diff options
Diffstat (limited to 'doc/builtins.ps')
| -rw-r--r-- | doc/builtins.ps | 1344 |
1 files changed, 677 insertions, 667 deletions
diff --git a/doc/builtins.ps b/doc/builtins.ps index 2a0a4795..2867ac15 100644 --- a/doc/builtins.ps +++ b/doc/builtins.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.22.4 -%%CreationDate: Mon Jun 13 11:04:35 2022 +%%CreationDate: Fri Aug 12 11:28:42 2022 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -668,12 +668,11 @@ F1<ad44>3.208 E F0(,)A F1<ad45>144 108 Q F0 2.604(,o)C(r)-2.604 E F1 (guments are ignored; these completions only apply to the)-.18 F (case speci\214ed by the option.)144 120 Q .152 (The process of applying these completion speci\214cations when w)144 -144 R .153(ord completion is attempted is de-)-.1 F(scribed abo)144 156 -Q .3 -.15(ve u)-.15 H(nder).15 E F1(Pr)2.5 E(ogrammable Completion)-.18 -E F0(.)A .556(Other options, if speci\214ed, ha)144 180 R .856 -.15 -(ve t)-.2 H .555(he follo).15 F .555(wing meanings.)-.25 F .555(The ar) -5.555 F .555(guments to the)-.18 F F1<ad47>3.055 E F0(,)A F1<ad57>3.055 -E F0 3.055(,a)C(nd)-3.055 E F1<ad58>3.055 E F0 .722 +144 R .153(ord completion is attempted is de-)-.1 F(scribed in)144 156 Q +F2(bash\(1\))2.5 E F0(.)A .556(Other options, if speci\214ed, ha)144 180 +R .856 -.15(ve t)-.2 H .555(he follo).15 F .555(wing meanings.)-.25 F +.555(The ar)5.555 F .555(guments to the)-.18 F F1<ad47>3.055 E F0(,)A F1 +<ad57>3.055 E F0 3.055(,a)C(nd)-3.055 E F1<ad58>3.055 E F0 .722 (options \(and, if necessary)144 192 R 3.222(,t)-.65 G(he)-3.222 E F1 <ad50>3.222 E F0(and)3.222 E F1<ad53>3.222 E F0 .723 (options\) should be quoted to protect them from e)3.222 F(xpan-)-.15 E @@ -760,8 +759,9 @@ E F0(option to the)2.5 E F1(set)2.5 E F0 -.2(bu)2.5 G(iltin.).2 E F1 (also be speci\214ed as)2.5 E F1<ad76>2.5 E F0(.)A F1<ad43>144 264 Q/F3 10/Times-Italic@0 SF(command)2.5 E(command)184 276 Q F0 1.056(is e)3.556 F -.15(xe)-.15 G 1.056(cuted in a subshell en).15 F 1.056 -(vironment, and its output is used as the possible)-.4 F(completions.) -184 288 Q F1<ad46>144 300 Q F3(function)2.5 E F0 .113 +(vironment, and its output is used as the possible)-.4 F 2.5 +(completions. Ar)184 288 R(guments are passed as with the)-.18 E F1 +<ad46>2.5 E F0(option.)2.5 E F1<ad46>144 300 Q F3(function)2.5 E F0 .113 (The shell function)184 312 R F3(function)2.614 E F0 .114(is e)2.614 F -.15(xe)-.15 G .114(cuted in the current shell en).15 F 2.614 (vironment. When)-.4 F .114(the func-)2.614 F .817(tion is e)184 324 R @@ -923,22 +923,23 @@ F .694(alue of an)-.25 F 3.194(ye)-.15 G .694(xisting v)-3.344 F -.2 E .3 -.15(ve v)-.25 H(ariables attrib)-.1 E(utes:)-.2 E F1<ad61>144 429.6 Q F0(Each)180 429.6 Q F2(name)2.5 E F0(is an inde)2.5 E -.15(xe) -.15 G 2.5(da).15 G(rray v)-2.5 E(ariable \(see)-.25 E F1(Arrays)2.5 E -F0(abo)2.5 E -.15(ve)-.15 G(\).).15 E F1<ad41>144 441.6 Q F0(Each)180 +F0(in)2.5 E F2(bash\(1\))2.5 E F0(\).)A F1<ad41>144 441.6 Q F0(Each)180 441.6 Q F2(name)2.5 E F0(is an associati)2.5 E .3 -.15(ve a)-.25 H -(rray v).15 E(ariable \(see)-.25 E F1(Arrays)2.5 E F0(abo)2.5 E -.15(ve) --.15 G(\).).15 E F1<ad66>144 453.6 Q F0(Use function names only)180 -453.6 Q(.)-.65 E F1<ad69>144 465.6 Q F0 .558(The v)180 465.6 R .558 -(ariable is treated as an inte)-.25 F .558(ger; arithmetic e)-.15 F -.25 -(va)-.25 G .558(luation \(see).25 F/F4 9/Times-Bold@0 SF .557 -(ARITHMETIC EV)3.058 F(ALU)-1.215 E(A-)-.54 E(TION)180 477.6 Q F0(abo) -2.25 E -.15(ve)-.15 G 2.5(\)i).15 G 2.5(sp)-2.5 G(erformed when the v) --2.5 E(ariable is assigned a v)-.25 E(alue.)-.25 E F1<ad6c>144 489.6 Q -F0 .909(When the v)180 489.6 R .909(ariable is assigned a v)-.25 F .909 -(alue, all upper)-.25 F .909(-case characters are con)-.2 F -.15(ve)-.4 -G .91(rted to lo).15 F(wer)-.25 E(-)-.2 E 2.5(case. The)180 501.6 R -(upper)2.5 E(-case attrib)-.2 E(ute is disabled.)-.2 E F1<ad6e>144 513.6 -Q F0(Gi)180 513.6 Q 1.62 -.15(ve e)-.25 H(ach).15 E F2(name)3.82 E F0 -(the)3.82 E F2(namer)3.819 E(ef)-.37 E F0(attrib)3.819 E 1.319 +(rray v).15 E(ariable \(see)-.25 E F1(Arrays)2.5 E F0(in)2.5 E F2 +(bash\(1\))2.5 E F0(\).)A F1<ad66>144 453.6 Q F0 +(Use function names only)180 453.6 Q(.)-.65 E F1<ad69>144 465.6 Q F0 +.558(The v)180 465.6 R .558(ariable is treated as an inte)-.25 F .558 +(ger; arithmetic e)-.15 F -.25(va)-.25 G .558(luation \(see).25 F/F4 9 +/Times-Bold@0 SF .557(ARITHMETIC EV)3.058 F(ALU)-1.215 E(A-)-.54 E(TION) +180 477.6 Q F0(in)2.25 E F2(bash\(1\))2.5 E F0 2.5(\)i)C 2.5(sp)-2.5 G +(erformed when the v)-2.5 E(ariable is assigned a v)-.25 E(alue.)-.25 E +F1<ad6c>144 489.6 Q F0 .909(When the v)180 489.6 R .909 +(ariable is assigned a v)-.25 F .909(alue, all upper)-.25 F .909 +(-case characters are con)-.2 F -.15(ve)-.4 G .91(rted to lo).15 F(wer) +-.25 E(-)-.2 E 2.5(case. The)180 501.6 R(upper)2.5 E(-case attrib)-.2 E +(ute is disabled.)-.2 E F1<ad6e>144 513.6 Q F0(Gi)180 513.6 Q 1.62 -.15 +(ve e)-.25 H(ach).15 E F2(name)3.82 E F0(the)3.82 E F2(namer)3.819 E(ef) +-.37 E F0(attrib)3.819 E 1.319 (ute, making it a name reference to another v)-.2 F(ariable.)-.25 E .477 (That other v)180 525.6 R .478(ariable is de\214ned by the v)-.25 F .478 (alue of)-.25 F F2(name)2.978 E F0 5.478(.A)C .478 @@ -998,10 +999,10 @@ is encountered, an attempt is made to de\214ne a function using).25 F/F1 G(t-)-2.866 E .549(tempt is made to assign a v)144 96 R .549 (alue to a readonly v)-.25 F .548 (ariable, an attempt is made to assign a v)-.25 F .548(alue to an)-.25 F -1.748(array v)144 108 R 1.748 +.391(array v)144 108 R .391 (ariable without using the compound assignment syntax \(see)-.25 F/F2 10 -/Times-Bold@0 SF(Arrays)4.249 E F0(abo)4.249 E -.15(ve)-.15 G 1.749 -(\), one of the).15 F/F3 10/Times-Italic@0 SF(names)144 120 Q F0 .359 +/Times-Bold@0 SF(Arrays)2.892 E F0(in)2.892 E/F3 10/Times-Italic@0 SF +(bash\(1\))2.892 E F0 .392(\), one of the)B F3(names)144 120 Q F0 .359 (is not a v)2.859 F .359(alid shell v)-.25 F .359 (ariable name, an attempt is made to turn of)-.25 F 2.859(fr)-.25 G .359 (eadonly status for a read-)-2.859 F 1.212(only v)144 132 R 1.213 @@ -1588,14 +1589,14 @@ G .962(lent to).25 F F1<ad6c>3.462 E F0(.)A F1(kill)5.962 E F0 .962 (successfully sent, or f)144 540 Q(alse if an error occurs or an in)-.1 E -.25(va)-.4 G(lid option is encountered.).25 E F1(let)108 556.8 Q F2 (ar)2.5 E(g)-.37 E F0([)2.5 E F2(ar)A(g)-.37 E F0(...])2.5 E(Each)144 -568.8 Q F2(ar)3.026 E(g)-.37 E F0 .196(is an arithmetic e)2.916 F .197 -(xpression to be e)-.15 F -.25(va)-.25 G .197(luated \(see).25 F F3 .197 -(ARITHMETIC EV)2.697 F(ALU)-1.215 E -.855(AT)-.54 G(ION).855 E F0(abo) -2.447 E -.15(ve)-.15 G 2.697(\). If).15 F(the last)144 580.8 Q F2(ar) -2.83 E(g)-.37 E F0 -.25(eva)2.72 G(luates to 0,).25 E F1(let)2.5 E F0 -(returns 1; 0 is returned otherwise.)2.5 E F1(local)108 597.6 Q F0([)2.5 -E F2(option)A F0 2.5(][)C F2(name)-2.5 E F0([=)A F2(value)A F0 2.5(].)C -(.. | \255 ])-2.5 E -.15(Fo)144 609.6 S 2.542(re).15 G .042(ach ar) +568.8 Q F2(ar)5.817 E(g)-.37 E F0 2.987(is an arithmetic e)5.707 F 2.987 +(xpression to be e)-.15 F -.25(va)-.25 G 2.987(luated \(see).25 F F3 +2.987(ARITHMETIC EV)5.487 F(ALU)-1.215 E -.855(AT)-.54 G(ION).855 E F0 +(in)5.238 E F2(bash\(1\))144 580.8 Q F0 2.5(\). If)B(the last)2.5 E F2 +(ar)2.83 E(g)-.37 E F0 -.25(eva)2.72 G(luates to 0,).25 E F1(let)2.5 E +F0(returns 1; 0 is returned otherwise.)2.5 E F1(local)108 597.6 Q F0([) +2.5 E F2(option)A F0 2.5(][)C F2(name)-2.5 E F0([=)A F2(value)A F0 2.5 +(].)C(.. | \255 ])-2.5 E -.15(Fo)144 609.6 S 2.542(re).15 G .042(ach ar) -2.542 F .042(gument, a local v)-.18 F .042(ariable named)-.25 F F2 (name)2.902 E F0 .042(is created, and assigned)2.722 F F2(value)2.832 E F0 5.042(.T).18 G(he)-5.042 E F2(option)2.542 E F0 .041(can be)2.541 F @@ -1865,14 +1866,14 @@ F2(pr)3.817 E(ompt)-.45 E F0 3.817(][)C F1<ad74>-3.817 E F2(timeout) Q F2(name)A F0(...])2.5 E .516(One line is read from the standard input\ , or from the \214le descriptor)144 703.2 R F2(fd)3.016 E F0 .516 (supplied as an ar)3.016 F .516(gument to)-.18 F(the)144 715.2 Q F1 -<ad75>2.935 E F0 .435(option, split into w)2.935 F .435 -(ords as described abo)-.1 F .735 -.15(ve u)-.15 H(nder).15 E F1 -.75 -(Wo)2.935 G .435(rd Splitting).75 F F0 2.935(,a)C .436(nd the \214rst w) --2.935 F .436(ord is as-)-.1 F .376(signed to the \214rst)144 727.2 R F2 -(name)3.236 E F0 2.876(,t).18 G .376(he second w)-2.876 F .376 -(ord to the second)-.1 F F2(name)3.236 E F0 2.876(,a).18 G .376 -(nd so on.)-2.876 F .375(If there are more w)5.376 F(ords)-.1 E -(GNU Bash 5.2)72 768 Q(2021 No)136.385 E -.15(ve)-.15 G(mber 22).15 E +<ad75>2.753 E F0 .253(option, split into w)2.753 F .253 +(ords as described in)-.1 F F2(bash\(1\))2.754 E F0(under)2.754 E F1 +-.75(Wo)2.754 G .254(rd Splitting).75 F F0 2.754(,a)C .254 +(nd the \214rst w)-2.754 F .254(ord is)-.1 F 1.425 +(assigned to the \214rst)144 727.2 R F2(name)4.285 E F0 3.925(,t).18 G +1.425(he second w)-3.925 F 1.425(ord to the second)-.1 F F2(name)4.285 E +F0 3.925(,a).18 G 1.425(nd so on.)-3.925 F 1.425(If there are more)6.425 +F(GNU Bash 5.2)72 768 Q(2021 No)136.385 E -.15(ve)-.15 G(mber 22).15 E (13)185.545 E 0 Cg EP %%Page: 14 14 %%BeginPageSetup @@ -1880,22 +1881,23 @@ BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 87.61 (TINS\(1\) General)-.92 F(Commands Manual)2.5 E -.35(BA)90.11 G(SH_B).35 -E(UIL)-.1 E(TINS\(1\))-.92 E .236(than names, the remaining w)144 84 R -.237(ords and their interv)-.1 F .237 -(ening delimiters are assigned to the last)-.15 F/F1 10/Times-Italic@0 -SF(name)3.097 E F0 5.237(.I).18 G(f)-5.237 E .875(there are fe)144 96 R -.875(wer w)-.25 F .875(ords read from the input stream than names, the \ -remaining names are assigned)-.1 F .517(empty v)144 108 R 3.017 -(alues. The)-.25 F .517(characters in)3.017 F/F2 9/Times-Bold@0 SF(IFS) -3.017 E F0 .518(are used to split the line into w)2.767 F .518 -(ords using the same rules the)-.1 F .027(shell uses for e)144 120 R -.026(xpansion \(described abo)-.15 F .326 -.15(ve u)-.15 H(nder).15 E/F3 -10/Times-Bold@0 SF -.75(Wo)2.526 G .026(rd Splitting).75 F F0 2.526 -(\). The)B .026(backslash character \()2.526 F F3(\\)A F0 2.526(\)m)C -(ay)-2.526 E .488(be used to remo)144 132 R .788 -.15(ve a)-.15 H .788 --.15(ny s).15 H .488(pecial meaning for the ne).15 F .488 -(xt character read and for line continuation.)-.15 F(Op-)5.489 E -(tions, if supplied, ha)144 144 Q .3 -.15(ve t)-.2 H(he follo).15 E +E(UIL)-.1 E(TINS\(1\))-.92 E -.1(wo)144 84 S 1.112 +(rds than names, the remaining w).1 F 1.112(ords and their interv)-.1 F +1.112(ening delimiters are assigned to the last)-.15 F/F1 10 +/Times-Italic@0 SF(name)144.36 96 Q F0 5.7(.I).18 G 3.2(ft)-5.7 G .7 +(here are fe)-3.2 F .7(wer w)-.25 F .7 +(ords read from the input stream than names, the remaining names are)-.1 +F .531(assigned empty v)144 108 R 3.031(alues. The)-.25 F .531 +(characters in)3.031 F/F2 9/Times-Bold@0 SF(IFS)3.031 E F0 .532 +(are used to split the line into w)2.781 F .532(ords using the same)-.1 +F 1.326(rules the shell uses for e)144 120 R 1.325 +(xpansion \(described in)-.15 F F1(bash\(1\))3.825 E F0(under)3.825 E/F3 +10/Times-Bold@0 SF -.75(Wo)3.825 G 1.325(rd Splitting).75 F F0 3.825 +(\). The)B(backslash)3.825 E .738(character \()144 132 R F3(\\)A F0 +3.238(\)m)C .739(ay be used to remo)-3.238 F 1.039 -.15(ve a)-.15 H +1.039 -.15(ny s).15 H .739(pecial meaning for the ne).15 F .739 +(xt character read and for line)-.15 F 2.5(continuation. Options,)144 +144 R(if supplied, ha)2.5 E .3 -.15(ve t)-.2 H(he follo).15 E (wing meanings:)-.25 E F3<ad61>144 156 Q F1(aname)2.5 E F0 1.026(The w) 180 168 R 1.026(ords are assigned to sequential indices of the array v) -.1 F(ariable)-.25 E F1(aname)3.855 E F0 3.525(,s).18 G 1.025 @@ -1907,15 +1909,16 @@ F0 .281(is used to terminate the input line, rather than ne)2.78 F 2.781 (wline. If)-.25 F F1(de-)2.781 E(lim)180 216 Q F0(is the empty string,) 2.5 E F3 -.18(re)2.5 G(ad).18 E F0 (will terminate a line when it reads a NUL character)2.5 E(.)-.55 E F3 -<ad65>144 228 Q F0 .373 +<ad65>144 228 Q F0 .629 (If the standard input is coming from a terminal,)180 228 R F3 -.18(re) -2.873 G(adline).18 E F0(\(see)2.873 E F2(READLINE)2.872 E F0(abo)2.622 E --.15(ve)-.15 G 2.872(\)i).15 G 2.872(su)-2.872 G(sed)-2.872 E .218 -(to obtain the line.)180 240 R .218(Readline uses the current \(or def) -5.218 F .218(ault, if line editing w)-.1 F .218(as not pre)-.1 F -(viously)-.25 E(acti)180 252 Q -.15(ve)-.25 G 2.5(\)e).15 G -(diting settings, b)-2.5 E(ut uses Readline')-.2 E 2.5(sd)-.55 G(ef)-2.5 -E(ault \214lename completion.)-.1 E F3<ad69>144 264 Q F1(te)2.5 E(xt)-.2 +3.128 G(adline).18 E F0(\(see)3.128 E F2(READLINE)3.128 E F0(in)2.878 E +F1(bash\(1\))3.128 E F0 3.128(\)i)C(s)-3.128 E .048 +(used to obtain the line.)180 240 R .049 +(Readline uses the current \(or def)5.049 F .049 +(ault, if line editing w)-.1 F .049(as not pre)-.1 F(vi-)-.25 E +(ously acti)180 252 Q -.15(ve)-.25 G 2.5(\)e).15 G(diting settings, b) +-2.5 E(ut uses Readline')-.2 E 2.5(sd)-.55 G(ef)-2.5 E +(ault \214lename completion.)-.1 E F3<ad69>144 264 Q F1(te)2.5 E(xt)-.2 E F0(If)180 264 Q F3 -.18(re)2.716 G(adline).18 E F0 .216 (is being used to read the line,)2.716 F F1(te)2.716 E(xt)-.2 E F0 .216 (is placed into the editing b)2.716 F(uf)-.2 E .215(fer before edit-) @@ -2099,46 +2102,45 @@ E(vironment of subsequent commands.)-.4 E F1<ad62>144 453.6 Q F0 .132 .087(Exit immediately if a)184 477.6 R F2(pipeline)2.587 E F0 .087 (\(which may consist of a single)2.587 F F2 .088(simple command)2.588 F F0 .088(\), a)B F2(list)2.588 E F0 2.588(,o)C(r)-2.588 E(a)184 489.6 Q -F2 1.521(compound command)4.021 F F0(\(see)4.021 E/F3 9/Times-Bold@0 SF -1.521(SHELL GRAMMAR)4.021 F F0(abo)3.771 E -.15(ve)-.15 G 1.521(\), e) -.15 F 1.521(xits with a non-zero status.)-.15 F .079 -(The shell does not e)184 501.6 R .079(xit if the command that f)-.15 F -.08(ails is part of the command list immediately)-.1 F(follo)184 513.6 Q -1.655(wing a)-.25 F F1(while)4.155 E F0(or)4.155 E F1(until)4.155 E F0 --.1(ke)4.155 G(yw)-.05 E 1.655(ord, part of the test follo)-.1 F 1.654 -(wing the)-.25 F F1(if)4.154 E F0(or)4.154 E F1(elif)4.154 E F0(reserv) -4.154 E(ed)-.15 E -.1(wo)184 525.6 S .581(rds, part of an).1 F 3.081(yc) --.15 G .581(ommand e)-3.081 F -.15(xe)-.15 G .581(cuted in a).15 F F1 -(&&)3.081 E F0(or)3.081 E F1(||)3.081 E F0 .582(list e)3.082 F .582 -(xcept the command follo)-.15 F(wing)-.25 E .918(the \214nal)184 537.6 R -F1(&&)3.418 E F0(or)3.418 E F1(||)3.418 E F0 3.418(,a)C 1.218 -.15(ny c) --3.418 H .918(ommand in a pipeline b).15 F .917 -(ut the last, or if the command')-.2 F 3.417(sr)-.55 G(eturn)-3.417 E --.25(va)184 549.6 S .66(lue is being in).25 F -.15(ve)-.4 G .66 -(rted with).15 F F1(!)3.16 E F0 5.661(.I)C 3.161(fac)-5.661 G .661 -(ompound command other than a subshell returns a)-3.161 F 1.113 -(non-zero status because a command f)184 561.6 R 1.112(ailed while)-.1 F -F1<ad65>3.612 E F0 -.1(wa)3.612 G 3.612(sb).1 G 1.112 -(eing ignored, the shell does)-3.612 F .177(not e)184 573.6 R 2.677 -(xit. A)-.15 F .177(trap on)2.677 F F1(ERR)2.677 E F0 2.677(,i)C 2.678 -(fs)-2.677 G .178(et, is e)-2.678 F -.15(xe)-.15 G .178 -(cuted before the shell e).15 F 2.678(xits. This)-.15 F .178 -(option applies to)2.678 F .618(the shell en)184 585.6 R .617 -(vironment and each subshell en)-.4 F .617(vironment separately \(see) --.4 F F3 .617(COMMAND EXE-)3.117 F .642(CUTION ENVIR)184 597.6 R(ONMENT) --.27 E F0(abo)2.893 E -.15(ve)-.15 G .643 -(\), and may cause subshells to e).15 F .643(xit before e)-.15 F -.15 -(xe)-.15 G .643(cuting all).15 F(the commands in the subshell.)184 609.6 -Q .999(If a compound command or shell function e)184 627.6 R -.15(xe) --.15 G .999(cutes in a conte).15 F .998(xt where)-.15 F F1<ad65>3.498 E -F0 .998(is being ig-)3.498 F .089(nored, none of the commands e)184 -639.6 R -.15(xe)-.15 G .089 -(cuted within the compound command or function body).15 F .503 -(will be af)184 651.6 R .503(fected by the)-.25 F F1<ad65>3.002 E F0 -.502(setting, e)3.002 F -.15(ve)-.25 G 3.002(ni).15 G(f)-3.002 E F1 -<ad65>3.002 E F0 .502(is set and a command returns a f)3.002 F .502 -(ailure sta-)-.1 F 4.183(tus. If)184 663.6 R 4.183(ac)4.183 G 1.683 -(ompound command or shell function sets)-4.183 F F1<ad65>4.184 E F0 +F2 .86(compound command)3.36 F F0(\(see)3.36 E/F3 9/Times-Bold@0 SF .86 +(SHELL GRAMMAR)3.36 F F0(in)3.11 E F2(bash\(1\))3.36 E F0 .86(\), e)B +.86(xits with a non-zero sta-)-.15 F 2.852(tus. The)184 501.6 R .352 +(shell does not e)2.852 F .352(xit if the command that f)-.15 F .353 +(ails is part of the command list imme-)-.1 F 1.108(diately follo)184 +513.6 R 1.108(wing a)-.25 F F1(while)3.608 E F0(or)3.608 E F1(until) +3.608 E F0 -.1(ke)3.608 G(yw)-.05 E 1.107(ord, part of the test follo) +-.1 F 1.107(wing the)-.25 F F1(if)3.607 E F0(or)3.607 E F1(elif)3.607 E +F0(re-)3.607 E(serv)184 525.6 Q .279(ed w)-.15 F .279(ords, part of an) +-.1 F 2.779(yc)-.15 G .279(ommand e)-2.779 F -.15(xe)-.15 G .279 +(cuted in a).15 F F1(&&)2.779 E F0(or)2.779 E F1(||)2.78 E F0 .28 +(list e)2.78 F .28(xcept the command fol-)-.15 F(lo)184 537.6 Q .703 +(wing the \214nal)-.25 F F1(&&)3.203 E F0(or)3.203 E F1(||)3.203 E F0 +3.203(,a)C 1.003 -.15(ny c)-3.203 H .703(ommand in a pipeline b).15 F +.703(ut the last, or if the command')-.2 F(s)-.55 E .476(return v)184 +549.6 R .476(alue is being in)-.25 F -.15(ve)-.4 G .476(rted with).15 F +F1(!)2.976 E F0 5.476(.I)C 2.976(fac)-5.476 G .476 +(ompound command other than a subshell re-)-2.976 F .418 +(turns a non-zero status because a command f)184 561.6 R .418 +(ailed while)-.1 F F1<ad65>2.918 E F0 -.1(wa)2.918 G 2.918(sb).1 G .417 +(eing ignored, the shell)-2.918 F .472(does not e)184 573.6 R 2.972 +(xit. A)-.15 F .472(trap on)2.972 F F1(ERR)2.972 E F0 2.972(,i)C 2.972 +(fs)-2.972 G .472(et, is e)-2.972 F -.15(xe)-.15 G .473 +(cuted before the shell e).15 F 2.973(xits. This)-.15 F .473(option ap-) +2.973 F 2.114(plies to the shell en)184 585.6 R 2.113 +(vironment and each subshell en)-.4 F 2.113(vironment separately \(see) +-.4 F F3(COM-)4.613 E .675(MAND EXECUTION ENVIR)184 597.6 R(ONMENT)-.27 +E F0(in)2.925 E F2(bash\(1\))3.175 E F0 .675 +(\), and may cause subshells to e)B .676(xit be-)-.15 F(fore e)184 609.6 +Q -.15(xe)-.15 G(cuting all the commands in the subshell.).15 E .999 +(If a compound command or shell function e)184 627.6 R -.15(xe)-.15 G +.999(cutes in a conte).15 F .998(xt where)-.15 F F1<ad65>3.498 E F0 .998 +(is being ig-)3.498 F .089(nored, none of the commands e)184 639.6 R +-.15(xe)-.15 G .089(cuted within the compound command or function body) +.15 F .503(will be af)184 651.6 R .503(fected by the)-.25 F F1<ad65> +3.002 E F0 .502(setting, e)3.002 F -.15(ve)-.25 G 3.002(ni).15 G(f) +-3.002 E F1<ad65>3.002 E F0 .502(is set and a command returns a f)3.002 +F .502(ailure sta-)-.1 F 4.183(tus. If)184 663.6 R 4.183(ac)4.183 G +1.683(ompound command or shell function sets)-4.183 F F1<ad65>4.184 E F0 1.684(while e)4.184 F -.15(xe)-.15 G 1.684(cuting in a conte).15 F(xt) -.15 E(where)184 675.6 Q F1<ad65>3.154 E F0 .654 (is ignored, that setting will not ha)3.154 F .953 -.15(ve a)-.2 H .953 @@ -2163,19 +2165,19 @@ F .513(vironment for a)-.4 F (command, not just those that precede the command name.)184 96 Q F1 <ad6d>144 108 Q F0 .148(Monitor mode.)184 108 R .148 (Job control is enabled.)5.148 F .149(This option is on by def)5.148 F -.149(ault for interacti)-.1 F .449 -.15(ve s)-.25 H(hells).15 E .651 -(on systems that support it \(see)184 120 R/F2 9/Times-Bold@0 SF .651 -(JOB CONTR)3.151 F(OL)-.27 E F0(abo)2.901 E -.15(ve)-.15 G 3.151 -(\). All).15 F .65(processes run in a separate)3.151 F .678 -(process group.)184 132 R .679(When a background job completes, the she\ -ll prints a line containing its)5.678 F -.15(ex)184 144 S(it status.).15 -E F1<ad6e>144 156 Q F0 .653(Read commands b)184 156 R .653(ut do not e) --.2 F -.15(xe)-.15 G .653(cute them.).15 F .652 -(This may be used to check a shell script for)5.653 F(syntax errors.)184 -168 Q(This is ignored by interacti)5 E .3 -.15(ve s)-.25 H(hells.).15 E -F1<ad6f>144 180 Q/F3 10/Times-Italic@0 SF(option\255name)2.5 E F0(The) -184 192 Q F3(option\255name)2.5 E F0(can be one of the follo)2.5 E -(wing:)-.25 E F1(allexport)184 204 Q F0(Same as)224 216 Q F1<ad61>2.5 E +.149(ault for interacti)-.1 F .449 -.15(ve s)-.25 H(hells).15 E .235 +(on systems that support it \(see)184 120 R/F2 9/Times-Bold@0 SF .235 +(JOB CONTR)2.735 F(OL)-.27 E F0(in)2.485 E/F3 10/Times-Italic@0 SF +(bash\(1\))2.735 E F0 2.735(\). All)B .234(processes run in a sepa-) +2.735 F .252(rate process group.)184 132 R .252 +(When a background job completes, the shell prints a line containing) +5.252 F(its e)184 144 Q(xit status.)-.15 E F1<ad6e>144 156 Q F0 .653 +(Read commands b)184 156 R .653(ut do not e)-.2 F -.15(xe)-.15 G .653 +(cute them.).15 F .652(This may be used to check a shell script for) +5.653 F(syntax errors.)184 168 Q(This is ignored by interacti)5 E .3 +-.15(ve s)-.25 H(hells.).15 E F1<ad6f>144 180 Q F3(option\255name)2.5 E +F0(The)184 192 Q F3(option\255name)2.5 E F0(can be one of the follo)2.5 +E(wing:)-.25 E F1(allexport)184 204 Q F0(Same as)224 216 Q F1<ad61>2.5 E F0(.)A F1(braceexpand)184 228 Q F0(Same as)224 240 Q F1<ad42>2.5 E F0(.) A F1(emacs)184 252 Q F0 .089 (Use an emacs-style command line editing interf)224 252 R 2.589 @@ -2189,16 +2191,16 @@ F0 2.5(option. This)224 276 R(also af)2.5 E(fects the editing interf) (functrace)184 312 Q F0(Same as)224 324 Q F1<ad54>2.5 E F0(.)A F1 (hashall)184 336 Q F0(Same as)224 336 Q F1<ad68>2.5 E F0(.)A F1 (histexpand)184 348 Q F0(Same as)224 360 Q F1<ad48>2.5 E F0(.)A F1 -(history)184 372 Q F0 .586(Enable command history)224 372 R 3.087(,a) --.65 G 3.087(sd)-3.087 G .587(escribed abo)-3.087 F .887 -.15(ve u)-.15 -H(nder).15 E F2(HIST)3.087 E(OR)-.162 E(Y)-.315 E/F4 9/Times-Roman@0 SF -(.)A F0 .587(This option is)5.087 F(on by def)224 384 Q +(history)184 372 Q F0 1.001(Enable command history)224 372 R 3.502(,a) +-.65 G 3.502(sd)-3.502 G 1.002(escribed in)-3.502 F F3(bash\(1\))3.502 E +F0(under)3.502 E F2(HIST)3.502 E(OR)-.162 E(Y)-.315 E/F4 9/Times-Roman@0 +SF(.)A F0 1.002(This op-)5.502 F(tion is on by def)224 384 Q (ault in interacti)-.1 E .3 -.15(ve s)-.25 H(hells.).15 E F1(ignor)184 396 Q(eeof)-.18 E F0 1.657(The ef)224 408 R 1.657 (fect is as if the shell command)-.25 F/F5 10/Courier@0 SF(IGNOREEOF=10) 4.156 E F0 1.656(had been e)4.156 F -.15(xe)-.15 G(cuted).15 E(\(see)224 -420 Q F1(Shell V)2.5 E(ariables)-.92 E F0(abo)2.5 E -.15(ve)-.15 G(\).) -.15 E F1 -.1(ke)184 432 S(yw).1 E(ord)-.1 E F0(Same as)224 444 Q F1 +420 Q F1(Shell V)2.5 E(ariables)-.92 E F0(in)2.5 E F3(bash\(1\))2.5 E F0 +(\).)A F1 -.1(ke)184 432 S(yw).1 E(ord)-.1 E F0(Same as)224 444 Q F1 <ad6b>2.5 E F0(.)A F1(monitor)184 456 Q F0(Same as)224 456 Q F1<ad6d>2.5 E F0(.)A F1(noclob)184 468 Q(ber)-.1 E F0(Same as)224 480 Q F1<ad43>2.5 E F0(.)A F1(noexec)184 492 Q F0(Same as)224 492 Q F1<ad6e>2.5 E F0(.)A @@ -2216,13 +2218,13 @@ R 1.136 (his option is disabled by def)-5 E(ault.)-.1 E F1(posix)184 612 Q F0 2.09(Change the beha)224 612 R 2.091(vior of)-.2 F F1(bash)4.591 E F0 2.091(where the def)4.591 F 2.091(ault operation dif)-.1 F 2.091 -(fers from the)-.25 F 1.212(POSIX standard to match the standard \()224 -624 R F3 1.212(posix mode)B F0 3.712(\). See)B F2 1.212(SEE ALSO)3.712 F -F0(belo)3.462 E(w)-.25 E .954 -(for a reference to a document that details ho)224 636 R 3.455(wp)-.25 G -.955(osix mode af)-3.455 F .955(fects bash')-.25 F 3.455(sb)-.55 G(e-) --3.455 E(ha)224 648 Q(vior)-.2 E(.)-.55 E F1(pri)184 660 Q(vileged)-.1 E -F0(Same as)224 672 Q F1<ad70>2.5 E F0(.)A F1 -.1(ve)184 684 S(rbose).1 E +(fers from the)-.25 F 2.704(POSIX standard to match the standard \()224 +624 R F3 2.704(posix mode)B F0 5.204(\). See)B F2 2.704(SEE ALSO)5.204 F +F0(in)4.953 E F3(bash\(1\))224 636 Q F0 1.844 +(for a reference to a document that details ho)4.344 F 4.344(wp)-.25 G +1.845(osix mode af)-4.344 F(fects)-.25 E(bash')224 648 Q 2.5(sb)-.55 G +(eha)-2.5 E(vior)-.2 E(.)-.55 E F1(pri)184 660 Q(vileged)-.1 E F0 +(Same as)224 672 Q F1<ad70>2.5 E F0(.)A F1 -.1(ve)184 684 S(rbose).1 E F0(Same as)224 684 Q F1<ad76>2.5 E F0(.)A F1(vi)184 696 Q F0 .209 (Use a vi-style command line editing interf)224 696 R 2.709(ace. This) -.1 F .209(also af)2.709 F .209(fects the editing in-)-.25 F(terf)224 @@ -2286,9 +2288,9 @@ F0(command,)2.815 E 1.236(or arithmetic)184 330 R F1 -.25(fo)3.736 G(r) 1.236(alue of)-.25 F F3(PS4)3.736 E F4(,)A F0(follo)3.486 E 1.236 (wed by the com-)-.25 F(mand and its e)184 342 Q(xpanded ar)-.15 E (guments or associated w)-.18 E(ord list.)-.1 E F1<ad42>144 354 Q F0 -1.205(The shell performs brace e)184 354 R 1.205(xpansion \(see)-.15 F -F1 1.205(Brace Expansion)3.705 F F0(abo)3.705 E -.15(ve)-.15 G 3.706 -(\). This).15 F 1.206(is on by de-)3.706 F -.1(fa)184 366 S(ult.).1 E F1 +1.053(The shell performs brace e)184 354 R 1.053(xpansion \(see)-.15 F +F1 1.053(Brace Expansion)3.553 F F0(in)3.553 E F2(bash\(1\))3.553 E F0 +3.553(\). This)B 1.053(is on by)3.553 F(def)184 366 Q(ault.)-.1 E F1 <ad43>144 378 Q F0 .214(If set,)184 378 R F1(bash)2.714 E F0 .214 (does not o)2.714 F -.15(ve)-.15 G .214(rwrite an e).15 F .214 (xisting \214le with the)-.15 F F1(>)2.714 E F0(,)A F1(>&)2.714 E F0 @@ -2446,11 +2448,11 @@ Q F0 .448(If set,)184 565.2 R F1(bash)2.948 E F0 .448 (topped and running jobs before e)-2.949 F .449(xiting an interacti)-.15 F -.15(ve)-.25 G 2.662(shell. If)184 577.2 R(an)2.662 E 2.661(yj)-.15 G .161(obs are running, this causes the e)-2.661 F .161 -(xit to be deferred until a second e)-.15 F .161(xit is at-)-.15 F 1.472 -(tempted without an interv)184 589.2 R 1.473(ening command \(see)-.15 F -/F3 9/Times-Bold@0 SF 1.473(JOB CONTR)3.973 F(OL)-.27 E F0(abo)3.723 E --.15(ve)-.15 G 3.973(\). The).15 F 1.473(shell al-)3.973 F -.1(wa)184 -601.2 S(ys postpones e).1 E(xiting if an)-.15 E 2.5(yj)-.15 G +(xit to be deferred until a second e)-.15 F .161(xit is at-)-.15 F 1.091 +(tempted without an interv)184 589.2 R 1.091(ening command \(see)-.15 F +/F3 9/Times-Bold@0 SF 1.091(JOB CONTR)3.591 F(OL)-.27 E F0(in)3.341 E F2 +(bash\(1\))3.591 E F0 3.591(\). The)B(shell)3.591 E(al)184 601.2 Q -.1 +(wa)-.1 G(ys postpones e).1 E(xiting if an)-.15 E 2.5(yj)-.15 G (obs are stopped.)-2.5 E F1(checkwinsize)144 613.2 Q F0 1.09(If set,)184 625.2 R F1(bash)3.59 E F0 1.09(checks the windo)3.59 F 3.59(ws)-.25 G 1.09(ize after each e)-3.59 F 1.09(xternal \(non-b)-.15 F 1.09 @@ -2463,12 +2465,12 @@ F3(COLUMNS)3.35 E/F4 9/Times-Roman@0 SF(.)A F0 .85 (ll lines of a multiple-line command in the same history en-).15 F(try) 184 673.2 Q 5.596(.T)-.65 G .597(his allo)-5.596 F .597 (ws easy re-editing of multi-line commands.)-.25 F .597 -(This option is enabled by de-)5.597 F -.1(fa)184 685.2 S 1.288(ult, b) -.1 F 1.288(ut only has an ef)-.2 F 1.288 -(fect if command history is enabled, as described abo)-.25 F 1.587 -.15 -(ve u)-.15 H(nder).15 E F3(HIST)184 697.2 Q(OR)-.162 E(Y)-.315 E F4(.)A -F0(GNU Bash 5.2)72 768 Q(2021 No)136.385 E -.15(ve)-.15 G(mber 22).15 E -(18)185.545 E 0 Cg EP +(This option is enabled by de-)5.597 F -.1(fa)184 685.2 S .052(ult, b).1 +F .052(ut only has an ef)-.2 F .052 +(fect if command history is enabled, as described in)-.25 F F2 +(bash\(1\))2.552 E F0(under)2.552 E F3(HIST)184 697.2 Q(OR)-.162 E(Y) +-.315 E F4(.)A F0(GNU Bash 5.2)72 768 Q(2021 No)136.385 E -.15(ve)-.15 G +(mber 22).15 E(18)185.545 E 0 Cg EP %%Page: 19 19 %%BeginPageSetup BP @@ -2480,12 +2482,12 @@ E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0 SF(compat31)144 84 Q 132 Q(compat43)144 144 Q(compat44)144 156 Q(compat50)144 168 Q F0 .889 (These control aspects of the shell')184 180 R 3.389(sc)-.55 G .889 (ompatibility mode \(see)-3.389 F/F2 9/Times-Bold@0 SF .889(SHELL COMP) -3.389 F -.855(AT)-.666 G(IBILITY).855 E(MODE)184 192 Q F0(belo)2.25 E -(w\).)-.25 E F1(complete_fullquote)144 208.8 Q F0 .654(If set,)184 220.8 -R F1(bash)3.153 E F0 .653(quotes all shell metacharacters in \214lename\ -s and directory names when per)3.153 F(-)-.2 E 1.524 -(forming completion.)184 232.8 R 1.524(If not set,)6.524 F F1(bash)4.024 -E F0(remo)4.024 E -.15(ve)-.15 G 4.024(sm).15 G 1.524 +3.389 F -.855(AT)-.666 G(IBILITY).855 E(MODE)184 192 Q F0(in)2.25 E/F3 +10/Times-Italic@0 SF(bash\(1\))2.5 E F0(\).)A F1(complete_fullquote)144 +208.8 Q F0 .654(If set,)184 220.8 R F1(bash)3.153 E F0 .653(quotes all \ +shell metacharacters in \214lenames and directory names when per)3.153 F +(-)-.2 E 1.524(forming completion.)184 232.8 R 1.524(If not set,)6.524 F +F1(bash)4.024 E F0(remo)4.024 E -.15(ve)-.15 G 4.024(sm).15 G 1.524 (etacharacters such as the dollar sign)-4.024 F 2.667(from the set of c\ haracters that will be quoted in completed \214lenames when these)184 244.8 R .028(metacharacters appear in shell v)184 256.8 R .028 @@ -2524,14 +2526,14 @@ E F1(dotglob)144 403.2 Q F0 .165(If set,)184 403.2 R F1(bash)2.665 E F0 (cute the \214le speci\214ed as an ar).15 F(-)-.2 E(gument to the)184 444 Q F1(exec)2.5 E F0 -.2(bu)2.5 G(iltin command.).2 E(An interacti)5 E .3 -.15(ve s)-.25 H(hell does not e).15 E(xit if)-.15 E F1(exec)2.5 E F0 --.1(fa)2.5 G(ils.).1 E F1(expand_aliases)144 460.8 Q F0 .717 -(If set, aliases are e)184 472.8 R .717(xpanded as described abo)-.15 F -1.017 -.15(ve u)-.15 H(nder).15 E F2(ALIASES)3.217 E/F3 9/Times-Roman@0 -SF(.)A F0 .716(This option is enabled)5.217 F(by def)184 484.8 Q -(ault for interacti)-.1 E .3 -.15(ve s)-.25 H(hells.).15 E F1(extdeb)144 -501.6 Q(ug)-.2 E F0 .17(If set at shell in)184 513.6 R -.2(vo)-.4 G .17 -(cation, or in a shell startup \214le, arrange to e).2 F -.15(xe)-.15 G -.17(cute the deb).15 F .17(ugger pro\214le)-.2 F 1.082 +-.1(fa)2.5 G(ils.).1 E F1(expand_aliases)144 460.8 Q F0 .743 +(If set, aliases are e)184 472.8 R .743(xpanded as described in)-.15 F +F3(bash\(1\))3.243 E F0(under)3.243 E F2(ALIASES)3.243 E/F4 9 +/Times-Roman@0 SF(.)A F0 .742(This option is en-)5.243 F(abled by def) +184 484.8 Q(ault for interacti)-.1 E .3 -.15(ve s)-.25 H(hells.).15 E F1 +(extdeb)144 501.6 Q(ug)-.2 E F0 .17(If set at shell in)184 513.6 R -.2 +(vo)-.4 G .17(cation, or in a shell startup \214le, arrange to e).2 F +-.15(xe)-.15 G .17(cute the deb).15 F .17(ugger pro\214le)-.2 F 1.082 (before the shell starts, identical to the)184 525.6 R F1<adad646562> 3.582 E(ugger)-.2 E F0 3.581(option. If)3.581 F 1.081(set after in)3.581 F -.2(vo)-.4 G 1.081(cation, be-).2 F(ha)184 537.6 Q @@ -2553,18 +2555,17 @@ Q(gument.)-.18 E F1(2.)184 583.2 Q F0 1.667(If the command run by the) (iltins\), the shell simulates a call to).2 E F1 -.18(re)2.5 G(tur).18 E (n)-.15 E F0(.)A F1(4.)184 652.8 Q F2 -.27(BA)220 652.8 S(SH_ARGC).27 E F0(and)3.153 E F2 -.27(BA)3.403 G(SH_ARGV).27 E F0 .904 -(are updated as described in their descriptions)3.154 F(abo)220 664.8 Q --.15(ve)-.15 G(.).15 E F1(5.)184 681.6 Q F0 1.637(Function tracing is e\ -nabled: command substitution, shell functions, and sub-)220 681.6 R +(are updated as described in their descriptions)3.154 F(in)220 664.8 Q +F3(bash\(1\))2.5 E F0(\).)A F1(5.)184 681.6 Q F0 1.637(Function tracing\ + is enabled: command substitution, shell functions, and sub-)220 681.6 R (shells in)220 693.6 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G(ith)-2.5 E -F1(\()2.5 E/F4 10/Times-Italic@0 SF(command)2.5 E F1(\))2.5 E F0 -(inherit the)2.5 E F1(DEB)2.5 E(UG)-.1 E F0(and)2.5 E F1(RETURN)2.5 E F0 -(traps.)2.5 E F1(6.)184 710.4 Q F0 1.082(Error tracing is enabled: comm\ -and substitution, shell functions, and subshells)220 710.4 R(in)220 -722.4 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G(ith)-2.5 E F1(\()2.5 E F4 -(command)2.5 E F1(\))2.5 E F0(inherit the)2.5 E F1(ERR)2.5 E F0(trap.) -2.5 E(GNU Bash 5.2)72 768 Q(2021 No)136.385 E -.15(ve)-.15 G(mber 22).15 -E(19)185.545 E 0 Cg EP +F1(\()2.5 E F3(command)2.5 E F1(\))2.5 E F0(inherit the)2.5 E F1(DEB)2.5 +E(UG)-.1 E F0(and)2.5 E F1(RETURN)2.5 E F0(traps.)2.5 E F1(6.)184 710.4 +Q F0 1.082(Error tracing is enabled: command substitution, shell functi\ +ons, and subshells)220 710.4 R(in)220 722.4 Q -.2(vo)-.4 G -.1(ke).2 G +2.5(dw).1 G(ith)-2.5 E F1(\()2.5 E F3(command)2.5 E F1(\))2.5 E F0 +(inherit the)2.5 E F1(ERR)2.5 E F0(trap.)2.5 E(GNU Bash 5.2)72 768 Q +(2021 No)136.385 E -.15(ve)-.15 G(mber 22).15 E(19)185.545 E 0 Cg EP %%Page: 20 20 %%BeginPageSetup BP @@ -2572,14 +2573,14 @@ BP /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 87.61 (TINS\(1\) General)-.92 F(Commands Manual)2.5 E -.35(BA)90.11 G(SH_B).35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0 SF(extglob)144 84 Q F0 -.4(If set, the e)184 84 R .4 -(xtended pattern matching features described abo)-.15 F .7 -.15(ve u) --.15 H(nder).15 E F1 -.1(Pa)2.9 G .4(thname Expan-).1 F(sion)184 96 Q F0 -(are enabled.)2.5 E F1(extquote)144 112.8 Q F0 .86(If set,)184 124.8 R -F1($)3.36 E F0<08>A/F2 10/Times-Italic@0 SF(string)A F0 3.36<0861>C(nd) --3.36 E F1($)3.36 E F0(")A F2(string)A F0 3.36("q)C .86 -(uoting is performed within)-3.36 F F1(${)3.36 E F2(par)A(ameter)-.15 E -F1(})A F0 -.15(ex)3.36 G .86(pansions en-).15 F +.273(If set, the e)184 84 R .273 +(xtended pattern matching features described in)-.15 F/F2 10 +/Times-Italic@0 SF(bash\(1\))2.772 E F0(under)2.772 E F1 -.1(Pa)2.772 G +.272(thname Ex-).1 F(pansion)184 96 Q F0(are enabled.)2.5 E F1(extquote) +144 112.8 Q F0 .86(If set,)184 124.8 R F1($)3.36 E F0<08>A F2(string)A +F0 3.36<0861>C(nd)-3.36 E F1($)3.36 E F0(")A F2(string)A F0 3.36("q)C +.86(uoting is performed within)-3.36 F F1(${)3.36 E F2(par)A(ameter)-.15 +E F1(})A F0 -.15(ex)3.36 G .86(pansions en-).15 F (closed in double quotes.)184 136.8 Q(This option is enabled by def)5 E (ault.)-.1 E F1(failglob)144 153.6 Q F0 .243(If set, patterns which f) 184 153.6 R .243(ail to match \214lenames during pathname e)-.1 F .243 @@ -2590,24 +2591,25 @@ F1(})A F0 -.15(ex)3.36 G .86(pansions en-).15 F (ariable cause w)-.25 F .937(ords to be ignored)-.1 F .32 (when performing w)184 206.4 R .32(ord completion e)-.1 F -.15(ve)-.25 G 2.82(ni).15 G 2.82(ft)-2.82 G .32(he ignored w)-2.82 F .32 -(ords are the only possible com-)-.1 F 2.947(pletions. See)184 218.4 R -F3 .447(SHELL V)2.947 F(ARIABLES)-1.215 E F0(abo)2.697 E .747 -.15(ve f) --.15 H .448(or a description of).15 F F3(FIGNORE)2.948 E/F4 9 -/Times-Roman@0 SF(.)A F0 .448(This option is)4.948 F(enabled by def)184 -230.4 Q(ault.)-.1 E F1(globasciiranges)144 247.2 Q F0 2.519 +(ords are the only possible com-)-.1 F 3.293(pletions. See)184 218.4 R +F3 .793(SHELL V)3.293 F(ARIABLES)-1.215 E F0(in)3.043 E F2(bash\(1\)) +3.293 E F0 .794(for a description of)3.293 F F3(FIGNORE)3.294 E/F4 9 +/Times-Roman@0 SF(.)A F0 .794(This op-)5.294 F(tion is enabled by def) +184 230.4 Q(ault.)-.1 E F1(globasciiranges)144 247.2 Q F0 2.519 (If set, range e)184 259.2 R 2.519 (xpressions used in pattern matching brack)-.15 F 2.518(et e)-.1 F 2.518 (xpressions \(see)-.15 F F3 -.09(Pa)5.018 G(tter).09 E(n)-.135 E -(Matching)184 271.2 Q F0(abo)2.964 E -.15(ve)-.15 G 3.214(\)b).15 G(eha) --3.214 E 1.014 -.15(ve a)-.2 H 3.214(si).15 G 3.214(fi)-3.214 G 3.214 -(nt)-3.214 G .714(he traditional C locale when performing comparisons.) --3.214 F 1.02(That is, the current locale')184 283.2 R 3.52(sc)-.55 G -1.02(ollating sequence is not tak)-3.52 F 1.02(en into account, so)-.1 F -F1(b)3.52 E F0 1.02(will not)3.52 F .956(collate between)184 295.2 R F1 -(A)3.456 E F0(and)3.456 E F1(B)3.456 E F0 3.457(,a)C .957(nd upper) --3.457 F .957(-case and lo)-.2 F(wer)-.25 E .957 -(-case ASCII characters will collate)-.2 F(together)184 307.2 Q(.)-.55 E -F1(globskipdots)144 324 Q F0 .285(If set, pathname e)184 336 R .285 +(Matching)184 271.2 Q F0(in)3.115 E F2(bash\(1\))3.365 E F0 3.365(\)b)C +(eha)-3.365 E 1.165 -.15(ve a)-.2 H 3.365(si).15 G 3.365(fi)-3.365 G +3.365(nt)-3.365 G .866(he traditional C locale when performing compar) +-3.365 F(-)-.2 E 2.668(isons. That)184 283.2 R .168 +(is, the current locale')2.668 F 2.668(sc)-.55 G .168 +(ollating sequence is not tak)-2.668 F .168(en into account, so)-.1 F F1 +(b)2.668 E F0(will)2.668 E .562(not collate between)184 295.2 R F1(A) +3.062 E F0(and)3.062 E F1(B)3.062 E F0 3.062(,a)C .562(nd upper)-3.062 F +.562(-case and lo)-.2 F(wer)-.25 E .563 +(-case ASCII characters will col-)-.2 F(late together)184 307.2 Q(.)-.55 +E F1(globskipdots)144 324 Q F0 .285(If set, pathname e)184 336 R .285 (xpansion will ne)-.15 F -.15(ve)-.25 G 2.785(rm).15 G .285 (atch the \214lenames)-2.785 F F1 -.63(``)2.785 G -.55(.').63 G(')-.08 E F0(and)5.285 E F1 -.63(``)2.784 G(..).63 E -.63('')-.55 G F0 2.784(,e) @@ -2639,27 +2641,27 @@ G(adline).18 E F0(editing)3.161 E -.2(bu)184 552 S -.25(ff).2 G(er).25 E 2.5(,a)-.4 G(llo)-2.5 E(wing further modi\214cation.)-.25 E F1 (hostcomplete)144 568.8 Q F0 1.181(If set, and)184 580.8 R F1 -.18(re) 3.681 G(adline).18 E F0 1.181(is being used,)3.681 F F1(bash)3.682 E F0 -1.182(will attempt to perform hostname completion)3.682 F 1.381 -(when a w)184 592.8 R 1.381(ord containing a)-.1 F F1(@)3.881 E F0 1.381 -(is being completed \(see)3.881 F F1(Completing)3.88 E F0(under)3.88 E -F3(READLINE)3.88 E F0(abo)184 604.8 Q -.15(ve)-.15 G 2.5(\). This).15 F -(is enabled by def)2.5 E(ault.)-.1 E F1(huponexit)144 621.6 Q F0 -(If set,)184 633.6 Q F1(bash)2.5 E F0(will send)2.5 E F3(SIGHUP)2.5 E F0 -(to all jobs when an interacti)2.25 E .3 -.15(ve l)-.25 H(ogin shell e) -.15 E(xits.)-.15 E F1(inherit_err)144 650.4 Q(exit)-.18 E F0 .219 -(If set, command substitution inherits the v)184 662.4 R .219 +1.182(will attempt to perform hostname completion)3.682 F .503(when a w) +184 592.8 R .503(ord containing a)-.1 F F1(@)3.003 E F0 .503 +(is being completed \(see)3.003 F F1(Completing)3.003 E F0(under)3.003 E +F3(READLINE)3.003 E F0(in)2.752 E F2(bash\(1\))184 604.8 Q F0 2.5 +(\). This)B(is enabled by def)2.5 E(ault.)-.1 E F1(huponexit)144 621.6 Q +F0(If set,)184 633.6 Q F1(bash)2.5 E F0(will send)2.5 E F3(SIGHUP)2.5 E +F0(to all jobs when an interacti)2.25 E .3 -.15(ve l)-.25 H +(ogin shell e).15 E(xits.)-.15 E F1(inherit_err)144 650.4 Q(exit)-.18 E +F0 .219(If set, command substitution inherits the v)184 662.4 R .219 (alue of the)-.25 F F1(err)2.719 E(exit)-.18 E F0 .22 (option, instead of unsetting)2.719 F(it in the subshell en)184 674.4 Q 2.5(vironment. This)-.4 F(option is enabled when)2.5 E F2(posix mode)2.5 E F0(is enabled.)2.5 E F1(interacti)144 691.2 Q -.1(ve)-.1 G(_comments) .1 E F0 .33(If set, allo)184 703.2 R 2.83(waw)-.25 G .33(ord be)-2.93 F .33(ginning with)-.15 F F1(#)2.83 E F0 .33(to cause that w)2.83 F .33 -(ord and all remaining characters on)-.1 F .967 -(that line to be ignored in an interacti)184 715.2 R 1.267 -.15(ve s) --.25 H .967(hell \(see).15 F F3(COMMENTS)3.467 E F0(abo)3.217 E -.15(ve) --.15 G 3.467(\). This).15 F .968(option is)3.468 F(enabled by def)184 -727.2 Q(ault.)-.1 E(GNU Bash 5.2)72 768 Q(2021 No)136.385 E -.15(ve)-.15 -G(mber 22).15 E(20)185.545 E 0 Cg EP +(ord and all remaining characters on)-.1 F .39 +(that line to be ignored in an interacti)184 715.2 R .69 -.15(ve s)-.25 +H .39(hell \(see).15 F F3(COMMENTS)2.89 E F0(in)2.64 E F2(bash\(1\))2.89 +E F0 2.89(\). This)B(option)2.89 E(is enabled by def)184 727.2 Q(ault.) +-.1 E(GNU Bash 5.2)72 768 Q(2021 No)136.385 E -.15(ve)-.15 G(mber 22).15 +E(20)185.545 E 0 Cg EP %%Page: 21 21 %%BeginPageSetup BP @@ -2688,27 +2690,27 @@ F1(unset)2.829 E F0 .329(on local v)2.829 F .329(ariables in pre)-.25 F ps \214nd them unset until that function returns. This is identical to \ the beha)184 218.4 R(v-)-.2 E(ior of unsetting local v)184 230.4 Q (ariables at the current function scope.)-.25 E F1(login_shell)144 247.2 -Q F0 .486 +Q F0 .693 (The shell sets this option if it is started as a login shell \(see)184 -259.2 R/F2 9/Times-Bold@0 SF(INV)2.986 E(OCA)-.405 E(TION)-.855 E F0 -(abo)2.736 E -.15(ve)-.15 G 2.986(\). The).15 F -.25(va)184 271.2 S -(lue may not be changed.).25 E F1(mailwar)144 288 Q(n)-.15 E F0 .814 -(If set, and a \214le that)184 300 R F1(bash)3.314 E F0 .815 +259.2 R/F2 9/Times-Bold@0 SF(INV)3.192 E(OCA)-.405 E(TION)-.855 E F0(in) +2.942 E/F3 10/Times-Italic@0 SF(bash\(1\))3.192 E F0(\).)A(The v)184 +271.2 Q(alue may not be changed.)-.25 E F1(mailwar)144 288 Q(n)-.15 E F0 +.814(If set, and a \214le that)184 300 R F1(bash)3.314 E F0 .815 (is checking for mail has been accessed since the last time it)3.314 F -.1(wa)184 312 S 2.5(sc).1 G(heck)-2.5 E(ed, the message `)-.1 E -(`The mail in)-.74 E/F3 10/Times-Italic@0 SF(mail\214le)2.5 E F0 -(has been read')2.5 E 2.5('i)-.74 G 2.5(sd)-2.5 G(isplayed.)-2.5 E F1 -(no_empty_cmd_completion)144 328.8 Q F0 .325(If set, and)184 340.8 R F1 --.18(re)2.825 G(adline).18 E F0 .325(is being used,)2.825 F F1(bash) -2.824 E F0 .324(will not attempt to search the)2.824 F F2 -.666(PA)2.824 -G(TH)-.189 E F0 .324(for possible)2.574 F +(`The mail in)-.74 E F3(mail\214le)2.5 E F0(has been read')2.5 E 2.5('i) +-.74 G 2.5(sd)-2.5 G(isplayed.)-2.5 E F1(no_empty_cmd_completion)144 +328.8 Q F0 .325(If set, and)184 340.8 R F1 -.18(re)2.825 G(adline).18 E +F0 .325(is being used,)2.825 F F1(bash)2.824 E F0 .324 +(will not attempt to search the)2.824 F F2 -.666(PA)2.824 G(TH)-.189 E +F0 .324(for possible)2.574 F (completions when completion is attempted on an empty line.)184 352.8 Q F1(nocaseglob)144 369.6 Q F0 .436(If set,)184 381.6 R F1(bash)2.936 E F0 .436(matches \214lenames in a case\255insensiti)2.936 F .737 -.15(ve f) -.25 H .437(ashion when performing pathname).05 F -.15(ex)184 393.6 S -(pansion \(see).15 E F1 -.1(Pa)2.5 G(thname Expansion).1 E F0(abo)2.5 E --.15(ve)-.15 G(\).).15 E F1(nocasematch)144 410.4 Q F0 1.194(If set,)184 -422.4 R F1(bash)3.694 E F0 1.194 +(pansion \(see).15 E F1 -.1(Pa)2.5 G(thname Expansion).1 E F0(in)2.5 E +F3(bash\(1\))2.5 E F0(\).)A F1(nocasematch)144 410.4 Q F0 1.194(If set,) +184 422.4 R F1(bash)3.694 E F0 1.194 (matches patterns in a case\255insensiti)3.694 F 1.493 -.15(ve f)-.25 H 1.193(ashion when performing matching).05 F .551(while e)184 434.4 R -.15(xe)-.15 G(cuting).15 E F1(case)3.051 E F0(or)3.051 E F1([[)3.051 E @@ -2719,23 +2721,23 @@ F -.1(wo)184 446.4 S .623(rd e).1 F .623(xpansions, or when \214ltering\ F1(bash)3.617 E F0 1.117(encloses the translated results of $"..." quot\ ing in single quotes instead of)3.617 F(double quotes.)184 499.2 Q (If the string is not translated, this has no ef)5 E(fect.)-.25 E F1 -(nullglob)144 516 Q F0 .855(If set,)184 528 R F1(bash)3.355 E F0(allo) -3.355 E .855(ws patterns which match no \214les \(see)-.25 F F1 -.1(Pa) -3.354 G .854(thname Expansion).1 F F0(abo)3.354 E -.15(ve)-.15 G 3.354 -(\)t).15 G(o)-3.354 E -.15(ex)184 540 S -(pand to a null string, rather than themselv).15 E(es.)-.15 E F1 -(patsub_r)144 556.8 Q(eplacement)-.18 E F0 .105(If set,)184 568.8 R F1 -(bash)2.605 E F0 -.15(ex)2.605 G .105(pands occurrences of).15 F F1(&) -2.606 E F0 .106(in the replacement string of pattern substitution to) -2.606 F .528(the te)184 580.8 R .528 -(xt matched by the pattern, as described under)-.15 F F1 -.1(Pa)3.027 G -.527(rameter Expansion).1 F F0(abo)3.027 E -.15(ve)-.15 G 5.527(.T).15 G -(his)-5.527 E(option is enabled by def)184 592.8 Q(ault.)-.1 E F1(pr)144 -609.6 Q(ogcomp)-.18 E F0 .676(If set, the programmable completion f)184 -621.6 R .677(acilities \(see)-.1 F F1(Pr)3.177 E .677 -(ogrammable Completion)-.18 F F0(abo)3.177 E -.15(ve)-.15 G(\)).15 E -(are enabled.)184 633.6 Q(This option is enabled by def)5 E(ault.)-.1 E -F1(pr)144 650.4 Q(ogcomp_alias)-.18 E F0 2.124 +(nullglob)144 516 Q F0 .319(If set,)184 528 R F1(bash)2.819 E F0(allo) +2.819 E .319(ws patterns which match no \214les \(see)-.25 F F1 -.1(Pa) +2.818 G .318(thname Expansion).1 F F0(in)2.818 E F3(bash\(1\))2.818 E F0 +(\))A(to e)184 540 Q(xpand to a null string, rather than themselv)-.15 E +(es.)-.15 E F1(patsub_r)144 556.8 Q(eplacement)-.18 E F0 .105(If set,) +184 568.8 R F1(bash)2.605 E F0 -.15(ex)2.605 G .105 +(pands occurrences of).15 F F1(&)2.606 E F0 .106 +(in the replacement string of pattern substitution to)2.606 F .989 +(the te)184 580.8 R .988(xt matched by the pattern, as described under) +-.15 F F1 -.1(Pa)3.488 G .988(rameter Expansion).1 F F0(in)3.488 E F3 +(bash\(1\))3.488 E F0(.)A(This option is enabled by def)184 592.8 Q +(ault.)-.1 E F1(pr)144 609.6 Q(ogcomp)-.18 E F0 2.802 +(If set, the programmable completion f)184 621.6 R 2.802 +(acilities \(see)-.1 F F1(Pr)5.302 E 2.803(ogrammable Completion)-.18 F +F0(in)5.303 E F3(bash\(1\))184 633.6 Q F0 2.5(\)a)C(re enabled.)-2.5 E +(This option is enabled by def)5 E(ault.)-.1 E F1(pr)144 650.4 Q +(ogcomp_alias)-.18 E F0 2.124 (If set, and programmable completion is enabled,)184 662.4 R F1(bash) 4.624 E F0 2.124(treats a command name that)4.624 F(doesn')184 674.4 Q 3.288(th)-.18 G -2.25 -.2(av e)-3.288 H(an)3.488 E 3.288(yc)-.15 G .789 @@ -2754,18 +2756,20 @@ BP E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0 SF(pr)144 84 Q(omptv) -.18 E(ars)-.1 E F0 1.447(If set, prompt strings under)184 96 R 1.448 (go parameter e)-.18 F 1.448(xpansion, command substitution, arithmetic) --.15 F -.15(ex)184 108 S .171(pansion, and quote remo).15 F -.25(va)-.15 -G 2.67(la).25 G .17(fter being e)-2.67 F .17(xpanded as described in) --.15 F/F2 9/Times-Bold@0 SF(PR)2.67 E(OMPTING)-.27 E F0(abo)2.42 E -.15 -(ve)-.15 G(.).15 E(This option is enabled by def)184 120 Q(ault.)-.1 E -F1 -.18(re)144 136.8 S(stricted_shell).18 E F0 1.069 +-.15 F -.15(ex)184 108 S 1.834(pansion, and quote remo).15 F -.25(va) +-.15 G 4.334(la).25 G 1.834(fter being e)-4.334 F 1.834 +(xpanded as described in)-.15 F/F2 9/Times-Bold@0 SF(PR)4.333 E(OMPTING) +-.27 E F0(in)4.083 E/F3 10/Times-Italic@0 SF(bash\(1\))184 120 Q F0 5 +(.T)C(his option is enabled by def)-5 E(ault.)-.1 E F1 -.18(re)144 136.8 +S(stricted_shell).18 E F0 .329 (The shell sets this option if it is started in restricted mode \(see) -184 148.8 R F2 1.069(RESTRICTED SHELL)3.569 F F0(belo)184 160.8 Q 2.86 -(w\). The)-.25 F -.25(va)2.86 G .36(lue may not be changed.).25 F .36 -(This is not reset when the startup \214les are e)5.36 F -.15(xe)-.15 G -(-).15 E(cuted, allo)184 172.8 Q(wing the startup \214les to disco)-.25 -E -.15(ve)-.15 G 2.5(rw).15 G(hether or not a shell is restricted.)-2.5 -E F1(shift_v)144 189.6 Q(erbose)-.1 E F0 .501(If set, the)184 201.6 R F1 +184 148.8 R F2 .329(RESTRICTED SHELL)2.829 F F0(in)2.58 E F3(bash\(1\)) +184 160.8 Q F0 2.731(\). The)B -.25(va)2.731 G .231 +(lue may not be changed.).25 F .23 +(This is not reset when the startup \214les are e)5.231 F(x-)-.15 E +(ecuted, allo)184 172.8 Q(wing the startup \214les to disco)-.25 E -.15 +(ve)-.15 G 2.5(rw).15 G(hether or not a shell is restricted.)-2.5 E F1 +(shift_v)144 189.6 Q(erbose)-.1 E F0 .501(If set, the)184 201.6 R F1 (shift)3.001 E F0 -.2(bu)3.001 G .501 (iltin prints an error message when the shift count e).2 F .502 (xceeds the number)-.15 F(of positional parameters.)184 213.6 Q F1(sour) @@ -2776,10 +2780,10 @@ F0(\()3.271 E F1(sour)A(ce)-.18 E F0 3.271(\)b)C .771(uiltin uses the v) 184 254.4 Q 2.5(gument. This)-.18 F(option is enabled by def)2.5 E (ault.)-.1 E F1 -.1(va)144 271.2 S(rr).1 E(edir_close)-.18 E F0 .74(If \ set, the shell automatically closes \214le descriptors assigned using t\ -he)184 283.2 R/F3 10/Times-Italic@0 SF({varname})3.24 E F0(redi-)3.24 E -.424(rection syntax \(see)184 295.2 R F2(REDIRECTION)2.924 E F0(abo) -2.674 E -.15(ve)-.15 G 2.924(\)i).15 G .424(nstead of lea)-2.924 F .424 -(ving them open when the com-)-.2 F(mand completes.)184 307.2 Q F1 +he)184 283.2 R F3({varname})3.24 E F0(redi-)3.24 E .908 +(rection syntax \(see)184 295.2 R F2(REDIRECTION)3.408 E F0(in)3.157 E +F3(bash\(1\))3.407 E F0 3.407(\)i)C .907(nstead of lea)-3.407 F .907 +(ving them open when the)-.2 F(command completes.)184 307.2 Q F1 (xpg_echo)144 324 Q F0(If set, the)184 336 Q F1(echo)2.5 E F0 -.2(bu)2.5 G(iltin e).2 E(xpands backslash-escape sequences by def)-.15 E(ault.)-.1 E F1(suspend)108 352.8 Q F0([)2.5 E F1<ad66>A F0(])A .909(Suspend the e) @@ -2798,180 +2802,180 @@ is not en-)5.107 F(abled and)144 400.8 Q F1<ad66>2.5 E F0 (luation of the conditional e).25 F(xpression)-.15 E F3 -.2(ex)144 441.6 S(pr).2 E F0 5.53(.E).73 G .53 (ach operator and operand must be a separate ar)-5.53 F 3.03 -(gument. Expressions)-.18 F .53(are composed of the)3.03 F .073 -(primaries described in the)144 453.6 R F1(bash)2.573 E F0 .073 -(manual page under)2.573 F F2(CONDITION)2.573 E .073(AL EXPRESSIONS)-.18 -F/F4 9/Times-Roman@0 SF(.)A F1(test)4.573 E F0 .072(does not)2.572 F -.694(accept an)144 465.6 R 3.194(yo)-.15 G .694 -(ptions, nor does it accept and ignore an ar)-3.194 F .695(gument of) --.18 F F1<adad>3.195 E F0 .695(as signifying the end of op-)3.195 F -(tions.)144 477.6 Q .786(Expressions may be combined using the follo)144 -495.6 R .785(wing operators, listed in decreasing order of prece-)-.25 F -3.411(dence. The)144 507.6 R -.25(eva)3.411 G .911 -(luation depends on the number of ar).25 F .912(guments; see belo)-.18 F -4.712 -.65(w. O)-.25 H .912(perator precedence is).65 F -(used when there are \214v)144 519.6 Q 2.5(eo)-.15 G 2.5(rm)-2.5 G -(ore ar)-2.5 E(guments.)-.18 E F1(!)144 531.6 Q F3 -.2(ex)2.5 G(pr).2 E -F0 -.35(Tr)180 531.6 S(ue if).35 E F3 -.2(ex)2.5 G(pr).2 E F0(is f)3.23 -E(alse.)-.1 E F1(\()144 543.6 Q F3 -.2(ex)2.5 G(pr).2 E F1(\))2.5 E F0 -.26(Returns the v)180 543.6 R .26(alue of)-.25 F F3 -.2(ex)2.76 G(pr).2 +(gument. Expressions)-.18 F .53(are composed of the)3.03 F 1.232 +(primaries described in)144 453.6 R F3(bash\(1\))3.732 E F0(under)3.731 +E F2(CONDITION)3.731 E 1.231(AL EXPRESSIONS)-.18 F/F4 9/Times-Roman@0 SF +(.)A F1(test)5.731 E F0 1.231(does not accept an)3.731 F(y)-.15 E +(options, nor does it accept and ignore an ar)144 465.6 Q(gument of)-.18 +E F1<adad>2.5 E F0(as signifying the end of options.)2.5 E .785 +(Expressions may be combined using the follo)144 483.6 R .786 +(wing operators, listed in decreasing order of prece-)-.25 F 3.412 +(dence. The)144 495.6 R -.25(eva)3.412 G .912 +(luation depends on the number of ar).25 F .911(guments; see belo)-.18 F +4.711 -.65(w. O)-.25 H .911(perator precedence is).65 F +(used when there are \214v)144 507.6 Q 2.5(eo)-.15 G 2.5(rm)-2.5 G +(ore ar)-2.5 E(guments.)-.18 E F1(!)144 519.6 Q F3 -.2(ex)2.5 G(pr).2 E +F0 -.35(Tr)180 519.6 S(ue if).35 E F3 -.2(ex)2.5 G(pr).2 E F0(is f)3.23 +E(alse.)-.1 E F1(\()144 531.6 Q F3 -.2(ex)2.5 G(pr).2 E F1(\))2.5 E F0 +.26(Returns the v)180 531.6 R .26(alue of)-.25 F F3 -.2(ex)2.76 G(pr).2 E F0 5.26(.T)C .26(his may be used to o)-5.26 F -.15(ve)-.15 G .26 -(rride the normal precedence of opera-).15 F(tors.)180 555.6 Q F3 -.2 -(ex)144 567.6 S(pr1).2 E F0<ad>2.5 E F1(a)A F3 -.2(ex)2.5 G(pr2).2 E F0 --.35(Tr)180 579.6 S(ue if both).35 E F3 -.2(ex)2.5 G(pr1).2 E F0(and)2.5 -E F3 -.2(ex)2.5 G(pr2).2 E F0(are true.)2.52 E F3 -.2(ex)144 591.6 S +(rride the normal precedence of opera-).15 F(tors.)180 543.6 Q F3 -.2 +(ex)144 555.6 S(pr1).2 E F0<ad>2.5 E F1(a)A F3 -.2(ex)2.5 G(pr2).2 E F0 +-.35(Tr)180 567.6 S(ue if both).35 E F3 -.2(ex)2.5 G(pr1).2 E F0(and)2.5 +E F3 -.2(ex)2.5 G(pr2).2 E F0(are true.)2.52 E F3 -.2(ex)144 579.6 S (pr1).2 E F0<ad>2.5 E F1(o)A F3 -.2(ex)2.5 G(pr2).2 E F0 -.35(Tr)180 -603.6 S(ue if either).35 E F3 -.2(ex)2.5 G(pr1).2 E F0(or)2.5 E F3 -.2 -(ex)2.5 G(pr2).2 E F0(is true.)2.52 E F1(test)144 620.4 Q F0(and)2.5 E +591.6 S(ue if either).35 E F3 -.2(ex)2.5 G(pr1).2 E F0(or)2.5 E F3 -.2 +(ex)2.5 G(pr2).2 E F0(is true.)2.52 E F1(test)144 608.4 Q F0(and)2.5 E F1([)2.5 E F0 -.25(eva)2.5 G(luate conditional e).25 E (xpressions using a set of rules based on the number of ar)-.15 E -(guments.)-.18 E 2.5(0a)144 638.4 S -.18(rg)-2.5 G(uments).18 E(The e) -180 650.4 Q(xpression is f)-.15 E(alse.)-.1 E 2.5(1a)144 662.4 S -.18 -(rg)-2.5 G(ument).18 E(The e)180 674.4 Q +(guments.)-.18 E 2.5(0a)144 626.4 S -.18(rg)-2.5 G(uments).18 E(The e) +180 638.4 Q(xpression is f)-.15 E(alse.)-.1 E 2.5(1a)144 650.4 S -.18 +(rg)-2.5 G(ument).18 E(The e)180 662.4 Q (xpression is true if and only if the ar)-.15 E(gument is not null.)-.18 -E 2.5(2a)144 686.4 S -.18(rg)-2.5 G(uments).18 E .37(If the \214rst ar) -180 698.4 R .37(gument is)-.18 F F1(!)2.87 E F0 2.87(,t)C .37(he e)-2.87 +E 2.5(2a)144 674.4 S -.18(rg)-2.5 G(uments).18 E .37(If the \214rst ar) +180 686.4 R .37(gument is)-.18 F F1(!)2.87 E F0 2.87(,t)C .37(he e)-2.87 F .37(xpression is true if and only if the second ar)-.15 F .37 -(gument is null.)-.18 F .38(If the \214rst ar)180 710.4 R .38 -(gument is one of the unary conditional operators listed abo)-.18 F .679 --.15(ve u)-.15 H(nder).15 E F2(CONDI-)2.879 E(TION)180 722.4 Q 2.264 -(AL EXPRESSIONS)-.18 F F4(,)A F0 2.264(the e)4.514 F 2.264 -(xpression is true if the unary test is true.)-.15 F 2.265 -(If the \214rst)7.265 F(GNU Bash 5.2)72 768 Q(2021 No)136.385 E -.15(ve) --.15 G(mber 22).15 E(22)185.545 E 0 Cg EP +(gument is null.)-.18 F 1.682(If the \214rst ar)180 698.4 R 1.683 +(gument is one of the unary conditional operators listed in)-.18 F F3 +(bash\(1\))4.183 E F0(under)4.183 E F2(CONDITION)180 710.4 Q .122 +(AL EXPRESSIONS)-.18 F F4(,)A F0 .122(the e)2.372 F .122 +(xpression is true if the unary test is true.)-.15 F .121 +(If the \214rst)5.121 F(ar)180 722.4 Q(gument is not a v)-.18 E +(alid unary conditional operator)-.25 E 2.5(,t)-.4 G(he e)-2.5 E +(xpression is f)-.15 E(alse.)-.1 E(GNU Bash 5.2)72 768 Q(2021 No)136.385 +E -.15(ve)-.15 G(mber 22).15 E(22)185.545 E 0 Cg EP %%Page: 23 23 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 87.61 (TINS\(1\) General)-.92 F(Commands Manual)2.5 E -.35(BA)90.11 G(SH_B).35 -E(UIL)-.1 E(TINS\(1\))-.92 E(ar)180 84 Q(gument is not a v)-.18 E -(alid unary conditional operator)-.25 E 2.5(,t)-.4 G(he e)-2.5 E -(xpression is f)-.15 E(alse.)-.1 E 2.5(3a)144 96 S -.18(rg)-2.5 G -(uments).18 E .236(The follo)180 108 R .236 +E(UIL)-.1 E(TINS\(1\))-.92 E 2.5(3a)144 84 S -.18(rg)-2.5 G(uments).18 E +.236(The follo)180 96 R .236 (wing conditions are applied in the order listed.)-.25 F .236 -(If the second ar)5.236 F .236(gument is one of)-.18 F .855 -(the binary conditional operators listed abo)180 120 R 1.155 -.15(ve u) --.15 H(nder).15 E/F1 9/Times-Bold@0 SF(CONDITION)3.355 E .855 -(AL EXPRESSIONS)-.18 F/F2 9/Times-Roman@0 SF(,)A F0(the)3.105 E .579 -(result of the e)180 132 R .578(xpression is the result of the binary t\ -est using the \214rst and third ar)-.15 F(guments)-.18 E 1.332 -(as operands.)180 144 R(The)6.332 E/F3 10/Times-Bold@0 SF<ad61>3.832 E -F0(and)3.832 E F3<ad6f>3.832 E F0 1.333 -(operators are considered binary operators when there are)3.832 F .558 -(three ar)180 156 R 3.058(guments. If)-.18 F .558(the \214rst ar)3.058 F -.558(gument is)-.18 F F3(!)3.058 E F0 3.058(,t)C .558(he v)-3.058 F .558 -(alue is the ne)-.25 F -.05(ga)-.15 G .558(tion of the tw).05 F(o-ar)-.1 -E(gument)-.18 E .52(test using the second and third ar)180 168 R 3.021 -(guments. If)-.18 F .521(the \214rst ar)3.021 F .521(gument is e)-.18 F -(xactly)-.15 E F3(\()3.021 E F0 .521(and the third)3.021 F(ar)180 180 Q -.485(gument is e)-.18 F(xactly)-.15 E F3(\))2.985 E F0 2.985(,t)C .485 -(he result is the one-ar)-2.985 F .485(gument test of the second ar)-.18 -F 2.985(gument. Other)-.18 F(-)-.2 E(wise, the e)180 192 Q -(xpression is f)-.15 E(alse.)-.1 E 2.5(4a)144 204 S -.18(rg)-2.5 G -(uments).18 E .429(The follo)180 216 R .429 -(wing conditions are applied in the order listed.)-.25 F .43 -(If the \214rst ar)5.429 F .43(gument is)-.18 F F3(!)2.93 E F0 2.93(,t)C -.43(he re-)-2.93 F 1.315(sult is the ne)180 228 R -.05(ga)-.15 G 1.314 -(tion of the three-ar).05 F 1.314(gument e)-.18 F 1.314 -(xpression composed of the remaining ar)-.15 F(gu-)-.18 E 2.744 -(ments. the)180 240 R(tw)2.744 E(o-ar)-.1 E .245 -(gument test using the second and third ar)-.18 F 2.745(guments. If)-.18 -F .245(the \214rst ar)2.745 F(gument)-.18 E .31(is e)180 252 R(xactly) --.15 E F3(\()2.81 E F0 .31(and the fourth ar)2.81 F .31(gument is e)-.18 -F(xactly)-.15 E F3(\))2.809 E F0 2.809(,t)C .309(he result is the tw) --2.809 F(o-ar)-.1 E .309(gument test of the)-.18 F .183 -(second and third ar)180 264 R 2.683(guments. Otherwise,)-.18 F .184 -(the e)2.684 F .184(xpression is parsed and e)-.15 F -.25(va)-.25 G .184 -(luated according).25 F(to precedence using the rules listed abo)180 276 -Q -.15(ve)-.15 G(.).15 E 2.5(5o)144 288 S 2.5(rm)-2.5 G(ore ar)-2.5 E -(guments)-.18 E 1.635(The e)180 300 R 1.635(xpression is parsed and e) +(If the second ar)5.236 F .236(gument is one of)-.18 F .546 +(the binary conditional operators listed in)180 108 R/F1 10 +/Times-Italic@0 SF(bash\(1\))3.046 E F0(under)3.046 E/F2 9/Times-Bold@0 +SF(CONDITION)3.046 E .546(AL EXPRESSIONS)-.18 F/F3 9/Times-Roman@0 SF(,) +A F0 .887(the result of the e)180 120 R .888(xpression is the result of\ + the binary test using the \214rst and third ar)-.15 F(gu-)-.18 E .434 +(ments as operands.)180 132 R(The)5.434 E/F4 10/Times-Bold@0 SF<ad61> +2.934 E F0(and)2.934 E F4<ad6f>2.934 E F0 .434 +(operators are considered binary operators when there)2.934 F .645 +(are three ar)180 144 R 3.145(guments. If)-.18 F .645(the \214rst ar) +3.145 F .646(gument is)-.18 F F4(!)3.146 E F0 3.146(,t)C .646(he v) +-3.146 F .646(alue is the ne)-.25 F -.05(ga)-.15 G .646(tion of the tw) +.05 F(o-ar)-.1 E(gu-)-.18 E .452 +(ment test using the second and third ar)180 156 R 2.951(guments. If) +-.18 F .451(the \214rst ar)2.951 F .451(gument is e)-.18 F(xactly)-.15 E +F4(\()2.951 E F0 .451(and the)2.951 F 1.164(third ar)180 168 R 1.164 +(gument is e)-.18 F(xactly)-.15 E F4(\))3.664 E F0 3.664(,t)C 1.164 +(he result is the one-ar)-3.664 F 1.165(gument test of the second ar) +-.18 F(gument.)-.18 E(Otherwise, the e)180 180 Q(xpression is f)-.15 E +(alse.)-.1 E 2.5(4a)144 192 S -.18(rg)-2.5 G(uments).18 E .43(The follo) +180 204 R .43(wing conditions are applied in the order listed.)-.25 F +.429(If the \214rst ar)5.429 F .429(gument is)-.18 F F4(!)2.929 E F0 +2.929(,t)C .429(he re-)-2.929 F 1.314(sult is the ne)180 216 R -.05(ga) +-.15 G 1.314(tion of the three-ar).05 F 1.314(gument e)-.18 F 1.314 +(xpression composed of the remaining ar)-.15 F(gu-)-.18 E 2.745 +(ments. the)180 228 R(tw)2.745 E(o-ar)-.1 E .245 +(gument test using the second and third ar)-.18 F 2.744(guments. If)-.18 +F .244(the \214rst ar)2.744 F(gument)-.18 E .309(is e)180 240 R(xactly) +-.15 E F4(\()2.809 E F0 .309(and the fourth ar)2.809 F .309(gument is e) +-.18 F(xactly)-.15 E F4(\))2.809 E F0 2.809(,t)C .31 +(he result is the tw)-2.809 F(o-ar)-.1 E .31(gument test of the)-.18 F +.184(second and third ar)180 252 R 2.684(guments. Otherwise,)-.18 F .184 +(the e)2.684 F .183(xpression is parsed and e)-.15 F -.25(va)-.25 G .183 +(luated according).25 F(to precedence using the rules listed abo)180 264 +Q -.15(ve)-.15 G(.).15 E 2.5(5o)144 276 S 2.5(rm)-2.5 G(ore ar)-2.5 E +(guments)-.18 E 1.635(The e)180 288 R 1.635(xpression is parsed and e) -.15 F -.25(va)-.25 G 1.635 -(luated according to precedence using the rules listed).25 F(abo)180 312 -Q -.15(ve)-.15 G(.).15 E(When used with)144 330 Q F3(test)2.5 E F0(or) -2.5 E F3([)2.5 E F0 2.5(,t)C(he)-2.5 E F3(<)2.5 E F0(and)2.5 E F3(>)2.5 +(luated according to precedence using the rules listed).25 F(abo)180 300 +Q -.15(ve)-.15 G(.).15 E(When used with)144 318 Q F4(test)2.5 E F0(or) +2.5 E F4([)2.5 E F0 2.5(,t)C(he)-2.5 E F4(<)2.5 E F0(and)2.5 E F4(>)2.5 E F0(operators sort le)2.5 E(xicographically using ASCII ordering.)-.15 -E F3(times)108 346.8 Q F0 1.229(Print the accumulated user and system t\ -imes for the shell and for processes run from the shell.)144 346.8 R -(The return status is 0.)144 358.8 Q F3(trap)108 375.6 Q F0([)2.5 E F3 -(\255lp)A F0 2.5(][)C([)-2.5 E/F4 10/Times-Italic@0 SF(ar)A(g)-.37 E F0 -(])A F4(sigspec)2.5 E F0(...])2.5 E .683(The command)144 387.6 R F4(ar) -3.513 E(g)-.37 E F0 .683(is to be read and e)3.403 F -.15(xe)-.15 G .682 -(cuted when the shell recei).15 F -.15(ve)-.25 G 3.182(ss).15 G -(ignal\(s\))-3.182 E F4(sigspec)3.522 E F0 5.682(.I).31 G(f)-5.682 E F4 -(ar)3.512 E(g)-.37 E F0(is)3.402 E .608(absent \(and there is a single) -144 399.6 R F4(sigspec)3.108 E F0 3.108(\)o)C(r)-3.108 E F3<ad>3.108 E +E F4(times)108 334.8 Q F0 1.229(Print the accumulated user and system t\ +imes for the shell and for processes run from the shell.)144 334.8 R +(The return status is 0.)144 346.8 Q F4(trap)108 363.6 Q F0([)2.5 E F4 +(\255lp)A F0 2.5(][)C([)-2.5 E F1(ar)A(g)-.37 E F0(])A F1(sigspec)2.5 E +F0(...])2.5 E .682(The command)144 375.6 R F1(ar)3.512 E(g)-.37 E F0 +.682(is to be read and e)3.402 F -.15(xe)-.15 G .682 +(cuted when the shell recei).15 F -.15(ve)-.25 G 3.183(ss).15 G +(ignal\(s\))-3.183 E F1(sigspec)3.523 E F0 5.683(.I).31 G(f)-5.683 E F1 +(ar)3.513 E(g)-.37 E F0(is)3.403 E .609(absent \(and there is a single) +144 387.6 R F1(sigspec)3.108 E F0 3.108(\)o)C(r)-3.108 E F4<ad>3.108 E F0 3.108(,e)C .608 (ach speci\214ed signal is reset to its original disposition)-3.108 F -.659(\(the v)144 411.6 R .659(alue it had upon entrance to the shell\).) --.25 F(If)5.658 E F4(ar)3.488 E(g)-.37 E F0 .658 -(is the null string the signal speci\214ed by each)3.378 F F4(sigspec) -144.34 423.6 Q F0 .58(is ignored by the shell and by the commands it in) -3.39 F -.2(vo)-.4 G -.1(ke).2 G 3.081(s. If).1 F F4(ar)3.411 E(g)-.37 E -F0 .581(is not present and)3.301 F F3<ad70>3.081 E F0(has)3.081 E 1.215 -(been supplied, then the trap commands associated with each)144 435.6 R -F4(sigspec)4.054 E F0 1.214(are displayed.)4.024 F 1.214(If no ar)6.214 -F(gu-)-.18 E .86(ments are supplied or if only)144 447.6 R F3<ad70>3.36 -E F0 .86(is gi)3.36 F -.15(ve)-.25 G(n,).15 E F3(trap)3.36 E F0 .86 +.658(\(the v)144 399.6 R .658(alue it had upon entrance to the shell\).) +-.25 F(If)5.658 E F1(ar)3.488 E(g)-.37 E F0 .659 +(is the null string the signal speci\214ed by each)3.378 F F1(sigspec) +144.34 411.6 Q F0 .581 +(is ignored by the shell and by the commands it in)3.391 F -.2(vo)-.4 G +-.1(ke).2 G 3.08(s. If).1 F F1(ar)3.41 E(g)-.37 E F0 .58 +(is not present and)3.3 F F4<ad70>3.08 E F0(has)3.08 E 1.214 +(been supplied, then the trap commands associated with each)144 423.6 R +F1(sigspec)4.054 E F0 1.215(are displayed.)4.024 F 1.215(If no ar)6.215 +F(gu-)-.18 E .86(ments are supplied or if only)144 435.6 R F4<ad70>3.36 +E F0 .86(is gi)3.36 F -.15(ve)-.25 G(n,).15 E F4(trap)3.36 E F0 .86 (prints the list of commands associated with each)3.36 F 2.83 -(signal. The)144 459.6 R F3<ad6c>2.83 E F0 .33(option causes the shell \ -to print a list of signal names and their corresponding num-)2.83 F 4.31 -(bers. Each)144 471.6 R F4(sigspec)4.65 E F0 1.811 -(is either a signal name de\214ned in <)4.62 F F4(signal.h)A F0 1.811 -(>, or a signal number)B 6.811(.S)-.55 G(ignal)-6.811 E -(names are case insensiti)144 483.6 Q .3 -.15(ve a)-.25 H(nd the).15 E -F1(SIG)2.5 E F0(pre\214x is optional.)2.25 E .667(If a)144 501.6 R F4 -(sigspec)3.507 E F0(is)3.477 E F1(EXIT)3.167 E F0 .667 -(\(0\) the command)2.917 F F4(ar)3.496 E(g)-.37 E F0 .666(is e)3.386 F --.15(xe)-.15 G .666(cuted on e).15 F .666(xit from the shell.)-.15 F -.666(If a)5.666 F F4(sigspec)3.506 E F0(is)3.476 E F1(DE-)3.166 E -.09 -(BU)144 513.6 S(G).09 E F2(,)A F0 .483(the command)2.733 F F4(ar)3.313 E -(g)-.37 E F0 .483(is e)3.203 F -.15(xe)-.15 G .484(cuted before e).15 F --.15(ve)-.25 G(ry).15 E F4 .484(simple command)2.984 F F0(,)A F4(for) -2.984 E F0(command,)2.984 E F4(case)2.984 E F0(command,)2.984 E F4 -(select)144 525.6 Q F0 .563(command, e)3.063 F -.15(ve)-.25 G .563 -(ry arithmetic).15 F F4(for)3.063 E F0 .563 -(command, and before the \214rst command e)3.063 F -.15(xe)-.15 G .562 -(cutes in a shell).15 F .622(function \(see)144 537.6 R F1 .622 -(SHELL GRAMMAR)3.122 F F0(abo)2.872 E -.15(ve)-.15 G 3.122(\). Refer).15 -F .622(to the description of the)3.122 F F3(extdeb)3.122 E(ug)-.2 E F0 -.622(option to the)3.122 F F3(shopt)144 549.6 Q F0 -.2(bu)2.996 G .496 -(iltin for details of its ef).2 F .496(fect on the)-.25 F F3(DEB)2.996 E -(UG)-.1 E F0 2.996(trap. If)2.996 F(a)2.996 E F4(sigspec)3.336 E F0(is) -3.306 E F1(RETURN)2.996 E F2(,)A F0 .496(the command)2.746 F F4(ar) -144.33 561.6 Q(g)-.37 E F0 .18(is e)2.9 F -.15(xe)-.15 G .18 -(cuted each time a shell function or a script e).15 F -.15(xe)-.15 G .18 -(cuted with the).15 F F3(.)2.68 E F0(or)2.68 E F3(sour)2.68 E(ce)-.18 E -F0 -.2(bu)2.68 G .18(iltins \214nishes).2 F -.15(exe)144 573.6 S -(cuting.).15 E .961(If a)144 591.6 R F4(sigspec)3.801 E F0(is)3.771 E F1 -(ERR)3.461 E F2(,)A F0 .961(the command)3.211 F F4(ar)3.791 E(g)-.37 E -F0 .961(is e)3.681 F -.15(xe)-.15 G .961(cuted whene).15 F -.15(ve)-.25 -G 3.461(ra).15 G .96(pipeline \(which may consist of a)-.001 F .185(sin\ +(signal. The)144 447.6 R F4<ad6c>2.83 E F0 .33(option causes the shell \ +to print a list of signal names and their corresponding num-)2.83 F +4.311(bers. Each)144 459.6 R F1(sigspec)4.651 E F0 1.811 +(is either a signal name de\214ned in <)4.621 F F1(signal.h)A F0 1.81 +(>, or a signal number)B 6.81(.S)-.55 G(ignal)-6.81 E +(names are case insensiti)144 471.6 Q .3 -.15(ve a)-.25 H(nd the).15 E +F2(SIG)2.5 E F0(pre\214x is optional.)2.25 E .666(If a)144 489.6 R F1 +(sigspec)3.506 E F0(is)3.476 E F2(EXIT)3.166 E F0 .666 +(\(0\) the command)2.916 F F1(ar)3.496 E(g)-.37 E F0 .666(is e)3.386 F +-.15(xe)-.15 G .666(cuted on e).15 F .667(xit from the shell.)-.15 F +.667(If a)5.667 F F1(sigspec)3.507 E F0(is)3.477 E F2(DE-)3.167 E -.09 +(BU)144 501.6 S(G).09 E F3(,)A F0 .484(the command)2.734 F F1(ar)3.314 E +(g)-.37 E F0 .484(is e)3.204 F -.15(xe)-.15 G .484(cuted before e).15 F +-.15(ve)-.25 G(ry).15 E F1 .483(simple command)2.984 F F0(,)A F1(for) +2.983 E F0(command,)2.983 E F1(case)2.983 E F0(command,)2.983 E F1 +(select)144 513.6 Q F0 .562(command, e)3.062 F -.15(ve)-.25 G .563 +(ry arithmetic).15 F F1(for)3.063 E F0 .563 +(command, and before the \214rst command e)3.063 F -.15(xe)-.15 G .563 +(cutes in a shell).15 F .442(function \(see)144 525.6 R F2 .442 +(SHELL GRAMMAR)2.942 F F0(in)2.692 E F1(bash\(1\))2.942 E F0 2.941 +(\). Refer)B .441(to the description of the)2.941 F F4(extdeb)2.941 E +(ug)-.2 E F0 .441(option to)2.941 F(the)144 537.6 Q F4(shopt)3.2 E F0 +-.2(bu)3.2 G .7(iltin for details of its ef).2 F .7(fect on the)-.25 F +F4(DEB)3.2 E(UG)-.1 E F0 3.2(trap. If)3.2 F(a)3.2 E F1(sigspec)3.54 E F0 +(is)3.51 E F2(RETURN)3.2 E F3(,)A F0 .701(the com-)2.951 F(mand)144 +549.6 Q F1(ar)3.474 E(g)-.37 E F0 .644(is e)3.364 F -.15(xe)-.15 G .643 +(cuted each time a shell function or a script e).15 F -.15(xe)-.15 G +.643(cuted with the).15 F F4(.)3.143 E F0(or)3.143 E F4(sour)3.143 E(ce) +-.18 E F0 -.2(bu)3.143 G(iltins).2 E(\214nishes e)144 561.6 Q -.15(xe) +-.15 G(cuting.).15 E .96(If a)144 579.6 R F1(sigspec)3.8 E F0(is)3.77 E +F2(ERR)3.46 E F3(,)A F0 .96(the command)3.21 F F1(ar)3.791 E(g)-.37 E F0 +.961(is e)3.681 F -.15(xe)-.15 G .961(cuted whene).15 F -.15(ve)-.25 G +3.461(rap).15 G .961(ipeline \(which may consist of a)-3.461 F .185(sin\ gle simple command\), a list, or a compound command returns a non\255ze\ -ro e)144 603.6 R .185(xit status, subject to)-.15 F .452(the follo)144 -615.6 R .452(wing conditions.)-.25 F(The)5.452 E F1(ERR)2.952 E F0 .451 -(trap is not e)2.701 F -.15(xe)-.15 G .451(cuted if the f).15 F .451 -(ailed command is part of the com-)-.1 F .387 -(mand list immediately follo)144 627.6 R .387(wing a)-.25 F F3(while) -2.887 E F0(or)2.887 E F3(until)2.888 E F0 -.1(ke)2.888 G(yw)-.05 E .388 -(ord, part of the test in an)-.1 F F4(if)2.898 E F0 .388 -(statement, part)4.848 F .778(of a command e)144 639.6 R -.15(xe)-.15 G -.778(cuted in a).15 F F3(&&)3.278 E F0(or)3.278 E F3(||)3.278 E F0 .778 +ro e)144 591.6 R .184(xit status, subject to)-.15 F .451(the follo)144 +603.6 R .451(wing conditions.)-.25 F(The)5.451 E F2(ERR)2.951 E F0 .451 +(trap is not e)2.701 F -.15(xe)-.15 G .451(cuted if the f).15 F .452 +(ailed command is part of the com-)-.1 F .388 +(mand list immediately follo)144 615.6 R .388(wing a)-.25 F F4(while) +2.888 E F0(or)2.888 E F4(until)2.888 E F0 -.1(ke)2.888 G(yw)-.05 E .388 +(ord, part of the test in an)-.1 F F1(if)2.897 E F0 .387 +(statement, part)4.847 F .777(of a command e)144 627.6 R -.15(xe)-.15 G +.778(cuted in a).15 F F4(&&)3.278 E F0(or)3.278 E F4(||)3.278 E F0 .778 (list e)3.278 F .778(xcept the command follo)-.15 F .778 -(wing the \214nal)-.25 F F3(&&)3.278 E F0(or)3.278 E F3(||)3.277 E F0 -3.277(,a)C -.15(ny)-3.277 G 1.28(command in a pipeline b)144 651.6 R +(wing the \214nal)-.25 F F4(&&)3.278 E F0(or)3.278 E F4(||)3.278 E F0 +3.278(,a)C -.15(ny)-3.278 G 1.28(command in a pipeline b)144 639.6 R 1.28(ut the last, or if the command')-.2 F 3.78(sr)-.55 G 1.28(eturn v) -3.78 F 1.28(alue is being in)-.25 F -.15(ve)-.4 G 1.28(rted using).15 F -F3(!)3.78 E F0(.)A(These are the same conditions obe)144 663.6 Q -(yed by the)-.15 E F3(err)2.5 E(exit)-.18 E F0(\()2.5 E F3<ad65>A F0 2.5 -(\)o)C(ption.)-2.5 E .133 +F4(!)3.78 E F0(.)A(These are the same conditions obe)144 651.6 Q +(yed by the)-.15 E F4(err)2.5 E(exit)-.18 E F0(\()2.5 E F4<ad65>A F0 2.5 +(\)o)C(ption.)-2.5 E .132 (Signals ignored upon entry to the shell cannot be trapped or reset.)144 -681.6 R -.35(Tr)5.132 G .132(apped signals that are not be-).35 F .117 -(ing ignored are reset to their original v)144 693.6 R .117 +669.6 R -.35(Tr)5.133 G .133(apped signals that are not be-).35 F .117 +(ing ignored are reset to their original v)144 681.6 R .117 (alues in a subshell or subshell en)-.25 F .117 -(vironment when one is cre-)-.4 F 2.5(ated. The)144 705.6 R -(return status is f)2.5 E(alse if an)-.1 E(y)-.15 E F4(sigspec)2.84 E F0 -(is in)2.81 E -.25(va)-.4 G(lid; otherwise).25 E F3(trap)2.5 E F0 +(vironment when one is cre-)-.4 F 2.5(ated. The)144 693.6 R +(return status is f)2.5 E(alse if an)-.1 E(y)-.15 E F1(sigspec)2.84 E F0 +(is in)2.81 E -.25(va)-.4 G(lid; otherwise).25 E F4(trap)2.5 E F0 (returns true.)2.5 E(GNU Bash 5.2)72 768 Q(2021 No)136.385 E -.15(ve) -.15 G(mber 22).15 E(23)185.545 E 0 Cg EP %%Page: 24 24 @@ -2982,74 +2986,74 @@ BP (TINS\(1\) General)-.92 F(Commands Manual)2.5 E -.35(BA)90.11 G(SH_B).35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0 SF(type)108 84 Q F0([) 2.5 E F1(\255aftpP)A F0(])A/F2 10/Times-Italic@0 SF(name)2.5 E F0([)2.5 -E F2(name)A F0(...])2.5 E -.4(Wi)144 96 S .174 -(th no options, indicate ho).4 F 2.674(we)-.25 G(ach)-2.674 E F2(name) -3.034 E F0 -.1(wo)2.854 G .173 -(uld be interpreted if used as a command name.).1 F .173(If the)5.173 F +E F2(name)A F0(...])2.5 E -.4(Wi)144 96 S .173 +(th no options, indicate ho).4 F 2.673(we)-.25 G(ach)-2.673 E F2(name) +3.033 E F0 -.1(wo)2.853 G .174 +(uld be interpreted if used as a command name.).1 F .174(If the)5.174 F F1<ad74>144 108 Q F0 .715(option is used,)3.215 F F1(type)3.215 E F0 .715(prints a string which is one of)3.215 F F2(alias)3.545 E F0(,).27 E F2 -.1(ke)3.215 G(ywor)-.2 E(d)-.37 E F0(,).77 E F2(function)5.185 E F0 (,).24 E F2 -.2(bu)3.215 G(iltin).2 E F0 3.215(,o).24 G(r)-3.215 E F2 -(\214le)5.125 E F0(if)3.395 E F2(name)144.36 120 Q F0 .087 -(is an alias, shell reserv)2.767 F .087(ed w)-.15 F .087 -(ord, function, b)-.1 F .086(uiltin, or disk \214le, respecti)-.2 F -.15 -(ve)-.25 G(ly).15 E 5.086(.I)-.65 G 2.586(ft)-5.086 G(he)-2.586 E F2 -(name)2.946 E F0 .086(is not)2.766 F .118 +(\214le)5.125 E F0(if)3.395 E F2(name)144.36 120 Q F0 .086 +(is an alias, shell reserv)2.766 F .086(ed w)-.15 F .086 +(ord, function, b)-.1 F .087(uiltin, or disk \214le, respecti)-.2 F -.15 +(ve)-.25 G(ly).15 E 5.087(.I)-.65 G 2.587(ft)-5.087 G(he)-2.587 E F2 +(name)2.947 E F0 .087(is not)2.767 F .119 (found, then nothing is printed, and an e)144 132 R .118 -(xit status of f)-.15 F .118(alse is returned.)-.1 F .119(If the)5.119 F -F1<ad70>2.619 E F0 .119(option is used,)2.619 F F1(type)2.619 E F0 .855 +(xit status of f)-.15 F .118(alse is returned.)-.1 F .118(If the)5.118 F +F1<ad70>2.618 E F0 .118(option is used,)2.618 F F1(type)2.618 E F0 .855 (either returns the name of the disk \214le that w)144 144 R .855 (ould be e)-.1 F -.15(xe)-.15 G .855(cuted if).15 F F2(name)3.715 E F0 -.855(were speci\214ed as a com-)3.535 F .528(mand name, or nothing if) +.855(were speci\214ed as a com-)3.535 F .529(mand name, or nothing if) 144 156 R/F3 10/Courier@0 SF .528(type -t name)3.028 F F0 -.1(wo)3.028 G .528(uld not return).1 F F2(\214le)4.938 E F0 5.528(.T).18 G(he)-5.528 E -F1<ad50>3.028 E F0 .529(option forces a)3.028 F/F4 9/Times-Bold@0 SF --.666(PA)3.029 G(TH)-.189 E F0 .007(search for each)144 168 R F2(name) -2.507 E F0 2.507(,e)C -.15(ve)-2.757 G 2.507(ni).15 G(f)-2.507 E F3 .007 -(type -t name)2.507 F F0 -.1(wo)2.507 G .007(uld not return).1 F F2 -(\214le)4.417 E F0 5.006(.I).18 G 2.506(fac)-5.006 G .006 -(ommand is hashed,)-2.506 F F1<ad70>2.506 E F0(and)144 180 Q F1<ad50> -3.23 E F0 .73(print the hashed v)3.23 F .731 +F1<ad50>3.028 E F0 .528(option forces a)3.028 F/F4 9/Times-Bold@0 SF +-.666(PA)3.028 G(TH)-.189 E F0 .006(search for each)144 168 R F2(name) +2.506 E F0 2.506(,e)C -.15(ve)-2.756 G 2.506(ni).15 G(f)-2.506 E F3 .007 +(type -t name)2.506 F F0 -.1(wo)2.507 G .007(uld not return).1 F F2 +(\214le)4.417 E F0 5.007(.I).18 G 2.507(fac)-5.007 G .007 +(ommand is hashed,)-2.507 F F1<ad70>2.507 E F0(and)144 180 Q F1<ad50> +3.231 E F0 .731(print the hashed v)3.231 F .73 (alue, which is not necessarily the \214le that appears \214rst in)-.25 -F F4 -.666(PA)3.231 G(TH)-.189 E/F5 9/Times-Roman@0 SF(.)A F0 .731 -(If the)5.231 F F1<ad61>144 192 Q F0 .824(option is used,)3.324 F F1 -(type)3.324 E F0 .824(prints all of the places that contain an e)3.324 F --.15(xe)-.15 G .823(cutable named).15 F F2(name)3.683 E F0 5.823(.T).18 -G .823(his in-)-5.823 F 1.176 +F F4 -.666(PA)3.23 G(TH)-.189 E/F5 9/Times-Roman@0 SF(.)A F0 .73(If the) +5.23 F F1<ad61>144 192 Q F0 .823(option is used,)3.323 F F1(type)3.323 E +F0 .824(prints all of the places that contain an e)3.323 F -.15(xe)-.15 +G .824(cutable named).15 F F2(name)3.684 E F0 5.824(.T).18 G .824 +(his in-)-5.824 F 1.176 (cludes aliases and functions, if and only if the)144 204 R F1<ad70> -3.676 E F0 1.176(option is not also used.)3.676 F 1.177 +3.676 E F0 1.176(option is not also used.)3.676 F 1.176 (The table of hashed)6.176 F 1.223(commands is not consulted when using) 144 216 R F1<ad61>3.723 E F0 6.223(.T)C(he)-6.223 E F1<ad66>3.723 E F0 -1.223(option suppresses shell function lookup, as)3.723 F .325(with the) -144 228 R F1(command)2.825 E F0 -.2(bu)2.825 G(iltin.).2 E F1(type)5.325 -E F0 .325(returns true if all of the ar)2.825 F .326 -(guments are found, f)-.18 F .326(alse if an)-.1 F 2.826(ya)-.15 G .326 -(re not)-2.826 F(found.)144 240 Q F1(ulimit)108 256.8 Q F0([)2.5 E F1 +1.223(option suppresses shell function lookup, as)3.723 F .326(with the) +144 228 R F1(command)2.826 E F0 -.2(bu)2.826 G(iltin.).2 E F1(type)5.326 +E F0 .326(returns true if all of the ar)2.826 F .325 +(guments are found, f)-.18 F .325(alse if an)-.1 F 2.825(ya)-.15 G .325 +(re not)-2.825 F(found.)144 240 Q F1(ulimit)108 256.8 Q F0([)2.5 E F1 (\255HS)A F0(])A F1<ad61>2.5 E(ulimit)108 268.8 Q F0([)2.5 E F1(\255HS)A F0 2.5(][)C F1(\255bcde\214klmnpqrstuvxPR)-2.5 E(T)-.4 E F0([)2.5 E F2 -(limit)A F0(]])A(Pro)144 280.8 Q .244(vides control o)-.15 F -.15(ve) --.15 G 2.744(rt).15 G .244(he resources a)-2.744 F -.25(va)-.2 G .244 +(limit)A F0(]])A(Pro)144 280.8 Q .243(vides control o)-.15 F -.15(ve) +-.15 G 2.743(rt).15 G .243(he resources a)-2.743 F -.25(va)-.2 G .244 (ilable to the shell and to processes started by it, on systems).25 F -.943(that allo)144 292.8 R 3.443(ws)-.25 G .943(uch control.)-3.443 F -(The)5.943 E F1<ad48>3.443 E F0(and)3.443 E F1<ad53>3.444 E F0 .944 +.944(that allo)144 292.8 R 3.444(ws)-.25 G .944(uch control.)-3.444 F +(The)5.944 E F1<ad48>3.444 E F0(and)3.444 E F1<ad53>3.444 E F0 .943 (options specify that the hard or soft limit is set for the)3.444 F(gi) -144 304.8 Q -.15(ve)-.25 G 2.709(nr).15 G 2.709(esource. A)-2.709 F .208 +144 304.8 Q -.15(ve)-.25 G 2.708(nr).15 G 2.708(esource. A)-2.708 F .208 (hard limit cannot be increased by a non-root user once it is set; a so\ -ft limit may)2.709 F .425(be increased up to the v)144 316.8 R .425 -(alue of the hard limit.)-.25 F .426(If neither)5.425 F F1<ad48>2.926 E -F0(nor)2.926 E F1<ad53>2.926 E F0 .426 -(is speci\214ed, both the soft and)2.926 F .139(hard limits are set.)144 +ft limit may)2.708 F .426(be increased up to the v)144 316.8 R .426 +(alue of the hard limit.)-.25 F .425(If neither)5.426 F F1<ad48>2.925 E +F0(nor)2.925 E F1<ad53>2.925 E F0 .425 +(is speci\214ed, both the soft and)2.925 F .139(hard limits are set.)144 328.8 R .139(The v)5.139 F .139(alue of)-.25 F F2(limit)2.729 E F0 .139 (can be a number in the unit speci\214ed for the resource or one)3.319 F -.741(of the special v)144 340.8 R(alues)-.25 E F1(hard)3.241 E F0(,)A F1 +.742(of the special v)144 340.8 R(alues)-.25 E F1(hard)3.242 E F0(,)A F1 (soft)3.241 E F0 3.241(,o)C(r)-3.241 E F1(unlimited)3.241 E F0 3.241(,w) -C .741(hich stand for the current hard limit, the current)-3.241 F .024 +C .741(hich stand for the current hard limit, the current)-3.241 F .023 (soft limit, and no limit, respecti)144 352.8 R -.15(ve)-.25 G(ly).15 E 5.023(.I)-.65 G(f)-5.023 E F2(limit)2.613 E F0 .023 (is omitted, the current v)3.203 F .023 -(alue of the soft limit of the re-)-.25 F .984 -(source is printed, unless the)144 364.8 R F1<ad48>3.484 E F0 .984 -(option is gi)3.484 F -.15(ve)-.25 G 3.484(n. When).15 F .985 +(alue of the soft limit of the re-)-.25 F .985 +(source is printed, unless the)144 364.8 R F1<ad48>3.485 E F0 .984 +(option is gi)3.485 F -.15(ve)-.25 G 3.484(n. When).15 F .984 (more than one resource is speci\214ed, the)3.484 F .7 (limit name and unit, if appropriate, are printed before the v)144 376.8 R 3.2(alue. Other)-.25 F .7(options are interpreted as)3.2 F(follo)144 @@ -3071,7 +3075,7 @@ Q F0(The maximum size of a process')180 436.8 Q 2.5(sd)-.55 G(ata se) (The maximum resident set size \(man)180 508.8 Q 2.5(ys)-.15 G (ystems do not honor this limit\))-2.5 E F1<ad6e>144 520.8 Q F0 .791(Th\ e maximum number of open \214le descriptors \(most systems do not allo) -180 520.8 R 3.291(wt)-.25 G .791(his v)-3.291 F .791(alue to)-.25 F +180 520.8 R 3.29(wt)-.25 G .79(his v)-3.29 F .79(alue to)-.25 F (be set\))180 532.8 Q F1<ad70>144 544.8 Q F0 (The pipe size in 512-byte blocks \(this may not be set\))180 544.8 Q F1 <ad71>144 556.8 Q F0 @@ -3091,18 +3095,18 @@ Q F1<ad73>144 580.8 Q F0(The maximum stack size)180 580.8 Q F1<ad74>144 E F0 .468(is gi)3.648 F -.15(ve)-.25 G .468(n, and the).15 F F1<ad61> 2.968 E F0 .468(option is not used,)2.968 F F2(limit)2.968 E F0 .468 (is the ne)2.968 F 2.968(wv)-.25 G .468 -(alue of the speci\214ed resource.)-3.218 F(If)5.468 E .045 -(no option is gi)144 705.6 R -.15(ve)-.25 G .045(n, then).15 F F1<ad66> -2.545 E F0 .045(is assumed.)2.545 F -1.11(Va)5.045 G .045 -(lues are in 1024-byte increments, e)1.11 F .044(xcept for)-.15 F F1 -<ad74>2.544 E F0 2.544(,w)C .044(hich is)-2.544 F .67(in seconds;)144 +(alue of the speci\214ed resource.)-3.218 F(If)5.468 E .044 +(no option is gi)144 705.6 R -.15(ve)-.25 G .044(n, then).15 F F1<ad66> +2.544 E F0 .045(is assumed.)2.545 F -1.11(Va)5.045 G .045 +(lues are in 1024-byte increments, e)1.11 F .045(xcept for)-.15 F F1 +<ad74>2.545 E F0 2.545(,w)C .045(hich is)-2.545 F .67(in seconds;)144 717.6 R F1<ad52>3.17 E F0 3.17(,w)C .67(hich is in microseconds;)-3.17 F F1<ad70>3.17 E F0 3.17(,w)C .67(hich is in units of 512-byte blocks;) -3.17 F F1<ad50>3.17 E F0(,)A F1<ad54>3.17 E F0(,)A F1<ad62>3.17 E F0(,) -A F1<ad6b>144 729.6 Q F0(,)A F1<ad6e>3.737 E F0 3.737(,a)C(nd)-3.737 E +A F1<ad6b>144 729.6 Q F0(,)A F1<ad6e>3.736 E F0 3.736(,a)C(nd)-3.736 E F1<ad75>3.736 E F0 3.736(,w)C 1.236(hich are unscaled v)-3.736 F 1.236 (alues; and, when in posix mode,)-.25 F F1<ad63>3.736 E F0(and)3.736 E -F1<ad66>3.736 E F0 3.736(,w)C 1.236(hich are in)-3.736 F(GNU Bash 5.2)72 +F1<ad66>3.736 E F0 3.736(,w)C 1.237(hich are in)-3.736 F(GNU Bash 5.2)72 768 Q(2021 No)136.385 E -.15(ve)-.15 G(mber 22).15 E(24)185.545 E 0 Cg EP %%Page: 25 25 @@ -3111,8 +3115,8 @@ BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 87.61 (TINS\(1\) General)-.92 F(Commands Manual)2.5 E -.35(BA)90.11 G(SH_B).35 -E(UIL)-.1 E(TINS\(1\))-.92 E .238(512-byte increments.)144 84 R .238 -(The return status is 0 unless an in)5.238 F -.25(va)-.4 G .238 +E(UIL)-.1 E(TINS\(1\))-.92 E .239(512-byte increments.)144 84 R .238 +(The return status is 0 unless an in)5.239 F -.25(va)-.4 G .238 (lid option or ar).25 F .238(gument is supplied, or an)-.18 F (error occurs while setting a ne)144 96 Q 2.5(wl)-.25 G(imit.)-2.5 E/F1 10/Times-Bold@0 SF(umask)108 112.8 Q F0([)2.5 E F1<ad70>A F0 2.5(][)C F1 @@ -3122,87 +3126,87 @@ E(UIL)-.1 E(TINS\(1\))-.92 E .238(512-byte increments.)144 84 R .238 (gins with a digit, it is interpreted as an octal)-.15 F .066(number; o\ therwise it is interpreted as a symbolic mode mask similar to that acce\ pted by)144 136.8 R F2 -.15(ch)2.566 G(mod).15 E F0(\(1\).).77 E(If)144 -148.8 Q F2(mode)3.263 E F0 .382(is omitted, the current v)3.063 F .382 +148.8 Q F2(mode)3.262 E F0 .382(is omitted, the current v)3.062 F .382 (alue of the mask is printed.)-.25 F(The)5.382 E F1<ad53>2.882 E F0 .382 (option causes the mask to be)2.882 F .547 (printed in symbolic form; the def)144 160.8 R .547 (ault output is an octal number)-.1 F 5.547(.I)-.55 G 3.047(ft)-5.547 G (he)-3.047 E F1<ad70>3.047 E F0 .547(option is supplied, and)3.047 F F2 -(mode)144.38 172.8 Q F0 .552 -(is omitted, the output is in a form that may be reused as input.)3.232 -F .551(The return status is 0 if the)5.551 F(mode w)144 184.8 Q +(mode)144.38 172.8 Q F0 .551 +(is omitted, the output is in a form that may be reused as input.)3.231 +F .552(The return status is 0 if the)5.552 F(mode w)144 184.8 Q (as successfully changed or if no)-.1 E F2(mode)2.5 E F0(ar)2.5 E (gument w)-.18 E(as supplied, and f)-.1 E(alse otherwise.)-.1 E F1 (unalias)108 201.6 Q F0<5bad>2.5 E F1(a)A F0 2.5(][)C F2(name)-2.5 E F0 -(...])2.5 E(Remo)144 213.6 Q 1.057 -.15(ve e)-.15 H(ach).15 E F2(name) -3.257 E F0 .757(from the list of de\214ned aliases.)3.257 F(If)5.758 E -F1<ad61>3.258 E F0 .758(is supplied, all alias de\214nitions are re-) +(...])2.5 E(Remo)144 213.6 Q 1.058 -.15(ve e)-.15 H(ach).15 E F2(name) +3.258 E F0 .758(from the list of de\214ned aliases.)3.258 F(If)5.758 E +F1<ad61>3.258 E F0 .757(is supplied, all alias de\214nitions are re-) 3.258 F(mo)144 225.6 Q -.15(ve)-.15 G 2.5(d. The).15 F(return v)2.5 E (alue is true unless a supplied)-.25 E F2(name)2.86 E F0 (is not a de\214ned alias.)2.68 E F1(unset)108 242.4 Q F0<5bad>2.5 E F1 (fv)A F0 2.5(][)C<ad>-2.5 E F1(n)A F0 2.5(][)C F2(name)-2.5 E F0(...]) -2.5 E -.15(Fo)144 254.4 S 3.804(re).15 G(ach)-3.804 E F2(name)4.164 E F0 -3.804(,r).18 G(emo)-3.804 E 1.604 -.15(ve t)-.15 H 1.304 +2.5 E -.15(Fo)144 254.4 S 3.803(re).15 G(ach)-3.803 E F2(name)4.163 E F0 +3.803(,r).18 G(emo)-3.803 E 1.603 -.15(ve t)-.15 H 1.303 (he corresponding v).15 F 1.303(ariable or function.)-.25 F 1.303 -(If the)6.303 F F1<ad76>3.803 E F0 1.303(option is gi)3.803 F -.15(ve) --.25 G 1.303(n, each).15 F F2(name)144.36 266.4 Q F0 .464 -(refers to a shell v)3.144 F .464(ariable, and that v)-.25 F .464 -(ariable is remo)-.25 F -.15(ve)-.15 G 2.965(d. Read-only).15 F -.25(va) -2.965 G .465(riables may not be un-).25 F 2.769(set. If)144 278.4 R F1 -<ad66>2.769 E F0 .269(is speci\214ed, each)2.769 F F2(name)3.129 E F0 +(If the)6.303 F F1<ad76>3.804 E F0 1.304(option is gi)3.804 F -.15(ve) +-.25 G 1.304(n, each).15 F F2(name)144.36 266.4 Q F0 .465 +(refers to a shell v)3.145 F .464(ariable, and that v)-.25 F .464 +(ariable is remo)-.25 F -.15(ve)-.15 G 2.964(d. Read-only).15 F -.25(va) +2.964 G .464(riables may not be un-).25 F 2.768(set. If)144 278.4 R F1 +<ad66>2.768 E F0 .269(is speci\214ed, each)2.768 F F2(name)3.129 E F0 .269(refers to a shell function, and the function de\214nition is remo) -2.949 F -.15(ve)-.15 G(d.).15 E .403(If the)144 290.4 R F1<ad6e>2.903 E +2.949 F -.15(ve)-.15 G(d.).15 E .404(If the)144 290.4 R F1<ad6e>2.904 E F0 .404(option is supplied, and)2.904 F F2(name)2.904 E F0 .404(is a v) 2.904 F .404(ariable with the)-.25 F F2(namer)2.904 E(ef)-.37 E F0 -(attrib)2.904 E(ute,)-.2 E F2(name)2.904 E F0 .404(will be unset)2.904 F -.72(rather than the v)144 302.4 R .72(ariable it references.)-.25 F F1 -<ad6e>5.72 E F0 .72(has no ef)3.22 F .719(fect if the)-.25 F F1<ad66> -3.219 E F0 .719(option is supplied.)3.219 F .719(If no options)5.719 F -.736(are supplied, each)144 314.4 R F2(name)3.236 E F0 .736 -(refers to a v)3.236 F .737(ariable; if there is no v)-.25 F .737 -(ariable by that name, a function with)-.25 F 1.762(that name, if an)144 -326.4 R 3.062 -.65(y, i)-.15 H 4.262(su).65 G 4.261(nset. Each)-4.262 F +(attrib)2.904 E(ute,)-.2 E F2(name)2.904 E F0 .403(will be unset)2.904 F +.719(rather than the v)144 302.4 R .719(ariable it references.)-.25 F F1 +<ad6e>5.719 E F0 .719(has no ef)3.219 F .719(fect if the)-.25 F F1<ad66> +3.22 E F0 .72(option is supplied.)3.22 F .72(If no options)5.72 F .737 +(are supplied, each)144 314.4 R F2(name)3.237 E F0 .737(refers to a v) +3.237 F .737(ariable; if there is no v)-.25 F .736 +(ariable by that name, a function with)-.25 F 1.761(that name, if an)144 +326.4 R 3.061 -.65(y, i)-.15 H 4.261(su).65 G 4.261(nset. Each)-4.261 F 1.761(unset v)4.261 F 1.761(ariable or function is remo)-.25 F -.15(ve) --.15 G 4.261(df).15 G 1.761(rom the en)-4.261 F(vironment)-.4 E 3.171 +-.15 G 4.262(df).15 G 1.762(rom the en)-4.262 F(vironment)-.4 E 3.172 (passed to subsequent commands.)144 338.4 R 3.172(If an)8.172 F 5.672 (yo)-.15 G(f)-5.672 E/F3 9/Times-Bold@0 SF -.27(BA)5.672 G(SH_ALIASES) -.27 E/F4 9/Times-Roman@0 SF(,)A F3 -.27(BA)5.422 G(SH_ARGV0).27 E F4(,)A -F3 -.27(BA)5.422 G(SH_CMDS).27 E F4(,)A F3 -.27(BA)144 350.4 S -(SH_COMMAND).27 E F4(,)A F3 -.27(BA)11.482 G(SH_SUBSHELL).27 E F4(,)A F3 +.27 E/F4 9/Times-Roman@0 SF(,)A F3 -.27(BA)5.421 G(SH_ARGV0).27 E F4(,)A +F3 -.27(BA)5.421 G(SH_CMDS).27 E F4(,)A F3 -.27(BA)144 350.4 S +(SH_COMMAND).27 E F4(,)A F3 -.27(BA)11.481 G(SH_SUBSHELL).27 E F4(,)A F3 -.27(BA)11.482 G(SHPID).27 E F4(,)A F3(COMP_W)11.482 E(ORDBREAKS)-.09 E -F4(,)A F3(DIRST)11.481 E -.495(AC)-.81 G(K).495 E F4(,)A F3(EPOCHREAL) +F4(,)A F3(DIRST)11.482 E -.495(AC)-.81 G(K).495 E F4(,)A F3(EPOCHREAL) 144 362.4 Q(TIME)-.828 E F4(,)A F3(EPOCHSECONDS)2.67 E F4(,)A F3(FUNCN) 2.67 E(AME)-.18 E F4(,)A F3(GR)2.67 E(OUPS)-.27 E F4(,)A F3(HISTCMD)2.67 E F4(,)A F3(LINENO)2.67 E F4(,)A F3(RANDOM)2.67 E F4(,)A F3(SECONDS)144 -374.4 Q F4(,)A F0(or)4.03 E F3(SRANDOM)4.28 E F0 1.779(are unset, the) -4.03 F 4.279(yl)-.15 G 1.779(ose their special properties, e)-4.279 F --.15(ve)-.25 G 4.279(ni).15 G 4.279(ft)-4.279 G(he)-4.279 E 4.279(ya) --.15 G 1.779(re subse-)-4.279 F(quently reset.)144 386.4 Q(The e)5 E +374.4 Q F4(,)A F0(or)4.029 E F3(SRANDOM)4.279 E F0 1.779(are unset, the) +4.029 F 4.279(yl)-.15 G 1.779(ose their special properties, e)-4.279 F +-.15(ve)-.25 G 4.279(ni).15 G 4.28(ft)-4.279 G(he)-4.28 E 4.28(ya)-.15 G +1.78(re subse-)-4.28 F(quently reset.)144 386.4 Q(The e)5 E (xit status is true unless a)-.15 E F2(name)2.86 E F0 (is readonly or may not be unset.)2.68 E F1(wait)108 403.2 Q F0([)2.5 E F1(\255fn)A F0 2.5(][)C F1<ad70>-2.5 E F2(varname)2.5 E F0 2.5(][)C F2 (id ...)-2.5 E F0(])A -.8(Wa)144 415.2 S .659(it for each speci\214ed c\ hild process and return its termination status.).8 F(Each)5.659 E F2(id) -3.169 E F0 .659(may be a process)3.929 F .009 +3.169 E F0 .658(may be a process)3.928 F .008 (ID or a job speci\214cation; if a job spec is gi)144 427.2 R -.15(ve) --.25 G .008(n, all processes in that job').15 F 2.508(sp)-.55 G .008 -(ipeline are w)-2.508 F .008(aited for)-.1 F 5.008(.I)-.55 G(f)-5.008 E -F2(id)144.01 439.2 Q F0 .441(is not gi)3.711 F -.15(ve)-.25 G(n,).15 E -F1(wait)2.941 E F0 -.1(wa)2.941 G .441 +-.25 G .009(n, all processes in that job').15 F 2.509(sp)-.55 G .009 +(ipeline are w)-2.509 F .009(aited for)-.1 F 5.009(.I)-.55 G(f)-5.009 E +F2(id)144.01 439.2 Q F0 .442(is not gi)3.712 F -.15(ve)-.25 G(n,).15 E +F1(wait)2.942 E F0 -.1(wa)2.942 G .441 (its for all running background jobs and the last-e).1 F -.15(xe)-.15 G -.442(cuted process substitu-).15 F .598 +.441(cuted process substitu-).15 F .597 (tion, if its process id is the same as)144 451.2 R F1($!)3.098 E F0 -3.098(,a)C .598(nd the return status is zero.)-3.098 F .597(If the)5.597 -F F1<ad6e>3.097 E F0 .597(option is supplied,)3.097 F F1(wait)144 463.2 -Q F0 -.1(wa)3.082 G .583(its for a single job from the list of).1 F F2 +3.098(,a)C .598(nd the return status is zero.)-3.098 F .598(If the)5.598 +F F1<ad6e>3.098 E F0 .598(option is supplied,)3.098 F F1(wait)144 463.2 +Q F0 -.1(wa)3.083 G .583(its for a single job from the list of).1 F F2 (id)3.083 E F0 3.083(so)C 1.383 -.4(r, i)-3.083 H 3.083(fn).4 G(o)-3.083 E F2(id)3.083 E F0 3.083(sa)C .583(re supplied, an)-3.083 F 3.083(yj) --.15 G .583(ob, to complete and)-3.083 F .404(returns its e)144 475.2 R -.404(xit status.)-.15 F .403(If none of the supplied ar)5.403 F .403 -(guments is a child of the shell, or if no ar)-.18 F(guments)-.18 E .572 +-.15 G .582(ob, to complete and)-3.083 F .403(returns its e)144 475.2 R +.403(xit status.)-.15 F .403(If none of the supplied ar)5.403 F .403 +(guments is a child of the shell, or if no ar)-.18 F(guments)-.18 E .573 (are supplied and the shell has no unw)144 487.2 R .573 -(aited-for children, the e)-.1 F .573(xit status is 127.)-.15 F .573 -(If the)5.573 F F1<ad70>3.073 E F0 .573(option is)3.073 F .39 +(aited-for children, the e)-.1 F .573(xit status is 127.)-.15 F .572 +(If the)5.573 F F1<ad70>3.072 E F0 .572(option is)3.072 F .39 (supplied, the process or job identi\214er of the job for which the e) 144 499.2 R .39(xit status is returned is assigned to)-.15 F .905(the v) 144 511.2 R(ariable)-.25 E F2(varname)3.405 E F0 .905 @@ -3211,163 +3215,167 @@ E F2(id)3.083 E F0 3.083(sa)C .583(re supplied, an)-3.083 F 3.083(yj) (an)144 523.2 Q 3.89(ya)-.15 G 3.89(ssignment. This)-3.89 F 1.39 (is useful only when the)3.89 F F1<ad6e>3.89 E F0 1.39 (option is supplied.)3.89 F 1.39(Supplying the)6.39 F F1<ad66>3.89 E F0 -(option,)3.89 E .574(when job control is enabled, forces)144 535.2 R F1 +(option,)3.89 E .575(when job control is enabled, forces)144 535.2 R F1 (wait)3.075 E F0 .575(to w)3.075 F .575(ait for)-.1 F F2(id)3.075 E F0 -.575(to terminate before returning its status, in-)3.075 F .635 +.574(to terminate before returning its status, in-)3.075 F .635 (stead of returning when it changes status.)144 547.2 R(If)5.635 E F2 (id)3.145 E F0 .635(speci\214es a non-e)3.905 F .635 -(xistent process or job, the return)-.15 F(status is 127.)144 559.2 Q -(Otherwise, the return status is the e)5 E -(xit status of the last process or job w)-.15 E(aited for)-.1 E(.)-.55 E -/F5 10.95/Times-Bold@0 SF(SHELL COMP)72 576 Q -1.04(AT)-.81 G -(IBILITY MODE)1.04 E F0 1.354(Bash-4.0 introduced the concept of a)108 -588 R F2 1.355(shell compatibility le)3.855 F(vel)-.15 E F0 3.855(,s)C -1.355(peci\214ed as a set of options to the shopt)-3.855 F -.2(bu)108 -600 S .399(iltin \().2 F F1(compat31)2.899 E F0(,)A F1(compat32)2.899 E -F0(,)A F1(compat40)2.899 E F0(,)A F1(compat41)2.899 E F0 2.899(,a)C .399 -(nd so on\).)-2.899 F .398(There is only one current compatibility)5.398 -F(le)108 612 Q -.15(ve)-.25 G 3.253(l-).15 G 3.253(-e)-3.253 G .753 -(ach option is mutually e)-3.253 F(xclusi)-.15 E -.15(ve)-.25 G 5.753 -(.T).15 G .753(he compatibility le)-5.753 F -.15(ve)-.25 G 3.254(li).15 -G 3.254(si)-3.254 G .754(ntended to allo)-3.254 F 3.254(wu)-.25 G .754 -(sers to select be-)-3.254 F(ha)108 624 Q 1.084(vior from pre)-.2 F -1.084(vious v)-.25 F 1.083(ersions that is incompatible with ne)-.15 F -1.083(wer v)-.25 F 1.083(ersions while the)-.15 F 3.583(ym)-.15 G 1.083 -(igrate scripts to use)-3.583 F(current features and beha)108 636 Q +(xistent process or job, the return)-.15 F .802(status is 127.)144 559.2 +R(If)5.801 E F1(wait)3.301 E F0 .801(is interrupted by a signal, the re\ +turn status will be greater than 128, as de-)3.301 F 1.758 +(scribed under)144 571.2 R F1(SIGN)4.258 E(ALS)-.2 E F0(in)4.258 E F2 +(bash\(1\))4.258 E F0 6.758(.O)C 1.759 +(therwise, the return status is the e)-6.758 F 1.759 +(xit status of the last)-.15 F(process or job w)144 583.2 Q(aited for) +-.1 E(.)-.55 E/F5 10.95/Times-Bold@0 SF(SHELL COMP)72 600 Q -1.04(AT) +-.81 G(IBILITY MODE)1.04 E F0 1.355 +(Bash-4.0 introduced the concept of a)108 612 R F2 1.355 +(shell compatibility le)3.855 F(vel)-.15 E F0 3.855(,s)C 1.354 +(peci\214ed as a set of options to the shopt)-3.855 F -.2(bu)108 624 S +.398(iltin \().2 F F1(compat31)2.898 E F0(,)A F1(compat32)2.898 E F0(,)A +F1(compat40)2.898 E F0(,)A F1(compat41)2.898 E F0 2.898(,a)C .399 +(nd so on\).)-2.898 F .399(There is only one current compatibility)5.399 +F(le)108 636 Q -.15(ve)-.25 G 3.254(l-).15 G 3.254(-e)-3.254 G .754 +(ach option is mutually e)-3.254 F(xclusi)-.15 E -.15(ve)-.25 G 5.754 +(.T).15 G .754(he compatibility le)-5.754 F -.15(ve)-.25 G 3.253(li).15 +G 3.253(si)-3.253 G .753(ntended to allo)-3.253 F 3.253(wu)-.25 G .753 +(sers to select be-)-3.253 F(ha)108 648 Q 1.083(vior from pre)-.2 F +1.083(vious v)-.25 F 1.083(ersions that is incompatible with ne)-.15 F +1.083(wer v)-.25 F 1.083(ersions while the)-.15 F 3.584(ym)-.15 G 1.084 +(igrate scripts to use)-3.584 F(current features and beha)108 660 Q (vior)-.2 E 2.5(.I)-.55 G(t')-2.5 E 2.5(si)-.55 G -(ntended to be a temporary solution.)-2.5 E 1.456 -(This section does not mention beha)108 652.8 R 1.457 -(vior that is standard for a particular v)-.2 F 1.457 -(ersion \(e.g., setting)-.15 F F1(compat32)3.957 E F0 .887 -(means that quoting the rhs of the re)108 664.8 R(ge)-.15 E .886 -(xp matching operator quotes special re)-.15 F(ge)-.15 E .886 -(xp characters in the w)-.15 F(ord,)-.1 E(which is def)108 676.8 Q -(ault beha)-.1 E(vior in bash-3.2 and abo)-.2 E -.15(ve)-.15 G(\).).15 E -.522(If a user enables, say)108 693.6 R(,)-.65 E F1(compat32)3.023 E F0 -3.023(,i)C 3.023(tm)-3.023 G .523(ay af)-3.023 F .523(fect the beha)-.25 -F .523(vior of other compatibility le)-.2 F -.15(ve)-.25 G .523 -(ls up to and includ-).15 F .26(ing the current compatibility le)108 -705.6 R -.15(ve)-.25 G 2.76(l. The).15 F .259 -(idea is that each compatibility le)2.759 F -.15(ve)-.25 G 2.759(lc).15 -G .259(ontrols beha)-2.759 F .259(vior that changed)-.2 F 1.645 -(in that v)108 717.6 R 1.646(ersion of)-.15 F F1(bash)4.146 E F0 4.146 -(,b)C 1.646(ut that beha)-4.346 F 1.646(vior may ha)-.2 F 1.946 -.15 -(ve b)-.2 H 1.646(een present in earlier v).15 F 4.146(ersions. F)-.15 F -1.646(or instance, the)-.15 F .761 -(change to use locale-based comparisons with the)108 729.6 R F1([[)3.261 -E F0 .76(command came in bash-4.1, and earlier v)3.261 F .76 -(ersions used)-.15 F(GNU Bash 5.2)72 768 Q(2021 No)136.385 E -.15(ve) --.15 G(mber 22).15 E(25)185.545 E 0 Cg EP +(ntended to be a temporary solution.)-2.5 E 1.457 +(This section does not mention beha)108 676.8 R 1.457 +(vior that is standard for a particular v)-.2 F 1.456 +(ersion \(e.g., setting)-.15 F F1(compat32)3.956 E F0 .886 +(means that quoting the rhs of the re)108 688.8 R(ge)-.15 E .886 +(xp matching operator quotes special re)-.15 F(ge)-.15 E .887 +(xp characters in the w)-.15 F(ord,)-.1 E(which is def)108 700.8 Q +(ault beha)-.1 E(vior in bash-3.2 and subsequent v)-.2 E(ersions\).)-.15 +E .523(If a user enables, say)108 717.6 R(,)-.65 E F1(compat32)3.023 E +F0 3.023(,i)C 3.023(tm)-3.023 G .523(ay af)-3.023 F .523(fect the beha) +-.25 F .523(vior of other compatibility le)-.2 F -.15(ve)-.25 G .522 +(ls up to and includ-).15 F .259(ing the current compatibility le)108 +729.6 R -.15(ve)-.25 G 2.759(l. The).15 F .259 +(idea is that each compatibility le)2.759 F -.15(ve)-.25 G 2.76(lc).15 G +.26(ontrols beha)-2.76 F .26(vior that changed)-.2 F(GNU Bash 5.2)72 768 +Q(2021 No)136.385 E -.15(ve)-.15 G(mber 22).15 E(25)185.545 E 0 Cg EP %%Page: 26 26 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 87.61 (TINS\(1\) General)-.92 F(Commands Manual)2.5 E -.35(BA)90.11 G(SH_B).35 -E(UIL)-.1 E(TINS\(1\))-.92 E 1.904(ASCII-based comparisons, so enabling) -108 84 R/F1 10/Times-Bold@0 SF(compat32)4.404 E F0 1.905 -(will enable ASCII-based comparisons as well.)4.404 F(That)6.905 E .296 -(granularity may not be suf)108 96 R .296 +E(UIL)-.1 E(TINS\(1\))-.92 E 1.646(in that v)108 84 R 1.646(ersion of) +-.15 F/F1 10/Times-Bold@0 SF(bash)4.146 E F0 4.146(,b)C 1.646 +(ut that beha)-4.346 F 1.646(vior may ha)-.2 F 1.946 -.15(ve b)-.2 H +1.646(een present in earlier v).15 F 4.146(ersions. F)-.15 F 1.645 +(or instance, the)-.15 F .76 +(change to use locale-based comparisons with the)108 96 R F1([[)3.261 E +F0 .761(command came in bash-4.1, and earlier v)3.261 F .761 +(ersions used)-.15 F 1.905(ASCII-based comparisons, so enabling)108 108 +R F1(compat32)4.405 E F0 1.904 +(will enable ASCII-based comparisons as well.)4.405 F(That)6.904 E .295 +(granularity may not be suf)108 120 R .296 (\214cient for all uses, and as a result users should emplo)-.25 F 2.796 -(yc)-.1 G .295(ompatibility le)-2.796 F -.15(ve)-.25 G .295(ls care-).15 -F(fully)108 108 Q 5(.R)-.65 G(ead the documentation for a particular fe\ -ature to \214nd out the current beha)-5 E(vior)-.2 E(.)-.55 E .531 -(Bash-4.3 introduced a ne)108 124.8 R 3.031(ws)-.25 G .531(hell v)-3.031 +(yc)-.1 G .296(ompatibility le)-2.796 F -.15(ve)-.25 G .296(ls care-).15 +F(fully)108 132 Q 5(.R)-.65 G(ead the documentation for a particular fe\ +ature to \214nd out the current beha)-5 E(vior)-.2 E(.)-.55 E .532 +(Bash-4.3 introduced a ne)108 148.8 R 3.032(ws)-.25 G .531(hell v)-3.032 F(ariable:)-.25 E/F2 9/Times-Bold@0 SF -.27(BA)3.031 G(SH_COMP).27 E -.855(AT)-.666 G/F3 9/Times-Roman@0 SF(.).855 E F0 .531(The v)5.031 F -.531(alue assigned to this v)-.25 F .532(ariable \(a decimal)-.25 F -.15 -(ve)108 136.8 S .108(rsion number lik).15 F 2.608(e4)-.1 G .108 -(.2, or an inte)-2.608 F .108(ger corresponding to the)-.15 F F1(compat) -2.607 E/F4 10/Times-Italic@0 SF(NN)A F0 .107(option, lik)2.607 F 2.607 -(e4)-.1 G .107(2\) determines the com-)-2.607 F(patibility le)108 148.8 -Q -.15(ve)-.25 G(l.).15 E .387(Starting with bash-4.4, Bash has be)108 -165.6 R .388(gun deprecating older compatibility le)-.15 F -.15(ve)-.25 -G 2.888(ls. Ev).15 F(entually)-.15 E 2.888(,t)-.65 G .388 -(he options will)-2.888 F(be remo)108 177.6 Q -.15(ve)-.15 G 2.5(di).15 +.531(alue assigned to this v)-.25 F .531(ariable \(a decimal)-.25 F -.15 +(ve)108 160.8 S .107(rsion number lik).15 F 2.607(e4)-.1 G .107 +(.2, or an inte)-2.607 F .107(ger corresponding to the)-.15 F F1(compat) +2.608 E/F4 10/Times-Italic@0 SF(NN)A F0 .108(option, lik)2.608 F 2.608 +(e4)-.1 G .108(2\) determines the com-)-2.608 F(patibility le)108 172.8 +Q -.15(ve)-.25 G(l.).15 E .388(Starting with bash-4.4, Bash has be)108 +189.6 R .388(gun deprecating older compatibility le)-.15 F -.15(ve)-.25 +G 2.887(ls. Ev).15 F(entually)-.15 E 2.887(,t)-.65 G .387 +(he options will)-2.887 F(be remo)108 201.6 Q -.15(ve)-.15 G 2.5(di).15 G 2.5(nf)-2.5 G -.2(avo)-2.6 G 2.5(ro).2 G(f)-2.5 E F2 -.27(BA)2.5 G -(SH_COMP).27 E -.855(AT)-.666 G F3(.).855 E F0 1.164 -(Bash-5.0 is the \214nal v)108 194.4 R 1.164 -(ersion for which there will be an indi)-.15 F 1.163 -(vidual shopt option for the pre)-.25 F 1.163(vious v)-.25 F(ersion.) --.15 E(Users should use)108 206.4 Q F2 -.27(BA)2.5 G(SH_COMP).27 E -.855 -(AT)-.666 G F0(on bash-5.0 and later v)3.105 E(ersions.)-.15 E 1.613 -(The follo)108 223.2 R 1.613(wing table describes the beha)-.25 F 1.613 +(SH_COMP).27 E -.855(AT)-.666 G F3(.).855 E F0 1.163 +(Bash-5.0 is the \214nal v)108 218.4 R 1.163 +(ersion for which there will be an indi)-.15 F 1.164 +(vidual shopt option for the pre)-.25 F 1.164(vious v)-.25 F(ersion.) +-.15 E(Users should use)108 230.4 Q F2 -.27(BA)2.5 G(SH_COMP).27 E -.855 +(AT)-.666 G F0(on bash-5.0 and later v)3.105 E(ersions.)-.15 E 1.614 +(The follo)108 247.2 R 1.613(wing table describes the beha)-.25 F 1.613 (vior changes controlled by each compatibility le)-.2 F -.15(ve)-.25 G -4.113(ls).15 G 4.114(etting. The)-4.113 F F1(compat)108 235.2 Q F4(NN)A -F0 1.186(tag is used as shorthand for setting the compatibility le)3.686 +4.113(ls).15 G 4.113(etting. The)-4.113 F F1(compat)108 259.2 Q F4(NN)A +F0 1.186(tag is used as shorthand for setting the compatibility le)3.685 F -.15(ve)-.25 G 3.686(lt).15 G(o)-3.686 E F4(NN)3.686 E F0 1.186 -(using one of the follo)3.686 F(wing)-.25 E 3.806(mechanisms. F)108 -247.2 R 1.306(or v)-.15 F 1.306 +(using one of the follo)3.686 F(wing)-.25 E 3.807(mechanisms. F)108 +271.2 R 1.307(or v)-.15 F 1.307 (ersions prior to bash-5.0, the compatibility le)-.15 F -.15(ve)-.25 G -3.807(lm).15 G 1.307(ay be set using the corresponding)-3.807 F F1 -(compat)108 259.2 Q F4(NN)A F0 .502(shopt option.)3.002 F -.15(Fo)5.502 +3.806(lm).15 G 1.306(ay be set using the corresponding)-3.806 F F1 +(compat)108 283.2 Q F4(NN)A F0 .502(shopt option.)3.002 F -.15(Fo)5.502 G 3.002(rb).15 G .502(ash-4.3 and later v)-3.002 F .502(ersions, the) -.15 F F2 -.27(BA)3.002 G(SH_COMP).27 E -.855(AT)-.666 G F0 -.25(va) 3.607 G .502(riable is preferred, and it).25 F -(is required for bash-5.1 and later v)108 271.2 Q(ersions.)-.15 E F1 -(compat31)108 288 Q F0<83>144 300 Q(quoting the rhs of the)180 300 Q F1 +(is required for bash-5.1 and later v)108 295.2 Q(ersions.)-.15 E F1 +(compat31)108 312 Q F0<83>144 324 Q(quoting the rhs of the)180 324 Q F1 ([[)2.5 E F0(command')2.5 E 2.5(sr)-.55 G -.15(eg)-2.5 G -.15(ex).15 G 2.5(pm).15 G(atching operator \(=~\) has no special ef)-2.5 E(fect)-.25 -E F1(compat32)108 316.8 Q F0<83>144 328.8 Q .35 -(interrupting a command list such as "a ; b ; c" causes the e)180 328.8 -R -.15(xe)-.15 G .35(cution of the ne).15 F .35(xt command)-.15 F .018 -(in the list \(in bash-4.0 and later v)180 340.8 R .018 -(ersions, the shell acts as if it recei)-.15 F -.15(ve)-.25 G 2.517(dt) -.15 G .017(he interrupt, so in-)-2.517 F -(terrupting one command in a list aborts the e)180 352.8 Q -.15(xe)-.15 -G(cution of the entire list\)).15 E F1(compat40)108 369.6 Q F0<83>144 -381.6 Q(the)180 381.6 Q F1(<)2.673 E F0(and)2.673 E F1(>)2.673 E F0 .173 +E F1(compat32)108 340.8 Q F0<83>144 352.8 Q .35 +(interrupting a command list such as "a ; b ; c" causes the e)180 352.8 +R -.15(xe)-.15 G .35(cution of the ne).15 F .35(xt command)-.15 F .017 +(in the list \(in bash-4.0 and later v)180 364.8 R .018 +(ersions, the shell acts as if it recei)-.15 F -.15(ve)-.25 G 2.518(dt) +.15 G .018(he interrupt, so in-)-2.518 F +(terrupting one command in a list aborts the e)180 376.8 Q -.15(xe)-.15 +G(cution of the entire list\)).15 E F1(compat40)108 393.6 Q F0<83>144 +405.6 Q(the)180 405.6 Q F1(<)2.674 E F0(and)2.674 E F1(>)2.673 E F0 .173 (operators to the)2.673 F F1([[)2.673 E F0 .173 (command do not consider the current locale when compar)2.673 F(-)-.2 E -.068(ing strings; the)180 393.6 R 2.568(yu)-.15 G .068 -(se ASCII ordering.)-2.568 F .068(Bash v)5.068 F .067 -(ersions prior to bash-4.1 use ASCII collation)-.15 F(and)180 405.6 Q F4 -(str)4.742 E(cmp)-.37 E F0 1.902 -(\(3\); bash-4.1 and later use the current locale').19 F 4.403(sc)-.55 G -1.903(ollation sequence and)-4.403 F F4(str)4.743 E(-)-.2 E(coll)180 -417.6 Q F0(\(3\).).51 E F1(compat41)108 434.4 Q F0<83>144 446.4 Q(in)180 -446.4 Q F4(posix)3.79 E F0(mode,)3.79 E F1(time)3.79 E F0 1.29 +.067(ing strings; the)180 417.6 R 2.567(yu)-.15 G .067 +(se ASCII ordering.)-2.567 F .068(Bash v)5.068 F .068 +(ersions prior to bash-4.1 use ASCII collation)-.15 F(and)180 429.6 Q F4 +(str)4.743 E(cmp)-.37 E F0 1.903 +(\(3\); bash-4.1 and later use the current locale').19 F 4.402(sc)-.55 G +1.902(ollation sequence and)-4.402 F F4(str)4.742 E(-)-.2 E(coll)180 +441.6 Q F0(\(3\).).51 E F1(compat41)108 458.4 Q F0<83>144 470.4 Q(in)180 +470.4 Q F4(posix)3.79 E F0(mode,)3.79 E F1(time)3.79 E F0 1.29 (may be follo)3.79 F 1.29 (wed by options and still be recognized as a reserv)-.25 F(ed)-.15 E -.1 -(wo)180 458.4 S(rd \(this is POSIX interpretation 267\)).1 E<83>144 -470.4 Q(in)180 470.4 Q F4(posix)2.708 E F0 .208 -(mode, the parser requires that an e)2.708 F -.15(ve)-.25 G 2.708(nn).15 -G .208(umber of single quotes occur in the)-2.708 F F4(wor)2.709 E(d) --.37 E F0 .282(portion of a double-quoted parameter e)180 482.4 R .282 -(xpansion and treats them specially)-.15 F 2.781(,s)-.65 G 2.781(ot) --2.781 G .281(hat charac-)-2.781 F(ters within the single quotes are co\ -nsidered quoted \(this is POSIX interpretation 221\))180 494.4 Q F1 -(compat42)108 511.2 Q F0<83>144 523.2 Q 1.055(the replacement string in\ - double-quoted pattern substitution does not under)180 523.2 R 1.056 -(go quote re-)-.18 F(mo)180 535.2 Q -.25(va)-.15 G(l, as it does in v) -.25 E(ersions after bash-4.2)-.15 E<83>144 547.2 Q .021 -(in posix mode, single quotes are considered special when e)180 547.2 R -.021(xpanding the)-.15 F F4(wor)2.52 E(d)-.37 E F0 .02(portion of a)2.52 -F .017(double-quoted parameter e)180 559.2 R .017 +(wo)180 482.4 S(rd \(this is POSIX interpretation 267\)).1 E<83>144 +494.4 Q(in)180 494.4 Q F4(posix)2.709 E F0 .208 +(mode, the parser requires that an e)2.709 F -.15(ve)-.25 G 2.708(nn).15 +G .208(umber of single quotes occur in the)-2.708 F F4(wor)2.708 E(d) +-.37 E F0 .281(portion of a double-quoted parameter e)180 506.4 R .282 +(xpansion and treats them specially)-.15 F 2.782(,s)-.65 G 2.782(ot) +-2.782 G .282(hat charac-)-2.782 F(ters within the single quotes are co\ +nsidered quoted \(this is POSIX interpretation 221\))180 518.4 Q F1 +(compat42)108 535.2 Q F0<83>144 547.2 Q 1.056(the replacement string in\ + double-quoted pattern substitution does not under)180 547.2 R 1.055 +(go quote re-)-.18 F(mo)180 559.2 Q -.25(va)-.15 G(l, as it does in v) +.25 E(ersions after bash-4.2)-.15 E<83>144 571.2 Q .021 +(in posix mode, single quotes are considered special when e)180 571.2 R +.021(xpanding the)-.15 F F4(wor)2.521 E(d)-.37 E F0 .021(portion of a) +2.521 F .018(double-quoted parameter e)180 583.2 R .017 (xpansion and can be used to quote a closing brace or other spe-)-.15 F -.999(cial character \(this is part of POSIX interpretation 221\); in la\ -ter v)180 571.2 R .998(ersions, single quotes)-.15 F -(are not special within double-quoted w)180 583.2 Q(ord e)-.1 E -(xpansions)-.15 E F1(compat43)108 600 Q F0<83>144 612 Q 1.07 -(the shell does not print a w)180 612 R 1.071 -(arning message if an attempt is made to use a quoted com-)-.1 F .249 -(pound assignment as an ar)180 624 R .248 -(gument to declare \(declare -a foo='\(1 2\)'\). Later v)-.18 F .248 -(ersions w)-.15 F(arn)-.1 E(that this usage is deprecated)180 636 Q<83> -144 648 Q -.1(wo)180 648 S .5(rd e).1 F .501 +.998(cial character \(this is part of POSIX interpretation 221\); in la\ +ter v)180 595.2 R .999(ersions, single quotes)-.15 F +(are not special within double-quoted w)180 607.2 Q(ord e)-.1 E +(xpansions)-.15 E F1(compat43)108 624 Q F0<83>144 636 Q 1.071 +(the shell does not print a w)180 636 R 1.07 +(arning message if an attempt is made to use a quoted com-)-.1 F .248 +(pound assignment as an ar)180 648 R .249 +(gument to declare \(declare -a foo='\(1 2\)'\). Later v)-.18 F .249 +(ersions w)-.15 F(arn)-.1 E(that this usage is deprecated)180 660 Q<83> +144 672 Q -.1(wo)180 672 S .501(rd e).1 F .501 (xpansion errors are considered non-f)-.15 F .501 -(atal errors that cause the current command to)-.1 F -.1(fa)180 660 S +(atal errors that cause the current command to)-.1 F -.1(fa)180 684 S .605(il, e).1 F -.15(ve)-.25 G 3.105(ni).15 G 3.105(np)-3.105 G .605 (osix mode \(the def)-3.105 F .605(ault beha)-.1 F .605(vior is to mak) -.2 F 3.105(et)-.1 G .605(hem f)-3.105 F .605 -(atal errors that cause the)-.1 F(shell to e)180 672 Q(xit\))-.15 E<83> -144 684 Q .354(when e)180 684 R -.15(xe)-.15 G .354 -(cuting a shell function, the loop state \(while/until/etc.\)).15 F .355 -(is not reset, so)5.354 F F1(br)2.855 E(eak)-.18 E F0(or)2.855 E F1 -(continue)180 696 Q F0 .052 +(atal errors that cause the)-.1 F(shell to e)180 696 Q(xit\))-.15 E<83> +144 708 Q .355(when e)180 708 R -.15(xe)-.15 G .354 +(cuting a shell function, the loop state \(while/until/etc.\)).15 F .354 +(is not reset, so)5.354 F F1(br)2.854 E(eak)-.18 E F0(or)2.854 E F1 +(continue)180 720 Q F0 .052 (in that function will break or continue loops in the calling conte) -2.553 F .052(xt. Bash-4.4 and)-.15 F(later reset the loop state to pre) -180 708 Q -.15(ve)-.25 G(nt this).15 E(GNU Bash 5.2)72 768 Q(2021 No) +2.552 F .053(xt. Bash-4.4 and)-.15 F(GNU Bash 5.2)72 768 Q(2021 No) 136.385 E -.15(ve)-.15 G(mber 22).15 E(26)185.545 E 0 Cg EP %%Page: 27 27 %%BeginPageSetup @@ -3375,49 +3383,51 @@ BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 87.61 (TINS\(1\) General)-.92 F(Commands Manual)2.5 E -.35(BA)90.11 G(SH_B).35 -E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0 SF(compat44)108 84 Q F0 -<83>144 96 Q .719(the shell sets up the v)180 96 R .719(alues used by) --.25 F/F2 9/Times-Bold@0 SF -.27(BA)3.219 G(SH_ARGV).27 E F0(and)2.969 E -F2 -.27(BA)3.219 G(SH_ARGC).27 E F0 .719(so the)2.969 F 3.219(yc)-.15 G -.719(an e)-3.219 F(xpand)-.15 E(to the shell')180 108 Q 2.5(sp)-.55 G -(ositional parameters e)-2.5 E -.15(ve)-.25 G 2.5(ni).15 G 2.5(fe)-2.5 G -(xtended deb)-2.65 E(ugging mode is not enabled)-.2 E<83>144 120 Q 2.635 -(as)180 120 S .135(ubshell inherits loops from its parent conte)-2.635 F -.135(xt, so)-.15 F F1(br)2.635 E(eak)-.18 E F0(or)2.635 E F1(continue) -2.634 E F0 .134(will cause the sub-)2.634 F(shell to e)180 132 Q 2.5 -(xit. Bash-5.0)-.15 F(and later reset the loop state to pre)2.5 E -.15 -(ve)-.25 G(nt the e).15 E(xit)-.15 E<83>144 144 Q -.25(va)180 144 S .618 +E(UIL)-.1 E(TINS\(1\))-.92 E(later reset the loop state to pre)180 84 Q +-.15(ve)-.25 G(nt this).15 E/F1 10/Times-Bold@0 SF(compat44)108 100.8 Q +F0<83>144 112.8 Q .719(the shell sets up the v)180 112.8 R .719 +(alues used by)-.25 F/F2 9/Times-Bold@0 SF -.27(BA)3.219 G(SH_ARGV).27 E +F0(and)2.969 E F2 -.27(BA)3.219 G(SH_ARGC).27 E F0 .719(so the)2.969 F +3.218(yc)-.15 G .718(an e)-3.218 F(xpand)-.15 E(to the shell')180 124.8 +Q 2.5(sp)-.55 G(ositional parameters e)-2.5 E -.15(ve)-.25 G 2.5(ni).15 +G 2.5(fe)-2.5 G(xtended deb)-2.65 E(ugging mode is not enabled)-.2 E<83> +144 136.8 Q 2.634(as)180 136.8 S .134 +(ubshell inherits loops from its parent conte)-2.634 F .135(xt, so)-.15 +F F1(br)2.635 E(eak)-.18 E F0(or)2.635 E F1(continue)2.635 E F0 .135 +(will cause the sub-)2.635 F(shell to e)180 148.8 Q 2.5(xit. Bash-5.0) +-.15 F(and later reset the loop state to pre)2.5 E -.15(ve)-.25 G +(nt the e).15 E(xit)-.15 E<83>144 160.8 Q -.25(va)180 160.8 S .619 (riable assignments preceding b).25 F .618(uiltins lik)-.2 F(e)-.1 E F1 (export)3.118 E F0(and)3.118 E F1 -.18(re)3.118 G(adonly).18 E F0 .618 -(that set attrib)3.118 F .619(utes con-)-.2 F .12(tinue to af)180 156 R -.12(fect v)-.25 F .119(ariables with the same name in the calling en) --.25 F .119(vironment e)-.4 F -.15(ve)-.25 G 2.619(ni).15 G 2.619(ft) --2.619 G .119(he shell is)-2.619 F(not in posix mode)180 168 Q F1 -(compat50)108 184.8 Q F0<83>144 196.8 Q 1.209(Bash-5.1 changed the w)180 -196.8 R(ay)-.1 E F2($RANDOM)3.709 E F0 1.209 -(is generated to introduce slightly more random-)3.459 F 1.019 -(ness. If the shell compatibility le)180 208.8 R -.15(ve)-.25 G 3.518 +(that set attrib)3.118 F .618(utes con-)-.2 F .119(tinue to af)180 172.8 +R .119(fect v)-.25 F .119(ariables with the same name in the calling en) +-.25 F .12(vironment e)-.4 F -.15(ve)-.25 G 2.62(ni).15 G 2.62(ft)-2.62 +G .12(he shell is)-2.62 F(not in posix mode)180 184.8 Q F1(compat50)108 +201.6 Q F0<83>144 213.6 Q 1.209(Bash-5.1 changed the w)180 213.6 R(ay) +-.1 E F2($RANDOM)3.709 E F0 1.209 +(is generated to introduce slightly more random-)3.459 F 1.018 +(ness. If the shell compatibility le)180 225.6 R -.15(ve)-.25 G 3.518 (li).15 G 3.518(ss)-3.518 G 1.018(et to 50 or lo)-3.518 F(wer)-.25 E -3.518(,i)-.4 G 3.518(tr)-3.518 G -2.15 -.25(ev e)-3.518 H 1.018 -(rts to the method from).25 F .732(bash-5.0 and pre)180 220.8 R .732 -(vious v)-.25 F .733 +3.518(,i)-.4 G 3.518(tr)-3.518 G -2.15 -.25(ev e)-3.518 H 1.019 +(rts to the method from).25 F .733(bash-5.0 and pre)180 237.6 R .733 +(vious v)-.25 F .732 (ersions, so seeding the random number generator by assigning a)-.15 F --.25(va)180 232.8 S(lue to).25 E F2(RANDOM)2.5 E F0 -(will produce the same sequence as in bash-5.0)2.25 E<83>144 244.8 Q -.696(If the command hash table is empty)180 244.8 R 3.196(,b)-.65 G .696 -(ash v)-3.196 F .695(ersions prior to bash-5.1 printed an informa-)-.15 -F 1.32(tional message to that ef)180 256.8 R 1.321(fect, e)-.25 F -.15 +-.25(va)180 249.6 S(lue to).25 E F2(RANDOM)2.5 E F0 +(will produce the same sequence as in bash-5.0)2.25 E<83>144 261.6 Q +.695(If the command hash table is empty)180 261.6 R 3.196(,b)-.65 G .696 +(ash v)-3.196 F .696(ersions prior to bash-5.1 printed an informa-)-.15 +F 1.321(tional message to that ef)180 273.6 R 1.321(fect, e)-.25 F -.15 (ve)-.25 G 3.821(nw).15 G 1.321 (hen producing output that can be reused as input.)-3.821 F -(Bash-5.1 suppresses that message when the)180 268.8 Q F1<ad6c>2.5 E F0 -(option is supplied.)2.5 E F1(compat51)108 285.6 Q F0<83>144 297.6 Q -(The)180 297.6 Q F1(unset)2.955 E F0 -.2(bu)2.955 G .455 -(iltin treats attempts to unset array subscripts).2 F F1(@)2.954 E F0 -(and)2.954 E F1(*)2.954 E F0(dif)2.954 E .454(ferently depending)-.25 F -(on whether the array is inde)180 309.6 Q -.15(xe)-.15 G 2.5(do).15 G +(Bash-5.1 suppresses that message when the)180 285.6 Q F1<ad6c>2.5 E F0 +(option is supplied.)2.5 E F1(compat51)108 302.4 Q F0<83>144 314.4 Q +(The)180 314.4 Q F1(unset)2.954 E F0 -.2(bu)2.954 G .454 +(iltin treats attempts to unset array subscripts).2 F F1(@)2.955 E F0 +(and)2.955 E F1(*)2.955 E F0(dif)2.955 E .455(ferently depending)-.25 F +(on whether the array is inde)180 326.4 Q -.15(xe)-.15 G 2.5(do).15 G 2.5(ra)-2.5 G(ssociati)-2.5 E -.15(ve)-.25 G 2.5(,a).15 G(nd dif)-2.5 E (ferently than in pre)-.25 E(vious v)-.25 E(ersions.)-.15 E/F3 10.95 -/Times-Bold@0 SF(SEE ALSO)72 326.4 Q F0(bash\(1\), sh\(1\))108 338.4 Q +/Times-Bold@0 SF(SEE ALSO)72 343.2 Q F0(bash\(1\), sh\(1\))108 355.2 Q (GNU Bash 5.2)72 768 Q(2021 No)136.385 E -.15(ve)-.15 G(mber 22).15 E (27)185.545 E 0 Cg EP %%Trailer |