Imported from ../bash-1.14.7.tar.gz.
[platform/upstream/bash.git] / documentation / builtins.ps
1 %!PS-Adobe-3.0
2 %%Creator: groff version 1.08
3 %%DocumentNeededResources: font Times-Roman
4 %%+ font Times-Bold
5 %%+ font Times-Italic
6 %%+ font Symbol
7 %%DocumentSuppliedResources: procset grops 1.08 0
8 %%Pages: 11
9 %%PageOrder: Ascend
10 %%Orientation: Portrait
11 %%EndComments
12 %%BeginProlog
13 %%BeginResource: procset grops 1.08 0
14 /setpacking where{
15 pop
16 currentpacking
17 true setpacking
18 }if
19 /grops 120 dict dup begin
20 /SC 32 def
21 /A/show load def
22 /B{0 SC 3 -1 roll widthshow}bind def
23 /C{0 exch ashow}bind def
24 /D{0 exch 0 SC 5 2 roll awidthshow}bind def
25 /E{0 rmoveto show}bind def
26 /F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
27 /G{0 rmoveto 0 exch ashow}bind def
28 /H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
29 /I{0 exch rmoveto show}bind def
30 /J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
31 /K{0 exch rmoveto 0 exch ashow}bind def
32 /L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
33 /M{rmoveto show}bind def
34 /N{rmoveto 0 SC 3 -1 roll widthshow}bind def
35 /O{rmoveto 0 exch ashow}bind def
36 /P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
37 /Q{moveto show}bind def
38 /R{moveto 0 SC 3 -1 roll widthshow}bind def
39 /S{moveto 0 exch ashow}bind def
40 /T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
41 /SF{
42 findfont exch
43 [exch dup 0 exch 0 exch neg 0 0]makefont
44 dup setfont
45 [exch/setfont cvx]cvx bind def
46 }bind def
47 /MF{
48 findfont
49 [5 2 roll
50 0 3 1 roll 
51 neg 0 0]makefont
52 dup setfont
53 [exch/setfont cvx]cvx bind def
54 }bind def
55 /level0 0 def
56 /RES 0 def
57 /PL 0 def
58 /LS 0 def
59 /PLG{
60 gsave newpath clippath pathbbox grestore
61 exch pop add exch pop
62 }bind def
63 /BP{
64 /level0 save def
65 1 setlinecap
66 1 setlinejoin
67 72 RES div dup scale
68 LS{
69 90 rotate
70 }{
71 0 PL translate
72 }ifelse
73 1 -1 scale
74 }bind def
75 /EP{
76 level0 restore
77 showpage
78 }bind def
79 /DA{
80 newpath arcn stroke
81 }bind def
82 /SN{
83 transform
84 .25 sub exch .25 sub exch
85 round .25 add exch round .25 add exch
86 itransform
87 }bind def
88 /DL{
89 SN
90 moveto
91 SN
92 lineto stroke
93 }bind def
94 /DC{
95 newpath 0 360 arc closepath
96 }bind def
97 /TM matrix def
98 /DE{
99 TM currentmatrix pop
100 translate scale newpath 0 0 .5 0 360 arc closepath
101 TM setmatrix
102 }bind def
103 /RC/rcurveto load def
104 /RL/rlineto load def
105 /ST/stroke load def
106 /MT/moveto load def
107 /CL/closepath load def
108 /FL{
109 currentgray exch setgray fill setgray
110 }bind def
111 /BL/fill load def
112 /LW/setlinewidth load def
113 /RE{
114 findfont
115 dup maxlength 1 index/FontName known not{1 add}if dict begin
116 {
117 1 index/FID ne{def}{pop pop}ifelse
118 }forall
119 /Encoding exch def
120 dup/FontName exch def
121 currentdict end definefont pop
122 }bind def
123 /DEFS 0 def
124 /EBEGIN{
125 moveto
126 DEFS begin
127 }bind def
128 /EEND/end load def
129 /CNT 0 def
130 /level1 0 def
131 /PBEGIN{
132 /level1 save def
133 translate
134 div 3 1 roll div exch scale
135 neg exch neg exch translate
136 0 setgray
137 0 setlinecap
138 1 setlinewidth
139 0 setlinejoin
140 10 setmiterlimit
141 []0 setdash
142 /setstrokeadjust where{
143 pop
144 false setstrokeadjust
145 }if
146 /setoverprint where{
147 pop
148 false setoverprint
149 }if
150 newpath
151 /CNT countdictstack def
152 userdict begin
153 /showpage{}def
154 }bind def
155 /PEND{
156 clear
157 countdictstack CNT sub{end}repeat
158 level1 restore
159 }bind def
160 end def
161 /setpacking where{
162 pop
163 setpacking
164 }if
165 %%EndResource
166 %%IncludeResource: font Times-Roman
167 %%IncludeResource: font Times-Bold
168 %%IncludeResource: font Times-Italic
169 %%IncludeResource: font Symbol
170 grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72 def/PL
171 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron/scaron/zcaron
172 /Ydieresis/trademark/quotesingle/.notdef/.notdef/.notdef/.notdef/.notdef
173 /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
174 /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/space
175 /exclam/quotedbl/numbersign/dollar/percent/ampersand/quoteright/parenleft
176 /parenright/asterisk/plus/comma/hyphen/period/slash/zero/one/two/three/four
177 /five/six/seven/eight/nine/colon/semicolon/less/equal/greater/question/at/A/B/C
178 /D/E/F/G/H/I/J/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash
179 /bracketright/circumflex/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q
180 /r/s/t/u/v/w/x/y/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase
181 /guillemotleft/guillemotright/bullet/florin/fraction/perthousand/dagger
182 /daggerdbl/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
183 /dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
184 /quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen/brokenbar
185 /section/dieresis/copyright/ordfeminine/guilsinglleft/logicalnot/minus
186 /registered/macron/degree/plusminus/twosuperior/threesuperior/acute/mu
187 /paragraph/periodcentered/cedilla/onesuperior/ordmasculine/guilsinglright
188 /onequarter/onehalf/threequarters/questiondown/Agrave/Aacute/Acircumflex/Atilde
189 /Adieresis/Aring/AE/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute
190 /Icircumflex/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
191 /multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn/germandbls
192 /agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla/egrave/eacute
193 /ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis/eth/ntilde/ograve
194 /oacute/ocircumflex/otilde/odieresis/divide/oslash/ugrave/uacute/ucircumflex
195 /udieresis/yacute/thorn/ydieresis]def/Times-Italic@0 ENC0/Times-Italic RE
196 /Times-Bold@0 ENC0/Times-Bold RE/Times-Roman@0 ENC0/Times-Roman RE
197 %%EndProlog
198 %%Page: 1 1
199 %%BeginPageSetup
200 BP
201 %%EndPageSetup
202 /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
203 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 9/Times-Bold@0
204 SF -.18(NA)72 84 S(ME).18 E F0 .393(bash, :, ., alias, bg, bind, break, b)108
205 96 R .392
206 (uiltin, bye, case, cd, command, continue, declare, dirs, echo, enable, e)-.2 F
207 -.25(va)-.25 G(l,).25 E -.15(exe)108 108 S .559(c, e).15 F .559(xit, e)-.15 F
208 .559(xport, fc, fg, for)-.15 F 3.059(,g)-.4 G .559(etopts, hash, help, history)
209 231.984 108 R 3.059(,i)-.65 G .56
210 (f, jobs, kill, let, local, logout, popd, pushd, pwd,)343.57 108 R 1.562
211 (read, readonly)108 120 R 4.062(,r)-.65 G 1.561(eturn, set, shift, source, sus\
212 pend, test, times, trap, type, typeset, ulimit, umask, unalias,)176.004 120 R
213 (unset, until, w)108 132 Q(ait, while \255 bash b)-.1 E(uilt-in commands, see)
214 -.2 E/F2 10/Times-Bold@0 SF(bash)2.5 E F0(\(1\))A F1 -.27(BA)72 148.8 S(SH B)
215 .27 E(UIL)-.09 E(TIN COMMANDS)-.828 E F2(:)108 160.8 Q F0([)2.5 E/F3 10
216 /Times-Italic@0 SF(ar)A(guments)-.37 E F0(])A .501(No ef)144 172.8 R .501
217 (fect; the command does nothing be)-.25 F .502(yond e)-.15 F(xpanding)-.15 E F3
218 (ar)3.002 E(guments)-.37 E F0 .502(and performing an)3.002 F 3.002(ys)-.15 G
219 (peci\214ed)508.34 172.8 Q 2.5(redirections. A)144 184.8 R(zero e)2.5 E
220 (xit code is returned.)-.15 E F2(.)110.5 201.6 Q F3(\214lename)6.666 E F0([)2.5
221 E F3(ar)A(guments)-.37 E F0(])A F2(sour)108 213.6 Q(ce)-.18 E F3(\214lename)2.5
222 E F0([)2.5 E F3(ar)A(guments)-.37 E F0(])A 1.17(Read and e)144 225.6 R -.15(xe)
223 -.15 G 1.17(cute commands from).15 F F3(\214lename)3.669 E F0 1.169
224 (in the current shell en)3.669 F 1.169(vironment and return the e)-.4 F(xit)
225 -.15 E 1.301(status of the last command e)144 237.6 R -.15(xe)-.15 G 1.301
226 (cuted from).15 F F3(\214lename)3.801 E F0 6.301(.I).18 G(f)368.138 237.6 Q F3
227 (\214lename)3.801 E F0 1.302(does not contain a slash, path-)3.801 F .608
228 (names in)144 249.6 R F1 -.666(PA)3.108 G(TH)-.189 E F0 .608
229 (are used to \214nd the directory containing)2.858 F F3(\214lename)3.108 E F0
230 5.608(.T).18 G .608(he \214le searched for in)424.339 249.6 R F1 -.666(PA)3.108
231 G(TH)-.189 E F0 .201(need not be e)144 261.6 R -.15(xe)-.15 G 2.701
232 (cutable. The).15 F .201
233 (current directory is searched if no \214le is found in)2.701 F F1 -.666(PA)
234 2.701 G(TH)-.189 E/F4 9/Times-Roman@0 SF(.)A F0 .201(If an)4.701 F(y)-.15 E F3
235 (ar)2.702 E(gu-)-.37 E(ments)144 273.6 Q F0 1.058(are supplied, the)3.558 F
236 3.558(yb)-.15 G 1.058(ecome the positional parameters when)252.232 273.6 R F3
237 (\214le)3.558 E F0 1.057(is e)3.557 F -.15(xe)-.15 G 3.557(cuted. Otherwise).15
238 F(the)3.557 E 1.078(positional parameters are unchanged.)144 285.6 R 1.079
239 (The return status is the status of the last command e)6.078 F(xited)-.15 E
240 (within the script \(0 if no commands are e)144 297.6 Q -.15(xe)-.15 G
241 (cuted\), and f).15 E(alse if)-.1 E F3(\214lename)2.5 E F0(is not found.)2.5 E
242 F2(alias)108 314.4 Q F0([)2.5 E F3(name)A F0([=)A F3(value)A F0 2.5(].)C(..])
243 193.9 314.4 Q F2(Alias)144 326.4 Q F0 1.668(with no ar)4.168 F 1.667
244 (guments prints the list of aliases in the form)-.18 F F3(name)4.167 E F0(=)A
245 F3(value)A F0 1.667(on standard output.)4.167 F .606(When ar)144 338.4 R .607
246 (guments are supplied, an alias is de\214ned for each)-.18 F F3(name)3.107 E F0
247 (whose)3.107 E F3(value)3.107 E F0 .607(is gi)3.107 F -.15(ve)-.25 G 3.107
248 (n. A).15 F(trailing)3.107 E 2.693(space in)144 350.4 R F3(value)5.193 E F0
249 2.693(causes the ne)5.193 F 2.693(xt w)-.15 F 2.693(ord to be check)-.1 F 2.692
250 (ed for alias substitution when the alias is)-.1 F -.15(ex)144 362.4 S 2.867
251 (panded. F).15 F .367(or each)-.15 F F3(name)2.867 E F0 .367(in the ar)2.867 F
252 .367(gument list for which no)-.18 F F3(value)2.867 E F0 .367
253 (is supplied, the name and v)2.867 F(alue)-.25 E 1.717
254 (of the alias is printed.)144 374.4 R F2(Alias)6.717 E F0 1.717
255 (returns true unless a)4.217 F F3(name)4.217 E F0 1.717(is gi)4.217 F -.15(ve)
256 -.25 G 4.216(nf).15 G 1.716(or which no alias has been)425.61 374.4 R
257 (de\214ned.)144 386.4 Q F2(bg)108 403.2 Q F0([)2.5 E F3(jobspec)A F0(])A(Place)
258 144 415.2 Q F3(jobspec)3.485 E F0 .985
259 (in the background, as if it had been started with)3.485 F F2(&)3.485 E F0
260 5.985(.I)C(f)425.645 415.2 Q F3(jobspec)3.485 E F0 .985(is not present, the)
261 3.485 F(shell')144 427.2 Q 3.102(sn)-.55 G .602(otion of the)177.662 427.2 R F3
262 (curr)3.102 E .602(ent job)-.37 F F0 .602(is used.)3.102 F F2(bg)5.602 E F3
263 (jobspec)3.102 E F0 .601(returns 0 unless run when job control is dis-)3.102 F
264 .565(abled or)144 439.2 R 3.065(,w)-.4 G .565
265 (hen run with job control enabled, if)189.44 439.2 R F3(jobspec)3.065 E F0 -.1
266 (wa)3.065 G 3.065(sn).1 G .566(ot found or started without job con-)394.395
267 439.2 R(trol.)144 451.2 Q F2(bind)108 468 Q F0([)2.5 E F2<ad6d>A F3 -.1(ke)2.5
268 G(ymap)-.2 E F0 2.5(][)C F2(\255lvd)189.12 468 Q F0 2.5(][)C F2(-q)217.32 468 Q
269 F3(name)2.5 E F0(])A F2(bind)108 480 Q F0([)2.5 E F2<ad6d>A F3 -.1(ke)2.5 G
270 (ymap)-.2 E F0(])A F2(-f)2.5 E F3(\214lename)2.5 E F2(bind)108 492 Q F0([)2.5 E
271 F2<ad6d>A F3 -.1(ke)2.5 G(ymap)-.2 E F0(])A F3 -.1(ke)2.5 G(yseq)-.2 E F0(:)A
272 F3(function-name)A F0 .239(Display current)144 504 R F2 -.18(re)2.739 G(adline)
273 .18 E F0 -.1(ke)2.739 G 2.739(ya)-.05 G .239(nd function bindings, or bind a k)
274 267.836 504 R .538 -.15(ey s)-.1 H .238(equence to a).15 F F2 -.18(re)2.738 G
275 (adline).18 E F0(function)2.738 E .88(or macro.)144 516 R .88
276 (The binding syntax accepted is identical to that of)5.88 F F3(.inputr)3.38 E
277 (c)-.37 E F0 3.38(,b).31 G .88(ut each binding must be)440.93 516 R .381
278 (passed as a separate ar)144 528 R .381
279 (gument; e.g., '"\\C-x\\C-r": re\255read\255init\255\214le'.)-.18 F .381
280 (Options, if supplied, ha)5.381 F .68 -.15(ve t)-.2 H(he).15 E(follo)144 540 Q
281 (wing meanings:)-.25 E F2<ad6d>144 552 Q F3 -.1(ke)2.5 G(ymap)-.2 E F0(Use)180
282 564 Q F3 -.1(ke)5.174 G(ymap)-.2 E F0 2.674(as the k)5.174 F -.15(ey)-.1 G
283 2.674(map to be af).15 F 2.674(fected by the subsequent bindings.)-.25 F
284 (Acceptable)7.675 E F3 -.1(ke)180 576 S(ymap)-.2 E F0 2.929(names are)5.429 F
285 F3 2.929(emacs, emacs-standar)5.429 F 2.929
286 (d, emacs-meta, emacs-ctlx, vi, vi-mo)-.37 F(ve)-.1 E 5.428(,v)-.1 G(i-)533.89
287 576 Q(command)180 588 Q F0 3.434(,a)C(nd)229.254 588 Q F3(vi-insert)3.434 E F0
288 (.).68 E F3(vi)5.934 E F0 .934(is equi)3.434 F -.25(va)-.25 G .934(lent to).25
289 F F3(vi-command)3.434 E F0(;)A F3(emacs)3.434 E F0 .934(is equi)3.434 F -.25
290 (va)-.25 G .935(lent to).25 F F3(emacs-)3.435 E(standar)180 600 Q(d)-.37 E F0
291 (.)A F2<ad6c>144 612 Q F0(List the names of all)180 612 Q F2 -.18(re)2.5 G
292 (adline).18 E F0(functions)2.5 E F2<ad76>144 624 Q F0
293 (List current function names and bindings)180 624 Q F2<ad64>144 636 Q F0
294 (Dump function names and bindings in such a w)180 636 Q(ay that the)-.1 E 2.5
295 (yc)-.15 G(an be re-read)423.89 636 Q F2<ad66>144 648 Q F3(\214lename)2.5 E F0
296 (Read k)180 660 Q .3 -.15(ey b)-.1 H(indings from).15 E F3(\214lename)2.5 E F2
297 <ad71>144 672 Q F3(function)2.5 E F0(Query about which k)180 684 Q -.15(ey)-.1
298 G 2.5(si).15 G -1.9 -.4(nv o)282.51 684 T .2 -.1(ke t).4 H(he named).1 E F3
299 (function)2.5 E F0(The return v)144 700.8 Q
300 (alue is 0 unless an unrecognized option is gi)-.25 E -.15(ve)-.25 G 2.5(no).15
301 G 2.5(ra)391.37 700.8 S 2.5(ne)401.64 700.8 S(rror occurred.)413.58 700.8 Q
302 170.955(GNU 1993)72 768 R(September 16)2.5 E(1)535 768 Q EP
303 %%Page: 2 2
304 %%BeginPageSetup
305 BP
306 %%EndPageSetup
307 /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
308 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0
309 SF(br)108 84 Q(eak)-.18 E F0([)2.5 E/F2 10/Times-Italic@0 SF(n)A F0(])A .076
310 (Exit from within a)144 96 R F1 -.25(fo)2.576 G(r).25 E F0(,)A F1(while)2.576 E
311 F0 2.576(,o)C(r)270.866 96 Q F1(until)2.576 E F0 2.576(loop. If)2.576 F F2(n)
312 2.576 E F0 .076(is speci\214ed, break)2.576 F F2(n)2.576 E F0(le)2.576 E -.15
313 (ve)-.25 G(ls.).15 E F2(n)5.075 E F0 .075(must be)2.575 F/F3 10/Symbol SF<b3>
314 2.575 E F0 2.575(1. If)2.575 F F2(n)2.575 E F0(is)2.575 E .838
315 (greater than the number of enclosing loops, all enclosing loops are e)144 108
316 R 3.338(xited. The)-.15 F .838(return v)3.338 F .839(alue is 0)-.25 F
317 (unless the shell is not e)144 120 Q -.15(xe)-.15 G(cuting a loop when).15 E F1
318 (br)2.5 E(eak)-.18 E F0(is e)2.5 E -.15(xe)-.15 G(cuted.).15 E F1 -.2(bu)108
319 136.8 S(iltin).2 E F2(shell\255b)2.5 E(uiltin)-.2 E F0([)2.5 E F2(ar)A(guments)
320 -.37 E F0(])A(Ex)144 148.8 Q .793(ecute the speci\214ed shell b)-.15 F .793
321 (uiltin, passing it)-.2 F F2(ar)3.293 E(guments)-.37 E F0 3.293(,a).27 G .793
322 (nd return its e)382.104 148.8 R .792(xit status.)-.15 F .792(This is useful)
323 5.792 F .603
324 (when you wish to de\214ne a function whose name is the same as a shell b)144
325 160.8 R .603(uiltin, b)-.2 F .603(ut need the func-)-.2 F .773
326 (tionality of the b)144 172.8 R .773(uiltin within the function itself.)-.2 F
327 (The)5.773 E F1(cd)3.273 E F0 -.2(bu)3.273 G .772
328 (iltin is commonly rede\214ned this w).2 F(ay)-.1 E(.)-.65 E
329 (The return status is f)144 184.8 Q(alse if)-.1 E F2(shell\255b)2.5 E(uiltin)
330 -.2 E F0(is not a shell b)2.5 E(uiltin command.)-.2 E F1(cd)108 201.6 Q F0([)
331 2.5 E F2(dir)A F0 5.17(]C)C .21(hange the current directory to)150.67 201.6 R
332 F2(dir)2.71 E F0 5.21(.T)C .21(he v)298.01 201.6 R(ariable)-.25 E/F4 9
333 /Times-Bold@0 SF(HOME)2.71 E F0 .21(is the def)2.46 F(ault)-.1 E F2(dir)2.71 E
334 F0 5.21(.T).73 G .21(he v)456.703 201.6 R(ariable)-.25 E F4(CDP)2.71 E -.855
335 (AT)-.666 G(H).855 E F0 .337
336 (de\214nes the search path for the directory containing)144 213.6 R F2(dir)
337 2.837 E F0 5.337(.A).73 G(lternati)379.663 213.6 Q .637 -.15(ve d)-.25 H .337
338 (irectory names are separated).15 F .309(by a colon \(:\).)144 225.6 R 2.809
339 (An)5.309 G .309(ull directory name in)221.365 225.6 R F4(CDP)2.809 E -.855(AT)
340 -.666 G(H).855 E F0 .309(is the same as the current directory)2.559 F 2.809(,i)
341 -.65 G .31(.e., `)496.44 225.6 R(`)-.74 E F1(.)A F0 -.74('')C 5.31(.I).74 G(f)
342 536.67 225.6 Q F2(dir)144 237.6 Q F0(be)3.419 E .919
343 (gins with a slash \(/\), then)-.15 F F4(CDP)3.419 E -.855(AT)-.666 G(H).855 E
344 F0 .919(is not used.)3.169 F .918(An ar)5.918 F .918(gument of)-.18 F F1<ad>
345 3.418 E F0 .918(is equi)3.418 F -.25(va)-.25 G .918(lent to).25 F F4($OLD-)
346 3.418 E(PWD)144 249.6 Q/F5 9/Times-Roman@0 SF(.)A F0(The return v)4.5 E
347 (alue is true if the directory w)-.25 E(as successfully changed; f)-.1 E
348 (alse otherwise.)-.1 E F1(command)108 266.4 Q F0([)2.5 E F1(-pVv)A F0(])A F2
349 (command)2.5 E F0([)2.5 E F2(ar)A(g)-.37 E F0(...])2.5 E(Run)144 278.4 Q F2
350 (command)2.877 E F0(with)2.877 E F2(ar)2.877 E(gs)-.37 E F0 .378
351 (suppressing the normal shell function lookup. Only b)2.877 F .378
352 (uiltin commands or)-.2 F .559(commands found in the)144 290.4 R F4 -.666(PA)
353 3.059 G(TH)-.189 E F0 .559(are e)2.809 F -.15(xe)-.15 G 3.059(cuted. If).15 F
354 (the)3.059 E F1<ad70>3.059 E F0 .559(option is gi)3.059 F -.15(ve)-.25 G .558
355 (n, the search for).15 F F2(command)3.058 E F0(is)3.058 E .231
356 (performed using a def)144 302.4 R .231(ault v)-.1 F .231(alue for)-.25 F F1
357 -.74(PA)2.731 G(TH)-.21 E F0 .231
358 (that is guaranteed to \214nd all of the standard utilities.)2.731 F(If)5.232 E
359 .232(either the)144 314.4 R F1<ad56>2.732 E F0(or)2.732 E F1<ad76>2.732 E F0
360 .232(option is supplied, a description of)2.732 F F2(command)2.732 E F0 .232
361 (is printed.)2.732 F(The)5.231 E F1<ad76>2.731 E F0 .231(option causes)2.731 F
362 2.71(as)144 326.4 S .21(ingle w)155.04 326.4 R .21
363 (ord indicating the command or pathname used to in)-.1 F -.2(vo)-.4 G -.1(ke).2
364 G F2(command)2.811 E F0 .211(to be printed; the)2.711 F F1<ad56>2.711 E F0 .476
365 (option produces a more v)144 338.4 R .476(erbose description.)-.15 F .476
366 (An ar)5.476 F .476(gument of)-.18 F F1<adad>2.976 E F0 .475
367 (disables option checking for the)2.976 F 1.348(rest of the ar)144 350.4 R
368 3.848(guments. If)-.18 F(the)3.848 E F1<ad56>3.848 E F0(or)3.848 E F1<ad76>
369 3.848 E F0 1.348(option is supplied, the e)3.848 F 1.349(xit status is 0 if)
370 -.15 F F2(command)3.849 E F0 -.1(wa)3.849 G(s).1 E 1.306(found, and 1 if not.)
371 144 362.4 R 1.305(If neither option is supplied and an error occurred or)6.306
372 F F2(command)3.805 E F0 1.305(cannot be)3.805 F .092(found, the e)144 374.4 R
373 .092(xit status is 127.)-.15 F .092(Otherwise, the e)5.092 F .092
374 (xit status of the)-.15 F F1(command)2.592 E F0 -.2(bu)2.592 G .093
375 (iltin is the e).2 F .093(xit status of)-.15 F F2(command)144 386.4 Q F0(.).77
376 E F1(continue)108 403.2 Q F0([)2.5 E F2(n)A F0(])A .065(Resume the ne)144 415.2
377 R .065(xt iteration of the enclosing)-.15 F F1 -.25(fo)2.565 G(r).25 E F0(,)A
378 F1(while)2.565 E F0 2.564(,o)C(r)366.104 415.2 Q F1(until)2.564 E F0 2.564
379 (loop. If)2.564 F F2(n)2.564 E F0 .064(is speci\214ed, resume at the)2.564 F F2
380 (n)144 427.2 Q F0 1.168(th enclosing loop.)B F2(n)6.169 E F0 1.169(must be)
381 3.669 F F3<b3>3.669 E F0 3.669(1. If)3.669 F F2(n)3.669 E F0 1.169
382 (is greater than the number of enclosing loops, the last)3.669 F 1.594
383 (enclosing loop \(the `top\255le)144 439.2 R -.15(ve)-.25 G 1.593
384 (l' loop\) is resumed.).15 F 1.593(The return v)6.593 F 1.593
385 (alue is 0 unless the shell is not)-.25 F -.15(exe)144 451.2 S
386 (cuting a loop when).15 E F1(continue)2.5 E F0(is e)2.5 E -.15(xe)-.15 G
387 (cuted.).15 E F1(declar)108 468 Q(e)-.18 E F0([)2.5 E F1(\255frxi)A F0 2.5(][)C
388 F2(name)175.16 468 Q F0([=)A F2(value)A F0(]])A F1(typeset)108 480 Q F0([)2.5 E
389 F1(\255frxi)A F0 2.5(][)C F2(name)174.23 480 Q F0([=)A F2(value)A F0(]])A 1.098
390 (Declare v)144 492 R 1.098(ariables and/or gi)-.25 F 1.398 -.15(ve t)-.25 H
391 1.098(hem attrib).15 F 3.598(utes. If)-.2 F(no)3.598 E F2(name)3.598 E F0 3.598
392 (sa)C 1.098(re gi)394.362 492 R -.15(ve)-.25 G 1.098(n, then display the v).15
393 F 1.098(alues of)-.25 F -.25(va)144 504 S 2.492(riables instead.).25 F 2.491
394 (The options can be used to restrict output to v)7.492 F 2.491
395 (ariables with the speci\214ed)-.25 F(attrib)144 516 Q(ute.)-.2 E F1<ad66>144
396 528 Q F0(Use function names only)180 528 Q F1<ad72>144 540 Q F0(Mak)180 540 Q
397 (e)-.1 E F2(name)5.046 E F0 5.046(sr)C(eadonly)241.642 540 Q 7.546(.T)-.65 G
398 2.546(hese names cannot then be assigned v)288.808 540 R 2.547
399 (alues by subsequent)-.25 F(assignment statements.)180 552 Q F1<ad78>144 564 Q
400 F0(Mark)180 564 Q F2(name)2.5 E F0 2.5(sf)C(or e)235.54 564 Q
401 (xport to subsequent commands via the en)-.15 E(vironment.)-.4 E F1<ad69>144
402 576 Q F0 .558(The v)180 576 R .558(ariable is treated as an inte)-.25 F .558
403 (ger; arithmetic e)-.15 F -.25(va)-.25 G .558(luation \(see).25 F F4 .557
404 (ARITHMETIC EV)3.058 F(ALU)-1.215 E(A-)-.54 E(TION \))180 588 Q F0
405 (is performed when the v)2.25 E(ariable is assigned a v)-.25 E(alue.)-.25 E
406 1.218(Using `+' instead of `\255' turns of)144 604.8 R 3.719(ft)-.25 G 1.219
407 (he attrib)289.369 604.8 R 1.219(ute instead.)-.2 F 1.219
408 (When used in a function, mak)6.219 F(es)-.1 E F2(name)3.719 E F0(s)A .236
409 (local, as with the)144 616.8 R F1(local)2.736 E F0 2.735(command. The)2.736 F
410 .235(return v)2.735 F .235(alue is 0 unless an ille)-.25 F -.05(ga)-.15 G 2.735
411 (lo).05 G .235(ption is encountered, an)443.755 616.8 R .435
412 (attempt is made to de\214ne a function using "-f foo=bar", one of the)144
413 628.8 R F2(names)2.935 E F0 .435(is not a le)2.935 F -.05(ga)-.15 G 2.935(ls)
414 .05 G .435(hell v)503.435 628.8 R(ari-)-.25 E .52
415 (able name, an attempt is made to turn of)144 640.8 R 3.019(fr)-.25 G .519
416 (eadonly status for a readonly v)318.399 640.8 R .519
417 (ariable, or an attempt is)-.25 F(made to display a non-e)144 652.8 Q
418 (xistant function with -f.)-.15 E F1(dirs [-l] [+/\255n])108 669.6 Q F0 1.505
419 (Display the list of currently remembered directories.)144 681.6 R 1.505
420 (Directories are added to the list with the)6.505 F F1(pushd)144 693.6 Q F0
421 (command; the)2.5 E F1(popd)2.5 E F0(command mo)2.5 E -.15(ve)-.15 G 2.5(sb).15
422 G(ack up through the list.)331.5 693.6 Q F1(+n)144 705.6 Q F0 .13(displays the)
423 180 705.6 R F2(n)2.63 E F0 .13(th entry counting from the left of the list sho)
424 B .13(wn by)-.25 F F1(dirs)2.63 E F0 .13(when in)2.63 F -.2(vo)-.4 G -.1(ke).2
425 G 2.63(dw).1 G(ith-)526.11 705.6 Q(out options, starting with zero.)180 717.6 Q
426 170.955(GNU 1993)72 768 R(September 16)2.5 E(2)535 768 Q EP
427 %%Page: 3 3
428 %%BeginPageSetup
429 BP
430 %%EndPageSetup
431 /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
432 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0
433 SF<ad6e>144 84 Q F0 1.342(displays the)180 84 R/F2 10/Times-Italic@0 SF(n)3.842
434 E F0 1.342(th entry counting from the right of the list sho)B 1.342(wn by)-.25
435 F F1(dirs)3.842 E F0 1.342(when in)3.842 F -.2(vo)-.4 G -.1(ke).2 G(d).1 E
436 (without options, starting with zero.)180 96 Q F1<ad6c>144 108 Q F0 .362
437 (produces a longer listing; the def)180 108 R .361
438 (ault listing format uses a tilde to denote the home direc-)-.1 F(tory)180 120
439 Q(.)-.65 E .38(The return v)144 136.8 R .38(alue is 0 unless an ille)-.25 F
440 -.05(ga)-.15 G 2.88(lo).05 G .381(ption is supplied or)303.79 136.8 R F2(n)
441 2.881 E F0(inde)2.881 E -.15(xe)-.15 G 2.881(sb).15 G -.15(ey)430.775 136.8 S
442 .381(ond the end of the direc-).15 F(tory stack.)144 148.8 Q F1(echo)108 165.6
443 Q F0([)2.5 E F1(\255neE)A F0 2.5(][)C F2(ar)164.8 165.6 Q(g)-.37 E F0(...])2.5
444 E .267(Output the)144 177.6 R F2(ar)2.767 E(g)-.37 E F0 .267
445 (s, separated by spaces.)B .267(The return status is al)5.267 F -.1(wa)-.1 G
446 .266(ys 0.).1 F(If)5.266 E F1<ad6e>2.766 E F0 .266
447 (is speci\214ed, the trailing)2.766 F(ne)144 189.6 Q .31(wline is suppressed.)
448 -.25 F .311(If the)5.31 F F1<ad65>2.811 E F0 .311(option is gi)2.811 F -.15(ve)
449 -.25 G .311(n, interpretation of the follo).15 F .311(wing backslash-escaped)
450 -.25 F .874(characters is enabled.)144 201.6 R(The)5.874 E F1<ad45>3.374 E F0
451 .874(option disables the interpretation of these escape characters, e)3.374 F
452 -.15(ve)-.25 G(n).15 E(on systems where the)144 213.6 Q 2.5(ya)-.15 G
453 (re interpreted by def)241.61 213.6 Q(ault.)-.1 E F1(\\a)144 225.6 Q F0
454 (alert \(bell\))180 225.6 Q F1(\\b)144 237.6 Q F0(backspace)180 237.6 Q F1(\\c)
455 144 249.6 Q F0(suppress trailing ne)180 249.6 Q(wline)-.25 E F1(\\f)144 261.6 Q
456 F0(form feed)180 261.6 Q F1(\\n)144 273.6 Q F0(ne)180 273.6 Q 2.5(wl)-.25 G
457 (ine)201.69 273.6 Q F1(\\r)144 285.6 Q F0(carriage return)180 285.6 Q F1(\\t)
458 144 297.6 Q F0(horizontal tab)180 297.6 Q F1(\\v)144 309.6 Q F0 -.15(ve)180
459 309.6 S(rtical tab).15 E F1(\\\\)144 321.6 Q F0(backslash)180 321.6 Q F1(\\nnn)
460 144 333.6 Q F0(the character whose ASCII code is)180 333.6 Q F2(nnn)2.5 E F0
461 (\(octal\))2.5 E F1(enable)108 350.4 Q F0([)2.5 E F1<ad6e>A F0 2.5(][)C F1
462 (\255all)162.03 350.4 Q F0 2.5(][)C F2(name)187.45 350.4 Q F0(...])2.5 E .682
463 (Enable and disable b)144 362.4 R .683(uiltin shell commands.)-.2 F .683
464 (This allo)5.683 F .683(ws the e)-.25 F -.15(xe)-.15 G .683
465 (cution of a disk command which).15 F .324(has the same name as a shell b)144
466 374.4 R .324(uiltin without specifying a full pathname.)-.2 F(If)5.324 E F1
467 <ad6e>2.824 E F0 .324(is used, each)2.824 F F2(name)2.823 E F0 .18
468 (is disabled; otherwise,)144 386.4 R F2(names)2.68 E F0 .18(are enabled.)2.68 F
469 -.15(Fo)5.18 G 2.68(re).15 G .181(xample, to use the)338.81 386.4 R F1(test)
470 2.681 E F0 .181(binary found via the)2.681 F/F3 9/Times-Bold@0 SF -.666(PA)
471 2.681 G(TH)-.189 E F0 .749(instead of the shell b)144 398.4 R .749(uiltin v)-.2
472 F .749(ersion, type `)-.15 F .748(`enable -n test')-.74 F 3.248('. If)-.74 F
473 .748(no ar)3.248 F .748(guments are gi)-.18 F -.15(ve)-.25 G .748
474 (n, a list of all).15 F .424(enabled shell b)144 410.4 R .424
475 (uiltins is printed.)-.2 F .424(If only)5.424 F F1<ad6e>2.924 E F0 .425
476 (is supplied, a list of all disabled b)2.924 F .425(uiltins is printed.)-.2 F
477 (If)5.425 E(only)144 422.4 Q F1(\255all)2.547 E F0 .047
478 (is supplied, the list printed includes all b)2.547 F .046
479 (uiltins, with an indication of whether or not each)-.2 F .28(is enabled.)144
480 434.4 R F1(enable)5.28 E F0(accepts)2.78 E F1<ad61>2.78 E F0 .28(as a synon)
481 2.78 F .28(ym for)-.15 F F1(\255all)2.78 E F0 5.28(.T)C .281(he return v)370.8
482 434.4 R .281(alue is 0 unless a)-.25 F F2(name)2.781 E F0 .281(is not a)2.781 F
483 (shell b)144 446.4 Q(uiltin.)-.2 E F1 -2.3 -.15(ev a)108 463.2 T(l).15 E F0([)
484 2.5 E F2(ar)A(g)-.37 E F0(...])2.5 E(The)144 475.2 Q F2(ar)3.171 E(g)-.37 E F0
485 3.171(sa)C .671(re read and concatenated together into a single command.)
486 187.742 475.2 R .67(This command is then read)5.67 F .164(and e)144 487.2 R
487 -.15(xe)-.15 G .164(cuted by the shell, and its e).15 F .165
488 (xit status is returned as the v)-.15 F .165(alue of the)-.25 F F1 -2.3 -.15
489 (ev a)2.665 H(l).15 E F0 2.665(command. If)2.665 F(there)2.665 E(are no)144
490 499.2 Q F2(ar)2.5 E(gs)-.37 E F0 2.5(,o).27 G 2.5(ro)198.89 499.2 S
491 (nly null ar)209.72 499.2 Q(guments,)-.18 E F1 -2.3 -.15(ev a)2.5 H(l).15 E F0
492 (returns true.)2.5 E F1(exec)108 516 Q F0([[)2.5 E F1<ad>A F0(])A F2(command)
493 2.5 E F0([)2.5 E F2(ar)A(guments)-.37 E F0(]])A(If)144 528 Q F2(command)2.91 E
494 F0 .41(is speci\214ed, it replaces the shell.)2.91 F .41(No ne)5.41 F 2.91(wp)
495 -.25 G .41(rocess is created.)371.42 528 R(The)5.41 E F2(ar)2.91 E(guments)-.37
496 E F0(become)2.91 E 1.238(the ar)144 540 R 1.238(guments to)-.18 F F2(command)
497 3.738 E F0 6.238(.I)C 3.738(ft)267.642 540 S 1.238(he \214rst ar)277.49 540 R
498 1.238(gument is)-.18 F F1<ad>3.738 E F0 3.738(,t)C 1.239
499 (he shell places a dash in the zeroth ar)376.42 540 R(g)-.18 E 1.049(passed to)
500 144 552 R F2(command)3.549 E F0 6.049(.T).77 G 1.048(his is what login does.)
501 239.847 552 R 1.048(If the \214le cannot be e)6.048 F -.15(xe)-.15 G 1.048
502 (cuted for some reason, a).15 F(non-interacti)144 564 Q .91 -.15(ve s)-.25 H
503 .611(hell e).15 F .611(xits, unless the shell v)-.15 F(ariable)-.25 E F1
504 (no_exit_on_failed_exec)3.111 E F0 -.15(ex)3.111 G .611(ists, in which case).15
505 F .333(it returns f)144 576 R 2.833(ailure. An)-.1 F(interacti)2.833 E .633
506 -.15(ve s)-.25 H .333(hell returns f).15 F .332
507 (ailure if the \214le cannot be e)-.1 F -.15(xe)-.15 G 2.832(cuted. If).15 F F2
508 (command)2.832 E F0(is)2.832 E(not speci\214ed, an)144 588 Q 2.5(yr)-.15 G
509 (edirections tak)219.95 588 Q 2.5(ee)-.1 G -.25(ff)289.83 588 S
510 (ect in the current shell, and the return status is 0.).25 E F1(exit)108 604.8
511 Q F0([)2.5 E F2(n)A F0 6.29(]C)C .122(ause the shell to e)150.67 604.8 R .122
512 (xit with a status of)-.15 F F2(n)2.623 E F0 5.123(.I)C(f)315.064 604.8 Q F2(n)
513 2.623 E F0 .123(is omitted, the e)2.623 F .123
514 (xit status is that of the last command)-.15 F -.15(exe)144 616.8 S 2.5
515 (cuted. A).15 F(trap on)2.5 E F3(EXIT)2.5 E F0(is e)2.25 E -.15(xe)-.15 G
516 (cuted before the shell terminates.).15 E F1(export)108 633.6 Q F0([)2.5 E F1
517 (\255nf)A F0 2.5(][).833 G F2(name)166.183 633.6 Q F0([=)A F2(wor)A(d)-.37 E F0
518 (]] ...)A F1(export \255p)108 645.6 Q F0 .306(The supplied)144 657.6 R F2
519 (names)2.806 E F0 .306(are mark)2.806 F .305(ed for automatic e)-.1 F .305
520 (xport to the en)-.15 F .305(vironment of subsequently e)-.4 F -.15(xe)-.15 G
521 (cuted).15 E 2.693(commands. If)144 669.6 R(the)2.693 E F1<ad66>2.693 E F0 .193
522 (option is gi)2.693 F -.15(ve)-.25 G .193(n, the).15 F F2(names)2.693 E F0 .193
523 (refer to functions.)2.693 F .193(If no)5.193 F F2(names)2.693 E F0 .193
524 (are gi)2.693 F -.15(ve)-.25 G .194(n, or if the).15 F F1<ad70>144 681.6 Q F0
525 .66(option is supplied, a list of all names that are e)3.16 F .659
526 (xported in this shell is printed.)-.15 F(The)5.659 E F1<ad6e>3.159 E F0
527 (option)3.159 E .537(causes the e)144 693.6 R .537(xport property to be remo)
528 -.15 F -.15(ve)-.15 G 3.037(df).15 G .537(rom the named v)318.099 693.6 R 3.038
529 (ariables. An)-.25 F(ar)3.038 E .538(gument of)-.18 F F1<adad>3.038 E F0
530 (disables)3.038 E .666(option checking for the rest of the ar)144 705.6 R
531 (guments.)-.18 E F1(export)5.665 E F0 .665(returns an e)3.165 F .665
532 (xit status of 0 unless an ille)-.15 F -.05(ga)-.15 G(l).05 E .32
533 (option is encountered, one of the)144 717.6 R F2(names)2.82 E F0 .32
534 (is not a le)2.82 F -.05(ga)-.15 G 2.82(ls).05 G .32(hell v)366.18 717.6 R .32
535 (ariable name, or)-.25 F F1<ad66>2.82 E F0 .32(is supplied with a)2.82 F F2
536 (name)144 729.6 Q F0(that is not a function.)2.5 E 170.955(GNU 1993)72 768 R
537 (September 16)2.5 E(3)535 768 Q EP
538 %%Page: 4 4
539 %%BeginPageSetup
540 BP
541 %%EndPageSetup
542 /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
543 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0
544 SF(fc)108 84 Q F0([)2.5 E F1<ad65>A/F2 10/Times-Italic@0 SF(ename)2.5 E F0 2.5
545 (][)C F1(\255nlr)169.5 84 Q F0 2.5(][)C F2<8c72>197.14 84 Q(st)-.1 E F0 2.5(][)
546 C F2(last)221.76 84 Q F0(])A F1(fc \255s)108 96 Q F0([)2.5 E F2(pat)A F0(=)A F2
547 -.37(re)C(p).37 E F0 2.5(][)C F2(cmd)174.23 96 Q F0(])A .665(Fix Command.)144
548 108 R .665(In the \214rst form, a range of commands from)5.665 F F2<8c72>3.164
549 E(st)-.1 E F0(to)3.164 E F2(last)3.164 E F0 .664(is selected from the his-)
550 3.164 F .967(tory list.)144 120 R F2 -.45(Fi)5.967 G -.1(rs).45 G(t).1 E F0
551 (and)3.467 E F2(last)3.467 E F0 .967
552 (may be speci\214ed as a string \(to locate the last command be)3.467 F .968
553 (ginning with)-.15 F .797(that string\) or as a number \(an inde)144 132 R
554 3.297(xi)-.15 G .797(nto the history list, where a ne)300.756 132 R -.05(ga)
555 -.15 G(ti).05 E 1.097 -.15(ve n)-.25 H .796(umber is used as an).15 F(of)144
556 144 Q .321(fset from the current command number\).)-.25 F(If)5.322 E F2(last)
557 2.822 E F0 .322(is not speci\214ed it is set to the current command)2.822 F
558 .019(for listing \(so that)144 156 R F1 .019(fc \255l \25510)2.519 F F0 .019
559 (prints the last 10 commands\) and to)2.519 F F2<8c72>2.519 E(st)-.1 E F0 2.519
560 (otherwise. If)2.519 F F2<8c72>2.519 E(st)-.1 E F0 .019(is not spec-)2.519 F
561 (i\214ed it is set to the pre)144 168 Q
562 (vious command for editing and \25516 for listing.)-.25 E(The)144 192 Q F1
563 <ad6e>2.92 E F0 .42(\215ag suppresses the command numbers when listing.)2.92 F
564 (The)5.421 E F1<ad72>2.921 E F0 .421(\215ag re)2.921 F -.15(ve)-.25 G .421
565 (rses the order of the).15 F 3.642(commands. If)144 204 R(the)3.642 E F1<ad6c>
566 3.642 E F0 1.142(\215ag is gi)3.642 F -.15(ve)-.25 G 1.142
567 (n, the commands are listed on standard output.).15 F 1.142(Otherwise, the)
568 6.142 F .378(editor gi)144 216 R -.15(ve)-.25 G 2.878(nb).15 G(y)199.906 216 Q
569 F2(ename)2.878 E F0 .378(is in)2.878 F -.2(vo)-.4 G -.1(ke).2 G 2.878(do).1 G
570 2.878(na\214)285.708 216 S .378(le containing those commands.)306.464 216 R(If)
571 5.378 E F2(ename)2.878 E F0 .379(is not gi)2.879 F -.15(ve)-.25 G .379(n, the)
572 .15 F -.25(va)144 228 S .805(lue of the).25 F/F3 9/Times-Bold@0 SF(FCEDIT)3.305
573 E F0 -.25(va)3.055 G .805(riable is used, and the v).25 F .805(alue of)-.25 F
574 F3(EDIT)3.305 E(OR)-.162 E F0(if)3.054 E F3(FCEDIT)3.304 E F0 .804(is not set.)
575 3.054 F .804(If neither)5.804 F -.25(va)144 240 S(riable is set, is used.).25 E
576 (When editing is complete, the edited commands are echoed and e)5 E -.15(xe)
577 -.15 G(cuted.).15 E .039(In the second form,)144 264 R F2(command)2.539 E F0
578 .039(is re-e)2.539 F -.15(xe)-.15 G .039(cuted after each instance of).15 F F2
579 (pat)2.54 E F0 .04(is replaced by)2.54 F F2 -.37(re)2.54 G(p).37 E F0 5.04(.A)C
580 (useful)515.56 264 Q 1.009(alias to use with this is `)144 276 R 1.008
581 (`r=fc \255s')-.74 F 1.008(', so that typing `)-.74 F 1.008(`r cc')-.74 F 3.508
582 ('r)-.74 G 1.008(uns the last command be)385.39 276 R 1.008(ginning with)-.15 F
583 -.74(``)144 288 S(cc').74 E 2.5('a)-.74 G(nd typing `)171.66 288 Q(`r')-.74 E
584 2.5('r)-.74 G(e-e)233.22 288 Q -.15(xe)-.15 G(cutes the last command.).15 E
585 .426(If the \214rst form is used, the return v)144 312 R .427
586 (alue is 0 unless an ille)-.25 F -.05(ga)-.15 G 2.927(lo).05 G .427
587 (ption is encountered or)399.768 312 R F2<8c72>2.927 E(st)-.1 E F0(or)2.927 E
588 F2(last)2.927 E F0 .455(specify history lines out of range.)144 324 R .454
589 (If the)5.454 F F1<ad65>2.954 E F0 .454(option is supplied, the return v)2.954
590 F .454(alue is the v)-.25 F .454(alue of the)-.25 F .787(last command e)144 336
591 R -.15(xe)-.15 G .787(cuted or f).15 F .788
592 (ailure if an error occurs with the temporary \214le of commands.)-.1 F .788
593 (If the)5.788 F 1.196
594 (second form is used, the return status is that of the command re-e)144 348 R
595 -.15(xe)-.15 G 1.196(cuted, unless).15 F F2(cmd)3.696 E F0 1.196(does not)3.696
596 F(specify a v)144 360 Q(alid history line, in which case)-.25 E F1(fc)2.5 E F0
597 (returns f)2.5 E(ailure.)-.1 E F1(fg)108 376.8 Q F0([)2.5 E F2(jobspec)A F0(])A
598 (Place)144 388.8 Q F2(jobspec)3.041 E F0 .541(in the fore)3.041 F .542
599 (ground, and mak)-.15 F 3.042(ei)-.1 G 3.042(tt)323.06 388.8 S .542
600 (he current job)331.662 388.8 R 5.542(.I)-.4 G(f)399.258 388.8 Q F2(jobspec)
601 3.042 E F0 .542(is not present, the shell')3.042 F(s)-.55 E .958(notion of the)
602 144 400.8 R F2(curr)3.458 E .958(ent job)-.37 F F0 .957(is used.)3.457 F .957
603 (The return v)5.957 F .957(alue is that of the command placed into the fore-)
604 -.25 F .194(ground, or f)144 412.8 R .194
605 (ailure if run when job control is disabled or)-.1 F 2.695(,w)-.4 G .195
606 (hen run with job control enabled, if)378.655 412.8 R F2(job-)2.695 E(spec)144
607 424.8 Q F0(does not specify a v)2.5 E(alid job or)-.25 E F2(jobspec)2.5 E F0
608 (speci\214es a job that w)2.5 E(as started without job control.)-.1 E F1
609 (getopts)108 441.6 Q F2(optstring name)2.5 E F0([)2.5 E F2(ar)A(gs)-.37 E F0(])
610 A F1(getopts)144 453.6 Q F0 .828
611 (is used by shell procedures to parse positional parameters.)3.328 F F2
612 (optstring)5.827 E F0 .827(contains the option)3.327 F .602
613 (letters to be recognized; if a letter is follo)144 465.6 R .603
614 (wed by a colon, the option is e)-.25 F .603(xpected to ha)-.15 F .903 -.15
615 (ve a)-.2 H 3.103(na).15 G -.18(rg)523.52 465.6 S(u-).18 E .7
616 (ment, which should be separated from it by white space.)144 477.6 R .7
617 (Each time it is in)5.7 F -.2(vo)-.4 G -.1(ke).2 G(d,).1 E F1(getopts)3.2 E F0
618 (places)3.2 E .008(the ne)144 489.6 R .008(xt option in the shell v)-.15 F
619 (ariable)-.25 E F2(name)2.508 E F0 2.508(,i).18 G(nitializing)316.884 489.6 Q
620 F2(name)2.508 E F0 .009(if it does not e)2.508 F .009(xist, and the inde)-.15 F
621 2.509(xo)-.15 G 2.509(ft)521.941 489.6 S(he)530.56 489.6 Q(ne)144 501.6 Q .199
622 (xt ar)-.15 F .199(gument to be processed into the v)-.18 F(ariable)-.25 E F3
623 (OPTIND)2.699 E/F4 9/Times-Roman@0 SF(.)A F3(OPTIND)4.699 E F0 .198
624 (is initialized to 1 each time the)2.449 F .497(shell or a shell script is in)
625 144 513.6 R -.2(vo)-.4 G -.1(ke).2 G 2.997(d. When).1 F .498
626 (an option requires an ar)2.997 F(gument,)-.18 E F1(getopts)2.998 E F0 .498
627 (places that ar)2.998 F(gu-)-.18 E .028(ment into the v)144 525.6 R(ariable)
628 -.25 E F3(OPT)2.528 E(ARG)-.81 E F4(.)A F0 .028(The shell does not reset)4.528
629 F F3(OPTIND)2.528 E F0 .027(automatically; it must be manu-)2.278 F .161
630 (ally reset between multiple calls to)144 537.6 R F1(getopts)2.661 E F0 .161
631 (within the same shell in)2.661 F -.2(vo)-.4 G .161(cation if a ne).2 F 2.662
632 (ws)-.25 G .162(et of param-)490.806 537.6 R(eters is to be used.)144 549.6 Q
633 F1(getopts)144 573.6 Q F0 1.252(can report errors in tw)3.752 F 3.752(ow)-.1 G
634 3.752(ays. If)287.942 573.6 R 1.252(the \214rst character of)3.752 F F2
635 (optstring)3.752 E F0 1.251(is a colon,)3.752 F F2(silent)3.751 E F0(error)
636 3.751 E 1.442(reporting is used.)144 585.6 R 1.442
637 (In normal operation diagnostic messages are printed when ille)6.442 F -.05(ga)
638 -.15 G 3.943(lo).05 G 1.443(ptions or)503.277 585.6 R .654(missing option ar)
639 144 597.6 R .653(guments are encountered.)-.18 F .653(If the v)5.653 F(ariable)
640 -.25 E F3(OPTERR)3.153 E F0 .653(is set to 0, no error message)2.903 F
641 (will be displayed, e)144 609.6 Q -.15(ve)-.25 G 2.5(ni).15 G 2.5(ft)241.09
642 609.6 S(he \214rst character of)249.7 609.6 Q F2(optstring)2.5 E F0
643 (is not a colon.)2.5 E .826(If an ille)144 633.6 R -.05(ga)-.15 G 3.326(lo).05
644 G .826(ption is seen,)199.878 633.6 R F1(getopts)3.326 E F0 .826(places ? into)
645 3.326 F F2(name)3.326 E F0 .826(and, if not silent, prints an error message)
646 3.326 F .4(and unsets)144 645.6 R F3(OPT)2.9 E(ARG)-.81 E F4(.)A F0(If)4.899 E
647 F1(getopts)2.899 E F0 .399(is silent, the option character found is placed in)
648 2.899 F F3(OPT)2.899 E(ARG)-.81 E F0 .399(and no)2.649 F
649 (diagnostic message is printed.)144 657.6 Q 1.241(If a required ar)144 681.6 R
650 1.241(gument is not found, and)-.18 F F1(getopts)3.741 E F0 1.241
651 (is not silent, a question mark \()3.741 F F1(?).833 E F0 3.742(\)i).833 G
652 3.742(sp)494.746 681.6 S 1.242(laced in)507.378 681.6 R F2(name)144 693.6 Q F0
653 (,).18 E F1(OPT)3.357 E(ARG)-.9 E F0 .856
654 (is unset, and a diagnostic message is printed.)3.357 F(If)5.856 E F1(getopts)
655 3.356 E F0 .856(is silent, then a colon)3.356 F(\()144 705.6 Q F1(:).833 E F0
656 2.5(\)i).833 G 2.5(sp)160.936 705.6 S(laced in)172.326 705.6 Q F2(name)2.5 E F0
657 (and)2.5 E F3(OPT)2.5 E(ARG)-.81 E F0(is set to the option character found.)
658 2.25 E F1(getopts)144 729.6 Q F0 2.392
659 (normally parses the positional parameters, b)4.892 F 2.392(ut if more ar)-.2 F
660 2.393(guments are gi)-.18 F -.15(ve)-.25 G 4.893(ni).15 G(n)509.927 729.6 Q F2
661 (ar)4.893 E(gs)-.37 E F0(,).27 E 170.955(GNU 1993)72 768 R(September 16)2.5 E
662 (4)535 768 Q EP
663 %%Page: 5 5
664 %%BeginPageSetup
665 BP
666 %%EndPageSetup
667 /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
668 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0
669 SF(getopts)144 84 Q F0 .651(parses those instead.)3.151 F F1(getopts)5.651 E F0
670 .651(returns true if an option, speci\214ed or unspeci\214ed, is found.)3.151 F
671 (It returns f)144 96 Q
672 (alse if the end of options is encountered or an error occurs.)-.1 E F1(hash)
673 108 112.8 Q F0([)2.5 E F1<ad72>A F0 2.5(][)C/F2 10/Times-Italic@0 SF(name)
674 153.14 112.8 Q F0(])A -.15(Fo)144 124.8 S 2.819(re).15 G(ach)164.999 124.8 Q F2
675 (name)2.819 E F0 2.819(,t).18 G .319
676 (he full pathname of the command is determined and remembered.)211.637 124.8 R
677 (The)5.32 E F1<ad72>2.82 E F0(option)2.82 E .508(causes the shell to for)144
678 136.8 R .508(get all remembered locations.)-.18 F .508(If no ar)5.508 F .508
679 (guments are gi)-.18 F -.15(ve)-.25 G .507(n, information about).15 F .193
680 (remembered commands is printed.)144 148.8 R .193(An ar)5.193 F .193(gument of)
681 -.18 F F1<adad>2.693 E F0 .194(disables option checking for the rest of the)
682 2.693 F(ar)144 160.8 Q 2.5(guments. The)-.18 F(return status is true unless a)
683 2.5 E F2(name)2.5 E F0(is not found or an ille)2.5 E -.05(ga)-.15 G 2.5(lo).05
684 G(ption is supplied.)453.86 160.8 Q F1(help)108 177.6 Q F0([)2.5 E F2(pattern)A
685 F0(])A .991(Display helpful information about b)144 189.6 R .991
686 (uiltin commands.)-.2 F(If)5.991 E F2(pattern)3.491 E F0 .991(is speci\214ed,)
687 3.491 F F1(help)3.491 E F0(gi)3.49 E -.15(ve)-.25 G 3.49(sd).15 G(etailed)
688 513.34 189.6 Q .408(help on all commands matching)144 201.6 R F2(pattern)2.909
689 E F0 2.909(;o).24 G .409(therwise a list of the b)316.13 201.6 R .409
690 (uiltins is printed.)-.2 F .409(The return sta-)5.409 F
691 (tus is 0 unless no command matches)144 213.6 Q F2(pattern)2.5 E F0(.).24 E F1
692 (history)108 230.4 Q F0([)2.5 E F2(n)A F0(])A F1(history \255rwan)108 242.4 Q
693 F0([)2.5 E F2(\214lename)A F0(])A -.4(Wi)144 254.4 S .752
694 (th no options, display the command history list with line numbers.).4 F .752
695 (Lines listed with a)5.752 F F1(*)3.251 E F0(ha)3.251 E -.15(ve)-.2 G .375
696 (been modi\214ed.)144 266.4 R .375(An ar)5.375 F .375(gument of)-.18 F F2(n)
697 2.875 E F0 .375(lists only the last)2.875 F F2(n)2.875 E F0 2.875(lines. If)
698 2.875 F 2.876(an)2.876 G .376(on-option ar)411.832 266.4 R .376
699 (gument is supplied,)-.18 F .811
700 (it is used as the name of the history \214le; if not, the v)144 278.4 R .811
701 (alue of)-.25 F/F3 9/Times-Bold@0 SF(HISTFILE)3.311 E F0 .811(is used.)3.061 F
702 .811(Options, if sup-)5.811 F(plied, ha)144 290.4 Q .3 -.15(ve t)-.2 H
703 (he follo).15 E(wing meanings:)-.25 E F1<ad61>144 302.4 Q F0 .598(Append the `)
704 180 302.4 R(`ne)-.74 E(w')-.25 E 3.098('h)-.74 G .598
705 (istory lines \(history lines entered since the be)266.424 302.4 R .599
706 (ginning of the current)-.15 F F1(bash)180 314.4 Q F0
707 (session\) to the history \214le)2.5 E F1<ad6e>144 326.4 Q F0 .854(Read the hi\
708 story lines not already read from the history \214le into the current history \
709 list.)180 326.4 R .772
710 (These are lines appended to the history \214le since the be)180 338.4 R .773
711 (ginning of the current)-.15 F F1(bash)3.273 E F0(ses-)3.273 E(sion.)180 350.4
712 Q F1<ad72>144 362.4 Q F0
713 (Read the contents of the history \214le and use them as the current history)
714 180 362.4 Q F1<ad77>144 374.4 Q F0
715 (Write the current history to the history \214le, o)180 374.4 Q -.15(ve)-.15 G
716 (rwriting the history \214le').15 E 2.5(sc)-.55 G(ontents.)474.4 374.4 Q .989
717 (The return v)144 391.2 R .989(alue is 0 unless an ille)-.25 F -.05(ga)-.15 G
718 3.489(lo).05 G .989(ption is encountered or an error occurs while reading or)
719 308.662 391.2 R(writing the history \214le.)144 403.2 Q F1(jobs)108 420 Q F0([)
720 2.5 E F1(\255lnp)A F0 2.5(][)C F2(jobspec)A F0(... ])2.5 E F1(jobs \255x)108
721 432 Q F2(command)2.5 E F0([)2.5 E F2(ar)2.5 E(gs)-.37 E F0(... ])2.5 E .297
722 (The \214rst form lists the acti)144 444 R .598 -.15(ve j)-.25 H 2.798
723 (obs. The).15 F F1<ad6c>2.798 E F0 .298
724 (option lists process IDs in addition to the normal infor)2.798 F(-)-.2 E .746
725 (mation; the)144 456 R F1<ad70>3.246 E F0 .745
726 (option lists only the process ID of the job')3.246 F 3.245(sp)-.55 G .745
727 (rocess group leader)394.205 456 R 5.745(.T)-.55 G(he)487.25 456 Q F1<ad6e>
728 3.245 E F0(option)3.245 E 2.08(displays only jobs that ha)144 468 R 2.38 -.15
729 (ve c)-.2 H 2.081(hanged status since last noti\214ed.).15 F(If)7.081 E F2
730 (jobspec)4.581 E F0 2.081(is gi)4.581 F -.15(ve)-.25 G 2.081(n, output is).15 F
731 .727(restricted to information about that job)144 480 R 5.727(.T)-.4 G .727
732 (he return status is 0 unless an ille)316.282 480 R -.05(ga)-.15 G 3.227(lo).05
733 G .726(ption is encoun-)474.108 480 R(tered or an ille)144 492 Q -.05(ga)-.15 G
734 (l).05 E F2(jobspec)2.5 E F0(is supplied.)2.5 E .607(If the)144 516 R F1<ad78>
735 3.107 E F0 .607(option is supplied,)3.107 F F1(jobs)3.107 E F0 .607
736 (replaces an)3.107 F(y)-.15 E F2(jobspec)3.107 E F0 .607(found in)3.107 F F2
737 (command)3.107 E F0(or)3.107 E F2(ar)3.107 E(gs)-.37 E F0 .607(with the corre-)
738 3.107 F(sponding process group ID, and e)144 528 Q -.15(xe)-.15 G(cutes).15 E
739 F2(command)2.5 E F0(passing it)2.5 E F2(ar)2.5 E(gs)-.37 E F0 2.5(,r).27 G
740 (eturning its e)418.56 528 Q(xit status.)-.15 E F1(kill)108 544.8 Q F0([)2.5 E
741 F1(-s sigspec)A F0(|)2.5 E F1(\255sigspec)2.5 E F0 2.5(][)C F2(pid)219.31 544.8
742 Q F0(|)2.5 E F2(jobspec)2.5 E F0 2.5(].)C(..)277.97 544.8 Q F1(kill \255l)108
743 556.8 Q F0([)2.5 E F2(signum)A F0(])A .943(Send the signal named by)144 568.8 R
744 F2(sigspec)3.443 E F0 .942(to the processes named by)3.443 F F2(pid)3.442 E F0
745 (or)3.442 E F2(jobspec)3.442 E F0(.).31 E F2(sigspec)5.942 E F0 .942
746 (is either a)3.442 F .908(signal name such as)144 580.8 R F3(SIGKILL)3.408 E F0
747 .908(or a signal number)3.158 F 5.908(.I)-.55 G(f)359.638 580.8 Q F2(sigspec)
748 3.408 E F0 .908(is a signal name, the name is case)3.408 F(insensiti)144 592.8
749 Q 2.43 -.15(ve a)-.25 H 2.13(nd may be gi).15 F -.15(ve)-.25 G 4.63(nw).15 G
750 2.13(ith or without the)279.67 592.8 R F3(SIG)4.63 E F0 4.629(pre\214x. If)
751 4.379 F F2(sigspec)4.629 E F0 2.129(is not present, then)4.629 F F3(SIGTERM)144
752 604.8 Q F0 .813(is assumed.)3.063 F .813(An ar)5.813 F .813(gument of)-.18 F F1
753 <ad6c>3.313 E F0 .814(lists the signal names.)3.313 F .814(If an)5.814 F 3.314
754 (ya)-.15 G -.18(rg)450.232 604.8 S .814(uments are supplied).18 F(when)144
755 616.8 Q F1<ad6c>2.827 E F0 .327(is gi)2.827 F -.15(ve)-.25 G .327(n, the names\
756  of the speci\214ed signals are listed, and the return status is 0.).15 F .326
757 (An ar)5.326 F(gu-)-.18 E .484(ment of)144 628.8 R F1<adad>2.984 E F0 .484
758 (disables option checking for the rest of the ar)2.984 F(guments.)-.18 E F1
759 (kill)5.485 E F0 .485(returns true if at least one)2.985 F(signal w)144 640.8 Q
760 (as successfully sent, or f)-.1 E(alse if an error occurs or an ille)-.1 E -.05
761 (ga)-.15 G 2.5(lo).05 G(ption is encountered.)419.09 640.8 Q F1(let)108 657.6 Q
762 F2(ar)2.5 E(g)-.37 E F0([)2.5 E F2(ar)A(g)-.37 E F0(...])2.5 E(Each)144 669.6 Q
763 F2(ar)3.677 E(g)-.37 E F0 1.177(is an arithmetic e)3.677 F 1.177
764 (xpression to be e)-.15 F -.25(va)-.25 G 1.177(luated \(see).25 F F3 1.176
765 (ARITHMETIC EV)3.677 F(ALU)-1.215 E -.855(AT)-.54 G(ION).855 E/F4 9
766 /Times-Roman@0 SF(\).)A F0 1.176(If the)5.676 F(last)144 681.6 Q F2(ar)2.5 E(g)
767 -.37 E F0 -.25(eva)2.5 G(luates to 0,).25 E F1(let)2.5 E F0
768 (returns 1; 0 is returned otherwise.)2.5 E F1(local)108 698.4 Q F0([)2.5 E F2
769 (name)A F0([=)A F2(value)A F0 2.5(].)C(..])194.45 698.4 Q -.15(Fo)144 710.4 S
770 3.276(re).15 G .776(ach ar)165.456 710.4 R .776(gument, create a local v)-.18 F
771 .776(ariable named)-.25 F F2(name)3.276 E F0 3.276(,a).18 G .776(nd assign it)
772 380.784 710.4 R F2(value)3.276 E F0 5.777(.W).18 G(hen)470.729 710.4 Q F1
773 (local)3.277 E F0 .777(is used)3.277 F .131(within a function, it causes the v)
774 144 722.4 R(ariable)-.25 E F2(name)2.631 E F0 .131(to ha)2.631 F .431 -.15
775 (ve a v)-.2 H .13(isible scope restricted to that function and).15 F 170.955
776 (GNU 1993)72 768 R(September 16)2.5 E(5)535 768 Q EP
777 %%Page: 6 6
778 %%BeginPageSetup
779 BP
780 %%EndPageSetup
781 /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
782 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E .232(its children.)
783 144 84 R -.4(Wi)5.232 G .232(th no operands,).4 F/F1 10/Times-Bold@0 SF(local)
784 2.733 E F0 .233(writes a list of local v)2.733 F .233
785 (ariables to the standard output.)-.25 F .233(It is an)5.233 F .42
786 (error to use)144 96 R F1(local)2.92 E F0 .42(when not within a function.)2.92
787 F .42(The return status is 0 unless)5.42 F F1(local)2.92 E F0 .42
788 (is used outside a)2.92 F(function, or an ille)144 108 Q -.05(ga)-.15 G(l).05 E
789 /F2 10/Times-Italic@0 SF(name)2.5 E F0(is supplied.)2.5 E F1(logout)108 124.8 Q
790 F0(Exit a login shell.)9.33 E F1(popd)108 141.6 Q F0([)2.5 E F1(+/\255n)A F0(])
791 A(Remo)144 153.6 Q -.15(ve)-.15 G 2.799(se).15 G .299
792 (ntries from the directory stack.)188.159 153.6 R -.4(Wi)5.299 G .299(th no ar)
793 .4 F .299(guments, remo)-.18 F -.15(ve)-.15 G 2.799(st).15 G .3
794 (he top directory from the)438.82 153.6 R(stack, and performs a)144 165.6 Q F1
795 (cd)2.5 E F0(to the ne)2.5 E 2.5(wt)-.25 G(op directory)291.22 165.6 Q(.)-.65 E
796 F1(+n)144 177.6 Q F0(remo)180 177.6 Q -.15(ve)-.15 G 2.849(st).15 G(he)219.209
797 177.6 Q F2(n)2.849 E F0 .349(th entry counting from the left of the list sho)B
798 .349(wn by)-.25 F F1(dirs)2.848 E F0 2.848(,s)C .348(tarting with zero.)470.704
799 177.6 R -.15(Fo)180 189.6 S 2.5(re).15 G(xample: `)200.53 189.6 Q(`popd +0')
800 -.74 E 2.5('r)-.74 G(emo)286.06 189.6 Q -.15(ve)-.15 G 2.5(st).15 G
801 (he \214rst directory)321.59 189.6 Q 2.5(,`)-.65 G(`popd +1')394.63 189.6 Q 2.5
802 ('t)-.74 G(he second.)442.3 189.6 Q F1<ad6e>144 201.6 Q F0(remo)180 201.6 Q
803 -.15(ve)-.15 G 2.501(st).15 G(he)218.861 201.6 Q F2(n)2.501 E F0 .001
804 (th entry counting from the right of the list sho)B .001(wn by)-.25 F F1(dirs)
805 2.502 E F0 2.502(,s)C .002(tarting with zero.)471.396 201.6 R -.15(Fo)180 213.6
806 S 2.5(re).15 G(xample: `)200.53 213.6 Q(`popd -0')-.74 E 2.5('r)-.74 G(emo)
807 283.75 213.6 Q -.15(ve)-.15 G 2.5(st).15 G(he last directory)319.28 213.6 Q 2.5
808 (,`)-.65 G(`popd -1')390.65 213.6 Q 2.5('t)-.74 G(he ne)436.01 213.6 Q
809 (xt to last.)-.15 E .644(If the)144 230.4 R F1(popd)3.144 E F0 .644
810 (command is successful, a)3.144 F F1(dirs)3.143 E F0 .643
811 (is performed as well, and the return status is 0.)3.143 F F1(popd)5.643 E F0
812 .57(returns f)144 242.4 R .57(alse if an ille)-.1 F -.05(ga)-.15 G 3.07(lo).05
813 G .571(ption is encountered, the directory stack is empty)251.25 242.4 R 3.071
814 (,an)-.65 G(on-e)469.319 242.4 Q .571(xistent direc-)-.15 F
815 (tory stack entry is speci\214ed, or the directory change f)144 254.4 Q(ails.)
816 -.1 E F1(pushd)108 271.2 Q F0([)2.5 E F2(dir)A F0(])A F1(pushd +/\255n)108
817 283.2 Q F0 .64(Adds a directory to the top of the directory stack, or rotates \
818 the stack, making the ne)144 295.2 R 3.139(wt)-.25 G .639(op of the)503.172
819 295.2 R 1.315(stack the current w)144 307.2 R 1.315(orking directory)-.1 F
820 6.315(.W)-.65 G 1.315(ith no ar)306.885 307.2 R 1.315(guments, e)-.18 F 1.316
821 (xchanges the top tw)-.15 F 3.816(od)-.1 G 1.316(irectories and)484.534 307.2 R
822 (returns 0, unless the directory stack is empty)144 319.2 Q(.)-.65 E F1(+n)144
823 331.2 Q F0 1.268(Rotates the stack so that the)180 331.2 R F2(n)3.768 E F0
824 1.267(th directory \(counting from the left of the list sho)B 1.267(wn by)-.25
825 F F1(dirs)180 343.2 Q F0 2.5(\)i)C 2.5(sa)205.28 343.2 S 2.5(tt)216.11 343.2 S
826 (he top.)224.17 343.2 Q F1<ad6e>144 355.2 Q F0(Rotates the stack so that the)
827 180 355.2 Q F2(n)2.5 E F0
828 (th directory \(counting from the right\) is at the top.)A F1(dir)144 367.2 Q
829 F0(adds)180 367.2 Q F2(dir)2.5 E F0
830 (to the directory stack at the top, making it the ne)2.5 E 2.5(wc)-.25 G
831 (urrent w)422.5 367.2 Q(orking directory)-.1 E(.)-.65 E .488(If the)144 384 R
832 F1(pushd)2.988 E F0 .488(command is successful, a)2.988 F F1(dirs)2.988 E F0
833 .488(is performed as well.)2.988 F .489(If the \214rst form is used,)5.488 F F1
834 (pushd)2.989 E F0 1.103(returns 0 unless the cd to)144 396 R F2(dir)3.603 E F0
835 -.1(fa)3.603 G 3.603(ils. W).1 F 1.103(ith the second form,)-.4 F F1(pushd)
836 3.603 E F0 1.103(returns 0 unless the directory)3.603 F .846(stack is empty)144
837 408 R 3.346(,an)-.65 G(on-e)220.894 408 Q .847(xistant directory stack element\
838  is speci\214ed, or the directory change to the)-.15 F(speci\214ed ne)144 420 Q
839 2.5(wc)-.25 G(urrent directory f)205.4 420 Q(ails.)-.1 E F1(pwd)108 436.8 Q F0
840 .725(Print the absolute pathname of the current w)144 436.8 R .724
841 (orking directory)-.1 F 5.724(.T)-.65 G .724(he path printed contains no sym-)
842 405.56 436.8 R .521(bolic links if the)144 448.8 R F1<ad50>3.021 E F0 .521
843 (option to the)3.021 F F1(set)3.021 E F0 -.2(bu)3.021 G .521
844 (iltin command is set.).2 F .521(See also the description of)5.521 F F1
845 (nolinks)3.022 E F0(under)144 460.8 Q F1 .074(Shell V)2.574 F(ariables)-.92 E
846 F0(abo)2.574 E -.15(ve)-.15 G 2.574(\). The).15 F .074
847 (return status is 0 unless an error occurs while reading the path-)2.574 F
848 (name of the current directory)144 472.8 Q(.)-.65 E F1 -.18(re)108 489.6 S(ad)
849 .18 E F0([)2.5 E F1<ad72>A F0 2.5(][)C F2(name)152.39 489.6 Q F0(...])2.5 E
850 .036(One line is read from the standard input, and the \214rst w)144 501.6 R
851 .037(ord is assigned to the \214rst)-.1 F F2(name)2.537 E F0 2.537(,t).18 G
852 .037(he second)500.253 501.6 R -.1(wo)144 513.6 S .109(rd to the second).1 F F2
853 (name)2.609 E F0 2.609(,a).18 G .109(nd so on, with lefto)254.045 513.6 R -.15
854 (ve)-.15 G 2.609(rw).15 G .109(ords assigned to the last)354.18 513.6 R F2
855 (name)2.609 E F0 5.109(.O).18 G .108(nly the char)489.444 513.6 R(-)-.2 E .143
856 (acters in)144 525.6 R/F3 9/Times-Bold@0 SF(IFS)2.643 E F0 .143
857 (are recognized as w)2.393 F .143(ord delimiters.)-.1 F .143(If no)5.143 F F2
858 (names)2.643 E F0 .144(are supplied, the line read is assigned)2.643 F .194
859 (to the v)144 537.6 R(ariable)-.25 E F3(REPL)2.694 E(Y)-.828 E/F4 9
860 /Times-Roman@0 SF(.)A F0 .194
861 (The return code is zero, unless end-of-\214le is encountered.)4.694 F .193
862 (If the)5.193 F F1<ad72>2.693 E F0(option)2.693 E .444(is gi)144 549.6 R -.15
863 (ve)-.25 G .444(n, a backslash-ne).15 F .444
864 (wline pair is not ignored, and the backslash is considered to be part of the)
865 -.25 F(line.)144 561.6 Q F1 -.18(re)108 578.4 S(adonly).18 E F0([)2.5 E F1
866 <ad66>A F0 2.5(][)C F2(name)169.62 578.4 Q F0(...])2.5 E F1 -.18(re)108 590.4 S
867 (adonly -p).18 E F0 .419(The gi)144 602.4 R -.15(ve)-.25 G(n).15 E F2(names)
868 2.919 E F0 .419(are mark)2.919 F .419(ed readonly and the v)-.1 F .419
869 (alues of these)-.25 F F2(names)2.919 E F0 .418(may not be changed by sub-)
870 2.919 F .541(sequent assignment.)144 614.4 R .541(If the)5.541 F F1<ad66>3.041
871 E F0 .541(option is supplied, the functions corresponding to the)3.041 F F2
872 (names)3.042 E F0 .542(are so)3.042 F(mark)144 626.4 Q 3.037(ed. If)-.1 F .537
873 (no ar)3.037 F .537(guments are gi)-.18 F -.15(ve)-.25 G .536(n, or if the).15
874 F F1<ad70>3.036 E F0 .536(option is supplied, a list of all readonly names is)
875 3.036 F 2.501(printed. An)144 638.4 R(ar)2.501 E .002(gument of)-.18 F F1<adad>
876 2.502 E F0 .002(disables option checking for the rest of the ar)2.502 F 2.502
877 (guments. The)-.18 F .002(return sta-)2.502 F .192(tus is 0 unless an ille)144
878 650.4 R -.05(ga)-.15 G 2.692(lo).05 G .192(ption is encountered, one of the)
879 247.732 650.4 R F2(names)2.691 E F0 .191(is not a le)2.691 F -.05(ga)-.15 G
880 2.691(ls).05 G .191(hell v)463.498 650.4 R .191(ariable name,)-.25 F(or)144
881 662.4 Q F1<ad66>2.5 E F0(is supplied with a)2.5 E F2(name)2.5 E F0
882 (that is not a function.)2.5 E F1 -.18(re)108 679.2 S(tur).18 E(n)-.15 E F0([)
883 2.5 E F2(n)A F0(])A .618(Causes a function to e)144 691.2 R .618
884 (xit with the return v)-.15 F .618(alue speci\214ed by)-.25 F F2(n)3.118 E F0
885 5.619(.I).24 G(f)404.557 691.2 Q F2(n)3.119 E F0 .619
886 (is omitted, the return status is)3.119 F 1.335(that of the last command e)144
887 703.2 R -.15(xe)-.15 G 1.335(cuted in the function body).15 F 6.335(.I)-.65 G
888 3.835(fu)387.48 703.2 S 1.335(sed outside a function, b)399.645 703.2 R 1.335
889 (ut during)-.2 F -.15(exe)144 715.2 S .794(cution of a script by the).15 F F1
890 (.)3.294 E F0(\()5.794 E F1(sour)A(ce)-.18 E F0 3.294(\)c)C .794
891 (ommand, it causes the shell to stop e)309.832 715.2 R -.15(xe)-.15 G .795
892 (cuting that script).15 F 1.234(and return either)144 727.2 R F2(n)3.734 E F0
893 1.234(or the e)3.734 F 1.234(xit status of the last command e)-.15 F -.15(xe)
894 -.15 G 1.234(cuted within the script as the e).15 F(xit)-.15 E 170.955
895 (GNU 1993)72 768 R(September 16)2.5 E(6)535 768 Q EP
896 %%Page: 7 7
897 %%BeginPageSetup
898 BP
899 %%EndPageSetup
900 /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
901 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E .393
902 (status of the script.)144 84 R .393
903 (If used outside a function and not during e)5.393 F -.15(xe)-.15 G .393
904 (cution of a script by).15 F/F1 10/Times-Bold@0 SF(.)2.893 E F0 2.893(,t).833 G
905 .393(he return)503.787 84 R(status is f)144 96 Q(alse.)-.1 E F1(set)108 112.8 Q
906 F0([)2.5 E F1(\255\255abefhkmnptuvxldCHP)A F0 2.5(][)C F1(-o)243.29 112.8 Q/F2
907 10/Times-Italic@0 SF(option)2.5 E F0 2.5(][)C F2(ar)288.84 112.8 Q(g)-.37 E F0
908 (...])2.5 E F1<ad61>144 124.8 Q F0 1.036(Automatically mark v)184 124.8 R 1.036
909 (ariables which are modi\214ed or created for e)-.25 F 1.035(xport to the en)
910 -.15 F(viron-)-.4 E(ment of subsequent commands.)184 136.8 Q F1<ad62>144 148.8
911 Q F0 .721
912 (Cause the status of terminated background jobs to be reported immediately)184
913 148.8 R 3.221(,r)-.65 G .721(ather than)499.569 148.8 R(before the ne)184 160.8
914 Q(xt primary prompt.)-.15 E(\(Also see)5 E F1(notify)2.5 E F0(under)2.5 E F1
915 (Shell V)2.5 E(ariables)-.92 E F0(abo)2.5 E -.15(ve)-.15 G(\).).15 E F1<ad65>
916 144 172.8 Q F0 1.772(Exit immediately if a)184 172.8 R F2(simple-command)4.272
917 E F0(\(see)4.272 E/F3 9/Times-Bold@0 SF 1.772(SHELL GRAMMAR)4.272 F F0(abo)
918 4.022 E -.15(ve)-.15 G 4.271(\)e).15 G 1.771(xits with a)494.788 172.8 R .642
919 (non\255zero status.)184 184.8 R .642(The shell does not e)5.642 F .642
920 (xit if the command that f)-.15 F .643(ails is part of an)-.1 F F2(until)3.143
921 E F0(or)3.143 E F2(while)184 196.8 Q F0 .728(loop, part of an)3.228 F F2(if)
922 3.228 E F0 .728(statement, part of a)3.228 F F1(&&)3.228 E F0(or)3.228 E/F4 10
923 /Symbol SF 1.666<efef>3.228 G F0 .728(list, or if the command')1.562 F 3.228
924 (sr)-.55 G(eturn)519.45 196.8 Q -.25(va)184 208.8 S(lue is being in).25 E -.15
925 (ve)-.4 G(rted via).15 E F1(!)2.5 E F0(.)A F1<ad66>144 220.8 Q F0
926 (Disable pathname e)184 220.8 Q(xpansion.)-.15 E F1<ad68>144 232.8 Q F0 .106
927 (Locate and remember function commands as functions are de\214ned.)184 232.8 R
928 .106(Function commands)5.106 F(are normally look)184 244.8 Q
929 (ed up when the function is e)-.1 E -.15(xe)-.15 G(cuted.).15 E F1<ad6b>144
930 256.8 Q F0 .162(All k)184 256.8 R -.15(ey)-.1 G -.1(wo).15 G .162(rd ar).1 F
931 .162(guments are placed in the en)-.18 F .161
932 (vironment for a command, not just those that)-.4 F(precede the command name.)
933 184 268.8 Q F1<ad6d>144 280.8 Q F0 .009(Monitor mode.)184 280.8 R .009
934 (Job control is enabled.)5.009 F .009(This \215ag is on by def)5.009 F .01
935 (ault for interacti)-.1 F .31 -.15(ve s)-.25 H .01(hells on).15 F .124
936 (systems that support it \(see)184 292.8 R F3 .124(JOB CONTR)2.624 F(OL)-.27 E
937 F0(abo)2.374 E -.15(ve)-.15 G 2.624(\). Background).15 F .124
938 (processes run in a sep-)2.624 F .72
939 (arate process group and a line containing their e)184 304.8 R .721
940 (xit status is printed upon their comple-)-.15 F(tion.)184 316.8 Q F1<ad6e>144
941 328.8 Q F0 .653(Read commands b)184 328.8 R .653(ut do not e)-.2 F -.15(xe)-.15
942 G .653(cute them.).15 F .652(This may be used to check a shell script for)5.653
943 F(syntax errors.)184 340.8 Q(This is ignored for interacti)5 E .3 -.15(ve s)
944 -.25 H(hells.).15 E F1<ad6f>144 352.8 Q F2(option-name)2.5 E F0(The)184 364.8 Q
945 F2(option-name)2.5 E F0(can be one of the follo)2.5 E(wing:)-.25 E F1
946 (allexport)184 376.8 Q F0(Same as)224 388.8 Q F1<ad61>2.5 E F0(.)A F1
947 (braceexpand)184 400.8 Q F0 .312(The shell performs brace e)224 412.8 R .313
948 (xpansion \(see)-.15 F F1 .313(Brace Expansion)2.813 F F0(abo)2.813 E -.15(ve)
949 -.15 G 2.813(\). This).15 F .313(is on)2.813 F(by def)224 424.8 Q(ault.)-.1 E
950 F1(emacs)184 436.8 Q F0 .089(Use an emacs-style command line editing interf)224
951 436.8 R 2.589(ace. This)-.1 F .089(is enabled by def)2.589 F(ault)-.1 E .128
952 (when the shell is interacti)224 448.8 R -.15(ve)-.25 G 2.628(,u).15 G .128
953 (nless the shell is started with the)345.89 448.8 R F1(\255nolineediting)2.629
954 E F0(option.)224 460.8 Q F1(err)184 472.8 Q(exit)-.18 E F0(Same as)224 472.8 Q
955 F1<ad65>2.5 E F0(.)A F1(histexpand)184 484.8 Q F0(Same as)224 496.8 Q F1<ad48>
956 2.5 E F0(.)A F1(ignor)184 508.8 Q(eeof)-.18 E F0 1.024(The ef)224 520.8 R 1.024
957 (fect is as if the shell command `IGNOREEOF=10' had been e)-.25 F -.15(xe)-.15
958 G(cuted).15 E(\(see)224 532.8 Q F1(Shell V)2.5 E(ariables)-.92 E F0(abo)2.5 E
959 -.15(ve)-.15 G(\).).15 E F1(interacti)184 544.8 Q -.1(ve)-.1 G(\255comments).1
960 E F0(Allo)224 556.8 Q 2.52(waw)-.25 G .02(ord be)265.35 556.8 R .021
961 (ginning with)-.15 F F1(#)2.521 E F0 .021(to cause that w)2.521 F .021
962 (ord and all remaining characters)-.1 F
963 (on that line to be ignored in an interacti)224 568.8 Q .3 -.15(ve s)-.25 H
964 (hell \(see).15 E F3(COMMENTS)2.5 E F0(abo)2.25 E -.15(ve)-.15 G(\).).15 E F1
965 (monitor)184 580.8 Q F0(Same as)5.56 E F1<ad6d>2.5 E F0(.)A F1(noclob)184 592.8
966 Q(ber)-.1 E F0(Same as)224 604.8 Q F1<ad43>2.5 E F0(.)A F1(noexec)184 616.8 Q
967 F0(Same as)224 616.8 Q F1<ad6e>2.5 E F0(.)A F1(noglob)184 628.8 Q F0(Same as)
968 224 628.8 Q F1<ad66>2.5 E F0(.)A F1(nohash)184 640.8 Q F0(Same as)9.43 E F1
969 <ad64>2.5 E F0(.)A F1(notify)184 652.8 Q F0(Same as)224 652.8 Q F1<ad62>2.5 E
970 F0(.)A F1(nounset)184 664.8 Q F0(Same as)6.66 E F1<ad75>2.5 E F0(.)A F1(ph)184
971 676.8 Q(ysical)-.15 E F0(Same as)5.14 E F1<ad50>2.5 E F0(.)A F1(posix)184 688.8
972 Q F0 2.244(Change the beha)224 688.8 R 2.244(vior of bash where the def)-.2 F
973 2.243(ault operation dif)-.1 F 2.243(fers from the)-.25 F
974 (Posix 1003.2 standard to match the standard.)224 700.8 Q 170.955(GNU 1993)72
975 768 R(September 16)2.5 E(7)535 768 Q EP
976 %%Page: 8 8
977 %%BeginPageSetup
978 BP
979 %%EndPageSetup
980 /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
981 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0
982 SF(pri)184 84 Q(vileged)-.1 E F0(Same as)224 96 Q F1<ad70>2.5 E F0(.)A F1 -.1
983 (ve)184 108 S(rbose).1 E F0(Same as)7.33 E F1<ad76>2.5 E F0(.)A F1(vi)184 120 Q
984 F0(Use a vi-style command line editing interf)224 120 Q(ace.)-.1 E F1(xtrace)
985 184 132 Q F0(Same as)224 132 Q F1<ad78>2.5 E F0(.)A(If no)184 144 Q/F2 10
986 /Times-Italic@0 SF(option-name)2.5 E F0(is supplied, the v)2.5 E
987 (alues of the current options are printed.)-.25 E F1<ad70>144 156 Q F0 -.45(Tu)
988 184 156 S .521(rn on).45 F F2(privile)3.021 E -.1(ge)-.4 G(d).1 E F0 3.021
989 (mode. In)3.021 F .521(this mode, the)3.021 F F1($ENV)3.021 E F0 .522
990 (\214le is not processed, and shell func-)3.021 F .26
991 (tions are not inherited from the en)184 168 R 2.76(vironment. This)-.4 F .26
992 (is enabled automatically on startup if)2.76 F .481(the ef)184 180 R(fecti)-.25
993 E .781 -.15(ve u)-.25 H .482
994 (ser \(group\) id is not equal to the real user \(group\) id.).15 F -.45(Tu)
995 5.482 G .482(rning this option).45 F(of)184 192 Q 2.5(fc)-.25 G(auses the ef)
996 202.35 192 Q(fecti)-.25 E .3 -.15(ve u)-.25 H
997 (ser and group ids to be set to the real user and group ids.).15 E F1<ad74>144
998 204 Q F0(Exit after reading and e)184 204 Q -.15(xe)-.15 G(cuting one command.)
999 .15 E F1<ad75>144 216 Q F0 -.35(Tr)184 216 S .445(eat unset v).35 F .444
1000 (ariables as an error when performing parameter e)-.25 F 2.944(xpansion. If)
1001 -.15 F -.15(ex)2.944 G .444(pansion is).15 F .519(attempted on an unset v)184
1002 228 R .519(ariable, the shell prints an error message, and, if not interacti)
1003 -.25 F -.15(ve)-.25 G(,).15 E -.15(ex)184 240 S(its with a non\255zero status.)
1004 .15 E F1<ad76>144 252 Q F0(Print shell input lines as the)184 252 Q 2.5(ya)-.15
1005 G(re read.)306.63 252 Q F1<ad78>144 264 Q F0 1.057(After e)184 264 R 1.056
1006 (xpanding each)-.15 F F2(simple-command)3.556 E F0(,).77 E F1(bash)3.556 E F0
1007 1.056(displays the e)3.556 F 1.056(xpanded v)-.15 F 1.056(alue of)-.25 F/F3 9
1008 /Times-Bold@0 SF(PS4)3.556 E/F4 9/Times-Roman@0 SF(,)A F0(fol-)3.306 E(lo)184
1009 276 Q(wed by the command and its e)-.25 E(xpanded ar)-.15 E(guments.)-.18 E F1
1010 <ad6c>144 288 Q F0(Sa)184 288 Q 1.398 -.15(ve a)-.2 H 1.098
1011 (nd restore the binding of).15 F F2(name)3.598 E F0 1.098(in a)3.598 F F1 -.25
1012 (fo)3.598 G(r).25 E F2(name)3.598 E F0([in)3.599 E F1 -.1(wo)3.599 G(rd).1 E F0
1013 3.599(]c)C 1.099(ommand \(see)451.687 288 R F3(SHELL)3.599 E(GRAMMAR)184 300 Q
1014 F0(abo)2.25 E -.15(ve)-.15 G(\).).15 E F1<ad64>144 312 Q F0 1.68
1015 (Disable the hashing of commands that are look)184 312 R 1.68(ed up for e)-.1 F
1016 -.15(xe)-.15 G 4.18(cution. Normally).15 F 4.18(,c)-.65 G(om-)523.89 312 Q
1017 1.275(mands are remembered in a hash table, and once found, do not ha)184 324 R
1018 1.576 -.15(ve t)-.2 H 3.776(ob).15 G 3.776(el)490.888 324 S(ook)501.884 324 Q
1019 1.276(ed up)-.1 F(ag)184 336 Q(ain.)-.05 E F1<ad43>144 348 Q F0 .812(The ef)184
1020 348 R .812(fect is as if the shell command `noclobber=' had been e)-.25 F -.15
1021 (xe)-.15 G .811(cuted \(see).15 F F1 .811(Shell V)3.311 F(ari-)-.92 E(ables)184
1022 360 Q F0(abo)2.5 E -.15(ve)-.15 G(\).).15 E F1<ad48>144 372 Q F0(Enable)184 372
1023 Q F1(!)3.13 E F0 .63(style history substitution.)5.63 F .63
1024 (This \215ag is on by def)5.63 F .63(ault when the shell is interac-)-.1 F(ti)
1025 184 384 Q -.15(ve)-.25 G(.).15 E F1<ad50>144 396 Q F0 2.107
1026 (If set, do not follo)184 396 R 4.607(ws)-.25 G 2.107
1027 (ymbolic links when performing commands such as)279.835 396 R F1(cd)4.607 E F0
1028 (which)4.606 E(change the current directory)184 408 Q 5(.T)-.65 G(he ph)309.42
1029 408 Q(ysical directory is used instead.)-.05 E F1<adad>144 420 Q F0 .05
1030 (If no ar)184 420 R .05(guments follo)-.18 F 2.55(wt)-.25 G .05
1031 (his \215ag, then the positional parameters are unset.)280.98 420 R .05
1032 (Otherwise, the)5.05 F(positional parameters are set to the)184 432 Q F2(ar)2.5
1033 E(g)-.37 E F0(s, e)A -.15(ve)-.25 G 2.5(ni).15 G 2.5(fs)371.81 432 S
1034 (ome of them be)381.53 432 Q(gin with a)-.15 E F1<ad>2.5 E F0(.)A F1<ad>144 444
1035 Q F0 1.945(Signal the end of options, cause all remaining)184 444 R F2(ar)4.444
1036 E(g)-.37 E F0 4.444(st)C 4.444(ob)409.45 444 S 4.444(ea)423.894 444 S 1.944
1037 (ssigned to the positional)437.218 444 R 3.445(parameters. The)184 456 R F1
1038 <ad78>3.445 E F0(and)3.445 E F1<ad76>3.445 E F0 .945(options are turned of)
1039 3.445 F 3.445(f. If)-.25 F .946(there are no)3.445 F F2(ar)3.446 E(g)-.37 E F0
1040 .946(s, the positional)B(parameters remain unchanged.)184 468 Q .317
1041 (The \215ags are of)144 484.8 R 2.817(fb)-.25 G 2.817(yd)218.328 484.8 S(ef)
1042 231.145 484.8 Q .317(ault unless otherwise noted.)-.1 F .316
1043 (Using + rather than \255 causes these \215ags to be)5.317 F .198(turned of)144
1044 496.8 R 2.698(f. The)-.25 F .199
1045 (\215ags can also be speci\214ed as options to an in)2.699 F -.2(vo)-.4 G .199
1046 (cation of the shell.).2 F .199(The current set)5.199 F .643
1047 (of \215ags may be found in)144 508.8 R F1<24ad>3.143 E F0 5.642(.A)C .642
1048 (fter the option ar)273.91 508.8 R .642(guments are processed, the remaining)
1049 -.18 F F2 3.142(na)3.142 G -.37(rg)512.238 508.8 S F0 3.142(sa).37 G(re)532.23
1050 508.8 Q .775(treated as v)144 520.8 R .775
1051 (alues for the positional parameters and are assigned, in order)-.25 F 3.275
1052 (,t)-.4 G(o)448.69 520.8 Q F1($1)3.275 E F0(,)A F1($2)3.275 E F0(,)A F1 3.275
1053 (... $)3.275 F F2(n)A F0 5.775(.I)C 3.275(fn)523.395 520.8 S(o)535 520.8 Q .309
1054 (options or)144 532.8 R F2(ar)2.809 E(g)-.37 E F0 2.808(sa)C .308
1055 (re supplied, all shell v)212.056 532.8 R .308(ariables are printed.)-.25 F
1056 .308(The return status is al)5.308 F -.1(wa)-.1 G .308(ys true unless).1 F
1057 (an ille)144 544.8 Q -.05(ga)-.15 G 2.5(lo).05 G(ption is encountered.)188.24
1058 544.8 Q F1(shift)108 561.6 Q F0([)2.5 E F2(n)A F0(])A .428
1059 (The positional parameters from)144 573.6 R F2(n)2.928 E F0 .429
1060 (+1 ... are renamed to)B F1 .429($1 ....)2.929 F F0 -.15(Pa)5.429 G .429
1061 (rameters represented by the num-).15 F(bers)144 585.6 Q F1($#)3.434 E F0(do)
1062 3.434 E .934(wn to)-.25 F F1($#)3.434 E F0<ad>A F2(n)A F0 .934(+1 are unset.)B
1063 (If)5.934 E F2(n)3.433 E F0 .933(is 0, no parameters are changed.)3.433 F(If)
1064 5.933 E F2(n)3.433 E F0 .933(is not gi)3.433 F -.15(ve)-.25 G .933(n, it is).15
1065 F .026(assumed to be 1.)144 597.6 R F2(n)5.026 E F0 .026(must be a non-ne)2.526
1066 F -.05(ga)-.15 G(ti).05 E .326 -.15(ve n)-.25 H .026
1067 (umber less than or equal to).15 F F1($#)2.526 E F0 5.026(.I)C(f)454.886 597.6
1068 Q F2(n)2.526 E F0 .027(is greater than)2.527 F F1($#)2.527 E F0(,)A .03
1069 (the positional parameters are not changed.)144 609.6 R .029
1070 (The return status is greater than 0 if)5.03 F F2(n)2.529 E F0 .029
1071 (is greater than)2.529 F F1($#)2.529 E F0(or less than 0; otherwise 0.)144
1072 621.6 Q F1(suspend)108 638.4 Q F0([)2.5 E F1<ad66>A F0(])A .492(Suspend the e)
1073 144 650.4 R -.15(xe)-.15 G .492(cution of this shell until it recei).15 F -.15
1074 (ve)-.25 G 2.992(sa).15 G F3(SIGCONT).001 E F0 2.993(signal. The)2.743 F F1
1075 <ad66>2.993 E F0 .493(option says not to)2.993 F .759
1076 (complain if this is a login shell; just suspend an)144 662.4 R(yw)-.15 E(ay)
1077 -.1 E 5.758(.T)-.65 G .758(he return status is 0 unless the shell is a)375.688
1078 662.4 R(login shell and)144 674.4 Q F1<ad66>2.5 E F0
1079 (is not supplied, or if job control is not enabled.)2.5 E F1(test)108 691.2 Q
1080 F2 -.2(ex)2.5 G(pr).2 E F1([)108 703.2 Q F2 -.2(ex)2.5 G(pr).2 E F1(])2.5 E F0
1081 .877(Return a status of 0 \(true\) or 1 \(f)6.77 F .878
1082 (alse\) depending on the e)-.1 F -.25(va)-.25 G .878
1083 (luation of the conditional e).25 F(xpression)-.15 E F2 -.2(ex)144 715.2 S(pr)
1084 .2 E F0 5.008(.E).73 G .008(xpressions may be unary or binary)175.918 715.2 R
1085 5.007(.U)-.65 G .007(nary e)328.064 715.2 R .007
1086 (xpressions are often used to e)-.15 F .007(xamine the status)-.15 F .203
1087 (of a \214le.)144 727.2 R .203
1088 (There are string operators and numeric comparison operators as well.)5.203 F
1089 .204(Each operator and)5.204 F 170.955(GNU 1993)72 768 R(September 16)2.5 E(8)
1090 535 768 Q EP
1091 %%Page: 9 9
1092 %%BeginPageSetup
1093 BP
1094 %%EndPageSetup
1095 /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
1096 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E 1.592
1097 (operand must be a separate ar)144 84 R 4.091(gument. If)-.18 F/F1 10
1098 /Times-Italic@0 SF(\214le)4.091 E F0 1.591(is of the form /de)4.091 F(v/fd/)
1099 -.25 E F1(n)A F0 4.091(,t)C 1.591(hen \214le descriptor)444.756 84 R F1(n)4.091
1100 E F0(is)4.091 E(check)144 96 Q(ed.)-.1 E/F2 10/Times-Bold@0 SF<ad62>144 108 Q
1101 F1(\214le)2.5 E F0 -.35(Tr)180 108 S(ue if).35 E F1(\214le)2.5 E F0 -.15(ex)2.5
1102 G(ists and is block special.).15 E F2<ad63>144 120 Q F1(\214le)2.5 E F0 -.35
1103 (Tr)180 120 S(ue if).35 E F1(\214le)2.5 E F0 -.15(ex)2.5 G
1104 (ists and is character special.).15 E F2<ad64>144 132 Q F1(\214le)2.5 E F0 -.35
1105 (Tr)180 132 S(ue if).35 E F1(\214le)2.5 E F0 -.15(ex)2.5 G
1106 (ists and is a directory).15 E(.)-.65 E F2<ad65>144 144 Q F1(\214le)2.5 E F0
1107 -.35(Tr)180 144 S(ue if).35 E F1(\214le)2.5 E F0 -.15(ex)2.5 G(ists.).15 E F2
1108 <ad66>144 156 Q F1(\214le)2.5 E F0 -.35(Tr)180 156 S(ue if).35 E F1(\214le)2.5
1109 E F0 -.15(ex)2.5 G(ists and is a re).15 E(gular \214le.)-.15 E F2<ad67>144 168
1110 Q F1(\214le)2.5 E F0 -.35(Tr)180 168 S(ue if).35 E F1(\214le)2.5 E F0 -.15(ex)
1111 2.5 G(ists and is set-group-id.).15 E F2<ad6b>144 180 Q F1(\214le)2.5 E F0 -.35
1112 (Tr)180 180 S(ue if).35 E F1(\214le)2.5 E F0(has its `)2.5 E(`stick)-.74 E(y')
1113 -.15 E 2.5('b)-.74 G(it set.)295.22 180 Q F2<ad4c>144 192 Q F1(\214le)2.5 E F0
1114 -.35(Tr)8.91 G(ue if).35 E F1(\214le)2.5 E F0 -.15(ex)2.5 G
1115 (ists and is a symbolic link.).15 E F2<ad70>144 204 Q F1(\214le)2.5 E F0 -.35
1116 (Tr)180 204 S(ue if).35 E F1(\214le)2.5 E F0 -.15(ex)2.5 G
1117 (ists and is a named pipe.).15 E F2<ad72>144 216 Q F1(\214le)2.5 E F0 -.35(Tr)
1118 180 216 S(ue if).35 E F1(\214le)2.5 E F0 -.15(ex)2.5 G(ists and is readable.)
1119 .15 E F2<ad73>144 228 Q F1(\214le)2.5 E F0 -.35(Tr)180 228 S(ue if).35 E F1
1120 (\214le)2.5 E F0 -.15(ex)2.5 G(ists and has a size greater than zero.).15 E F2
1121 <ad53>144 240 Q F1(\214le)2.5 E F0 -.35(Tr)180 240 S(ue if).35 E F1(\214le)2.5
1122 E F0 -.15(ex)2.5 G(ists and is a sock).15 E(et.)-.1 E F2<ad74>144 252 Q F1(fd)
1123 2.5 E F0 -.35(Tr)180 252 S(ue if).35 E F1(fd)2.5 E F0(is opened on a terminal.)
1124 2.5 E F2<ad75>144 264 Q F1(\214le)2.5 E F0 -.35(Tr)180 264 S(ue if).35 E F1
1125 (\214le)2.5 E F0 -.15(ex)2.5 G(ists and its set-user).15 E(-id bit is set.)-.2
1126 E F2<ad77>144 276 Q F1(\214le)2.5 E F0 -.35(Tr)8.36 G(ue if).35 E F1(\214le)2.5
1127 E F0 -.15(ex)2.5 G(ists and is writable.).15 E F2<ad78>144 288 Q F1(\214le)2.5
1128 E F0 -.35(Tr)180 288 S(ue if).35 E F1(\214le)2.5 E F0 -.15(ex)2.5 G
1129 (ists and is e).15 E -.15(xe)-.15 G(cutable.).15 E F2<ad4f>144 300 Q F1(\214le)
1130 2.5 E F0 -.35(Tr)7.8 G(ue if).35 E F1(\214le)2.5 E F0 -.15(ex)2.5 G
1131 (ists and is o).15 E(wned by the ef)-.25 E(fecti)-.25 E .3 -.15(ve u)-.25 H
1132 (ser id.).15 E F2<ad47>144 312 Q F1(\214le)2.5 E F0 -.35(Tr)7.8 G(ue if).35 E
1133 F1(\214le)2.5 E F0 -.15(ex)2.5 G(ists and is o).15 E(wned by the ef)-.25 E
1134 (fecti)-.25 E .3 -.15(ve g)-.25 H(roup id.).15 E F1(\214le1)144 324 Q F0<ad>2.5
1135 E F2(nt)A F1(\214le2)2.5 E F0 -.35(Tr)180 336 S(ue if).35 E F1(\214le1)2.5 E F0
1136 (is ne)2.5 E(wer \(according to modi\214cation date\) than)-.25 E F1(\214le2)
1137 2.5 E F0(.)A F1(\214le1)144 348 Q F0<ad>2.5 E F2(ot)A F1(\214le2)2.5 E F0 -.35
1138 (Tr)180 360 S(ue if).35 E F1(\214le1)2.5 E F0(is older than \214le2.)2.5 E F1
1139 (\214le1)144 372 Q F2(\255ef)2.5 E F1(\214le)2.5 E F0 -.35(Tr)180 384 S(ue if)
1140 .35 E F1(\214le1)2.5 E F0(and)2.5 E F1(\214le2)2.5 E F0(ha)2.5 E .3 -.15(ve t)
1141 -.2 H(he same de).15 E(vice and inode numbers.)-.25 E F2<ad7a>144 396 Q F1
1142 (string)2.5 E F0 -.35(Tr)180 408 S(ue if the length of).35 E F1(string)2.5 E F0
1143 (is zero.)2.5 E F2<ad6e>144 420 Q F1(string)2.5 E(string)144 432 Q F0 -.35(Tr)
1144 180 432 S(ue if the length of).35 E F1(string)2.5 E F0(is non\255zero.)2.5 E F1
1145 (string1)144 444 Q F2(=)2.5 E F1(string2)2.5 E F0 -.35(Tr)180 456 S
1146 (ue if the strings are equal.).35 E F1(string1)144 468 Q F2(!=)2.5 E F1
1147 (string2)2.5 E F0 -.35(Tr)180 480 S(ue if the strings are not equal.).35 E F2
1148 (!)144 492 Q F1 -.2(ex)2.5 G(pr).2 E F0 -.35(Tr)180 492 S(ue if).35 E F1 -.2
1149 (ex)2.5 G(pr).2 E F0(is f)2.5 E(alse.)-.1 E F1 -.2(ex)144 504 S(pr1).2 E F0<ad>
1150 2.5 E F2(a)A F1 -.2(ex)2.5 G(pr2).2 E F0 -.35(Tr)180 516 S(ue if both).35 E F1
1151 -.2(ex)2.5 G(pr1).2 E F0(AND)2.5 E F1 -.2(ex)2.5 G(pr2).2 E F0(are true.)2.5 E
1152 F1 -.2(ex)144 528 S(pr1).2 E F0<ad>2.5 E F2(o)A F1 -.2(ex)2.5 G(pr2).2 E F0
1153 -.35(Tr)180 540 S(ue if either).35 E F1 -.2(ex)2.5 G(pr1).2 E F0(OR)2.5 E F1
1154 -.2(ex)2.5 G(pr2).2 E F0(is true.)2.5 E F1(ar)144 552 Q(g1)-.37 E F2(OP)2.5 E
1155 F1(ar)2.5 E(g2)-.37 E/F3 9/Times-Bold@0 SF(OP)180 564 Q F0 .035(is one of)2.284
1156 F F2(\255eq)2.535 E F0(,)A F2(\255ne)2.535 E F0(,)A F2(\255lt)2.535 E F0(,)A F2
1157 (\255le)2.535 E F0(,)A F2(\255gt)2.535 E F0 2.535(,o)C(r)332.165 564 Q F2
1158 (\255ge)2.535 E F0 5.035(.T)C .035
1159 (hese arithmetic binary operators return true)366.815 564 R(if)180 576 Q F1(ar)
1160 3.32 E(g1)-.37 E F0 .82(is equal, not-equal, less-than, less-than-or)3.32 F .82
1161 (-equal, greater)-.2 F .82(-than, or greater)-.2 F(-than-or)-.2 E(-)-.2 E .5
1162 (equal than)180 588 R F1(ar)3 E(g2)-.37 E F0 3.001(,r)C(especti)252.231 588 Q
1163 -.15(ve)-.25 G(ly).15 E(.)-.65 E F1(Ar)5.501 E(g1)-.37 E F0(and)3.001 E F1(ar)
1164 3.001 E(g2)-.37 E F0 .501(may be positi)3.001 F .801 -.15(ve i)-.25 H(nte).15 E
1165 .501(gers, ne)-.15 F -.05(ga)-.15 G(ti).05 E .801 -.15(ve i)-.25 H(nte).15 E
1166 (gers,)-.15 E(or the special e)180 600 Q(xpression)-.15 E F2<ad6c>2.5 E F1
1167 (string)2.5 E F0 2.5(,w)C(hich e)327.48 600 Q -.25(va)-.25 G
1168 (luates to the length of).25 E F1(string)2.5 E F0(.).22 E F2(times)108 616.8 Q
1169 F0 1.229(Print the accumulated user and system times for the shell and for pro\
1170 cesses run from the shell.)144 616.8 R(The return status is 0.)144 628.8 Q F2
1171 (trap)108 645.6 Q F0([)2.5 E F2<ad6c>A F0 2.5(][)C F1(ar)149.8 645.6 Q(g)-.37 E
1172 F0 2.5(][)C F1(sigspec)172.48 645.6 Q F0(])A .767(The command)144 657.6 R F1
1173 (ar)3.267 E(g)-.37 E F0 .767(is to be read and e)3.267 F -.15(xe)-.15 G .767
1174 (cuted when the shell recei).15 F -.15(ve)-.25 G 3.267(ss).15 G(ignal\(s\))
1175 434.781 657.6 Q F1(sigspec)3.267 E F0 5.767(.I).31 G(f)509.945 657.6 Q F1(ar)
1176 3.267 E(g)-.37 E F0(is)3.268 E 2.164(absent or)144 669.6 R F2<ad>4.664 E F0
1177 4.664(,a)C 2.164(ll speci\214ed signals are reset to their original v)204.512
1178 669.6 R 2.164(alues \(the v)-.25 F 2.163(alues the)-.25 F 4.663(yh)-.15 G 2.163
1179 (ad upon)505.897 669.6 R .681(entrance to the shell\).)144 681.6 R(If)5.681 E
1180 F1(ar)3.181 E(g)-.37 E F0 .681
1181 (is the null string this signal is ignored by the shell and by the com-)3.181 F
1182 1.174(mands it in)144 693.6 R -.2(vo)-.4 G -.1(ke).2 G(s.).1 E F1(sigspec)6.174
1183 E F0 1.174(is either a signal name de\214ned in <)3.674 F F1(signal.h)A F0
1184 1.173(>, or a signal number)B 6.173(.I)-.55 G(f)536.67 693.6 Q F1(sigspec)144
1185 705.6 Q F0(is)2.769 E F3(EXIT)2.769 E F0 .269(\(0\) the command)2.519 F F1(ar)
1186 2.769 E(g)-.37 E F0 .269(is e)2.769 F -.15(xe)-.15 G .269(cuted on e).15 F .269
1187 (xit from the shell.)-.15 F -.4(Wi)5.269 G .269(th no ar).4 F(guments,)-.18 E
1188 F2(trap)2.77 E F0 .403
1189 (prints the list of commands associated with each signal number)144 717.6 R
1190 5.402(.T)-.55 G(he)414.118 717.6 Q F2<ad6c>2.902 E F0 .402
1191 (option causes the shell to)2.902 F .562
1192 (print a list of signal names and their corresponding numbers.)144 729.6 R .562
1193 (An ar)5.562 F .562(gument of)-.18 F F2<adad>3.062 E F0 .562(disables option)
1194 3.062 F 170.955(GNU 1993)72 768 R(September 16)2.5 E(9)535 768 Q EP
1195 %%Page: 10 10
1196 %%BeginPageSetup
1197 BP
1198 %%EndPageSetup
1199 /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
1200 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E .564
1201 (checking for the rest of the ar)144 84 R 3.064(guments. Signals)-.18 F .564
1202 (ignored upon entry to the shell cannot be trapped)3.064 F 1.144(or reset.)144
1203 96 R -.35(Tr)6.144 G 1.145(apped signals are reset to their original v).35 F
1204 1.145(alues in a child process when it is created.)-.25 F
1205 (The return status is f)144 108 Q(alse if either the trap name or number is in)
1206 -.1 E -.25(va)-.4 G(lid; otherwise).25 E/F1 10/Times-Bold@0 SF(trap)2.5 E F0
1207 (returns true.)2.5 E F1(type)108 124.8 Q F0([)2.5 E F1(\255all)A F0 2.5(][)C F1
1208 (\255type)157.58 124.8 Q F0(|)2.5 E F1(\255path)2.5 E F0(])A/F2 10
1209 /Times-Italic@0 SF(name)2.5 E F0([)2.5 E F2(name)A F0(...])2.5 E -.4(Wi)144
1210 136.8 S .206(th no options, indicate ho).4 F 2.706(we)-.25 G(ach)272.15 136.8 Q
1211 F2(name)2.705 E F0 -.1(wo)2.705 G .205
1212 (uld be interpreted if used as a command name.).1 F .205(If the)5.205 F F1
1213 (\255type)144 148.8 Q F0 .527(\215ag is used,)3.027 F F1(type)3.027 E F0 .528
1214 (prints a phrase which is one of)3.028 F F2(alias)3.028 E F0(,).27 E F2 -.1(ke)
1215 3.028 G(ywor)-.2 E(d)-.37 E F0(,).77 E F2(function)3.028 E F0(,).24 E F2 -.2
1216 (bu)3.028 G(iltin).2 E F0 3.028(,o).24 G(r)512.284 148.8 Q F2(\214le)3.028 E F0
1217 (if)3.028 E F2(name)144 160.8 Q F0 .297(is an alias, shell reserv)2.798 F .297
1218 (ed w)-.15 F .297(ord, function, b)-.1 F .297(uiltin, or disk \214le, respecti)
1219 -.2 F -.15(ve)-.25 G(ly).15 E 2.797(.I)-.65 G 2.797(ft)472.152 160.8 S .297
1220 (he name is not)481.059 160.8 R 1.097(found, then nothing is printed, and an e)
1221 144 172.8 R 1.097(xit status of f)-.15 F 1.097(alse is returned.)-.1 F 1.097
1222 (If the)6.097 F F1(\255path)3.598 E F0 1.098(\215ag is used,)3.598 F F1(type)
1223 144 184.8 Q F0 1.009(either returns the name of the disk \214le that w)3.509 F
1224 1.008(ould be e)-.1 F -.15(xe)-.15 G 1.008(cuted if).15 F F2(name)3.508 E F0
1225 1.008(were speci\214ed as a)3.508 F .562(command name, or nothing if)144 196.8
1226 R F1(\255type)3.062 E F0 -.1(wo)3.062 G .562(uld not return).1 F F2(\214le)
1227 3.063 E F0 5.563(.I).18 G 3.063(fac)389.542 196.8 S .563(ommand is hashed,)
1228 407.878 196.8 R F1(\255path)3.063 E F0(prints)3.063 E .684(the hashed v)144
1229 208.8 R .684(alue, not necessarily the \214le that appears \214rst in)-.25 F/F3
1230 9/Times-Bold@0 SF -.666(PA)3.184 G(TH)-.189 E/F4 9/Times-Roman@0 SF(.)A F0 .684
1231 (If the)5.184 F F1(\255all)3.184 E F0 .683(\215ag is used,)3.184 F F1(type)
1232 3.183 E F0 1.135(prints all of the places that contain an e)144 220.8 R -.15
1233 (xe)-.15 G 1.135(cutable named).15 F F2(name)3.635 E F0 6.136(.T).18 G 1.136
1234 (his includes aliases and func-)418.256 220.8 R 1.011
1235 (tions, if and only if the)144 232.8 R F1(\255path)3.511 E F0 1.011
1236 (\215ag is not also used.)3.511 F 1.011
1237 (The table of hashed commands is not con-)6.011 F .786(sulted when using)144
1238 244.8 R F1(\255all)3.286 E F0(.)A F1(type)5.786 E F0(accepts)3.286 E F1<ad61>
1239 3.286 E F0(,)A F1<ad74>3.286 E F0 3.286(,a)C(nd)335.698 244.8 Q F1<ad70>3.286 E
1240 F0 .787(in place of)3.287 F F1(\255all)3.287 E F0(,)A F1(\255type)3.287 E F0
1241 3.287(,a)C(nd)466.906 244.8 Q F1(\255path)3.287 E F0 3.287(,r)C(espec-)514.46
1242 244.8 Q(ti)144 256.8 Q -.15(ve)-.25 G(ly).15 E 6.127(.A)-.65 G 3.627(na)181.577
1243 256.8 S -.18(rg)194.644 256.8 S 1.127(ument of).18 F F1<adad>3.627 E F0 1.127
1244 (disables option checking for the rest of the ar)3.627 F(guments.)-.18 E F1
1245 (type)6.126 E F0(returns)3.626 E(true if an)144 268.8 Q 2.5(yo)-.15 G 2.5(ft)
1246 192.45 268.8 S(he ar)201.06 268.8 Q(guments are found, f)-.18 E
1247 (alse if none are found.)-.1 E F1(ulimit)108 285.6 Q F0([)2.5 E F1
1248 (\255SHacdfmstpnuv)A F0([)2.5 E F2(limit)A F0(]])A F1(Ulimit)144 297.6 Q F0
1249 (pro)3.056 E .556(vides control o)-.15 F -.15(ve)-.15 G 3.057(rt).15 G .557
1250 (he resources a)266.316 297.6 R -.25(va)-.2 G .557
1251 (ilable to the shell and to processes started by it, on).25 F .765
1252 (systems that allo)144 309.6 R 3.265(ws)-.25 G .765(uch control.)226.325 309.6
1253 R .765(The v)5.765 F .765(alue of)-.25 F F2(limit)3.265 E F0 .765
1254 (can be a number in the unit speci\214ed for the)3.265 F .301
1255 (resource, or the v)144 321.6 R(alue)-.25 E F1(unlimited)2.801 E F0 5.301(.T)C
1256 (he)288.565 321.6 Q F1(H)2.801 E F0(and)2.801 E F1(S)2.801 E F0 .302
1257 (options specify that the hard or soft limit is set for)2.802 F .005(the gi)144
1258 333.6 R -.15(ve)-.25 G 2.505(nr).15 G 2.505(esource. A)186.38 333.6 R .004(har\
1259 d limit cannot be increased once it is set; a soft limit may be increased up)
1260 2.505 F .008(to the v)144 345.6 R .008(alue of the hard limit.)-.25 F .008
1261 (If neither)5.008 F F1(H)2.508 E F0(nor)2.508 E F1(S)2.508 E F0 .008
1262 (is speci\214ed, the command applies to the soft limit.)2.508 F(If)144 357.6 Q
1263 F2(limit)2.758 E F0 .258(is omitted, the current v)2.758 F .257
1264 (alue of the soft limit of the resource is printed, unless the)-.25 F F1(H)
1265 2.757 E F0(option)2.757 E .575(is gi)144 369.6 R -.15(ve)-.25 G 3.075(n. When)
1266 .15 F .576(more than one resource is speci\214ed, the limit name and unit is p\
1267 rinted before the)3.076 F -.25(va)144 381.6 S 2.5(lue. Other).25 F
1268 (options are interpreted as follo)2.5 E(ws:)-.25 E F1<ad61>144 393.6 Q F0
1269 (all current limits are reported)180 393.6 Q F1<ad63>144 405.6 Q F0
1270 (the maximum size of core \214les created)180 405.6 Q F1<ad64>144 417.6 Q F0
1271 (the maximum size of a process')180 417.6 Q 2.5(sd)-.55 G(ata se)317.76 417.6 Q
1272 (gment)-.15 E F1<ad66>144 429.6 Q F0
1273 (the maximum size of \214les created by the shell)180 429.6 Q F1<ad6d>144 441.6
1274 Q F0(the maximum resident set size)180 441.6 Q F1<ad73>144 453.6 Q F0
1275 (the maximum stack size)180 453.6 Q F1<ad74>144 465.6 Q F0
1276 (the maximum amount of cpu time in seconds)180 465.6 Q F1<ad70>144 477.6 Q F0
1277 (the pipe size in 512-byte blocks \(this may not be set\))180 477.6 Q F1<ad6e>
1278 144 489.6 Q F0 .164
1279 (the maximum number of open \214le descriptors \(most systems do not allo)180
1280 489.6 R 2.664(wt)-.25 G .164(his v)481.708 489.6 R .164(alue to be)-.25 F
1281 (set, only displayed\))180 501.6 Q F1<ad75>144 513.6 Q F0
1282 (the maximum number of processes a)180 513.6 Q -.25(va)-.2 G
1283 (ilable to a single user).25 E F1<ad76>144 525.6 Q F0
1284 (The maximum amount of virtual memory a)180 525.6 Q -.25(va)-.2 G
1285 (ilable to the shell).25 E .778(An ar)144 542.4 R .778(gument of)-.18 F F1
1286 <adad>3.278 E F0 .778(disables option checking for the rest of the ar)3.278 F
1287 3.279(guments. If)-.18 F F2(limit)3.279 E F0 .779(is gi)3.279 F -.15(ve)-.25 G
1288 .779(n, it is).15 F .394(the ne)144 554.4 R 2.894(wv)-.25 G .394
1289 (alue of the speci\214ed resource \(the)183.168 554.4 R F1<ad61>2.893 E F0 .393
1290 (option is display only\).)2.893 F .393(If no option is gi)5.393 F -.15(ve)-.25
1291 G .393(n, then).15 F F1<ad66>144 566.4 Q F0 .43(is assumed.)2.93 F -1.11(Va)
1292 5.43 G .43(lues are in 1024-byte increments, e)1.11 F .431(xcept for)-.15 F F1
1293 <ad74>2.931 E F0 2.931(,w)C .431(hich is in seconds,)421.315 566.4 R F1<ad70>
1294 2.931 E F0 2.931(,w)C(hich)522.78 566.4 Q .828
1295 (is in units of 512-byte blocks, and)144 578.4 R F1<ad6e>3.327 E F0(and)3.327 E
1296 F1<ad75>3.327 E F0 3.327(,w)C .827(hich are unscaled v)344.784 578.4 R 3.327
1297 (alues. The)-.25 F .827(return status is 0)3.327 F .621(unless an ille)144
1298 590.4 R -.05(ga)-.15 G 3.121(lo).05 G .621
1299 (ption is encountered, a non-numeric ar)217.603 590.4 R .622(gument other than)
1300 -.18 F F1(unlimited)3.122 E F0 .622(is supplied)3.122 F(as)144 602.4 Q F2
1301 (limit)2.5 E F0 2.5(,o)C 2.5(ra)183.17 602.4 S 2.5(ne)193.44 602.4 S
1302 (rror occurs while setting a ne)205.38 602.4 Q 2.5(wl)-.25 G(imit.)333.99 602.4
1303 Q F1(umask)108 619.2 Q F0([)2.5 E F1<ad53>A F0 2.5(][)C F2(mode)162.59 619.2 Q
1304 F0(])A .23(The user \214le-creation mask is set to)144 631.2 R F2(mode)2.73 E
1305 F0 5.23(.I).18 G(f)323.21 631.2 Q F2(mode)2.73 E F0(be)2.729 E .229
1306 (gins with a digit, it is interpreted as an octal)-.15 F .066(number; otherwis\
1307 e it is interpreted as a symbolic mode mask similar to that accepted by)144
1308 643.2 R F2 -.15(ch)2.566 G(mod).15 E F0(\(1\).).77 E(If)144 655.2 Q F2(mode)
1309 2.55 E F0 .05(is omitted, or if the)2.55 F F1<ad53>2.55 E F0 .049
1310 (option is supplied, the current v)2.55 F .049(alue of the mask is printed.)
1311 -.25 F(The)5.049 E F1<ad53>2.549 E F0 .475
1312 (option causes the mask to be printed in symbolic form; the def)144 667.2 R
1313 .475(ault output is an octal number)-.1 F 5.475(.A)-.55 G(n)535 667.2 Q(ar)144
1314 679.2 Q .125(gument of)-.18 F F1<adad>2.625 E F0 .125
1315 (disables option checking for the rest of the ar)2.625 F 2.624(guments. The)
1316 -.18 F .124(return status is 0 if the)2.624 F(mode w)144 691.2 Q
1317 (as successfully changed or if no)-.1 E F2(mode)2.5 E F0(ar)2.5 E(gument w)-.18
1318 E(as supplied, and f)-.1 E(alse otherwise.)-.1 E 170.955(GNU 1993)72 768 R
1319 (September 16)2.5 E(10)530 768 Q EP
1320 %%Page: 11 11
1321 %%BeginPageSetup
1322 BP
1323 %%EndPageSetup
1324 /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
1325 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0
1326 SF(unalias)108 84 Q F0<5bad>2.5 E F1(a)A F0 2.5(][)C/F2 10/Times-Italic@0 SF
1327 (name)164.2 84 Q F0(...])2.5 E(Remo)144 96 Q -.15(ve)-.15 G F2(name)2.882 E F0
1328 2.732(sf)C .232(rom the list of de\214ned aliases.)211.374 96 R(If)5.232 E F1
1329 <ad61>2.733 E F0 .233(is supplied, all alias de\214nitions are remo)2.733 F
1330 -.15(ve)-.15 G(d.).15 E(The return v)144 108 Q(alue is true unless a supplied)
1331 -.25 E F2(name)2.5 E F0(is not a de\214ned alias.)2.5 E F1(unset)108 124.8 Q F0
1332 <5bad>2.5 E F1(fv)A F0 2.5(][)C F2(name)159.74 124.8 Q F0(...])2.5 E -.15(Fo)
1333 144 136.8 S 2.773(re).15 G(ach)164.953 136.8 Q F2(name)2.773 E F0 2.773(,r).18
1334 G(emo)212.049 136.8 Q .573 -.15(ve t)-.15 H .273(he corresponding v).15 F .273
1335 (ariable or)-.25 F 2.773(,g)-.4 G -2.15 -.25(iv e)369.094 136.8 T 2.773(nt).25
1336 G(he)391.467 136.8 Q F1<ad66>2.773 E F0 .273(option, function.)2.773 F .272
1337 (An ar)5.272 F(gument)-.18 E(of)144 148.8 Q F1<adad>2.58 E F0 .08
1338 (disables option checking for the rest of the ar)2.58 F 2.58(guments. Note)-.18
1339 F(that)2.58 E/F3 9/Times-Bold@0 SF -.666(PA)2.58 G(TH)-.189 E/F4 9
1340 /Times-Roman@0 SF(,)A F3(IFS)2.33 E F4(,)A F3(PPID)2.33 E F4(,)A F3(PS1)2.331 E
1341 F4(,)A F3(PS2)2.331 E F4(,)A F3(UID)144 160.8 Q F4(,)A F0(and)4.074 E F3(EUID)
1342 4.324 E F0 1.824(cannot be unset.)4.074 F 1.824(If an)6.824 F 4.323(yo)-.15 G
1343 (f)321.938 160.8 Q F3(RANDOM)4.323 E F4(,)A F3(SECONDS)4.073 E F4(,)A F3
1344 (LINENO)4.073 E F4(,)A F0(or)4.073 E F3(HISTCMD)4.323 E F0(are)4.073 E .328
1345 (unset, the)144 172.8 R 2.828(yl)-.15 G .328(ose their special properties, e)
1346 193.116 172.8 R -.15(ve)-.25 G 2.828(ni).15 G 2.828(ft)330.436 172.8 S(he)
1347 339.374 172.8 Q 2.828(ya)-.15 G .328(re subsequently reset.)360.932 172.8 R
1348 .328(The e)5.328 F .329(xit status is true)-.15 F(unless a)144 184.8 Q F2(name)
1349 2.5 E F0(does not e)2.5 E(xist or is non-unsettable.)-.15 E F1(wait)108 201.6 Q
1350 F0([)2.5 E F2(n)A F0(])A -.8(Wa)144 213.6 S 1.061
1351 (it for the speci\214ed process and return its termination status.).8 F F2(n)
1352 6.061 E F0 1.06(may be a process ID or a job)3.56 F .753
1353 (speci\214cation; if a job spec is gi)144 225.6 R -.15(ve)-.25 G .754
1354 (n, all processes in that job').15 F 3.254(sp)-.55 G .754(ipeline are w)404.012
1355 225.6 R .754(aited for)-.1 F 5.754(.I)-.55 G(f)502.458 225.6 Q F2(n)3.254 E F0
1356 .754(is not)3.254 F(gi)144 237.6 Q -.15(ve)-.25 G .027(n, all currently acti)
1357 .15 F .327 -.15(ve c)-.25 H .027(hild processes are w).15 F .027(aited for)-.1
1358 F 2.526(,a)-.4 G .026(nd the return status is zero.)375.932 237.6 R(If)5.026 E
1359 F2(n)2.526 E F0(speci\214es)2.526 E 2.595(an)144 249.6 S(on-e)156.035 249.6 Q
1360 .095(xistant process or job, the return status is 127.)-.15 F .096
1361 (Otherwise, the return status is the e)5.095 F .096(xit status)-.15 F
1362 (of the last process or job w)144 261.6 Q(aited for)-.1 E(.)-.55 E F3(SEE ALSO)
1363 72 278.4 Q F0(bash\(1\), sh\(1\))108 290.4 Q 170.955(GNU 1993)72 768 R
1364 (September 16)2.5 E(11)530 768 Q EP
1365 %%Trailer
1366 end
1367 %%EOF