pmodules/bash
0
0
Fork 0
mirror of https://https.git.savannah.gnu.org/git/bash.git synced 2026-07-13 23:20:49 +02:00
Code Issues Packages Projects Releases Wiki Activity

bash-4.4 beta2 release

Browse Source
This commit is contained in:
Chet Ramey
2016-07-11 16:52:30 -04:00
parent 690150f9e5
commit a4eef1991c
205 changed files with 21194 additions and 15639 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/FAQ
+9 -3
View File
@@ -1,4 +1,4 @@
This is the Bash FAQ, version 4.13, for Bash version 4.3.
This is the Bash FAQ, version 4.14, for Bash version 4.4.
This document contains a set of frequently-asked questions concerning
Bash, the GNU Bourne-Again Shell. Bash is a freely-available command
@@ -2169,11 +2169,17 @@ You may also need
Finally, you need to tell readline that you will be inputting and
displaying eight-bit characters. You use readline variables to do
this. These variables can be set in your .inputrc or using the bash
this. convert-meta says what to do if you read a character with its
eighth bit set. input-meta says whether to permit characters with the
eighth bit at all. output-meta determines how to display characters
with the eighth bit set: if on, they are output directly; if it is off,
such characters are displayed as a meta-prefixed escape sequence.
These variables can be set in your .inputrc or using the bash
`bind' builtin. Here's an example using `bind':
bash$ bind 'set convert-meta off'
bash$ bind 'set meta-flag on'
bash$ bind 'set input-meta on'
bash$ bind 'set output-meta on'
The `set' commands between the single quotes may also be placed
doc/bash.0
+894 -870
View File
File diff suppressed because it is too large Load Diff
doc/bash.1
+52 -18
View File
@@ -5,12 +5,12 @@
.\" Case Western Reserve University
.\" chet.ramey@case.edu
.\"
.\" Last Change: Mon Feb 8 10:15:48 EST 2016
.\" Last Change: Sun May 29 13:48:21 EDT 2016
.\"
.\" bash_builtins, strip all but Built-Ins section
.if \n(zZ=1 .ig zZ
.if \n(zY=1 .ig zY
.TH BASH 1 "2016 February 8" "GNU Bash 4.4"
.TH BASH 1 "2016 May 29" "GNU Bash 4.4"
.\"
.\" There's some problem with having a `@'
.\" in a tagged paragraph with the BSD man macros.
@@ -628,7 +628,7 @@ are executed sequentially; the shell waits for each
command to terminate in turn. The return status is the
exit status of the last command executed.
.PP
AND and OR lists are sequences of one of more pipelines separated by the
AND and OR lists are sequences of one or more pipelines separated by the
\fB&&\fP and \fB||\fP control operators, respectively.
AND and OR lists are executed with left associativity.
An AND list has the form
@@ -1266,7 +1266,8 @@ A variable can be assigned the \fInameref\fP attribute using the
to create a \fInameref\fP, or a reference to another variable.
This allows variables to be manipulated indirectly.
Whenever the nameref variable is referenced, assigned to, unset, or has
its attributes modified (other than the \fInameref\fP attribute itself), the
its attributes modified (other than using or changing the \fInameref\fP
attribute itself), the
operation is actually performed on the variable specified by the nameref
variable's value.
A nameref is commonly used within shell functions to refer to a variable
@@ -2014,11 +2015,14 @@ used when the shell is invoked in POSIX mode.
.TP
.B EXECIGNORE
A colon-separated list of shell patterns (see \fBPattern Matching\fP)
defining the list of filenames to be ignored by command search.
defining the list of filenames to be ignored by command search using
\fBPATH\fP.
Files whose full pathnames match one of these patterns are not considered
executable files for the purposes of completion and command execution.
executable files for the purposes of completion and command execution
via \fBPATH\fP lookup.
This does not affect the behavior of the \fB[\fP, \fBtest\fP, and \fB[[\fP
commands.
Full pathnames in the command hash table are not subject to \fBEXECIGNORE\fP.
Use this variable to ignore shared library files that have the executable
bit set, but are not executable files.
The pattern matching honors the setting of the \fBextglob\fP shell
@@ -2319,8 +2323,10 @@ The default path is system-dependent,
and is set by the administrator who installs
.BR bash .
A common value is
.na
.if t \f(CW/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin\fP.
.if n ``/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin''.
.ad
.TP
.B POSIXLY_CORRECT
If this variable is in the environment when \fBbash\fP starts, the shell
@@ -3899,9 +3905,9 @@ The format of here-documents is:
No parameter and variable expansion, command substitution,
arithmetic expansion, or pathname expansion is performed on
.IR word .
If any characters in
If any part of
.I word
are quoted, the
is quoted, the
.I delimiter
is the result of quote removal on
.IR word ,
@@ -4219,7 +4225,7 @@ By default, no limit is imposed on the number of recursive calls.
.SH "ARITHMETIC EVALUATION"
The shell allows arithmetic expressions to be evaluated, under
certain circumstances (see the \fBlet\fP and \fBdeclare\fP builtin
commands and \fBArithmetic Expansion\fP).
commands, the \fB((\fP compound command, and \fBArithmetic Expansion\fP).
Evaluation is done in fixed-width integers with no check for overflow,
though division by 0 is trapped and flagged as an error.
The operators and their precedence, associativity, and values
@@ -5451,6 +5457,10 @@ If set to \fBOn\fP, readline attempts to bind the control characters
treated specially by the kernel's terminal driver to their readline
equivalents.
.TP
.B blink\-matching\-paren (Off)
If set to \fBOn\fP, readline attempts to briefly move the cursor to an
opening parenthesis when a closing parenthesis is inserted.
.TP
.B colored\-completion\-prefix (Off)
If set to \fBOn\fP, when listing completions, readline displays the
common prefix of the set of possible completions using a different color.
@@ -5473,10 +5483,23 @@ in emacs mode and to
.B #
in vi command mode.
.TP
.B completion\-display\-width (-1)
The number of screen columns used to display possible matches
when performing completion.
The value is ignored if it is less than 0 or greater than the terminal
screen width.
A value of 0 will cause matches to be displayed one per line.
The default value is -1.
.TP
.B completion\-ignore\-case (Off)
If set to \fBOn\fP, readline performs filename matching and completion
in a case\-insensitive fashion.
.TP
.B completion\-map\-case (Off)
If set to \fBOn\fP, and \fBcompletion\-ignore\-case\fP is enabled, readline
treats hyphens (\fI\-\fP) and underscores (\fI_\fP) as equivalent when
performing case\-insensitive filename matching and completion.
.TP
.B completion\-prefix\-display\-length (0)
The length in characters of the common prefix of a list of possible
completions that is displayed without modification. When set to a
@@ -5498,12 +5521,19 @@ If set to \fBOn\fP, readline will convert characters with the
eighth bit set to an ASCII key sequence
by stripping the eighth bit and prefixing an
escape character (in effect, using escape as the \fImeta prefix\fP).
The default is \fIOn\fP, but readline will set it to \fIOff\fP if the
locale contains eight-bit characters.
.TP
.B disable\-completion (Off)
If set to \fBOn\fP, readline will inhibit word completion. Completion
characters will be inserted into the line as if they had been
mapped to \fBself-insert\fP.
.TP
.B echo\-control\-characters (On)
When set to \fBOn\fP, on operating systems that indicate they support it,
readline echoes a character corresponding to a signal generated from the
keyboard.
.TP
.B editing\-mode (emacs)
Controls whether readline begins with a set of key bindings similar
to \fIEmacs\fP or \fIvi\fP.
@@ -5513,11 +5543,6 @@ can be set to either
or
.BR vi .
.TP
.B echo\-control\-characters (On)
When set to \fBOn\fP, on operating systems that indicate they support it,
readline echoes a character corresponding to a signal generated from the
keyboard.
.TP
.B enable\-bracketed\-paste (Off)
When set to \fBOn\fP, readline will configure the terminal in a way
that will enable it to insert each paste into the editing buffer as a
@@ -5550,7 +5575,10 @@ If set to zero, any existing history entries are deleted and no new entries
are saved.
If set to a value less than zero, the number of history entries is not
limited.
By default, the number of history entries is not limited.
By default, the number of history entries is set to the value of the
\fBHISTSIZE\fP shell variable.
If an attempt is made to set \fIhistory\-size\fP to a non-numeric value,
the maximum number of history entries will be set to 500.
.TP
.B horizontal\-scroll\-mode (Off)
When set to \fBOn\fP, makes readline use a single line for display,
@@ -5559,10 +5587,12 @@ becomes longer than the screen width rather than wrapping to a new line.
.TP
.B input\-meta (Off)
If set to \fBOn\fP, readline will enable eight-bit input (that is,
it will not strip the high bit from the characters it reads),
it will not strip the eighth bit from the characters it reads),
regardless of what the terminal claims it can support. The name
.B meta\-flag
is a synonym for this variable.
The default is \fIOff\fP, but readline will set it to \fIOn\fP if the
locale contains eight-bit characters.
.TP
.B isearch\-terminators (``C\-[C\-J'')
The string of characters that should terminate an incremental
@@ -5633,6 +5663,8 @@ the list.
If set to \fBOn\fP, readline will display characters with the
eighth bit set directly rather than as a meta-prefixed escape
sequence.
The default is \fIOff\fP, but readline will set it to \fIOn\fP if the
locale contains eight-bit characters.
.TP
.B page\-completions (On)
If set to \fBOn\fP, readline uses an internal \fImore\fP-like pager
@@ -7692,7 +7724,7 @@ Give each \fIname\fP the \fInameref\fP attribute, making
it a name reference to another variable.
That other variable is defined by the value of \fIname\fP.
All references, assignments, and attribute modifications
to \fIname\fP, except for changing the
to \fIname\fP, except those using or changing the
\fB\-n\fP attribute itself, are performed on the variable referenced by
\fIname\fP's value.
The nameref attribute cannot be applied to array variables.
@@ -9598,7 +9630,9 @@ If set, aliases are expanded as described above under
This option is enabled by default for interactive shells.
.TP 8
.B extdebug
If set, behavior intended for use by debuggers is enabled:
If set at shell invocation, arrange to execute the debugger profile
before the shell starts, identical to the \fB\-\-debugger\fP option.
If set after invocation, behavior intended for use by debuggers is enabled:
.RS
.TP
.B 1.
doc/bash.html
+57 -20
View File
@@ -3,7 +3,7 @@
</HEAD>
<BODY><TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2016 February 8<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2016 May 29<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<BR><A HREF="#index">Index</A>
@@ -838,7 +838,7 @@ command to terminate in turn. The return status is the
exit status of the last command executed.
<P>
AND and OR lists are sequences of one of more pipelines separated by the
AND and OR lists are sequences of one or more pipelines separated by the
<B>&amp;&amp;</B> and <B>||</B> control operators, respectively.
AND and OR lists are executed with left associativity.
An AND list has the form
@@ -1628,7 +1628,8 @@ A variable can be assigned the <I>nameref</I> attribute using the
to create a <I>nameref</I>, or a reference to another variable.
This allows variables to be manipulated indirectly.
Whenever the nameref variable is referenced, assigned to, unset, or has
its attributes modified (other than the <I>nameref</I> attribute itself), the
its attributes modified (other than using or changing the <I>nameref</I>
attribute itself), the
operation is actually performed on the variable specified by the nameref
variable's value.
A nameref is commonly used within shell functions to refer to a variable
@@ -2566,11 +2567,14 @@ used when the shell is invoked in POSIX mode.
<DD>
A colon-separated list of shell patterns (see <B>Pattern Matching</B>)
defining the list of filenames to be ignored by command search.
defining the list of filenames to be ignored by command search using
<B>PATH</B>.
Files whose full pathnames match one of these patterns are not considered
executable files for the purposes of completion and command execution.
executable files for the purposes of completion and command execution
via <B>PATH</B> lookup.
This does not affect the behavior of the <B>[</B>, <B>test</B>, and <B>[[</B>
commands.
Full pathnames in the command hash table are not subject to <B>EXECIGNORE</B>.
Use this variable to ignore shared library files that have the executable
bit set, but are not executable files.
The pattern matching honors the setting of the <B>extglob</B> shell
@@ -2949,8 +2953,10 @@ and is set by the administrator who installs
<B>bash</B>.
A common value is
<TT>/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin</TT>.
<DT><B>POSIXLY_CORRECT</B>
<DD>
@@ -4964,10 +4970,10 @@ No parameter and variable expansion, command substitution,
arithmetic expansion, or pathname expansion is performed on
<I>word</I>.
If any characters in
If any part of
<I>word</I>
are quoted, the
is quoted, the
<I>delimiter</I>
is the result of quote removal on
@@ -5396,7 +5402,7 @@ By default, no limit is imposed on the number of recursive calls.
The shell allows arithmetic expressions to be evaluated, under
certain circumstances (see the <B>let</B> and <B>declare</B> builtin
commands and <B>Arithmetic Expansion</B>).
commands, the <B>((</B> compound command, and <B>Arithmetic Expansion</B>).
Evaluation is done in fixed-width integers with no check for overflow,
though division by 0 is trapped and flagged as an error.
The operators and their precedence, associativity, and values
@@ -7008,6 +7014,11 @@ If set to <B>audible</B>, readline attempts to ring the terminal's bell.
If set to <B>On</B>, readline attempts to bind the control characters
treated specially by the kernel's terminal driver to their readline
equivalents.
<DT><B>blink-matching-paren (Off)</B>
<DD>
If set to <B>On</B>, readline attempts to briefly move the cursor to an
opening parenthesis when a closing parenthesis is inserted.
<DT><B>colored-completion-prefix (Off)</B>
<DD>
@@ -7036,11 +7047,26 @@ in emacs mode and to
<B>#</B>
in vi command mode.
<DT><B>completion-display-width (-1)</B>
<DD>
The number of screen columns used to display possible matches
when performing completion.
The value is ignored if it is less than 0 or greater than the terminal
screen width.
A value of 0 will cause matches to be displayed one per line.
The default value is -1.
<DT><B>completion-ignore-case (Off)</B>
<DD>
If set to <B>On</B>, readline performs filename matching and completion
in a case-insensitive fashion.
<DT><B>completion-map-case (Off)</B>
<DD>
If set to <B>On</B>, and <B>completion-ignore-case</B> is enabled, readline
treats hyphens (<I>-</I>) and underscores (<I>_</I>) as equivalent when
performing case-insensitive filename matching and completion.
<DT><B>completion-prefix-display-length (0)</B>
<DD>
@@ -7066,12 +7092,20 @@ If set to <B>On</B>, readline will convert characters with the
eighth bit set to an ASCII key sequence
by stripping the eighth bit and prefixing an
escape character (in effect, using escape as the <I>meta prefix</I>).
The default is <I>On</I>, but readline will set it to <I>Off</I> if the
locale contains eight-bit characters.
<DT><B>disable-completion (Off)</B>
<DD>
If set to <B>On</B>, readline will inhibit word completion. Completion
characters will be inserted into the line as if they had been
mapped to <B>self-insert</B>.
<DT><B>echo-control-characters (On)</B>
<DD>
When set to <B>On</B>, on operating systems that indicate they support it,
readline echoes a character corresponding to a signal generated from the
keyboard.
<DT><B>editing-mode (emacs)</B>
<DD>
@@ -7085,12 +7119,6 @@ can be set to either
or
<B>vi</B>.
<DT><B>echo-control-characters (On)</B>
<DD>
When set to <B>On</B>, on operating systems that indicate they support it,
readline echoes a character corresponding to a signal generated from the
keyboard.
<DT><B>enable-bracketed-paste (Off)</B>
<DD>
@@ -7130,7 +7158,10 @@ If set to zero, any existing history entries are deleted and no new entries
are saved.
If set to a value less than zero, the number of history entries is not
limited.
By default, the number of history entries is not limited.
By default, the number of history entries is set to the value of the
<B>HISTSIZE</B> shell variable.
If an attempt is made to set <I>history-size</I> to a non-numeric value,
the maximum number of history entries will be set to 500.
<DT><B>horizontal-scroll-mode (Off)</B>
<DD>
@@ -7141,11 +7172,13 @@ becomes longer than the screen width rather than wrapping to a new line.
<DD>
If set to <B>On</B>, readline will enable eight-bit input (that is,
it will not strip the high bit from the characters it reads),
it will not strip the eighth bit from the characters it reads),
regardless of what the terminal claims it can support. The name
<B>meta-flag</B>
is a synonym for this variable.
The default is <I>Off</I>, but readline will set it to <I>On</I> if the
locale contains eight-bit characters.
<DT><B>isearch-terminators (``C-[C-J'')</B>
<DD>
@@ -7229,6 +7262,8 @@ the list.
If set to <B>On</B>, readline will display characters with the
eighth bit set directly rather than as a meta-prefixed escape
sequence.
The default is <I>Off</I>, but readline will set it to <I>On</I> if the
locale contains eight-bit characters.
<DT><B>page-completions (On)</B>
<DD>
@@ -9807,7 +9842,7 @@ Give each <I>name</I> the <I>nameref</I> attribute, making
it a name reference to another variable.
That other variable is defined by the value of <I>name</I>.
All references, assignments, and attribute modifications
to <I>name</I>, except for changing the
to <I>name</I>, except those using or changing the
<B>-n</B> attribute itself, are performed on the variable referenced by
<I>name</I>'s value.
The nameref attribute cannot be applied to array variables.
@@ -12198,7 +12233,9 @@ This option is enabled by default for interactive shells.
<DT><B>extdebug</B>
<DD>
If set, behavior intended for use by debuggers is enabled:
If set at shell invocation, arrange to execute the debugger profile
before the shell starts, identical to the <B>--debugger</B> option.
If set after invocation, behavior intended for use by debuggers is enabled:
<DL COMPACT><DT><DD>
<DL COMPACT>
<DT><B>1.</B>
@@ -13477,7 +13514,7 @@ There may be only one active coprocess at a time.
<HR>
<TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>GNU Bash 4.4<TH ALIGN=CENTER width=33%>2016 February 8<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>GNU Bash 4.4<TH ALIGN=CENTER width=33%>2016 May 29<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<HR>
@@ -13583,6 +13620,6 @@ There may be only one active coprocess at a time.
</DL>
<HR>
This document was created by man2html from bash.1.<BR>
Time: 08 February 2016 10:17:49 EST
Time: 20 June 2016 15:38:21 EDT
</BODY>
</HTML>
doc/bash.pdf
BIN
View File
Binary file not shown.
doc/bash.ps
+4392 -4364
View File
File diff suppressed because it is too large Load Diff
doc/bashbug.0
+5 -4
View File
@@ -1,4 +1,4 @@
BASHBUG(1) BASHBUG(1)
BASHBUG(1) General Commands Manual BASHBUG(1)
@@ -27,8 +27,9 @@ DDEESSCCRRIIPPTTIIOONN
EENNVVIIRROONNMMEENNTT
bbaasshhbbuugg will utilize the following environment variables if they exist:
EEDDIITTOORR Specifies the preferred editor. If EEDDIITTOORR is not set, bbaasshhbbuugg
defaults to eemmaaccss.
EEDDIITTOORR Specifies the preferred editor. If EEDDIITTOORR is not set, bbaasshhbbuugg
attempts to locate a number of alternative editors, including
eemmaaccss, and defaults to vvii.
HHOOMMEE Directory in which the failed bug report is saved if the mail
fails.
@@ -47,4 +48,4 @@ AAUUTTHHOORRSS
GNU Bash-4.0 1998 July 30 BASHBUG(1)
GNU Bash-4.4 2016 February 15 BASHBUG(1)
doc/bashbug.1
+5 -4
View File
@@ -5,9 +5,9 @@
.\" Case Western Reserve University
.\" chet@po.cwru.edu
.\"
.\" Last Change: Tue Apr 3 15:46:30 EDT 2007
.\" Last Change: Mon Feb 15 14:42:40 EST 2016
.\"
.TH BASHBUG 1 "1998 July 30" "GNU Bash-4.0"
.TH BASHBUG 1 "2016 February 15" "GNU Bash-4.4"
.SH NAME
bashbug \- report a bug in bash
.SH SYNOPSIS
@@ -43,8 +43,9 @@ Specifies the preferred editor. If
.B EDITOR
is not set,
.B bashbug
defaults to
.BR emacs .
attempts to locate a number of alternative editors, including
.BR emacs ,
and defaults to \fBvi\fP.
.TP
.B HOME
Directory in which the failed bug report is saved if the mail fails.
doc/bashbug.ps
+39 -29
View File
@@ -1,20 +1,20 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.19.2
%%CreationDate: Mon Nov 17 17:38:06 2008
%%Creator: groff version 1.22.3
%%CreationDate: Mon Mar 28 15:34:55 2016
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
%%DocumentSuppliedResources: procset grops 1.19 2
%%DocumentSuppliedResources: procset grops 1.22 3
%%Pages: 1
%%PageOrder: Ascend
%%DocumentMedia: Default 595 842 0 () ()
%%DocumentMedia: Default 612 792 0 () ()
%%Orientation: Portrait
%%EndComments
%%BeginDefaults
%%PageMedia: Default
%%EndDefaults
%%BeginProlog
%%BeginResource: procset grops 1.19 2
%%BeginResource: procset grops 1.22 3
%!PS-Adobe-3.0 Resource-ProcSet
/setpacking where{
pop
@@ -72,6 +72,7 @@ exch pop add exch pop
/level0 save def
1 setlinecap
1 setlinejoin
DEFS/BPhook known{DEFS begin BPhook end}if
72 RES div dup scale
LS{
90 rotate
@@ -137,7 +138,10 @@ pop
findfont
dup maxlength 1 index/FontName known not{1 add}if dict begin
{
1 index/FID ne{def}{pop pop}ifelse
1 index/FID ne
2 index/UniqueID ne
and
{def}{pop pop}ifelse
}forall
/Encoding exch def
dup/FontName exch def
@@ -175,8 +179,10 @@ newpath
userdict begin
/showpage{}def
/setpagedevice{}def
mark
}bind def
/PEND{
cleartomark
countdictstack CNT sub{end}repeat
level1 restore
}bind def
@@ -189,17 +195,17 @@ setpacking
%%EndProlog
%%BeginSetup
%%BeginFeature: *PageSize Default
<< /PageSize [ 595 842 ] /ImagingBBox null >> setpagedevice
<< /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice
%%EndFeature
%%IncludeResource: font Times-Roman
%%IncludeResource: font Times-Bold
%%IncludeResource: font Times-Italic
grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
def/PL 841.89 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron
/Zcaron/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef
def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron
/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O
@@ -229,13 +235,14 @@ def/PL 841.89 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SHB).35 E 347.52(UG\(1\) B)-.1 F
(ASHB)-.35 E(UG\(1\))-.1 E/F1 10.95/Times-Bold@0 SF -.219(NA)72 84 S(ME)
.219 E F0(bashb)108 96 Q(ug \255 report a b)-.2 E(ug in bash)-.2 E F1
(SYNOPSIS)72 112.8 Q/F2 10/Times-Bold@0 SF(bashb)108 124.8 Q(ug)-.2 E F0
([)2.5 E/F3 10/Times-Italic@0 SF(--ver)A(sion)-.1 E F0 2.5(][)C F3
(--help)-2.5 E F0 2.5(][)C F3(email-addr)-2.5 E(ess)-.37 E F0(])A F1
(DESCRIPTION)72 141.6 Q F2(bashb)108 153.6 Q(ug)-.2 E F0 .446
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SHB).35 E 116.13
(UG\(1\) General)-.1 F(Commands Manual)2.5 E -.35(BA)118.63 G(SHB).35 E
(UG\(1\))-.1 E/F1 10.95/Times-Bold@0 SF -.219(NA)72 84 S(ME).219 E F0
(bashb)108 96 Q(ug \255 report a b)-.2 E(ug in bash)-.2 E F1(SYNOPSIS)72
112.8 Q/F2 10/Times-Bold@0 SF(bashb)108 124.8 Q(ug)-.2 E F0([)2.5 E/F3
10/Times-Italic@0 SF(--ver)A(sion)-.1 E F0 2.5(][)C F3(--help)-2.5 E F0
2.5(][)C F3(email-addr)-2.5 E(ess)-.37 E F0(])A F1(DESCRIPTION)72 141.6
Q F2(bashb)108 153.6 Q(ug)-.2 E F0 .446
(is a shell script to help the user compose and mail b)2.947 F .446
(ug reports concerning bash in a standard for)-.2 F(-)-.2 E(mat.)108
165.6 Q F2(bashb)5.961 E(ug)-.2 E F0(in)3.461 E -.2(vo)-.4 G -.1(ke).2 G
@@ -265,20 +272,23 @@ F0(in the in)2.5 E -.2(vo)-.4 G(king user').2 E 2.5(sh)-.55 G
(Fix)5 E(es are encouraged.)-.15 E F1(ENVIR)72 271.2 Q(ONMENT)-.329 E F2
(bashb)108 283.2 Q(ug)-.2 E F0(will utilize the follo)2.5 E(wing en)-.25
E(vironment v)-.4 E(ariables if the)-.25 E 2.5(ye)-.15 G(xist:)-2.65 E
F2(EDIT)108 300 Q(OR)-.18 E F0(Speci\214es the preferred editor)144 312
Q 2.5(.I)-.55 G(f)-2.5 E F4(EDIT)2.5 E(OR)-.162 E F0(is not set,)2.25 E
F2(bashb)2.5 E(ug)-.2 E F0(def)2.5 E(aults to)-.1 E F2(emacs)2.5 E F0(.)
A F2(HOME)108 328.8 Q F0(Directory in which the f)144 340.8 Q(ailed b)
-.1 E(ug report is sa)-.2 E -.15(ve)-.2 G 2.5(di).15 G 2.5(ft)-2.5 G
(he mail f)-2.5 E(ails.)-.1 E F2(TMPDIR)108 357.6 Q F0
F2(EDIT)108 300 Q(OR)-.18 E F0 .327(Speci\214es the preferred editor)144
312 R 2.827(.I)-.55 G(f)-2.827 E F4(EDIT)2.827 E(OR)-.162 E F0 .327
(is not set,)2.577 F F2(bashb)2.827 E(ug)-.2 E F0 .328
(attempts to locate a number of alter)2.827 F(-)-.2 E(nati)144 324 Q .3
-.15(ve e)-.25 H(ditors, including).15 E F2(emacs)2.5 E F0 2.5(,a)C
(nd def)-2.5 E(aults to)-.1 E F2(vi)2.5 E F0(.)A F2(HOME)108 340.8 Q F0
(Directory in which the f)144 352.8 Q(ailed b)-.1 E(ug report is sa)-.2
E -.15(ve)-.2 G 2.5(di).15 G 2.5(ft)-2.5 G(he mail f)-2.5 E(ails.)-.1 E
F2(TMPDIR)108 369.6 Q F0
(Directory in which to create temporary \214les and directories.)144
369.6 Q F1(SEE ALSO)72 386.4 Q F3(bash)108 398.4 Q F0(\(1\))A F1 -.548
(AU)72 415.2 S(THORS).548 E F0(Brian F)108 427.2 Q(ox, Free Softw)-.15 E
(are F)-.1 E(oundation)-.15 E(bfox@gnu.or)108 439.2 Q(g)-.18 E
(Chet Rame)108 456 Q 1.3 -.65(y, C)-.15 H(ase W).65 E(estern Reserv)-.8
381.6 Q F1(SEE ALSO)72 398.4 Q F3(bash)108 410.4 Q F0(\(1\))A F1 -.548
(AU)72 427.2 S(THORS).548 E F0(Brian F)108 439.2 Q(ox, Free Softw)-.15 E
(are F)-.1 E(oundation)-.15 E(bfox@gnu.or)108 451.2 Q(g)-.18 E
(Chet Rame)108 468 Q 1.3 -.65(y, C)-.15 H(ase W).65 E(estern Reserv)-.8
E 2.5(eU)-.15 G(ni)-2.5 E -.15(ve)-.25 G(rsity).15 E(chet@po.cwru.edu)
108 468 Q(GNU Bash-4.0)72 768 Q(1998 July 30)148.175 E(1)203.165 E 0 Cg
EP
108 480 Q(GNU Bash-4.4)72 768 Q(2016 February 15)138.46 E(1)193.45 E 0
Cg EP
%%Trailer
end
%%EOF
doc/bashref.dvi
BIN
View File
Binary file not shown.
doc/bashref.html
+46 -30
View File
@@ -1,9 +1,9 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This text is a brief description of the features that are present in
the Bash shell (version 4.4, 8 February 2016).
the Bash shell (version 4.4, 29 May 2016).
This is Edition 4.4, last updated 8 February 2016,
This is Edition 4.4, last updated 29 May 2016,
of The GNU Bash Reference Manual,
for Bash, Version 4.4.
@@ -15,7 +15,7 @@ any later version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled
"GNU Free Documentation License". -->
<!-- Created by GNU Texinfo 6.0, http://www.gnu.org/software/texinfo/ -->
<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Bash Reference Manual</title>
@@ -50,9 +50,8 @@ pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space: nowrap}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: serif; font-weight: normal}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
@@ -285,10 +284,10 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Previou
<h1 class="top">Bash Features</h1>
<p>This text is a brief description of the features that are present in
the Bash shell (version 4.4, 8 February 2016).
the Bash shell (version 4.4, 29 May 2016).
The Bash home page is <a href="http://www.gnu.org/software/bash/">http://www.gnu.org/software/bash/</a>.
</p>
<p>This is Edition 4.4, last updated 8 February 2016,
<p>This is Edition 4.4, last updated 29 May 2016,
of <cite>The GNU Bash Reference Manual</cite>,
for <code>Bash</code>, Version 4.4.
</p>
@@ -1962,12 +1961,13 @@ When applied to a string-valued variable, <var>value</var> is expanded and
appended to the variable&rsquo;s value.
</p>
<p>A variable can be assigned the <var>nameref</var> attribute using the
<samp>-n</samp> option to the \fBdeclare\fP or \fBlocal\fP builtin commands
<samp>-n</samp> option to the <code>declare</code> or <code>local</code> builtin commands
(see <a href="#Bash-Builtins">Bash Builtins</a>)
to create a <var>nameref</var>, or a reference to another variable.
This allows variables to be manipulated indirectly.
Whenever the nameref variable is referenced, assigned to, unset, or has
its attributes modified (other than the nameref attribute itself), the
its attributes modified (other than using or changing the nameref
attribute itself), the
operation is actually performed on the variable specified by the nameref
variable&rsquo;s value.
A nameref is commonly used within shell functions to refer to a variable
@@ -3327,7 +3327,7 @@ input (or file descriptor <var>n</var> if <var>n</var> is specified) for a comma
<p>No parameter and variable expansion, command substitution,
arithmetic expansion, or filename expansion is performed on
<var>word</var>. If any characters in <var>word</var> are quoted, the
<var>word</var>. If any part of <var>word</var> is quoted, the
<var>delimiter</var> is the result of quote removal on <var>word</var>,
and the lines in the here-document are not expanded.
If <var>word</var> is unquoted,
@@ -4275,8 +4275,7 @@ less than zero, non-zero otherwise.
<pre class="example">test <var>expr</var>
</pre></div>
<p>Evaluate a conditional express
ion <var>expr</var> and return a status of 0
<p>Evaluate a conditional expression <var>expr</var> and return a status of 0
(true) or 1 (false).
Each operator and operand must be a separate argument.
Expressions are composed of the primaries described below in
@@ -4469,7 +4468,7 @@ results in permissions of <code>755</code>.
<p>Remove each variable or function <var>name</var>.
If the <samp>-v</samp> option is given, each
<var>name</var> refers to a shell variable and that variable is remvoved.
<var>name</var> refers to a shell variable and that variable is removed.
If the <samp>-f</samp> option is given, the <var>name</var>s refer to shell
functions, and the function definition is removed.
If the <samp>-n</samp> option is supplied, and <var>name</var> is a variable with
@@ -4750,7 +4749,7 @@ The upper-case attribute is disabled.
it a name reference to another variable.
That other variable is defined by the value of <var>name</var>.
All references, assignments, and attribute modifications
to <var>name</var>, except for changing the
to <var>name</var>, except for those using or changing the
<samp>-n</samp> attribute itself, are performed on the variable referenced by
<var>name</var>&rsquo;s value.
The nameref attribute cannot be applied to array variables.
@@ -6011,7 +6010,9 @@ This option is enabled by default for interactive shells.
</p>
</dd>
<dt><code>extdebug</code></dt>
<dd><p>If set, behavior intended for use by debuggers is enabled:
<dd><p>If set at shell invocation, arrange to execute the debugger profile
before the shell starts, identical to the <samp>--debugger</samp> option.
If set after invocation, behavior intended for use by debuggers is enabled:
</p>
<ol>
<li> The <samp>-F</samp> option to the <code>declare</code> builtin (see <a href="#Bash-Builtins">Bash Builtins</a>)
@@ -6773,11 +6774,14 @@ is readonly.
<a name="index-EXECIGNORE"></a>
</dt>
<dd><p>A colon-separated list of shell patterns (see <a href="#Pattern-Matching">Pattern Matching</a>)
defining the list of filenames to be ignored by command search.
defining the list of filenames to be ignored by command search using
<code>PATH</code>.
Files whose full pathnames match one of these patterns are not considered
executable files for the purposes of completion and command execution.
executable files for the purposes of completion and command execution
via <code>PATH</code> lookup.
This does not affect the behavior of the <code>[</code>, <code>test</code>, and <code>[[</code>
commands.
Full pathnames in the command hash table are not subject to <code>EXECIGNORE</code>.
Use this variable to ignore shared library files that have the executable
bit set, but are not executable files.
The pattern matching honors the setting of the <code>extglob</code> shell
@@ -8078,8 +8082,8 @@ Next: <a href="#Aliases" accesskey="n" rel="next">Aliases</a>, Previous: <a href
<a name="index-arithmetic-evaluation"></a>
<p>The shell allows arithmetic expressions to be evaluated, as one of
the shell expansions or by the <code>let</code> and the <samp>-i</samp> option
to the <code>declare</code> builtins.
the shell expansions or by using the <code>((</code> compound command, the
<code>let</code> builtin, or the <samp>-i</samp> option to the <code>declare</code> builtin.
</p>
<p>Evaluation is done in fixed-width integers with no check for overflow,
though division by 0 is trapped and flagged as an error.
@@ -8923,6 +8927,9 @@ has been set.
If Bash receives a trapped signal while executing <code>read</code>, the trap
handler executes and <code>read</code> returns an exit status greater than 128.
</li><li> Bash removes an exited background process&rsquo;s status from the list of such
statuses after the <code>wait</code> builtin is used to obtain it.
</li></ol>
<p>There is other <small>POSIX</small> behavior that Bash does not implement by
@@ -9668,9 +9675,11 @@ incorporating any changes that you might have made to it.
<tr><td align="left" valign="top">&bull; <a href="#Readline-Init-File-Syntax" accesskey="1">Readline Init File Syntax</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Syntax for the commands in the inputrc file.
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Conditional-Init-Constructs" accesskey="2">Conditional Init Constructs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Conditional key bindings in the inputrc file.
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Sample-Init-File" accesskey="3">Sample Init File</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">An example inputrc file.
</td></tr>
</table>
@@ -9822,7 +9831,9 @@ The default limit is <code>100</code>.
<p>If set to &lsquo;<samp>on</samp>&rsquo;, Readline will convert characters with the
eighth bit set to an <small>ASCII</small> key sequence by stripping the eighth
bit and prefixing an <tt class="key">ESC</tt> character, converting them to a
meta-prefixed key sequence. The default value is &lsquo;<samp>on</samp>&rsquo;.
meta-prefixed key sequence. The default value is &lsquo;<samp>on</samp>&rsquo;, but
will be set to &lsquo;<samp>off</samp>&rsquo; if the locale is one that contains
eight-bit characters.
</p>
</dd>
<dt><code>disable-completion</code></dt>
@@ -9832,6 +9843,13 @@ Completion characters will be inserted into the line as if they had
been mapped to <code>self-insert</code>. The default is &lsquo;<samp>off</samp>&rsquo;.
</p>
</dd>
<dt><code>echo-control-characters</code></dt>
<dd><a name="index-echo_002dcontrol_002dcharacters"></a>
<p>When set to &lsquo;<samp>on</samp>&rsquo;, on operating systems that indicate they support it,
readline echoes a character corresponding to a signal generated from the
keyboard. The default is &lsquo;<samp>on</samp>&rsquo;.
</p>
</dd>
<dt><code>editing-mode</code></dt>
<dd><a name="index-editing_002dmode"></a>
<p>The <code>editing-mode</code> variable controls which default set of
@@ -9852,13 +9870,6 @@ sequence into the mode string.
The default is &lsquo;<samp>@</samp>&rsquo;.
</p>
</dd>
<dt><code>echo-control-characters</code></dt>
<dd><a name="index-echo_002dcontrol_002dcharacters"></a>
<p>When set to &lsquo;<samp>on</samp>&rsquo;, on operating systems that indicate they support it,
readline echoes a character corresponding to a signal generated from the
keyboard. The default is &lsquo;<samp>on</samp>&rsquo;.
</p>
</dd>
<dt><code>enable-bracketed-paste</code></dt>
<dd><a name="index-enable_002dbracketed_002dpaste"></a>
<p>When set to &lsquo;<samp>On</samp>&rsquo;, Readline will configure the terminal in a way
@@ -9904,6 +9915,8 @@ are saved.
If set to a value less than zero, the number of history entries is not
limited.
By default, the number of history entries is not limited.
If an attempt is made to set <var>history-size</var> to a non-numeric value,
the maximum number of history entries will be set to 500.
</p>
</dd>
<dt><code>horizontal-scroll-mode</code></dt>
@@ -9921,8 +9934,9 @@ this variable is set to &lsquo;<samp>off</samp>&rsquo;.
<p>If set to &lsquo;<samp>on</samp>&rsquo;, Readline will enable eight-bit input (it
will not clear the eighth bit in the characters it reads),
regardless of what the terminal claims it can support. The
default value is &lsquo;<samp>off</samp>&rsquo;. The name <code>meta-flag</code> is a
synonym for this variable.
default value is &lsquo;<samp>off</samp>&rsquo;, but Readline will set it to &lsquo;<samp>on</samp>&rsquo; if the
locale contains eight-bit characters.
The name <code>meta-flag</code> is a synonym for this variable.
</p>
</dd>
<dt><code>isearch-terminators</code></dt>
@@ -10010,7 +10024,9 @@ the list. The default is &lsquo;<samp>off</samp>&rsquo;.
<dd><a name="index-output_002dmeta"></a>
<p>If set to &lsquo;<samp>on</samp>&rsquo;, Readline will display characters with the
eighth bit set directly rather than as a meta-prefixed escape
sequence. The default is &lsquo;<samp>off</samp>&rsquo;.
sequence.
The default is &lsquo;<samp>off</samp>&rsquo;, but Readline will set it to &lsquo;<samp>on</samp>&rsquo; if the
locale contains eight-bit characters.
</p>
</dd>
<dt><code>page-completions</code></dt>
doc/bashref.info
+277 -263
View File
@@ -1,10 +1,10 @@
This is bashref.info, produced by makeinfo version 6.0 from
This is bashref.info, produced by makeinfo version 6.1 from
bashref.texi.
This text is a brief description of the features that are present in the
Bash shell (version 4.4, 8 February 2016).
Bash shell (version 4.4, 29 May 2016).
This is Edition 4.4, last updated 8 February 2016, of 'The GNU Bash
This is Edition 4.4, last updated 29 May 2016, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Copyright (C) 1988-2016 Free Software Foundation, Inc.
@@ -27,10 +27,10 @@ Bash Features
*************
This text is a brief description of the features that are present in the
Bash shell (version 4.4, 8 February 2016). The Bash home page is
Bash shell (version 4.4, 29 May 2016). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 4.4, last updated 8 February 2016, of 'The GNU Bash
This is Edition 4.4, last updated 29 May 2016, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Bash contains features that appear in other popular shells, and some
@@ -798,6 +798,7 @@ File: bashref.info, Node: Conditional Constructs, Next: Command Grouping, Pre
esac
echo " legs."
If the ';;' operator is used, no subsequent matches are attempted
after the first pattern match. Using ';&' in place of ';;' causes
execution to continue with the COMMAND-LIST associated with the
@@ -1280,16 +1281,16 @@ pairs in an associative array. When applied to a string-valued
variable, VALUE is expanded and appended to the variable's value.
A variable can be assigned the NAMEREF attribute using the '-n'
option to the \fBdeclare\fP or \fBlocal\fP builtin commands (*note Bash
option to the 'declare' or 'local' builtin commands (*note Bash
Builtins::) to create a NAMEREF, or a reference to another variable.
This allows variables to be manipulated indirectly. Whenever the
nameref variable is referenced, assigned to, unset, or has its
attributes modified (other than the nameref attribute itself), the
operation is actually performed on the variable specified by the nameref
variable's value. A nameref is commonly used within shell functions to
refer to a variable whose name is passed as an argument to the function.
For instance, if a variable name is passed to a shell function as its
first argument, running
attributes modified (other than using or changing the nameref attribute
itself), the operation is actually performed on the variable specified
by the nameref variable's value. A nameref is commonly used within
shell functions to refer to a variable whose name is passed as an
argument to the function. For instance, if a variable name is passed to
a shell function as its first argument, running
declare -n ref=$1
inside the function creates a nameref variable REF whose value is the
variable name passed as the first argument. References and assignments
@@ -2317,13 +2318,13 @@ command.
DELIMITER
No parameter and variable expansion, command substitution, arithmetic
expansion, or filename expansion is performed on WORD. If any
characters in WORD are quoted, the DELIMITER is the result of quote
removal on WORD, and the lines in the here-document are not expanded.
If WORD is unquoted, all lines of the here-document are subjected to
parameter expansion, command substitution, and arithmetic expansion, the
character sequence '\newline' is ignored, and '\' must be used to quote
the characters '\', '$', and '`'.
expansion, or filename expansion is performed on WORD. If any part of
WORD is quoted, the DELIMITER is the result of quote removal on WORD,
and the lines in the here-document are not expanded. If WORD is
unquoted, all lines of the here-document are subjected to parameter
expansion, command substitution, and arithmetic expansion, the character
sequence '\newline' is ignored, and '\' must be used to quote the
characters '\', '$', and '`'.
If the redirection operator is '<<-', then all leading tab characters
are stripped from input lines and the line containing DELIMITER. This
@@ -3053,7 +3054,7 @@ standard.
'['
test EXPR
Evaluate a conditional express ion EXPR and return a status of 0
Evaluate a conditional expression EXPR and return a status of 0
(true) or 1 (false). Each operator and operand must be a separate
argument. Expressions are composed of the primaries described
below in *note Bash Conditional Expressions::. 'test' does not
@@ -3203,7 +3204,7 @@ standard.
Remove each variable or function NAME. If the '-v' option is
given, each NAME refers to a shell variable and that variable is
remvoved. If the '-f' option is given, the NAMEs refer to shell
removed. If the '-f' option is given, the NAMEs refer to shell
functions, and the function definition is removed. If the '-n'
option is supplied, and NAME is a variable with the NAMEREF
attribute, NAME will be unset rather than the variable it
@@ -3413,10 +3414,10 @@ standard.
Give each NAME the NAMEREF attribute, making it a name
reference to another variable. That other variable is defined
by the value of NAME. All references, assignments, and
attribute modifications to NAME, except for changing the '-n'
attribute itself, are performed on the variable referenced by
NAME's value. The nameref attribute cannot be applied to
array variables.
attribute modifications to NAME, except for those using or
changing the '-n' attribute itself, are performed on the
variable referenced by NAME's value. The nameref attribute
cannot be applied to array variables.
'-r'
Make NAMEs readonly. These names cannot then be assigned
@@ -4390,7 +4391,10 @@ This builtin allows you to change additional shell optional behavior.
interactive shells.
'extdebug'
If set, behavior intended for use by debuggers is enabled:
If set at shell invocation, arrange to execute the debugger
profile before the shell starts, identical to the '--debugger'
option. If set after invocation, behavior intended for use by
debuggers is enabled:
1. The '-F' option to the 'declare' builtin (*note Bash
Builtins::) displays the source file name and line number
@@ -4927,14 +4931,16 @@ Variables::).
'EXECIGNORE'
A colon-separated list of shell patterns (*note Pattern Matching::)
defining the list of filenames to be ignored by command search.
Files whose full pathnames match one of these patterns are not
considered executable files for the purposes of completion and
command execution. This does not affect the behavior of the '[',
'test', and '[[' commands. Use this variable to ignore shared
library files that have the executable bit set, but are not
executable files. The pattern matching honors the setting of the
'extglob' shell option.
defining the list of filenames to be ignored by command search
using 'PATH'. Files whose full pathnames match one of these
patterns are not considered executable files for the purposes of
completion and command execution via 'PATH' lookup. This does not
affect the behavior of the '[', 'test', and '[[' commands. Full
pathnames in the command hash table are not subject to
'EXECIGNORE'. Use this variable to ignore shared library files
that have the executable bit set, but are not executable files.
The pattern matching honors the setting of the 'extglob' shell
option.
'FCEDIT'
The editor used as a default by the '-e' option to the 'fc' builtin
@@ -5877,8 +5883,8 @@ File: bashref.info, Node: Shell Arithmetic, Next: Aliases, Prev: Bash Conditi
====================
The shell allows arithmetic expressions to be evaluated, as one of the
shell expansions or by the 'let' and the '-i' option to the 'declare'
builtins.
shell expansions or by using the '((' compound command, the 'let'
builtin, or the '-i' option to the 'declare' builtin.
Evaluation is done in fixed-width integers with no check for
overflow, though division by 0 is trapped and flagged as an error. The
@@ -6555,6 +6561,9 @@ startup files.
'read', the trap handler executes and 'read' returns an exit status
greater than 128.
54. Bash removes an exited background process's status from the list
of such statuses after the 'wait' builtin is used to obtain it.
There is other POSIX behavior that Bash does not implement by default
even when in POSIX mode. Specifically:
@@ -7225,13 +7234,20 @@ Variable Settings
If set to 'on', Readline will convert characters with the
eighth bit set to an ASCII key sequence by stripping the
eighth bit and prefixing an <ESC> character, converting them
to a meta-prefixed key sequence. The default value is 'on'.
to a meta-prefixed key sequence. The default value is 'on',
but will be set to 'off' if the locale is one that contains
eight-bit characters.
'disable-completion'
If set to 'On', Readline will inhibit word completion.
Completion characters will be inserted into the line as if
they had been mapped to 'self-insert'. The default is 'off'.
'echo-control-characters'
When set to 'on', on operating systems that indicate they
support it, readline echoes a character corresponding to a
signal generated from the keyboard. The default is 'on'.
'editing-mode'
The 'editing-mode' variable controls which default set of key
bindings is used. By default, Readline starts up in Emacs
@@ -7248,11 +7264,6 @@ Variable Settings
embed a terminal control sequence into the mode string. The
default is '@'.
'echo-control-characters'
When set to 'on', on operating systems that indicate they
support it, readline echoes a character corresponding to a
signal generated from the keyboard. The default is 'on'.
'enable-bracketed-paste'
When set to 'On', Readline will configure the terminal in a
way that will enable it to insert each paste into the editing
@@ -7287,7 +7298,9 @@ Variable Settings
list. If set to zero, any existing history entries are
deleted and no new entries are saved. If set to a value less
than zero, the number of history entries is not limited. By
default, the number of history entries is not limited.
default, the number of history entries is not limited. If an
attempt is made to set HISTORY-SIZE to a non-numeric value,
the maximum number of history entries will be set to 500.
'horizontal-scroll-mode'
This variable can be set to either 'on' or 'off'. Setting it
@@ -7300,8 +7313,9 @@ Variable Settings
If set to 'on', Readline will enable eight-bit input (it will
not clear the eighth bit in the characters it reads),
regardless of what the terminal claims it can support. The
default value is 'off'. The name 'meta-flag' is a synonym for
this variable.
default value is 'off', but Readline will set it to 'on' if
the locale contains eight-bit characters. The name
'meta-flag' is a synonym for this variable.
'isearch-terminators'
The string of characters that should terminate an incremental
@@ -7365,7 +7379,8 @@ Variable Settings
'output-meta'
If set to 'on', Readline will display characters with the
eighth bit set directly rather than as a meta-prefixed escape
sequence. The default is 'off'.
sequence. The default is 'off', but Readline will set it to
'on' if the locale contains eight-bit characters.
'page-completions'
If set to 'on', Readline uses an internal 'more'-like pager to
@@ -10706,9 +10721,9 @@ D.2 Index of Shell Reserved Words
* !: Pipelines. (line 9)
* [[: Conditional Constructs.
(line 120)
(line 121)
* ]]: Conditional Constructs.
(line 120)
(line 121)
* {: Command Grouping. (line 21)
* }: Command Grouping. (line 21)
* case: Conditional Constructs.
@@ -10730,7 +10745,7 @@ D.2 Index of Shell Reserved Words
* in: Conditional Constructs.
(line 28)
* select: Conditional Constructs.
(line 78)
(line 79)
* then: Conditional Constructs.
(line 7)
* time: Pipelines. (line 9)
@@ -10824,141 +10839,141 @@ D.3 Parameter and Variable Index
* COPROC: Bash Variables. (line 231)
* DIRSTACK: Bash Variables. (line 235)
* disable-completion: Readline Init File Syntax.
(line 114)
(line 116)
* echo-control-characters: Readline Init File Syntax.
(line 135)
(line 121)
* editing-mode: Readline Init File Syntax.
(line 119)
(line 126)
* EMACS: Bash Variables. (line 245)
* emacs-mode-string: Readline Init File Syntax.
(line 125)
(line 132)
* enable-bracketed-paste: Readline Init File Syntax.
(line 140)
(line 142)
* enable-keypad: Readline Init File Syntax.
(line 148)
(line 150)
* ENV: Bash Variables. (line 250)
* EUID: Bash Variables. (line 254)
* EXECIGNORE: Bash Variables. (line 258)
* expand-tilde: Readline Init File Syntax.
(line 159)
* FCEDIT: Bash Variables. (line 269)
* FIGNORE: Bash Variables. (line 273)
* FUNCNAME: Bash Variables. (line 279)
* FUNCNEST: Bash Variables. (line 296)
* GLOBIGNORE: Bash Variables. (line 301)
* GROUPS: Bash Variables. (line 308)
* histchars: Bash Variables. (line 314)
* HISTCMD: Bash Variables. (line 329)
* HISTCONTROL: Bash Variables. (line 334)
* HISTFILE: Bash Variables. (line 350)
* HISTFILESIZE: Bash Variables. (line 354)
* HISTIGNORE: Bash Variables. (line 365)
(line 161)
* FCEDIT: Bash Variables. (line 271)
* FIGNORE: Bash Variables. (line 275)
* FUNCNAME: Bash Variables. (line 281)
* FUNCNEST: Bash Variables. (line 298)
* GLOBIGNORE: Bash Variables. (line 303)
* GROUPS: Bash Variables. (line 310)
* histchars: Bash Variables. (line 316)
* HISTCMD: Bash Variables. (line 331)
* HISTCONTROL: Bash Variables. (line 336)
* HISTFILE: Bash Variables. (line 352)
* HISTFILESIZE: Bash Variables. (line 356)
* HISTIGNORE: Bash Variables. (line 367)
* history-preserve-point: Readline Init File Syntax.
(line 163)
(line 165)
* history-size: Readline Init File Syntax.
(line 169)
* HISTSIZE: Bash Variables. (line 385)
* HISTTIMEFORMAT: Bash Variables. (line 392)
(line 171)
* HISTSIZE: Bash Variables. (line 387)
* HISTTIMEFORMAT: Bash Variables. (line 394)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 176)
* HOSTFILE: Bash Variables. (line 400)
* HOSTNAME: Bash Variables. (line 411)
* HOSTTYPE: Bash Variables. (line 414)
(line 180)
* HOSTFILE: Bash Variables. (line 402)
* HOSTNAME: Bash Variables. (line 413)
* HOSTTYPE: Bash Variables. (line 416)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 417)
* IGNOREEOF: Bash Variables. (line 419)
* input-meta: Readline Init File Syntax.
(line 183)
* INPUTRC: Bash Variables. (line 427)
(line 187)
* INPUTRC: Bash Variables. (line 429)
* isearch-terminators: Readline Init File Syntax.
(line 190)
(line 195)
* keymap: Readline Init File Syntax.
(line 197)
* LANG: Bash Variables. (line 431)
* LC_ALL: Bash Variables. (line 435)
* LC_COLLATE: Bash Variables. (line 439)
* LC_CTYPE: Bash Variables. (line 446)
(line 202)
* LANG: Bash Variables. (line 433)
* LC_ALL: Bash Variables. (line 437)
* LC_COLLATE: Bash Variables. (line 441)
* LC_CTYPE: Bash Variables. (line 448)
* LC_MESSAGES: Locale Translation. (line 11)
* LC_MESSAGES <1>: Bash Variables. (line 451)
* LC_NUMERIC: Bash Variables. (line 455)
* LC_TIME: Bash Variables. (line 459)
* LINENO: Bash Variables. (line 463)
* LINES: Bash Variables. (line 467)
* MACHTYPE: Bash Variables. (line 473)
* LC_MESSAGES <1>: Bash Variables. (line 453)
* LC_NUMERIC: Bash Variables. (line 457)
* LC_TIME: Bash Variables. (line 461)
* LINENO: Bash Variables. (line 465)
* LINES: Bash Variables. (line 469)
* MACHTYPE: Bash Variables. (line 475)
* MAIL: Bourne Shell Variables.
(line 22)
* MAILCHECK: Bash Variables. (line 477)
* MAILCHECK: Bash Variables. (line 479)
* MAILPATH: Bourne Shell Variables.
(line 27)
* MAPFILE: Bash Variables. (line 485)
* MAPFILE: Bash Variables. (line 487)
* mark-modified-lines: Readline Init File Syntax.
(line 227)
* mark-symlinked-directories: Readline Init File Syntax.
(line 232)
* match-hidden-files: Readline Init File Syntax.
* mark-symlinked-directories: Readline Init File Syntax.
(line 237)
* match-hidden-files: Readline Init File Syntax.
(line 242)
* menu-complete-display-prefix: Readline Init File Syntax.
(line 244)
(line 249)
* meta-flag: Readline Init File Syntax.
(line 183)
* OLDPWD: Bash Variables. (line 489)
(line 187)
* OLDPWD: Bash Variables. (line 491)
* OPTARG: Bourne Shell Variables.
(line 34)
* OPTERR: Bash Variables. (line 492)
* OPTERR: Bash Variables. (line 494)
* OPTIND: Bourne Shell Variables.
(line 38)
* OSTYPE: Bash Variables. (line 496)
* OSTYPE: Bash Variables. (line 498)
* output-meta: Readline Init File Syntax.
(line 249)
* page-completions: Readline Init File Syntax.
(line 254)
* page-completions: Readline Init File Syntax.
(line 260)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 499)
* POSIXLY_CORRECT: Bash Variables. (line 504)
* PPID: Bash Variables. (line 513)
* PROMPT_COMMAND: Bash Variables. (line 517)
* PROMPT_DIRTRIM: Bash Variables. (line 521)
* PS0: Bash Variables. (line 527)
* PIPESTATUS: Bash Variables. (line 501)
* POSIXLY_CORRECT: Bash Variables. (line 506)
* PPID: Bash Variables. (line 515)
* PROMPT_COMMAND: Bash Variables. (line 519)
* PROMPT_DIRTRIM: Bash Variables. (line 523)
* PS0: Bash Variables. (line 529)
* PS1: Bourne Shell Variables.
(line 48)
* PS2: Bourne Shell Variables.
(line 53)
* PS3: Bash Variables. (line 532)
* PS4: Bash Variables. (line 537)
* PWD: Bash Variables. (line 543)
* RANDOM: Bash Variables. (line 546)
* READLINE_LINE: Bash Variables. (line 551)
* READLINE_POINT: Bash Variables. (line 555)
* REPLY: Bash Variables. (line 559)
* PS3: Bash Variables. (line 534)
* PS4: Bash Variables. (line 539)
* PWD: Bash Variables. (line 545)
* RANDOM: Bash Variables. (line 548)
* READLINE_LINE: Bash Variables. (line 553)
* READLINE_POINT: Bash Variables. (line 557)
* REPLY: Bash Variables. (line 561)
* revert-all-at-newline: Readline Init File Syntax.
(line 264)
* SECONDS: Bash Variables. (line 562)
* SHELL: Bash Variables. (line 568)
* SHELLOPTS: Bash Variables. (line 573)
* SHLVL: Bash Variables. (line 582)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 270)
* show-all-if-unmodified: Readline Init File Syntax.
* SECONDS: Bash Variables. (line 564)
* SHELL: Bash Variables. (line 570)
* SHELLOPTS: Bash Variables. (line 575)
* SHLVL: Bash Variables. (line 584)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 276)
* show-all-if-unmodified: Readline Init File Syntax.
(line 282)
* show-mode-in-prompt: Readline Init File Syntax.
(line 285)
* skip-completed-text: Readline Init File Syntax.
(line 291)
* skip-completed-text: Readline Init File Syntax.
(line 297)
* TEXTDOMAIN: Locale Translation. (line 11)
* TEXTDOMAINDIR: Locale Translation. (line 11)
* TIMEFORMAT: Bash Variables. (line 587)
* TMOUT: Bash Variables. (line 625)
* TMPDIR: Bash Variables. (line 637)
* UID: Bash Variables. (line 641)
* TIMEFORMAT: Bash Variables. (line 589)
* TMOUT: Bash Variables. (line 627)
* TMPDIR: Bash Variables. (line 639)
* UID: Bash Variables. (line 643)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 304)
(line 310)
* vi-ins-mode-string: Readline Init File Syntax.
(line 314)
(line 320)
* visible-stats: Readline Init File Syntax.
(line 324)
(line 330)

File: bashref.info, Node: Function Index, Next: Concept Index, Prev: Variable Index, Up: Indexes
@@ -11020,8 +11035,7 @@ D.4 Function Index
(line 43)
* delete-horizontal-space (): Commands For Killing.
(line 46)
* digit-argument ('M-0', 'M-1', ... 'M--'): Numeric Arguments.
(line 6)
* digit-argument (M-0, M-1, ... M--): Numeric Arguments. (line 6)
* display-shell-version (C-x C-v): Miscellaneous Commands.
(line 109)
* do-uppercase-version (M-a, M-b, M-X, ...): Miscellaneous Commands.
@@ -11320,134 +11334,134 @@ D.5 Concept Index

Tag Table:
Node: Top895
Node: Introduction2813
Node: What is Bash?3029
Node: What is a shell?4143
Node: Definitions6681
Node: Basic Shell Features9632
Node: Shell Syntax10851
Node: Shell Operation11877
Node: Quoting13170
Node: Escape Character14470
Node: Single Quotes14955
Node: Double Quotes15303
Node: ANSI-C Quoting16581
Node: Locale Translation17834
Node: Comments18730
Node: Shell Commands19348
Node: Simple Commands20220
Node: Pipelines20851
Node: Lists23594
Node: Compound Commands25323
Node: Looping Constructs26326
Node: Conditional Constructs28789
Node: Command Grouping39710
Node: Coprocesses41189
Node: GNU Parallel43021
Node: Shell Functions46994
Node: Shell Parameters52200
Node: Positional Parameters56602
Node: Special Parameters57502
Node: Shell Expansions60839
Node: Brace Expansion62776
Node: Tilde Expansion65557
Node: Shell Parameter Expansion67905
Node: Command Substitution82037
Node: Arithmetic Expansion83392
Node: Process Substitution84324
Node: Word Splitting85444
Node: Filename Expansion87388
Node: Pattern Matching89672
Node: Quote Removal93370
Node: Redirections93665
Node: Executing Commands102914
Node: Simple Command Expansion103584
Node: Command Search and Execution105514
Node: Command Execution Environment107850
Node: Environment110834
Node: Exit Status112493
Node: Signals114163
Node: Shell Scripts116130
Node: Shell Builtin Commands118645
Node: Bourne Shell Builtins120679
Node: Bash Builtins141281
Node: Modifying Shell Behavior169911
Node: The Set Builtin170256
Node: The Shopt Builtin180669
Node: Special Builtins196289
Node: Shell Variables197268
Node: Bourne Shell Variables197705
Node: Bash Variables199736
Node: Bash Features228000
Node: Invoking Bash228899
Node: Bash Startup Files234848
Node: Interactive Shells239951
Node: What is an Interactive Shell?240361
Node: Is this Shell Interactive?241010
Node: Interactive Shell Behavior241825
Node: Bash Conditional Expressions245200
Node: Shell Arithmetic249201
Node: Aliases251978
Node: Arrays254526
Node: The Directory Stack259610
Node: Directory Stack Builtins260394
Node: Controlling the Prompt263362
Node: The Restricted Shell266108
Node: Bash POSIX Mode267933
Node: Job Control277845
Node: Job Control Basics278305
Node: Job Control Builtins283024
Node: Job Control Variables287554
Node: Command Line Editing288710
Node: Introduction and Notation290381
Node: Readline Interaction292004
Node: Readline Bare Essentials293195
Node: Readline Movement Commands294978
Node: Readline Killing Commands295938
Node: Readline Arguments297856
Node: Searching298900
Node: Readline Init File301086
Node: Readline Init File Syntax302233
Node: Conditional Init Constructs321997
Node: Sample Init File324522
Node: Bindable Readline Commands327639
Node: Commands For Moving328843
Node: Commands For History329986
Node: Commands For Text334275
Node: Commands For Killing337664
Node: Numeric Arguments340145
Node: Commands For Completion341284
Node: Keyboard Macros345475
Node: Miscellaneous Commands346162
Node: Readline vi Mode351966
Node: Programmable Completion352873
Node: Programmable Completion Builtins360334
Node: A Programmable Completion Example370220
Node: Using History Interactively375472
Node: Bash History Facilities376156
Node: Bash History Builtins379157
Node: History Interaction383154
Node: Event Designators386118
Node: Word Designators387337
Node: Modifiers388974
Node: Installing Bash390376
Node: Basic Installation391513
Node: Compilers and Options394204
Node: Compiling For Multiple Architectures394945
Node: Installation Names396608
Node: Specifying the System Type397426
Node: Sharing Defaults398142
Node: Operation Controls398815
Node: Optional Features399773
Node: Reporting Bugs410030
Node: Major Differences From The Bourne Shell411224
Node: GNU Free Documentation License428076
Node: Indexes453253
Node: Builtin Index453707
Node: Reserved Word Index460534
Node: Variable Index462982
Node: Function Index478441
Node: Concept Index491661
Node: Top887
Node: Introduction2797
Node: What is Bash?3013
Node: What is a shell?4127
Node: Definitions6665
Node: Basic Shell Features9616
Node: Shell Syntax10835
Node: Shell Operation11861
Node: Quoting13154
Node: Escape Character14454
Node: Single Quotes14939
Node: Double Quotes15287
Node: ANSI-C Quoting16565
Node: Locale Translation17818
Node: Comments18714
Node: Shell Commands19332
Node: Simple Commands20204
Node: Pipelines20835
Node: Lists23578
Node: Compound Commands25307
Node: Looping Constructs26310
Node: Conditional Constructs28773
Node: Command Grouping39695
Node: Coprocesses41174
Node: GNU Parallel43006
Node: Shell Functions46979
Node: Shell Parameters52185
Node: Positional Parameters56598
Node: Special Parameters57498
Node: Shell Expansions60835
Node: Brace Expansion62772
Node: Tilde Expansion65553
Node: Shell Parameter Expansion67901
Node: Command Substitution82033
Node: Arithmetic Expansion83388
Node: Process Substitution84320
Node: Word Splitting85440
Node: Filename Expansion87384
Node: Pattern Matching89668
Node: Quote Removal93366
Node: Redirections93661
Node: Executing Commands102904
Node: Simple Command Expansion103574
Node: Command Search and Execution105504
Node: Command Execution Environment107840
Node: Environment110824
Node: Exit Status112483
Node: Signals114153
Node: Shell Scripts116120
Node: Shell Builtin Commands118635
Node: Bourne Shell Builtins120669
Node: Bash Builtins141269
Node: Modifying Shell Behavior169914
Node: The Set Builtin170259
Node: The Shopt Builtin180672
Node: Special Builtins196471
Node: Shell Variables197450
Node: Bourne Shell Variables197887
Node: Bash Variables199918
Node: Bash Features228298
Node: Invoking Bash229197
Node: Bash Startup Files235146
Node: Interactive Shells240249
Node: What is an Interactive Shell?240659
Node: Is this Shell Interactive?241308
Node: Interactive Shell Behavior242123
Node: Bash Conditional Expressions245498
Node: Shell Arithmetic249499
Node: Aliases252316
Node: Arrays254864
Node: The Directory Stack259948
Node: Directory Stack Builtins260732
Node: Controlling the Prompt263700
Node: The Restricted Shell266446
Node: Bash POSIX Mode268271
Node: Job Control278324
Node: Job Control Basics278784
Node: Job Control Builtins283503
Node: Job Control Variables288033
Node: Command Line Editing289189
Node: Introduction and Notation290860
Node: Readline Interaction292483
Node: Readline Bare Essentials293674
Node: Readline Movement Commands295457
Node: Readline Killing Commands296417
Node: Readline Arguments298335
Node: Searching299379
Node: Readline Init File301565
Node: Readline Init File Syntax302712
Node: Conditional Init Constructs322899
Node: Sample Init File325424
Node: Bindable Readline Commands328541
Node: Commands For Moving329745
Node: Commands For History330888
Node: Commands For Text335177
Node: Commands For Killing338566
Node: Numeric Arguments341047
Node: Commands For Completion342186
Node: Keyboard Macros346377
Node: Miscellaneous Commands347064
Node: Readline vi Mode352868
Node: Programmable Completion353775
Node: Programmable Completion Builtins361236
Node: A Programmable Completion Example371122
Node: Using History Interactively376374
Node: Bash History Facilities377058
Node: Bash History Builtins380059
Node: History Interaction384056
Node: Event Designators387020
Node: Word Designators388239
Node: Modifiers389876
Node: Installing Bash391278
Node: Basic Installation392415
Node: Compilers and Options395106
Node: Compiling For Multiple Architectures395847
Node: Installation Names397510
Node: Specifying the System Type398328
Node: Sharing Defaults399044
Node: Operation Controls399717
Node: Optional Features400675
Node: Reporting Bugs410932
Node: Major Differences From The Bourne Shell412126
Node: GNU Free Documentation License428978
Node: Indexes454155
Node: Builtin Index454609
Node: Reserved Word Index461436
Node: Variable Index463884
Node: Function Index479343
Node: Concept Index492500

End Tag Table
doc/bashref.pdf
BIN
View File
Binary file not shown.
doc/bashref.ps
+2561 -2460
View File
File diff suppressed because it is too large Load Diff
doc/bashref.texi
+21 -12
View File
@@ -1513,12 +1513,13 @@ When applied to a string-valued variable, @var{value} is expanded and
appended to the variable's value.
A variable can be assigned the @var{nameref} attribute using the
@option{-n} option to the \fBdeclare\fP or \fBlocal\fP builtin commands
@option{-n} option to the @code{declare} or @code{local} builtin commands
(@pxref{Bash Builtins})
to create a @var{nameref}, or a reference to another variable.
This allows variables to be manipulated indirectly.
Whenever the nameref variable is referenced, assigned to, unset, or has
its attributes modified (other than the nameref attribute itself), the
its attributes modified (other than using or changing the nameref
attribute itself), the
operation is actually performed on the variable specified by the nameref
variable's value.
A nameref is commonly used within shell functions to refer to a variable
@@ -2730,7 +2731,7 @@ The format of here-documents is:
No parameter and variable expansion, command substitution,
arithmetic expansion, or filename expansion is performed on
@var{word}. If any characters in @var{word} are quoted, the
@var{word}. If any part of @var{word} is quoted, the
@var{delimiter} is the result of quote removal on @var{word},
and the lines in the here-document are not expanded.
If @var{word} is unquoted,
@@ -3621,8 +3622,7 @@ less than zero, non-zero otherwise.
test @var{expr}
@end example
Evaluate a conditional express
ion @var{expr} and return a status of 0
Evaluate a conditional expression @var{expr} and return a status of 0
(true) or 1 (false).
Each operator and operand must be a separate argument.
Expressions are composed of the primaries described below in
@@ -3801,7 +3801,7 @@ unset [-fnv] [@var{name}]
Remove each variable or function @var{name}.
If the @option{-v} option is given, each
@var{name} refers to a shell variable and that variable is remvoved.
@var{name} refers to a shell variable and that variable is removed.
If the @option{-f} option is given, the @var{name}s refer to shell
functions, and the function definition is removed.
If the @option{-n} option is supplied, and @var{name} is a variable with
@@ -4053,7 +4053,7 @@ Give each @var{name} the @var{nameref} attribute, making
it a name reference to another variable.
That other variable is defined by the value of @var{name}.
All references, assignments, and attribute modifications
to @var{name}, except for changing the
to @var{name}, except for those using or changing the
@option{-n} attribute itself, are performed on the variable referenced by
@var{name}'s value.
The nameref attribute cannot be applied to array variables.
@@ -5144,7 +5144,9 @@ If set, aliases are expanded as described below under Aliases,
This option is enabled by default for interactive shells.
@item extdebug
If set, behavior intended for use by debuggers is enabled:
If set at shell invocation, arrange to execute the debugger profile
before the shell starts, identical to the @option{--debugger} option.
If set after invocation, behavior intended for use by debuggers is enabled:
@enumerate
@item
@@ -5723,11 +5725,14 @@ is readonly.
@item EXECIGNORE
A colon-separated list of shell patterns (@pxref{Pattern Matching})
defining the list of filenames to be ignored by command search.
defining the list of filenames to be ignored by command search using
@code{PATH}.
Files whose full pathnames match one of these patterns are not considered
executable files for the purposes of completion and command execution.
executable files for the purposes of completion and command execution
via @code{PATH} lookup.
This does not affect the behavior of the @code{[}, @code{test}, and @code{[[}
commands.
Full pathnames in the command hash table are not subject to @code{EXECIGNORE}.
Use this variable to ignore shared library files that have the executable
bit set, but are not executable files.
The pattern matching honors the setting of the @code{extglob} shell
@@ -6752,8 +6757,8 @@ may be positive or negative integers.
@cindex arithmetic evaluation
The shell allows arithmetic expressions to be evaluated, as one of
the shell expansions or by the @code{let} and the @option{-i} option
to the @code{declare} builtins.
the shell expansions or by using the @code{((} compound command, the
@code{let} builtin, or the @option{-i} option to the @code{declare} builtin.
Evaluation is done in fixed-width integers with no check for overflow,
though division by 0 is trapped and flagged as an error.
@@ -7566,6 +7571,10 @@ has been set.
If Bash receives a trapped signal while executing @code{read}, the trap
handler executes and @code{read} returns an exit status greater than 128.
@item
Bash removes an exited background process's status from the list of such
statuses after the @code{wait} builtin is used to obtain it.
@end enumerate
There is other @sc{posix} behavior that Bash does not implement by
doc/builtins.0
+7 -5
View File
@@ -411,9 +411,9 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
--nn Give each _n_a_m_e the _n_a_m_e_r_e_f attribute, making it a name
reference to another variable. That other variable is
defined by the value of _n_a_m_e. All references, assign-
ments, and attribute modifications to _n_a_m_e, except for
changing the --nn attribute itself, are performed on the
variable referenced by _n_a_m_e's value. The nameref
ments, and attribute modifications to _n_a_m_e, except those
using or changing the --nn attribute itself, are performed
on the variable referenced by _n_a_m_e's value. The nameref
attribute cannot be applied to array variables.
--rr Make _n_a_m_es readonly. These names cannot then be assigned
values by subsequent assignment statements or unset.
@@ -1393,8 +1393,10 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
AALLIIAASSEESS. This option is enabled by default for interac-
tive shells.
eexxttddeebbuugg
If set, behavior intended for use by debuggers is
enabled:
If set at shell invocation, arrange to execute the
debugger profile before the shell starts, identical to
the ----ddeebbuuggggeerr option. If set after invocation, behav-
ior intended for use by debuggers is enabled:
11.. The --FF option to the ddeeccllaarree builtin displays the
source file name and line number corresponding to
each function name supplied as an argument.
doc/builtins.ps
+347 -342
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.22.3
%%CreationDate: Mon Feb 8 10:16:53 2016
%%CreationDate: Mon Jun 20 15:38:03 2016
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
@@ -889,32 +889,32 @@ F0(Gi)180 300 Q 1.619 -.15(ve e)-.25 H(ach).15 E F1(name)3.819 E F0(the)
(ute, making it a name reference to another v)-.2 F(ariable.)-.25 E
1.519(That other v)180 312 R 1.519(ariable is de\214ned by the v)-.25 F
1.518(alue of)-.25 F F1(name)4.018 E F0 6.518(.A)C 1.518
(ll references, assignments, and)-6.518 F(attrib)180 324 Q .27
(ute modi\214cations to)-.2 F F1(name)2.77 E F0 2.77(,e)C .27
(xcept for changing the)-2.92 F F2<ad6e>2.77 E F0(attrib)2.77 E .27
(ute itself, are performed)-.2 F .895(on the v)180 336 R .895
(ariable referenced by)-.25 F F1(name)3.395 E F0 1.995 -.55('s v)D 3.395
(alue. The).3 F .894(nameref attrib)3.395 F .894
(ute cannot be applied to)-.2 F(array v)180 348 Q(ariables.)-.25 E F2
<ad72>144 360 Q F0(Mak)180 360 Q(e)-.1 E F1(name)5.046 E F0 5.046(sr)C
(eadonly)-5.046 E 7.546(.T)-.65 G 2.546
(hese names cannot then be assigned v)-7.546 F 2.547
(alues by subsequent)-.25 F(assignment statements or unset.)180 372 Q F2
<ad74>144 384 Q F0(Gi)180 384 Q .73 -.15(ve e)-.25 H(ach).15 E F1(name)
2.93 E F0(the)2.929 E F1(tr)2.929 E(ace)-.15 E F0(attrib)2.929 E 2.929
(ute. T)-.2 F .429(raced functions inherit the)-.35 F F2(DEB)2.929 E(UG)
-.1 E F0(and)2.929 E F2(RETURN)2.929 E F0(traps from the calling shell.)
180 396 Q(The trace attrib)5 E(ute has no special meaning for v)-.2 E
(ariables.)-.25 E F2<ad75>144 408 Q F0 .909(When the v)180 408 R .909
(ariable is assigned a v)-.25 F .909(alue, all lo)-.25 F(wer)-.25 E .909
(-case characters are con)-.2 F -.15(ve)-.4 G .91(rted to upper).15 F(-)
-.2 E 2.5(case. The)180 420 R(lo)2.5 E(wer)-.25 E(-case attrib)-.2 E
(ute is disabled.)-.2 E F2<ad78>144 432 Q F0(Mark)180 432 Q F1(name)2.5
E F0 2.5(sf)C(or e)-2.5 E(xport to subsequent commands via the en)-.15 E
(vironment.)-.4 E .121(Using `+' instead of `\255' turns of)144 448.8 R
2.621(ft)-.25 G .121(he attrib)-2.621 F .121(ute instead, with the e)-.2
F .12(xceptions that)-.15 F F2(+a)2.62 E F0 .12(may not be used)2.62 F
.644(to destro)144 460.8 R 3.144(ya)-.1 G 3.144(na)-3.144 G .644(rray v)
(ll references, assignments, and)-6.518 F(attrib)180 324 Q .226
(ute modi\214cations to)-.2 F F1(name)2.726 E F0 2.726(,e)C .226
(xcept those using or changing the)-2.876 F F2<ad6e>2.726 E F0(attrib)
2.726 E .227(ute itself, are)-.2 F .809(performed on the v)180 336 R
.809(ariable referenced by)-.25 F F1(name)3.308 E F0 1.908 -.55('s v)D
3.308(alue. The).3 F .808(nameref attrib)3.308 F .808(ute cannot be)-.2
F(applied to array v)180 348 Q(ariables.)-.25 E F2<ad72>144 360 Q F0
(Mak)180 360 Q(e)-.1 E F1(name)5.046 E F0 5.046(sr)C(eadonly)-5.046 E
7.546(.T)-.65 G 2.546(hese names cannot then be assigned v)-7.546 F
2.547(alues by subsequent)-.25 F(assignment statements or unset.)180 372
Q F2<ad74>144 384 Q F0(Gi)180 384 Q .73 -.15(ve e)-.25 H(ach).15 E F1
(name)2.93 E F0(the)2.929 E F1(tr)2.929 E(ace)-.15 E F0(attrib)2.929 E
2.929(ute. T)-.2 F .429(raced functions inherit the)-.35 F F2(DEB)2.929
E(UG)-.1 E F0(and)2.929 E F2(RETURN)2.929 E F0
(traps from the calling shell.)180 396 Q(The trace attrib)5 E
(ute has no special meaning for v)-.2 E(ariables.)-.25 E F2<ad75>144 408
Q F0 .909(When the v)180 408 R .909(ariable is assigned a v)-.25 F .909
(alue, all lo)-.25 F(wer)-.25 E .909(-case characters are con)-.2 F -.15
(ve)-.4 G .91(rted to upper).15 F(-)-.2 E 2.5(case. The)180 420 R(lo)2.5
E(wer)-.25 E(-case attrib)-.2 E(ute is disabled.)-.2 E F2<ad78>144 432 Q
F0(Mark)180 432 Q F1(name)2.5 E F0 2.5(sf)C(or e)-2.5 E
(xport to subsequent commands via the en)-.15 E(vironment.)-.4 E .121
(Using `+' instead of `\255' turns of)144 448.8 R 2.621(ft)-.25 G .121
(he attrib)-2.621 F .121(ute instead, with the e)-.2 F .12
(xceptions that)-.15 F F2(+a)2.62 E F0 .12(may not be used)2.62 F .644
(to destro)144 460.8 R 3.144(ya)-.1 G 3.144(na)-3.144 G .644(rray v)
-3.144 F .644(ariable and)-.25 F F2(+r)3.145 E F0 .645(will not remo)
3.145 F .945 -.15(ve t)-.15 H .645(he readonly attrib).15 F 3.145
(ute. When)-.2 F .645(used in a func-)3.145 F(tion,)144 472.8 Q F2
@@ -2422,592 +2422,597 @@ E F2(exec)2.5 E F0 -.1(fa)2.5 G(ils.).1 E F2(expand_aliases)144 636 Q F0
F 1.017 -.15(ve u)-.15 H(nder).15 E/F3 9/Times-Bold@0 SF(ALIASES)3.217 E
/F4 9/Times-Roman@0 SF(.)A F0 .716(This option is enabled)5.217 F
(by def)184 660 Q(ault for interacti)-.1 E .3 -.15(ve s)-.25 H(hells.)
.15 E F2(extdeb)144 672 Q(ug)-.2 E F0(If set, beha)184 684 Q
(vior intended for use by deb)-.2 E(uggers is enabled:)-.2 E F2(1.)184
696 Q F0(The)220 696 Q F2<ad46>4.25 E F0 1.75(option to the)4.25 F F2
(declar)4.251 E(e)-.18 E F0 -.2(bu)4.251 G 1.751
(iltin displays the source \214le name and line).2 F
(number corresponding to each function name supplied as an ar)220 708 Q
(gument.)-.18 E(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(18)198.725 E
0 Cg EP
.15 E F2(extdeb)144 672 Q(ug)-.2 E F0 .671(If set at shell in)184 684 R
-.2(vo)-.4 G .671(cation, arrange to e).2 F -.15(xe)-.15 G .671
(cute the deb).15 F .672(ugger pro\214le before the shell starts,)-.2 F
.221(identical to the)184 696 R F2<adad646562>2.721 E(ugger)-.2 E F0
2.721(option. If)2.721 F .221(set after in)2.721 F -.2(vo)-.4 G .221
(cation, beha).2 F .22(vior intended for use by)-.2 F(deb)184 708 Q
(uggers is enabled:)-.2 E(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E
(18)198.725 E 0 Cg EP
%%Page: 19 19
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 87.61
(TINS\(1\) General)-.92 F(Commands Manual)2.5 E -.35(BA)90.11 G(SH_B).35
E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0 SF(2.)184 84 Q F0 1.667
(If the command run by the)220 84 R F1(DEB)4.167 E(UG)-.1 E F0 1.667
(trap returns a non-zero v)4.167 F 1.667(alue, the ne)-.25 F(xt)-.15 E
(command is skipped and not e)220 96 Q -.15(xe)-.15 G(cuted.).15 E F1
(3.)184 108 Q F0 .84(If the command run by the)220 108 R F1(DEB)3.34 E
(UG)-.1 E F0 .841(trap returns a v)3.341 F .841
(alue of 2, and the shell is)-.25 F -.15(exe)220 120 S .488
E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0 SF(1.)184 84 Q F0(The)
220 84 Q F1<ad46>4.25 E F0 1.75(option to the)4.25 F F1(declar)4.251 E
(e)-.18 E F0 -.2(bu)4.251 G 1.751
(iltin displays the source \214le name and line).2 F
(number corresponding to each function name supplied as an ar)220 96 Q
(gument.)-.18 E F1(2.)184 108 Q F0 1.667(If the command run by the)220
108 R F1(DEB)4.167 E(UG)-.1 E F0 1.667(trap returns a non-zero v)4.167 F
1.667(alue, the ne)-.25 F(xt)-.15 E(command is skipped and not e)220 120
Q -.15(xe)-.15 G(cuted.).15 E F1(3.)184 132 Q F0 .84
(If the command run by the)220 132 R F1(DEB)3.34 E(UG)-.1 E F0 .841
(trap returns a v)3.341 F .841(alue of 2, and the shell is)-.25 F -.15
(exe)220 144 S .488
(cuting in a subroutine \(a shell function or a shell script e).15 F
-.15(xe)-.15 G .488(cuted by the).15 F F1(.)2.988 E F0(or)2.988 E F1
(sour)220 132 Q(ce)-.18 E F0 -.2(bu)2.5 G
(sour)220 156 Q(ce)-.18 E F0 -.2(bu)2.5 G
(iltins\), the shell simulates a call to).2 E F1 -.18(re)2.5 G(tur).18 E
(n)-.15 E F0(.)A F1(4.)184 144 Q/F2 9/Times-Bold@0 SF -.27(BA)220 144 S
(n)-.15 E F0(.)A F1(4.)184 168 Q/F2 9/Times-Bold@0 SF -.27(BA)220 168 S
(SH_ARGC).27 E F0(and)3.153 E F2 -.27(BA)3.403 G(SH_ARGV).27 E F0 .904
(are updated as described in their descriptions)3.154 F(abo)220 156 Q
-.15(ve)-.15 G(.).15 E F1(5.)184 168 Q F0 1.637(Function tracing is ena\
bled: command substitution, shell functions, and sub-)220 168 R
(shells in)220 180 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G(ith)-2.5 E F1
(are updated as described in their descriptions)3.154 F(abo)220 180 Q
-.15(ve)-.15 G(.).15 E F1(5.)184 192 Q F0 1.637(Function tracing is ena\
bled: command substitution, shell functions, and sub-)220 192 R
(shells in)220 204 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G(ith)-2.5 E F1
(\()2.5 E/F3 10/Times-Italic@0 SF(command)2.5 E F1(\))2.5 E F0
(inherit the)2.5 E F1(DEB)2.5 E(UG)-.1 E F0(and)2.5 E F1(RETURN)2.5 E F0
(traps.)2.5 E F1(6.)184 192 Q F0 1.082(Error tracing is enabled: comman\
d substitution, shell functions, and subshells)220 192 R(in)220 204 Q
(traps.)2.5 E F1(6.)184 216 Q F0 1.082(Error tracing is enabled: comman\
d substitution, shell functions, and subshells)220 216 R(in)220 228 Q
-.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G(ith)-2.5 E F1(\()2.5 E F3(command)
2.5 E F1(\))2.5 E F0(inherit the)2.5 E F1(ERR)2.5 E F0(trap.)2.5 E F1
(extglob)144 216 Q F0 .4(If set, the e)184 216 R .4
(extglob)144 240 Q F0 .4(If set, the e)184 240 R .4
(xtended pattern matching features described abo)-.15 F .7 -.15(ve u)
-.15 H(nder).15 E F1 -.1(Pa)2.9 G .4(thname Expan-).1 F(sion)184 228 Q
F0(are enabled.)2.5 E F1(extquote)144 240 Q F0 2.473(If set,)184 252 R
-.15 H(nder).15 E F1 -.1(Pa)2.9 G .4(thname Expan-).1 F(sion)184 252 Q
F0(are enabled.)2.5 E F1(extquote)144 264 Q F0 2.473(If set,)184 276 R
F1($)4.973 E F0<08>A F3(string)A F0 4.973<0861>C(nd)-4.973 E F1($)4.973
E F0(")A F3(string)A F0 4.973("q)C 2.473(uoting is performed within)
-4.973 F F1(${)4.973 E F3(par)A(ameter)-.15 E F1(})A F0 -.15(ex)4.973 G
(pansions).15 E(enclosed in double quotes.)184 264 Q
(This option is enabled by def)5 E(ault.)-.1 E F1(failglob)144 276 Q F0
1.425(If set, patterns which f)184 276 R 1.425
(pansions).15 E(enclosed in double quotes.)184 288 Q
(This option is enabled by def)5 E(ault.)-.1 E F1(failglob)144 300 Q F0
1.425(If set, patterns which f)184 300 R 1.425
(ail to match \214lenames during pathname e)-.1 F 1.424
(xpansion result in an)-.15 F -.15(ex)184 288 S(pansion error).15 E(.)
-.55 E F1 -.25(fo)144 300 S -.18(rc).25 G(e_\214gnor).18 E(e)-.18 E F0
.936(If set, the suf)184 312 R<8c78>-.25 E .936(es speci\214ed by the)
(xpansion result in an)-.15 F -.15(ex)184 312 S(pansion error).15 E(.)
-.55 E F1 -.25(fo)144 324 S -.18(rc).25 G(e_\214gnor).18 E(e)-.18 E F0
.936(If set, the suf)184 336 R<8c78>-.25 E .936(es speci\214ed by the)
-.15 F F2(FIGNORE)3.436 E F0 .936(shell v)3.186 F .936(ariable cause w)
-.25 F .937(ords to be ignored)-.1 F .32(when performing w)184 324 R .32
-.25 F .937(ords to be ignored)-.1 F .32(when performing w)184 348 R .32
(ord completion e)-.1 F -.15(ve)-.25 G 2.82(ni).15 G 2.82(ft)-2.82 G .32
(he ignored w)-2.82 F .32(ords are the only possible com-)-.1 F 2.947
(pletions. See)184 336 R F2 .447(SHELL V)2.947 F(ARIABLES)-1.215 E F0
(pletions. See)184 360 R F2 .447(SHELL V)2.947 F(ARIABLES)-1.215 E F0
(abo)2.697 E .747 -.15(ve f)-.15 H .448(or a description of).15 F F2
(FIGNORE)2.948 E/F4 9/Times-Roman@0 SF(.)A F0 .448(This option is)4.948
F(enabled by def)184 348 Q(ault.)-.1 E F1(globasciiranges)144 360 Q F0
2.519(If set, range e)184 372 R 2.519
F(enabled by def)184 372 Q(ault.)-.1 E F1(globasciiranges)144 384 Q F0
2.519(If set, range e)184 396 R 2.519
(xpressions used in pattern matching brack)-.15 F 2.518(et e)-.1 F 2.518
(xpressions \(see)-.15 F F2 -.09(Pa)5.018 G(tter).09 E(n)-.135 E
(Matching)184 384 Q F0(abo)2.964 E -.15(ve)-.15 G 3.214(\)b).15 G(eha)
(Matching)184 408 Q F0(abo)2.964 E -.15(ve)-.15 G 3.214(\)b).15 G(eha)
-3.214 E 1.014 -.15(ve a)-.2 H 3.214(si).15 G 3.214(fi)-3.214 G 3.214
(nt)-3.214 G .714(he traditional C locale when performing comparisons.)
-3.214 F 1.02(That is, the current locale')184 396 R 3.52(sc)-.55 G 1.02
-3.214 F 1.02(That is, the current locale')184 420 R 3.52(sc)-.55 G 1.02
(ollating sequence is not tak)-3.52 F 1.02(en into account, so)-.1 F F1
(b)3.52 E F0 1.02(will not)3.52 F .956(collate between)184 408 R F1(A)
(b)3.52 E F0 1.02(will not)3.52 F .956(collate between)184 432 R F1(A)
3.456 E F0(and)3.456 E F1(B)3.456 E F0 3.457(,a)C .957(nd upper)-3.457 F
.957(-case and lo)-.2 F(wer)-.25 E .957
(-case ASCII characters will collate)-.2 F(together)184 420 Q(.)-.55 E
F1(globstar)144 432 Q F0 .519(If set, the pattern)184 432 R F1(**)3.019
(-case ASCII characters will collate)-.2 F(together)184 444 Q(.)-.55 E
F1(globstar)144 456 Q F0 .519(If set, the pattern)184 456 R F1(**)3.019
E F0 .519(used in a pathname e)3.019 F .519(xpansion conte)-.15 F .518
(xt will match all \214les and zero)-.15 F .431
(or more directories and subdirectories.)184 444 R .431
(or more directories and subdirectories.)184 468 R .431
(If the pattern is follo)5.431 F .432(wed by a)-.25 F F1(/)2.932 E F0
2.932(,o)C .432(nly directories)-2.932 F(and subdirectories match.)184
456 Q F1(gnu_errfmt)144 468 Q F0(If set, shell error messages are writt\
en in the standard GNU error message format.)184 480 Q F1(histappend)144
492 Q F0 .676
480 Q F1(gnu_errfmt)144 492 Q F0(If set, shell error messages are writt\
en in the standard GNU error message format.)184 504 Q F1(histappend)144
516 Q F0 .676
(If set, the history list is appended to the \214le named by the v)184
504 R .676(alue of the)-.25 F F2(HISTFILE)3.176 E F0 -.25(va)2.926 G
(ri-).25 E(able when the shell e)184 516 Q(xits, rather than o)-.15 E
-.15(ve)-.15 G(rwriting the \214le.).15 E F1(histr)144 528 Q(eedit)-.18
E F0 .575(If set, and)184 540 R F1 -.18(re)3.075 G(adline).18 E F0 .575
528 R .676(alue of the)-.25 F F2(HISTFILE)3.176 E F0 -.25(va)2.926 G
(ri-).25 E(able when the shell e)184 540 Q(xits, rather than o)-.15 E
-.15(ve)-.15 G(rwriting the \214le.).15 E F1(histr)144 552 Q(eedit)-.18
E F0 .575(If set, and)184 564 R F1 -.18(re)3.075 G(adline).18 E F0 .575
(is being used, a user is gi)3.075 F -.15(ve)-.25 G 3.075(nt).15 G .576
(he opportunity to re-edit a f)-3.075 F .576(ailed his-)-.1 F
(tory substitution.)184 552 Q F1(histv)144 564 Q(erify)-.1 E F0 .403
(If set, and)184 576 R F1 -.18(re)2.903 G(adline).18 E F0 .403
(tory substitution.)184 576 Q F1(histv)144 588 Q(erify)-.1 E F0 .403
(If set, and)184 600 R F1 -.18(re)2.903 G(adline).18 E F0 .403
(is being used, the results of history substitution are not immediately)
2.903 F .661(passed to the shell parser)184 588 R 5.661(.I)-.55 G .662
2.903 F .661(passed to the shell parser)184 612 R 5.661(.I)-.55 G .662
(nstead, the resulting line is loaded into the)-5.661 F F1 -.18(re)3.162
G(adline).18 E F0(editing)3.162 E -.2(bu)184 600 S -.25(ff).2 G(er).25 E
G(adline).18 E F0(editing)3.162 E -.2(bu)184 624 S -.25(ff).2 G(er).25 E
2.5(,a)-.4 G(llo)-2.5 E(wing further modi\214cation.)-.25 E F1
(hostcomplete)144 612 Q F0 1.182(If set, and)184 624 R F1 -.18(re)3.682
(hostcomplete)144 636 Q F0 1.182(If set, and)184 648 R F1 -.18(re)3.682
G(adline).18 E F0 1.182(is being used,)3.682 F F1(bash)3.682 E F0 1.181
(will attempt to perform hostname completion)3.681 F 1.38(when a w)184
636 R 1.38(ord containing a)-.1 F F1(@)3.881 E F0 1.381
660 R 1.38(ord containing a)-.1 F F1(@)3.881 E F0 1.381
(is being completed \(see)3.881 F F1(Completing)3.881 E F0(under)3.881 E
F2(READLINE)3.881 E F0(abo)184 648 Q -.15(ve)-.15 G 2.5(\). This).15 F
(is enabled by def)2.5 E(ault.)-.1 E F1(huponexit)144 660 Q F0(If set,)
184 672 Q F1(bash)2.5 E F0(will send)2.5 E F2(SIGHUP)2.5 E F0
F2(READLINE)3.881 E F0(abo)184 672 Q -.15(ve)-.15 G 2.5(\). This).15 F
(is enabled by def)2.5 E(ault.)-.1 E F1(huponexit)144 684 Q F0(If set,)
184 696 Q F1(bash)2.5 E F0(will send)2.5 E F2(SIGHUP)2.5 E F0
(to all jobs when an interacti)2.25 E .3 -.15(ve l)-.25 H(ogin shell e)
.15 E(xits.)-.15 E F1(inherit_err)144 684 Q(exit)-.18 E F0 .22
(If set, command substitution inherits the v)184 696 R .219(alue of the)
-.25 F F1(err)2.719 E(exit)-.18 E F0 .219(option, instead of unsetting)
2.719 F(it in the subshell en)184 708 Q 2.5(vironment. This)-.4 F
(option is enabled when)2.5 E F3(posix mode)2.5 E F0(is enabled.)2.5 E
(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(19)198.725 E 0 Cg EP
.15 E(xits.)-.15 E(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(19)
198.725 E 0 Cg EP
%%Page: 20 20
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 87.61
(TINS\(1\) General)-.92 F(Commands Manual)2.5 E -.35(BA)90.11 G(SH_B).35
E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0 SF(interacti)144 84 Q
-.1(ve)-.1 G(_comments).1 E F0 .33(If set, allo)184 96 R 2.83(waw)-.25 G
.33(ord be)-2.93 F .33(ginning with)-.15 F F1(#)2.83 E F0 .33
(to cause that w)2.83 F .33(ord and all remaining characters on)-.1 F
.967(that line to be ignored in an interacti)184 108 R 1.267 -.15(ve s)
-.25 H .967(hell \(see).15 F/F2 9/Times-Bold@0 SF(COMMENTS)3.467 E F0
E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0 SF(inherit_err)144 84 Q
(exit)-.18 E F0 .22(If set, command substitution inherits the v)184 96 R
.219(alue of the)-.25 F F1(err)2.719 E(exit)-.18 E F0 .219
(option, instead of unsetting)2.719 F(it in the subshell en)184 108 Q
2.5(vironment. This)-.4 F(option is enabled when)2.5 E/F2 10
/Times-Italic@0 SF(posix mode)2.5 E F0(is enabled.)2.5 E F1(interacti)
144 120 Q -.1(ve)-.1 G(_comments).1 E F0 .33(If set, allo)184 132 R 2.83
(waw)-.25 G .33(ord be)-2.93 F .33(ginning with)-.15 F F1(#)2.83 E F0
.33(to cause that w)2.83 F .33(ord and all remaining characters on)-.1 F
.967(that line to be ignored in an interacti)184 144 R 1.267 -.15(ve s)
-.25 H .967(hell \(see).15 F/F3 9/Times-Bold@0 SF(COMMENTS)3.467 E F0
(abo)3.217 E -.15(ve)-.15 G 3.467(\). This).15 F .967(option is)3.467 F
(enabled by def)184 120 Q(ault.)-.1 E F1(lastpipe)144 132 Q F0 .066
(If set, and job control is not acti)184 132 R -.15(ve)-.25 G 2.566(,t)
(enabled by def)184 156 Q(ault.)-.1 E F1(lastpipe)144 168 Q F0 .066
(If set, and job control is not acti)184 168 R -.15(ve)-.25 G 2.566(,t)
.15 G .066(he shell runs the last command of a pipeline not e)-2.566 F
-.15(xe)-.15 G(-).15 E(cuted in the background in the current shell en)
184 144 Q(vironment.)-.4 E F1(lithist)144 156 Q F0 .655(If set, and the)
184 156 R F1(cmdhist)3.155 E F0 .654
184 180 Q(vironment.)-.4 E F1(lithist)144 192 Q F0 .655(If set, and the)
184 192 R F1(cmdhist)3.155 E F0 .654
(option is enabled, multi-line commands are sa)3.154 F -.15(ve)-.2 G
3.154(dt).15 G 3.154(ot)-3.154 G .654(he history)-3.154 F
(with embedded ne)184 168 Q
(with embedded ne)184 204 Q
(wlines rather than using semicolon separators where possible.)-.25 E F1
(login_shell)144 180 Q F0 .486
(login_shell)144 216 Q F0 .486
(The shell sets this option if it is started as a login shell \(see)184
192 R F2(INV)2.987 E(OCA)-.405 E(TION)-.855 E F0(abo)2.737 E -.15(ve)
-.15 G 2.987(\). The).15 F -.25(va)184 204 S(lue may not be changed.).25
E F1(mailwar)144 216 Q(n)-.15 E F0 .815(If set, and a \214le that)184
228 R F1(bash)3.315 E F0 .814
228 R F3(INV)2.987 E(OCA)-.405 E(TION)-.855 E F0(abo)2.737 E -.15(ve)
-.15 G 2.987(\). The).15 F -.25(va)184 240 S(lue may not be changed.).25
E F1(mailwar)144 252 Q(n)-.15 E F0 .815(If set, and a \214le that)184
264 R F1(bash)3.315 E F0 .814
(is checking for mail has been accessed since the last time it)3.315 F
-.1(wa)184 240 S 2.5(sc).1 G(heck)-2.5 E(ed, the message `)-.1 E
(`The mail in)-.74 E/F3 10/Times-Italic@0 SF(mail\214le)2.5 E F0
(has been read')2.5 E 2.5('i)-.74 G 2.5(sd)-2.5 G(isplayed.)-2.5 E F1
(no_empty_cmd_completion)144 252 Q F0 .324(If set, and)184 264 R F1 -.18
(re)2.824 G(adline).18 E F0 .324(is being used,)2.824 F F1(bash)2.824 E
F0 .324(will not attempt to search the)2.824 F F2 -.666(PA)2.825 G(TH)
-.189 E F0 .325(for possible)2.575 F
(completions when completion is attempted on an empty line.)184 276 Q F1
(nocaseglob)144 288 Q F0 .437(If set,)184 300 R F1(bash)2.937 E F0 .436
-.1(wa)184 276 S 2.5(sc).1 G(heck)-2.5 E(ed, the message `)-.1 E
(`The mail in)-.74 E F2(mail\214le)2.5 E F0(has been read')2.5 E 2.5('i)
-.74 G 2.5(sd)-2.5 G(isplayed.)-2.5 E F1(no_empty_cmd_completion)144 288
Q F0 .324(If set, and)184 300 R F1 -.18(re)2.824 G(adline).18 E F0 .324
(is being used,)2.824 F F1(bash)2.824 E F0 .324
(will not attempt to search the)2.824 F F3 -.666(PA)2.825 G(TH)-.189 E
F0 .325(for possible)2.575 F
(completions when completion is attempted on an empty line.)184 312 Q F1
(nocaseglob)144 324 Q F0 .437(If set,)184 336 R F1(bash)2.937 E F0 .436
(matches \214lenames in a case\255insensiti)2.937 F .736 -.15(ve f)-.25
H .436(ashion when performing pathname).05 F -.15(ex)184 312 S
H .436(ashion when performing pathname).05 F -.15(ex)184 348 S
(pansion \(see).15 E F1 -.1(Pa)2.5 G(thname Expansion).1 E F0(abo)2.5 E
-.15(ve)-.15 G(\).).15 E F1(nocasematch)144 324 Q F0 1.193(If set,)184
336 R F1(bash)3.693 E F0 1.194(matches patterns in a case\255insensiti)
-.15(ve)-.15 G(\).).15 E F1(nocasematch)144 360 Q F0 1.193(If set,)184
372 R F1(bash)3.693 E F0 1.194(matches patterns in a case\255insensiti)
3.693 F 1.494 -.15(ve f)-.25 H 1.194(ashion when performing matching).05
F .551(while e)184 348 R -.15(xe)-.15 G(cuting).15 E F1(case)3.051 E F0
F .551(while e)184 384 R -.15(xe)-.15 G(cuting).15 E F1(case)3.051 E F0
(or)3.051 E F1([[)3.051 E F0 .551
(conditional commands, when performing pattern substitution)3.051 F -.1
(wo)184 360 S .622(rd e).1 F .623(xpansions, or when \214ltering possib\
le completions as part of programmable com-)-.15 F(pletion.)184 372 Q F1
(nullglob)144 384 Q F0 .855(If set,)184 396 R F1(bash)3.355 E F0(allo)
(wo)184 396 S .622(rd e).1 F .623(xpansions, or when \214ltering possib\
le completions as part of programmable com-)-.15 F(pletion.)184 408 Q F1
(nullglob)144 420 Q F0 .855(If set,)184 432 R F1(bash)3.355 E F0(allo)
3.355 E .855(ws patterns which match no \214les \(see)-.25 F F1 -.1(Pa)
3.354 G .854(thname Expansion).1 F F0(abo)3.354 E -.15(ve)-.15 G 3.354
(\)t).15 G(o)-3.354 E -.15(ex)184 408 S
(\)t).15 G(o)-3.354 E -.15(ex)184 444 S
(pand to a null string, rather than themselv).15 E(es.)-.15 E F1(pr)144
420 Q(ogcomp)-.18 E F0 .676(If set, the programmable completion f)184
432 R .677(acilities \(see)-.1 F F1(Pr)3.177 E .677
456 Q(ogcomp)-.18 E F0 .676(If set, the programmable completion f)184
468 R .677(acilities \(see)-.1 F F1(Pr)3.177 E .677
(ogrammable Completion)-.18 F F0(abo)3.177 E -.15(ve)-.15 G(\)).15 E
(are enabled.)184 444 Q(This option is enabled by def)5 E(ault.)-.1 E F1
(pr)144 456 Q(omptv)-.18 E(ars)-.1 E F0 1.448
(If set, prompt strings under)184 468 R 1.448(go parameter e)-.18 F
1.447(xpansion, command substitution, arithmetic)-.15 F -.15(ex)184 480
(are enabled.)184 480 Q(This option is enabled by def)5 E(ault.)-.1 E F1
(pr)144 492 Q(omptv)-.18 E(ars)-.1 E F0 1.448
(If set, prompt strings under)184 504 R 1.448(go parameter e)-.18 F
1.447(xpansion, command substitution, arithmetic)-.15 F -.15(ex)184 516
S .17(pansion, and quote remo).15 F -.25(va)-.15 G 2.67(la).25 G .17
(fter being e)-2.67 F .17(xpanded as described in)-.15 F F2(PR)2.671 E
(fter being e)-2.67 F .17(xpanded as described in)-.15 F F3(PR)2.671 E
(OMPTING)-.27 E F0(abo)2.421 E -.15(ve)-.15 G(.).15 E
(This option is enabled by def)184 492 Q(ault.)-.1 E F1 -.18(re)144 504
(This option is enabled by def)184 528 Q(ault.)-.1 E F1 -.18(re)144 540
S(stricted_shell).18 E F0 1.069
(The shell sets this option if it is started in restricted mode \(see)
184 516 R F2 1.069(RESTRICTED SHELL)3.569 F F0(belo)184 528 Q 2.86
184 552 R F3 1.069(RESTRICTED SHELL)3.569 F F0(belo)184 564 Q 2.86
(w\). The)-.25 F -.25(va)2.86 G .36(lue may not be changed.).25 F .36
(This is not reset when the startup \214les are e)5.36 F -.15(xe)-.15 G
(-).15 E(cuted, allo)184 540 Q(wing the startup \214les to disco)-.25 E
(-).15 E(cuted, allo)184 576 Q(wing the startup \214les to disco)-.25 E
-.15(ve)-.15 G 2.5(rw).15 G(hether or not a shell is restricted.)-2.5 E
F1(shift_v)144 552 Q(erbose)-.1 E F0 .502(If set, the)184 564 R F1
F1(shift_v)144 588 Q(erbose)-.1 E F0 .502(If set, the)184 600 R F1
(shift)3.002 E F0 -.2(bu)3.002 G .501
(iltin prints an error message when the shift count e).2 F .501
(xceeds the number)-.15 F(of positional parameters.)184 576 Q F1(sour)
144 588 Q(cepath)-.18 E F0 .77(If set, the)184 600 R F1(sour)3.27 E(ce)
(xceeds the number)-.15 F(of positional parameters.)184 612 Q F1(sour)
144 624 Q(cepath)-.18 E F0 .77(If set, the)184 636 R F1(sour)3.27 E(ce)
-.18 E F0(\()3.27 E F1(.)A F0 3.27(\)b)C .77(uiltin uses the v)-3.47 F
.771(alue of)-.25 F F2 -.666(PA)3.271 G(TH)-.189 E F0 .771
.771(alue of)-.25 F F3 -.666(PA)3.271 G(TH)-.189 E F0 .771
(to \214nd the directory containing the)3.021 F
(\214le supplied as an ar)184 612 Q 2.5(gument. This)-.18 F
(option is enabled by def)2.5 E(ault.)-.1 E F1(xpg_echo)144 624 Q F0
(If set, the)184 636 Q F1(echo)2.5 E F0 -.2(bu)2.5 G(iltin e).2 E
(\214le supplied as an ar)184 648 Q 2.5(gument. This)-.18 F
(option is enabled by def)2.5 E(ault.)-.1 E F1(xpg_echo)144 660 Q F0
(If set, the)184 672 Q F1(echo)2.5 E F0 -.2(bu)2.5 G(iltin e).2 E
(xpands backslash-escape sequences by def)-.15 E(ault.)-.1 E F1(suspend)
108 652.8 Q F0([)2.5 E F1<ad66>A F0(])A 1.002(Suspend the e)144 664.8 R
108 688.8 Q F0([)2.5 E F1<ad66>A F0(])A 1.002(Suspend the e)144 700.8 R
-.15(xe)-.15 G 1.002(cution of this shell until it recei).15 F -.15(ve)
-.25 G 3.501(sa).15 G F2(SIGCONT)A F0 3.501(signal. A)3.251 F 1.001
(login shell cannot be)3.501 F .022(suspended; the)144 676.8 R F1<ad66>
-.25 G 3.501(sa).15 G F3(SIGCONT)A F0 3.501(signal. A)3.251 F 1.001
(login shell cannot be)3.501 F .022(suspended; the)144 712.8 R F1<ad66>
2.522 E F0 .022(option can be used to o)2.522 F -.15(ve)-.15 G .022
(rride this and force the suspension.).15 F .023(The return status is)
5.023 F 2.5(0u)144 688.8 S(nless the shell is a login shell and)-2.5 E
5.023 F 2.5(0u)144 724.8 S(nless the shell is a login shell and)-2.5 E
F1<ad66>2.5 E F0(is not supplied, or if job control is not enabled.)2.5
E F1(test)108 705.6 Q F3 -.2(ex)2.5 G(pr).2 E F1([)108 717.6 Q F3 -.2
(ex)2.5 G(pr).2 E F1(])2.5 E F0 .878
(Return a status of 0 \(true\) or 1 \(f)144 717.6 R .877
(alse\) depending on the e)-.1 F -.25(va)-.25 G .877
(luation of the conditional e).25 F(xpression)-.15 E F3 -.2(ex)144 729.6
S(pr).2 E F0 5.53(.E).73 G .53
(ach operator and operand must be a separate ar)-5.53 F 3.03
(gument. Expressions)-.18 F .53(are composed of the)3.03 F(GNU Bash-4.2)
72 768 Q(2004 Apr 20)148.735 E(20)198.725 E 0 Cg EP
E(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(20)198.725 E 0 Cg EP
%%Page: 21 21
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 87.61
(TINS\(1\) General)-.92 F(Commands Manual)2.5 E -.35(BA)90.11 G(SH_B).35
E(UIL)-.1 E(TINS\(1\))-.92 E 3.08(primaries described abo)144 84 R 3.38
-.15(ve u)-.15 H(nder).15 E/F1 9/Times-Bold@0 SF(CONDITION)5.58 E 3.079
(AL EXPRESSIONS)-.18 F/F2 9/Times-Roman@0 SF(.)A/F3 10/Times-Bold@0 SF
(test)7.579 E F0 3.079(does not accept an)5.579 F(y)-.15 E
(options, nor does it accept and ignore an ar)144 96 Q(gument of)-.18 E
F3<adad>2.5 E F0(as signifying the end of options.)2.5 E .785
(Expressions may be combined using the follo)144 114 R .786
E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0 SF(test)108 84 Q/F2 10
/Times-Italic@0 SF -.2(ex)2.5 G(pr).2 E F1([)108 96 Q F2 -.2(ex)2.5 G
(pr).2 E F1(])2.5 E F0 .878(Return a status of 0 \(true\) or 1 \(f)144
96 R .877(alse\) depending on the e)-.1 F -.25(va)-.25 G .877
(luation of the conditional e).25 F(xpression)-.15 E F2 -.2(ex)144 108 S
(pr).2 E F0 5.53(.E).73 G .53
(ach operator and operand must be a separate ar)-5.53 F 3.03
(gument. Expressions)-.18 F .53(are composed of the)3.03 F 3.08
(primaries described abo)144 120 R 3.38 -.15(ve u)-.15 H(nder).15 E/F3 9
/Times-Bold@0 SF(CONDITION)5.58 E 3.079(AL EXPRESSIONS)-.18 F/F4 9
/Times-Roman@0 SF(.)A F1(test)7.579 E F0 3.079(does not accept an)5.579
F(y)-.15 E(options, nor does it accept and ignore an ar)144 132 Q
(gument of)-.18 E F1<adad>2.5 E F0(as signifying the end of options.)2.5
E .785(Expressions may be combined using the follo)144 150 R .786
(wing operators, listed in decreasing order of prece-)-.25 F 3.412
(dence. The)144 126 R -.25(eva)3.412 G .912
(dence. The)144 162 R -.25(eva)3.412 G .912
(luation depends on the number of ar).25 F .911(guments; see belo)-.18 F
4.711 -.65(w. O)-.25 H .911(perator precedence is).65 F
(used when there are \214v)144 138 Q 2.5(eo)-.15 G 2.5(rm)-2.5 G(ore ar)
-2.5 E(guments.)-.18 E F3(!)144 150 Q/F4 10/Times-Italic@0 SF -.2(ex)2.5
G(pr).2 E F0 -.35(Tr)180 150 S(ue if).35 E F4 -.2(ex)2.5 G(pr).2 E F0
(is f)3.23 E(alse.)-.1 E F3(\()144 162 Q F4 -.2(ex)2.5 G(pr).2 E F3(\))
2.5 E F0 .26(Returns the v)180 162 R .26(alue of)-.25 F F4 -.2(ex)2.76 G
(pr).2 E F0 5.26(.T)C .26(his may be used to o)-5.26 F -.15(ve)-.15 G
.26(rride the normal precedence of opera-).15 F(tors.)180 174 Q F4 -.2
(ex)144 186 S(pr1).2 E F0<ad>2.5 E F3(a)A F4 -.2(ex)2.5 G(pr2).2 E F0
-.35(Tr)180 198 S(ue if both).35 E F4 -.2(ex)2.5 G(pr1).2 E F0(and)2.5 E
F4 -.2(ex)2.5 G(pr2).2 E F0(are true.)2.52 E F4 -.2(ex)144 210 S(pr1).2
E F0<ad>2.5 E F3(o)A F4 -.2(ex)2.5 G(pr2).2 E F0 -.35(Tr)180 222 S
(ue if either).35 E F4 -.2(ex)2.5 G(pr1).2 E F0(or)2.5 E F4 -.2(ex)2.5 G
(pr2).2 E F0(is true.)2.52 E F3(test)144 238.8 Q F0(and)2.5 E F3([)2.5 E
(used when there are \214v)144 174 Q 2.5(eo)-.15 G 2.5(rm)-2.5 G(ore ar)
-2.5 E(guments.)-.18 E F1(!)144 186 Q F2 -.2(ex)2.5 G(pr).2 E F0 -.35
(Tr)180 186 S(ue if).35 E F2 -.2(ex)2.5 G(pr).2 E F0(is f)3.23 E(alse.)
-.1 E F1(\()144 198 Q F2 -.2(ex)2.5 G(pr).2 E F1(\))2.5 E F0 .26
(Returns the v)180 198 R .26(alue of)-.25 F F2 -.2(ex)2.76 G(pr).2 E F0
5.26(.T)C .26(his may be used to o)-5.26 F -.15(ve)-.15 G .26
(rride the normal precedence of opera-).15 F(tors.)180 210 Q F2 -.2(ex)
144 222 S(pr1).2 E F0<ad>2.5 E F1(a)A F2 -.2(ex)2.5 G(pr2).2 E F0 -.35
(Tr)180 234 S(ue if both).35 E F2 -.2(ex)2.5 G(pr1).2 E F0(and)2.5 E F2
-.2(ex)2.5 G(pr2).2 E F0(are true.)2.52 E F2 -.2(ex)144 246 S(pr1).2 E
F0<ad>2.5 E F1(o)A F2 -.2(ex)2.5 G(pr2).2 E F0 -.35(Tr)180 258 S
(ue if either).35 E F2 -.2(ex)2.5 G(pr1).2 E F0(or)2.5 E F2 -.2(ex)2.5 G
(pr2).2 E F0(is true.)2.52 E F1(test)144 274.8 Q F0(and)2.5 E F1([)2.5 E
F0 -.25(eva)2.5 G(luate conditional e).25 E
(xpressions using a set of rules based on the number of ar)-.15 E
(guments.)-.18 E 2.5(0a)144 256.8 S -.18(rg)-2.5 G(uments).18 E(The e)
180 268.8 Q(xpression is f)-.15 E(alse.)-.1 E 2.5(1a)144 280.8 S -.18
(rg)-2.5 G(ument).18 E(The e)180 292.8 Q
(guments.)-.18 E 2.5(0a)144 292.8 S -.18(rg)-2.5 G(uments).18 E(The e)
180 304.8 Q(xpression is f)-.15 E(alse.)-.1 E 2.5(1a)144 316.8 S -.18
(rg)-2.5 G(ument).18 E(The e)180 328.8 Q
(xpression is true if and only if the ar)-.15 E(gument is not null.)-.18
E 2.5(2a)144 304.8 S -.18(rg)-2.5 G(uments).18 E .37(If the \214rst ar)
180 316.8 R .37(gument is)-.18 F F3(!)2.87 E F0 2.87(,t)C .37(he e)-2.87
E 2.5(2a)144 340.8 S -.18(rg)-2.5 G(uments).18 E .37(If the \214rst ar)
180 352.8 R .37(gument is)-.18 F F1(!)2.87 E F0 2.87(,t)C .37(he e)-2.87
F .37(xpression is true if and only if the second ar)-.15 F .37
(gument is null.)-.18 F .379(If the \214rst ar)180 328.8 R .38
(gument is null.)-.18 F .379(If the \214rst ar)180 364.8 R .38
(gument is one of the unary conditional operators listed abo)-.18 F .68
-.15(ve u)-.15 H(nder).15 E F1(CONDI-)2.88 E(TION)180 340.8 Q .553
(AL EXPRESSIONS)-.18 F F2(,)A F0 .552(the e)2.802 F .552
-.15(ve u)-.15 H(nder).15 E F3(CONDI-)2.88 E(TION)180 376.8 Q .553
(AL EXPRESSIONS)-.18 F F4(,)A F0 .552(the e)2.802 F .552
(xpression is true if the unary test is true.)-.15 F .552
(If the \214rst ar)5.552 F(gu-)-.18 E(ment is not a v)180 352.8 Q
(If the \214rst ar)5.552 F(gu-)-.18 E(ment is not a v)180 388.8 Q
(alid unary conditional operator)-.25 E 2.5(,t)-.4 G(he e)-2.5 E
(xpression is f)-.15 E(alse.)-.1 E 2.5(3a)144 364.8 S -.18(rg)-2.5 G
(uments).18 E .236(The follo)180 376.8 R .236
(xpression is f)-.15 E(alse.)-.1 E 2.5(3a)144 400.8 S -.18(rg)-2.5 G
(uments).18 E .236(The follo)180 412.8 R .236
(wing conditions are applied in the order listed.)-.25 F .236
(If the second ar)5.236 F .236(gument is one of)-.18 F .855
(the binary conditional operators listed abo)180 388.8 R 1.155 -.15
(ve u)-.15 H(nder).15 E F1(CONDITION)3.355 E .855(AL EXPRESSIONS)-.18 F
F2(,)A F0(the)3.104 E .578(result of the e)180 400.8 R .578(xpression i\
(the binary conditional operators listed abo)180 424.8 R 1.155 -.15
(ve u)-.15 H(nder).15 E F3(CONDITION)3.355 E .855(AL EXPRESSIONS)-.18 F
F4(,)A F0(the)3.104 E .578(result of the e)180 436.8 R .578(xpression i\
s the result of the binary test using the \214rst and third ar)-.15 F
(guments)-.18 E 1.333(as operands.)180 412.8 R(The)6.333 E F3<ad61>3.833
E F0(and)3.833 E F3<ad6f>3.832 E F0 1.332
(guments)-.18 E 1.333(as operands.)180 448.8 R(The)6.333 E F1<ad61>3.833
E F0(and)3.833 E F1<ad6f>3.832 E F0 1.332
(operators are considered binary operators when there are)3.832 F .558
(three ar)180 424.8 R 3.058(guments. If)-.18 F .558(the \214rst ar)3.058
F .558(gument is)-.18 F F3(!)3.058 E F0 3.058(,t)C .558(he v)-3.058 F
(three ar)180 460.8 R 3.058(guments. If)-.18 F .558(the \214rst ar)3.058
F .558(gument is)-.18 F F1(!)3.058 E F0 3.058(,t)C .558(he v)-3.058 F
.558(alue is the ne)-.25 F -.05(ga)-.15 G .558(tion of the tw).05 F
(o-ar)-.1 E(gument)-.18 E .521(test using the second and third ar)180
436.8 R 3.021(guments. If)-.18 F .521(the \214rst ar)3.021 F .52
(gument is e)-.18 F(xactly)-.15 E F3(\()3.02 E F0 .52(and the third)3.02
F(ar)180 448.8 Q .485(gument is e)-.18 F(xactly)-.15 E F3(\))2.985 E F0
472.8 R 3.021(guments. If)-.18 F .521(the \214rst ar)3.021 F .52
(gument is e)-.18 F(xactly)-.15 E F1(\()3.02 E F0 .52(and the third)3.02
F(ar)180 484.8 Q .485(gument is e)-.18 F(xactly)-.15 E F1(\))2.985 E F0
2.985(,t)C .485(he result is the one-ar)-2.985 F .485
(gument test of the second ar)-.18 F 2.985(gument. Other)-.18 F(-)-.2 E
(wise, the e)180 460.8 Q(xpression is f)-.15 E(alse.)-.1 E 2.5(4a)144
472.8 S -.18(rg)-2.5 G(uments).18 E .385(If the \214rst ar)180 484.8 R
.385(gument is)-.18 F F3(!)2.885 E F0 2.885(,t)C .385
(wise, the e)180 496.8 Q(xpression is f)-.15 E(alse.)-.1 E 2.5(4a)144
508.8 S -.18(rg)-2.5 G(uments).18 E .385(If the \214rst ar)180 520.8 R
.385(gument is)-.18 F F1(!)2.885 E F0 2.885(,t)C .385
(he result is the ne)-2.885 F -.05(ga)-.15 G .384(tion of the three-ar)
.05 F .384(gument e)-.18 F .384(xpression com-)-.15 F 1.647
(posed of the remaining ar)180 496.8 R 4.147(guments. Otherwise,)-.18 F
(posed of the remaining ar)180 532.8 R 4.147(guments. Otherwise,)-.18 F
1.647(the e)4.147 F 1.648(xpression is parsed and e)-.15 F -.25(va)-.25
G(luated).25 E(according to precedence using the rules listed abo)180
508.8 Q -.15(ve)-.15 G(.).15 E 2.5(5o)144 520.8 S 2.5(rm)-2.5 G(ore ar)
-2.5 E(guments)-.18 E 1.635(The e)180 532.8 R 1.635
544.8 Q -.15(ve)-.15 G(.).15 E 2.5(5o)144 556.8 S 2.5(rm)-2.5 G(ore ar)
-2.5 E(guments)-.18 E 1.635(The e)180 568.8 R 1.635
(xpression is parsed and e)-.15 F -.25(va)-.25 G 1.635
(luated according to precedence using the rules listed).25 F(abo)180
544.8 Q -.15(ve)-.15 G(.).15 E(When used with)144 562.8 Q F3(test)2.5 E
F0(or)2.5 E F3([)2.5 E F0 2.5(,t)C(he)-2.5 E F3(<)2.5 E F0(and)2.5 E F3
580.8 Q -.15(ve)-.15 G(.).15 E(When used with)144 598.8 Q F1(test)2.5 E
F0(or)2.5 E F1([)2.5 E F0 2.5(,t)C(he)-2.5 E F1(<)2.5 E F0(and)2.5 E F1
(>)2.5 E F0(operators sort le)2.5 E
(xicographically using ASCII ordering.)-.15 E F3(times)108 579.6 Q F0
(xicographically using ASCII ordering.)-.15 E F1(times)108 615.6 Q F0
1.229(Print the accumulated user and system times for the shell and for\
processes run from the shell.)144 579.6 R(The return status is 0.)144
591.6 Q F3(trap)108 608.4 Q F0([)2.5 E F3(\255lp)A F0 2.5(][)C([)-2.5 E
F4(ar)A(g)-.37 E F0(])A F4(sigspec)2.5 E F0(...])2.5 E .703(The command)
144 620.4 R F4(ar)3.533 E(g)-.37 E F0 .703(is to be read and e)3.423 F
processes run from the shell.)144 615.6 R(The return status is 0.)144
627.6 Q F1(trap)108 644.4 Q F0([)2.5 E F1(\255lp)A F0 2.5(][)C([)-2.5 E
F2(ar)A(g)-.37 E F0(])A F2(sigspec)2.5 E F0(...])2.5 E .703(The command)
144 656.4 R F2(ar)3.533 E(g)-.37 E F0 .703(is to be read and e)3.423 F
-.15(xe)-.15 G .702(cuted when the shell recei).15 F -.15(ve)-.25 G
3.202(ss).15 G(ignal\(s\))-3.202 E F4(sigspec)3.202 E F0 5.702(.I).31 G
(f)-5.702 E F4(ar)3.532 E(g)-.37 E F0(is)3.422 E .608
(absent \(and there is a single)144 632.4 R F4(sigspec)3.108 E F0 3.108
(\)o)C(r)-3.108 E F3<ad>3.108 E F0 3.108(,e)C .608
3.202(ss).15 G(ignal\(s\))-3.202 E F2(sigspec)3.202 E F0 5.702(.I).31 G
(f)-5.702 E F2(ar)3.532 E(g)-.37 E F0(is)3.422 E .608
(absent \(and there is a single)144 668.4 R F2(sigspec)3.108 E F0 3.108
(\)o)C(r)-3.108 E F1<ad>3.108 E F0 3.108(,e)C .608
(ach speci\214ed signal is reset to its original disposition)-3.108 F
.659(\(the v)144 644.4 R .659(alue it had upon entrance to the shell\).)
-.25 F(If)5.658 E F4(ar)3.488 E(g)-.37 E F0 .658
(is the null string the signal speci\214ed by each)3.378 F F4(sigspec)
144.34 656.4 Q F0 .58(is ignored by the shell and by the commands it in)
3.39 F -.2(vo)-.4 G -.1(ke).2 G 3.081(s. If).1 F F4(ar)3.411 E(g)-.37 E
F0 .581(is not present and)3.301 F F3<ad70>3.081 E F0(has)3.081 E 1.215
(been supplied, then the trap commands associated with each)144 668.4 R
F4(sigspec)4.054 E F0 1.214(are displayed.)4.024 F 1.214(If no ar)6.214
F(gu-)-.18 E .86(ments are supplied or if only)144 680.4 R F3<ad70>3.36
E F0 .86(is gi)3.36 F -.15(ve)-.25 G(n,).15 E F3(trap)3.36 E F0 .86
(prints the list of commands associated with each)3.36 F 2.83
(signal. The)144 692.4 R F3<ad6c>2.83 E F0 .33(option causes the shell \
to print a list of signal names and their corresponding num-)2.83 F 4.31
(bers. Each)144 704.4 R F4(sigspec)4.65 E F0 1.811
(is either a signal name de\214ned in <)4.62 F F4(signal.h)A F0 1.811
(>, or a signal number)B 6.811(.S)-.55 G(ignal)-6.811 E
(names are case insensiti)144 716.4 Q .3 -.15(ve a)-.25 H(nd the).15 E
F1(SIG)2.5 E F0(pre\214x is optional.)2.25 E(GNU Bash-4.2)72 768 Q
(2004 Apr 20)148.735 E(21)198.725 E 0 Cg EP
.659(\(the v)144 680.4 R .659(alue it had upon entrance to the shell\).)
-.25 F(If)5.658 E F2(ar)3.488 E(g)-.37 E F0 .658
(is the null string the signal speci\214ed by each)3.378 F F2(sigspec)
144.34 692.4 Q F0 .58(is ignored by the shell and by the commands it in)
3.39 F -.2(vo)-.4 G -.1(ke).2 G 3.081(s. If).1 F F2(ar)3.411 E(g)-.37 E
F0 .581(is not present and)3.301 F F1<ad70>3.081 E F0(has)3.081 E 1.215
(been supplied, then the trap commands associated with each)144 704.4 R
F2(sigspec)4.054 E F0 1.214(are displayed.)4.024 F 1.214(If no ar)6.214
F(gu-)-.18 E .86(ments are supplied or if only)144 716.4 R F1<ad70>3.36
E F0 .86(is gi)3.36 F -.15(ve)-.25 G(n,).15 E F1(trap)3.36 E F0 .86
(prints the list of commands associated with each)3.36 F 4.327
(signal. The)144 728.4 R F1<ad6c>4.327 E F0 1.826(option causes the she\
ll to print a list of signal names and their corresponding)4.327 F
(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(21)198.725 E 0 Cg EP
%%Page: 22 22
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 87.61
(TINS\(1\) General)-.92 F(Commands Manual)2.5 E -.35(BA)90.11 G(SH_B).35
E(UIL)-.1 E(TINS\(1\))-.92 E 1.649(If a)144 84 R/F1 10/Times-Italic@0 SF
(sigspec)4.489 E F0(is)4.459 E/F2 9/Times-Bold@0 SF(EXIT)4.149 E F0
1.649(\(0\) the command)3.899 F F1(ar)4.479 E(g)-.37 E F0 1.649(is e)
4.369 F -.15(xe)-.15 G 1.649(cuted on e).15 F 1.648(xit from the shell.)
-.15 F 1.648(If a)6.648 F F1(sigspec)4.488 E F0(is)4.458 E F2(DEB)144 96
Q(UG)-.09 E/F3 9/Times-Roman@0 SF(,)A F0 1.167(the command)3.417 F F1
(ar)3.997 E(g)-.37 E F0 1.167(is e)3.887 F -.15(xe)-.15 G 1.167
E(UIL)-.1 E(TINS\(1\))-.92 E 3.125(numbers. Each)144 84 R/F1 10
/Times-Italic@0 SF(sigspec)3.465 E F0 .625
(is either a signal name de\214ned in <)3.435 F F1(signal.h)A F0 .626
(>, or a signal number)B 5.626(.S)-.55 G(ignal)-5.626 E
(names are case insensiti)144 96 Q .3 -.15(ve a)-.25 H(nd the).15 E/F2 9
/Times-Bold@0 SF(SIG)2.5 E F0(pre\214x is optional.)2.25 E 1.649(If a)
144 114 R F1(sigspec)4.489 E F0(is)4.459 E F2(EXIT)4.149 E F0 1.649
(\(0\) the command)3.899 F F1(ar)4.479 E(g)-.37 E F0 1.649(is e)4.369 F
-.15(xe)-.15 G 1.649(cuted on e).15 F 1.648(xit from the shell.)-.15 F
1.648(If a)6.648 F F1(sigspec)4.488 E F0(is)4.458 E F2(DEB)144 126 Q(UG)
-.09 E/F3 9/Times-Roman@0 SF(,)A F0 1.167(the command)3.417 F F1(ar)
3.997 E(g)-.37 E F0 1.167(is e)3.887 F -.15(xe)-.15 G 1.167
(cuted before e).15 F -.15(ve)-.25 G(ry).15 E F1 1.168(simple command)
3.667 F F0(,)A F1(for)3.668 E F0(command,)3.668 E F1(case)3.668 E F0
(com-)3.668 E(mand,)144 108 Q F1(select)2.647 E F0 .147(command, e)2.647
(com-)3.668 E(mand,)144 138 Q F1(select)2.647 E F0 .147(command, e)2.647
F -.15(ve)-.25 G .147(ry arithmetic).15 F F1(for)2.647 E F0 .146
(command, and before the \214rst command e)2.647 F -.15(xe)-.15 G .146
(cutes in a).15 F .145(shell function \(see)144 120 R F2 .145
(cutes in a).15 F .145(shell function \(see)144 150 R F2 .145
(SHELL GRAMMAR)2.645 F F0(abo)2.395 E -.15(ve)-.15 G 2.646(\). Refer).15
F .146(to the description of the)2.646 F/F4 10/Times-Bold@0 SF(extdeb)
2.646 E(ug)-.2 E F0 .146(option to)2.646 F(the)144 132 Q F4(shopt)3.201
2.646 E(ug)-.2 E F0 .146(option to)2.646 F(the)144 162 Q F4(shopt)3.201
E F0 -.2(bu)3.201 G .7(iltin for details of its ef).2 F .7(fect on the)
-.25 F F4(DEB)3.2 E(UG)-.1 E F0 3.2(trap. If)3.2 F(a)3.2 E F1(sigspec)
3.54 E F0(is)3.51 E F2(RETURN)3.2 E F3(,)A F0 .7(the com-)2.95 F(mand)
144 144 Q F1(ar)3.473 E(g)-.37 E F0 .643(is e)3.363 F -.15(xe)-.15 G
144 174 Q F1(ar)3.473 E(g)-.37 E F0 .643(is e)3.363 F -.15(xe)-.15 G
.643(cuted each time a shell function or a script e).15 F -.15(xe)-.15 G
.644(cuted with the).15 F F4(.)3.144 E F0(or)3.144 E F4(sour)3.144 E(ce)
-.18 E F0 -.2(bu)3.144 G(iltins).2 E(\214nishes e)144 156 Q -.15(xe)-.15
G(cuting.).15 E .961(If a)144 174 R F1(sigspec)3.801 E F0(is)3.771 E F2
-.18 E F0 -.2(bu)3.144 G(iltins).2 E(\214nishes e)144 186 Q -.15(xe)-.15
G(cuting.).15 E .961(If a)144 204 R F1(sigspec)3.801 E F0(is)3.771 E F2
(ERR)3.461 E F3(,)A F0 .961(the command)3.211 F F1(ar)3.791 E(g)-.37 E
F0 .961(is e)3.681 F -.15(xe)-.15 G .961(cuted whene).15 F -.15(ve)-.25
G 3.461(ra).15 G .96(pipeline \(which may consist of a)-.001 F .185(sin\
gle simple command\), a list, or a compound command returns a non\255ze\
ro e)144 186 R .185(xit status, subject to)-.15 F .452(the follo)144 198
ro e)144 216 R .185(xit status, subject to)-.15 F .452(the follo)144 228
R .452(wing conditions.)-.25 F(The)5.452 E F2(ERR)2.952 E F0 .451
(trap is not e)2.701 F -.15(xe)-.15 G .451(cuted if the f).15 F .451
(ailed command is part of the com-)-.1 F .387
(mand list immediately follo)144 210 R .387(wing a)-.25 F F4(while)2.887
(mand list immediately follo)144 240 R .387(wing a)-.25 F F4(while)2.887
E F0(or)2.887 E F4(until)2.888 E F0 -.1(ke)2.888 G(yw)-.05 E .388
(ord, part of the test in an)-.1 F F1(if)2.898 E F0 .388
(statement, part)4.848 F .778(of a command e)144 222 R -.15(xe)-.15 G
(statement, part)4.848 F .778(of a command e)144 252 R -.15(xe)-.15 G
.778(cuted in a).15 F F4(&&)3.278 E F0(or)3.278 E F4(||)3.278 E F0 .778
(list e)3.278 F .778(xcept the command follo)-.15 F .778
(wing the \214nal)-.25 F F4(&&)3.278 E F0(or)3.278 E F4(||)3.277 E F0
3.277(,a)C -.15(ny)-3.277 G 1.28(command in a pipeline b)144 234 R 1.28
3.277(,a)C -.15(ny)-3.277 G 1.28(command in a pipeline b)144 264 R 1.28
(ut the last, or if the command')-.2 F 3.78(sr)-.55 G 1.28(eturn v)-3.78
F 1.28(alue is being in)-.25 F -.15(ve)-.4 G 1.28(rted using).15 F F4(!)
3.78 E F0(.)A(These are the same conditions obe)144 246 Q(yed by the)
3.78 E F0(.)A(These are the same conditions obe)144 276 Q(yed by the)
-.15 E F4(err)2.5 E(exit)-.18 E F0(\()2.5 E F4<ad65>A F0 2.5(\)o)C
(ption.)-2.5 E 1.095
(Signals ignored upon entry to the shell cannot be trapped or reset.)144
264 R -.35(Tr)6.095 G 1.095(apped signals that are not).35 F .662
(being ignored are reset to their original v)144 276 R .662
294 R -.35(Tr)6.095 G 1.095(apped signals that are not).35 F .662
(being ignored are reset to their original v)144 306 R .662
(alues in a subshell or subshell en)-.25 F .662(vironment when one is)
-.4 F 2.5(created. The)144 288 R(return status is f)2.5 E(alse if an)-.1
-.4 F 2.5(created. The)144 318 R(return status is f)2.5 E(alse if an)-.1
E(y)-.15 E F1(sigspec)2.84 E F0(is in)2.81 E -.25(va)-.4 G
(lid; otherwise).25 E F4(trap)2.5 E F0(returns true.)2.5 E F4(type)108
304.8 Q F0([)2.5 E F4(\255aftpP)A F0(])A F1(name)2.5 E F0([)2.5 E F1
(name)A F0(...])2.5 E -.4(Wi)144 316.8 S .174
334.8 Q F0([)2.5 E F4(\255aftpP)A F0(])A F1(name)2.5 E F0([)2.5 E F1
(name)A F0(...])2.5 E -.4(Wi)144 346.8 S .174
(th no options, indicate ho).4 F 2.674(we)-.25 G(ach)-2.674 E F1(name)
3.034 E F0 -.1(wo)2.854 G .173
(uld be interpreted if used as a command name.).1 F .173(If the)5.173 F
F4<ad74>144 328.8 Q F0 .842(option is used,)3.342 F F4(type)3.342 E F0
F4<ad74>144 358.8 Q F0 .842(option is used,)3.342 F F4(type)3.342 E F0
.843(prints a string which is one of)3.343 F F1(alias)3.343 E F0(,).27 E
F1 -.1(ke)3.343 G(ywor)-.2 E(d)-.37 E F0(,).77 E F1(function)3.343 E F0
(,).24 E F1 -.2(bu)3.343 G(iltin).2 E F0 3.343(,o).24 G(r)-3.343 E F1
(\214le)5.253 E F0(if)3.523 E F1(name)144.36 340.8 Q F0 .087
(\214le)5.253 E F0(if)3.523 E F1(name)144.36 370.8 Q F0 .087
(is an alias, shell reserv)2.767 F .087(ed w)-.15 F .087
(ord, function, b)-.1 F .086(uiltin, or disk \214le, respecti)-.2 F -.15
(ve)-.25 G(ly).15 E 5.086(.I)-.65 G 2.586(ft)-5.086 G(he)-2.586 E F1
(name)2.946 E F0 .086(is not)2.766 F .118
(found, then nothing is printed, and an e)144 352.8 R .118
(found, then nothing is printed, and an e)144 382.8 R .118
(xit status of f)-.15 F .118(alse is returned.)-.1 F .119(If the)5.119 F
F4<ad70>2.619 E F0 .119(option is used,)2.619 F F4(type)2.619 E F0 .855
(either returns the name of the disk \214le that w)144 364.8 R .855
(either returns the name of the disk \214le that w)144 394.8 R .855
(ould be e)-.1 F -.15(xe)-.15 G .855(cuted if).15 F F1(name)3.715 E F0
.855(were speci\214ed as a com-)3.535 F .64(mand name, or nothing if)144
376.8 R/F5 10/Courier@0 SF .64(type -t name)3.14 F F0 -.1(wo)3.14 G .641
406.8 R/F5 10/Courier@0 SF .64(type -t name)3.14 F F0 -.1(wo)3.14 G .641
(uld not return).1 F F1(\214le)3.141 E F0 5.641(.T).18 G(he)-5.641 E F4
<ad50>3.141 E F0 .641(option forces a)3.141 F F2 -.666(PA)3.141 G(TH)
-.189 E F0 .113(search for each)144 388.8 R F1(name)2.613 E F0 2.613(,e)
-.189 E F0 .113(search for each)144 418.8 R F1(name)2.613 E F0 2.613(,e)
C -.15(ve)-2.863 G 2.613(ni).15 G(f)-2.613 E F5 .113(type -t name)2.613
F F0 -.1(wo)2.613 G .113(uld not return).1 F F1(\214le)2.613 E F0 5.113
(.I).18 G 2.613(fa)-5.113 G .112(command is hashed,)-.001 F F4<ad70>
2.612 E F0(and)144 400.8 Q F4<ad50>3.23 E F0 .73(print the hashed v)3.23
2.612 E F0(and)144 430.8 Q F4<ad50>3.23 E F0 .73(print the hashed v)3.23
F .731
(alue, which is not necessarily the \214le that appears \214rst in)-.25
F F2 -.666(PA)3.231 G(TH)-.189 E F3(.)A F0 .731(If the)5.231 F F4<ad61>
144 412.8 Q F0 1.749(option is used,)4.249 F F4(type)4.248 E F0 1.748
144 442.8 Q F0 1.749(option is used,)4.249 F F4(type)4.248 E F0 1.748
(prints all of the places that contain an e)4.248 F -.15(xe)-.15 G 1.748
(cutable named).15 F F1(name)4.248 E F0 6.748(.T).18 G(his)-6.748 E .744
(includes aliases and functions, if and only if the)144 424.8 R F4<ad70>
(includes aliases and functions, if and only if the)144 454.8 R F4<ad70>
3.244 E F0 .744(option is not also used.)3.244 F .744
(The table of hashed)5.744 F 1.223(commands is not consulted when using)
144 436.8 R F4<ad61>3.723 E F0 6.223(.T)C(he)-6.223 E F4<ad66>3.723 E F0
144 466.8 R F4<ad61>3.723 E F0 6.223(.T)C(he)-6.223 E F4<ad66>3.723 E F0
1.223(option suppresses shell function lookup, as)3.723 F .325(with the)
144 448.8 R F4(command)2.825 E F0 -.2(bu)2.825 G(iltin.).2 E F4(type)
144 478.8 R F4(command)2.825 E F0 -.2(bu)2.825 G(iltin.).2 E F4(type)
5.325 E F0 .325(returns true if all of the ar)2.825 F .326
(guments are found, f)-.18 F .326(alse if an)-.1 F 2.826(ya)-.15 G .326
(re not)-2.826 F(found.)144 460.8 Q F4(ulimit)108 477.6 Q F0([)2.5 E F4
(re not)-2.826 F(found.)144 490.8 Q F4(ulimit)108 507.6 Q F0([)2.5 E F4
(\255HSabcde\214klmnpqrstuvxPT)A F0([)2.5 E F1(limit)A F0(]])A(Pro)144
489.6 Q .244(vides control o)-.15 F -.15(ve)-.15 G 2.744(rt).15 G .244
519.6 Q .244(vides control o)-.15 F -.15(ve)-.15 G 2.744(rt).15 G .244
(he resources a)-2.744 F -.25(va)-.2 G .244
(ilable to the shell and to processes started by it, on systems).25 F
.943(that allo)144 501.6 R 3.443(ws)-.25 G .943(uch control.)-3.443 F
.943(that allo)144 531.6 R 3.443(ws)-.25 G .943(uch control.)-3.443 F
(The)5.943 E F4<ad48>3.443 E F0(and)3.443 E F4<ad53>3.444 E F0 .944
(options specify that the hard or soft limit is set for the)3.444 F(gi)
144 513.6 Q -.15(ve)-.25 G 2.709(nr).15 G 2.709(esource. A)-2.709 F .208
144 543.6 Q -.15(ve)-.25 G 2.709(nr).15 G 2.709(esource. A)-2.709 F .208
(hard limit cannot be increased by a non-root user once it is set; a so\
ft limit may)2.709 F .425(be increased up to the v)144 525.6 R .425
ft limit may)2.709 F .425(be increased up to the v)144 555.6 R .425
(alue of the hard limit.)-.25 F .426(If neither)5.425 F F4<ad48>2.926 E
F0(nor)2.926 E F4<ad53>2.926 E F0 .426
(is speci\214ed, both the soft and)2.926 F .139(hard limits are set.)144
537.6 R .139(The v)5.139 F .139(alue of)-.25 F F1(limit)2.729 E F0 .139
567.6 R .139(The v)5.139 F .139(alue of)-.25 F F1(limit)2.729 E F0 .139
(can be a number in the unit speci\214ed for the resource or one)3.319 F
.741(of the special v)144 549.6 R(alues)-.25 E F4(hard)3.241 E F0(,)A F4
.741(of the special v)144 579.6 R(alues)-.25 E F4(hard)3.241 E F0(,)A F4
(soft)3.241 E F0 3.241(,o)C(r)-3.241 E F4(unlimited)3.241 E F0 3.241(,w)
C .741(hich stand for the current hard limit, the current)-3.241 F .78
(soft limit, and no limit, respecti)144 561.6 R -.15(ve)-.25 G(ly).15 E
(soft limit, and no limit, respecti)144 591.6 R -.15(ve)-.25 G(ly).15 E
5.78(.I)-.65 G(f)-5.78 E F1(limit)3.37 E F0 .78
(is omitted, the current v)3.96 F .78(alue of the soft limit of the)-.25
F .498(resource is printed, unless the)144 573.6 R F4<ad48>2.999 E F0
F .498(resource is printed, unless the)144 603.6 R F4<ad48>2.999 E F0
.499(option is gi)2.999 F -.15(ve)-.25 G 2.999(n. When).15 F .499
(more than one resource is speci\214ed, the)2.999 F
(limit name and unit are printed before the v)144 585.6 Q 2.5
(limit name and unit are printed before the v)144 615.6 Q 2.5
(alue. Other)-.25 F(options are interpreted as follo)2.5 E(ws:)-.25 E F4
<ad61>144 597.6 Q F0(All current limits are reported)180 597.6 Q F4
<ad62>144 609.6 Q F0(The maximum sock)180 609.6 Q(et b)-.1 E(uf)-.2 E
(fer size)-.25 E F4<ad63>144 621.6 Q F0
(The maximum size of core \214les created)180 621.6 Q F4<ad64>144 633.6
Q F0(The maximum size of a process')180 633.6 Q 2.5(sd)-.55 G(ata se)
-2.5 E(gment)-.15 E F4<ad65>144 645.6 Q F0
(The maximum scheduling priority \("nice"\))180 645.6 Q F4<ad66>144
657.6 Q F0
<ad61>144 627.6 Q F0(All current limits are reported)180 627.6 Q F4
<ad62>144 639.6 Q F0(The maximum sock)180 639.6 Q(et b)-.1 E(uf)-.2 E
(fer size)-.25 E F4<ad63>144 651.6 Q F0
(The maximum size of core \214les created)180 651.6 Q F4<ad64>144 663.6
Q F0(The maximum size of a process')180 663.6 Q 2.5(sd)-.55 G(ata se)
-2.5 E(gment)-.15 E F4<ad65>144 675.6 Q F0
(The maximum scheduling priority \("nice"\))180 675.6 Q F4<ad66>144
687.6 Q F0
(The maximum size of \214les written by the shell and its children)180
657.6 Q F4<ad69>144 669.6 Q F0(The maximum number of pending signals)180
669.6 Q F4<ad6b>144 681.6 Q F0
(The maximum number of kqueues that may be allocated)180 681.6 Q F4
<ad6c>144 693.6 Q F0(The maximum size that may be lock)180 693.6 Q
(ed into memory)-.1 E F4<ad6d>144 705.6 Q F0
(The maximum resident set size \(man)180 705.6 Q 2.5(ys)-.15 G
(ystems do not honor this limit\))-2.5 E F4<ad6e>144 717.6 Q F0 .791(Th\
e maximum number of open \214le descriptors \(most systems do not allo)
180 717.6 R 3.29(wt)-.25 G .79(his v)-3.29 F .79(alue to)-.25 F
(be set\))180 729.6 Q(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(22)
198.725 E 0 Cg EP
687.6 Q F4<ad69>144 699.6 Q F0(The maximum number of pending signals)180
699.6 Q F4<ad6b>144 711.6 Q F0
(The maximum number of kqueues that may be allocated)180 711.6 Q
(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(22)198.725 E 0 Cg EP
%%Page: 23 23
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 87.61
(TINS\(1\) General)-.92 F(Commands Manual)2.5 E -.35(BA)90.11 G(SH_B).35
E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0 SF<ad70>144 84 Q F0
(The pipe size in 512-byte blocks \(this may not be set\))180 84 Q F1
<ad71>144 96 Q F0(The maximum number of bytes in POSIX message queues)
180 96 Q F1<ad72>144 108 Q F0(The maximum real-time scheduling priority)
180 108 Q F1<ad73>144 120 Q F0(The maximum stack size)180 120 Q F1<ad74>
144 132 Q F0(The maximum amount of cpu time in seconds)180 132 Q F1
<ad75>144 144 Q F0(The maximum number of processes a)180 144 Q -.25(va)
-.2 G(ilable to a single user).25 E F1<ad76>144 156 Q F0 .47
(The maximum amount of virtual memory a)180 156 R -.25(va)-.2 G .47
(ilable to the shell and, on some systems, to).25 F(its children)180 168
Q F1<ad78>144 180 Q F0(The maximum number of \214le locks)180 180 Q F1
<ad50>144 192 Q F0(The maximum number of pseudoterminals)180 192 Q F1
<ad54>144 204 Q F0(The maximum number of threads)180 204 Q(If)144 220.8
E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0 SF<ad6c>144 84 Q F0
(The maximum size that may be lock)180 84 Q(ed into memory)-.1 E F1
<ad6d>144 96 Q F0(The maximum resident set size \(man)180 96 Q 2.5(ys)
-.15 G(ystems do not honor this limit\))-2.5 E F1<ad6e>144 108 Q F0 .791
(The maximum number of open \214le descriptors \(most systems do not al\
lo)180 108 R 3.29(wt)-.25 G .79(his v)-3.29 F .79(alue to)-.25 F
(be set\))180 120 Q F1<ad70>144 132 Q F0
(The pipe size in 512-byte blocks \(this may not be set\))180 132 Q F1
<ad71>144 144 Q F0(The maximum number of bytes in POSIX message queues)
180 144 Q F1<ad72>144 156 Q F0
(The maximum real-time scheduling priority)180 156 Q F1<ad73>144 168 Q
F0(The maximum stack size)180 168 Q F1<ad74>144 180 Q F0
(The maximum amount of cpu time in seconds)180 180 Q F1<ad75>144 192 Q
F0(The maximum number of processes a)180 192 Q -.25(va)-.2 G
(ilable to a single user).25 E F1<ad76>144 204 Q F0 .47
(The maximum amount of virtual memory a)180 204 R -.25(va)-.2 G .47
(ilable to the shell and, on some systems, to).25 F(its children)180 216
Q F1<ad78>144 228 Q F0(The maximum number of \214le locks)180 228 Q F1
<ad50>144 240 Q F0(The maximum number of pseudoterminals)180 240 Q F1
<ad54>144 252 Q F0(The maximum number of threads)180 252 Q(If)144 268.8
Q/F2 10/Times-Italic@0 SF(limit)3.058 E F0 .468(is gi)3.648 F -.15(ve)
-.25 G .468(n, and the).15 F F1<ad61>2.968 E F0 .468
(option is not used,)2.968 F F2(limit)2.968 E F0 .468(is the ne)2.968 F
2.968(wv)-.25 G .468(alue of the speci\214ed resource.)-3.218 F(If)5.468
E .044(no option is gi)144 232.8 R -.15(ve)-.25 G .044(n, then).15 F F1
E .044(no option is gi)144 280.8 R -.15(ve)-.25 G .044(n, then).15 F F1
<ad66>2.544 E F0 .045(is assumed.)2.545 F -1.11(Va)5.045 G .045
(lues are in 1024-byte increments, e)1.11 F .045(xcept for)-.15 F F1
<ad74>2.545 E F0 2.545(,w)C .045(hich is)-2.545 F 1.589(in seconds;)144
244.8 R F1<ad70>4.089 E F0 4.089(,w)C 1.589
292.8 R F1<ad70>4.089 E F0 4.089(,w)C 1.589
(hich is in units of 512-byte blocks;)-4.089 F F1<ad50>4.089 E F0(,)A F1
<ad54>4.089 E F0(,)A F1<ad62>4.089 E F0(,)A F1<ad6b>4.089 E F0(,)A F1
<ad6e>4.089 E F0 4.089(,a)C(nd)-4.089 E F1<ad75>4.089 E F0 4.088(,w)C
1.588(hich are)-4.088 F 1.438(unscaled v)144 256.8 R 1.438
1.588(hich are)-4.088 F 1.438(unscaled v)144 304.8 R 1.438
(alues; and, when in Posix mode,)-.25 F F1<ad63>3.939 E F0(and)3.939 E
F1<ad66>3.939 E F0 3.939(,w)C 1.439(hich are in 512-byte increments.)
-3.939 F(The)6.439 E .404(return status is 0 unless an in)144 268.8 R
-3.939 F(The)6.439 E .404(return status is 0 unless an in)144 316.8 R
-.25(va)-.4 G .404(lid option or ar).25 F .404
(gument is supplied, or an error occurs while setting)-.18 F 2.5(an)144
280.8 S .5 -.25(ew l)-2.5 H(imit.).25 E F1(umask)108 297.6 Q F0([)2.5 E
328.8 S .5 -.25(ew l)-2.5 H(imit.).25 E F1(umask)108 345.6 Q F0([)2.5 E
F1<ad70>A F0 2.5(][)C F1<ad53>-2.5 E F0 2.5(][)C F2(mode)-2.5 E F0(])A
.2(The user \214le-creation mask is set to)144 309.6 R F2(mode)2.7 E F0
.2(The user \214le-creation mask is set to)144 357.6 R F2(mode)2.7 E F0
5.2(.I).18 G(f)-5.2 E F2(mode)3.08 E F0(be)2.88 E .2
(gins with a digit, it is interpreted as an octal)-.15 F .066(number; o\
therwise it is interpreted as a symbolic mode mask similar to that acce\
pted by)144 321.6 R F2 -.15(ch)2.566 G(mod).15 E F0(\(1\).).77 E(If)144
333.6 Q F2(mode)3.262 E F0 .382(is omitted, the current v)3.062 F .382
pted by)144 369.6 R F2 -.15(ch)2.566 G(mod).15 E F0(\(1\).).77 E(If)144
381.6 Q F2(mode)3.262 E F0 .382(is omitted, the current v)3.062 F .382
(alue of the mask is printed.)-.25 F(The)5.382 E F1<ad53>2.882 E F0 .382
(option causes the mask to be)2.882 F .547
(printed in symbolic form; the def)144 345.6 R .547
(printed in symbolic form; the def)144 393.6 R .547
(ault output is an octal number)-.1 F 5.547(.I)-.55 G 3.047(ft)-5.547 G
(he)-3.047 E F1<ad70>3.047 E F0 .547(option is supplied, and)3.047 F F2
(mode)144.38 357.6 Q F0 .551
(mode)144.38 405.6 Q F0 .551
(is omitted, the output is in a form that may be reused as input.)3.231
F .552(The return status is 0 if the)5.552 F(mode w)144 369.6 Q
F .552(The return status is 0 if the)5.552 F(mode w)144 417.6 Q
(as successfully changed or if no)-.1 E F2(mode)2.5 E F0(ar)2.5 E
(gument w)-.18 E(as supplied, and f)-.1 E(alse otherwise.)-.1 E F1
(unalias)108 386.4 Q F0<5bad>2.5 E F1(a)A F0 2.5(][)C F2(name)-2.5 E F0
(...])2.5 E(Remo)144 398.4 Q 1.955 -.15(ve e)-.15 H(ach).15 E F2(name)
(unalias)108 434.4 Q F0<5bad>2.5 E F1(a)A F0 2.5(][)C F2(name)-2.5 E F0
(...])2.5 E(Remo)144 446.4 Q 1.955 -.15(ve e)-.15 H(ach).15 E F2(name)
4.155 E F0 1.655(from the list of de\214ned aliases.)4.155 F(If)6.655 E
F1<ad61>4.155 E F0 1.655(is supplied, all alias de\214nitions are)4.155
F(remo)144 410.4 Q -.15(ve)-.15 G 2.5(d. The).15 F(return v)2.5 E
F(remo)144 458.4 Q -.15(ve)-.15 G 2.5(d. The).15 F(return v)2.5 E
(alue is true unless a supplied)-.25 E F2(name)2.86 E F0
(is not a de\214ned alias.)2.68 E F1(unset)108 427.2 Q F0<5bad>2.5 E F1
(is not a de\214ned alias.)2.68 E F1(unset)108 475.2 Q F0<5bad>2.5 E F1
(fv)A F0 2.5(][)C<ad>-2.5 E F1(n)A F0 2.5(][)C F2(name)-2.5 E F0(...])
2.5 E -.15(Fo)144 439.2 S 3.827(re).15 G(ach)-3.827 E F2(name)3.827 E F0
2.5 E -.15(Fo)144 487.2 S 3.827(re).15 G(ach)-3.827 E F2(name)3.827 E F0
3.827(,r).18 G(emo)-3.827 E 1.627 -.15(ve t)-.15 H 1.327
(he corresponding v).15 F 1.327(ariable or function.)-.25 F 1.327
(If the)6.327 F F1<ad76>3.828 E F0 1.328(option is gi)3.828 F -.15(ve)
-.25 G 1.328(n, each).15 F F2(name)144.36 451.2 Q F0 1.551
-.25 G 1.328(n, each).15 F F2(name)144.36 499.2 Q F0 1.551
(refers to a shell v)4.231 F 1.551(ariable, and that v)-.25 F 1.551
(ariable is remo)-.25 F -.15(ve)-.15 G 4.05(d. Read-only).15 F -.25(va)
4.05 G 1.55(riables may not be).25 F 4.641(unset. If)144 463.2 R F1
4.05 G 1.55(riables may not be).25 F 4.641(unset. If)144 511.2 R F1
<ad66>4.641 E F0 2.141(is speci\214ed, each)4.641 F F2(name)5.001 E F0
2.141(refers to a shell function, and the function de\214nition is)4.821
F(remo)144 475.2 Q -.15(ve)-.15 G 2.538(d. If).15 F(the)2.537 E F1<ad6e>
F(remo)144 523.2 Q -.15(ve)-.15 G 2.538(d. If).15 F(the)2.537 E F1<ad6e>
2.537 E F0 .037(option is supplied, and)2.537 F F2(name)2.537 E F0 .037
(is a v)2.537 F .037(ariable with the)-.25 F F2(namer)2.537 E(ef)-.37 E
F0(attrib)2.537 E(ute,)-.2 E F2(name)2.537 E F0(will)2.537 E .492
(be unset rather than the v)144 487.2 R .492(ariable it references.)-.25
(be unset rather than the v)144 535.2 R .492(ariable it references.)-.25
F F1<ad6e>5.492 E F0 .492(has no ef)2.992 F .492(fect if the)-.25 F F1
<ad66>2.992 E F0 .492(option is supplied.)2.992 F .493(If no)5.493 F
.221(options are supplied, each)144 499.2 R F2(name)2.721 E F0 .221
.221(options are supplied, each)144 547.2 R F2(name)2.721 E F0 .221
(refers to a v)2.721 F .22(ariable; if there is no v)-.25 F .22
(ariable by that name, an)-.25 F 2.72(yf)-.15 G(unc-)-2.72 E 1.188
(tion with that name is unset.)144 511.2 R 1.189(Each unset v)6.189 F
(tion with that name is unset.)144 559.2 R 1.189(Each unset v)6.189 F
1.189(ariable or function is remo)-.25 F -.15(ve)-.15 G 3.689(df).15 G
1.189(rom the en)-3.689 F(vironment)-.4 E 3.206
(passed to subsequent commands.)144 523.2 R 3.206(If an)8.206 F 5.706
(passed to subsequent commands.)144 571.2 R 3.206(If an)8.206 F 5.706
(yo)-.15 G(f)-5.706 E/F3 9/Times-Bold@0 SF(COMP_W)5.706 E(ORDBREAKS)-.09
E/F4 9/Times-Roman@0 SF(,)A F3(RANDOM)5.455 E F4(,)A F3(SECONDS)5.455 E
F4(,)A F3(LINENO)144 535.2 Q F4(,)A F3(HISTCMD)4.347 E F4(,)A F3(FUNCN)
F4(,)A F3(LINENO)144 583.2 Q F4(,)A F3(HISTCMD)4.347 E F4(,)A F3(FUNCN)
4.347 E(AME)-.18 E F4(,)A F3(GR)4.347 E(OUPS)-.27 E F4(,)A F0(or)4.348 E
F3(DIRST)4.598 E -.495(AC)-.81 G(K).495 E F0 2.098(are unset, the)4.348
F 4.598(yl)-.15 G 2.098(ose their special)-4.598 F(properties, e)144
547.2 Q -.15(ve)-.25 G 2.5(ni).15 G 2.5(ft)-2.5 G(he)-2.5 E 2.5(ya)-.15
595.2 Q -.15(ve)-.25 G 2.5(ni).15 G 2.5(ft)-2.5 G(he)-2.5 E 2.5(ya)-.15
G(re subsequently reset.)-2.5 E(The e)5 E(xit status is true unless a)
-.15 E F2(name)2.86 E F0(is readonly)2.68 E(.)-.65 E F1(wait)108 564 Q
-.15 E F2(name)2.86 E F0(is readonly)2.68 E(.)-.65 E F1(wait)108 612 Q
F0([)2.5 E F1<ad6e>A F0 2.5(][)C F2 2.5(n.)-2.5 G(..)-2.5 E F0(])A -.8
(Wa)144 576 S .027(it for each speci\214ed child process and return its\
(Wa)144 624 S .027(it for each speci\214ed child process and return its\
termination status.).8 F(Each)5.026 E F2(n)2.886 E F0 .026
(may be a process ID)2.766 F .256
(or a job speci\214cation; if a job spec is gi)144 588 R -.15(ve)-.25 G
(or a job speci\214cation; if a job spec is gi)144 636 R -.15(ve)-.25 G
.256(n, all processes in that job').15 F 2.756(sp)-.55 G .256
(ipeline are w)-2.756 F .256(aited for)-.1 F 5.256(.I)-.55 G(f)-5.256 E
F2(n)3.116 E F0 .318(is not gi)144 600 R -.15(ve)-.25 G .318
F2(n)3.116 E F0 .318(is not gi)144 648 R -.15(ve)-.25 G .318
(n, all currently acti).15 F .618 -.15(ve c)-.25 H .318
(hild processes are w).15 F .318(aited for)-.1 F 2.818(,a)-.4 G .318
(nd the return status is zero.)-2.818 F .317(If the)5.317 F F1<ad6e>144
612 Q F0 .361(option is supplied,)2.861 F F1(wait)2.861 E F0 -.1(wa)
660 Q F0 .361(option is supplied,)2.861 F F1(wait)2.861 E F0 -.1(wa)
2.861 G .361(its for an).1 F 2.862(yj)-.15 G .362
(ob to terminate and returns its e)-2.862 F .362(xit status.)-.15 F(If)
5.362 E F2(n)3.222 E F0(speci\214es)3.102 E 2.596(an)144 624 S(on-e)
5.362 E F2(n)3.222 E F0(speci\214es)3.102 E 2.596(an)144 672 S(on-e)
-2.596 E .096(xistent process or job, the return status is 127.)-.15 F
.095(Otherwise, the return status is the e)5.095 F .095(xit status)-.15
F(of the last process or job w)144 636 Q(aited for)-.1 E(.)-.55 E/F5
10.95/Times-Bold@0 SF(SEE ALSO)72 652.8 Q F0(bash\(1\), sh\(1\))108
664.8 Q(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(23)198.725 E 0 Cg EP
F(of the last process or job w)144 684 Q(aited for)-.1 E(.)-.55 E/F5
10.95/Times-Bold@0 SF(SEE ALSO)72 700.8 Q F0(bash\(1\), sh\(1\))108
712.8 Q(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(23)198.725 E 0 Cg EP
%%Trailer
end
%%EOF
doc/rbash.ps
+1 -1
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.22.3
%%CreationDate: Mon Feb 8 10:16:54 2016
%%CreationDate: Mon Jun 20 15:38:03 2016
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%DocumentSuppliedResources: procset grops 1.22 3
doc/version.texi
+3 -3
View File
@@ -2,10 +2,10 @@
Copyright (C) 1988-2016 Free Software Foundation, Inc.
@end ignore
@set LASTCHANGE Mon Feb 8 10:16:20 EST 2016
@set LASTCHANGE Sun May 29 13:48:02 EDT 2016
@set EDITION 4.4
@set VERSION 4.4
@set UPDATED 8 February 2016
@set UPDATED-MONTH February 2016
@set UPDATED 29 May 2016
@set UPDATED-MONTH May 2016