mirror of
https://https.git.savannah.gnu.org/git/bash.git
synced 2026-08-06 02:02:42 +02:00
commit bash-20080306 snapshot
This commit is contained in:
Chet Ramey
+223
-209
@@ -11,7 +11,7 @@
|
||||
%DVIPSWebPage: (www.radicaleye.com)
|
||||
%DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps bashref.dvi
|
||||
%DVIPSParameters: dpi=600
|
||||
%DVIPSSource: TeX output 2008.01.10:1741
|
||||
%DVIPSSource: TeX output 2008.03.04:0838
|
||||
%%BeginProcSet: tex.pro 0 0
|
||||
%!
|
||||
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
|
||||
@@ -4537,19 +4537,19 @@ letter
|
||||
TeXDict begin 1 0 bop 150 1318 a Fu(Bash)64 b(Reference)j(Man)-5
|
||||
b(ual)p 150 1385 3600 34 v 2361 1481 a Ft(Reference)31
|
||||
b(Do)s(cumen)m(tation)i(for)d(Bash)2428 1589 y(Edition)h(3.2,)g(for)f
|
||||
Fs(Bash)g Ft(V)-8 b(ersion)31 b(3.2.)3145 1697 y(Decem)m(b)s(er)g(2007)
|
||||
150 4935 y Fr(Chet)45 b(Ramey)-11 b(,)46 b(Case)g(W)-11
|
||||
b(estern)46 b(Reserv)l(e)g(Univ)l(ersit)l(y)150 5068
|
||||
y(Brian)f(F)-11 b(o)l(x,)45 b(F)-11 b(ree)45 b(Soft)l(w)l(are)h(F)-11
|
||||
b(oundation)p 150 5141 3600 17 v eop end
|
||||
Fs(Bash)g Ft(V)-8 b(ersion)31 b(3.2.)3180 1697 y(F)-8
|
||||
b(ebruary)30 b(2008)150 4935 y Fr(Chet)45 b(Ramey)-11
|
||||
b(,)46 b(Case)g(W)-11 b(estern)46 b(Reserv)l(e)g(Univ)l(ersit)l(y)150
|
||||
5068 y(Brian)f(F)-11 b(o)l(x,)45 b(F)-11 b(ree)45 b(Soft)l(w)l(are)h(F)
|
||||
-11 b(oundation)p 150 5141 3600 17 v eop end
|
||||
%%Page: 2 2
|
||||
TeXDict begin 2 1 bop 150 2889 a Ft(This)35 b(text)h(is)g(a)g(brief)f
|
||||
(description)h(of)f(the)h(features)g(that)g(are)g(presen)m(t)g(in)f
|
||||
(the)h(Bash)f(shell)h(\(v)m(ersion)150 2999 y(3.2,)c(14)f(Decem)m(b)s
|
||||
(er)g(2007\).)150 3133 y(This)f(is)g(Edition)h(3.2,)h(last)g(up)s
|
||||
(dated)d(14)i(Decem)m(b)s(er)h(2007,)h(of)d Fq(The)g(GNU)i(Bash)e
|
||||
(Reference)i(Man)m(ual)p Ft(,)150 3243 y(for)e Fs(Bash)p
|
||||
Ft(,)g(V)-8 b(ersion)31 b(3.2.)150 3377 y(Cop)m(yrigh)m(t)602
|
||||
(the)h(Bash)f(shell)h(\(v)m(ersion)150 2999 y(3.2,)c(22)f(F)-8
|
||||
b(ebruary)30 b(2008\).)150 3133 y(This)g(is)h(Edition)g(3.2,)h(last)g
|
||||
(up)s(dated)e(22)h(F)-8 b(ebruary)31 b(2008,)i(of)e Fq(The)g(GNU)g
|
||||
(Bash)g(Reference)h(Man)m(ual)p Ft(,)150 3243 y(for)e
|
||||
Fs(Bash)p Ft(,)g(V)-8 b(ersion)31 b(3.2.)150 3377 y(Cop)m(yrigh)m(t)602
|
||||
3374 y(c)577 3377 y Fp(\015)f Ft(1988{2007)35 b(F)-8
|
||||
b(ree)31 b(Soft)m(w)m(are)h(F)-8 b(oundation,)31 b(Inc.)150
|
||||
3512 y(P)m(ermission)h(is)h(gran)m(ted)g(to)f(mak)m(e)i(and)d
|
||||
@@ -4568,12 +4568,12 @@ b(texts)e(b)s(eing)g(\\A)g(GNU)g(Man)m(ual",)h(and)e(with)g(the)h(Bac)m
|
||||
(k-Co)m(v)m(er)390 4194 y(T)-8 b(exts)33 b(as)g(in)f(\(a\))h(b)s(elo)m
|
||||
(w.)47 b(A)33 b(cop)m(y)g(of)f(the)h(license)g(is)g(included)e(in)h
|
||||
(the)h(section)g(en)m(titled)390 4304 y(\\GNU)e(F)-8
|
||||
b(ree)32 b(Do)s(cumen)m(tation)g(License".)390 4438 y(\(a\))c(The)e
|
||||
(FSF's)h(Bac)m(k-Co)m(v)m(er)j(T)-8 b(ext)28 b(is:)39
|
||||
b(\\Y)-8 b(ou)27 b(are)g(free)g(to)h(cop)m(y)f(and)g(mo)s(dify)f(this)g
|
||||
(GNU)390 4548 y(Man)m(ual.)41 b(Buying)30 b(copies)g(from)f(GNU)h
|
||||
(Press)e(supp)s(orts)g(the)h(FSF)h(in)f(dev)m(eloping)h(GNU)390
|
||||
4658 y(and)g(promoting)g(soft)m(w)m(are)i(freedom.")150
|
||||
b(ree)32 b(Do)s(cumen)m(tation)g(License".)390 4438 y(\(a\))e(The)e
|
||||
(FSF's)h(Bac)m(k-Co)m(v)m(er)j(T)-8 b(ext)30 b(is:)40
|
||||
b(\\Y)-8 b(ou)30 b(ha)m(v)m(e)g(the)f(freedom)f(to)i(cop)m(y)g(and)e
|
||||
(mo)s(dify)390 4548 y(this)f(GNU)i(man)m(ual.)40 b(Buying)27
|
||||
b(copies)i(from)e(the)h(FSF)f(supp)s(orts)f(it)i(in)g(dev)m(eloping)g
|
||||
(GNU)390 4658 y(and)i(promoting)g(soft)m(w)m(are)i(freedom.")150
|
||||
4902 y(Published)d(b)m(y)h(the)h(F)-8 b(ree)31 b(Soft)m(w)m(are)h(F)-8
|
||||
b(oundation)150 5011 y(59)31 b(T)-8 b(emple)31 b(Place,)h(Suite)e(330,)
|
||||
150 5121 y(Boston,)i(MA)e(02111-1307)150 5230 y(USA)p
|
||||
@@ -7120,194 +7120,205 @@ b(the)h(\014le)f(descriptors)g(of)h(the)f(calling)i(shell)f(as)f(mo)s
|
||||
%%Page: 31 37
|
||||
TeXDict begin 31 36 bop 150 -116 a Ft(Chapter)30 b(3:)41
|
||||
b(Basic)32 b(Shell)e(F)-8 b(eatures)2246 b(31)150 299
|
||||
y Fk(3.7.4)63 b(En)m(vironmen)m(t)275 546 y Ft(When)31
|
||||
y Fk(3.7.4)63 b(En)m(vironmen)m(t)275 547 y Ft(When)31
|
||||
b(a)g(program)h(is)f(in)m(v)m(ok)m(ed)i(it)f(is)f(giv)m(en)h(an)g(arra)
|
||||
m(y)g(of)f(strings)g(called)i(the)e Fq(en)m(vironmen)m(t)p
|
||||
Ft(.)45 b(This)150 656 y(is)30 b(a)h(list)g(of)g(name-v)-5
|
||||
b(alue)31 b(pairs,)f(of)h(the)f(form)g Fs(name=value)p
|
||||
Ft(.)275 793 y(Bash)39 b(pro)m(vides)g(sev)m(eral)i(w)m(a)m(ys)g(to)f
|
||||
Ft(.)275 795 y(Bash)39 b(pro)m(vides)g(sev)m(eral)i(w)m(a)m(ys)g(to)f
|
||||
(manipulate)f(the)h(en)m(vironmen)m(t.)69 b(On)38 b(in)m(v)m(o)s
|
||||
(cation,)44 b(the)c(shell)150 903 y(scans)g(its)h(o)m(wn)f(en)m
|
||||
(cation,)44 b(the)c(shell)150 904 y(scans)g(its)h(o)m(wn)f(en)m
|
||||
(vironmen)m(t)h(and)f(creates)i(a)f(parameter)f(for)g(eac)m(h)i(name)e
|
||||
(found,)i(automatically)150 1012 y(marking)26 b(it)g(for)g
|
||||
(found,)i(automatically)150 1014 y(marking)26 b(it)g(for)g
|
||||
Fq(exp)s(ort)h Ft(to)g(c)m(hild)f(pro)s(cesses.)39 b(Executed)26
|
||||
b(commands)g(inherit)g(the)g(en)m(vironmen)m(t.)39 b(The)150
|
||||
1122 y Fs(export)c Ft(and)i(`)p Fs(declare)29 b(-x)p
|
||||
1123 y Fs(export)c Ft(and)i(`)p Fs(declare)29 b(-x)p
|
||||
Ft(')36 b(commands)h(allo)m(w)i(parameters)e(and)g(functions)g(to)h(b)s
|
||||
(e)e(added)h(to)h(and)150 1231 y(deleted)21 b(from)f(the)h(en)m
|
||||
(e)e(added)h(to)h(and)150 1233 y(deleted)21 b(from)f(the)h(en)m
|
||||
(vironmen)m(t.)38 b(If)20 b(the)h(v)-5 b(alue)21 b(of)g(a)g(parameter)g
|
||||
(in)f(the)g(en)m(vironmen)m(t)i(is)e(mo)s(di\014ed,)i(the)150
|
||||
1341 y(new)31 b(v)-5 b(alue)32 b(b)s(ecomes)f(part)h(of)f(the)h(en)m
|
||||
1343 y(new)31 b(v)-5 b(alue)32 b(b)s(ecomes)f(part)h(of)f(the)h(en)m
|
||||
(vironmen)m(t,)g(replacing)h(the)e(old.)44 b(The)31 b(en)m(vironmen)m
|
||||
(t)h(inherited)150 1451 y(b)m(y)f(an)m(y)g(executed)h(command)f
|
||||
(t)h(inherited)150 1452 y(b)m(y)f(an)m(y)g(executed)h(command)f
|
||||
(consists)g(of)g(the)g(shell's)h(initial)g(en)m(vironmen)m(t,)g(whose)f
|
||||
(v)-5 b(alues)31 b(ma)m(y)h(b)s(e)150 1560 y(mo)s(di\014ed)26
|
||||
(v)-5 b(alues)31 b(ma)m(y)h(b)s(e)150 1562 y(mo)s(di\014ed)26
|
||||
b(in)g(the)h(shell,)h(less)f(an)m(y)g(pairs)f(remo)m(v)m(ed)i(b)m(y)f
|
||||
(the)g Fs(unset)e Ft(and)h(`)p Fs(export)j(-n)p Ft(')e(commands,)g
|
||||
(plus)150 1670 y(an)m(y)k(additions)f(via)h(the)g Fs(export)d
|
||||
Ft(and)i(`)p Fs(declare)f(-x)p Ft(')h(commands.)275 1807
|
||||
(plus)150 1671 y(an)m(y)k(additions)f(via)h(the)g Fs(export)d
|
||||
Ft(and)i(`)p Fs(declare)f(-x)p Ft(')h(commands.)275 1810
|
||||
y(The)j(en)m(vironmen)m(t)i(for)f(an)m(y)g(simple)h(command)f(or)g
|
||||
(function)g(ma)m(y)g(b)s(e)g(augmen)m(ted)h(temp)s(orarily)150
|
||||
1917 y(b)m(y)c(pre\014xing)e(it)i(with)g(parameter)g(assignmen)m(ts,)h
|
||||
1919 y(b)m(y)c(pre\014xing)e(it)i(with)g(parameter)g(assignmen)m(ts,)h
|
||||
(as)e(describ)s(ed)g(in)g(Section)i(3.4)g([Shell)e(P)m(arameters],)150
|
||||
2026 y(page)g(15.)41 b(These)29 b(assignmen)m(t)i(statemen)m(ts)g
|
||||
2029 y(page)g(15.)41 b(These)29 b(assignmen)m(t)i(statemen)m(ts)g
|
||||
(a\013ect)f(only)g(the)f(en)m(vironmen)m(t)h(seen)g(b)m(y)f(that)h
|
||||
(command.)275 2164 y(If)d(the)h(`)p Fs(-k)p Ft(')g(option)g(is)g(set)g
|
||||
(command.)275 2167 y(If)d(the)h(`)p Fs(-k)p Ft(')g(option)g(is)g(set)g
|
||||
(\(see)h(Section)f(4.3.1)i([The)e(Set)g(Builtin],)h(page)f(49\),)i
|
||||
(then)e(all)g(parameter)150 2273 y(assignmen)m(ts)i(are)g(placed)h(in)e
|
||||
(then)e(all)g(parameter)150 2277 y(assignmen)m(ts)i(are)g(placed)h(in)e
|
||||
(the)h(en)m(vironmen)m(t)g(for)g(a)g(command,)f(not)h(just)f(those)i
|
||||
(that)f(precede)g(the)150 2383 y(command)g(name.)275
|
||||
2521 y(When)f(Bash)h(in)m(v)m(ok)m(es)i(an)e(external)g(command,)g(the)
|
||||
(that)f(precede)g(the)150 2386 y(command)g(name.)275
|
||||
2525 y(When)f(Bash)h(in)m(v)m(ok)m(es)i(an)e(external)g(command,)g(the)
|
||||
g(v)-5 b(ariable)31 b(`)p Fs($_)p Ft(')f(is)g(set)g(to)h(the)f(full)f
|
||||
(path)h(name)150 2630 y(of)h(the)f(command)g(and)g(passed)g(to)h(that)g
|
||||
(command)f(in)g(its)h(en)m(vironmen)m(t.)150 2860 y Fk(3.7.5)63
|
||||
b(Exit)40 b(Status)275 3107 y Ft(F)-8 b(or)32 b(the)g(shell's)g(purp)s
|
||||
(path)h(name)150 2634 y(of)h(the)f(command)g(and)g(passed)g(to)h(that)g
|
||||
(command)f(in)g(its)h(en)m(vironmen)m(t.)150 2866 y Fk(3.7.5)63
|
||||
b(Exit)40 b(Status)275 3114 y Ft(The)24 b(exit)i(status)f(of)g(an)g
|
||||
(executed)h(command)e(is)h(the)h(v)-5 b(alue)25 b(returned)f(b)m(y)h
|
||||
(the)g Fq(w)m(aitpid)k Ft(system)c(call)150 3224 y(or)e(equiv)-5
|
||||
b(alen)m(t)25 b(function.)38 b(Exit)24 b(statuses)g(fall)f(b)s(et)m(w)m
|
||||
(een)h(0)g(and)f(255,)j(though,)f(as)e(explained)h(b)s(elo)m(w,)h(the)
|
||||
150 3333 y(shell)35 b(ma)m(y)g(use)f(v)-5 b(alues)35
|
||||
b(ab)s(o)m(v)m(e)g(125)h(sp)s(ecially)-8 b(.)54 b(Exit)35
|
||||
b(statuses)g(from)f(shell)h(builtins)f(and)f(comp)s(ound)150
|
||||
3443 y(commands)j(are)g(also)h(limited)g(to)g(this)f(range.)58
|
||||
b(Under)36 b(certain)h(circumstances,)h(the)e(shell)h(will)f(use)150
|
||||
3552 y(sp)s(ecial)31 b(v)-5 b(alues)31 b(to)g(indicate)g(sp)s(eci\014c)
|
||||
f(failure)h(mo)s(des.)275 3691 y(F)-8 b(or)32 b(the)g(shell's)g(purp)s
|
||||
(oses,)e(a)j(command)e(whic)m(h)h(exits)g(with)g(a)g(zero)g(exit)h
|
||||
(status)f(has)f(succeeded.)150 3217 y(A)e(non-zero)h(exit)g(status)g
|
||||
(status)f(has)f(succeeded.)150 3800 y(A)e(non-zero)h(exit)g(status)g
|
||||
(indicates)g(failure.)40 b(This)28 b(seemingly)i(coun)m(ter-in)m
|
||||
(tuitiv)m(e)i(sc)m(heme)e(is)f(used)g(so)150 3327 y(there)34
|
||||
(tuitiv)m(e)i(sc)m(heme)e(is)f(used)g(so)150 3910 y(there)34
|
||||
b(is)g(one)g(w)m(ell-de\014ned)g(w)m(a)m(y)g(to)h(indicate)g(success)f
|
||||
(and)f(a)h(v)-5 b(ariet)m(y)35 b(of)f(w)m(a)m(ys)h(to)f(indicate)h(v)-5
|
||||
b(arious)150 3436 y(failure)38 b(mo)s(des.)62 b(When)38
|
||||
b(arious)150 4020 y(failure)38 b(mo)s(des.)62 b(When)38
|
||||
b(a)g(command)f(terminates)i(on)e(a)i(fatal)g(signal)f(whose)g(n)m(um)m
|
||||
(b)s(er)e(is)i Fq(N)p Ft(,)g(Bash)150 3546 y(uses)30
|
||||
(b)s(er)e(is)i Fq(N)p Ft(,)g(Bash)150 4129 y(uses)30
|
||||
b(the)g(v)-5 b(alue)31 b(128)p Fs(+)p Fq(N)42 b Ft(as)30
|
||||
b(the)h(exit)g(status.)275 3683 y(If)k(a)h(command)g(is)g(not)g(found,)
|
||||
b(the)h(exit)g(status.)275 4267 y(If)k(a)h(command)g(is)g(not)g(found,)
|
||||
g(the)g(c)m(hild)h(pro)s(cess)e(created)i(to)g(execute)g(it)g(returns)d
|
||||
(a)j(status)f(of)150 3793 y(127.)42 b(If)30 b(a)h(command)f(is)g(found)
|
||||
(a)j(status)f(of)150 4377 y(127.)42 b(If)30 b(a)h(command)f(is)g(found)
|
||||
f(but)h(is)g(not)h(executable,)h(the)f(return)e(status)i(is)f(126.)275
|
||||
3930 y(If)i(a)i(command)f(fails)g(b)s(ecause)g(of)h(an)f(error)f
|
||||
4515 y(If)i(a)i(command)f(fails)g(b)s(ecause)g(of)h(an)f(error)f
|
||||
(during)g(expansion)h(or)g(redirection,)i(the)f(exit)g(status)150
|
||||
4040 y(is)c(greater)i(than)e(zero.)275 4177 y(The)38
|
||||
4625 y(is)c(greater)i(than)e(zero.)275 4763 y(The)38
|
||||
b(exit)h(status)g(is)g(used)f(b)m(y)g(the)h(Bash)g(conditional)h
|
||||
(commands)e(\(see)h(Section)h(3.2.4.2)h([Con-)150 4287
|
||||
(commands)e(\(see)h(Section)h(3.2.4.2)h([Con-)150 4873
|
||||
y(ditional)i(Constructs],)h(page)f(10\))g(and)e(some)i(of)f(the)g(list)
|
||||
g(constructs)g(\(see)h(Section)f(3.2.3)i([Lists],)150
|
||||
4397 y(page)31 b(9\).)275 4534 y(All)40 b(of)g(the)h(Bash)f(builtins)f
|
||||
4982 y(page)31 b(9\).)275 5121 y(All)40 b(of)g(the)h(Bash)f(builtins)f
|
||||
(return)g(an)h(exit)h(status)g(of)f(zero)h(if)f(they)g(succeed)g(and)g
|
||||
(a)g(non-zero)150 4644 y(status)34 b(on)f(failure,)i(so)f(they)g(ma)m
|
||||
(a)g(non-zero)150 5230 y(status)34 b(on)f(failure,)i(so)f(they)g(ma)m
|
||||
(y)g(b)s(e)f(used)g(b)m(y)g(the)h(conditional)h(and)e(list)h
|
||||
(constructs.)50 b(All)35 b(builtins)150 4753 y(return)29
|
||||
b(an)i(exit)g(status)g(of)f(2)h(to)g(indicate)g(incorrect)h(usage.)150
|
||||
4983 y Fk(3.7.6)63 b(Signals)275 5230 y Ft(When)27 b(Bash)h(is)h(in)m
|
||||
(teractiv)m(e,)i(in)d(the)g(absence)h(of)f(an)m(y)g(traps,)h(it)f
|
||||
(ignores)h Fs(SIGTERM)d Ft(\(so)i(that)h(`)p Fs(kill)150
|
||||
5340 y(0)p Ft(')k(do)s(es)g(not)g(kill)g(an)g(in)m(teractiv)m(e)j
|
||||
(shell\),)f(and)d Fs(SIGINT)f Ft(is)i(caugh)m(t)h(and)f(handled)f(\(so)
|
||||
h(that)h(the)f Fs(wait)p eop end
|
||||
(constructs.)50 b(All)35 b(builtins)150 5340 y(return)29
|
||||
b(an)i(exit)g(status)g(of)f(2)h(to)g(indicate)g(incorrect)h(usage.)p
|
||||
eop end
|
||||
%%Page: 32 38
|
||||
TeXDict begin 32 37 bop 150 -116 a Ft(32)2572 b(Bash)31
|
||||
b(Reference)g(Man)m(ual)150 299 y(builtin)24 b(is)h(in)m
|
||||
(terruptible\).)39 b(When)24 b(Bash)g(receiv)m(es)j(a)d
|
||||
Fs(SIGINT)p Ft(,)h(it)g(breaks)f(out)h(of)f(an)m(y)h(executing)h(lo)s
|
||||
(ops.)150 408 y(In)31 b(all)h(cases,)h(Bash)f(ignores)g
|
||||
Fs(SIGQUIT)p Ft(.)42 b(If)32 b(job)f(con)m(trol)i(is)e(in)h(e\013ect)h
|
||||
(\(see)f(Chapter)f(7)h([Job)g(Con)m(trol],)150 518 y(page)f(87\),)h
|
||||
(Bash)e(ignores)h Fs(SIGTTIN)p Ft(,)e Fs(SIGTTOU)p Ft(,)g(and)g
|
||||
Fs(SIGTSTP)p Ft(.)275 654 y(Non-builtin)i(commands)g(started)g(b)m(y)g
|
||||
(Bash)h(ha)m(v)m(e)g(signal)g(handlers)e(set)i(to)g(the)g(v)-5
|
||||
b(alues)31 b(inherited)150 763 y(b)m(y)37 b(the)h(shell)g(from)f(its)h
|
||||
(paren)m(t.)62 b(When)38 b(job)f(con)m(trol)i(is)e(not)h(in)f
|
||||
(e\013ect,)k(async)m(hronous)c(commands)150 873 y(ignore)f
|
||||
Fs(SIGINT)e Ft(and)h Fs(SIGQUIT)e Ft(in)j(addition)f(to)i(these)f
|
||||
(inherited)f(handlers.)55 b(Commands)35 b(run)f(as)i(a)150
|
||||
983 y(result)27 b(of)h(command)f(substitution)h(ignore)g(the)g(k)m(eyb)
|
||||
s(oard-generated)g(job)g(con)m(trol)h(signals)f Fs(SIGTTIN)p
|
||||
Ft(,)150 1092 y Fs(SIGTTOU)p Ft(,)h(and)g Fs(SIGTSTP)p
|
||||
Ft(.)275 1228 y(The)h(shell)i(exits)g(b)m(y)f(default)g(up)s(on)f
|
||||
b(Reference)g(Man)m(ual)150 299 y Fk(3.7.6)63 b(Signals)275
|
||||
555 y Ft(When)27 b(Bash)h(is)h(in)m(teractiv)m(e,)i(in)d(the)g(absence)
|
||||
h(of)f(an)m(y)g(traps,)h(it)f(ignores)h Fs(SIGTERM)d
|
||||
Ft(\(so)i(that)h(`)p Fs(kill)150 665 y(0)p Ft(')k(do)s(es)g(not)g(kill)
|
||||
g(an)g(in)m(teractiv)m(e)j(shell\),)f(and)d Fs(SIGINT)f
|
||||
Ft(is)i(caugh)m(t)h(and)f(handled)f(\(so)h(that)h(the)f
|
||||
Fs(wait)150 774 y Ft(builtin)24 b(is)h(in)m(terruptible\).)39
|
||||
b(When)24 b(Bash)g(receiv)m(es)j(a)d Fs(SIGINT)p Ft(,)h(it)g(breaks)f
|
||||
(out)h(of)f(an)m(y)h(executing)h(lo)s(ops.)150 884 y(In)31
|
||||
b(all)h(cases,)h(Bash)f(ignores)g Fs(SIGQUIT)p Ft(.)42
|
||||
b(If)32 b(job)f(con)m(trol)i(is)e(in)h(e\013ect)h(\(see)f(Chapter)f(7)h
|
||||
([Job)g(Con)m(trol],)150 993 y(page)f(87\),)h(Bash)e(ignores)h
|
||||
Fs(SIGTTIN)p Ft(,)e Fs(SIGTTOU)p Ft(,)g(and)g Fs(SIGTSTP)p
|
||||
Ft(.)275 1140 y(Non-builtin)i(commands)g(started)g(b)m(y)g(Bash)h(ha)m
|
||||
(v)m(e)g(signal)g(handlers)e(set)i(to)g(the)g(v)-5 b(alues)31
|
||||
b(inherited)150 1250 y(b)m(y)37 b(the)h(shell)g(from)f(its)h(paren)m
|
||||
(t.)62 b(When)38 b(job)f(con)m(trol)i(is)e(not)h(in)f(e\013ect,)k
|
||||
(async)m(hronous)c(commands)150 1359 y(ignore)f Fs(SIGINT)e
|
||||
Ft(and)h Fs(SIGQUIT)e Ft(in)j(addition)f(to)i(these)f(inherited)f
|
||||
(handlers.)55 b(Commands)35 b(run)f(as)i(a)150 1469 y(result)27
|
||||
b(of)h(command)f(substitution)h(ignore)g(the)g(k)m(eyb)s
|
||||
(oard-generated)g(job)g(con)m(trol)h(signals)f Fs(SIGTTIN)p
|
||||
Ft(,)150 1578 y Fs(SIGTTOU)p Ft(,)h(and)g Fs(SIGTSTP)p
|
||||
Ft(.)275 1725 y(The)h(shell)i(exits)g(b)m(y)f(default)g(up)s(on)f
|
||||
(receipt)i(of)f(a)h Fs(SIGHUP)p Ft(.)42 b(Before)32 b(exiting,)h(an)e
|
||||
(in)m(teractiv)m(e)j(shell)150 1337 y(resends)41 b(the)i
|
||||
(in)m(teractiv)m(e)j(shell)150 1835 y(resends)41 b(the)i
|
||||
Fs(SIGHUP)e Ft(to)i(all)g(jobs,)i(running)c(or)h(stopp)s(ed.)76
|
||||
b(Stopp)s(ed)41 b(jobs)h(are)h(sen)m(t)g Fs(SIGCONT)d
|
||||
Ft(to)150 1447 y(ensure)32 b(that)h(they)g(receiv)m(e)i(the)e
|
||||
Ft(to)150 1944 y(ensure)32 b(that)h(they)g(receiv)m(e)i(the)e
|
||||
Fs(SIGHUP)p Ft(.)47 b(T)-8 b(o)33 b(prev)m(en)m(t)g(the)g(shell)g(from)
|
||||
g(sending)f(the)h Fs(SIGHUP)e Ft(signal)150 1557 y(to)i(a)g(particular)
|
||||
g(sending)f(the)h Fs(SIGHUP)e Ft(signal)150 2054 y(to)i(a)g(particular)
|
||||
g(job,)g(it)g(should)f(b)s(e)g(remo)m(v)m(ed)h(from)g(the)f(jobs)g
|
||||
(table)i(with)e(the)h Fs(disown)e Ft(builtin)h(\(see)150
|
||||
1666 y(Section)f(7.2)g([Job)f(Con)m(trol)h(Builtins],)g(page)g(88\))h
|
||||
2163 y(Section)f(7.2)g([Job)f(Con)m(trol)h(Builtins],)g(page)g(88\))h
|
||||
(or)e(mark)m(ed)g(to)h(not)f(receiv)m(e)i Fs(SIGHUP)d
|
||||
Ft(using)h Fs(disown)150 1776 y(-h)p Ft(.)275 1912 y(If)38
|
||||
Ft(using)h Fs(disown)150 2273 y(-h)p Ft(.)275 2419 y(If)38
|
||||
b(the)h Fs(huponexit)e Ft(shell)i(option)g(has)g(b)s(een)f(set)i(with)f
|
||||
Fs(shopt)e Ft(\(see)j(Section)g(4.3.2)h([The)e(Shopt)150
|
||||
2021 y(Builtin],)31 b(page)g(53\),)h(Bash)f(sends)e(a)i
|
||||
2529 y(Builtin],)31 b(page)g(53\),)h(Bash)f(sends)e(a)i
|
||||
Fs(SIGHUP)e Ft(to)i(all)g(jobs)f(when)f(an)i(in)m(teractiv)m(e)i(login)
|
||||
e(shell)g(exits.)275 2157 y(If)38 b(Bash)h(is)g(w)m(aiting)h(for)f(a)g
|
||||
e(shell)g(exits.)275 2676 y(If)38 b(Bash)h(is)g(w)m(aiting)h(for)f(a)g
|
||||
(command)f(to)i(complete)g(and)e(receiv)m(es)j(a)e(signal)h(for)e(whic)
|
||||
m(h)h(a)g(trap)150 2266 y(has)c(b)s(een)f(set,)i(the)f(trap)g(will)g
|
||||
m(h)h(a)g(trap)150 2785 y(has)c(b)s(een)f(set,)i(the)f(trap)g(will)g
|
||||
(not)g(b)s(e)f(executed)i(un)m(til)f(the)g(command)f(completes.)55
|
||||
b(When)35 b(Bash)g(is)150 2376 y(w)m(aiting)j(for)f(an)g(async)m
|
||||
b(When)35 b(Bash)g(is)150 2895 y(w)m(aiting)j(for)f(an)g(async)m
|
||||
(hronous)g(command)g(via)h(the)f Fs(wait)f Ft(builtin,)i(the)g
|
||||
(reception)g(of)f(a)g(signal)h(for)150 2486 y(whic)m(h)d(a)g(trap)g
|
||||
(reception)g(of)f(a)g(signal)h(for)150 3004 y(whic)m(h)d(a)g(trap)g
|
||||
(has)g(b)s(een)f(set)h(will)h(cause)f(the)g Fs(wait)f
|
||||
Ft(builtin)h(to)g(return)f(immediately)i(with)f(an)g(exit)150
|
||||
2595 y(status)c(greater)g(than)f(128,)i(immediately)g(after)f(whic)m(h)
|
||||
f(the)h(trap)f(is)g(executed.)150 2856 y Fr(3.8)68 b(Shell)45
|
||||
b(Scripts)275 3101 y Ft(A)c(shell)h(script)g(is)g(a)g(text)h(\014le)f
|
||||
3114 y(status)c(greater)g(than)f(128,)i(immediately)g(after)f(whic)m(h)
|
||||
f(the)h(trap)f(is)g(executed.)150 3402 y Fr(3.8)68 b(Shell)45
|
||||
b(Scripts)275 3658 y Ft(A)c(shell)h(script)g(is)g(a)g(text)h(\014le)f
|
||||
(con)m(taining)h(shell)f(commands.)75 b(When)41 b(suc)m(h)h(a)g(\014le)
|
||||
g(is)g(used)f(as)150 3211 y(the)33 b(\014rst)f(non-option)h(argumen)m
|
||||
g(is)g(used)f(as)150 3767 y(the)33 b(\014rst)f(non-option)h(argumen)m
|
||||
(t)h(when)e(in)m(v)m(oking)i(Bash,)g(and)e(neither)h(the)g(`)p
|
||||
Fs(-c)p Ft(')g(nor)g(`)p Fs(-s)p Ft(')f(option)i(is)150
|
||||
3320 y(supplied)j(\(see)j(Section)g(6.1)f([In)m(v)m(oking)h(Bash],)h
|
||||
3877 y(supplied)j(\(see)j(Section)g(6.1)f([In)m(v)m(oking)h(Bash],)h
|
||||
(page)f(69\),)i(Bash)d(reads)f(and)g(executes)i(commands)150
|
||||
3430 y(from)31 b(the)h(\014le,)h(then)e(exits.)46 b(This)31
|
||||
3987 y(from)31 b(the)h(\014le,)h(then)e(exits.)46 b(This)31
|
||||
b(mo)s(de)g(of)h(op)s(eration)h(creates)g(a)f(non-in)m(teractiv)m(e)i
|
||||
(shell.)45 b(The)32 b(shell)150 3539 y(\014rst)26 b(searc)m(hes)h(for)f
|
||||
(shell.)45 b(The)32 b(shell)150 4096 y(\014rst)26 b(searc)m(hes)h(for)f
|
||||
(the)g(\014le)h(in)f(the)g(curren)m(t)h(directory)-8
|
||||
b(,)28 b(and)e(lo)s(oks)g(in)h(the)f(directories)h(in)f
|
||||
Fs($PATH)f Ft(if)i(not)150 3649 y(found)i(there.)275
|
||||
3785 y(When)34 b(Bash)h(runs)e(a)i(shell)g(script,)g(it)h(sets)f(the)f
|
||||
Fs($PATH)f Ft(if)i(not)150 4206 y(found)i(there.)275
|
||||
4352 y(When)34 b(Bash)h(runs)e(a)i(shell)g(script,)g(it)h(sets)f(the)f
|
||||
(sp)s(ecial)i(parameter)f Fs(0)f Ft(to)h(the)g(name)g(of)g(the)g
|
||||
(\014le,)150 3894 y(rather)k(than)g(the)h(name)f(of)h(the)f(shell,)j
|
||||
(\014le,)150 4462 y(rather)k(than)g(the)h(name)f(of)h(the)f(shell,)j
|
||||
(and)d(the)h(p)s(ositional)g(parameters)f(are)h(set)g(to)g(the)g
|
||||
(remain-)150 4004 y(ing)f(argumen)m(ts,)j(if)d(an)m(y)g(are)g(giv)m
|
||||
(remain-)150 4571 y(ing)f(argumen)m(ts,)j(if)d(an)m(y)g(are)g(giv)m
|
||||
(en.)67 b(If)39 b(no)g(additional)g(argumen)m(ts)h(are)f(supplied,)h
|
||||
(the)f(p)s(ositional)150 4113 y(parameters)31 b(are)f(unset.)275
|
||||
4249 y(A)39 b(shell)h(script)f(ma)m(y)h(b)s(e)f(made)h(executable)h(b)m
|
||||
(the)f(p)s(ositional)150 4681 y(parameters)31 b(are)f(unset.)275
|
||||
4828 y(A)39 b(shell)h(script)f(ma)m(y)h(b)s(e)f(made)h(executable)h(b)m
|
||||
(y)e(using)g(the)h Fs(chmod)e Ft(command)h(to)h(turn)e(on)i(the)150
|
||||
4359 y(execute)j(bit.)73 b(When)41 b(Bash)g(\014nds)e(suc)m(h)i(a)h
|
||||
4937 y(execute)j(bit.)73 b(When)41 b(Bash)g(\014nds)e(suc)m(h)i(a)h
|
||||
(\014le)f(while)g(searc)m(hing)h(the)f Fs($PATH)f Ft(for)h(a)h
|
||||
(command,)h(it)150 4468 y(spa)m(wns)30 b(a)g(subshell)g(to)h(execute)h
|
||||
(it.)41 b(In)30 b(other)g(w)m(ords,)g(executing)390 4604
|
||||
y Fs(filename)46 b Fj(arguments)150 4740 y Ft(is)30 b(equiv)-5
|
||||
b(alen)m(t)32 b(to)f(executing)390 4875 y Fs(bash)47
|
||||
b(filename)e Fj(arguments)150 5011 y Ft(if)30 b Fs(filename)d
|
||||
Ft(is)j(an)f(executable)j(shell)e(script.)40 b(This)29
|
||||
b(subshell)g(reinitializes)i(itself,)g(so)f(that)h(the)e(e\013ect)150
|
||||
5121 y(is)36 b(as)h(if)g(a)f(new)g(shell)h(had)f(b)s(een)g(in)m(v)m(ok)
|
||||
m(ed)h(to)h(in)m(terpret)e(the)h(script,)h(with)e(the)h(exception)h
|
||||
(that)f(the)150 5230 y(lo)s(cations)25 b(of)g(commands)e(remem)m(b)s
|
||||
(ered)h(b)m(y)g(the)g(paren)m(t)g(\(see)h(the)f(description)g(of)g
|
||||
Fs(hash)f Ft(in)h(Section)h(4.1)150 5340 y([Bourne)30
|
||||
b(Shell)h(Builtins],)g(page)g(35\))h(are)e(retained)h(b)m(y)f(the)h(c)m
|
||||
(hild.)p eop end
|
||||
(command,)h(it)150 5047 y(spa)m(wns)30 b(a)g(subshell)g(to)h(execute)h
|
||||
(it.)41 b(In)30 b(other)g(w)m(ords,)g(executing)390 5193
|
||||
y Fs(filename)46 b Fj(arguments)150 5340 y Ft(is)30 b(equiv)-5
|
||||
b(alen)m(t)32 b(to)f(executing)p eop end
|
||||
%%Page: 33 39
|
||||
TeXDict begin 33 38 bop 150 -116 a Ft(Chapter)30 b(3:)41
|
||||
b(Basic)32 b(Shell)e(F)-8 b(eatures)2246 b(33)275 299
|
||||
y(Most)36 b(v)m(ersions)g(of)g(Unix)f(mak)m(e)h(this)g(a)g(part)f(of)h
|
||||
(the)g(op)s(erating)g(system's)f(command)h(execution)150
|
||||
408 y(mec)m(hanism.)50 b(If)33 b(the)g(\014rst)g(line)h(of)f(a)h
|
||||
(script)f(b)s(egins)g(with)g(the)g(t)m(w)m(o)i(c)m(haracters)g(`)p
|
||||
Fs(#!)p Ft(',)f(the)g(remainder)150 518 y(of)d(the)g(line)h(sp)s
|
||||
(eci\014es)e(an)h(in)m(terpreter)g(for)g(the)g(program.)43
|
||||
b(Th)m(us,)30 b(y)m(ou)h(can)h(sp)s(ecify)e(Bash,)i Fs(awk)p
|
||||
Ft(,)e(P)m(erl,)150 628 y(or)g(some)h(other)g(in)m(terpreter)g(and)e
|
||||
(write)i(the)f(rest)h(of)g(the)f(script)g(\014le)h(in)f(that)h
|
||||
(language.)275 762 y(The)40 b(argumen)m(ts)h(to)g(the)g(in)m(terpreter)
|
||||
g(consist)g(of)g(a)g(single)h(optional)f(argumen)m(t)h(follo)m(wing)g
|
||||
(the)150 872 y(in)m(terpreter)33 b(name)h(on)f(the)g(\014rst)f(line)i
|
||||
(of)f(the)g(script)g(\014le,)h(follo)m(w)m(ed)h(b)m(y)e(the)g(name)g
|
||||
(of)g(the)h(script)f(\014le,)150 981 y(follo)m(w)m(ed)g(b)m(y)f(the)f
|
||||
(rest)h(of)g(the)f(argumen)m(ts.)45 b(Bash)31 b(will)h(p)s(erform)e
|
||||
(this)i(action)h(on)e(op)s(erating)h(systems)150 1091
|
||||
y(that)24 b(do)g(not)f(handle)g(it)h(themselv)m(es.)40
|
||||
b(Basic)32 b(Shell)e(F)-8 b(eatures)2246 b(33)390 299
|
||||
y Fs(bash)47 b(filename)e Fj(arguments)150 433 y Ft(if)30
|
||||
b Fs(filename)d Ft(is)j(an)f(executable)j(shell)e(script.)40
|
||||
b(This)29 b(subshell)g(reinitializes)i(itself,)g(so)f(that)h(the)e
|
||||
(e\013ect)150 543 y(is)36 b(as)h(if)g(a)f(new)g(shell)h(had)f(b)s(een)g
|
||||
(in)m(v)m(ok)m(ed)h(to)h(in)m(terpret)e(the)h(script,)h(with)e(the)h
|
||||
(exception)h(that)f(the)150 653 y(lo)s(cations)25 b(of)g(commands)e
|
||||
(remem)m(b)s(ered)h(b)m(y)g(the)g(paren)m(t)g(\(see)h(the)f
|
||||
(description)g(of)g Fs(hash)f Ft(in)h(Section)h(4.1)150
|
||||
762 y([Bourne)30 b(Shell)h(Builtins],)g(page)g(35\))h(are)e(retained)h
|
||||
(b)m(y)f(the)h(c)m(hild.)275 897 y(Most)36 b(v)m(ersions)g(of)g(Unix)f
|
||||
(mak)m(e)h(this)g(a)g(part)f(of)h(the)g(op)s(erating)g(system's)f
|
||||
(command)h(execution)150 1006 y(mec)m(hanism.)50 b(If)33
|
||||
b(the)g(\014rst)g(line)h(of)f(a)h(script)f(b)s(egins)g(with)g(the)g(t)m
|
||||
(w)m(o)i(c)m(haracters)g(`)p Fs(#!)p Ft(',)f(the)g(remainder)150
|
||||
1116 y(of)d(the)g(line)h(sp)s(eci\014es)e(an)h(in)m(terpreter)g(for)g
|
||||
(the)g(program.)43 b(Th)m(us,)30 b(y)m(ou)h(can)h(sp)s(ecify)e(Bash,)i
|
||||
Fs(awk)p Ft(,)e(P)m(erl,)150 1225 y(or)g(some)h(other)g(in)m(terpreter)
|
||||
g(and)e(write)i(the)f(rest)h(of)g(the)f(script)g(\014le)h(in)f(that)h
|
||||
(language.)275 1360 y(The)40 b(argumen)m(ts)h(to)g(the)g(in)m
|
||||
(terpreter)g(consist)g(of)g(a)g(single)h(optional)f(argumen)m(t)h
|
||||
(follo)m(wing)g(the)150 1469 y(in)m(terpreter)33 b(name)h(on)f(the)g
|
||||
(\014rst)f(line)i(of)f(the)g(script)g(\014le,)h(follo)m(w)m(ed)h(b)m(y)
|
||||
e(the)g(name)g(of)g(the)h(script)f(\014le,)150 1579 y(follo)m(w)m(ed)g
|
||||
(b)m(y)f(the)f(rest)h(of)g(the)f(argumen)m(ts.)45 b(Bash)31
|
||||
b(will)h(p)s(erform)e(this)i(action)h(on)e(op)s(erating)h(systems)150
|
||||
1689 y(that)24 b(do)g(not)f(handle)g(it)h(themselv)m(es.)40
|
||||
b(Note)25 b(that)f(some)g(older)g(v)m(ersions)f(of)h(Unix)f(limit)i
|
||||
(the)f(in)m(terpreter)150 1200 y(name)30 b(and)g(argumen)m(t)h(to)g(a)g
|
||||
(maxim)m(um)f(of)h(32)g(c)m(haracters.)275 1335 y(Bash)h(scripts)g
|
||||
(the)f(in)m(terpreter)150 1798 y(name)30 b(and)g(argumen)m(t)h(to)g(a)g
|
||||
(maxim)m(um)f(of)h(32)g(c)m(haracters.)275 1933 y(Bash)h(scripts)g
|
||||
(often)g(b)s(egin)g(with)g Fs(#!)e(/bin/bash)g Ft(\(assuming)i(that)h
|
||||
(Bash)f(has)g(b)s(een)f(installed)i(in)150 1445 y(`)p
|
||||
(Bash)f(has)g(b)s(een)f(installed)i(in)150 2042 y(`)p
|
||||
Fs(/bin)p Ft('\),)25 b(since)e(this)g(ensures)f(that)i(Bash)f(will)h(b)
|
||||
s(e)e(used)h(to)h(in)m(terpret)f(the)g(script,)i(ev)m(en)f(if)f(it)h
|
||||
(is)f(executed)150 1554 y(under)29 b(another)h(shell.)p
|
||||
(is)f(executed)150 2152 y(under)29 b(another)h(shell.)p
|
||||
eop end
|
||||
%%Page: 34 40
|
||||
TeXDict begin 34 39 bop 150 -116 a Ft(34)2572 b(Bash)31
|
||||
@@ -8678,104 +8689,107 @@ b Ft(If)33 b(set,)j(Bash)e(attempts)h(to)g(sa)m(v)m(e)g(all)g(lines)f
|
||||
(of)g(a)h(m)m(ultiple-line)g(command)1110 1504 y(in)c(the)g(same)g
|
||||
(history)g(en)m(try)-8 b(.)42 b(This)30 b(allo)m(ws)i(easy)g
|
||||
(re-editing)g(of)f(m)m(ulti-line)1110 1614 y(commands.)630
|
||||
1778 y Fs(dotglob)144 b Ft(If)27 b(set,)i(Bash)f(includes)g
|
||||
(\014lenames)g(b)s(eginning)f(with)g(a)h(`.')41 b(in)27
|
||||
b(the)h(results)g(of)1110 1888 y(\014lename)j(expansion.)630
|
||||
2052 y Fs(execfail)96 b Ft(If)24 b(this)h(is)f(set,)j(a)e(non-in)m
|
||||
(teractiv)m(e)i(shell)e(will)f(not)h(exit)h(if)e(it)h(cannot)h(execute)
|
||||
1110 2162 y(the)i(\014le)g(sp)s(eci\014ed)g(as)g(an)g(argumen)m(t)g(to)
|
||||
h(the)f Fs(exec)f Ft(builtin)h(command.)39 b(An)1110
|
||||
2271 y(in)m(teractiv)m(e)33 b(shell)e(do)s(es)f(not)g(exit)i(if)e
|
||||
Fs(exec)f Ft(fails.)630 2436 y Fs(expand_aliases)1110
|
||||
2545 y Ft(If)j(set,)h(aliases)g(are)g(expanded)e(as)h(describ)s(ed)f(b)
|
||||
s(elo)m(w)h(under)f(Aliases,)i(Sec-)1110 2655 y(tion)38
|
||||
1778 y Fs(compat31)96 b Ft(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s
|
||||
(eha)m(vior)f(to)i(that)f(of)f(v)m(ersion)h(3.1)h(with)e(resp)s(ect)
|
||||
1110 1888 y(to)k(quoted)g(argumen)m(ts)f(to)h(the)g(conditional)h
|
||||
(command's)e(=)p Fs(~)g Ft(op)s(erator.)630 2052 y Fs(dotglob)144
|
||||
b Ft(If)27 b(set,)i(Bash)f(includes)g(\014lenames)g(b)s(eginning)f
|
||||
(with)g(a)h(`.')41 b(in)27 b(the)h(results)g(of)1110
|
||||
2162 y(\014lename)j(expansion.)630 2326 y Fs(execfail)96
|
||||
b Ft(If)24 b(this)h(is)f(set,)j(a)e(non-in)m(teractiv)m(e)i(shell)e
|
||||
(will)f(not)h(exit)h(if)e(it)h(cannot)h(execute)1110
|
||||
2436 y(the)i(\014le)g(sp)s(eci\014ed)g(as)g(an)g(argumen)m(t)g(to)h
|
||||
(the)f Fs(exec)f Ft(builtin)h(command.)39 b(An)1110 2545
|
||||
y(in)m(teractiv)m(e)33 b(shell)e(do)s(es)f(not)g(exit)i(if)e
|
||||
Fs(exec)f Ft(fails.)630 2710 y Fs(expand_aliases)1110
|
||||
2819 y Ft(If)j(set,)h(aliases)g(are)g(expanded)e(as)h(describ)s(ed)f(b)
|
||||
s(elo)m(w)h(under)f(Aliases,)i(Sec-)1110 2929 y(tion)38
|
||||
b(6.6)h([Aliases],)j(page)d(77.)64 b(This)37 b(option)h(is)g(enabled)g
|
||||
(b)m(y)g(default)g(for)1110 2765 y(in)m(teractiv)m(e)33
|
||||
b(shells.)630 2929 y Fs(extdebug)96 b Ft(If)30 b(set,)h(b)s(eha)m(vior)
|
||||
(b)m(y)g(default)g(for)1110 3039 y(in)m(teractiv)m(e)33
|
||||
b(shells.)630 3203 y Fs(extdebug)96 b Ft(If)30 b(set,)h(b)s(eha)m(vior)
|
||||
g(in)m(tended)f(for)g(use)g(b)m(y)g(debuggers)g(is)h(enabled:)1159
|
||||
3066 y(1.)61 b(The)32 b(`)p Fs(-F)p Ft(')g(option)h(to)g(the)g
|
||||
3340 y(1.)61 b(The)32 b(`)p Fs(-F)p Ft(')g(option)h(to)g(the)g
|
||||
Fs(declare)d Ft(builtin)i(\(see)i(Section)f(4.2)h([Bash)1290
|
||||
3176 y(Builtins],)29 b(page)g(41\))g(displa)m(ys)f(the)g(source)h
|
||||
(\014le)f(name)g(and)f(line)h(n)m(um-)1290 3285 y(b)s(er)h(corresp)s
|
||||
3450 y(Builtins],)29 b(page)g(41\))g(displa)m(ys)f(the)g(source)h
|
||||
(\014le)f(name)g(and)f(line)h(n)m(um-)1290 3559 y(b)s(er)h(corresp)s
|
||||
(onding)g(to)i(eac)m(h)g(function)f(name)g(supplied)f(as)i(an)f(argu-)
|
||||
1290 3395 y(men)m(t.)1159 3532 y(2.)61 b(If)20 b(the)h(command)g(run)e
|
||||
1290 3669 y(men)m(t.)1159 3806 y(2.)61 b(If)20 b(the)h(command)g(run)e
|
||||
(b)m(y)i(the)f Fs(DEBUG)g Ft(trap)g(returns)g(a)h(non-zero)g(v)-5
|
||||
b(alue,)1290 3641 y(the)31 b(next)f(command)g(is)h(skipp)s(ed)e(and)g
|
||||
(not)i(executed.)1159 3778 y(3.)61 b(If)37 b(the)g(command)g(run)f(b)m
|
||||
b(alue,)1290 3915 y(the)31 b(next)f(command)g(is)h(skipp)s(ed)e(and)g
|
||||
(not)i(executed.)1159 4052 y(3.)61 b(If)37 b(the)g(command)g(run)f(b)m
|
||||
(y)i(the)f Fs(DEBUG)f Ft(trap)h(returns)f(a)i(v)-5 b(alue)38
|
||||
b(of)f(2,)1290 3888 y(and)c(the)g(shell)h(is)f(executing)i(in)e(a)h
|
||||
(subroutine)e(\(a)i(shell)g(function)f(or)1290 3998 y(a)h(shell)h
|
||||
b(of)f(2,)1290 4162 y(and)c(the)g(shell)h(is)f(executing)i(in)e(a)h
|
||||
(subroutine)e(\(a)i(shell)g(function)f(or)1290 4271 y(a)h(shell)h
|
||||
(script)f(executed)h(b)m(y)f(the)g Fs(.)g Ft(or)g Fs(source)e
|
||||
Ft(builtins\),)j(a)g(call)g(to)1290 4107 y Fs(return)29
|
||||
b Ft(is)h(sim)m(ulated.)1159 4244 y(4.)61 b Fs(BASH_ARGC)34
|
||||
Ft(builtins\),)j(a)g(call)g(to)1290 4381 y Fs(return)29
|
||||
b Ft(is)h(sim)m(ulated.)1159 4518 y(4.)61 b Fs(BASH_ARGC)34
|
||||
b Ft(and)i Fs(BASH_ARGV)e Ft(are)j(up)s(dated)e(as)h(describ)s(ed)g(in)
|
||||
g(their)1290 4354 y(descriptions)30 b(\(see)i(Section)f(5.2)g([Bash)g
|
||||
(V)-8 b(ariables],)32 b(page)f(59\).)1159 4491 y(5.)61
|
||||
g(their)1290 4628 y(descriptions)30 b(\(see)i(Section)f(5.2)g([Bash)g
|
||||
(V)-8 b(ariables],)32 b(page)f(59\).)1159 4765 y(5.)61
|
||||
b(F)-8 b(unction)57 b(tracing)g(is)g(enabled:)93 b(command)56
|
||||
b(substitution,)63 b(shell)1290 4600 y(functions,)30
|
||||
b(substitution,)63 b(shell)1290 4874 y(functions,)30
|
||||
b(and)f(subshells)g(in)m(v)m(ok)m(ed)j(with)d Fs(\()h
|
||||
Fj(command)39 b Fs(\))30 b Ft(inherit)g(the)1290 4710
|
||||
y Fs(DEBUG)f Ft(and)h Fs(RETURN)e Ft(traps.)1159 4847
|
||||
Fj(command)39 b Fs(\))30 b Ft(inherit)g(the)1290 4984
|
||||
y Fs(DEBUG)f Ft(and)h Fs(RETURN)e Ft(traps.)1159 5121
|
||||
y(6.)61 b(Error)74 b(tracing)i(is)f(enabled:)131 b(command)74
|
||||
b(substitution,)87 b(shell)1290 4956 y(functions,)30
|
||||
b(substitution,)87 b(shell)1290 5230 y(functions,)30
|
||||
b(and)f(subshells)g(in)m(v)m(ok)m(ed)j(with)d Fs(\()h
|
||||
Fj(command)39 b Fs(\))30 b Ft(inherit)g(the)1290 5066
|
||||
y Fs(ERROR)f Ft(trap.)630 5230 y Fs(extglob)144 b Ft(If)26
|
||||
b(set,)i(the)f(extended)f(pattern)h(matc)m(hing)g(features)g(describ)s
|
||||
(ed)e(ab)s(o)m(v)m(e)j(\(see)1110 5340 y(Section)j(3.5.8.1)i([P)m
|
||||
(attern)f(Matc)m(hing],)g(page)f(24\))h(are)f(enabled.)p
|
||||
eop end
|
||||
Fj(command)39 b Fs(\))30 b Ft(inherit)g(the)1290 5340
|
||||
y Fs(ERROR)f Ft(trap.)p eop end
|
||||
%%Page: 55 61
|
||||
TeXDict begin 55 60 bop 150 -116 a Ft(Chapter)30 b(4:)41
|
||||
b(Shell)30 b(Builtin)h(Commands)2069 b(55)630 299 y Fs(extquote)96
|
||||
b Ft(If)49 b(set,)54 b Fs($')p Fj(string)11 b Fs(')46
|
||||
b Ft(and)j Fs($")p Fj(string)11 b Fs(")46 b Ft(quoting)k(is)f(p)s
|
||||
(erformed)e(within)1110 408 y Fs(${)p Fj(parameter)11
|
||||
b Fs(})30 b Ft(expansions)j(enclosed)h(in)g(double)f(quotes.)51
|
||||
b(This)32 b(option)1110 518 y(is)e(enabled)h(b)m(y)f(default.)630
|
||||
693 y Fs(failglob)96 b Ft(If)30 b(set,)g(patterns)g(whic)m(h)g(fail)h
|
||||
(to)g(matc)m(h)g(\014lenames)f(during)e(pathname)i(ex-)1110
|
||||
803 y(pansion)g(result)g(in)g(an)g(expansion)h(error.)630
|
||||
978 y Fs(force_fignore)1110 1088 y Ft(If)43 b(set,)k(the)d(su\016xes)f
|
||||
b(Shell)30 b(Builtin)h(Commands)2069 b(55)630 299 y Fs(extglob)144
|
||||
b Ft(If)26 b(set,)i(the)f(extended)f(pattern)h(matc)m(hing)g(features)g
|
||||
(describ)s(ed)e(ab)s(o)m(v)m(e)j(\(see)1110 408 y(Section)j(3.5.8.1)i
|
||||
([P)m(attern)f(Matc)m(hing],)g(page)f(24\))h(are)f(enabled.)630
|
||||
558 y Fs(extquote)96 b Ft(If)49 b(set,)54 b Fs($')p Fj(string)11
|
||||
b Fs(')46 b Ft(and)j Fs($")p Fj(string)11 b Fs(")46 b
|
||||
Ft(quoting)k(is)f(p)s(erformed)e(within)1110 667 y Fs(${)p
|
||||
Fj(parameter)11 b Fs(})30 b Ft(expansions)j(enclosed)h(in)g(double)f
|
||||
(quotes.)51 b(This)32 b(option)1110 777 y(is)e(enabled)h(b)m(y)f
|
||||
(default.)630 927 y Fs(failglob)96 b Ft(If)30 b(set,)g(patterns)g(whic)
|
||||
m(h)g(fail)h(to)g(matc)m(h)g(\014lenames)f(during)e(pathname)i(ex-)1110
|
||||
1036 y(pansion)g(result)g(in)g(an)g(expansion)h(error.)630
|
||||
1186 y Fs(force_fignore)1110 1295 y Ft(If)43 b(set,)k(the)d(su\016xes)f
|
||||
(sp)s(eci\014ed)f(b)m(y)i(the)f Fs(FIGNORE)f Ft(shell)h(v)-5
|
||||
b(ariable)44 b(cause)1110 1198 y(w)m(ords)31 b(to)h(b)s(e)f(ignored)h
|
||||
b(ariable)44 b(cause)1110 1405 y(w)m(ords)31 b(to)h(b)s(e)f(ignored)h
|
||||
(when)f(p)s(erforming)f(w)m(ord)h(completion)i(ev)m(en)f(if)g(the)1110
|
||||
1307 y(ignored)37 b(w)m(ords)g(are)g(the)h(only)f(p)s(ossible)g
|
||||
(completions.)62 b(See)37 b(Section)h(5.2)1110 1417 y([Bash)24
|
||||
1514 y(ignored)37 b(w)m(ords)g(are)g(the)h(only)f(p)s(ossible)g
|
||||
(completions.)62 b(See)37 b(Section)h(5.2)1110 1624 y([Bash)24
|
||||
b(V)-8 b(ariables],)27 b(page)e(59,)h(for)d(a)h(description)g(of)g
|
||||
Fs(FIGNORE)p Ft(.)37 b(This)22 b(option)1110 1526 y(is)30
|
||||
b(enabled)h(b)m(y)f(default.)630 1702 y Fs(gnu_errfmt)1110
|
||||
1811 y Ft(If)35 b(set,)j(shell)e(error)g(messages)g(are)h(written)e(in)
|
||||
h(the)g(standard)f Fl(gnu)g Ft(error)1110 1921 y(message)c(format.)630
|
||||
2096 y Fs(histappend)1110 2206 y Ft(If)c(set,)j(the)e(history)g(list)g
|
||||
Fs(FIGNORE)p Ft(.)37 b(This)22 b(option)1110 1733 y(is)30
|
||||
b(enabled)h(b)m(y)f(default.)630 1883 y Fs(gnu_errfmt)1110
|
||||
1993 y Ft(If)35 b(set,)j(shell)e(error)g(messages)g(are)h(written)e(in)
|
||||
h(the)g(standard)f Fl(gnu)g Ft(error)1110 2102 y(message)c(format.)630
|
||||
2252 y Fs(histappend)1110 2361 y Ft(If)c(set,)j(the)e(history)g(list)g
|
||||
(is)g(app)s(ended)e(to)j(the)f(\014le)g(named)f(b)m(y)h(the)g(v)-5
|
||||
b(alue)29 b(of)1110 2315 y(the)d Fs(HISTFILE)d Ft(v)-5
|
||||
b(alue)29 b(of)1110 2471 y(the)d Fs(HISTFILE)d Ft(v)-5
|
||||
b(ariable)26 b(when)e(the)h(shell)h(exits,)h(rather)e(than)h(o)m(v)m
|
||||
(erwriting)1110 2425 y(the)31 b(\014le.)630 2600 y Fs(histreedit)1110
|
||||
2710 y Ft(If)i(set,)h(and)f(Readline)h(is)f(b)s(eing)g(used,)g(a)g
|
||||
(erwriting)1110 2580 y(the)31 b(\014le.)630 2730 y Fs(histreedit)1110
|
||||
2839 y Ft(If)i(set,)h(and)f(Readline)h(is)f(b)s(eing)g(used,)g(a)g
|
||||
(user)g(is)g(giv)m(en)h(the)g(opp)s(ortunit)m(y)1110
|
||||
2819 y(to)d(re-edit)g(a)g(failed)g(history)f(substitution.)630
|
||||
2995 y Fs(histverify)1110 3104 y Ft(If)35 b(set,)i(and)e(Readline)h(is)
|
||||
2949 y(to)d(re-edit)g(a)g(failed)g(history)f(substitution.)630
|
||||
3098 y Fs(histverify)1110 3208 y Ft(If)35 b(set,)i(and)e(Readline)h(is)
|
||||
f(b)s(eing)g(used,)h(the)f(results)g(of)g(history)h(substitu-)1110
|
||||
3214 y(tion)h(are)g(not)g(immediately)h(passed)e(to)h(the)g(shell)g
|
||||
(parser.)59 b(Instead,)38 b(the)1110 3324 y(resulting)i(line)f(is)h
|
||||
3318 y(tion)h(are)g(not)g(immediately)h(passed)e(to)h(the)g(shell)g
|
||||
(parser.)59 b(Instead,)38 b(the)1110 3427 y(resulting)i(line)f(is)h
|
||||
(loaded)g(in)m(to)g(the)g(Readline)g(editing)g(bu\013er,)h(allo)m(wing)
|
||||
1110 3433 y(further)29 b(mo)s(di\014cation.)630 3608
|
||||
y Fs(hostcomplete)1110 3718 y Ft(If)38 b(set,)j(and)c(Readline)i(is)f
|
||||
1110 3537 y(further)29 b(mo)s(di\014cation.)630 3686
|
||||
y Fs(hostcomplete)1110 3796 y Ft(If)38 b(set,)j(and)c(Readline)i(is)f
|
||||
(b)s(eing)g(used,)h(Bash)g(will)f(attempt)h(to)g(p)s(erform)1110
|
||||
3828 y(hostname)d(completion)h(when)e(a)h(w)m(ord)f(con)m(taining)i(a)f
|
||||
(`)p Fs(@)p Ft(')g(is)g(b)s(eing)f(com-)1110 3937 y(pleted)g(\(see)h
|
||||
3905 y(hostname)d(completion)h(when)e(a)h(w)m(ord)f(con)m(taining)i(a)f
|
||||
(`)p Fs(@)p Ft(')g(is)g(b)s(eing)f(com-)1110 4015 y(pleted)g(\(see)h
|
||||
(Section)f(8.4.6)i([Commands)d(F)-8 b(or)36 b(Completion],)g(page)g
|
||||
(107\).)1110 4047 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.)
|
||||
630 4222 y Fs(huponexit)1110 4332 y Ft(If)i(set,)i(Bash)f(will)h(send)d
|
||||
(107\).)1110 4125 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.)
|
||||
630 4274 y Fs(huponexit)1110 4384 y Ft(If)i(set,)i(Bash)f(will)h(send)d
|
||||
Fs(SIGHUP)h Ft(to)h(all)h(jobs)e(when)g(an)g(in)m(teractiv)m(e)k(login)
|
||||
1110 4441 y(shell)31 b(exits)g(\(see)g(Section)g(3.7.6)h([Signals],)g
|
||||
(page)f(31\).)630 4617 y Fs(interactive_comments)1110
|
||||
4726 y Ft(Allo)m(w)c(a)g(w)m(ord)e(b)s(eginning)g(with)h(`)p
|
||||
1110 4493 y(shell)31 b(exits)g(\(see)g(Section)g(3.7.6)h([Signals],)g
|
||||
(page)f(32\).)630 4643 y Fs(interactive_comments)1110
|
||||
4752 y Ft(Allo)m(w)c(a)g(w)m(ord)e(b)s(eginning)g(with)h(`)p
|
||||
Fs(#)p Ft(')g(to)h(cause)f(that)h(w)m(ord)f(and)f(all)i(remain-)1110
|
||||
4836 y(ing)41 b(c)m(haracters)i(on)e(that)h(line)g(to)g(b)s(e)f
|
||||
4862 y(ing)41 b(c)m(haracters)i(on)e(that)h(line)g(to)g(b)s(e)f
|
||||
(ignored)g(in)g(an)g(in)m(teractiv)m(e)j(shell.)1110
|
||||
4945 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.)630
|
||||
4971 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.)630
|
||||
5121 y Fs(lithist)144 b Ft(If)22 b(enabled,)i(and)d(the)h
|
||||
Fs(cmdhist)e Ft(option)j(is)f(enabled,)i(m)m(ulti-line)f(commands)1110
|
||||
5230 y(are)28 b(sa)m(v)m(ed)h(to)g(the)f(history)g(with)f(em)m(b)s
|
||||
@@ -9880,14 +9894,14 @@ b(Alias)31 b(expansion)g(\(see)g(Section)g(6.6)g([Aliases],)i(page)e
|
||||
(77\))h(is)e(p)s(erformed)f(b)m(y)h(default.)199 2191
|
||||
y(9.)61 b(In)24 b(the)g(absence)h(of)f(an)m(y)h(traps,)g(Bash)g
|
||||
(ignores)f Fs(SIGTERM)f Ft(\(see)i(Section)g(3.7.6)h([Signals],)g(page)
|
||||
f(31\).)154 2342 y(10.)61 b(In)26 b(the)h(absence)h(of)f(an)m(y)g
|
||||
f(32\).)154 2342 y(10.)61 b(In)26 b(the)h(absence)h(of)f(an)m(y)g
|
||||
(traps,)g Fs(SIGINT)e Ft(is)i(caugh)m(t)h(and)f(handled)e(\(\(see)k
|
||||
(Section)e(3.7.6)i([Signals],)330 2451 y(page)i(31\).)42
|
||||
(Section)e(3.7.6)i([Signals],)330 2451 y(page)i(32\).)42
|
||||
b Fs(SIGINT)29 b Ft(will)h(in)m(terrupt)g(some)h(shell)g(builtins.)154
|
||||
2602 y(11.)61 b(An)40 b(in)m(teractiv)m(e)j(login)e(shell)g(sends)e(a)i
|
||||
Fs(SIGHUP)d Ft(to)j(all)g(jobs)f(on)g(exit)h(if)g(the)f
|
||||
Fs(huponexit)e Ft(shell)330 2712 y(option)31 b(has)f(b)s(een)g(enabled)
|
||||
g(\(see)h(Section)g(3.7.6)i([Signals],)e(page)g(31\).)154
|
||||
g(\(see)h(Section)g(3.7.6)i([Signals],)e(page)g(32\).)154
|
||||
2863 y(12.)61 b(The)26 b(`)p Fs(-n)p Ft(')f(in)m(v)m(o)s(cation)k
|
||||
(option)d(is)g(ignored,)h(and)f(`)p Fs(set)k(-n)p Ft(')25
|
||||
b(has)h(no)g(e\013ect)i(\(see)e(Section)h(4.3.1)h([The)330
|
||||
@@ -15686,7 +15700,7 @@ g(.)h(.)f(.)42 b Fb(73)2025 1259 y(signal)14 b Fc(.)f(.)g(.)f(.)g(.)h
|
||||
h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)40
|
||||
b Fb(4)2025 1346 y(signal)27 b(handling)18 b Fc(.)13
|
||||
b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g
|
||||
(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)44 b Fb(31)2025
|
||||
(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)44 b Fb(32)2025
|
||||
1433 y(sp)r(ecial)27 b(builtin)12 b Fc(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g
|
||||
(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)
|
||||
g(.)g(.)h(.)38 b Fb(4,)26 b(57)2025 1521 y(startup)f(\014les)20
|
||||
|
||||
Reference in New Issue
Block a user