fix for read builtin and invalid multibyte characters followed by the delimiter; updated formatted documentation; new bash.pot file with updated strings; updated translations

This commit is contained in:
Chet Ramey
2025-04-22 10:39:43 -04:00
parent 482872ed8b
commit 7731dc5c4d
77 changed files with 19705 additions and 13848 deletions
+339 -332
View File
@@ -1,7 +1,7 @@
%!PS-Adobe-2.0
%%Creator: dvips(k) 2024.1 (TeX Live 2024) Copyright 2024 Radical Eye Software
%%Title: bashref.dvi
%%CreationDate: Mon Mar 31 14:31:21 2025
%%CreationDate: Tue Apr 22 14:00:28 2025
%%Pages: 214
%%PageOrder: Ascend
%%BoundingBox: 0 0 612 792
@@ -10,9 +10,10 @@
%%DocumentPaperSizes: Letter
%%EndComments
%DVIPSWebPage: (www.radicaleye.com)
%DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps bashref.dvi
%DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps
%+ /usr/local/src/bash/bash-20250418/doc/bashref.dvi
%DVIPSParameters: dpi=600
%DVIPSSource: TeX output 2025.03.31:1028
%DVIPSSource: TeX output 2025.04.22:1000
%%BeginProcSet: tex.pro 0 0
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -7566,7 +7567,8 @@ E69030FD907778821C66F93220A31991386640AC2315A5B7DB80B4AE91A6A4D7
cleartomark
{restore}if
%%EndFont
TeXDict begin 40258431 52099146 1000 600 600 (bashref.dvi)
TeXDict begin 40258431 52099146 1000 600 600
(/usr/local/src/bash/bash-20250418/doc/bashref.dvi)
@start /Fa 130[55 1[55 123[{ T1Encoding ReEncodeFont }2
116.231 /SFRM1440 rf /Fb 133[34 41 41 55 41 43 30 30
30 41 43 38 43 64 21 41 23 21 43 38 23 34 43 34 43 38
@@ -7644,24 +7646,23 @@ 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(5.3,)g(for)f
Ft(Bash)g Fu(V)-8 b(ersion)31 b(5.3.)3180 1697 y(F)-8
b(ebruary)30 b(2025)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 b(oundation)p 150 5141 3600 17 v eop end
Ft(Bash)g Fu(V)-8 b(ersion)31 b(5.3.)3333 1697 y(April)f(2025)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
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(5.3,)c(24)f(F)-8
b(ebruary)30 b(2025\).)150 4523 y(This)i(is)h(Edition)g(5.3,)i(last)f
(up)s(dated)e(24)i(F)-8 b(ebruary)33 b(2025,)i(of)f Fr(The)e(GNU)i
(Bash)f(Reference)h(Man)m(ual)p Fu(,)150 4633 y(for)c
Ft(Bash)p Fu(,)g(V)-8 b(ersion)31 b(5.3.)150 4767 y(Cop)m(yrigh)m(t)602
4764 y(c)577 4767 y Fq(\015)f Fu(1988{2025)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(to)g(cop)m(y)-8
b(,)24 b(distribute)c(and/or)h(mo)s(dify)e(this)i(do)s(cumen)m(t)f
(under)f(the)390 5011 y(terms)25 b(of)h(the)f(GNU)h(F)-8
(the)h(Bash)f(shell)h(\(v)m(ersion)150 4389 y(5.3,)c(7)e(April)h
(2025\).)150 4523 y(This)36 b(is)g(Edition)h(5.3,)j(last)d(up)s(dated)e
(7)i(April)g(2025,)j(of)c Fr(The)h(GNU)g(Bash)g(Reference)g(Man)m(ual)p
Fu(,)i(for)150 4633 y Ft(Bash)p Fu(,)29 b(V)-8 b(ersion)31
b(5.3.)150 4767 y(Cop)m(yrigh)m(t)602 4764 y(c)577 4767
y Fq(\015)f Fu(1988{2025)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
(to)g(cop)m(y)-8 b(,)24 b(distribute)c(and/or)h(mo)s(dify)e(this)i(do)s
(cumen)m(t)f(under)f(the)390 5011 y(terms)25 b(of)h(the)f(GNU)h(F)-8
b(ree)27 b(Do)s(cumen)m(tation)g(License,)g(V)-8 b(ersion)26
b(1.3)g(or)f(an)m(y)h(later)g(v)m(ersion)390 5121 y(published)43
b(b)m(y)h(the)h(F)-8 b(ree)46 b(Soft)m(w)m(are)g(F)-8
@@ -12159,83 +12160,85 @@ b([-fn])g([-p])h([)p Fj(name)p Ft([=)p Fj(value)p Ft(]])630
(functions;)630 5097 y(otherwise)31 b(the)f(names)h(refer)f(to)h(shell)
f(v)-5 b(ariables.)630 5230 y(The)31 b Ft(-n)f Fu(option)i(means)f(to)h
(unexp)s(ort)e(eac)m(h)j(name:)42 b(no)32 b(longer)f(mark)g(it)h(for)f
(exp)s(ort.)43 b(If)630 5340 y(no)37 b Fr(name)5 b Fu(s)36
b(are)h(supplied,)h(or)e(if)h(the)g Ft(-p)f Fu(option)h(is)g(giv)m(en,)
j Ft(export)35 b Fu(displa)m(ys)h(a)h(list)h(of)p eop
end
(exp)s(ort.)43 b(If)630 5340 y(no)30 b Fr(name)5 b Fu(s)31
b(are)g(supplied,)e(or)i(if)f(only)h(the)g Ft(-p)f Fu(option)h(is)f
(giv)m(en,)i Ft(export)d Fu(displa)m(ys)h(a)h(list)p
eop end
%%Page: 55 61
TeXDict begin 55 60 bop 150 -116 a Fu(Chapter)30 b(4:)41
b(Shell)30 b(Builtin)h(Commands)2069 b(55)630 299 y(names)26
b(of)g(all)h(exp)s(orted)f(v)-5 b(ariables)26 b(on)g(the)g(standard)g
(output.)38 b(The)26 b Ft(-p)f Fu(option)i(displa)m(ys)630
408 y(output)j(in)g(a)h(form)f(that)h(ma)m(y)g(b)s(e)e(reused)h(as)h
(input.)630 544 y Ft(export)e Fu(allo)m(ws)k(the)e(v)-5
b(alue)31 b(of)h(a)f(v)-5 b(ariable)32 b(to)g(b)s(e)e(set)i(at)f(the)g
(same)h(time)g(it)f(is)g(exp)s(orted)630 653 y(or)e(unexp)s(orted)f(b)m
(y)g(follo)m(wing)j(the)e(v)-5 b(ariable)30 b(name)f(with)f(=)p
b(Shell)30 b(Builtin)h(Commands)2069 b(55)630 299 y(of)37
b(names)h(of)f(all)h(exp)s(orted)f(v)-5 b(ariables)38
b(on)f(the)g(standard)g(output.)61 b(Using)37 b Ft(-p)g
Fu(and)g Ft(-f)630 408 y Fu(together)32 b(displa)m(ys)f(exp)s(orted)g
(functions.)41 b(The)31 b Ft(-p)f Fu(option)h(displa)m(ys)g(output)g
(in)f(a)h(form)630 518 y(that)g(ma)m(y)g(b)s(e)f(reused)f(as)i(input.)
630 647 y Ft(export)e Fu(allo)m(ws)k(the)e(v)-5 b(alue)31
b(of)h(a)f(v)-5 b(ariable)32 b(to)g(b)s(e)e(set)i(at)f(the)g(same)h
(time)g(it)f(is)g(exp)s(orted)630 757 y(or)e(unexp)s(orted)f(b)m(y)g
(follo)m(wing)j(the)e(v)-5 b(ariable)30 b(name)f(with)f(=)p
Fr(v)-5 b(alue)p Fu(.)41 b(This)28 b(sets)h(the)g(v)-5
b(alue)630 763 y(of)31 b(the)f(v)-5 b(ariable)31 b(is)g(to)g
b(alue)630 866 y(of)31 b(the)f(v)-5 b(ariable)31 b(is)g(to)g
Fr(v)-5 b(alue)36 b Fu(while)30 b(mo)s(difying)g(the)g(exp)s(ort)h
(attribute.)630 898 y(The)e(return)e(status)j(is)f(zero)h(unless)e(an)h
(attribute.)630 995 y(The)e(return)e(status)j(is)f(zero)h(unless)e(an)h
(in)m(v)-5 b(alid)29 b(option)h(is)f(supplied,)f(one)i(of)f(the)g
(names)630 1008 y(is)k(not)g(a)h(v)-5 b(alid)33 b(shell)h(v)-5
(names)630 1105 y(is)k(not)g(a)h(v)-5 b(alid)33 b(shell)h(v)-5
b(ariable)33 b(name,)i(or)e Ft(-f)f Fu(is)h(supplied)f(with)h(a)g(name)
g(that)h(is)f(not)h(a)630 1118 y(shell)d(function.)150
1279 y Ft(false)870 1414 y(false)630 1549 y Fu(Do)s(es)g(nothing;)g
(returns)e(a)h(non-zero)h(status.)150 1711 y Ft(getopts)870
1846 y(getopts)46 b Fj(optstring)f(name)i Ft([)p Fj(arg)f
Ft(...])630 1981 y(getopts)24 b Fu(is)i(used)f(b)m(y)h(shell)g(scripts)
g(that)h(is)f(not)h(a)630 1214 y(shell)d(function.)150
1363 y Ft(false)870 1491 y(false)630 1620 y Fu(Do)s(es)g(nothing;)g
(returns)e(a)h(non-zero)h(status.)150 1769 y Ft(getopts)870
1898 y(getopts)46 b Fj(optstring)f(name)i Ft([)p Fj(arg)f
Ft(...])630 2027 y(getopts)24 b Fu(is)i(used)f(b)m(y)h(shell)g(scripts)
g(or)g(functions)f(to)i(parse)f(p)s(ositional)g(parameters)h(and)630
2091 y(obtain)35 b(options)h(and)e(their)h(argumen)m(ts.)55
2136 y(obtain)35 b(options)h(and)e(their)h(argumen)m(ts.)55
b Fr(optstring)43 b Fu(con)m(tains)36 b(the)f(option)g(c)m(haracters)
630 2201 y(to)h(b)s(e)f(recognized;)k(if)c(a)h(c)m(haracter)h(is)e
630 2246 y(to)h(b)s(e)f(recognized;)k(if)c(a)h(c)m(haracter)h(is)e
(follo)m(w)m(ed)i(b)m(y)e(a)h(colon,)i(the)d(option)h(is)g(exp)s(ected)
630 2310 y(to)g(ha)m(v)m(e)h(an)f(argumen)m(t,)h(whic)m(h)f(should)e(b)
630 2355 y(to)g(ha)m(v)m(e)h(an)f(argumen)m(t,)h(whic)m(h)f(should)e(b)
s(e)h(separated)h(from)g(it)g(b)m(y)f(whitespace.)57
b(The)630 2420 y(colon)31 b(\(`)p Ft(:)p Fu('\))h(and)d(question)i
b(The)630 2465 y(colon)31 b(\(`)p Ft(:)p Fu('\))h(and)d(question)i
(mark)f(\(`)p Ft(?)p Fu('\))h(ma)m(y)g(not)g(b)s(e)f(used)f(as)i
(option)g(c)m(haracters.)630 2555 y(Eac)m(h)38 b(time)g(it)g(is)f(in)m
(option)g(c)m(haracters.)630 2594 y(Eac)m(h)38 b(time)g(it)g(is)f(in)m
(v)m(ok)m(ed,)k Ft(getopts)35 b Fu(places)j(the)f(next)h(option)f(in)g
(the)h(shell)f(v)-5 b(ariable)630 2665 y Fr(name)p Fu(,)28
(the)h(shell)f(v)-5 b(ariable)630 2703 y Fr(name)p Fu(,)28
b(initializing)h Fr(name)j Fu(if)27 b(it)h(do)s(es)f(not)g(exist,)i
(and)d(the)h(index)g(of)g(the)g(next)g(argumen)m(t)630
2774 y(to)34 b(b)s(e)f(pro)s(cessed)g(in)m(to)i(the)f(v)-5
2813 y(to)34 b(b)s(e)f(pro)s(cessed)g(in)m(to)i(the)f(v)-5
b(ariable)34 b Ft(OPTIND)p Fu(.)48 b Ft(OPTIND)32 b Fu(is)i
(initialized)h(to)g(1)f(eac)m(h)g(time)630 2884 y(the)k(shell)f(or)h(a)
(initialized)h(to)g(1)f(eac)m(h)g(time)630 2923 y(the)k(shell)f(or)h(a)
g(shell)f(script)h(is)f(in)m(v)m(ok)m(ed.)63 b(When)38
b(an)f(option)h(requires)f(an)g(argumen)m(t,)630 2993
b(an)f(option)h(requires)f(an)g(argumen)m(t,)630 3032
y Ft(getopts)28 b Fu(places)k(that)f(argumen)m(t)f(in)m(to)i(the)e(v)-5
b(ariable)31 b Ft(OPTARG)p Fu(.)630 3129 y(The)j(shell)g(do)s(es)h(not)
b(ariable)31 b Ft(OPTARG)p Fu(.)630 3161 y(The)j(shell)g(do)s(es)h(not)
f(reset)h Ft(OPTIND)e Fu(automatically;)39 b(it)c(m)m(ust)g(b)s(e)e
(man)m(ually)i(reset)g(b)s(e-)630 3238 y(t)m(w)m(een)e(m)m(ultiple)f
(man)m(ually)i(reset)g(b)s(e-)630 3271 y(t)m(w)m(een)e(m)m(ultiple)f
(calls)g(to)g Ft(getopts)e Fu(within)h(the)g(same)h(shell)g(in)m(v)m(o)
s(cation)h(to)g(use)e(a)g(new)630 3348 y(set)g(of)f(parameters.)630
3483 y(When)i(it)g(reac)m(hes)h(the)e(end)h(of)f(options,)i
s(cation)h(to)g(use)e(a)g(new)630 3380 y(set)g(of)f(parameters.)630
3509 y(When)i(it)g(reac)m(hes)h(the)e(end)h(of)f(options,)i
Ft(getopts)d Fu(exits)i(with)g(a)g(return)f(v)-5 b(alue)32
b(greater)630 3593 y(than)39 b(zero.)67 b Ft(OPTIND)38
b(greater)630 3619 y(than)39 b(zero.)67 b Ft(OPTIND)38
b Fu(is)h(set)g(to)h(the)f(index)g(of)g(the)g(\014rst)f(non-option)i
(argumen)m(t,)i(and)630 3703 y Fr(name)36 b Fu(is)30
b(set)h(to)g(`)p Ft(?)p Fu('.)630 3838 y Ft(getopts)c
(argumen)m(t,)i(and)630 3728 y Fr(name)36 b Fu(is)30
b(set)h(to)g(`)p Ft(?)p Fu('.)630 3857 y Ft(getopts)c
Fu(normally)j(parses)e(the)i(p)s(ositional)g(parameters,)g(but)e(if)i
(more)f(argumen)m(ts)h(are)630 3948 y(supplied)f(as)i
(more)f(argumen)m(ts)h(are)630 3967 y(supplied)f(as)i
Fr(arg)38 b Fu(v)-5 b(alues,)31 b Ft(getopts)e Fu(parses)h(those)h
(instead.)630 4083 y Ft(getopts)37 b Fu(can)i(rep)s(ort)f(errors)g(in)h
(instead.)630 4096 y Ft(getopts)37 b Fu(can)i(rep)s(ort)f(errors)g(in)h
(t)m(w)m(o)h(w)m(a)m(ys.)67 b(If)38 b(the)h(\014rst)g(c)m(haracter)h
(of)f Fr(optstring)47 b Fu(is)630 4193 y(a)41 b(colon,)k
(of)f Fr(optstring)47 b Fu(is)630 4205 y(a)41 b(colon,)k
Ft(getopts)39 b Fu(uses)h Fl(silent)50 b Fu(error)40
b(rep)s(orting.)72 b(In)40 b(normal)h(op)s(eration,)j
Ft(getopts)630 4302 y Fu(prin)m(ts)26 b(diagnostic)i(messages)g(when)e
Ft(getopts)630 4315 y Fu(prin)m(ts)26 b(diagnostic)i(messages)g(when)e
(it)h(encoun)m(ters)g(in)m(v)-5 b(alid)27 b(options)g(or)g(missing)f
(option)630 4412 y(argumen)m(ts.)63 b(If)37 b(the)h(v)-5
(option)630 4425 y(argumen)m(ts.)63 b(If)37 b(the)h(v)-5
b(ariable)38 b Ft(OPTERR)e Fu(is)i(set)g(to)g(0,)i Ft(getopts)c
Fu(do)s(es)h(not)h(displa)m(y)g(an)m(y)630 4521 y(error)30
Fu(do)s(es)h(not)h(displa)m(y)g(an)m(y)630 4534 y(error)30
b(messages,)i(ev)m(en)f(if)f(the)h(\014rst)e(c)m(haracter)j(of)f
Ft(optstring)d Fu(is)i(not)h(a)f(colon.)630 4657 y(If)i
Ft(optstring)d Fu(is)i(not)h(a)f(colon.)630 4663 y(If)i
Ft(getopts)e Fu(detects)j(an)g(in)m(v)-5 b(alid)32 b(option,)i(it)f
(places)g(`)p Ft(?)p Fu(')f(in)m(to)h Fr(name)38 b Fu(and,)32
b(if)g(not)h(silen)m(t,)630 4766 y(prin)m(ts)e(an)h(error)f(message)i
b(if)g(not)h(silen)m(t,)630 4773 y(prin)m(ts)e(an)h(error)f(message)i
(and)e(unsets)g Ft(OPTARG)p Fu(.)42 b(If)31 b Ft(getopts)f
Fu(is)i(silen)m(t,)h(it)f(assigns)g(the)630 4876 y(option)f(c)m
Fu(is)i(silen)m(t,)h(it)f(assigns)g(the)630 4882 y(option)f(c)m
(haracter)h(found)d(to)i Ft(OPTARG)e Fu(and)g(do)s(es)h(not)h(prin)m(t)
f(a)h(diagnostic)h(message.)630 5011 y(If)21 b(a)h(required)f(argumen)m
(t)h(is)g(not)g(found,)g(and)f Ft(getopts)f Fu(is)h(not)h(silen)m(t,)j
@@ -14984,408 +14987,412 @@ y Fu(The)26 b(maxim)m(um)f(n)m(um)m(b)s(er)g(of)h(lines)h(con)m(tained)
g(in)f(the)g(history)g(\014le.)39 b(When)26 b(this)g(v)-5
b(ariable)630 3214 y(is)25 b(assigned)h(a)g(v)-5 b(alue,)27
b(the)f(history)f(\014le)h(is)f(truncated,)i(if)e(necessary)-8
b(,)28 b(to)e(con)m(tain)g(no)g(more)630 3324 y(than)37
b(that)h(n)m(um)m(b)s(er)d(of)j(lines)f(b)m(y)g(remo)m(ving)h(the)f
(oldest)h(en)m(tries.)62 b(The)37 b(history)g(\014le)g(is)630
3433 y(also)30 b(truncated)f(to)h(this)f(size)g(after)h(writing)f(it)h
(when)d(a)j(shell)f(exits)h(or)f(b)m(y)g(the)g Ft(history)630
3543 y Fu(builtin.)40 b(If)28 b(the)h(v)-5 b(alue)29
b(is)g(0,)h(the)f(history)g(\014le)g(is)g(truncated)f(to)i(zero)g
(size.)41 b(Non-n)m(umeric)630 3652 y(v)-5 b(alues)32
b(and)e(n)m(umeric)h(v)-5 b(alues)32 b(less)f(than)g(zero)h(inhibit)f
(truncation.)44 b(The)31 b(shell)g(sets)h(the)630 3762
y(default)f(v)-5 b(alue)30 b(to)i(the)e(v)-5 b(alue)31
b(of)f Ft(HISTSIZE)f Fu(after)h(reading)h(an)m(y)g(startup)f(\014les.)
150 3915 y Ft(HISTIGNORE)630 4025 y Fu(A)j(colon-separated)h(list)f(of)
g(patterns)f(used)g(to)h(decide)g(whic)m(h)f(command)g(lines)h(should)
630 4134 y(b)s(e)d(sa)m(v)m(ed)i(on)f(the)g(history)g(list.)43
b(,)28 b(to)e(con)m(tain)g(no)g(more)630 3324 y(than)f(the)h(n)m(um)m
(b)s(er)e(of)h(history)h(en)m(tries)g(that)g(total)h(no)e(more)h(than)f
(that)h(n)m(um)m(b)s(er)e(of)i(lines)630 3433 y(b)m(y)f(remo)m(ving)g
(the)g(oldest)g(en)m(tries.)40 b(If)24 b(the)h(history)g(list)g(con)m
(tains)h(m)m(ulti-line)g(en)m(tries,)h(the)630 3543 y(history)i(\014le)
f(ma)m(y)h(con)m(tain)h(more)f(lines)g(than)f(this)h(maxim)m(um)f(to)i
(a)m(v)m(oid)g(lea)m(ving)g(partial)630 3652 y(history)38
b(en)m(tries.)63 b(The)37 b(history)h(\014le)g(is)g(also)g(truncated)g
(to)g(this)g(size)g(after)h(writing)e(it)630 3762 y(when)26
b(a)i(shell)g(exits)g(or)f(b)m(y)h(the)f Ft(history)f
Fu(builtin.)39 b(If)27 b(the)h(v)-5 b(alue)27 b(is)h(0,)g(the)g
(history)f(\014le)h(is)630 3871 y(truncated)34 b(to)h(zero)g(size.)52
b(Non-n)m(umeric)35 b(v)-5 b(alues)34 b(and)g(n)m(umeric)g(v)-5
b(alues)34 b(less)g(than)g(zero)630 3981 y(inhibit)i(truncation.)61
b(The)36 b(shell)h(sets)g(the)g(default)g(v)-5 b(alue)37
b(to)h(the)f(v)-5 b(alue)37 b(of)g Ft(HISTSIZE)630 4091
y Fu(after)31 b(reading)f(an)m(y)h(startup)f(\014les.)150
4244 y Ft(HISTIGNORE)630 4354 y Fu(A)j(colon-separated)h(list)f(of)g
(patterns)f(used)g(to)h(decide)g(whic)m(h)f(command)g(lines)h(should)
630 4463 y(b)s(e)d(sa)m(v)m(ed)i(on)f(the)g(history)g(list.)43
b(If)30 b(a)h(command)g(line)g(matc)m(hes)h(one)f(of)g(the)g(patterns)g
(in)630 4244 y(the)38 b(v)-5 b(alue)38 b(of)f Ft(HISTIGNORE)p
(in)630 4573 y(the)38 b(v)-5 b(alue)38 b(of)f Ft(HISTIGNORE)p
Fu(,)g(it)h(is)g(not)f(sa)m(v)m(ed)i(on)e(the)h(history)f(list.)63
b(Eac)m(h)38 b(pattern)g(is)630 4354 y(anc)m(hored)30
b(Eac)m(h)38 b(pattern)g(is)630 4682 y(anc)m(hored)30
b(at)h(the)f(b)s(eginning)g(of)g(the)g(line)h(and)e(m)m(ust)h(matc)m(h)
h(the)f(complete)i(line)e(\(Bash)630 4463 y(do)s(es)h(not)h(implicitly)
h(the)f(complete)i(line)e(\(Bash)630 4792 y(do)s(es)h(not)h(implicitly)
g(app)s(end)e(a)i(`)p Ft(*)p Fu('\).)44 b(Eac)m(h)32
b(pattern)g(is)f(tested)h(against)h(the)f(line)f(after)630
4573 y(the)39 b(c)m(hec)m(ks)h(sp)s(eci\014ed)f(b)m(y)g
4902 y(the)39 b(c)m(hec)m(ks)h(sp)s(eci\014ed)f(b)m(y)g
Ft(HISTCONTROL)c Fu(are)40 b(applied.)66 b(In)38 b(addition)h(to)h(the)
f(normal)630 4682 y(shell)k(pattern)g(matc)m(hing)h(c)m(haracters,)k(`)
f(normal)630 5011 y(shell)k(pattern)g(matc)m(hing)h(c)m(haracters,)k(`)
p Ft(&)p Fu(')43 b(matc)m(hes)h(the)g(previous)e(history)h(line.)79
b(A)630 4792 y(bac)m(kslash)29 b(escap)s(es)g(the)g(`)p
b(A)630 5121 y(bac)m(kslash)29 b(escap)s(es)g(the)g(`)p
Ft(&)p Fu(';)g(the)g(bac)m(kslash)g(is)g(remo)m(v)m(ed)g(b)s(efore)f
(attempting)i(a)f(matc)m(h.)630 4902 y(If)j(the)g(\014rst)g(line)g(of)h
(attempting)i(a)f(matc)m(h.)630 5230 y(If)j(the)g(\014rst)g(line)g(of)h
(a)f(m)m(ulti-line)i(comp)s(ound)c(command)i(w)m(as)h(sa)m(v)m(ed,)h
(the)e(second)h(and)630 5011 y(subsequen)m(t)e(lines)h(are)g(not)g
(the)e(second)h(and)630 5340 y(subsequen)m(t)e(lines)h(are)g(not)g
(tested,)i(and)d(are)h(added)f(to)i(the)f(history)g(regardless)g(of)g
(the)630 5121 y(v)-5 b(alue)28 b(of)f Ft(HISTIGNORE)p
Fu(.)37 b(If)27 b(the)g(\014rst)g(line)h(w)m(as)f(not)h(sa)m(v)m(ed,)h
(the)f(second)f(and)g(subsequen)m(t)630 5230 y(lines)35
b(of)g(the)f(command)h(are)g(not)g(sa)m(v)m(ed)g(either.)54
b(The)34 b(pattern)h(matc)m(hing)h(honors)e(the)630 5340
y(setting)d(of)g(the)g Ft(extglob)d Fu(shell)j(option.)p
eop end
(the)p eop end
%%Page: 95 101
TeXDict begin 95 100 bop 150 -116 a Fu(Chapter)30 b(5:)41
b(Shell)30 b(V)-8 b(ariables)2459 b(95)630 299 y Ft(HISTIGNORE)31
b Fu(subsumes)h(some)i(of)g(the)g(function)g(of)g Ft(HISTCONTROL)p
Fu(.)48 b(A)34 b(pattern)g(of)g(`)p Ft(&)p Fu(')630 408
y(is)28 b(iden)m(tical)h(to)f Ft(ignoredups)p Fu(,)d(and)i(a)h(pattern)
g(of)f(`)p Ft([)k(]*)p Fu(')c(is)g(iden)m(tical)j(to)e
Ft(ignorespace)p Fu(.)630 518 y(Com)m(bining)c(these)h(t)m(w)m(o)g
(patterns,)h(separating)f(them)f(with)g(a)h(colon,)i(pro)m(vides)d(the)
h(func-)630 628 y(tionalit)m(y)33 b(of)d Ft(ignoreboth)p
Fu(.)150 792 y Ft(HISTSIZE)96 b Fu(The)37 b(maxim)m(um)g(n)m(um)m(b)s
(er)e(of)j(commands)f(to)g(remem)m(b)s(er)g(on)g(the)g(history)g(list.)
62 b(If)37 b(the)630 902 y(v)-5 b(alue)26 b(is)g(0,)i(commands)d(are)h
(not)h(sa)m(v)m(ed)g(in)e(the)h(history)g(list.)40 b(Numeric)26
b(v)-5 b(alues)26 b(less)g(than)630 1011 y(zero)i(result)e(in)h(ev)m
(ery)g(command)g(b)s(eing)f(sa)m(v)m(ed)i(on)f(the)g(history)f(list)i
(\(there)f(is)g(no)g(limit\).)630 1121 y(The)j(shell)g(sets)h(the)g
(default)f(v)-5 b(alue)31 b(to)g(500)h(after)f(reading)f(an)m(y)h
(startup)f(\014les.)150 1285 y Ft(HISTTIMEFORMAT)630
1395 y Fu(If)44 b(this)g(v)-5 b(ariable)45 b(is)f(set)g(and)g(not)g(n)m
(ull,)k(its)d(v)-5 b(alue)44 b(is)g(used)g(as)g(a)h(format)f(string)g
(for)630 1504 y Ft(strftime)p Fu(\(3\))37 b(to)i(prin)m(t)g(the)f(time)
h(stamp)f(asso)s(ciated)i(with)e(eac)m(h)i(history)e(en)m(try)h(dis-)
630 1614 y(pla)m(y)m(ed)k(b)m(y)f(the)h Ft(history)d
Fu(builtin.)76 b(If)42 b(this)g(v)-5 b(ariable)43 b(is)g(set,)j(the)c
(shell)h(writes)f(time)630 1724 y(stamps)32 b(to)g(the)h(history)e
(\014le)i(so)f(they)g(ma)m(y)g(b)s(e)g(preserv)m(ed)f(across)i(shell)f
(sessions.)46 b(This)630 1833 y(uses)32 b(the)h(history)g(commen)m(t)h
(c)m(haracter)g(to)g(distinguish)e(timestamps)h(from)f(other)h(his-)630
1943 y(tory)e(lines.)150 2107 y Ft(HOSTFILE)96 b Fu(Con)m(tains)33
b(Shell)30 b(V)-8 b(ariables)2459 b(95)630 299 y(v)-5
b(alue)28 b(of)f Ft(HISTIGNORE)p Fu(.)37 b(If)27 b(the)g(\014rst)g
(line)h(w)m(as)f(not)h(sa)m(v)m(ed,)h(the)f(second)f(and)g(subsequen)m
(t)630 408 y(lines)35 b(of)g(the)f(command)h(are)g(not)g(sa)m(v)m(ed)g
(either.)54 b(The)34 b(pattern)h(matc)m(hing)h(honors)e(the)630
518 y(setting)d(of)g(the)g Ft(extglob)d Fu(shell)j(option.)630
651 y Ft(HISTIGNORE)g Fu(subsumes)h(some)i(of)g(the)g(function)g(of)g
Ft(HISTCONTROL)p Fu(.)48 b(A)34 b(pattern)g(of)g(`)p
Ft(&)p Fu(')630 760 y(is)28 b(iden)m(tical)h(to)f Ft(ignoredups)p
Fu(,)d(and)i(a)h(pattern)g(of)f(`)p Ft([)k(]*)p Fu(')c(is)g(iden)m
(tical)j(to)e Ft(ignorespace)p Fu(.)630 870 y(Com)m(bining)c(these)h(t)
m(w)m(o)g(patterns,)h(separating)f(them)f(with)g(a)h(colon,)i(pro)m
(vides)d(the)h(func-)630 979 y(tionalit)m(y)33 b(of)d
Ft(ignoreboth)p Fu(.)150 1135 y Ft(HISTSIZE)96 b Fu(The)37
b(maxim)m(um)g(n)m(um)m(b)s(er)e(of)j(commands)f(to)g(remem)m(b)s(er)g
(on)g(the)g(history)g(list.)62 b(If)37 b(the)630 1245
y(v)-5 b(alue)26 b(is)g(0,)i(commands)d(are)h(not)h(sa)m(v)m(ed)g(in)e
(the)h(history)g(list.)40 b(Numeric)26 b(v)-5 b(alues)26
b(less)g(than)630 1354 y(zero)i(result)e(in)h(ev)m(ery)g(command)g(b)s
(eing)f(sa)m(v)m(ed)i(on)f(the)g(history)f(list)i(\(there)f(is)g(no)g
(limit\).)630 1464 y(The)j(shell)g(sets)h(the)g(default)f(v)-5
b(alue)31 b(to)g(500)h(after)f(reading)f(an)m(y)h(startup)f(\014les.)
150 1620 y Ft(HISTTIMEFORMAT)630 1729 y Fu(If)44 b(this)g(v)-5
b(ariable)45 b(is)f(set)g(and)g(not)g(n)m(ull,)k(its)d(v)-5
b(alue)44 b(is)g(used)g(as)g(a)h(format)f(string)g(for)630
1839 y Ft(strftime)p Fu(\(3\))37 b(to)i(prin)m(t)g(the)f(time)h(stamp)f
(asso)s(ciated)i(with)e(eac)m(h)i(history)e(en)m(try)h(dis-)630
1948 y(pla)m(y)m(ed)k(b)m(y)f(the)h Ft(history)d Fu(builtin.)76
b(If)42 b(this)g(v)-5 b(ariable)43 b(is)g(set,)j(the)c(shell)h(writes)f
(time)630 2058 y(stamps)32 b(to)g(the)h(history)e(\014le)i(so)f(they)g
(ma)m(y)g(b)s(e)g(preserv)m(ed)f(across)i(shell)f(sessions.)46
b(This)630 2168 y(uses)32 b(the)h(history)g(commen)m(t)h(c)m(haracter)g
(to)g(distinguish)e(timestamps)h(from)f(other)h(his-)630
2277 y(tory)e(lines.)150 2433 y Ft(HOSTFILE)96 b Fu(Con)m(tains)33
b(the)g(name)f(of)h(a)g(\014le)f(in)g(the)h(same)g(format)g(as)f
Ft(/etc/hosts)e Fu(that)j(should)f(b)s(e)630 2217 y(read)21
Ft(/etc/hosts)e Fu(that)j(should)f(b)s(e)630 2543 y(read)21
b(when)g(the)g(shell)h(needs)f(to)h(complete)h(a)e(hostname.)38
b(The)21 b(list)h(of)g(p)s(ossible)f(hostname)630 2326
b(The)21 b(list)h(of)g(p)s(ossible)f(hostname)630 2652
y(completions)27 b(ma)m(y)f(b)s(e)f(c)m(hanged)h(while)f(the)h(shell)g
(is)f(running;)h(the)g(next)f(time)i(hostname)630 2436
(is)f(running;)h(the)g(next)f(time)i(hostname)630 2762
y(completion)33 b(is)g(attempted)g(after)g(the)f(v)-5
b(alue)33 b(is)f(c)m(hanged,)i(Bash)e(adds)f(the)i(con)m(ten)m(ts)h(of)
630 2545 y(the)h(new)f(\014le)g(to)h(the)g(existing)h(list.)53
630 2871 y(the)h(new)f(\014le)g(to)h(the)g(existing)h(list.)53
b(If)34 b Ft(HOSTFILE)e Fu(is)j(set,)h(but)e(has)g(no)h(v)-5
b(alue,)36 b(or)e(do)s(es)630 2655 y(not)d(name)f(a)h(readable)g
b(alue,)36 b(or)e(do)s(es)630 2981 y(not)d(name)f(a)h(readable)g
(\014le,)g(Bash)f(attempts)i(to)f(read)f Ft(/etc/hosts)e
Fu(to)j(obtain)g(the)f(list)630 2765 y(of)38 b(p)s(ossible)f(hostname)g
Fu(to)j(obtain)g(the)f(list)630 3091 y(of)38 b(p)s(ossible)f(hostname)g
(completions.)63 b(When)37 b Ft(HOSTFILE)e Fu(is)j(unset,)h(Bash)e
(clears)i(the)630 2874 y(hostname)31 b(list.)150 3039
(clears)i(the)630 3200 y(hostname)31 b(list.)150 3356
y Ft(HOSTNAME)96 b Fu(The)30 b(name)g(of)h(the)f(curren)m(t)h(host.)150
3203 y Ft(HOSTTYPE)96 b Fu(A)30 b(string)h(describing)f(the)g(mac)m
(hine)h(Bash)g(is)f(running)f(on.)150 3367 y Ft(IGNOREEOF)630
3477 y Fu(Con)m(trols)e(the)h(action)g(of)f(the)g(shell)g(on)g(receipt)
3512 y Ft(HOSTTYPE)96 b Fu(A)30 b(string)h(describing)f(the)g(mac)m
(hine)h(Bash)g(is)f(running)f(on.)150 3667 y Ft(IGNOREEOF)630
3777 y Fu(Con)m(trols)e(the)h(action)g(of)f(the)g(shell)g(on)g(receipt)
h(of)f(an)g Ft(EOF)f Fu(c)m(haracter)i(as)g(the)f(sole)h(input.)630
3587 y(If)33 b(set,)i(the)e(v)-5 b(alue)34 b(is)f(the)h(n)m(um)m(b)s
3886 y(If)33 b(set,)i(the)e(v)-5 b(alue)34 b(is)f(the)h(n)m(um)m(b)s
(er)e(of)h(consecutiv)m(e)j Ft(EOF)c Fu(c)m(haracters)j(that)f(can)f(b)
s(e)g(read)630 3696 y(as)h(the)g(\014rst)f(c)m(haracter)j(on)d(an)h
s(e)g(read)630 3996 y(as)h(the)g(\014rst)f(c)m(haracter)j(on)d(an)h
(input)f(line)h(b)s(efore)g(Bash)g(exits.)51 b(If)34
b(the)g(v)-5 b(ariable)35 b(is)e(set)630 3806 y(but)e(do)s(es)g(not)h
b(the)g(v)-5 b(ariable)35 b(is)e(set)630 4106 y(but)e(do)s(es)g(not)h
(ha)m(v)m(e)h(a)f(n)m(umeric)f(v)-5 b(alue,)33 b(or)e(the)h(v)-5
b(alue)32 b(is)f(n)m(ull,)i(then)e(the)h(default)f(is)h(10.)630
3915 y(If)e(the)g(v)-5 b(ariable)31 b(is)g(unset,)f(then)g
4215 y(If)e(the)g(v)-5 b(ariable)31 b(is)g(unset,)f(then)g
Ft(EOF)f Fu(signi\014es)h(the)h(end)e(of)i(input)e(to)i(the)g(shell.)40
b(This)30 b(is)630 4025 y(only)g(in)h(e\013ect)g(for)g(in)m(teractiv)m
(e)i(shells.)150 4189 y Ft(INPUTRC)144 b Fu(The)68 b(name)h(of)f(the)h
b(This)30 b(is)630 4325 y(only)g(in)h(e\013ect)g(for)g(in)m(teractiv)m
(e)i(shells.)150 4481 y Ft(INPUTRC)144 b Fu(The)68 b(name)h(of)f(the)h
(Readline)g(initialization)j(\014le,)78 b(o)m(v)m(erriding)69
b(the)g(default)g(of)630 4299 y Ft(~/.inputrc)p Fu(.)150
4463 y Ft(INSIDE_EMACS)630 4573 y Fu(If)29 b(Bash)h(\014nds)e(this)h(v)
b(the)g(default)g(of)630 4590 y Ft(~/.inputrc)p Fu(.)150
4746 y Ft(INSIDE_EMACS)630 4855 y Fu(If)29 b(Bash)h(\014nds)e(this)h(v)
-5 b(ariable)31 b(in)e(the)h(en)m(vironmen)m(t)g(when)e(the)i(shell)g
(starts,)g(it)g(assumes)630 4682 y(that)i(the)g(shell)g(is)f(running)f
(starts,)g(it)g(assumes)630 4965 y(that)i(the)g(shell)g(is)f(running)f
(in)i(an)f(Emacs)h(shell)g(bu\013er)e(and)h(ma)m(y)i(disable)e(line)h
(editing)630 4792 y(dep)s(ending)d(on)h(the)h(v)-5 b(alue)31
b(of)f Ft(TERM)p Fu(.)150 4956 y Ft(LANG)288 b Fu(Used)28
(editing)630 5075 y(dep)s(ending)d(on)h(the)h(v)-5 b(alue)31
b(of)f Ft(TERM)p Fu(.)150 5230 y Ft(LANG)288 b Fu(Used)28
b(to)h(determine)f(the)g(lo)s(cale)h(category)h(for)e(an)m(y)h
(category)h(not)e(sp)s(eci\014cally)g(selected)630 5066
(category)h(not)e(sp)s(eci\014cally)g(selected)630 5340
y(with)i(a)h(v)-5 b(ariable)31 b(starting)g(with)f Ft(LC_)p
Fu(.)150 5230 y Ft(LC_ALL)192 b Fu(This)28 b(v)-5 b(ariable)29
b(o)m(v)m(errides)h(the)f(v)-5 b(alue)29 b(of)g Ft(LANG)f
Fu(and)g(an)m(y)h(other)g Ft(LC_)f Fu(v)-5 b(ariable)29
b(sp)s(ecifying)630 5340 y(a)i(lo)s(cale)h(category)-8
b(.)p eop end
Fu(.)p eop end
%%Page: 96 102
TeXDict begin 96 101 bop 150 -116 a Fu(Chapter)30 b(5:)41
b(Shell)30 b(V)-8 b(ariables)2459 b(96)150 299 y Ft(LC_COLLATE)630
408 y Fu(This)37 b(v)-5 b(ariable)38 b(determines)g(the)g(collation)i
b(Shell)30 b(V)-8 b(ariables)2459 b(96)150 299 y Ft(LC_ALL)192
b Fu(This)28 b(v)-5 b(ariable)29 b(o)m(v)m(errides)h(the)f(v)-5
b(alue)29 b(of)g Ft(LANG)f Fu(and)g(an)m(y)h(other)g
Ft(LC_)f Fu(v)-5 b(ariable)29 b(sp)s(ecifying)630 408
y(a)i(lo)s(cale)h(category)-8 b(.)150 565 y Ft(LC_COLLATE)630
675 y Fu(This)37 b(v)-5 b(ariable)38 b(determines)g(the)g(collation)i
(order)d(used)g(when)f(sorting)i(the)g(results)g(of)630
518 y(\014lename)e(expansion,)i(and)e(determines)g(the)h(b)s(eha)m
(vior)f(of)g(range)h(expressions,)h(equiv-)630 628 y(alence)e(classes,)
784 y(\014lename)e(expansion,)i(and)e(determines)g(the)h(b)s(eha)m
(vior)f(of)g(range)h(expressions,)h(equiv-)630 894 y(alence)e(classes,)
h(and)e(collating)i(sequences)e(within)f(\014lename)h(expansion)g(and)f
(pattern)630 737 y(matc)m(hing)d(\(see)h(Section)f(3.5.8)h([Filename)g
(Expansion],)e(page)h(39\).)150 897 y Ft(LC_CTYPE)96
(pattern)630 1003 y(matc)m(hing)d(\(see)h(Section)f(3.5.8)h([Filename)g
(Expansion],)e(page)h(39\).)150 1160 y Ft(LC_CTYPE)96
b Fu(This)36 b(v)-5 b(ariable)37 b(determines)f(the)h(in)m
(terpretation)h(of)f(c)m(haracters)h(and)e(the)g(b)s(eha)m(vior)h(of)
630 1007 y(c)m(haracter)46 b(classes)g(within)e(\014lename)h(expansion)
g(and)f(pattern)h(matc)m(hing)h(\(see)f(Sec-)630 1117
630 1270 y(c)m(haracter)46 b(classes)g(within)e(\014lename)h(expansion)
g(and)f(pattern)h(matc)m(hing)h(\(see)f(Sec-)630 1379
y(tion)31 b(3.5.8)h([Filename)g(Expansion],)e(page)h(39\).)150
1277 y Ft(LC_MESSAGES)630 1386 y Fu(This)25 b(v)-5 b(ariable)27
1536 y Ft(LC_MESSAGES)630 1645 y Fu(This)25 b(v)-5 b(ariable)27
b(determines)f(the)g(lo)s(cale)i(used)d(to)i(translate)g(double-quoted)
f(strings)g(pre-)630 1496 y(ceded)31 b(b)m(y)f(a)h(`)p
f(strings)g(pre-)630 1755 y(ceded)31 b(b)m(y)f(a)h(`)p
Ft($)p Fu(')f(\(see)h(Section)h(3.1.2.5)g([Lo)s(cale)g(T)-8
b(ranslation],)32 b(page)f(7\).)150 1656 y Ft(LC_NUMERIC)630
1766 y Fu(This)f(v)-5 b(ariable)31 b(determines)f(the)h(lo)s(cale)h
b(ranslation],)32 b(page)f(7\).)150 1911 y Ft(LC_NUMERIC)630
2021 y Fu(This)f(v)-5 b(ariable)31 b(determines)f(the)h(lo)s(cale)h
(category)g(used)e(for)g(n)m(um)m(b)s(er)f(formatting.)150
1926 y Ft(LC_TIME)144 b Fu(This)25 b(v)-5 b(ariable)26
2178 y Ft(LC_TIME)144 b Fu(This)25 b(v)-5 b(ariable)26
b(determines)g(the)g(lo)s(cale)h(category)h(used)d(for)g(data)h(and)f
(time)i(formatting.)150 2086 y Ft(LINENO)192 b Fu(The)30
(time)i(formatting.)150 2334 y Ft(LINENO)192 b Fu(The)30
b(line)h(n)m(um)m(b)s(er)e(in)h(the)g(script)h(or)f(shell)h(function)f
(curren)m(tly)g(executing.)42 b(Line)30 b(n)m(um-)630
2196 y(b)s(ers)c(start)h(with)g(1.)40 b(When)27 b(not)g(in)g(a)g
2444 y(b)s(ers)c(start)h(with)g(1.)40 b(When)27 b(not)g(in)g(a)g
(script)g(or)g(function,)h(the)f(v)-5 b(alue)28 b(is)f(not)g(guaran)m
(teed)630 2305 y(to)k(b)s(e)e(meaningful.)40 b(If)30
(teed)630 2553 y(to)k(b)s(e)e(meaningful.)40 b(If)30
b Ft(LINENO)e Fu(is)i(unset,)g(it)g(loses)h(its)f(sp)s(ecial)g(prop)s
(erties,)g(ev)m(en)h(if)e(it)i(is)630 2415 y(subsequen)m(tly)f(reset.)
150 2575 y Ft(LINES)240 b Fu(Used)43 b(b)m(y)g(the)g
(erties,)g(ev)m(en)h(if)e(it)i(is)630 2663 y(subsequen)m(tly)f(reset.)
150 2819 y Ft(LINES)240 b Fu(Used)43 b(b)m(y)g(the)g
Ft(select)e Fu(command)i(to)g(determine)g(the)g(column)g(length)g(for)g
(prin)m(ting)630 2685 y(selection)c(lists.)63 b(Automatically)41
(prin)m(ting)630 2929 y(selection)c(lists.)63 b(Automatically)41
b(set)d(if)f(the)h Ft(checkwinsize)d Fu(option)j(is)f(enabled)h(\(see)
630 2794 y(Section)44 b(4.3.2)h([The)e(Shopt)g(Builtin],)k(page)d
630 3039 y(Section)44 b(4.3.2)h([The)e(Shopt)g(Builtin],)k(page)d
(78\),)k(or)43 b(in)g(an)g(in)m(teractiv)m(e)j(shell)e(up)s(on)630
2904 y(receipt)31 b(of)g(a)g Ft(SIGWINCH)p Fu(.)150 3064
3148 y(receipt)31 b(of)g(a)g Ft(SIGWINCH)p Fu(.)150 3305
y Ft(MACHTYPE)96 b Fu(A)26 b(string)g(that)h(fully)f(describ)s(es)f
(the)h(system)g(t)m(yp)s(e)h(on)f(whic)m(h)f(Bash)i(is)f(executing,)i
(in)e(the)630 3173 y(standard)k Fm(gnu)g Fr(cpu-compan)m(y-system)h
Fu(format.)150 3334 y Ft(MAILCHECK)630 3443 y Fu(Ho)m(w)d(often)g(\(in)
(in)e(the)630 3414 y(standard)k Fm(gnu)g Fr(cpu-compan)m(y-system)h
Fu(format.)150 3571 y Ft(MAILCHECK)630 3680 y Fu(Ho)m(w)d(often)g(\(in)
g(seconds\))g(that)g(the)f(shell)h(should)f(c)m(hec)m(k)i(for)e(mail)h
(in)f(the)h(\014les)g(sp)s(eci\014ed)630 3553 y(in)i(the)h
(in)f(the)h(\014les)g(sp)s(eci\014ed)630 3790 y(in)i(the)h
Ft(MAILPATH)e Fu(or)i Ft(MAIL)e Fu(v)-5 b(ariables.)43
b(The)30 b(default)h(is)f(60)i(seconds.)42 b(When)30
b(it)h(is)g(time)630 3662 y(to)37 b(c)m(hec)m(k)h(for)e(mail,)j(the)e
b(it)h(is)g(time)630 3900 y(to)37 b(c)m(hec)m(k)h(for)e(mail,)j(the)e
(shell)f(do)s(es)g(so)h(b)s(efore)f(displa)m(ying)h(the)f(primary)g
(prompt.)57 b(If)630 3772 y(this)37 b(v)-5 b(ariable)38
(prompt.)57 b(If)630 4009 y(this)37 b(v)-5 b(ariable)38
b(is)f(unset,)h(or)f(set)h(to)g(a)f(v)-5 b(alue)38 b(that)f(is)g(not)h
(a)f(n)m(um)m(b)s(er)f(greater)i(than)f(or)630 3882 y(equal)31
(a)f(n)m(um)m(b)s(er)f(greater)i(than)f(or)630 4119 y(equal)31
b(to)g(zero,)g(the)g(shell)g(disables)f(mail)h(c)m(hec)m(king.)150
4042 y Ft(MAPFILE)144 b Fu(An)35 b(arra)m(y)h(v)-5 b(ariable)36
4275 y Ft(MAPFILE)144 b Fu(An)35 b(arra)m(y)h(v)-5 b(ariable)36
b(created)g(to)h(hold)e(the)g(text)i(read)e(b)m(y)g(the)h
Ft(mapfile)d Fu(builtin)i(when)630 4151 y(no)30 b(v)-5
b(ariable)31 b(name)g(is)f(supplied.)150 4312 y Ft(OLDPWD)192
Ft(mapfile)d Fu(builtin)i(when)630 4385 y(no)30 b(v)-5
b(ariable)31 b(name)g(is)f(supplied.)150 4542 y Ft(OLDPWD)192
b Fu(The)30 b(previous)g(w)m(orking)g(directory)h(as)g(set)g(b)m(y)f
(the)h Ft(cd)e Fu(builtin.)150 4472 y Ft(OPTERR)192 b
(the)h Ft(cd)e Fu(builtin.)150 4698 y Ft(OPTERR)192 b
Fu(If)35 b(set)i(to)f(the)h(v)-5 b(alue)36 b(1,)i(Bash)e(displa)m(ys)g
(error)f(messages)i(generated)g(b)m(y)f(the)g Ft(getopts)630
4581 y Fu(builtin)30 b(command.)40 b Ft(OPTERR)29 b Fu(is)i
4808 y Fu(builtin)30 b(command.)40 b Ft(OPTERR)29 b Fu(is)i
(initialized)h(to)f(1)g(eac)m(h)g(time)g(the)g(shell)f(is)h(in)m(v)m
(ok)m(ed.)150 4741 y Ft(OSTYPE)192 b Fu(A)30 b(string)h(describing)f
(ok)m(ed.)150 4964 y Ft(OSTYPE)192 b Fu(A)30 b(string)h(describing)f
(the)g(op)s(erating)h(system)g(Bash)f(is)h(running)d(on.)150
4902 y Ft(PIPESTATUS)630 5011 y Fu(An)33 b(arra)m(y)g(v)-5
5121 y Ft(PIPESTATUS)630 5230 y Fu(An)33 b(arra)m(y)g(v)-5
b(ariable)34 b(\(see)g(Section)g(6.7)g([Arra)m(ys],)h(page)f(110\))h
(con)m(taining)f(a)g(list)g(of)f(exit)630 5121 y(status)47
(con)m(taining)f(a)g(list)g(of)f(exit)630 5340 y(status)47
b(v)-5 b(alues)46 b(from)g(the)g(commands)g(in)g(the)g(most-recen)m
(tly-executed)k(foreground)630 5230 y(pip)s(eline,)36
b(whic)m(h)f(ma)m(y)g(consist)h(of)f(only)h(a)f(simple)g(command)g
(\(see)h(Section)g(3.2)g([Shell)630 5340 y(Commands],)49
b(page)d(9\).)88 b(Bash)46 b(sets)g Ft(PIPESTATUS)c Fu(after)47
b(executing)g(m)m(ulti-elemen)m(t)p eop end
(tly-executed)k(foreground)p eop end
%%Page: 97 103
TeXDict begin 97 102 bop 150 -116 a Fu(Chapter)30 b(5:)41
b(Shell)30 b(V)-8 b(ariables)2459 b(97)630 299 y(pip)s(elines,)47
b(timed)c(and)h(negated)g(pip)s(elines,)j(simple)c(commands,)k
(subshells)c(created)630 408 y(with)f(the)h(`)p Ft(\()p
Fu(')f(op)s(erator,)k(the)c Ft([[)g Fu(and)g Ft(\(\()g
Fu(comp)s(ound)f(commands,)k(and)c(after)i(error)630
518 y(conditions)31 b(that)g(result)f(in)g(the)h(shell)f(ab)s(orting)h
(command)f(execution.)150 673 y Ft(POSIXLY_CORRECT)630
783 y Fu(If)i(this)g(v)-5 b(ariable)34 b(is)e(in)g(the)h(en)m(vironmen)
m(t)g(when)e(Bash)i(starts,)g(the)g(shell)g(en)m(ters)g
Fm(posix)630 892 y Fu(mo)s(de)46 b(\(see)h(Section)g(6.11)g([Bash)g
b(Shell)30 b(V)-8 b(ariables)2459 b(97)630 299 y(pip)s(eline,)36
b(whic)m(h)f(ma)m(y)g(consist)h(of)f(only)h(a)f(simple)g(command)g
(\(see)h(Section)g(3.2)g([Shell)630 408 y(Commands],)49
b(page)d(9\).)88 b(Bash)46 b(sets)g Ft(PIPESTATUS)c Fu(after)47
b(executing)g(m)m(ulti-elemen)m(t)630 518 y(pip)s(elines,)g(timed)c
(and)h(negated)g(pip)s(elines,)j(simple)c(commands,)k(subshells)c
(created)630 628 y(with)f(the)h(`)p Ft(\()p Fu(')f(op)s(erator,)k(the)c
Ft([[)g Fu(and)g Ft(\(\()g Fu(comp)s(ound)f(commands,)k(and)c(after)i
(error)630 737 y(conditions)31 b(that)g(result)f(in)g(the)h(shell)f(ab)
s(orting)h(command)f(execution.)150 907 y Ft(POSIXLY_CORRECT)630
1016 y Fu(If)i(this)g(v)-5 b(ariable)34 b(is)e(in)g(the)h(en)m
(vironmen)m(t)g(when)e(Bash)i(starts,)g(the)g(shell)g(en)m(ters)g
Fm(posix)630 1126 y Fu(mo)s(de)46 b(\(see)h(Section)g(6.11)g([Bash)g
(POSIX)e(Mo)s(de],)50 b(page)d(116\))h(b)s(efore)e(reading)g(the)630
1002 y(startup)38 b(\014les,)j(as)e(if)g(the)g Ft(--posix)d
1235 y(startup)38 b(\014les,)j(as)e(if)g(the)g Ft(--posix)d
Fu(in)m(v)m(o)s(cation)41 b(option)e(had)f(b)s(een)g(supplied.)64
b(If)39 b(it)g(is)630 1112 y(set)31 b(while)f(the)h(shell)f(is)h
b(If)39 b(it)g(is)630 1345 y(set)31 b(while)f(the)h(shell)f(is)h
(running,)e(Bash)h(enables)h Fm(posix)f Fu(mo)s(de,)g(as)g(if)h(the)f
(command)870 1244 y Ft(set)47 b(-o)g(posix)630 1377 y
(command)870 1484 y Ft(set)47 b(-o)g(posix)630 1624 y
Fu(had)33 b(b)s(een)g(executed.)51 b(When)33 b(the)h(shell)f(en)m(ters)
h Fm(posix)f Fu(mo)s(de,)h(it)g(sets)g(this)g(v)-5 b(ariable)34
b(if)630 1486 y(it)d(w)m(as)g(not)f(already)h(set.)150
1641 y Ft(PPID)288 b Fu(The)30 b(pro)s(cess)g Fm(id)g
b(if)630 1733 y(it)d(w)m(as)g(not)f(already)h(set.)150
1903 y Ft(PPID)288 b Fu(The)30 b(pro)s(cess)g Fm(id)g
Fu(of)h(the)f(shell's)h(paren)m(t)g(pro)s(cess.)40 b(This)30
b(v)-5 b(ariable)31 b(is)f(readonly)-8 b(.)150 1797 y
Ft(PROMPT_COMMAND)630 1906 y Fu(If)23 b(this)h(v)-5 b(ariable)24
b(v)-5 b(ariable)31 b(is)f(readonly)-8 b(.)150 2072 y
Ft(PROMPT_COMMAND)630 2182 y Fu(If)23 b(this)h(v)-5 b(ariable)24
b(is)g(set,)i(and)d(is)h(an)f(arra)m(y)-8 b(,)27 b(the)d(v)-5
b(alue)24 b(of)g(eac)m(h)g(set)h(elemen)m(t)g(is)f(in)m(terpreted)630
2016 y(as)29 b(a)g(command)f(to)i(execute)g(b)s(efore)e(prin)m(ting)h
2291 y(as)29 b(a)g(command)f(to)i(execute)g(b)s(efore)e(prin)m(ting)h
(the)g(primary)f(prompt)f(\()p Ft($PS1)p Fu(\).)40 b(If)28
b(this)h(is)630 2125 y(set)c(but)f(not)g(an)h(arra)m(y)g(v)-5
b(this)h(is)630 2401 y(set)c(but)f(not)g(an)h(arra)m(y)g(v)-5
b(ariable,)26 b(its)f(v)-5 b(alue)25 b(is)f(used)g(as)h(a)f(command)g
(to)i(execute)f(instead.)150 2281 y Ft(PROMPT_DIRTRIM)630
2390 y Fu(If)i(set)g(to)h(a)g(n)m(um)m(b)s(er)e(greater)i(than)f(zero,)
(to)i(execute)f(instead.)150 2570 y Ft(PROMPT_DIRTRIM)630
2680 y Fu(If)i(set)g(to)h(a)g(n)m(um)m(b)s(er)e(greater)i(than)f(zero,)
i(the)e(v)-5 b(alue)28 b(is)f(used)g(as)g(the)h(n)m(um)m(b)s(er)e(of)h
(trailing)630 2500 y(directory)c(comp)s(onen)m(ts)h(to)f(retain)h(when)
(trailing)630 2790 y(directory)c(comp)s(onen)m(ts)h(to)f(retain)h(when)
e(expanding)g(the)h Ft(\\w)g Fu(and)f Ft(\\W)g Fu(prompt)h(string)f
(es-)630 2609 y(cap)s(es)i(\(see)h(Section)g(6.9)g([Con)m(trolling)g
(es-)630 2899 y(cap)s(es)i(\(see)h(Section)g(6.9)g([Con)m(trolling)g
(the)f(Prompt],)i(page)e(114\).)41 b(Characters)24 b(remo)m(v)m(ed)630
2719 y(are)31 b(replaced)g(with)f(an)g(ellipsis.)150
2874 y Ft(PS0)336 b Fu(The)32 b(v)-5 b(alue)33 b(of)g(this)g(parameter)
3009 y(are)31 b(replaced)g(with)f(an)g(ellipsis.)150
3178 y Ft(PS0)336 b Fu(The)32 b(v)-5 b(alue)33 b(of)g(this)g(parameter)
g(is)g(expanded)e(lik)m(e)j Ft(PS1)e Fu(and)g(displa)m(y)m(ed)i(b)m(y)e
(in)m(teractiv)m(e)630 2984 y(shells)e(after)h(reading)g(a)g(command)f
(in)m(teractiv)m(e)630 3288 y(shells)e(after)h(reading)g(a)g(command)f
(and)f(b)s(efore)h(the)h(command)f(is)h(executed.)150
3139 y Ft(PS3)336 b Fu(The)34 b(v)-5 b(alue)35 b(of)f(this)g(v)-5
3457 y Ft(PS3)336 b Fu(The)34 b(v)-5 b(alue)35 b(of)f(this)g(v)-5
b(ariable)35 b(is)g(used)e(as)i(the)f(prompt)g(for)g(the)g
Ft(select)f Fu(command.)52 b(If)630 3249 y(this)30 b(v)-5
Ft(select)f Fu(command.)52 b(If)630 3567 y(this)30 b(v)-5
b(ariable)31 b(is)g(not)f(set,)i(the)e Ft(select)f Fu(command)h
(prompts)f(with)h(`)p Ft(#?)g Fu(')150 3404 y Ft(PS4)336
(prompts)f(with)h(`)p Ft(#?)g Fu(')150 3736 y Ft(PS4)336
b Fu(The)38 b(v)-5 b(alue)39 b(of)g(this)g(parameter)g(is)g(expanded)f
(lik)m(e)i Ft(PS1)e Fu(and)g(the)h(expanded)f(v)-5 b(alue)39
b(is)630 3513 y(the)c(prompt)f(prin)m(ted)g(b)s(efore)g(the)h(command)f
b(is)630 3846 y(the)c(prompt)f(prin)m(ted)g(b)s(efore)g(the)h(command)f
(line)h(is)g(ec)m(ho)s(ed)g(when)f(the)h Ft(-x)f Fu(option)h(is)630
3623 y(set)k(\(see)h(Section)g(4.3.1)g([The)f(Set)g(Builtin],)j(page)e
3955 y(set)k(\(see)h(Section)g(4.3.1)g([The)f(Set)g(Builtin],)j(page)e
(74\).)67 b(The)38 b(\014rst)g(c)m(haracter)j(of)e(the)630
3733 y(expanded)33 b(v)-5 b(alue)33 b(is)h(replicated)g(m)m(ultiple)g
4065 y(expanded)33 b(v)-5 b(alue)33 b(is)h(replicated)g(m)m(ultiple)g
(times,)h(as)f(necessary)-8 b(,)35 b(to)f(indicate)g(m)m(ultiple)630
3842 y(lev)m(els)e(of)e(indirection.)42 b(The)29 b(default)i(is)f(`)p
Ft(+)h Fu('.)150 3998 y Ft(PWD)336 b Fu(The)30 b(curren)m(t)g(w)m
4174 y(lev)m(els)e(of)e(indirection.)42 b(The)29 b(default)i(is)f(`)p
Ft(+)h Fu('.)150 4344 y Ft(PWD)336 b Fu(The)30 b(curren)m(t)g(w)m
(orking)h(directory)g(as)f(set)h(b)m(y)f(the)h Ft(cd)f
Fu(builtin.)150 4153 y Ft(RANDOM)192 b Fu(Eac)m(h)26
Fu(builtin.)150 4513 y Ft(RANDOM)192 b Fu(Eac)m(h)26
b(time)g(this)f(parameter)h(is)g(referenced,)g(it)g(expands)f(to)h(a)g
(random)e(in)m(teger)j(b)s(et)m(w)m(een)630 4262 y(0)39
(random)e(in)m(teger)j(b)s(et)m(w)m(een)630 4623 y(0)39
b(and)e(32767.)66 b(Assigning)39 b(a)f(v)-5 b(alue)39
b(to)f Ft(RANDOM)f Fu(initializes)j(\(seeds\))f(the)f(sequence)h(of)630
4372 y(random)c(n)m(um)m(b)s(ers.)56 b(Seeding)36 b(the)g(random)f(n)m
4732 y(random)c(n)m(um)m(b)s(ers.)56 b(Seeding)36 b(the)g(random)f(n)m
(um)m(b)s(er)g(generator)i(with)f(the)g(same)g(con-)630
4482 y(stan)m(t)f(v)-5 b(alue)35 b(pro)s(duces)e(the)i(same)g(sequence)
4842 y(stan)m(t)f(v)-5 b(alue)35 b(pro)s(duces)e(the)i(same)g(sequence)
f(of)h(v)-5 b(alues.)53 b(If)34 b Ft(RANDOM)f Fu(is)h(unset,)h(it)g
(loses)630 4591 y(its)c(sp)s(ecial)g(prop)s(erties,)f(ev)m(en)h(if)f
(it)h(is)f(subsequen)m(tly)g(reset.)150 4746 y Ft(READLINE_ARGUMENT)630
4856 y Fu(An)m(y)37 b(n)m(umeric)f(argumen)m(t)h(giv)m(en)g(to)g(a)g
(loses)630 4951 y(its)c(sp)s(ecial)g(prop)s(erties,)f(ev)m(en)h(if)f
(it)h(is)f(subsequen)m(tly)g(reset.)150 5121 y Ft(READLINE_ARGUMENT)630
5230 y Fu(An)m(y)37 b(n)m(umeric)f(argumen)m(t)h(giv)m(en)g(to)g(a)g
(Readline)g(command)f(that)h(w)m(as)g(de\014ned)e(using)630
4966 y(`)p Ft(bind)29 b(-x)p Fu(')h(\(see)i(Section)f(4.2)g([Bash)g
(Builtins],)g(page)h(61,)f(when)e(it)i(w)m(as)g(in)m(v)m(ok)m(ed.)150
5121 y Ft(READLINE_LINE)630 5230 y Fu(The)c(con)m(ten)m(ts)i(of)f(the)g
(Readline)g(line)g(bu\013er,)f(for)h(use)f(with)g(`)p
Ft(bind)j(-x)p Fu(')d(\(see)h(Section)h(4.2)630 5340
y([Bash)i(Builtins],)g(page)g(61\).)p eop end
5340 y(`)p Ft(bind)29 b(-x)p Fu(')h(\(see)i(Section)f(4.2)g([Bash)g
(Builtins],)g(page)h(61,)f(when)e(it)i(w)m(as)g(in)m(v)m(ok)m(ed.)p
eop end
%%Page: 98 104
TeXDict begin 98 103 bop 150 -116 a Fu(Chapter)30 b(5:)41
b(Shell)30 b(V)-8 b(ariables)2459 b(98)150 299 y Ft(READLINE_MARK)630
408 y Fu(The)26 b(p)s(osition)h(of)g(the)g Fr(mark)32
b Fu(\(sa)m(v)m(ed)c(insertion)f(p)s(oin)m(t\))g(in)g(the)g(Readline)g
(line)g(bu\013er,)g(for)630 518 y(use)36 b(with)f(`)p
b(Shell)30 b(V)-8 b(ariables)2459 b(98)150 299 y Ft(READLINE_LINE)630
408 y Fu(The)27 b(con)m(ten)m(ts)i(of)f(the)g(Readline)g(line)g
(bu\013er,)f(for)h(use)f(with)g(`)p Ft(bind)j(-x)p Fu(')d(\(see)h
(Section)h(4.2)630 518 y([Bash)i(Builtins],)g(page)g(61\).)150
676 y Ft(READLINE_MARK)630 786 y Fu(The)26 b(p)s(osition)h(of)g(the)g
Fr(mark)32 b Fu(\(sa)m(v)m(ed)c(insertion)f(p)s(oin)m(t\))g(in)g(the)g
(Readline)g(line)g(bu\013er,)g(for)630 896 y(use)36 b(with)f(`)p
Ft(bind)30 b(-x)p Fu(')35 b(\(see)i(Section)g(4.2)g([Bash)f(Builtins],)
i(page)f(61\).)58 b(The)35 b(c)m(haracters)630 628 y(b)s(et)m(w)m(een)c
(the)g(insertion)f(p)s(oin)m(t)g(and)g(the)h(mark)f(are)h(often)f
(called)i(the)f Fr(region)p Fu(.)150 792 y Ft(READLINE_POINT)630
902 y Fu(The)23 b(p)s(osition)g(of)g(the)h(insertion)f(p)s(oin)m(t)g
i(page)f(61\).)58 b(The)35 b(c)m(haracters)630 1005 y(b)s(et)m(w)m(een)
c(the)g(insertion)f(p)s(oin)m(t)g(and)g(the)h(mark)f(are)h(often)f
(called)i(the)f Fr(region)p Fu(.)150 1163 y Ft(READLINE_POINT)630
1273 y Fu(The)23 b(p)s(osition)g(of)g(the)h(insertion)f(p)s(oin)m(t)g
(in)g(the)g(Readline)h(line)f(bu\013er,)h(for)f(use)g(with)g(`)p
Ft(bind)630 1011 y(-x)p Fu(')30 b(\(see)h(Section)h(4.2)f([Bash)g
(Builtins],)g(page)g(61\).)150 1176 y Ft(REPLY)240 b
Ft(bind)630 1383 y(-x)p Fu(')30 b(\(see)h(Section)h(4.2)f([Bash)g
(Builtins],)g(page)g(61\).)150 1541 y Ft(REPLY)240 b
Fu(The)29 b(default)h(v)-5 b(ariable)30 b(for)f(the)h
Ft(read)e Fu(builtin;)i(set)g(to)g(the)f(line)h(read)f(when)g
Ft(read)f Fu(is)i(not)630 1285 y(supplied)f(a)i(v)-5
b(ariable)31 b(name)f(argumen)m(t.)150 1450 y Ft(SECONDS)144
Ft(read)f Fu(is)i(not)630 1650 y(supplied)f(a)i(v)-5
b(ariable)31 b(name)f(argumen)m(t.)150 1809 y Ft(SECONDS)144
b Fu(This)40 b(v)-5 b(ariable)41 b(expands)f(to)h(the)g(n)m(um)m(b)s
(er)e(of)i(seconds)g(since)g(the)f(shell)h(w)m(as)g(started.)630
1559 y(Assignmen)m(t)i(to)g(this)g(v)-5 b(ariable)43
1918 y(Assignmen)m(t)i(to)g(this)g(v)-5 b(ariable)43
b(resets)g(the)g(coun)m(t)g(to)g(the)g(v)-5 b(alue)43
b(assigned,)j(and)c(the)630 1669 y(expanded)35 b(v)-5
b(assigned,)j(and)c(the)630 2028 y(expanded)35 b(v)-5
b(alue)36 b(b)s(ecomes)h(the)f(v)-5 b(alue)36 b(assigned)g(plus)f(the)h
(n)m(um)m(b)s(er)f(of)h(seconds)g(since)630 1778 y(the)24
(n)m(um)m(b)s(er)f(of)h(seconds)g(since)630 2138 y(the)24
b(assignmen)m(t.)39 b(The)23 b(n)m(um)m(b)s(er)g(of)h(seconds)f(at)i
(shell)f(in)m(v)m(o)s(cation)i(and)d(the)h(curren)m(t)f(time)630
1888 y(are)h(alw)m(a)m(ys)h(determined)e(b)m(y)g(querying)g(the)g
2247 y(are)h(alw)m(a)m(ys)h(determined)e(b)m(y)g(querying)g(the)g
(system)h(clo)s(c)m(k)g(at)g(one-second)g(resolution.)39
b(If)630 1998 y Ft(SECONDS)28 b Fu(is)h(unset,)h(it)g(loses)h(its)f(sp)
b(If)630 2357 y Ft(SECONDS)28 b Fu(is)h(unset,)h(it)g(loses)h(its)f(sp)
s(ecial)g(prop)s(erties,)g(ev)m(en)g(if)g(it)g(is)g(subsequen)m(tly)f
(reset.)150 2162 y Ft(SHELL)240 b Fu(This)24 b(en)m(vironmen)m(t)i(v)-5
(reset.)150 2515 y Ft(SHELL)240 b Fu(This)24 b(en)m(vironmen)m(t)i(v)-5
b(ariable)26 b(expands)e(to)i(the)g(full)f(pathname)g(to)h(the)f
(shell.)39 b(If)25 b(it)g(is)h(not)630 2271 y(set)36
(shell.)39 b(If)25 b(it)g(is)h(not)630 2625 y(set)36
b(when)f(the)h(shell)g(starts,)i(Bash)e(assigns)h(to)f(it)h(the)f(full)
f(pathname)h(of)g(the)g(curren)m(t)630 2381 y(user's)30
b(login)h(shell.)150 2545 y Ft(SHELLOPTS)630 2655 y Fu(A)g
f(pathname)h(of)g(the)g(curren)m(t)630 2734 y(user's)30
b(login)h(shell.)150 2892 y Ft(SHELLOPTS)630 3002 y Fu(A)g
(colon-separated)h(list)f(of)g(enabled)f(shell)h(options.)41
b(Eac)m(h)31 b(w)m(ord)f(in)g(the)h(list)g(is)g(a)g(v)-5
b(alid)630 2765 y(argumen)m(t)28 b(for)f(the)h Ft(-o)e
b(alid)630 3112 y(argumen)m(t)28 b(for)f(the)h Ft(-o)e
Fu(option)i(to)g(the)g Ft(set)e Fu(builtin)h(command)g(\(see)i(Section)
f(4.3.1)h([The)630 2874 y(Set)g(Builtin],)h(page)f(74\).)42
f(4.3.1)h([The)630 3221 y(Set)g(Builtin],)h(page)f(74\).)42
b(The)28 b(options)h(app)s(earing)f(in)g Ft(SHELLOPTS)e
Fu(are)j(those)h(rep)s(orted)630 2984 y(as)40 b(`)p Ft(on)p
Fu(are)j(those)h(rep)s(orted)630 3331 y(as)40 b(`)p Ft(on)p
Fu(')g(b)m(y)h(`)p Ft(set)29 b(-o)p Fu('.)70 b(If)40
b(this)g(v)-5 b(ariable)41 b(is)f(in)g(the)g(en)m(vironmen)m(t)h(when)e
(Bash)i(starts)630 3093 y(up,)31 b(the)g(shell)g(enables)h(eac)m(h)g
(Bash)i(starts)630 3440 y(up,)31 b(the)g(shell)g(enables)h(eac)m(h)g
(option)g(in)f(the)g(list)h(b)s(efore)f(reading)g(an)m(y)h(startup)e
(\014les.)43 b(If)630 3203 y(this)35 b(v)-5 b(ariable)36
(\014les.)43 b(If)630 3550 y(this)35 b(v)-5 b(ariable)36
b(is)f(exp)s(orted,)i(c)m(hild)e(shells)g(will)h(enable)g(eac)m(h)g
(option)g(in)f(the)g(list.)56 b(This)630 3313 y(v)-5
b(ariable)31 b(is)g(readonly)-8 b(.)150 3477 y Ft(SHLVL)240
(option)g(in)f(the)g(list.)56 b(This)630 3660 y(v)-5
b(ariable)31 b(is)g(readonly)-8 b(.)150 3818 y Ft(SHLVL)240
b Fu(Incremen)m(ted)21 b(b)m(y)g(one)g(eac)m(h)h(time)f(a)h(new)e
(instance)h(of)g(Bash)g(is)g(started.)38 b(This)20 b(is)h(in)m(tended)
630 3587 y(to)31 b(b)s(e)f(a)h(coun)m(t)g(of)f(ho)m(w)h(deeply)f(y)m
(our)g(Bash)h(shells)f(are)h(nested.)150 3751 y Ft(SRANDOM)144
630 3927 y(to)31 b(b)s(e)f(a)h(coun)m(t)g(of)f(ho)m(w)h(deeply)f(y)m
(our)g(Bash)h(shells)f(are)h(nested.)150 4086 y Ft(SRANDOM)144
b Fu(This)36 b(v)-5 b(ariable)37 b(expands)f(to)h(a)g(32-bit)h
(pseudo-random)d(n)m(um)m(b)s(er)g(eac)m(h)j(time)f(it)g(is)g(ref-)630
3861 y(erenced.)47 b(The)32 b(random)g(n)m(um)m(b)s(er)f(generator)j
4195 y(erenced.)47 b(The)32 b(random)g(n)m(um)m(b)s(er)f(generator)j
(is)e(not)h(linear)g(on)f(systems)h(that)g(supp)s(ort)630
3970 y Ft(/dev/urandom)26 b Fu(or)k Ft(arc4random)p Fu(,)d(so)j(eac)m
4305 y Ft(/dev/urandom)26 b Fu(or)k Ft(arc4random)p Fu(,)d(so)j(eac)m
(h)g(returned)f(n)m(um)m(b)s(er)f(has)h(no)g(relationship)h(to)630
4080 y(the)39 b(n)m(um)m(b)s(ers)e(preceding)i(it.)66
4415 y(the)39 b(n)m(um)m(b)s(ers)e(preceding)i(it.)66
b(The)38 b(random)g(n)m(um)m(b)s(er)f(generator)j(cannot)g(b)s(e)e
(seeded,)630 4189 y(so)c(assignmen)m(ts)g(to)g(this)f(v)-5
(seeded,)630 4524 y(so)c(assignmen)m(ts)g(to)g(this)f(v)-5
b(ariable)34 b(ha)m(v)m(e)h(no)e(e\013ect.)51 b(If)33
b Ft(SRANDOM)e Fu(is)j(unset,)g(it)f(loses)i(its)630
4299 y(sp)s(ecial)c(prop)s(erties,)f(ev)m(en)h(if)f(it)h(is)g
(subsequen)m(tly)f(reset.)150 4463 y Ft(TIMEFORMAT)630
4573 y Fu(The)g(v)-5 b(alue)32 b(of)f(this)g(parameter)g(is)g(used)f
4634 y(sp)s(ecial)c(prop)s(erties,)f(ev)m(en)h(if)f(it)h(is)g
(subsequen)m(tly)f(reset.)150 4792 y Ft(TIMEFORMAT)630
4902 y Fu(The)g(v)-5 b(alue)32 b(of)f(this)g(parameter)g(is)g(used)f
(as)h(a)g(format)h(string)f(sp)s(ecifying)f(ho)m(w)h(the)g(tim-)630
4682 y(ing)37 b(information)f(for)h(pip)s(elines)f(pre\014xed)f(with)h
5011 y(ing)37 b(information)f(for)h(pip)s(elines)f(pre\014xed)f(with)h
(the)h Ft(time)e Fu(reserv)m(ed)i(w)m(ord)f(should)g(b)s(e)630
4792 y(displa)m(y)m(ed.)k(The)27 b(`)p Ft(\045)p Fu(')h(c)m(haracter)h
5121 y(displa)m(y)m(ed.)k(The)27 b(`)p Ft(\045)p Fu(')h(c)m(haracter)h
(in)m(tro)s(duces)e(an)h(escap)s(e)g(sequence)g(that)g(is)f(expanded)g
(to)630 4902 y(a)37 b(time)g(v)-5 b(alue)36 b(or)h(other)f
(to)630 5230 y(a)37 b(time)g(v)-5 b(alue)36 b(or)h(other)f
(information.)59 b(The)36 b(escap)s(e)g(sequences)h(and)e(their)i
(meanings)630 5011 y(are)31 b(as)f(follo)m(ws;)i(the)f(brac)m(k)m(ets)h
(denote)e(optional)i(p)s(ortions.)630 5176 y Ft(\045\045)384
b Fu(A)30 b(literal)i(`)p Ft(\045)p Fu('.)630 5340 y
Ft(\045[)p Fj(p)p Ft(][l]R)96 b Fu(The)30 b(elapsed)h(time)g(in)f
(seconds.)p eop end
(meanings)630 5340 y(are)31 b(as)f(follo)m(ws;)i(the)f(brac)m(k)m(ets)h
(denote)e(optional)i(p)s(ortions.)p eop end
%%Page: 99 105
TeXDict begin 99 104 bop 150 -116 a Fu(Chapter)30 b(5:)41
b(Shell)30 b(V)-8 b(ariables)2459 b(99)630 299 y Ft(\045[)p
Fj(p)p Ft(][l]U)96 b Fu(The)30 b(n)m(um)m(b)s(er)f(of)h(CPU)g(seconds)h
(sp)s(en)m(t)f(in)g(user)f(mo)s(de.)630 458 y Ft(\045[)p
Fj(p)p Ft(][l]S)96 b Fu(The)30 b(n)m(um)m(b)s(er)f(of)h(CPU)g(seconds)h
(sp)s(en)m(t)f(in)g(system)g(mo)s(de.)630 618 y Ft(\045P)384
b Fu(The)30 b(CPU)g(p)s(ercen)m(tage,)i(computed)e(as)h(\(\045U)f
Ft(+)g Fu(\045S\))g(/)h(\045R.)630 777 y(The)23 b(optional)j
Fr(p)g Fu(is)e(a)g(digit)h(sp)s(ecifying)e(the)h(precision,)i(the)e(n)m
(um)m(b)s(er)f(of)h(fractional)h(digits)630 887 y(after)36
b(a)f(decimal)i(p)s(oin)m(t.)55 b(A)35 b(v)-5 b(alue)36
b(of)f(0)h(causes)g(no)f(decimal)h(p)s(oin)m(t)f(or)h(fraction)g(to)g
(b)s(e)630 996 y(output.)77 b Ft(time)41 b Fu(prin)m(ts)h(at)h(most)g
(six)g(digits)g(after)g(the)g(decimal)g(p)s(oin)m(t;)49
b(v)-5 b(alues)43 b(of)g Fr(p)630 1106 y Fu(greater)34
b(than)f(6)h(are)f(c)m(hanged)h(to)g(6.)49 b(If)32 b
Fr(p)k Fu(is)d(not)g(sp)s(eci\014ed,)h Ft(time)d Fu(prin)m(ts)i(three)g
(digits)630 1215 y(after)e(the)f(decimal)i(p)s(oin)m(t.)630
1350 y(The)54 b(optional)h Ft(l)f Fu(sp)s(eci\014es)g(a)h(longer)f
(format,)61 b(including)54 b(min)m(utes,)61 b(of)54 b(the)g(form)630
1460 y Fr(MM)10 b Fu(m)p Fr(SS)p Fu(.)p Fr(FF)d Fu(s.)103
b(The)50 b(v)-5 b(alue)52 b(of)f Fr(p)j Fu(determines)d(whether)f(or)h
(not)h(the)f(fraction)h(is)630 1569 y(included.)630 1704
y(If)30 b(this)g(v)-5 b(ariable)31 b(is)g(not)f(set,)i(Bash)e(acts)h
(as)g(if)f(it)h(had)f(the)h(v)-5 b(alue)870 1838 y Ft
($'\\nreal\\t\0453lR\\nuser\\t\0453)o(lU\\n)o(sys\\)o(t\0453)o(lS')630
1973 y Fu(If)34 b(the)h(v)-5 b(alue)35 b(is)g(n)m(ull,)h(Bash)f(do)s
(es)f(not)h(displa)m(y)g(an)m(y)g(timing)g(information.)54
b(A)35 b(trailing)630 2082 y(newline)30 b(is)h(added)e(when)h(the)g
(format)h(string)f(is)h(displa)m(y)m(ed.)150 2242 y Ft(TMOUT)240
b Fu(If)27 b(set)i(to)f(a)g(v)-5 b(alue)28 b(greater)h(than)f(zero,)h
(the)f Ft(read)f Fu(builtin)g(uses)g(the)h(v)-5 b(alue)29
b(as)f(its)g(default)630 2351 y(timeout)33 b(\(see)f(Section)h(4.2)f
([Bash)g(Builtins],)h(page)f(61\).)46 b(The)31 b Ft(select)f
Fu(command)h(\(see)630 2461 y(Section)g(3.2.5.2)i([Conditional)f
(Constructs],)e(page)h(12\))h(terminates)f(if)g(input)f(do)s(es)g(not)
630 2570 y(arriv)m(e)h(after)g Ft(TMOUT)e Fu(seconds)h(when)g(input)f
(is)h(coming)i(from)d(a)i(terminal.)630 2705 y(In)40
b(an)h(in)m(teractiv)m(e)i(shell,)h(the)d(v)-5 b(alue)41
b(is)g(in)m(terpreted)g(as)f(the)h(n)m(um)m(b)s(er)f(of)h(seconds)f(to)
630 2814 y(w)m(ait)28 b(for)e(a)g(line)h(of)g(input)e(after)i(issuing)f
(the)h(primary)e(prompt.)39 b(Bash)26 b(terminates)h(after)630
2924 y(w)m(aiting)32 b(for)e(that)h(n)m(um)m(b)s(er)e(of)h(seconds)h
(if)f(a)h(complete)h(line)e(of)h(input)e(do)s(es)h(not)h(arriv)m(e.)150
3083 y Ft(TMPDIR)192 b Fu(If)39 b(set,)j(Bash)e(uses)f(its)h(v)-5
b(alue)40 b(as)f(the)h(name)f(of)h(a)g(directory)g(in)f(whic)m(h)g
(Bash)h(creates)630 3193 y(temp)s(orary)30 b(\014les)g(for)g(the)h
(shell's)g(use.)150 3352 y Ft(UID)336 b Fu(The)30 b(n)m(umeric)g(real)h
(user)f(id)g(of)g(the)h(curren)m(t)f(user.)40 b(This)30
b(v)-5 b(ariable)31 b(is)f(readonly)-8 b(.)p eop end
b(Shell)30 b(V)-8 b(ariables)2459 b(99)630 299 y Ft(\045\045)384
b Fu(A)30 b(literal)i(`)p Ft(\045)p Fu('.)630 458 y Ft(\045[)p
Fj(p)p Ft(][l]R)96 b Fu(The)30 b(elapsed)h(time)g(in)f(seconds.)630
618 y Ft(\045[)p Fj(p)p Ft(][l]U)96 b Fu(The)30 b(n)m(um)m(b)s(er)f(of)
h(CPU)g(seconds)h(sp)s(en)m(t)f(in)g(user)f(mo)s(de.)630
777 y Ft(\045[)p Fj(p)p Ft(][l]S)96 b Fu(The)30 b(n)m(um)m(b)s(er)f(of)
h(CPU)g(seconds)h(sp)s(en)m(t)f(in)g(system)g(mo)s(de.)630
936 y Ft(\045P)384 b Fu(The)30 b(CPU)g(p)s(ercen)m(tage,)i(computed)e
(as)h(\(\045U)f Ft(+)g Fu(\045S\))g(/)h(\045R.)630 1096
y(The)23 b(optional)j Fr(p)g Fu(is)e(a)g(digit)h(sp)s(ecifying)e(the)h
(precision,)i(the)e(n)m(um)m(b)s(er)f(of)h(fractional)h(digits)630
1205 y(after)36 b(a)f(decimal)i(p)s(oin)m(t.)55 b(A)35
b(v)-5 b(alue)36 b(of)f(0)h(causes)g(no)f(decimal)h(p)s(oin)m(t)f(or)h
(fraction)g(to)g(b)s(e)630 1315 y(output.)77 b Ft(time)41
b Fu(prin)m(ts)h(at)h(most)g(six)g(digits)g(after)g(the)g(decimal)g(p)s
(oin)m(t;)49 b(v)-5 b(alues)43 b(of)g Fr(p)630 1425 y
Fu(greater)34 b(than)f(6)h(are)f(c)m(hanged)h(to)g(6.)49
b(If)32 b Fr(p)k Fu(is)d(not)g(sp)s(eci\014ed,)h Ft(time)d
Fu(prin)m(ts)i(three)g(digits)630 1534 y(after)e(the)f(decimal)i(p)s
(oin)m(t.)630 1669 y(The)54 b(optional)h Ft(l)f Fu(sp)s(eci\014es)g(a)h
(longer)f(format,)61 b(including)54 b(min)m(utes,)61
b(of)54 b(the)g(form)630 1778 y Fr(MM)10 b Fu(m)p Fr(SS)p
Fu(.)p Fr(FF)d Fu(s.)103 b(The)50 b(v)-5 b(alue)52 b(of)f
Fr(p)j Fu(determines)d(whether)f(or)h(not)h(the)f(fraction)h(is)630
1888 y(included.)630 2022 y(If)30 b(this)g(v)-5 b(ariable)31
b(is)g(not)f(set,)i(Bash)e(acts)h(as)g(if)f(it)h(had)f(the)h(v)-5
b(alue)870 2157 y Ft($'\\nreal\\t\0453lR\\nuser\\t\0453)o(lU\\n)o
(sys\\)o(t\0453)o(lS')630 2291 y Fu(If)34 b(the)h(v)-5
b(alue)35 b(is)g(n)m(ull,)h(Bash)f(do)s(es)f(not)h(displa)m(y)g(an)m(y)
g(timing)g(information.)54 b(A)35 b(trailing)630 2401
y(newline)30 b(is)h(added)e(when)h(the)g(format)h(string)f(is)h(displa)
m(y)m(ed.)150 2560 y Ft(TMOUT)240 b Fu(If)27 b(set)i(to)f(a)g(v)-5
b(alue)28 b(greater)h(than)f(zero,)h(the)f Ft(read)f
Fu(builtin)g(uses)g(the)h(v)-5 b(alue)29 b(as)f(its)g(default)630
2670 y(timeout)33 b(\(see)f(Section)h(4.2)f([Bash)g(Builtins],)h(page)f
(61\).)46 b(The)31 b Ft(select)f Fu(command)h(\(see)630
2780 y(Section)g(3.2.5.2)i([Conditional)f(Constructs],)e(page)h(12\))h
(terminates)f(if)g(input)f(do)s(es)g(not)630 2889 y(arriv)m(e)h(after)g
Ft(TMOUT)e Fu(seconds)h(when)g(input)f(is)h(coming)i(from)d(a)i
(terminal.)630 3024 y(In)40 b(an)h(in)m(teractiv)m(e)i(shell,)h(the)d
(v)-5 b(alue)41 b(is)g(in)m(terpreted)g(as)f(the)h(n)m(um)m(b)s(er)f
(of)h(seconds)f(to)630 3133 y(w)m(ait)28 b(for)e(a)g(line)h(of)g(input)
e(after)i(issuing)f(the)h(primary)e(prompt.)39 b(Bash)26
b(terminates)h(after)630 3243 y(w)m(aiting)32 b(for)e(that)h(n)m(um)m
(b)s(er)e(of)h(seconds)h(if)f(a)h(complete)h(line)e(of)h(input)e(do)s
(es)h(not)h(arriv)m(e.)150 3402 y Ft(TMPDIR)192 b Fu(If)39
b(set,)j(Bash)e(uses)f(its)h(v)-5 b(alue)40 b(as)f(the)h(name)f(of)h(a)
g(directory)g(in)f(whic)m(h)g(Bash)h(creates)630 3512
y(temp)s(orary)30 b(\014les)g(for)g(the)h(shell's)g(use.)150
3671 y Ft(UID)336 b Fu(The)30 b(n)m(umeric)g(real)h(user)f(id)g(of)g
(the)h(curren)m(t)f(user.)40 b(This)30 b(v)-5 b(ariable)31
b(is)f(readonly)-8 b(.)p eop end
%%Page: 100 106
TeXDict begin 100 105 bop 3614 -116 a Fu(100)150 299
y Fp(6)80 b(Bash)54 b(F)-13 b(eatures)150 502 y Fu(This)30
@@ -23292,7 +23299,7 @@ h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)35
b Fb(8,)26 b(95)2025 1817 y Fe(LC_ALL)6 b Fc(:)14 b(:)f(:)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(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)21
b Fb(95)2025 1907 y Fe(LC_COLLATE)13 b Fc(:)i(:)e(:)g(:)g(:)h(:)f(:)g
b Fb(96)2025 1907 y Fe(LC_COLLATE)13 b Fc(:)i(:)e(:)g(:)g(:)h(:)f(:)g
(:)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(:)27 b Fb(96)2025
1998 y Fe(LC_CTYPE)18 b Fc(:)d(:)e(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g
@@ -23406,7 +23413,7 @@ b Fc(:)17 b(:)c(:)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(:)26 b Fb(97)150
1979 y Fe(READLINE_LINE)f Fc(:)13 b(:)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(:)g(:)g(:)g(:)37 b Fb(97)150 2066 y Fe(READLINE_MARK)25
g(:)g(:)g(:)g(:)37 b Fb(98)150 2066 y Fe(READLINE_MARK)25
b Fc(:)13 b(:)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(:)g(:)g(:)g(:)37
b Fb(98)150 2153 y Fe(READLINE_POINT)23 b Fc(:)13 b(:)g(:)g(:)g(:)h(:)f