commit bash-20090618 snapshot

This commit is contained in:
Chet Ramey
2011-12-08 20:11:17 -05:00
parent 4a8bb13f3c
commit 2c471a92e2
29 changed files with 1169 additions and 1119 deletions
+45 -43
View File
@@ -11,7 +11,7 @@
%DVIPSWebPage: (www.radicaleye.com)
%DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps bashref.dvi
%DVIPSParameters: dpi=600
%DVIPSSource: TeX output 2009.06.08:0833
%DVIPSSource: TeX output 2009.06.17:0851
%%BeginProcSet: tex.pro 0 0
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -4325,10 +4325,10 @@ b(oundation)p 150 5141 3600 17 v eop end
%%Page: 2 2
TeXDict begin 2 1 bop 150 2889 a Ft(This)35 b(text)h(is)g(a)g(brief)f
(description)h(of)f(the)h(features)g(that)g(are)g(presen)m(t)g(in)f
(the)h(Bash)f(shell)h(\(v)m(ersion)150 2999 y(4.0,)c(5)e(June)g
(2009\).)150 3133 y(This)37 b(is)h(Edition)f(4.0,)k(last)e(up)s(dated)d
(5)i(June)f(2009,)k(of)d Fq(The)f(GNU)h(Bash)g(Reference)h(Man)m(ual)p
Ft(,)h(for)150 3243 y Fs(Bash)p Ft(,)29 b(V)-8 b(ersion)31
(the)h(Bash)f(shell)h(\(v)m(ersion)150 2999 y(4.0,)c(17)f(June)e
(2009\).)150 3133 y(This)34 b(is)h(Edition)g(4.0,)i(last)e(up)s(dated)f
(17)h(June)f(2009,)k(of)d Fq(The)f(GNU)i(Bash)f(Reference)g(Man)m(ual)p
Ft(,)i(for)150 3243 y Fs(Bash)p Ft(,)29 b(V)-8 b(ersion)31
b(4.0.)150 3377 y(Cop)m(yrigh)m(t)602 3374 y(c)577 3377
y Fp(\015)f Ft(1988{2009)35 b(F)-8 b(ree)31 b(Soft)m(w)m(are)h(F)-8
b(oundation,)31 b(Inc.)150 3512 y(P)m(ermission)h(is)h(gran)m(ted)g(to)
@@ -8616,63 +8616,65 @@ eop end
%%Page: 53 59
TeXDict begin 53 58 bop 150 -116 a Ft(Chapter)30 b(4:)41
b(Shell)30 b(Builtin)h(Commands)2069 b(53)1110 299 y
Fs(onecmd)192 b Ft(Same)30 b(as)h Fs(-t)p Ft(.)1110 467
Fs(onecmd)192 b Ft(Same)30 b(as)h Fs(-t)p Ft(.)1110 459
y Fs(physical)96 b Ft(Same)30 b(as)h Fs(-P)p Ft(.)1110
636 y Fs(pipefail)96 b Ft(If)44 b(set,)k(the)d(return)e(v)-5
619 y Fs(pipefail)96 b Ft(If)44 b(set,)k(the)d(return)e(v)-5
b(alue)45 b(of)f(a)h(pip)s(eline)e(is)i(the)f(v)-5 b(alue)45
b(of)1590 746 y(the)33 b(last)h(\(righ)m(tmost\))h(command)e(to)h(exit)
g(with)f(a)g(non-zero)1590 855 y(status,)28 b(or)f(zero)g(if)f(all)i
b(of)1590 729 y(the)33 b(last)h(\(righ)m(tmost\))h(command)e(to)h(exit)
g(with)f(a)g(non-zero)1590 838 y(status,)28 b(or)f(zero)g(if)f(all)i
(commands)e(in)g(the)h(pip)s(eline)f(exit)i(suc-)1590
965 y(cessfully)-8 b(.)41 b(This)30 b(option)h(is)f(disabled)g(b)m(y)h
(default.)1110 1133 y Fs(posix)240 b Ft(Change)30 b(the)g(b)s(eha)m
948 y(cessfully)-8 b(.)41 b(This)30 b(option)h(is)f(disabled)g(b)m(y)h
(default.)1110 1108 y Fs(posix)240 b Ft(Change)30 b(the)g(b)s(eha)m
(vior)h(of)f(Bash)g(where)g(the)g(default)h(op)s(era-)1590
1243 y(tion)25 b(di\013ers)f(from)g(the)h Fl(posix)f
Ft(standard)f(to)i(matc)m(h)h(the)f(stan-)1590 1353 y(dard)32
1218 y(tion)25 b(di\013ers)f(from)g(the)h Fl(posix)f
Ft(standard)f(to)i(matc)m(h)h(the)f(stan-)1590 1327 y(dard)32
b(\(see)i(Section)g(6.11)h([Bash)e(POSIX)f(Mo)s(de],)j(page)e(84\).)
1590 1462 y(This)k(is)g(in)m(tended)g(to)h(mak)m(e)g(Bash)g(b)s(eha)m
(v)m(e)g(as)g(a)f(strict)h(su-)1590 1572 y(p)s(erset)30
b(of)h(that)f(standard.)1110 1740 y Fs(privileged)1590
1850 y Ft(Same)g(as)h Fs(-p)p Ft(.)1110 2019 y Fs(verbose)144
b Ft(Same)30 b(as)h Fs(-v)p Ft(.)1110 2187 y Fs(vi)384
1590 1437 y(This)k(is)g(in)m(tended)g(to)h(mak)m(e)g(Bash)g(b)s(eha)m
(v)m(e)g(as)g(a)f(strict)h(su-)1590 1547 y(p)s(erset)30
b(of)h(that)f(standard.)1110 1707 y Fs(privileged)1590
1816 y Ft(Same)g(as)h Fs(-p)p Ft(.)1110 1976 y Fs(verbose)144
b Ft(Same)30 b(as)h Fs(-v)p Ft(.)1110 2137 y Fs(vi)384
b Ft(Use)36 b(a)g Fs(vi)p Ft(-st)m(yle)g(line)g(editing)g(in)m
(terface.)58 b(This)35 b(also)h(a\013ects)1590 2297 y(the)31
(terface.)58 b(This)35 b(also)h(a\013ects)1590 2246 y(the)31
b(editing)g(in)m(terface)h(used)d(for)h Fs(read)f(-e)p
Ft(.)1110 2465 y Fs(xtrace)192 b Ft(Same)30 b(as)h Fs(-x)p
Ft(.)630 2634 y Fs(-p)384 b Ft(T)-8 b(urn)33 b(on)h(privileged)h(mo)s
Ft(.)1110 2406 y Fs(xtrace)192 b Ft(Same)30 b(as)h Fs(-x)p
Ft(.)630 2567 y Fs(-p)384 b Ft(T)-8 b(urn)33 b(on)h(privileged)h(mo)s
(de.)51 b(In)34 b(this)g(mo)s(de,)h(the)f Fs($BASH_ENV)e
Ft(and)h Fs($ENV)1110 2744 y Ft(\014les)k(are)h(not)g(pro)s(cessed,)h
Ft(and)h Fs($ENV)1110 2676 y Ft(\014les)k(are)h(not)g(pro)s(cessed,)h
(shell)f(functions)f(are)h(not)f(inherited)h(from)f(the)1110
2853 y(en)m(vironmen)m(t,)47 b(and)42 b(the)h Fs(SHELLOPTS)p
2786 y(en)m(vironmen)m(t,)47 b(and)42 b(the)h Fs(SHELLOPTS)p
Ft(,)g Fs(CDPATH)e Ft(and)i Fs(GLOBIGNORE)c Ft(v)-5 b(ari-)1110
2963 y(ables,)36 b(if)e(they)g(app)s(ear)g(in)g(the)g(en)m(vironmen)m
(t,)i(are)f(ignored.)53 b(If)33 b(the)i(shell)1110 3072
2895 y(ables,)36 b(if)e(they)g(app)s(ear)g(in)g(the)g(en)m(vironmen)m
(t,)i(are)f(ignored.)53 b(If)33 b(the)i(shell)1110 3005
y(is)i(started)h(with)f(the)g(e\013ectiv)m(e)j(user)d(\(group\))g(id)g
(not)g(equal)h(to)g(the)f(real)1110 3182 y(user)h(\(group\))h(id,)i
(not)g(equal)h(to)g(the)f(real)1110 3114 y(user)h(\(group\))h(id,)i
(and)d(the)h Fs(-p)f Ft(option)i(is)e(not)i(supplied,)f(these)h
(actions)1110 3292 y(are)32 b(tak)m(en)i(and)d(the)h(e\013ectiv)m(e)j
(actions)1110 3224 y(are)32 b(tak)m(en)i(and)d(the)h(e\013ectiv)m(e)j
(user)c(id)h(is)g(set)h(to)f(the)h(real)f(user)g(id.)45
b(If)32 b(the)1110 3401 y Fs(-p)i Ft(option)h(is)g(supplied)f(at)h
b(If)32 b(the)1110 3334 y Fs(-p)i Ft(option)h(is)g(supplied)f(at)h
(startup,)h(the)f(e\013ectiv)m(e)i(user)d(id)g(is)h(not)g(reset.)1110
3511 y(T)-8 b(urning)35 b(this)i(option)g(o\013)g(causes)g(the)g
3443 y(T)-8 b(urning)35 b(this)i(option)g(o\013)g(causes)g(the)g
(e\013ectiv)m(e)i(user)d(and)g(group)g(ids)g(to)1110
3620 y(b)s(e)30 b(set)h(to)g(the)f(real)h(user)f(and)g(group)g(ids.)630
3789 y Fs(-t)384 b Ft(Exit)31 b(after)g(reading)f(and)g(executing)h
(one)g(command.)630 3957 y Fs(-u)384 b Ft(T)-8 b(reat)38
b(unset)e(v)-5 b(ariables)37 b(as)h(an)e(error)h(when)e(p)s(erforming)h
(parameter)h(ex-)1110 4067 y(pansion.)58 b(An)36 b(error)f(message)j
(will)e(b)s(e)g(written)g(to)h(the)g(standard)e(error,)1110
4177 y(and)30 b(a)h(non-in)m(teractiv)m(e)i(shell)d(will)h(exit.)630
4345 y Fs(-v)384 b Ft(Prin)m(t)30 b(shell)h(input)e(lines)i(as)g(they)f
(are)h(read.)630 4514 y Fs(-x)384 b Ft(Prin)m(t)21 b(a)h(trace)h(of)f
3553 y(b)s(e)30 b(set)h(to)g(the)f(real)h(user)f(and)g(group)g(ids.)630
3713 y Fs(-t)384 b Ft(Exit)31 b(after)g(reading)f(and)g(executing)h
(one)g(command.)630 3873 y Fs(-u)384 b Ft(T)-8 b(reat)25
b(unset)e(v)-5 b(ariables)25 b(and)e(parameters)h(other)h(than)e(the)h
(sp)s(ecial)h(param-)1110 3983 y(eters)35 b(`)p Fs(@)p
Ft(')f(or)g(`)p Fs(*)p Ft(')h(as)f(an)g(error)g(when)f(p)s(erforming)g
(parameter)i(expansion.)1110 4092 y(An)28 b(error)h(message)g(will)g(b)
s(e)f(written)h(to)h(the)e(standard)g(error,)h(and)f(a)h(non-)1110
4202 y(in)m(teractiv)m(e)k(shell)e(will)g(exit.)630 4362
y Fs(-v)384 b Ft(Prin)m(t)30 b(shell)h(input)e(lines)i(as)g(they)f(are)
h(read.)630 4522 y Fs(-x)384 b Ft(Prin)m(t)21 b(a)h(trace)h(of)f
(simple)f(commands,)i Fs(for)e Ft(commands,)i Fs(case)d
Ft(commands,)1110 4623 y Fs(select)29 b Ft(commands,)j(and)e
Ft(commands,)1110 4632 y Fs(select)29 b Ft(commands,)j(and)e
(arithmetic)j Fs(for)d Ft(commands)h(and)f(their)i(argu-)1110
4733 y(men)m(ts)h(or)f(asso)s(ciated)i(w)m(ord)e(lists)h(after)g(they)f
(are)h(expanded)f(and)f(b)s(efore)1110 4843 y(they)i(are)g(executed.)49
4741 y(men)m(ts)h(or)f(asso)s(ciated)i(w)m(ord)e(lists)h(after)g(they)f
(are)h(expanded)f(and)f(b)s(efore)1110 4851 y(they)i(are)g(executed.)49
b(The)32 b(v)-5 b(alue)33 b(of)g(the)g Fs(PS4)f Ft(v)-5
b(ariable)34 b(is)f(expanded)f(and)1110 4952 y(the)24
b(ariable)34 b(is)f(expanded)f(and)1110 4961 y(the)24
b(resultan)m(t)h(v)-5 b(alue)24 b(is)g(prin)m(ted)g(b)s(efore)f(the)h
(command)g(and)f(its)i(expanded)1110 5062 y(argumen)m(ts.)630
(command)g(and)f(its)i(expanded)1110 5070 y(argumen)m(ts.)630
5230 y Fs(-B)384 b Ft(The)41 b(shell)g(will)g(p)s(erform)f(brace)h
(expansion)g(\(see)h(Section)g(3.5.1)g([Brace)1110 5340
y(Expansion],)30 b(page)h(18\).)42 b(This)30 b(option)h(is)f(on)g(b)m