mirror of
https://https.git.savannah.gnu.org/git/bash.git
synced 2026-07-09 05:00:49 +02:00
commit bash-snap-20170626 snapshot
This commit is contained in:
Chet Ramey
+357
-338
@@ -1,7 +1,7 @@
|
||||
%!PS-Adobe-2.0
|
||||
%%Creator: dvips(k) 5.996 Copyright 2016 Radical Eye Software
|
||||
%%Title: bashref.dvi
|
||||
%%CreationDate: Mon Apr 3 16:34:02 2017
|
||||
%%CreationDate: Mon Jun 26 09:16:48 2017
|
||||
%%Pages: 182
|
||||
%%PageOrder: Ascend
|
||||
%%BoundingBox: 0 0 612 792
|
||||
@@ -12,7 +12,7 @@
|
||||
%DVIPSWebPage: (www.radicaleye.com)
|
||||
%DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps bashref.dvi
|
||||
%DVIPSParameters: dpi=600
|
||||
%DVIPSSource: TeX output 2017.04.03:1634
|
||||
%DVIPSSource: TeX output 2017.06.26:0916
|
||||
%%BeginProcSet: tex.pro 0 0
|
||||
%!
|
||||
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
|
||||
@@ -7596,7 +7596,7 @@ ifelse
|
||||
TeXDict begin 1 0 bop 150 1318 a Fv(Bash)64 b(Reference)j(Man)-5
|
||||
b(ual)p 150 1385 3600 34 v 2361 1481 a Fu(Reference)31
|
||||
b(Do)s(cumen)m(tation)i(for)d(Bash)2428 1589 y(Edition)h(4.4,)g(for)f
|
||||
Ft(Bash)g Fu(V)-8 b(ersion)31 b(4.4.)3285 1697 y(Marc)m(h)g(2017)150
|
||||
Ft(Bash)g Fu(V)-8 b(ersion)31 b(4.4.)3350 1697 y(June)e(2017)150
|
||||
4927 y Fs(Chet)45 b(Ramey)-11 b(,)46 b(Case)g(W)-11 b(estern)46
|
||||
b(Reserv)l(e)g(Univ)l(ersit)l(y)150 5068 y(Brian)f(F)-11
|
||||
b(o)l(x,)45 b(F)-11 b(ree)45 b(Soft)l(w)l(are)h(F)-11
|
||||
@@ -7604,10 +7604,10 @@ b(oundation)p 150 5141 3600 17 v eop end
|
||||
%%Page: 2 2
|
||||
TeXDict begin 2 1 bop 150 4279 a Fu(This)35 b(text)h(is)g(a)g(brief)f
|
||||
(description)h(of)f(the)h(features)g(that)g(are)g(presen)m(t)g(in)f
|
||||
(the)h(Bash)f(shell)h(\(v)m(ersion)150 4389 y(4.4,)c(22)f(Marc)m(h)g
|
||||
(2017\).)150 4523 y(This)f(is)h(Edition)f(4.4,)i(last)g(up)s(dated)d
|
||||
(22)j(Marc)m(h)f(2017,)i(of)e Fr(The)f(GNU)h(Bash)g(Reference)g(Man)m
|
||||
(ual)p Fu(,)h(for)150 4633 y Ft(Bash)p Fu(,)d(V)-8 b(ersion)31
|
||||
(the)h(Bash)f(shell)h(\(v)m(ersion)150 4389 y(4.4,)c(23)f(June)e
|
||||
(2017\).)150 4523 y(This)34 b(is)h(Edition)g(4.4,)i(last)e(up)s(dated)f
|
||||
(23)h(June)f(2017,)k(of)d Fr(The)f(GNU)i(Bash)f(Reference)g(Man)m(ual)p
|
||||
Fu(,)i(for)150 4633 y Ft(Bash)p Fu(,)29 b(V)-8 b(ersion)31
|
||||
b(4.4.)150 4767 y(Cop)m(yrigh)m(t)602 4764 y(c)577 4767
|
||||
y Fq(\015)f Fu(1988{2017)35 b(F)-8 b(ree)31 b(Soft)m(w)m(are)h(F)-8
|
||||
b(oundation,)31 b(Inc.)390 4902 y(P)m(ermission)21 b(is)f(gran)m(ted)h
|
||||
@@ -9209,9 +9209,9 @@ b(the)g Ft(-k)g Fu(option)390 811 y Ft({)47 b(echo)g(foss.org.my)e(;)i
|
||||
f(to)150 1189 y(`)p Ft(cat)g(file)f(|)h(bash)p Fu('.)53
|
||||
b(It)35 b(is)g(not)g(uncommon)f(to)i(tak)m(e)g(a)f(list)h(of)f
|
||||
(\014lenames,)h(create)g(a)g(series)f(of)g(shell)150
|
||||
1298 y(commands)27 b(to)h(op)s(erate)h(on)e(them,)h(and)f(feed)h(that)g
|
||||
(list)g(of)g(commnds)e(to)j(a)f(shell.)40 b(P)m(arallel)29
|
||||
b(can)f(sp)s(eed)150 1408 y(this)i(up.)40 b(Assuming)30
|
||||
1298 y(commands)24 b(to)h(op)s(erate)h(on)e(them,)i(and)e(feed)g(that)h
|
||||
(list)h(of)e(commands)g(to)i(a)f(shell.)39 b(P)m(arallel)26
|
||||
b(can)f(sp)s(eed)150 1408 y(this)30 b(up.)40 b(Assuming)30
|
||||
b(that)h Ft(file)e Fu(con)m(tains)i(a)g(list)g(of)g(shell)f(commands,)h
|
||||
(one)f(p)s(er)g(line,)390 1542 y Ft(parallel)46 b(-j)h(10)g(<)g(file)
|
||||
150 1676 y Fu(will)37 b(ev)-5 b(aluate)38 b(the)f(commands)f(using)g
|
||||
@@ -9673,17 +9673,18 @@ Fu(.)50 b(This)33 b(is)h(p)s(erformed)e(at)j(the)f(same)g(time)g(as)g
|
||||
(haracters)h(presen)m(t)e(in)g(the)g(original)i(w)m(ord)e(are)150
|
||||
2872 y(remo)m(v)m(ed)h(unless)f(they)h(ha)m(v)m(e)g(b)s(een)f(quoted)g
|
||||
(themselv)m(es)i(\()p Fr(quote)f(remo)m(v)-5 b(al)t Fu(\).)275
|
||||
3011 y(Only)35 b(brace)i(expansion,)h(w)m(ord)e(splitting,)j(and)d
|
||||
(\014lename)g(expansion)g(can)h(c)m(hange)h(the)e(n)m(um)m(b)s(er)150
|
||||
3121 y(of)h(w)m(ords)f(of)g(the)h(expansion;)i(other)e(expansions)f
|
||||
(expand)g(a)h(single)g(w)m(ord)f(to)h(a)g(single)g(w)m(ord.)58
|
||||
b(The)150 3230 y(only)32 b(exceptions)i(to)f(this)f(are)h(the)f
|
||||
(expansions)g(of)h Ft("$@")e Fu(\(see)i(Section)g(3.4.2)h([Sp)s(ecial)f
|
||||
(P)m(arameters],)150 3340 y(page)e(21\))h(and)d Ft("${)p
|
||||
Fj(name)p Ft([@]}")e Fu(\(see)32 b(Section)f(6.7)g([Arra)m(ys],)h(page)
|
||||
f(93\).)275 3478 y(After)41 b(all)i(expansions,)h Ft(quote)29
|
||||
b(removal)40 b Fu(\(see)i(Section)h(3.5.9)g([Quote)f(Remo)m(v)-5
|
||||
b(al],)47 b(page)42 b(33\))h(is)150 3588 y(p)s(erformed.)150
|
||||
3011 y(Only)31 b(brace)i(expansion,)h(w)m(ord)e(splitting,)i(and)e
|
||||
(\014lename)h(expansion)f(can)h(increase)g(the)g(n)m(um)m(b)s(er)150
|
||||
3121 y(of)24 b(w)m(ords)g(of)g(the)h(expansion;)h(other)e(expansions)g
|
||||
(expand)g(a)g(single)h(w)m(ord)f(to)h(a)f(single)h(w)m(ord.)38
|
||||
b(The)24 b(only)150 3230 y(exceptions)i(to)f(this)g(are)g(the)g
|
||||
(expansions)g(of)g Ft("$@")f Fu(and)g Ft($*)g Fu(\(see)i(Section)f
|
||||
(3.4.2)i([Sp)s(ecial)e(P)m(arameters],)150 3340 y(page)31
|
||||
b(21\),)h(and)e Ft("${)p Fj(name)p Ft([@]}")d Fu(and)i
|
||||
Ft(${)p Fj(name)p Ft([*]})f Fu(\(see)j(Section)h(6.7)f([Arra)m(ys],)g
|
||||
(page)g(93\).)275 3478 y(After)41 b(all)i(expansions,)h
|
||||
Ft(quote)29 b(removal)40 b Fu(\(see)i(Section)h(3.5.9)g([Quote)f(Remo)m
|
||||
(v)-5 b(al],)47 b(page)42 b(33\))h(is)150 3588 y(p)s(erformed.)150
|
||||
3791 y Fk(3.5.1)63 b(Brace)40 b(Expansion)150 3938 y
|
||||
Fu(Brace)32 b(expansion)f(is)f(a)i(mec)m(hanism)f(b)m(y)f(whic)m(h)h
|
||||
(arbitrary)f(strings)h(ma)m(y)g(b)s(e)f(generated.)43
|
||||
@@ -12183,63 +12184,65 @@ b(when)e(the)i(function)f(returns.)37 b(The)24 b(return)f(status)i(is)f
|
||||
(zero)i(unless)d Ft(local)g Fu(is)i(used)630 518 y(outside)k(a)f
|
||||
(function,)h(an)f(in)m(v)-5 b(alid)29 b Fr(name)k Fu(is)28
|
||||
b(supplied,)g(or)g Fr(name)34 b Fu(is)28 b(a)h(readonly)f(v)-5
|
||||
b(ariable.)150 681 y Ft(logout)870 817 y(logout)46 b([)p
|
||||
Fj(n)p Ft(])630 953 y Fu(Exit)31 b(a)g(login)g(shell,)g(returning)e(a)i
|
||||
b(ariable.)150 674 y Ft(logout)870 807 y(logout)46 b([)p
|
||||
Fj(n)p Ft(])630 940 y Fu(Exit)31 b(a)g(login)g(shell,)g(returning)e(a)i
|
||||
(status)g(of)f Fr(n)g Fu(to)h(the)g(shell's)f(paren)m(t.)150
|
||||
1116 y Ft(mapfile)870 1252 y(mapfile)46 b([-d)h Fj(delim)p
|
||||
1096 y Ft(mapfile)870 1229 y(mapfile)46 b([-d)h Fj(delim)p
|
||||
Ft(])f([-n)h Fj(count)p Ft(])f([-O)h Fj(origin)p Ft(])f([-s)g
|
||||
Fj(count)p Ft(])h([-t])f([-u)h Fj(fd)p Ft(])1061 1362
|
||||
Fj(count)p Ft(])h([-t])f([-u)h Fj(fd)p Ft(])1061 1338
|
||||
y([-C)g Fj(callback)p Ft(])e([-c)i Fj(quantum)p Ft(])f([)p
|
||||
Fj(array)p Ft(])630 1498 y Fu(Read)38 b(lines)f(from)g(the)h(standard)e
|
||||
Fj(array)p Ft(])630 1471 y Fu(Read)38 b(lines)f(from)g(the)h(standard)e
|
||||
(input)g(in)m(to)j(the)e(indexed)g(arra)m(y)h(v)-5 b(ariable)38
|
||||
b Fr(arra)m(y)p Fu(,)i(or)630 1607 y(from)28 b(\014le)h(descriptor)f
|
||||
b Fr(arra)m(y)p Fu(,)i(or)630 1581 y(from)28 b(\014le)h(descriptor)f
|
||||
Fr(fd)k Fu(if)c(the)h Ft(-u)f Fu(option)h(is)g(supplied.)39
|
||||
b(The)28 b(v)-5 b(ariable)29 b Ft(MAPFILE)e Fu(is)i(the)630
|
||||
1717 y(default)i Fr(arra)m(y)p Fu(.)41 b(Options,)30
|
||||
1690 y(default)i Fr(arra)m(y)p Fu(.)41 b(Options,)30
|
||||
b(if)g(supplied,)g(ha)m(v)m(e)h(the)g(follo)m(wing)h(meanings:)630
|
||||
1880 y Ft(-d)384 b Fu(The)37 b(\014rst)g(c)m(haracter)i(of)f
|
||||
1846 y Ft(-d)384 b Fu(The)37 b(\014rst)g(c)m(haracter)i(of)f
|
||||
Fr(delim)g Fu(is)f(used)g(to)h(terminate)h(eac)m(h)g(input)d(line,)1110
|
||||
1989 y(rather)30 b(than)g(newline.)630 2152 y Ft(-n)384
|
||||
b Fu(Cop)m(y)30 b(at)h(most)g Fr(coun)m(t)i Fu(lines.)41
|
||||
b(If)30 b Fr(coun)m(t)j Fu(is)d(0,)h(all)h(lines)e(are)h(copied.)630
|
||||
2315 y Ft(-O)384 b Fu(Begin)31 b(assigning)g(to)g Fr(arra)m(y)39
|
||||
b Fu(at)31 b(index)f Fr(origin)p Fu(.)41 b(The)30 b(default)h(index)f
|
||||
(is)g(0.)630 2477 y Ft(-s)384 b Fu(Discard)31 b(the)f(\014rst)g
|
||||
Fr(coun)m(t)j Fu(lines)e(read.)630 2640 y Ft(-t)384 b
|
||||
Fu(Remo)m(v)m(e)32 b(a)f(trailing)g Fr(delim)g Fu(\(default)g
|
||||
(newline\))f(from)g(eac)m(h)i(line)f(read.)630 2803 y
|
||||
Ft(-u)384 b Fu(Read)31 b(lines)f(from)g(\014le)h(descriptor)f
|
||||
Fr(fd)j Fu(instead)e(of)f(the)h(standard)e(input.)630
|
||||
2966 y Ft(-C)384 b Fu(Ev)-5 b(aluate)33 b Fr(callbac)m(k)39
|
||||
b Fu(eac)m(h)33 b(time)f Fr(quan)m(tum)p Fu(P)f(lines)h(are)g(read.)45
|
||||
b(The)31 b Ft(-c)g Fu(op-)1110 3075 y(tion)g(sp)s(eci\014es)f
|
||||
Fr(quan)m(tum)p Fu(.)630 3238 y Ft(-c)384 b Fu(Sp)s(ecify)30
|
||||
b(the)g(n)m(um)m(b)s(er)f(of)i(lines)f(read)h(b)s(et)m(w)m(een)g(eac)m
|
||||
(h)g(call)h(to)f Fr(callbac)m(k)p Fu(.)630 3401 y(If)36
|
||||
b Ft(-C)g Fu(is)g(sp)s(eci\014ed)g(without)g Ft(-c)p
|
||||
Fu(,)h(the)g(default)f(quan)m(tum)g(is)h(5000.)60 b(When)36
|
||||
b Fr(callbac)m(k)44 b Fu(is)630 3510 y(ev)-5 b(aluated,)30
|
||||
b(it)e(is)g(supplied)f(the)h(index)f(of)i(the)f(next)g(arra)m(y)g
|
||||
(elemen)m(t)h(to)g(b)s(e)e(assigned)i(and)630 3620 y(the)39
|
||||
b(line)g(to)h(b)s(e)e(assigned)h(to)h(that)f(elemen)m(t)i(as)e
|
||||
(additional)h(argumen)m(ts.)66 b Fr(callbac)m(k)47 b
|
||||
Fu(is)630 3729 y(ev)-5 b(aluated)32 b(after)e(the)h(line)g(is)f(read)g
|
||||
(but)g(b)s(efore)g(the)h(arra)m(y)g(elemen)m(t)g(is)g(assigned.)630
|
||||
3866 y(If)25 b(not)g(supplied)f(with)h(an)g(explicit)i(origin,)g
|
||||
1956 y(rather)41 b(than)h(newline.)74 b(If)41 b Fr(delim)h
|
||||
Fu(is)g(the)f(empt)m(y)h(string,)j Ft(mapfile)40 b Fu(will)1110
|
||||
2066 y(terminate)31 b(a)g(line)g(when)e(it)i(reads)f(a)h(NUL)g(c)m
|
||||
(haracter.)630 2222 y Ft(-n)384 b Fu(Cop)m(y)30 b(at)h(most)g
|
||||
Fr(coun)m(t)i Fu(lines.)41 b(If)30 b Fr(coun)m(t)j Fu(is)d(0,)h(all)h
|
||||
(lines)e(are)h(copied.)630 2378 y Ft(-O)384 b Fu(Begin)31
|
||||
b(assigning)g(to)g Fr(arra)m(y)39 b Fu(at)31 b(index)f
|
||||
Fr(origin)p Fu(.)41 b(The)30 b(default)h(index)f(is)g(0.)630
|
||||
2534 y Ft(-s)384 b Fu(Discard)31 b(the)f(\014rst)g Fr(coun)m(t)j
|
||||
Fu(lines)e(read.)630 2690 y Ft(-t)384 b Fu(Remo)m(v)m(e)32
|
||||
b(a)f(trailing)g Fr(delim)g Fu(\(default)g(newline\))f(from)g(eac)m(h)i
|
||||
(line)f(read.)630 2846 y Ft(-u)384 b Fu(Read)31 b(lines)f(from)g
|
||||
(\014le)h(descriptor)f Fr(fd)j Fu(instead)e(of)f(the)h(standard)e
|
||||
(input.)630 3002 y Ft(-C)384 b Fu(Ev)-5 b(aluate)33 b
|
||||
Fr(callbac)m(k)39 b Fu(eac)m(h)33 b(time)f Fr(quan)m(tum)p
|
||||
Fu(P)f(lines)h(are)g(read.)45 b(The)31 b Ft(-c)g Fu(op-)1110
|
||||
3112 y(tion)g(sp)s(eci\014es)f Fr(quan)m(tum)p Fu(.)630
|
||||
3268 y Ft(-c)384 b Fu(Sp)s(ecify)30 b(the)g(n)m(um)m(b)s(er)f(of)i
|
||||
(lines)f(read)h(b)s(et)m(w)m(een)g(eac)m(h)g(call)h(to)f
|
||||
Fr(callbac)m(k)p Fu(.)630 3424 y(If)36 b Ft(-C)g Fu(is)g(sp)s
|
||||
(eci\014ed)g(without)g Ft(-c)p Fu(,)h(the)g(default)f(quan)m(tum)g(is)h
|
||||
(5000.)60 b(When)36 b Fr(callbac)m(k)44 b Fu(is)630 3533
|
||||
y(ev)-5 b(aluated,)30 b(it)e(is)g(supplied)f(the)h(index)f(of)i(the)f
|
||||
(next)g(arra)m(y)g(elemen)m(t)h(to)g(b)s(e)e(assigned)i(and)630
|
||||
3643 y(the)39 b(line)g(to)h(b)s(e)e(assigned)h(to)h(that)f(elemen)m(t)i
|
||||
(as)e(additional)h(argumen)m(ts.)66 b Fr(callbac)m(k)47
|
||||
b Fu(is)630 3753 y(ev)-5 b(aluated)32 b(after)e(the)h(line)g(is)f(read)
|
||||
g(but)g(b)s(efore)g(the)h(arra)m(y)g(elemen)m(t)g(is)g(assigned.)630
|
||||
3885 y(If)25 b(not)g(supplied)f(with)h(an)g(explicit)i(origin,)g
|
||||
Ft(mapfile)c Fu(will)j(clear)g Fr(arra)m(y)34 b Fu(b)s(efore)24
|
||||
b(assigning)630 3975 y(to)31 b(it.)630 4111 y Ft(mapfile)41
|
||||
b(assigning)630 3995 y(to)31 b(it.)630 4128 y Ft(mapfile)41
|
||||
b Fu(returns)g(successfully)i(unless)e(an)i(in)m(v)-5
|
||||
b(alid)43 b(option)g(or)g(option)g(argumen)m(t)g(is)630
|
||||
4221 y(supplied,)29 b Fr(arra)m(y)39 b Fu(is)30 b(in)m(v)-5
|
||||
4237 y(supplied,)29 b Fr(arra)m(y)39 b Fu(is)30 b(in)m(v)-5
|
||||
b(alid)31 b(or)g(unassignable,)f(or)h Fr(arra)m(y)38
|
||||
b Fu(is)31 b(not)f(an)h(indexed)e(arra)m(y)-8 b(.)150
|
||||
4384 y Ft(printf)870 4520 y(printf)46 b([-v)h Fj(var)p
|
||||
Ft(])g Fj(format)f Ft([)p Fj(arguments)p Ft(])630 4656
|
||||
4394 y Ft(printf)870 4526 y(printf)46 b([-v)h Fj(var)p
|
||||
Ft(])g Fj(format)f Ft([)p Fj(arguments)p Ft(])630 4659
|
||||
y Fu(W)-8 b(rite)27 b(the)g(formatted)f Fr(argumen)m(ts)k
|
||||
Fu(to)d(the)f(standard)f(output)h(under)e(the)i(con)m(trol)i(of)e(the)
|
||||
630 4765 y Fr(format)p Fu(.)66 b(The)39 b Ft(-v)f Fu(option)h(causes)g
|
||||
630 4769 y Fr(format)p Fu(.)66 b(The)39 b Ft(-v)f Fu(option)h(causes)g
|
||||
(the)g(output)g(to)g(b)s(e)f(assigned)h(to)h(the)f(v)-5
|
||||
b(ariable)39 b Fr(v)-5 b(ar)630 4875 y Fu(rather)30 b(than)g(b)s(eing)g
|
||||
b(ariable)39 b Fr(v)-5 b(ar)630 4878 y Fu(rather)30 b(than)g(b)s(eing)g
|
||||
(prin)m(ted)g(to)h(the)g(standard)e(output.)630 5011
|
||||
y(The)36 b Fr(format)i Fu(is)f(a)f(c)m(haracter)i(string)e(whic)m(h)g
|
||||
(con)m(tains)i(three)e(t)m(yp)s(es)g(of)h(ob)5 b(jects:)53
|
||||
@@ -12341,199 +12344,204 @@ b Fj(aname)114 b Fu(The)34 b(w)m(ords)f(are)i(assigned)f(to)h(sequen)m
|
||||
b(elemen)m(ts)h(are)e(remo)m(v)m(ed)i(from)d Fr(aname)34
|
||||
b Fu(b)s(efore)1110 518 y(the)d(assignmen)m(t.)41 b(Other)30
|
||||
b Fr(name)36 b Fu(argumen)m(ts)30 b(are)h(ignored.)630
|
||||
667 y Ft(-d)f Fj(delim)114 b Fu(The)41 b(\014rst)h(c)m(haracter)h(of)f
|
||||
671 y Ft(-d)f Fj(delim)114 b Fu(The)41 b(\014rst)h(c)m(haracter)h(of)f
|
||||
Fr(delim)g Fu(is)g(used)g(to)g(terminate)h(the)f(input)f(line,)1110
|
||||
777 y(rather)30 b(than)g(newline.)630 927 y Ft(-e)384
|
||||
b Fu(Readline)46 b(\(see)g(Chapter)e(8)h([Command)f(Line)h(Editing],)50
|
||||
b(page)45 b(106\))i(is)1110 1036 y(used)37 b(to)i(obtain)g(the)f(line.)
|
||||
65 b(Readline)39 b(uses)e(the)i(curren)m(t)f(\(or)g(default,)j(if)1110
|
||||
1146 y(line)31 b(editing)g(w)m(as)f(not)h(previously)f(activ)m(e\))j
|
||||
(editing)e(settings.)630 1295 y Ft(-i)f Fj(text)162 b
|
||||
Fu(If)36 b(Readline)i(is)f(b)s(eing)g(used)f(to)h(read)g(the)g(line,)j
|
||||
Fr(text)f Fu(is)e(placed)h(in)m(to)g(the)1110 1405 y(editing)31
|
||||
b(bu\013er)e(b)s(efore)h(editing)h(b)s(egins.)630 1554
|
||||
y Ft(-n)f Fj(nchars)66 b Ft(read)38 b Fu(returns)f(after)j(reading)f
|
||||
Fr(nc)m(hars)j Fu(c)m(haracters)e(rather)f(than)g(w)m(aiting)1110
|
||||
1664 y(for)d(a)h(complete)h(line)f(of)g(input,)g(but)f(honors)g(a)h
|
||||
(delimiter)g(if)f(few)m(er)h(than)1110 1773 y Fr(nc)m(hars)d
|
||||
Fu(c)m(haracters)e(are)e(read)h(b)s(efore)f(the)g(delimiter.)630
|
||||
1923 y Ft(-N)g Fj(nchars)66 b Ft(read)39 b Fu(returns)f(after)j
|
||||
(reading)e(exactly)j Fr(nc)m(hars)h Fu(c)m(haracters)f(rather)d(than)
|
||||
1110 2032 y(w)m(aiting)32 b(for)f(a)g(complete)i(line)e(of)g(input,)g
|
||||
(unless)f(EOF)h(is)g(encoun)m(tered)g(or)1110 2142 y
|
||||
Ft(read)f Fu(times)i(out.)43 b(Delimiter)33 b(c)m(haracters)f(encoun)m
|
||||
(tered)g(in)f(the)g(input)g(are)1110 2252 y(not)g(treated)h(sp)s
|
||||
(ecially)f(and)f(do)h(not)g(cause)g Ft(read)e Fu(to)j(return)d(un)m
|
||||
(til)i Fr(nc)m(hars)1110 2361 y Fu(c)m(haracters)26 b(are)f(read.)38
|
||||
b(The)24 b(result)g(is)h(not)f(split)h(on)f(the)h(c)m(haracters)h(in)e
|
||||
Ft(IFS)p Fu(;)1110 2471 y(the)e(in)m(ten)m(t)i(is)e(that)h(the)f(v)-5
|
||||
781 y(rather)31 b(than)g(newline.)42 b(If)30 b Fr(delim)h
|
||||
Fu(is)g(the)h(empt)m(y)f(string,)g Ft(read)f Fu(will)h(termi-)1110
|
||||
891 y(nate)g(a)g(line)f(when)g(it)h(reads)f(a)h(NUL)f(c)m(haracter.)630
|
||||
1044 y Ft(-e)384 b Fu(Readline)46 b(\(see)g(Chapter)e(8)h([Command)f
|
||||
(Line)h(Editing],)50 b(page)45 b(106\))i(is)1110 1154
|
||||
y(used)37 b(to)i(obtain)g(the)f(line.)65 b(Readline)39
|
||||
b(uses)e(the)i(curren)m(t)f(\(or)g(default,)j(if)1110
|
||||
1263 y(line)h(editing)g(w)m(as)g(not)g(previously)f(activ)m(e\))k
|
||||
(editing)d(settings,)j(but)c(uses)1110 1373 y(Readline's)31
|
||||
b(default)g(\014lename)f(completion.)630 1526 y Ft(-i)g
|
||||
Fj(text)162 b Fu(If)36 b(Readline)i(is)f(b)s(eing)g(used)f(to)h(read)g
|
||||
(the)g(line,)j Fr(text)f Fu(is)e(placed)h(in)m(to)g(the)1110
|
||||
1636 y(editing)31 b(bu\013er)e(b)s(efore)h(editing)h(b)s(egins.)630
|
||||
1789 y Ft(-n)f Fj(nchars)66 b Ft(read)38 b Fu(returns)f(after)j
|
||||
(reading)f Fr(nc)m(hars)j Fu(c)m(haracters)e(rather)f(than)g(w)m
|
||||
(aiting)1110 1899 y(for)d(a)h(complete)h(line)f(of)g(input,)g(but)f
|
||||
(honors)g(a)h(delimiter)g(if)f(few)m(er)h(than)1110 2008
|
||||
y Fr(nc)m(hars)d Fu(c)m(haracters)e(are)e(read)h(b)s(efore)f(the)g
|
||||
(delimiter.)630 2162 y Ft(-N)g Fj(nchars)66 b Ft(read)39
|
||||
b Fu(returns)f(after)j(reading)e(exactly)j Fr(nc)m(hars)h
|
||||
Fu(c)m(haracters)f(rather)d(than)1110 2271 y(w)m(aiting)32
|
||||
b(for)f(a)g(complete)i(line)e(of)g(input,)g(unless)f(EOF)h(is)g(encoun)
|
||||
m(tered)g(or)1110 2381 y Ft(read)f Fu(times)i(out.)43
|
||||
b(Delimiter)33 b(c)m(haracters)f(encoun)m(tered)g(in)f(the)g(input)g
|
||||
(are)1110 2491 y(not)g(treated)h(sp)s(ecially)f(and)f(do)h(not)g(cause)
|
||||
g Ft(read)e Fu(to)j(return)d(un)m(til)i Fr(nc)m(hars)1110
|
||||
2600 y Fu(c)m(haracters)26 b(are)f(read.)38 b(The)24
|
||||
b(result)g(is)h(not)f(split)h(on)f(the)h(c)m(haracters)h(in)e
|
||||
Ft(IFS)p Fu(;)1110 2710 y(the)e(in)m(ten)m(t)i(is)e(that)h(the)f(v)-5
|
||||
b(ariable)23 b(is)f(assigned)g(exactly)i(the)e(c)m(haracters)i(read)
|
||||
1110 2580 y(\(with)30 b(the)h(exception)h(of)e(bac)m(kslash;)h(see)g
|
||||
(the)g Ft(-r)f Fu(option)h(b)s(elo)m(w\).)630 2730 y
|
||||
1110 2819 y(\(with)30 b(the)h(exception)h(of)e(bac)m(kslash;)h(see)g
|
||||
(the)g Ft(-r)f Fu(option)h(b)s(elo)m(w\).)630 2973 y
|
||||
Ft(-p)f Fj(prompt)66 b Fu(Displa)m(y)38 b Fr(prompt)p
|
||||
Fu(,)g(without)e(a)h(trailing)h(newline,)h(b)s(efore)d(attempting)i(to)
|
||||
1110 2839 y(read)f(an)m(y)h(input.)60 b(The)37 b(prompt)g(is)g(displa)m
|
||||
(y)m(ed)h(only)f(if)g(input)g(is)g(coming)1110 2949 y(from)30
|
||||
b(a)h(terminal.)630 3098 y Ft(-r)384 b Fu(If)21 b(this)h(option)g(is)f
|
||||
1110 3082 y(read)f(an)m(y)h(input.)60 b(The)37 b(prompt)g(is)g(displa)m
|
||||
(y)m(ed)h(only)f(if)g(input)g(is)g(coming)1110 3192 y(from)30
|
||||
b(a)h(terminal.)630 3345 y Ft(-r)384 b Fu(If)21 b(this)h(option)g(is)f
|
||||
(giv)m(en,)k(bac)m(kslash)d(do)s(es)f(not)h(act)h(as)f(an)f(escap)s(e)h
|
||||
(c)m(haracter.)1110 3208 y(The)30 b(bac)m(kslash)i(is)f(considered)g
|
||||
(c)m(haracter.)1110 3455 y(The)30 b(bac)m(kslash)i(is)f(considered)g
|
||||
(to)h(b)s(e)e(part)h(of)g(the)g(line.)43 b(In)30 b(particular,)i(a)1110
|
||||
3318 y(bac)m(kslash-newline)f(pair)f(ma)m(y)h(not)g(b)s(e)f(used)f(as)i
|
||||
(a)g(line)f(con)m(tin)m(uation.)630 3467 y Ft(-s)384
|
||||
3565 y(bac)m(kslash-newline)f(pair)f(ma)m(y)h(not)g(b)s(e)f(used)f(as)i
|
||||
(a)g(line)f(con)m(tin)m(uation.)630 3718 y Ft(-s)384
|
||||
b Fu(Silen)m(t)28 b(mo)s(de.)40 b(If)27 b(input)f(is)i(coming)g(from)f
|
||||
(a)h(terminal,)h(c)m(haracters)g(are)f(not)1110 3577
|
||||
y(ec)m(ho)s(ed.)630 3726 y Ft(-t)i Fj(timeout)1110 3836
|
||||
(a)h(terminal,)h(c)m(haracters)g(are)f(not)1110 3828
|
||||
y(ec)m(ho)s(ed.)630 3981 y Ft(-t)i Fj(timeout)1110 4091
|
||||
y Fu(Cause)42 b Ft(read)g Fu(to)h(time)h(out)f(and)f(return)f(failure)i
|
||||
(if)g(a)g(complete)h(line)f(of)1110 3945 y(input)26 b(\(or)h(a)g(sp)s
|
||||
(if)g(a)g(complete)h(line)f(of)1110 4200 y(input)26 b(\(or)h(a)g(sp)s
|
||||
(eci\014ed)f(n)m(um)m(b)s(er)g(of)h(c)m(haracters\))h(is)f(not)g(read)g
|
||||
(within)f Fr(time-)1110 4055 y(out)37 b Fu(seconds.)53
|
||||
(within)f Fr(time-)1110 4310 y(out)37 b Fu(seconds.)53
|
||||
b Fr(timeout)38 b Fu(ma)m(y)d(b)s(e)f(a)h(decimal)h(n)m(um)m(b)s(er)d
|
||||
(with)h(a)h(fractional)1110 4164 y(p)s(ortion)29 b(follo)m(wing)h(the)f
|
||||
(with)h(a)h(fractional)1110 4419 y(p)s(ortion)29 b(follo)m(wing)h(the)f
|
||||
(decimal)h(p)s(oin)m(t.)40 b(This)29 b(option)g(is)g(only)g(e\013ectiv)
|
||||
m(e)j(if)1110 4274 y Ft(read)j Fu(is)i(reading)g(input)e(from)h(a)h
|
||||
m(e)j(if)1110 4529 y Ft(read)j Fu(is)i(reading)g(input)e(from)h(a)h
|
||||
(terminal,)i(pip)s(e,)e(or)g(other)f(sp)s(ecial)i(\014le;)1110
|
||||
4384 y(it)31 b(has)g(no)g(e\013ect)h(when)e(reading)h(from)g(regular)g
|
||||
4639 y(it)31 b(has)g(no)g(e\013ect)h(when)e(reading)h(from)g(regular)g
|
||||
(\014les.)42 b(If)30 b Ft(read)g Fu(times)h(out,)1110
|
||||
4493 y Ft(read)d Fu(sa)m(v)m(es)j(an)m(y)f(partial)h(input)d(read)i(in)
|
||||
4748 y Ft(read)d Fu(sa)m(v)m(es)j(an)m(y)f(partial)h(input)d(read)i(in)
|
||||
m(to)h(the)e(sp)s(eci\014ed)g(v)-5 b(ariable)31 b Fr(name)p
|
||||
Fu(.)1110 4603 y(If)k Fr(timeout)j Fu(is)e(0,)h Ft(read)e
|
||||
Fu(.)1110 4858 y(If)k Fr(timeout)j Fu(is)e(0,)h Ft(read)e
|
||||
Fu(returns)f(immediately)-8 b(,)39 b(without)c(trying)h(to)g(read)1110
|
||||
4712 y(and)30 b(data.)44 b(The)30 b(exit)i(status)f(is)g(0)g(if)g
|
||||
4967 y(and)30 b(data.)44 b(The)30 b(exit)i(status)f(is)g(0)g(if)g
|
||||
(input)f(is)h(a)m(v)-5 b(ailable)34 b(on)c(the)i(sp)s(eci\014ed)1110
|
||||
4822 y(\014le)g(descriptor,)g(non-zero)h(otherwise.)46
|
||||
b(The)31 b(exit)i(status)f(is)g(greater)h(than)1110 4932
|
||||
y(128)f(if)e(the)h(timeout)g(is)f(exceeded.)630 5081
|
||||
5077 y(\014le)g(descriptor,)g(non-zero)h(otherwise.)46
|
||||
b(The)31 b(exit)i(status)f(is)g(greater)h(than)1110 5187
|
||||
y(128)f(if)e(the)h(timeout)g(is)f(exceeded.)630 5340
|
||||
y Ft(-u)g Fj(fd)258 b Fu(Read)31 b(input)e(from)h(\014le)g(descriptor)h
|
||||
Fr(fd)p Fu(.)150 5230 y Ft(readarray)870 5340 y(readarray)45
|
||||
b([-d)i Fj(delim)p Ft(])f([-n)h Fj(count)p Ft(])f([-O)h
|
||||
Fj(origin)p Ft(])f([-s)h Fj(count)p Ft(])f([-t])h([-u)g
|
||||
Fj(fd)p Ft(])p eop end
|
||||
Fr(fd)p Fu(.)p eop end
|
||||
%%Page: 59 65
|
||||
TeXDict begin 59 64 bop 150 -116 a Fu(Chapter)30 b(4:)41
|
||||
b(Shell)30 b(Builtin)h(Commands)2069 b(59)1061 299 y
|
||||
Ft([-C)47 b Fj(callback)p Ft(])e([-c)i Fj(quantum)p Ft(])f([)p
|
||||
Fj(array)p Ft(])630 433 y Fu(Read)38 b(lines)f(from)g(the)h(standard)e
|
||||
(input)g(in)m(to)j(the)e(indexed)g(arra)m(y)h(v)-5 b(ariable)38
|
||||
b Fr(arra)m(y)p Fu(,)i(or)630 543 y(from)30 b(\014le)g(descriptor)h
|
||||
Fr(fd)i Fu(if)d(the)h Ft(-u)e Fu(option)i(is)g(supplied.)630
|
||||
677 y(A)f(synon)m(ym)g(for)g Ft(mapfile)p Fu(.)150 836
|
||||
y Ft(source)870 971 y(source)46 b Fj(filename)630 1105
|
||||
y Fu(A)30 b(synon)m(ym)g(for)g Ft(.)g Fu(\(see)i(Section)f(4.1)g
|
||||
([Bourne)g(Shell)f(Builtins],)h(page)g(43\).)150 1264
|
||||
y Ft(type)870 1398 y(type)47 b([-afptP])e([)p Fj(name)i
|
||||
Ft(...)o(])630 1533 y Fu(F)-8 b(or)42 b(eac)m(h)g Fr(name)p
|
||||
Fu(,)i(indicate)e(ho)m(w)g(it)f(w)m(ould)g(b)s(e)g(in)m(terpreted)g(if)
|
||||
g(used)f(as)i(a)f(command)630 1642 y(name.)630 1777 y(If)g(the)g
|
||||
Ft(-t)g Fu(option)h(is)f(used,)j Ft(type)c Fu(prin)m(ts)h(a)h(single)g
|
||||
(w)m(ord)f(whic)m(h)g(is)g(one)h(of)g(`)p Ft(alias)p
|
||||
Fu(',)630 1886 y(`)p Ft(function)p Fu(',)32 b(`)p Ft(builtin)p
|
||||
Fu(',)g(`)p Ft(file)p Fu(')g(or)h(`)p Ft(keyword)p Fu(',)f(if)h
|
||||
Fr(name)38 b Fu(is)33 b(an)f(alias,)j(shell)e(function,)630
|
||||
1996 y(shell)i(builtin,)g(disk)g(\014le,)h(or)e(shell)h(reserv)m(ed)g
|
||||
(w)m(ord,)h(resp)s(ectiv)m(ely)-8 b(.)55 b(If)34 b(the)h
|
||||
Fr(name)40 b Fu(is)35 b(not)630 2105 y(found,)29 b(then)h(nothing)h(is)
|
||||
f(prin)m(ted,)g(and)g Ft(type)f Fu(returns)g(a)i(failure)g(status.)630
|
||||
2240 y(If)25 b(the)g Ft(-p)g Fu(option)h(is)f(used,)h
|
||||
Ft(type)e Fu(either)h(returns)g(the)g(name)g(of)h(the)f(disk)g(\014le)g
|
||||
(that)h(w)m(ould)630 2349 y(b)s(e)k(executed,)h(or)g(nothing)f(if)g
|
||||
b(Shell)30 b(Builtin)h(Commands)2069 b(59)150 299 y Ft(readarray)870
|
||||
408 y(readarray)45 b([-d)i Fj(delim)p Ft(])f([-n)h Fj(count)p
|
||||
Ft(])f([-O)h Fj(origin)p Ft(])f([-s)h Fj(count)p Ft(])f([-t])h([-u)g
|
||||
Fj(fd)p Ft(])1061 518 y([-C)g Fj(callback)p Ft(])e([-c)i
|
||||
Fj(quantum)p Ft(])f([)p Fj(array)p Ft(])630 650 y Fu(Read)38
|
||||
b(lines)f(from)g(the)h(standard)e(input)g(in)m(to)j(the)e(indexed)g
|
||||
(arra)m(y)h(v)-5 b(ariable)38 b Fr(arra)m(y)p Fu(,)i(or)630
|
||||
760 y(from)30 b(\014le)g(descriptor)h Fr(fd)i Fu(if)d(the)h
|
||||
Ft(-u)e Fu(option)i(is)g(supplied.)630 892 y(A)f(synon)m(ym)g(for)g
|
||||
Ft(mapfile)p Fu(.)150 1047 y Ft(source)870 1179 y(source)46
|
||||
b Fj(filename)630 1312 y Fu(A)30 b(synon)m(ym)g(for)g
|
||||
Ft(.)g Fu(\(see)i(Section)f(4.1)g([Bourne)g(Shell)f(Builtins],)h(page)g
|
||||
(43\).)150 1467 y Ft(type)870 1599 y(type)47 b([-afptP])e([)p
|
||||
Fj(name)i Ft(...)o(])630 1731 y Fu(F)-8 b(or)42 b(eac)m(h)g
|
||||
Fr(name)p Fu(,)i(indicate)e(ho)m(w)g(it)f(w)m(ould)g(b)s(e)g(in)m
|
||||
(terpreted)g(if)g(used)f(as)i(a)f(command)630 1841 y(name.)630
|
||||
1973 y(If)g(the)g Ft(-t)g Fu(option)h(is)f(used,)j Ft(type)c
|
||||
Fu(prin)m(ts)h(a)h(single)g(w)m(ord)f(whic)m(h)g(is)g(one)h(of)g(`)p
|
||||
Ft(alias)p Fu(',)630 2083 y(`)p Ft(function)p Fu(',)32
|
||||
b(`)p Ft(builtin)p Fu(',)g(`)p Ft(file)p Fu(')g(or)h(`)p
|
||||
Ft(keyword)p Fu(',)f(if)h Fr(name)38 b Fu(is)33 b(an)f(alias,)j(shell)e
|
||||
(function,)630 2192 y(shell)i(builtin,)g(disk)g(\014le,)h(or)e(shell)h
|
||||
(reserv)m(ed)g(w)m(ord,)h(resp)s(ectiv)m(ely)-8 b(.)55
|
||||
b(If)34 b(the)h Fr(name)40 b Fu(is)35 b(not)630 2302
|
||||
y(found,)29 b(then)h(nothing)h(is)f(prin)m(ted,)g(and)g
|
||||
Ft(type)f Fu(returns)g(a)i(failure)g(status.)630 2434
|
||||
y(If)25 b(the)g Ft(-p)g Fu(option)h(is)f(used,)h Ft(type)e
|
||||
Fu(either)h(returns)g(the)g(name)g(of)h(the)f(disk)g(\014le)g(that)h(w)
|
||||
m(ould)630 2544 y(b)s(e)k(executed,)h(or)g(nothing)f(if)g
|
||||
Ft(-t)g Fu(w)m(ould)g(not)h(return)e(`)p Ft(file)p Fu('.)630
|
||||
2484 y(The)h Ft(-P)g Fu(option)h(forces)g(a)g(path)f(searc)m(h)h(for)g
|
||||
2676 y(The)h Ft(-P)g Fu(option)h(forces)g(a)g(path)f(searc)m(h)h(for)g
|
||||
(eac)m(h)g Fr(name)p Fu(,)g(ev)m(en)g(if)g Ft(-t)f Fu(w)m(ould)g(not)h
|
||||
(return)630 2593 y(`)p Ft(file)p Fu('.)630 2728 y(If)f(a)g(command)g
|
||||
(return)630 2785 y(`)p Ft(file)p Fu('.)630 2918 y(If)f(a)g(command)g
|
||||
(is)g(hashed,)f Ft(-p)h Fu(and)f Ft(-P)g Fu(prin)m(t)h(the)g(hashed)f
|
||||
(v)-5 b(alue,)31 b(whic)m(h)f(is)g(not)g(neces-)630 2837
|
||||
(v)-5 b(alue,)31 b(whic)m(h)f(is)g(not)g(neces-)630 3027
|
||||
y(sarily)h(the)f(\014le)h(that)g(app)s(ears)e(\014rst)h(in)g
|
||||
Ft($PATH)p Fu(.)630 2971 y(If)22 b(the)i Ft(-a)e Fu(option)h(is)g
|
||||
Ft($PATH)p Fu(.)630 3160 y(If)22 b(the)i Ft(-a)e Fu(option)h(is)g
|
||||
(used,)h Ft(type)e Fu(returns)f(all)j(of)f(the)g(places)h(that)f(con)m
|
||||
(tain)i(an)d(executable)630 3081 y(named)32 b Fr(\014le)p
|
||||
(tain)i(an)d(executable)630 3269 y(named)32 b Fr(\014le)p
|
||||
Fu(.)49 b(This)32 b(includes)h(aliases)h(and)e(functions,)i(if)f(and)f
|
||||
(only)h(if)g(the)g Ft(-p)f Fu(option)i(is)630 3191 y(not)d(also)g
|
||||
(used.)630 3325 y(If)f(the)g Ft(-f)g Fu(option)g(is)h(used,)e
|
||||
(only)h(if)g(the)g Ft(-p)f Fu(option)i(is)630 3379 y(not)d(also)g
|
||||
(used.)630 3511 y(If)f(the)g Ft(-f)g Fu(option)g(is)h(used,)e
|
||||
Ft(type)g Fu(do)s(es)h(not)h(attempt)g(to)g(\014nd)d(shell)j
|
||||
(functions,)f(as)g(with)630 3435 y(the)h Ft(command)d
|
||||
Fu(builtin.)630 3569 y(The)j(return)f(status)h(is)g(zero)h(if)f(all)h
|
||||
(functions,)f(as)g(with)630 3621 y(the)h Ft(command)d
|
||||
Fu(builtin.)630 3753 y(The)j(return)f(status)h(is)g(zero)h(if)f(all)h
|
||||
(of)f(the)h Fr(names)i Fu(are)e(found,)e(non-zero)i(if)f(an)m(y)g(are)h
|
||||
(not)630 3678 y(found.)150 3838 y Ft(typeset)870 3972
|
||||
(not)630 3862 y(found.)150 4017 y Ft(typeset)870 4150
|
||||
y(typeset)46 b([-afFgrxilnrtux])d([-p])k([)p Fj(name)p
|
||||
Ft([=)p Fj(value)p Ft(])d(...)o(])630 4106 y Fu(The)31
|
||||
Ft([=)p Fj(value)p Ft(])d(...)o(])630 4282 y Fu(The)31
|
||||
b Ft(typeset)e Fu(command)i(is)g(supplied)f(for)h(compatibilit)m(y)i
|
||||
(with)e(the)g(Korn)f(shell.)44 b(It)31 b(is)630 4216
|
||||
(with)e(the)g(Korn)f(shell.)44 b(It)31 b(is)630 4391
|
||||
y(a)g(synon)m(ym)f(for)g(the)g Ft(declare)f Fu(builtin)h(command.)150
|
||||
4375 y Ft(ulimit)870 4509 y(ulimit)46 b([-HSabcdefiklmnpqrstuvxPT)o(])c
|
||||
([)p Fj(limit)p Ft(])630 4644 y(ulimit)25 b Fu(pro)m(vides)h(con)m
|
||||
4546 y Ft(ulimit)870 4679 y(ulimit)46 b([-HSabcdefiklmnpqrstuvxPT)o(])c
|
||||
([)p Fj(limit)p Ft(])630 4811 y(ulimit)25 b Fu(pro)m(vides)h(con)m
|
||||
(trol)i(o)m(v)m(er)g(the)f(resources)f(a)m(v)-5 b(ailable)29
|
||||
b(to)e(pro)s(cesses)f(started)h(b)m(y)g(the)630 4753
|
||||
b(to)e(pro)s(cesses)f(started)h(b)m(y)g(the)630 4921
|
||||
y(shell,)i(on)f(systems)g(that)h(allo)m(w)h(suc)m(h)e(con)m(trol.)41
|
||||
b(If)28 b(an)g(option)h(is)f(giv)m(en,)i(it)e(is)h(in)m(terpreted)630
|
||||
4863 y(as)i(follo)m(ws:)630 5022 y Ft(-S)384 b Fu(Change)30
|
||||
5030 y(as)i(follo)m(ws:)630 5185 y Ft(-S)384 b Fu(Change)30
|
||||
b(and)g(rep)s(ort)g(the)g(soft)h(limit)g(asso)s(ciated)h(with)e(a)h
|
||||
(resource.)630 5181 y Ft(-H)384 b Fu(Change)30 b(and)g(rep)s(ort)g(the)
|
||||
g(hard)g(limit)h(asso)s(ciated)h(with)e(a)h(resource.)630
|
||||
5340 y Ft(-a)384 b Fu(All)31 b(curren)m(t)f(limits)h(are)g(rep)s
|
||||
(orted.)p eop end
|
||||
(resource.)630 5340 y Ft(-H)384 b Fu(Change)30 b(and)g(rep)s(ort)g(the)
|
||||
g(hard)g(limit)h(asso)s(ciated)h(with)e(a)h(resource.)p
|
||||
eop end
|
||||
%%Page: 60 66
|
||||
TeXDict begin 60 65 bop 150 -116 a Fu(Chapter)30 b(4:)41
|
||||
b(Shell)30 b(Builtin)h(Commands)2069 b(60)630 299 y Ft(-b)384
|
||||
b Fu(The)30 b(maxim)m(um)g(so)s(c)m(k)m(et)i(bu\013er)e(size.)630
|
||||
462 y Ft(-c)384 b Fu(The)30 b(maxim)m(um)g(size)h(of)g(core)g(\014les)f
|
||||
(created.)630 625 y Ft(-d)384 b Fu(The)30 b(maxim)m(um)g(size)h(of)g(a)
|
||||
g(pro)s(cess's)f(data)h(segmen)m(t.)630 788 y Ft(-e)384
|
||||
b Fu(The)30 b(maxim)m(um)g(sc)m(heduling)h(priorit)m(y)f(\()p
|
||||
Ft(")p Fu(nice)p Ft(")p Fu(\).)630 951 y Ft(-f)384 b
|
||||
Fu(The)30 b(maxim)m(um)g(size)h(of)g(\014les)f(written)h(b)m(y)f(the)g
|
||||
(shell)h(and)f(its)h(c)m(hildren.)630 1114 y Ft(-i)384
|
||||
b(Shell)30 b(Builtin)h(Commands)2069 b(60)630 299 y Ft(-a)384
|
||||
b Fu(All)31 b(curren)m(t)f(limits)h(are)g(rep)s(orted.)630
|
||||
454 y Ft(-b)384 b Fu(The)30 b(maxim)m(um)g(so)s(c)m(k)m(et)i(bu\013er)e
|
||||
(size.)630 610 y Ft(-c)384 b Fu(The)30 b(maxim)m(um)g(size)h(of)g(core)
|
||||
g(\014les)f(created.)630 765 y Ft(-d)384 b Fu(The)30
|
||||
b(maxim)m(um)g(size)h(of)g(a)g(pro)s(cess's)f(data)h(segmen)m(t.)630
|
||||
921 y Ft(-e)384 b Fu(The)30 b(maxim)m(um)g(sc)m(heduling)h(priorit)m(y)
|
||||
f(\()p Ft(")p Fu(nice)p Ft(")p Fu(\).)630 1076 y Ft(-f)384
|
||||
b Fu(The)30 b(maxim)m(um)g(size)h(of)g(\014les)f(written)h(b)m(y)f(the)
|
||||
g(shell)h(and)f(its)h(c)m(hildren.)630 1232 y Ft(-i)384
|
||||
b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(p)s(ending)e
|
||||
(signals.)630 1277 y Ft(-k)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s
|
||||
(signals.)630 1387 y Ft(-k)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s
|
||||
(er)f(of)i(kqueues)f(that)h(ma)m(y)g(b)s(e)e(allo)s(cated.)630
|
||||
1440 y Ft(-l)384 b Fu(The)30 b(maxim)m(um)g(size)h(that)g(ma)m(y)g(b)s
|
||||
(e)f(lo)s(c)m(k)m(ed)i(in)m(to)f(memory)-8 b(.)630 1603
|
||||
1543 y Ft(-l)384 b Fu(The)30 b(maxim)m(um)g(size)h(that)g(ma)m(y)g(b)s
|
||||
(e)f(lo)s(c)m(k)m(ed)i(in)m(to)f(memory)-8 b(.)630 1698
|
||||
y Ft(-m)384 b Fu(The)36 b(maxim)m(um)g(residen)m(t)h(set)g(size)g
|
||||
(\(man)m(y)g(systems)f(do)h(not)f(honor)g(this)1110 1713
|
||||
y(limit\).)630 1876 y Ft(-n)384 b Fu(The)38 b(maxim)m(um)h(n)m(um)m(b)s
|
||||
(\(man)m(y)g(systems)f(do)h(not)f(honor)g(this)1110 1808
|
||||
y(limit\).)630 1963 y Ft(-n)384 b Fu(The)38 b(maxim)m(um)h(n)m(um)m(b)s
|
||||
(er)e(of)i(op)s(en)f(\014le)h(descriptors)g(\(most)g(systems)g(do)1110
|
||||
1985 y(not)31 b(allo)m(w)g(this)g(v)-5 b(alue)31 b(to)g(b)s(e)e(set\).)
|
||||
630 2149 y Ft(-p)384 b Fu(The)30 b(pip)s(e)f(bu\013er)h(size.)630
|
||||
2312 y Ft(-q)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(b)m
|
||||
(ytes)g(in)f(POSIX)f(message)j(queues.)630 2475 y Ft(-r)384
|
||||
2073 y(not)31 b(allo)m(w)g(this)g(v)-5 b(alue)31 b(to)g(b)s(e)e(set\).)
|
||||
630 2228 y Ft(-p)384 b Fu(The)30 b(pip)s(e)f(bu\013er)h(size.)630
|
||||
2384 y Ft(-q)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(b)m
|
||||
(ytes)g(in)f(POSIX)f(message)j(queues.)630 2539 y Ft(-r)384
|
||||
b Fu(The)30 b(maxim)m(um)g(real-time)i(sc)m(heduling)f(priorit)m(y)-8
|
||||
b(.)630 2638 y Ft(-s)384 b Fu(The)30 b(maxim)m(um)g(stac)m(k)i(size.)
|
||||
630 2801 y Ft(-t)384 b Fu(The)30 b(maxim)m(um)g(amoun)m(t)h(of)f(cpu)g
|
||||
(time)h(in)f(seconds.)630 2964 y Ft(-u)384 b Fu(The)30
|
||||
b(.)630 2695 y Ft(-s)384 b Fu(The)30 b(maxim)m(um)g(stac)m(k)i(size.)
|
||||
630 2850 y Ft(-t)384 b Fu(The)30 b(maxim)m(um)g(amoun)m(t)h(of)f(cpu)g
|
||||
(time)h(in)f(seconds.)630 3005 y Ft(-u)384 b Fu(The)30
|
||||
b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(pro)s(cesses)f(a)m(v)-5
|
||||
b(ailable)33 b(to)e(a)f(single)i(user.)630 3127 y Ft(-v)384
|
||||
b(ailable)33 b(to)e(a)f(single)i(user.)630 3161 y Ft(-v)384
|
||||
b Fu(The)41 b(maxim)m(um)h(amoun)m(t)g(of)h(virtual)f(memory)g(a)m(v)-5
|
||||
b(ailable)44 b(to)e(the)g(shell,)1110 3236 y(and,)30
|
||||
b(ailable)44 b(to)e(the)g(shell,)1110 3271 y(and,)30
|
||||
b(on)g(some)h(systems,)g(to)g(its)g(c)m(hildren.)630
|
||||
3399 y Ft(-x)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i
|
||||
(\014le)f(lo)s(c)m(ks.)630 3562 y Ft(-P)384 b Fu(The)30
|
||||
3426 y Ft(-x)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i
|
||||
(\014le)f(lo)s(c)m(ks.)630 3581 y Ft(-P)384 b Fu(The)30
|
||||
b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(pseudoterminals.)630
|
||||
3726 y Ft(-T)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i
|
||||
(threads.)630 3889 y(If)36 b Fr(limit)k Fu(is)c(giv)m(en,)k(and)c(the)h
|
||||
3737 y Ft(-T)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i
|
||||
(threads.)630 3892 y(If)36 b Fr(limit)k Fu(is)c(giv)m(en,)k(and)c(the)h
|
||||
Ft(-a)f Fu(option)h(is)f(not)h(used,)h Fr(limit)h Fu(is)e(the)g(new)f
|
||||
(v)-5 b(alue)37 b(of)g(the)630 3998 y(sp)s(eci\014ed)c(resource.)51
|
||||
(v)-5 b(alue)37 b(of)g(the)630 4002 y(sp)s(eci\014ed)c(resource.)51
|
||||
b(The)34 b(sp)s(ecial)g Fr(limit)j Fu(v)-5 b(alues)34
|
||||
b Ft(hard)p Fu(,)g Ft(soft)p Fu(,)g(and)f Ft(unlimited)e
|
||||
Fu(stand)630 4108 y(for)h(the)g(curren)m(t)g(hard)f(limit,)i(the)g
|
||||
Fu(stand)630 4112 y(for)h(the)g(curren)m(t)g(hard)f(limit,)i(the)g
|
||||
(curren)m(t)f(soft)g(limit,)h(and)f(no)g(limit,)h(resp)s(ectiv)m(ely)-8
|
||||
b(.)48 b(A)630 4217 y(hard)37 b(limit)h(cannot)h(b)s(e)e(increased)h(b)
|
||||
b(.)48 b(A)630 4221 y(hard)37 b(limit)h(cannot)h(b)s(e)e(increased)h(b)
|
||||
m(y)f(a)h(non-ro)s(ot)g(user)f(once)i(it)f(is)g(set;)k(a)c(soft)g
|
||||
(limit)630 4327 y(ma)m(y)j(b)s(e)e(increased)i(up)e(to)h(the)h(v)-5
|
||||
(limit)630 4331 y(ma)m(y)j(b)s(e)e(increased)i(up)e(to)h(the)h(v)-5
|
||||
b(alue)40 b(of)g(the)h(hard)e(limit.)70 b(Otherwise,)43
|
||||
b(the)d(curren)m(t)630 4437 y(v)-5 b(alue)29 b(of)h(the)f(soft)g(limit)
|
||||
b(the)d(curren)m(t)630 4440 y(v)-5 b(alue)29 b(of)h(the)f(soft)g(limit)
|
||||
h(for)e(the)h(sp)s(eci\014ed)g(resource)g(is)g(prin)m(ted,)g(unless)f
|
||||
(the)h Ft(-H)f Fu(option)630 4546 y(is)h(supplied.)39
|
||||
(the)h Ft(-H)f Fu(option)630 4550 y(is)h(supplied.)39
|
||||
b(When)29 b(setting)h(new)f(limits,)h(if)f(neither)g
|
||||
Ft(-H)g Fu(nor)f Ft(-S)h Fu(is)g(supplied,)f(b)s(oth)h(the)630
|
||||
4656 y(hard)i(and)h(soft)h(limits)g(are)f(set.)48 b(If)31
|
||||
4660 y(hard)i(and)h(soft)h(limits)g(are)f(set.)48 b(If)31
|
||||
b(no)i(option)f(is)h(giv)m(en,)h(then)e Ft(-f)g Fu(is)g(assumed.)46
|
||||
b(V)-8 b(alues)630 4765 y(are)31 b(in)f(1024-b)m(yte)j(incremen)m(ts,)e
|
||||
b(V)-8 b(alues)630 4769 y(are)31 b(in)f(1024-b)m(yte)j(incremen)m(ts,)e
|
||||
(except)g(for)f Ft(-t)p Fu(,)g(whic)m(h)g(is)g(in)g(seconds;)h
|
||||
Ft(-p)p Fu(,)f(whic)m(h)g(is)g(in)630 4875 y(units)h(of)g(512-b)m(yte)j
|
||||
Ft(-p)p Fu(,)f(whic)m(h)g(is)g(in)630 4879 y(units)h(of)g(512-b)m(yte)j
|
||||
(blo)s(c)m(ks;)e Ft(-P)p Fu(,)f Ft(-T)p Fu(,)h Ft(-b)p
|
||||
Fu(,)f Ft(-k)p Fu(,)g Ft(-n)g Fu(and)f Ft(-u)p Fu(,)h(whic)m(h)h(are)f
|
||||
(unscaled)g(v)-5 b(alues;)630 4984 y(and,)31 b(when)f(in)g
|
||||
(unscaled)g(v)-5 b(alues;)630 4988 y(and,)31 b(when)f(in)g
|
||||
Fm(posix)g Fu(Mo)s(de)h(\(see)h(Section)g(6.11)g([Bash)g(POSIX)e(Mo)s
|
||||
(de],)h(page)h(98\),)h Ft(-c)630 5094 y Fu(and)d Ft(-f)p
|
||||
(de],)h(page)h(98\),)h Ft(-c)630 5098 y Fu(and)d Ft(-f)p
|
||||
Fu(,)g(whic)m(h)g(are)h(in)f(512-b)m(yte)i(incremen)m(ts.)630
|
||||
5230 y(The)i(return)g(status)h(is)f(zero)i(unless)e(an)g(in)m(v)-5
|
||||
b(alid)36 b(option)f(or)f(argumen)m(t)i(is)e(supplied,)h(or)630
|
||||
@@ -12884,111 +12892,117 @@ b(If)41 b(an)m(y)g(jobs)f(are)i(running,)g(this)f(causes)1110
|
||||
(command)f(\(see)h(Chapter)e(7)h([Job)g(Con)m(trol],)i(page)f(102\).)40
|
||||
b(The)1110 2436 y(shell)31 b(alw)m(a)m(ys)g(p)s(ostp)s(ones)f(exiting)h
|
||||
(if)g(an)m(y)f(jobs)g(are)h(stopp)s(ed.)630 2600 y Ft(checkwinsize)1110
|
||||
2710 y Fu(If)41 b(set,)k(Bash)c(c)m(hec)m(ks)i(the)f(windo)m(w)e(size)j
|
||||
(after)f(eac)m(h)g(command)f(and,)j(if)1110 2819 y(necessary)-8
|
||||
b(,)31 b(up)s(dates)f(the)g(v)-5 b(alues)31 b(of)g Ft(LINES)e
|
||||
Fu(and)g Ft(COLUMNS)p Fu(.)630 2984 y Ft(cmdhist)144
|
||||
2710 y Fu(If)23 b(set,)j(Bash)e(c)m(hec)m(ks)h(the)f(windo)m(w)f(size)h
|
||||
(after)h(eac)m(h)f(external)h(\(non-builtin\))1110 2819
|
||||
y(command)55 b(and,)60 b(if)55 b(necessary)-8 b(,)62
|
||||
b(up)s(dates)54 b(the)h(v)-5 b(alues)55 b(of)g Ft(LINES)f
|
||||
Fu(and)1110 2929 y Ft(COLUMNS)p Fu(.)630 3093 y Ft(cmdhist)144
|
||||
b Fu(If)33 b(set,)j(Bash)e(attempts)h(to)g(sa)m(v)m(e)g(all)g(lines)f
|
||||
(of)g(a)h(m)m(ultiple-line)g(command)1110 3093 y(in)c(the)g(same)g
|
||||
(of)g(a)h(m)m(ultiple-line)g(command)1110 3203 y(in)c(the)g(same)g
|
||||
(history)g(en)m(try)-8 b(.)42 b(This)30 b(allo)m(ws)i(easy)g
|
||||
(re-editing)g(of)f(m)m(ulti-line)1110 3203 y(commands.)630
|
||||
3367 y Ft(compat31)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s
|
||||
(eha)m(vior)f(to)i(that)f(of)f(v)m(ersion)h(3.1)h(with)e(resp)s(ect)
|
||||
1110 3477 y(to)39 b(quoted)f(argumen)m(ts)g(to)h(the)f(conditional)h
|
||||
(command's)f(`)p Ft(=~)p Fu(')g(op)s(erator)1110 3587
|
||||
(re-editing)g(of)f(m)m(ulti-line)1110 3313 y(commands.)79
|
||||
b(This)43 b(option)g(is)h(enabled)f(b)m(y)g(default,)k(but)c(only)g
|
||||
(has)g(an)1110 3422 y(e\013ect)30 b(if)e(command)g(history)g(is)h
|
||||
(enabled)f(\(see)h(Section)g(9.1)h([Bash)e(History)1110
|
||||
3532 y(F)-8 b(acilities],)34 b(page)d(140\).)630 3696
|
||||
y Ft(compat31)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s(eha)
|
||||
m(vior)f(to)i(that)f(of)f(v)m(ersion)h(3.1)h(with)e(resp)s(ect)1110
|
||||
3806 y(to)39 b(quoted)f(argumen)m(ts)g(to)h(the)f(conditional)h
|
||||
(command's)f(`)p Ft(=~)p Fu(')g(op)s(erator)1110 3915
|
||||
y(and)i(with)f(resp)s(ect)i(to)g(lo)s(cale-sp)s(eci\014c)h(string)e
|
||||
(comparison)g(when)f(using)1110 3696 y(the)31 b Ft([[)e
|
||||
(comparison)g(when)f(using)1110 4025 y(the)31 b Ft([[)e
|
||||
Fu(conditional)j(command's)e(`)p Ft(<)p Fu(')h(and)f(`)p
|
||||
Ft(>)p Fu(')g(op)s(erators.)41 b(Bash)31 b(v)m(ersions)1110
|
||||
3806 y(prior)g(to)h(bash-4.1)g(use)g(ASCI)s(I)e(collation)j(and)e
|
||||
(strcmp\(3\);)i(bash-4.1)g(and)1110 3915 y(later)e(use)f(the)h(curren)m
|
||||
4134 y(prior)g(to)h(bash-4.1)g(use)g(ASCI)s(I)e(collation)j(and)e
|
||||
(strcmp\(3\);)i(bash-4.1)g(and)1110 4244 y(later)e(use)f(the)h(curren)m
|
||||
(t)f(lo)s(cale's)i(collation)h(sequence)e(and)f(strcoll\(3\).)630
|
||||
4080 y Ft(compat32)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s
|
||||
4408 y Ft(compat32)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s
|
||||
(eha)m(vior)f(to)i(that)f(of)f(v)m(ersion)h(3.2)h(with)e(resp)s(ect)
|
||||
1110 4189 y(to)34 b(lo)s(cale-sp)s(eci\014c)h(string)e(comparison)g
|
||||
(when)f(using)h(the)g Ft([[)g Fu(conditional)1110 4299
|
||||
1110 4518 y(to)34 b(lo)s(cale-sp)s(eci\014c)h(string)e(comparison)g
|
||||
(when)f(using)h(the)g Ft([[)g Fu(conditional)1110 4628
|
||||
y(command's)21 b(`)p Ft(<)p Fu(')g(and)f(`)p Ft(>)p Fu(')h(op)s
|
||||
(erators)g(\(see)h(previous)e(item\))i(and)e(the)h(e\013ect)i(of)1110
|
||||
4408 y(in)m(terrupting)h(a)h(command)e(list.)40 b(Bash)24
|
||||
4737 y(in)m(terrupting)h(a)h(command)e(list.)40 b(Bash)24
|
||||
b(v)m(ersions)h(3.2)g(and)f(earlier)h(con)m(tin)m(ue)1110
|
||||
4518 y(with)33 b(the)g(next)g(command)g(in)g(the)g(list)h(after)f(one)h
|
||||
(terminates)g(due)e(to)i(an)1110 4628 y(in)m(terrupt.)630
|
||||
4792 y Ft(compat40)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s
|
||||
4847 y(with)33 b(the)g(next)g(command)g(in)g(the)g(list)h(after)f(one)h
|
||||
(terminates)g(due)e(to)i(an)1110 4956 y(in)m(terrupt.)630
|
||||
5121 y Ft(compat40)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s
|
||||
(eha)m(vior)f(to)i(that)f(of)f(v)m(ersion)h(4.0)h(with)e(resp)s(ect)
|
||||
1110 4902 y(to)34 b(lo)s(cale-sp)s(eci\014c)h(string)e(comparison)g
|
||||
(when)f(using)h(the)g Ft([[)g Fu(conditional)1110 5011
|
||||
1110 5230 y(to)34 b(lo)s(cale-sp)s(eci\014c)h(string)e(comparison)g
|
||||
(when)f(using)h(the)g Ft([[)g Fu(conditional)1110 5340
|
||||
y(command's)28 b(`)p Ft(<)p Fu(')h(and)f(`)p Ft(>)p Fu(')h(op)s
|
||||
(erators)f(\(see)i(description)e(of)h Ft(compat31)p Fu(\))e(and)1110
|
||||
5121 y(the)38 b(e\013ect)i(of)e(in)m(terrupting)f(a)i(command)e(list.)
|
||||
64 b(Bash)38 b(v)m(ersions)h(4.0)g(and)1110 5230 y(later)24
|
||||
b(in)m(terrupt)f(the)g(list)h(as)g(if)f(the)h(shell)f(receiv)m(ed)i
|
||||
(the)e(in)m(terrupt;)i(previous)1110 5340 y(v)m(ersions)31
|
||||
b(con)m(tin)m(ue)g(with)f(the)h(next)g(command)f(in)g(the)g(list.)p
|
||||
(erators)f(\(see)i(description)e(of)h Ft(compat31)p Fu(\))e(and)p
|
||||
eop end
|
||||
%%Page: 67 73
|
||||
TeXDict begin 67 72 bop 150 -116 a Fu(Chapter)30 b(4:)41
|
||||
b(Shell)30 b(Builtin)h(Commands)2069 b(67)630 299 y Ft(compat41)96
|
||||
b Fu(If)25 b(set,)j(Bash,)e(when)f(in)g Fm(posix)g Fu(mo)s(de,)i
|
||||
(treats)f(a)g(single)h(quote)f(in)f(a)h(double-)1110
|
||||
408 y(quoted)46 b(parameter)h(expansion)f(as)g(a)h(sp)s(ecial)f(c)m
|
||||
(haracter.)90 b(The)45 b(single)1110 518 y(quotes)34
|
||||
b(m)m(ust)g(matc)m(h)h(\(an)f(ev)m(en)h(n)m(um)m(b)s(er\))e(and)g(the)h
|
||||
(c)m(haracters)h(b)s(et)m(w)m(een)1110 628 y(the)40 b(single)g(quotes)g
|
||||
(are)g(considered)g(quoted.)69 b(This)38 b(is)i(the)g(b)s(eha)m(vior)g
|
||||
(of)1110 737 y Fm(posix)f Fu(mo)s(de)g(through)g(v)m(ersion)h(4.1.)69
|
||||
b(Shell)30 b(Builtin)h(Commands)2069 b(67)1110 299 y(the)38
|
||||
b(e\013ect)i(of)e(in)m(terrupting)f(a)i(command)e(list.)64
|
||||
b(Bash)38 b(v)m(ersions)h(4.0)g(and)1110 408 y(later)24
|
||||
b(in)m(terrupt)f(the)g(list)h(as)g(if)f(the)h(shell)f(receiv)m(ed)i
|
||||
(the)e(in)m(terrupt;)i(previous)1110 518 y(v)m(ersions)31
|
||||
b(con)m(tin)m(ue)g(with)f(the)h(next)g(command)f(in)g(the)g(list.)630
|
||||
669 y Ft(compat41)96 b Fu(If)25 b(set,)j(Bash,)e(when)f(in)g
|
||||
Fm(posix)g Fu(mo)s(de,)i(treats)f(a)g(single)h(quote)f(in)f(a)h
|
||||
(double-)1110 778 y(quoted)46 b(parameter)h(expansion)f(as)g(a)h(sp)s
|
||||
(ecial)f(c)m(haracter.)90 b(The)45 b(single)1110 888
|
||||
y(quotes)34 b(m)m(ust)g(matc)m(h)h(\(an)f(ev)m(en)h(n)m(um)m(b)s(er\))e
|
||||
(and)g(the)h(c)m(haracters)h(b)s(et)m(w)m(een)1110 998
|
||||
y(the)40 b(single)g(quotes)g(are)g(considered)g(quoted.)69
|
||||
b(This)38 b(is)i(the)g(b)s(eha)m(vior)g(of)1110 1107
|
||||
y Fm(posix)f Fu(mo)s(de)g(through)g(v)m(ersion)h(4.1.)69
|
||||
b(The)39 b(default)g(Bash)h(b)s(eha)m(vior)g(re-)1110
|
||||
847 y(mains)30 b(as)h(in)f(previous)g(v)m(ersions.)630
|
||||
1050 y Ft(compat42)96 b Fu(If)29 b(set,)i(Bash)f(do)s(es)f(not)h(pro)s
|
||||
1217 y(mains)30 b(as)h(in)f(previous)g(v)m(ersions.)630
|
||||
1367 y Ft(compat42)96 b Fu(If)29 b(set,)i(Bash)f(do)s(es)f(not)h(pro)s
|
||||
(cess)g(the)g(replacemen)m(t)h(string)e(in)h(the)g(pattern)1110
|
||||
1160 y(substitution)g(w)m(ord)g(expansion)g(using)g(quote)h(remo)m(v)-5
|
||||
b(al.)630 1363 y Ft(compat43)96 b Fu(If)24 b(set,)j(Bash)e(do)s(es)g
|
||||
1477 y(substitution)g(w)m(ord)g(expansion)g(using)g(quote)h(remo)m(v)-5
|
||||
b(al.)630 1628 y Ft(compat43)96 b Fu(If)24 b(set,)j(Bash)e(do)s(es)g
|
||||
(not)g(prin)m(t)g(a)g(w)m(arning)g(message)h(if)f(an)g(attempt)h(is)f
|
||||
(made)1110 1473 y(to)43 b(use)g(a)g(quoted)f(comp)s(ound)f(arra)m(y)i
|
||||
(assignmen)m(t)h(as)f(an)f(argumen)m(t)h(to)1110 1583
|
||||
(made)1110 1737 y(to)43 b(use)g(a)g(quoted)f(comp)s(ound)f(arra)m(y)i
|
||||
(assignmen)m(t)h(as)f(an)f(argumen)m(t)h(to)1110 1847
|
||||
y Ft(declare)p Fu(,)31 b(mak)m(es)i(w)m(ord)f(expansion)g(errors)g
|
||||
(non-fatal)i(errors)d(that)i(cause)1110 1692 y(the)28
|
||||
(non-fatal)i(errors)d(that)i(cause)1110 1956 y(the)28
|
||||
b(curren)m(t)h(command)f(to)h(fail)g(\(the)f(default)h(b)s(eha)m(vior)f
|
||||
(is)h(to)g(mak)m(e)g(them)1110 1802 y(fatal)42 b(errors)e(that)i(cause)
|
||||
(is)h(to)g(mak)m(e)g(them)1110 2066 y(fatal)42 b(errors)e(that)i(cause)
|
||||
f(the)h(shell)f(to)g(exit\),)k(and)c(do)s(es)f(not)h(reset)h(the)1110
|
||||
1911 y(lo)s(op)34 b(state)h(when)f(a)g(shell)g(function)g(is)g
|
||||
2176 y(lo)s(op)34 b(state)h(when)f(a)g(shell)g(function)g(is)g
|
||||
(executed)h(\(this)f(allo)m(ws)h Ft(break)e Fu(or)1110
|
||||
2021 y Ft(continue)25 b Fu(in)j(a)g(shell)g(function)f(to)i(a\013ect)g
|
||||
(lo)s(ops)f(in)f(the)h(caller's)h(con)m(text\).)630 2225
|
||||
y Ft(complete_fullquote)1110 2334 y Fu(If)i(set,)g(Bash)h(quotes)f(all)
|
||||
2285 y Ft(continue)25 b Fu(in)j(a)g(shell)g(function)f(to)i(a\013ect)g
|
||||
(lo)s(ops)f(in)f(the)h(caller's)h(con)m(text\).)630 2436
|
||||
y Ft(complete_fullquote)1110 2545 y Fu(If)i(set,)g(Bash)h(quotes)f(all)
|
||||
h(shell)f(metac)m(haracters)i(in)e(\014lenames)g(and)g(direc-)1110
|
||||
2444 y(tory)g(names)f(when)g(p)s(erforming)f(completion.)43
|
||||
b(If)30 b(not)h(set,)g(Bash)g(remo)m(v)m(es)1110 2553
|
||||
2655 y(tory)g(names)f(when)g(p)s(erforming)f(completion.)43
|
||||
b(If)30 b(not)h(set,)g(Bash)g(remo)m(v)m(es)1110 2765
|
||||
y(metac)m(haracters)40 b(suc)m(h)d(as)h(the)g(dollar)g(sign)g(from)f
|
||||
(the)h(set)g(of)f(c)m(haracters)1110 2663 y(that)f(will)g(b)s(e)f
|
||||
(the)h(set)g(of)f(c)m(haracters)1110 2874 y(that)f(will)g(b)s(e)f
|
||||
(quoted)g(in)g(completed)i(\014lenames)e(when)f(these)i(metac)m(har-)
|
||||
1110 2772 y(acters)29 b(app)s(ear)e(in)g(shell)h(v)-5
|
||||
1110 2984 y(acters)29 b(app)s(ear)e(in)g(shell)h(v)-5
|
||||
b(ariable)28 b(references)g(in)f(w)m(ords)g(to)i(b)s(e)e(completed.)
|
||||
1110 2882 y(This)k(means)i(that)g(dollar)f(signs)g(in)g(v)-5
|
||||
1110 3093 y(This)k(means)i(that)g(dollar)f(signs)g(in)g(v)-5
|
||||
b(ariable)33 b(names)g(that)f(expand)g(to)h(di-)1110
|
||||
2992 y(rectories)28 b(will)g(not)f(b)s(e)f(quoted;)j(ho)m(w)m(ev)m(er,)
|
||||
g(an)m(y)e(dollar)h(signs)f(app)s(earing)f(in)1110 3101
|
||||
3203 y(rectories)28 b(will)g(not)f(b)s(e)f(quoted;)j(ho)m(w)m(ev)m(er,)
|
||||
g(an)m(y)e(dollar)h(signs)f(app)s(earing)f(in)1110 3313
|
||||
y(\014lenames)j(will)h(not)f(b)s(e)g(quoted,)h(either.)41
|
||||
b(This)28 b(is)i(activ)m(e)h(only)e(when)g(bash)1110
|
||||
3211 y(is)39 b(using)f(bac)m(kslashes)i(to)g(quote)g(completed)f
|
||||
(\014lenames.)67 b(This)38 b(v)-5 b(ariable)1110 3320
|
||||
3422 y(is)39 b(using)f(bac)m(kslashes)i(to)g(quote)g(completed)f
|
||||
(\014lenames.)67 b(This)38 b(v)-5 b(ariable)1110 3532
|
||||
y(is)41 b(set)g(b)m(y)g(default,)j(whic)m(h)c(is)h(the)g(default)g
|
||||
(Bash)g(b)s(eha)m(vior)g(in)g(v)m(ersions)1110 3430 y(through)30
|
||||
b(4.2.)630 3634 y Ft(direxpand)1110 3743 y Fu(If)k(set,)i(Bash)f
|
||||
(Bash)g(b)s(eha)m(vior)g(in)g(v)m(ersions)1110 3641 y(through)30
|
||||
b(4.2.)630 3792 y Ft(direxpand)1110 3902 y Fu(If)k(set,)i(Bash)f
|
||||
(replaces)g(directory)g(names)g(with)f(the)g(results)h(of)f(w)m(ord)g
|
||||
(ex-)1110 3853 y(pansion)k(when)g(p)s(erforming)f(\014lename)i
|
||||
(completion.)67 b(This)38 b(c)m(hanges)i(the)1110 3962
|
||||
(ex-)1110 4011 y(pansion)k(when)g(p)s(erforming)f(\014lename)i
|
||||
(completion.)67 b(This)38 b(c)m(hanges)i(the)1110 4121
|
||||
y(con)m(ten)m(ts)29 b(of)e(the)g(readline)h(editing)g(bu\013er.)38
|
||||
b(If)27 b(not)g(set,)i(Bash)e(attempts)h(to)1110 4072
|
||||
b(If)27 b(not)g(set,)i(Bash)e(attempts)h(to)1110 4230
|
||||
y(preserv)m(e)j(what)f(the)g(user)g(t)m(yp)s(ed.)630
|
||||
4275 y Ft(dirspell)96 b Fu(If)26 b(set,)i(Bash)f(attempts)g(sp)s
|
||||
4381 y Ft(dirspell)96 b Fu(If)26 b(set,)i(Bash)f(attempts)g(sp)s
|
||||
(elling)g(correction)g(on)g(directory)g(names)f(during)1110
|
||||
4385 y(w)m(ord)36 b(completion)h(if)f(the)g(directory)g(name)g
|
||||
(initially)h(supplied)e(do)s(es)h(not)1110 4495 y(exist.)630
|
||||
4698 y Ft(dotglob)144 b Fu(If)36 b(set,)i(Bash)e(includes)g
|
||||
4491 y(w)m(ord)36 b(completion)h(if)f(the)g(directory)g(name)g
|
||||
(initially)h(supplied)e(do)s(es)h(not)1110 4600 y(exist.)630
|
||||
4751 y Ft(dotglob)144 b Fu(If)36 b(set,)i(Bash)e(includes)g
|
||||
(\014lenames)g(b)s(eginning)f(with)h(a)g(`.')58 b(in)36
|
||||
b(the)g(results)1110 4808 y(of)f(\014lename)f(expansion.)53
|
||||
b(the)g(results)1110 4861 y(of)f(\014lename)f(expansion.)53
|
||||
b(The)33 b(\014lenames)i(`)p Ft(.)p Fu(')f(and)g(`)p
|
||||
Ft(..)p Fu(')g(m)m(ust)h(alw)m(a)m(ys)h(b)s(e)1110 4917
|
||||
Ft(..)p Fu(')g(m)m(ust)h(alw)m(a)m(ys)h(b)s(e)1110 4970
|
||||
y(matc)m(hed)31 b(explicitly)-8 b(,)33 b(ev)m(en)e(if)f
|
||||
Ft(dotglob)f Fu(is)h(set.)630 5121 y Ft(execfail)96 b
|
||||
Fu(If)24 b(this)h(is)f(set,)j(a)e(non-in)m(teractiv)m(e)i(shell)e(will)
|
||||
@@ -13126,95 +13140,100 @@ Ft(cmdhist)e Fu(option)j(is)f(enabled,)i(m)m(ulti-line)f(commands)1110
|
||||
b(separators)f(where)e(p)s(ossible.)p eop end
|
||||
%%Page: 70 76
|
||||
TeXDict begin 70 75 bop 150 -116 a Fu(Chapter)30 b(4:)41
|
||||
b(Shell)30 b(Builtin)h(Commands)2069 b(70)630 299 y Ft(login_shell)1110
|
||||
408 y Fu(The)35 b(shell)h(sets)g(this)f(option)h(if)g(it)g(is)f
|
||||
(started)h(as)g(a)g(login)g(shell)g(\(see)g(Sec-)1110
|
||||
518 y(tion)29 b(6.1)g([In)m(v)m(oking)h(Bash],)f(page)g(84\).)41
|
||||
b(The)28 b(v)-5 b(alue)29 b(ma)m(y)g(not)f(b)s(e)g(c)m(hanged.)630
|
||||
682 y Ft(mailwarn)96 b Fu(If)34 b(set,)i(and)e(a)h(\014le)g(that)g
|
||||
b(Shell)30 b(Builtin)h(Commands)2069 b(70)630 299 y Ft
|
||||
(localvar_inherit)1110 408 y Fu(If)32 b(set,)h(lo)s(cal)g(v)-5
|
||||
b(ariables)33 b(inherit)f(the)g(v)-5 b(alue)32 b(and)g(attributes)h(of)
|
||||
f(a)g(v)-5 b(ariable)1110 518 y(of)36 b(the)g(same)g(name)g(that)h
|
||||
(exists)f(at)h(a)f(previous)g(scop)s(e)g(b)s(efore)f(an)m(y)h(new)1110
|
||||
628 y(v)-5 b(alue)31 b(is)f(assigned.)41 b(The)30 b Fr(nameref)48
|
||||
b Fu(attribute)31 b(is)f(not)h(inherited.)630 792 y Ft(login_shell)1110
|
||||
902 y Fu(The)k(shell)h(sets)g(this)f(option)h(if)g(it)g(is)f(started)h
|
||||
(as)g(a)g(login)g(shell)g(\(see)g(Sec-)1110 1011 y(tion)29
|
||||
b(6.1)g([In)m(v)m(oking)h(Bash],)f(page)g(84\).)41 b(The)28
|
||||
b(v)-5 b(alue)29 b(ma)m(y)g(not)f(b)s(e)g(c)m(hanged.)630
|
||||
1176 y Ft(mailwarn)96 b Fu(If)34 b(set,)i(and)e(a)h(\014le)g(that)g
|
||||
(Bash)f(is)h(c)m(hec)m(king)h(for)f(mail)g(has)f(b)s(een)g(accessed)
|
||||
1110 792 y(since)24 b(the)h(last)g(time)f(it)h(w)m(as)f(c)m(hec)m(k)m
|
||||
1110 1285 y(since)24 b(the)h(last)g(time)f(it)h(w)m(as)f(c)m(hec)m(k)m
|
||||
(ed,)k(the)c(message)h Ft("The)k(mail)h(in)f Fj(mail-)1110
|
||||
902 y(file)g Ft(has)h(been)f(read")g Fu(is)h(displa)m(y)m(ed.)630
|
||||
1066 y Ft(no_empty_cmd_completion)1110 1176 y Fu(If)g(set,)g(and)g
|
||||
1395 y(file)g Ft(has)h(been)f(read")g Fu(is)h(displa)m(y)m(ed.)630
|
||||
1559 y Ft(no_empty_cmd_completion)1110 1669 y Fu(If)g(set,)g(and)g
|
||||
(Readline)g(is)h(b)s(eing)e(used,)h(Bash)g(will)g(not)g(attempt)i(to)e
|
||||
(searc)m(h)1110 1285 y(the)25 b Ft(PATH)f Fu(for)h(p)s(ossible)f
|
||||
(searc)m(h)1110 1778 y(the)25 b Ft(PATH)f Fu(for)h(p)s(ossible)f
|
||||
(completions)j(when)d(completion)i(is)f(attempted)h(on)1110
|
||||
1395 y(an)k(empt)m(y)h(line.)630 1559 y Ft(nocaseglob)1110
|
||||
1669 y Fu(If)38 b(set,)k(Bash)d(matc)m(hes)g(\014lenames)g(in)f(a)h
|
||||
(case-insensitiv)m(e)j(fashion)c(when)1110 1778 y(p)s(erforming)29
|
||||
b(\014lename)i(expansion.)630 1943 y Ft(nocasematch)1110
|
||||
2052 y Fu(If)42 b(set,)k(Bash)d(matc)m(hes)g(patterns)g(in)f(a)h
|
||||
(case-insensitiv)m(e)i(fashion)d(when)1110 2162 y(p)s(erforming)31
|
||||
1888 y(an)k(empt)m(y)h(line.)630 2052 y Ft(nocaseglob)1110
|
||||
2162 y Fu(If)38 b(set,)k(Bash)d(matc)m(hes)g(\014lenames)g(in)f(a)h
|
||||
(case-insensitiv)m(e)j(fashion)c(when)1110 2271 y(p)s(erforming)29
|
||||
b(\014lename)i(expansion.)630 2436 y Ft(nocasematch)1110
|
||||
2545 y Fu(If)42 b(set,)k(Bash)d(matc)m(hes)g(patterns)g(in)f(a)h
|
||||
(case-insensitiv)m(e)i(fashion)d(when)1110 2655 y(p)s(erforming)31
|
||||
b(matc)m(hing)i(while)f(executing)i Ft(case)d Fu(or)h
|
||||
Ft([[)g Fu(conditional)h(com-)1110 2271 y(mands,)d(when)g(p)s
|
||||
Ft([[)g Fu(conditional)h(com-)1110 2765 y(mands,)d(when)g(p)s
|
||||
(erforming)g(pattern)h(substitution)g(w)m(ord)g(expansions,)g(or)1110
|
||||
2381 y(when)g(\014ltering)i(p)s(ossible)f(completions)h(as)g(part)f(of)
|
||||
h(programmable)f(com-)1110 2491 y(pletion.)630 2655 y
|
||||
2874 y(when)g(\014ltering)i(p)s(ossible)f(completions)h(as)g(part)f(of)
|
||||
h(programmable)f(com-)1110 2984 y(pletion.)630 3148 y
|
||||
Ft(nullglob)96 b Fu(If)23 b(set,)j(Bash)e(allo)m(ws)g(\014lename)g
|
||||
(patterns)g(whic)m(h)f(matc)m(h)h(no)g(\014les)f(to)i(expand)1110
|
||||
2765 y(to)31 b(a)g(n)m(ull)f(string,)h(rather)f(than)g(themselv)m(es.)
|
||||
630 2929 y Ft(progcomp)96 b Fu(If)25 b(set,)i(the)f(programmable)g
|
||||
3258 y(to)31 b(a)g(n)m(ull)f(string,)h(rather)f(than)g(themselv)m(es.)
|
||||
630 3422 y Ft(progcomp)96 b Fu(If)25 b(set,)i(the)f(programmable)g
|
||||
(completion)g(facilities)i(\(see)f(Section)f(8.6)h([Pro-)1110
|
||||
3039 y(grammable)45 b(Completion],)k(page)c(131\))h(are)f(enabled.)82
|
||||
b(This)44 b(option)h(is)1110 3148 y(enabled)30 b(b)m(y)h(default.)630
|
||||
3313 y Ft(promptvars)1110 3422 y Fu(If)50 b(set,)56 b(prompt)49
|
||||
3532 y(grammable)45 b(Completion],)k(page)c(131\))h(are)f(enabled.)82
|
||||
b(This)44 b(option)h(is)1110 3641 y(enabled)30 b(b)m(y)h(default.)630
|
||||
3806 y Ft(promptvars)1110 3915 y Fu(If)50 b(set,)56 b(prompt)49
|
||||
b(strings)h(undergo)g(parameter)h(expansion,)k(command)1110
|
||||
3532 y(substitution,)35 b(arithmetic)g(expansion,)g(and)e(quote)i(remo)
|
||||
m(v)-5 b(al)35 b(after)f(b)s(eing)1110 3641 y(expanded)53
|
||||
4025 y(substitution,)35 b(arithmetic)g(expansion,)g(and)e(quote)i(remo)
|
||||
m(v)-5 b(al)35 b(after)f(b)s(eing)1110 4134 y(expanded)53
|
||||
b(as)h(describ)s(ed)e(b)s(elo)m(w)i(\(see)h(Section)f(6.9)h([Con)m
|
||||
(trolling)g(the)1110 3751 y(Prompt],)30 b(page)h(96\).)42
|
||||
(trolling)g(the)1110 4244 y(Prompt],)30 b(page)h(96\).)42
|
||||
b(This)30 b(option)h(is)f(enabled)h(b)m(y)f(default.)630
|
||||
3915 y Ft(restricted_shell)1110 4025 y Fu(The)40 b(shell)h(sets)g(this)
|
||||
4408 y Ft(restricted_shell)1110 4518 y Fu(The)40 b(shell)h(sets)g(this)
|
||||
g(option)g(if)g(it)h(is)e(started)i(in)e(restricted)i(mo)s(de)e(\(see)
|
||||
1110 4134 y(Section)c(6.10)g([The)f(Restricted)g(Shell],)i(page)e
|
||||
1110 4628 y(Section)c(6.10)g([The)f(Restricted)g(Shell],)i(page)e
|
||||
(97\).)56 b(The)34 b(v)-5 b(alue)35 b(ma)m(y)h(not)1110
|
||||
4244 y(b)s(e)c(c)m(hanged.)49 b(This)32 b(is)h(not)h(reset)f(when)f
|
||||
(the)h(startup)g(\014les)f(are)i(executed,)1110 4354
|
||||
4737 y(b)s(e)c(c)m(hanged.)49 b(This)32 b(is)h(not)h(reset)f(when)f
|
||||
(the)h(startup)g(\014les)f(are)i(executed,)1110 4847
|
||||
y(allo)m(wing)k(the)e(startup)f(\014les)h(to)g(disco)m(v)m(er)h
|
||||
(whether)f(or)f(not)i(a)f(shell)g(is)g(re-)1110 4463
|
||||
y(stricted.)630 4628 y Ft(shift_verbose)1110 4737 y Fu(If)g(this)g(is)g
|
||||
(whether)f(or)f(not)i(a)f(shell)g(is)g(re-)1110 4956
|
||||
y(stricted.)630 5121 y Ft(shift_verbose)1110 5230 y Fu(If)g(this)g(is)g
|
||||
(set,)j(the)d Ft(shift)f Fu(builtin)h(prin)m(ts)f(an)h(error)g(message)
|
||||
i(when)d(the)1110 4847 y(shift)30 b(coun)m(t)h(exceeds)g(the)g(n)m(um)m
|
||||
(b)s(er)e(of)h(p)s(ositional)i(parameters.)630 5011 y
|
||||
Ft(sourcepath)1110 5121 y Fu(If)22 b(set,)j(the)e Ft(source)e
|
||||
Fu(builtin)h(uses)g(the)h(v)-5 b(alue)23 b(of)g Ft(PATH)e
|
||||
Fu(to)j(\014nd)d(the)h(directory)1110 5230 y(con)m(taining)29
|
||||
b(the)e(\014le)h(supplied)e(as)h(an)g(argumen)m(t.)40
|
||||
b(This)27 b(option)h(is)f(enabled)1110 5340 y(b)m(y)j(default.)p
|
||||
eop end
|
||||
i(when)d(the)1110 5340 y(shift)30 b(coun)m(t)h(exceeds)g(the)g(n)m(um)m
|
||||
(b)s(er)e(of)h(p)s(ositional)i(parameters.)p eop end
|
||||
%%Page: 71 77
|
||||
TeXDict begin 71 76 bop 150 -116 a Fu(Chapter)30 b(4:)41
|
||||
b(Shell)30 b(Builtin)h(Commands)2069 b(71)630 299 y Ft(xpg_echo)96
|
||||
b Fu(If)31 b(set,)h(the)g Ft(echo)e Fu(builtin)h(expands)f(bac)m
|
||||
(kslash-escap)s(e)j(sequences)f(b)m(y)f(de-)1110 408
|
||||
y(fault.)630 568 y(The)c(return)f(status)i(when)f(listing)h(options)g
|
||||
(is)f(zero)i(if)e(all)i Fr(optnames)i Fu(are)d(enabled,)g(non-)630
|
||||
677 y(zero)40 b(otherwise.)66 b(When)39 b(setting)h(or)f(unsetting)g
|
||||
(options,)i(the)e(return)f(status)h(is)g(zero)630 787
|
||||
y(unless)30 b(an)g Fr(optname)36 b Fu(is)30 b(not)h(a)g(v)-5
|
||||
b(alid)30 b(shell)h(option.)150 1028 y Fs(4.4)68 b(Sp)t(ecial)45
|
||||
b(Builtins)150 1187 y Fu(F)-8 b(or)35 b(historical)h(reasons,)g(the)e
|
||||
Fm(posix)g Fu(standard)f(has)i(classi\014ed)f(sev)m(eral)i(builtin)e
|
||||
(commands)g(as)h Fl(sp)-5 b(e-)150 1297 y(cial)p Fu(.)47
|
||||
b(When)33 b(Bash)f(is)h(executing)g(in)f Fm(posix)g Fu(mo)s(de,)h(the)g
|
||||
(sp)s(ecial)g(builtins)e(di\013er)i(from)f(other)g(builtin)150
|
||||
1406 y(commands)e(in)g(three)h(resp)s(ects:)199 1541
|
||||
b(Shell)30 b(Builtin)h(Commands)2069 b(71)630 299 y Ft(sourcepath)1110
|
||||
408 y Fu(If)22 b(set,)j(the)e Ft(source)e Fu(builtin)h(uses)g(the)h(v)
|
||||
-5 b(alue)23 b(of)g Ft(PATH)e Fu(to)j(\014nd)d(the)h(directory)1110
|
||||
518 y(con)m(taining)29 b(the)e(\014le)h(supplied)e(as)h(an)g(argumen)m
|
||||
(t.)40 b(This)27 b(option)h(is)f(enabled)1110 628 y(b)m(y)j(default.)
|
||||
630 787 y Ft(xpg_echo)96 b Fu(If)31 b(set,)h(the)g Ft(echo)e
|
||||
Fu(builtin)h(expands)f(bac)m(kslash-escap)s(e)j(sequences)f(b)m(y)f
|
||||
(de-)1110 897 y(fault.)630 1056 y(The)c(return)f(status)i(when)f
|
||||
(listing)h(options)g(is)f(zero)i(if)e(all)i Fr(optnames)i
|
||||
Fu(are)d(enabled,)g(non-)630 1166 y(zero)40 b(otherwise.)66
|
||||
b(When)39 b(setting)h(or)f(unsetting)g(options,)i(the)e(return)f
|
||||
(status)h(is)g(zero)630 1275 y(unless)30 b(an)g Fr(optname)36
|
||||
b Fu(is)30 b(not)h(a)g(v)-5 b(alid)30 b(shell)h(option.)150
|
||||
1516 y Fs(4.4)68 b(Sp)t(ecial)45 b(Builtins)150 1675
|
||||
y Fu(F)-8 b(or)35 b(historical)h(reasons,)g(the)e Fm(posix)g
|
||||
Fu(standard)f(has)i(classi\014ed)f(sev)m(eral)i(builtin)e(commands)g
|
||||
(as)h Fl(sp)-5 b(e-)150 1785 y(cial)p Fu(.)47 b(When)33
|
||||
b(Bash)f(is)h(executing)g(in)f Fm(posix)g Fu(mo)s(de,)h(the)g(sp)s
|
||||
(ecial)g(builtins)e(di\013er)i(from)f(other)g(builtin)150
|
||||
1895 y(commands)e(in)g(three)h(resp)s(ects:)199 2029
|
||||
y(1.)61 b(Sp)s(ecial)31 b(builtins)e(are)i(found)e(b)s(efore)h(shell)h
|
||||
(functions)f(during)f(command)h(lo)s(okup.)199 1675 y(2.)61
|
||||
(functions)f(during)f(command)h(lo)s(okup.)199 2164 y(2.)61
|
||||
b(If)30 b(a)h(sp)s(ecial)g(builtin)f(returns)f(an)h(error)g(status,)h
|
||||
(a)g(non-in)m(teractiv)m(e)i(shell)d(exits.)199 1810
|
||||
(a)g(non-in)m(teractiv)m(e)i(shell)d(exits.)199 2298
|
||||
y(3.)61 b(Assignmen)m(t)30 b(statemen)m(ts)h(preceding)f(the)f(command)
|
||||
g(sta)m(y)i(in)e(e\013ect)i(in)e(the)h(shell)f(en)m(vironmen)m(t)330
|
||||
1919 y(after)i(the)f(command)h(completes.)275 2079 y(When)36
|
||||
2408 y(after)i(the)f(command)h(completes.)275 2567 y(When)36
|
||||
b(Bash)g(is)h(not)f(executing)i(in)e Fm(posix)f Fu(mo)s(de,)j(these)f
|
||||
(builtins)f(b)s(eha)m(v)m(e)h(no)f(di\013eren)m(tly)h(than)150
|
||||
2188 y(the)31 b(rest)f(of)h(the)f(Bash)h(builtin)e(commands.)41
|
||||
2677 y(the)31 b(rest)f(of)h(the)f(Bash)h(builtin)e(commands.)41
|
||||
b(The)30 b(Bash)g Fm(posix)g Fu(mo)s(de)g(is)g(describ)s(ed)f(in)h
|
||||
(Section)h(6.11)150 2298 y([Bash)g(POSIX)e(Mo)s(de],)i(page)g(98.)275
|
||||
2433 y(These)f(are)g(the)h Fm(posix)f Fu(sp)s(ecial)h(builtins:)390
|
||||
2567 y Ft(break)46 b(:)i(.)f(continue)f(eval)g(exec)h(exit)g(export)f
|
||||
(readonly)f(return)h(set)390 2677 y(shift)g(trap)h(unset)p
|
||||
(Section)h(6.11)150 2786 y([Bash)g(POSIX)e(Mo)s(de],)i(page)g(98.)275
|
||||
2921 y(These)f(are)g(the)h Fm(posix)f Fu(sp)s(ecial)h(builtins:)390
|
||||
3055 y Ft(break)46 b(:)i(.)f(continue)f(eval)g(exec)h(exit)g(export)f
|
||||
(readonly)f(return)h(set)390 3165 y(shift)g(trap)h(unset)p
|
||||
eop end
|
||||
%%Page: 72 78
|
||||
TeXDict begin 72 77 bop 3659 -116 a Fu(72)150 299 y Fp(5)80
|
||||
@@ -17773,14 +17792,14 @@ Fu(pro)m(vide)i(is)h(to)f(use)g(a)h(shell)f(function)g(and)g(bind)e(it)
|
||||
j(to)g(a)g(particular)150 1151 y(command)h(using)g Ft(complete)e(-F)p
|
||||
Fu(.)275 1294 y(The)j(follo)m(wing)j(function)e(pro)m(vides)g
|
||||
(completions)i(for)e(the)g Ft(cd)g Fu(builtin.)46 b(It)32
|
||||
b(is)h(a)f(reasonably)h(go)s(o)s(d)150 1403 y(example)e(of)f(what)g
|
||||
(shell)g(functions)g(m)m(ust)f(do)h(when)f(used)h(for)f(completion.)42
|
||||
b(This)29 b(function)h(uses)g(the)150 1513 y(w)m(ord)38
|
||||
b(passsed)g(as)h Ft($2)g Fu(to)g(determine)g(the)g(directory)g(name)g
|
||||
(to)g(complete.)67 b(Y)-8 b(ou)40 b(can)f(also)g(use)g(the)150
|
||||
1623 y Ft(COMP_WORDS)28 b Fu(arra)m(y)i(v)-5 b(ariable;)32
|
||||
b(the)e(curren)m(t)h(w)m(ord)f(is)g(indexed)g(b)m(y)g(the)h
|
||||
Ft(COMP_CWORD)c Fu(v)-5 b(ariable.)275 1766 y(The)42
|
||||
b(is)h(a)f(reasonably)h(go)s(o)s(d)150 1403 y(example)41
|
||||
b(of)g(what)f(shell)h(functions)f(m)m(ust)g(do)h(when)e(used)h(for)g
|
||||
(completion.)73 b(This)39 b(function)h(uses)150 1513
|
||||
y(the)32 b(w)m(ord)f(passed)g(as)h Ft($2)f Fu(to)h(determine)g(the)f
|
||||
(directory)h(name)g(to)g(complete.)46 b(Y)-8 b(ou)32
|
||||
b(can)g(also)g(use)g(the)150 1623 y Ft(COMP_WORDS)c Fu(arra)m(y)i(v)-5
|
||||
b(ariable;)32 b(the)e(curren)m(t)h(w)m(ord)f(is)g(indexed)g(b)m(y)g
|
||||
(the)h Ft(COMP_CWORD)c Fu(v)-5 b(ariable.)275 1766 y(The)42
|
||||
b(function)h(relies)h(on)e(the)i Ft(complete)c Fu(and)j
|
||||
Ft(compgen)e Fu(builtins)h(to)i(do)f(m)m(uc)m(h)g(of)g(the)h(w)m(ork,)
|
||||
150 1875 y(adding)25 b(only)h(the)g(things)g(that)g(the)g(Bash)g
|
||||
@@ -20067,7 +20086,7 @@ g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f
|
||||
g(:)g(:)g(:)26 b Fb(57)2025 4339 y Fe(readarray)15 b
|
||||
Fc(:)g(:)f(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g
|
||||
(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)
|
||||
g(:)g(:)30 b Fb(58)2025 4427 y Fe(readonly)18 b Fc(:)d(:)e(:)g(:)g(:)g
|
||||
g(:)g(:)30 b Fb(59)2025 4427 y Fe(readonly)18 b Fc(:)d(:)e(:)g(:)g(:)g
|
||||
(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)
|
||||
h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)33
|
||||
b Fb(46)2025 4515 y Fe(return)6 b Fc(:)14 b(:)f(:)h(:)f(:)g(:)g(:)g(:)g
|
||||
|
||||
Reference in New Issue
Block a user