commit bash-snap-20170626 snapshot

This commit is contained in:
Chet Ramey
2017-06-26 09:29:20 -04:00
parent a930c746a8
commit 68d220cb05
20 changed files with 7370 additions and 7239 deletions
+6
View File
@@ -14193,3 +14193,9 @@ expr.c
error and either longjmp back to the expression top level or return
0 immediately. Fixes bug reported by Eduardo Bustamante
<dualbus@gmail.com>
6/23
----
doc/{bash.1,bashref.texi}
- add text noting that $* and ${array[*]} (unquoted) can also expand
to multiple words
+1611 -1609
View File
File diff suppressed because it is too large Load Diff
+7 -6
View File
@@ -5,12 +5,12 @@
.\" Case Western Reserve University
.\" chet.ramey@case.edu
.\"
.\" Last Change: Thu May 25 15:58:43 EDT 2017
.\" Last Change: Fri Jun 23 12:42:34 EDT 2017
.\"
.\" bash_builtins, strip all but Built-Ins section
.if \n(zZ=1 .ig zZ
.if \n(zY=1 .ig zY
.TH BASH 1 "2017 May 25" "GNU Bash 4.4"
.TH BASH 1 "2017 June 23" "GNU Bash 4.4"
.\"
.\" There's some problem with having a `@'
.\" in a tagged paragraph with the BSD man macros.
@@ -2744,10 +2744,11 @@ original word are removed unless they have been quoted themselves
(\fIquote removal\fP).
.PP
Only brace expansion, word splitting, and pathname expansion
can change the number of words of the expansion; other expansions
can increase the number of words of the expansion; other expansions
expand a single word to a single word.
The only exceptions to this are the expansions of
"\fB$@\fP" and "\fB${\fP\fIname\fP\fB[@]}\fP"
"\fB$@\fP" and "\fB${\fP\fIname\fP\fB[@]}\fP",
and, in most cases, \fB$*\fP and \fB${\fP\fIname\fP\fB[*]}\fP
as explained above (see
.SM
.BR PARAMETERS ).
@@ -9679,8 +9680,8 @@ above). The shell always
postpones exiting if any jobs are stopped.
.TP 8
.B checkwinsize
If set, \fBbash\fP checks the window size after each command
and, if necessary, updates the values of
If set, \fBbash\fP checks the window size after each external (non-builtin)
command and, if necessary, updates the values of
.SM
.B LINES
and
+27 -11
View File
@@ -3,7 +3,7 @@
</HEAD>
<BODY><TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2017 March 22<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2017 June 23<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<BR><A HREF="#index">Index</A>
@@ -3482,10 +3482,11 @@ original word are removed unless they have been quoted themselves
<P>
Only brace expansion, word splitting, and pathname expansion
can change the number of words of the expansion; other expansions
can increase the number of words of the expansion; other expansions
expand a single word to a single word.
The only exceptions to this are the expansions of
&quot;<B>$@</B>&quot; and &quot;<B>${</B><I>name</I><B>[@]}</B>&quot;
&quot;<B>$@</B>&quot; and &quot;<B>${</B><I>name</I><B>[@]}</B>&quot;,
and, in most cases, <B>$*</B> and <B>${</B><I>name</I><B>[*]}</B>
as explained above (see
<FONT SIZE=-1><B>PARAMETERS</B>).
@@ -8728,7 +8729,7 @@ If <B>HISTFILESIZE</B> is unset, or set to null, a non-numeric value,
or a numeric value less than zero, the history file is not truncated.
When the history file is read,
lines beginning with the history comment character followed immediately
by a digit are interpreted as timestamps for the preceding history line.
by a digit are interpreted as timestamps for the following history line.
These timestamps are optionally displayed depending on the value of the
<FONT SIZE=-1><B>HISTTIMEFORMAT</B>
@@ -10535,7 +10536,7 @@ echoed and executed.
<P>
In the second form, <I>command</I> is re-executed after each instance
of <I>pat</I> is replaced by <I>rep</I>.
<I>Command</I> is intepreted the same as <I>first</I> above.
<I>Command</I> is interpreted the same as <I>first</I> above.
A useful alias to use with this is
<TT>r='fc -s'</TT>,
@@ -11125,6 +11126,8 @@ Options, if supplied, have the following meanings:
<DD>
The first character of <I>delim</I> is used to terminate each input line,
rather than newline.
If <I>delim</I> is the empty string, <B>mapfile</B> will terminate a line
when it reads a NUL character.
<DT><B>-n</B>
<DD>
@@ -11440,6 +11443,8 @@ Other <I>name</I> arguments are ignored.
<DD>
The first character of <I>delim</I> is used to terminate the input line,
rather than newline.
If <I>delim</I> is the empty string, <B>read</B> will terminate a line
when it reads a NUL character.
<DT><B>-e</B>
<DD>
@@ -11453,7 +11458,7 @@ is coming from a terminal,
</FONT>
above) is used to obtain the line.
Readline uses the current (or default, if line editing was not previously
active) editing settings.
active) editing settings, but uses Readline's default filename completion.
<DT><B>-i </B><I>text</I>
<DD>
@@ -12273,8 +12278,8 @@ postpones exiting if any jobs are stopped.
<DT><B>checkwinsize</B>
<DD>
If set, <B>bash</B> checks the window size after each command
and, if necessary, updates the values of
If set, <B>bash</B> checks the window size after each external (non-builtin)
command and, if necessary, updates the values of
<FONT SIZE=-1><B>LINES</B>
</FONT>
@@ -12291,6 +12296,11 @@ If set,
attempts to save all lines of a multiple-line
command in the same history entry. This allows
easy re-editing of multi-line commands.
This option is enabled by default, but only has an effect if command
history is enabled, as described above under
<FONT SIZE=-1><B>HISTORY</B>.
</FONT>
<DT><B>compat31</B>
<DD>
@@ -12641,6 +12651,12 @@ If set, and the
option is enabled, multi-line commands are saved to the history with
embedded newlines rather than using semicolon separators where possible.
<DT><B>localvar_inherit</B>
<DD>
If set, local variables inherit the value and attributes of a variable of
the same name that exists at a previous scope before any new value is
assigned. The nameref attribute is not inherited.
<DT><B>login_shell</B>
<DD>
@@ -13437,7 +13453,7 @@ If the <B>-n</B> option is supplied, <B>wait</B> waits for any job to
terminate and returns its exit status.
If the <B>-f</B> option is supplied, and job control is enabled,
<B>wait</B> forces <I>id</I> to terminate before returning its status,
intead of returning when it changes status.
instead of returning when it changes status.
If
<I>id</I>
@@ -13732,7 +13748,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%>2017 March 22<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>GNU Bash 4.4<TH ALIGN=CENTER width=33%>2017 June 23<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<HR>
@@ -13838,6 +13854,6 @@ There may be only one active coprocess at a time.
</DL>
<HR>
This document was created by man2html from bash.1.<BR>
Time: 03 April 2017 16:34:05 EDT
Time: 26 June 2017 09:16:53 EDT
</BODY>
</HTML>
+167 -156
View File
@@ -2,9 +2,9 @@ This is bash.info, produced by makeinfo version 6.3 from
bashref.texi.
This text is a brief description of the features that are present in the
Bash shell (version 4.4, 22 March 2017).
Bash shell (version 4.4, 23 June 2017).
This is Edition 4.4, last updated 22 March 2017, of 'The GNU Bash
This is Edition 4.4, last updated 23 June 2017, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Copyright (C) 1988-2017 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, 22 March 2017). The Bash home page is
Bash shell (version 4.4, 23 June 2017). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 4.4, last updated 22 March 2017, of 'The GNU Bash
This is Edition 4.4, last updated 23 June 2017, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Bash contains features that appear in other popular shells, and some
@@ -1127,7 +1127,7 @@ first.
Finally, Parallel can be used to run a sequence of shell commands in
parallel, similar to 'cat file | bash'. It is not uncommon to take a
list of filenames, create a series of shell commands to operate on them,
and feed that list of commnds to a shell. Parallel can speed this up.
and feed that list of commands to a shell. Parallel can speed this up.
Assuming that 'file' contains a list of shell commands, one per line,
parallel -j 10 < file
@@ -1503,10 +1503,10 @@ original word are removed unless they have been quoted themselves (QUOTE
REMOVAL).
Only brace expansion, word splitting, and filename expansion can
change the number of words of the expansion; other expansions expand a
increase the number of words of the expansion; other expansions expand a
single word to a single word. The only exceptions to this are the
expansions of '"$@"' (*note Special Parameters::) and '"${NAME[@]}"'
(*note Arrays::).
expansions of '"$@"' and '$*' (*note Special Parameters::), and
'"${NAME[@]}"' and '${NAME[*]}' (*note Arrays::).
After all expansions, 'quote removal' (*note Quote Removal::) is
performed.
@@ -3665,7 +3665,8 @@ standard.
'-d'
The first character of DELIM is used to terminate each input
line, rather than newline.
line, rather than newline. If DELIM is the empty string,
'mapfile' will terminate a line when it reads a NUL character.
'-n'
Copy at most COUNT lines. If COUNT is 0, all lines are
copied.
@@ -3777,12 +3778,14 @@ standard.
'-d DELIM'
The first character of DELIM is used to terminate the input
line, rather than newline.
line, rather than newline. If DELIM is the empty string,
'read' will terminate a line when it reads a NUL character.
'-e'
Readline (*note Command Line Editing::) is used to obtain the
line. Readline uses the current (or default, if line editing
was not previously active) editing settings.
was not previously active) editing settings, but uses
Readline's default filename completion.
'-i TEXT'
If Readline is being used to read the line, TEXT is placed
@@ -4366,13 +4369,16 @@ This builtin allows you to change additional shell optional behavior.
are stopped.
'checkwinsize'
If set, Bash checks the window size after each command and, if
necessary, updates the values of 'LINES' and 'COLUMNS'.
If set, Bash checks the window size after each external
(non-builtin) command and, if necessary, updates the values of
'LINES' and 'COLUMNS'.
'cmdhist'
If set, Bash attempts to save all lines of a multiple-line
command in the same history entry. This allows easy
re-editing of multi-line commands.
re-editing of multi-line commands. This option is enabled by
default, but only has an effect if command history is enabled
(*note Bash History Facilities::).
'compat31'
If set, Bash changes its behavior to that of version 3.1 with
@@ -4579,6 +4585,12 @@ This builtin allows you to change additional shell optional behavior.
commands are saved to the history with embedded newlines
rather than using semicolon separators where possible.
'localvar_inherit'
If set, local variables inherit the value and attributes of a
variable of the same name that exists at a previous scope
before any new value is assigned. The NAMEREF attribute is
not inherited.
'login_shell'
The shell sets this option if it is started as a login shell
(*note Invoking Bash::). The value may not be changed.
@@ -8893,10 +8905,9 @@ function and bind it to a particular command using 'complete -F'.
The following function provides completions for the 'cd' builtin. It
is a reasonably good example of what shell functions must do when used
for completion. This function uses the word passsed as '$2' to
determine the directory name to complete. You can also use the
'COMP_WORDS' array variable; the current word is indexed by the
'COMP_CWORD' variable.
for completion. This function uses the word passed as '$2' to determine
the directory name to complete. You can also use the 'COMP_WORDS' array
variable; the current word is indexed by the 'COMP_CWORD' variable.
The function relies on the 'complete' and 'compgen' builtins to do
much of the work, adding only the things that the Bash 'cd' does beyond
@@ -10826,13 +10837,13 @@ D.1 Index of Shell Builtin Commands
* mapfile: Bash Builtins. (line 369)
* popd: Directory Stack Builtins.
(line 35)
* printf: Bash Builtins. (line 414)
* printf: Bash Builtins. (line 415)
* pushd: Directory Stack Builtins.
(line 53)
* pwd: Bourne Shell Builtins.
(line 205)
* read: Bash Builtins. (line 458)
* readarray: Bash Builtins. (line 550)
* read: Bash Builtins. (line 459)
* readarray: Bash Builtins. (line 553)
* readonly: Bourne Shell Builtins.
(line 215)
* return: Bourne Shell Builtins.
@@ -10841,7 +10852,7 @@ D.1 Index of Shell Builtin Commands
* shift: Bourne Shell Builtins.
(line 255)
* shopt: The Shopt Builtin. (line 9)
* source: Bash Builtins. (line 559)
* source: Bash Builtins. (line 562)
* suspend: Job Control Builtins.
(line 104)
* test: Bourne Shell Builtins.
@@ -10850,12 +10861,12 @@ D.1 Index of Shell Builtin Commands
(line 343)
* trap: Bourne Shell Builtins.
(line 349)
* type: Bash Builtins. (line 564)
* typeset: Bash Builtins. (line 596)
* ulimit: Bash Builtins. (line 602)
* type: Bash Builtins. (line 567)
* typeset: Bash Builtins. (line 599)
* ulimit: Bash Builtins. (line 605)
* umask: Bourne Shell Builtins.
(line 398)
* unalias: Bash Builtins. (line 701)
* unalias: Bash Builtins. (line 704)
* unset: Bourne Shell Builtins.
(line 416)
* wait: Job Control Builtins.
@@ -11412,7 +11423,7 @@ D.5 Concept Index
* history list: Bash History Facilities.
(line 6)
* History, how to use: A Programmable Completion Example.
(line 114)
(line 113)
* identifier: Definitions. (line 51)
* initialization file, readline: Readline Init File. (line 6)
* installation: Basic Installation. (line 6)
@@ -11490,134 +11501,134 @@ D.5 Concept Index

Tag Table:
Node: Top891
Node: Introduction2805
Node: What is Bash?3021
Node: What is a shell?4135
Node: Definitions6673
Node: Basic Shell Features9624
Node: Shell Syntax10843
Node: Shell Operation11869
Node: Quoting13162
Node: Escape Character14462
Node: Single Quotes14947
Node: Double Quotes15295
Node: ANSI-C Quoting16573
Node: Locale Translation17832
Node: Comments18728
Node: Shell Commands19346
Node: Simple Commands20218
Node: Pipelines20849
Node: Lists23781
Node: Compound Commands25520
Node: Looping Constructs26532
Node: Conditional Constructs29027
Node: Command Grouping40082
Node: Coprocesses41561
Node: GNU Parallel43393
Node: Shell Functions47366
Node: Shell Parameters54565
Node: Positional Parameters58978
Node: Special Parameters59878
Node: Shell Expansions63215
Node: Brace Expansion65309
Node: Tilde Expansion68143
Node: Shell Parameter Expansion70491
Node: Command Substitution84623
Node: Arithmetic Expansion85978
Node: Process Substitution86910
Node: Word Splitting88030
Node: Filename Expansion89974
Node: Pattern Matching92348
Node: Quote Removal96334
Node: Redirections96629
Node: Executing Commands106187
Node: Simple Command Expansion106857
Node: Command Search and Execution108787
Node: Command Execution Environment111123
Node: Environment114107
Node: Exit Status115766
Node: Signals117436
Node: Shell Scripts119403
Node: Shell Builtin Commands121918
Node: Bourne Shell Builtins123952
Node: Bash Builtins144552
Node: Modifying Shell Behavior173197
Node: The Set Builtin173542
Node: The Shopt Builtin183955
Node: Special Builtins199853
Node: Shell Variables200832
Node: Bourne Shell Variables201269
Node: Bash Variables203373
Node: Bash Features233166
Node: Invoking Bash234065
Node: Bash Startup Files240014
Node: Interactive Shells245117
Node: What is an Interactive Shell?245527
Node: Is this Shell Interactive?246176
Node: Interactive Shell Behavior246991
Node: Bash Conditional Expressions250479
Node: Shell Arithmetic254845
Node: Aliases257662
Node: Arrays260210
Node: The Directory Stack265372
Node: Directory Stack Builtins266156
Node: Controlling the Prompt269124
Node: The Restricted Shell271886
Node: Bash POSIX Mode273711
Node: Job Control284062
Node: Job Control Basics284522
Node: Job Control Builtins289490
Node: Job Control Variables294217
Node: Command Line Editing295373
Node: Introduction and Notation297044
Node: Readline Interaction298667
Node: Readline Bare Essentials299858
Node: Readline Movement Commands301641
Node: Readline Killing Commands302601
Node: Readline Arguments304519
Node: Searching305563
Node: Readline Init File307749
Node: Readline Init File Syntax308896
Node: Conditional Init Constructs329083
Node: Sample Init File331608
Node: Bindable Readline Commands334725
Node: Commands For Moving335929
Node: Commands For History337778
Node: Commands For Text342073
Node: Commands For Killing345462
Node: Numeric Arguments347943
Node: Commands For Completion349082
Node: Keyboard Macros353273
Node: Miscellaneous Commands353960
Node: Readline vi Mode359836
Node: Programmable Completion360743
Node: Programmable Completion Builtins368204
Node: A Programmable Completion Example378090
Node: Using History Interactively383342
Node: Bash History Facilities384026
Node: Bash History Builtins387027
Node: History Interaction391319
Node: Event Designators394283
Node: Word Designators395502
Node: Modifiers397139
Node: Installing Bash398541
Node: Basic Installation399678
Node: Compilers and Options402369
Node: Compiling For Multiple Architectures403110
Node: Installation Names404773
Node: Specifying the System Type405591
Node: Sharing Defaults406307
Node: Operation Controls406980
Node: Optional Features407938
Node: Reporting Bugs418464
Node: Major Differences From The Bourne Shell419658
Node: GNU Free Documentation License436510
Node: Indexes461687
Node: Builtin Index462141
Node: Reserved Word Index468968
Node: Variable Index471416
Node: Function Index487094
Node: Concept Index500397
Node: Top889
Node: Introduction2801
Node: What is Bash?3017
Node: What is a shell?4131
Node: Definitions6669
Node: Basic Shell Features9620
Node: Shell Syntax10839
Node: Shell Operation11865
Node: Quoting13158
Node: Escape Character14458
Node: Single Quotes14943
Node: Double Quotes15291
Node: ANSI-C Quoting16569
Node: Locale Translation17828
Node: Comments18724
Node: Shell Commands19342
Node: Simple Commands20214
Node: Pipelines20845
Node: Lists23777
Node: Compound Commands25516
Node: Looping Constructs26528
Node: Conditional Constructs29023
Node: Command Grouping40078
Node: Coprocesses41557
Node: GNU Parallel43389
Node: Shell Functions47363
Node: Shell Parameters54562
Node: Positional Parameters58975
Node: Special Parameters59875
Node: Shell Expansions63212
Node: Brace Expansion65335
Node: Tilde Expansion68169
Node: Shell Parameter Expansion70517
Node: Command Substitution84649
Node: Arithmetic Expansion86004
Node: Process Substitution86936
Node: Word Splitting88056
Node: Filename Expansion90000
Node: Pattern Matching92374
Node: Quote Removal96360
Node: Redirections96655
Node: Executing Commands106213
Node: Simple Command Expansion106883
Node: Command Search and Execution108813
Node: Command Execution Environment111149
Node: Environment114133
Node: Exit Status115792
Node: Signals117462
Node: Shell Scripts119429
Node: Shell Builtin Commands121944
Node: Bourne Shell Builtins123978
Node: Bash Builtins144578
Node: Modifying Shell Behavior173487
Node: The Set Builtin173832
Node: The Shopt Builtin184245
Node: Special Builtins200580
Node: Shell Variables201559
Node: Bourne Shell Variables201996
Node: Bash Variables204100
Node: Bash Features233893
Node: Invoking Bash234792
Node: Bash Startup Files240741
Node: Interactive Shells245844
Node: What is an Interactive Shell?246254
Node: Is this Shell Interactive?246903
Node: Interactive Shell Behavior247718
Node: Bash Conditional Expressions251206
Node: Shell Arithmetic255572
Node: Aliases258389
Node: Arrays260937
Node: The Directory Stack266099
Node: Directory Stack Builtins266883
Node: Controlling the Prompt269851
Node: The Restricted Shell272613
Node: Bash POSIX Mode274438
Node: Job Control284789
Node: Job Control Basics285249
Node: Job Control Builtins290217
Node: Job Control Variables294944
Node: Command Line Editing296100
Node: Introduction and Notation297771
Node: Readline Interaction299394
Node: Readline Bare Essentials300585
Node: Readline Movement Commands302368
Node: Readline Killing Commands303328
Node: Readline Arguments305246
Node: Searching306290
Node: Readline Init File308476
Node: Readline Init File Syntax309623
Node: Conditional Init Constructs329810
Node: Sample Init File332335
Node: Bindable Readline Commands335452
Node: Commands For Moving336656
Node: Commands For History338505
Node: Commands For Text342800
Node: Commands For Killing346189
Node: Numeric Arguments348670
Node: Commands For Completion349809
Node: Keyboard Macros354000
Node: Miscellaneous Commands354687
Node: Readline vi Mode360563
Node: Programmable Completion361470
Node: Programmable Completion Builtins368931
Node: A Programmable Completion Example378817
Node: Using History Interactively384068
Node: Bash History Facilities384752
Node: Bash History Builtins387753
Node: History Interaction392045
Node: Event Designators395009
Node: Word Designators396228
Node: Modifiers397865
Node: Installing Bash399267
Node: Basic Installation400404
Node: Compilers and Options403095
Node: Compiling For Multiple Architectures403836
Node: Installation Names405499
Node: Specifying the System Type406317
Node: Sharing Defaults407033
Node: Operation Controls407706
Node: Optional Features408664
Node: Reporting Bugs419190
Node: Major Differences From The Bourne Shell420384
Node: GNU Free Documentation License437236
Node: Indexes462413
Node: Builtin Index462867
Node: Reserved Word Index469694
Node: Variable Index472142
Node: Function Index487820
Node: Concept Index501123

End Tag Table
BIN
View File
Binary file not shown.
+3752 -3732
View File
File diff suppressed because it is too large Load Diff
+1 -1
View File
@@ -34,7 +34,7 @@
\entry{mapfile}{56}{\code {mapfile}}
\entry{printf}{56}{\code {printf}}
\entry{read}{57}{\code {read}}
\entry{readarray}{58}{\code {readarray}}
\entry{readarray}{59}{\code {readarray}}
\entry{source}{59}{\code {source}}
\entry{type}{59}{\code {type}}
\entry{typeset}{59}{\code {typeset}}
+1 -1
View File
@@ -56,7 +56,7 @@
\entry {\code {pwd}}{46}
\initial {R}
\entry {\code {read}}{57}
\entry {\code {readarray}}{58}
\entry {\code {readarray}}{59}
\entry {\code {readonly}}{46}
\entry {\code {return}}{47}
\initial {S}
BIN
View File
Binary file not shown.
+24 -11
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, 22 March 2017).
the Bash shell (version 4.4, 23 June 2017).
This is Edition 4.4, last updated 22 March 2017,
This is Edition 4.4, last updated 23 June 2017,
of The GNU Bash Reference Manual,
for Bash, Version 4.4.
@@ -284,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, 22 March 2017).
the Bash shell (version 4.4, 23 June 2017).
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 22 March 2017,
<p>This is Edition 4.4, last updated 23 June 2017,
of <cite>The GNU Bash Reference Manual</cite>,
for <code>Bash</code>, Version 4.4.
</p>
@@ -1755,7 +1755,7 @@ Adding the <samp>-k</samp> option
<p>Finally, Parallel can be used to run a sequence of shell commands in parallel,
similar to &lsquo;<samp>cat file | bash</samp>&rsquo;.
It is not uncommon to take a list of filenames, create a series of shell
commands to operate on them, and feed that list of commnds to a shell.
commands to operate on them, and feed that list of commands to a shell.
Parallel can speed this up. Assuming that <samp>file</samp> contains a list of
shell commands, one per line,
</p>
@@ -2276,10 +2276,11 @@ original word are removed unless they have been quoted themselves
(<var>quote removal</var>).
</p>
<p>Only brace expansion, word splitting, and filename expansion
can change the number of words of the expansion; other expansions
can increase the number of words of the expansion; other expansions
expand a single word to a single word.
The only exceptions to this are the expansions of
<code>&quot;$@&quot;</code> (see <a href="#Special-Parameters">Special Parameters</a>) and <code>&quot;${<var>name</var>[@]}&quot;</code>
<code>&quot;$@&quot;</code> and <code>$*</code> (see <a href="#Special-Parameters">Special Parameters</a>), and
<code>&quot;${<var>name</var>[@]}&quot;</code> and <code>${<var>name</var>[*]}</code>
(see <a href="#Arrays">Arrays</a>).
</p>
<p>After all expansions, <code>quote removal</code> (see <a href="#Quote-Removal">Quote Removal</a>)
@@ -5084,6 +5085,8 @@ Options, if supplied, have the following meanings:
<dt><code>-d</code></dt>
<dd><p>The first character of <var>delim</var> is used to terminate each input line,
rather than newline.
If <var>delim</var> is the empty string, <code>mapfile</code> will terminate a line
when it reads a NUL character.
</p></dd>
<dt><code>-n</code></dt>
<dd><p>Copy at most <var>count</var> lines. If <var>count</var> is 0, all lines are copied.
@@ -5222,12 +5225,14 @@ Other <var>name</var> arguments are ignored.
<dt><code>-d <var>delim</var></code></dt>
<dd><p>The first character of <var>delim</var> is used to terminate the input line,
rather than newline.
If <var>delim</var> is the empty string, <code>read</code> will terminate a line
when it reads a NUL character.
</p>
</dd>
<dt><code>-e</code></dt>
<dd><p>Readline (see <a href="#Command-Line-Editing">Command Line Editing</a>) is used to obtain the line.
Readline uses the current (or default, if line editing was not previously
active) editing settings.
active) editing settings, but uses Readline&rsquo;s default filename completion.
</p>
</dd>
<dt><code>-i <var>text</var></code></dt>
@@ -5976,8 +5981,8 @@ The shell always postpones exiting if any jobs are stopped.
</p>
</dd>
<dt><code>checkwinsize</code></dt>
<dd><p>If set, Bash checks the window size after each command
and, if necessary, updates the values of
<dd><p>If set, Bash checks the window size after each external (non-builtin)
command and, if necessary, updates the values of
<code>LINES</code> and <code>COLUMNS</code>.
</p>
</dd>
@@ -5986,6 +5991,8 @@ The shell always postpones exiting if any jobs are stopped.
attempts to save all lines of a multiple-line
command in the same history entry. This allows
easy re-editing of multi-line commands.
This option is enabled by default, but only has an effect if command
history is enabled (see <a href="#Bash-History-Facilities">Bash History Facilities</a>).
</p>
</dd>
<dt><code>compat31</code></dt>
@@ -6230,6 +6237,12 @@ option is enabled, multi-line commands are saved to the history with
embedded newlines rather than using semicolon separators where possible.
</p>
</dd>
<dt><code>localvar_inherit</code></dt>
<dd><p>If set, local variables inherit the value and attributes of a variable of
the same name that exists at a previous scope before any new value is
assigned. The <var>nameref</var> attribute is not inherited.
</p>
</dd>
<dt><code>login_shell</code></dt>
<dd><p>The shell sets this option if it is started as a login shell
(see <a href="#Invoking-Bash">Invoking Bash</a>).
@@ -12173,7 +12186,7 @@ a shell function and bind it to a particular command using <code>complete -F</co
</p>
<p>The following function provides completions for the <code>cd</code> builtin.
It is a reasonably good example of what shell functions must do when
used for completion. This function uses the word passsed as <code>$2</code>
used for completion. This function uses the word passed as <code>$2</code>
to determine the directory name to complete. You can also use the
<code>COMP_WORDS</code> array variable; the current word is indexed by the
<code>COMP_CWORD</code> variable.
+167 -156
View File
@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 6.3 from
bashref.texi.
This text is a brief description of the features that are present in the
Bash shell (version 4.4, 22 March 2017).
Bash shell (version 4.4, 23 June 2017).
This is Edition 4.4, last updated 22 March 2017, of 'The GNU Bash
This is Edition 4.4, last updated 23 June 2017, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Copyright (C) 1988-2017 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, 22 March 2017). The Bash home page is
Bash shell (version 4.4, 23 June 2017). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 4.4, last updated 22 March 2017, of 'The GNU Bash
This is Edition 4.4, last updated 23 June 2017, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Bash contains features that appear in other popular shells, and some
@@ -1127,7 +1127,7 @@ first.
Finally, Parallel can be used to run a sequence of shell commands in
parallel, similar to 'cat file | bash'. It is not uncommon to take a
list of filenames, create a series of shell commands to operate on them,
and feed that list of commnds to a shell. Parallel can speed this up.
and feed that list of commands to a shell. Parallel can speed this up.
Assuming that 'file' contains a list of shell commands, one per line,
parallel -j 10 < file
@@ -1503,10 +1503,10 @@ original word are removed unless they have been quoted themselves (QUOTE
REMOVAL).
Only brace expansion, word splitting, and filename expansion can
change the number of words of the expansion; other expansions expand a
increase the number of words of the expansion; other expansions expand a
single word to a single word. The only exceptions to this are the
expansions of '"$@"' (*note Special Parameters::) and '"${NAME[@]}"'
(*note Arrays::).
expansions of '"$@"' and '$*' (*note Special Parameters::), and
'"${NAME[@]}"' and '${NAME[*]}' (*note Arrays::).
After all expansions, 'quote removal' (*note Quote Removal::) is
performed.
@@ -3665,7 +3665,8 @@ standard.
'-d'
The first character of DELIM is used to terminate each input
line, rather than newline.
line, rather than newline. If DELIM is the empty string,
'mapfile' will terminate a line when it reads a NUL character.
'-n'
Copy at most COUNT lines. If COUNT is 0, all lines are
copied.
@@ -3777,12 +3778,14 @@ standard.
'-d DELIM'
The first character of DELIM is used to terminate the input
line, rather than newline.
line, rather than newline. If DELIM is the empty string,
'read' will terminate a line when it reads a NUL character.
'-e'
Readline (*note Command Line Editing::) is used to obtain the
line. Readline uses the current (or default, if line editing
was not previously active) editing settings.
was not previously active) editing settings, but uses
Readline's default filename completion.
'-i TEXT'
If Readline is being used to read the line, TEXT is placed
@@ -4366,13 +4369,16 @@ This builtin allows you to change additional shell optional behavior.
are stopped.
'checkwinsize'
If set, Bash checks the window size after each command and, if
necessary, updates the values of 'LINES' and 'COLUMNS'.
If set, Bash checks the window size after each external
(non-builtin) command and, if necessary, updates the values of
'LINES' and 'COLUMNS'.
'cmdhist'
If set, Bash attempts to save all lines of a multiple-line
command in the same history entry. This allows easy
re-editing of multi-line commands.
re-editing of multi-line commands. This option is enabled by
default, but only has an effect if command history is enabled
(*note Bash History Facilities::).
'compat31'
If set, Bash changes its behavior to that of version 3.1 with
@@ -4579,6 +4585,12 @@ This builtin allows you to change additional shell optional behavior.
commands are saved to the history with embedded newlines
rather than using semicolon separators where possible.
'localvar_inherit'
If set, local variables inherit the value and attributes of a
variable of the same name that exists at a previous scope
before any new value is assigned. The NAMEREF attribute is
not inherited.
'login_shell'
The shell sets this option if it is started as a login shell
(*note Invoking Bash::). The value may not be changed.
@@ -8893,10 +8905,9 @@ function and bind it to a particular command using 'complete -F'.
The following function provides completions for the 'cd' builtin. It
is a reasonably good example of what shell functions must do when used
for completion. This function uses the word passsed as '$2' to
determine the directory name to complete. You can also use the
'COMP_WORDS' array variable; the current word is indexed by the
'COMP_CWORD' variable.
for completion. This function uses the word passed as '$2' to determine
the directory name to complete. You can also use the 'COMP_WORDS' array
variable; the current word is indexed by the 'COMP_CWORD' variable.
The function relies on the 'complete' and 'compgen' builtins to do
much of the work, adding only the things that the Bash 'cd' does beyond
@@ -10826,13 +10837,13 @@ D.1 Index of Shell Builtin Commands
* mapfile: Bash Builtins. (line 369)
* popd: Directory Stack Builtins.
(line 35)
* printf: Bash Builtins. (line 414)
* printf: Bash Builtins. (line 415)
* pushd: Directory Stack Builtins.
(line 53)
* pwd: Bourne Shell Builtins.
(line 205)
* read: Bash Builtins. (line 458)
* readarray: Bash Builtins. (line 550)
* read: Bash Builtins. (line 459)
* readarray: Bash Builtins. (line 553)
* readonly: Bourne Shell Builtins.
(line 215)
* return: Bourne Shell Builtins.
@@ -10841,7 +10852,7 @@ D.1 Index of Shell Builtin Commands
* shift: Bourne Shell Builtins.
(line 255)
* shopt: The Shopt Builtin. (line 9)
* source: Bash Builtins. (line 559)
* source: Bash Builtins. (line 562)
* suspend: Job Control Builtins.
(line 104)
* test: Bourne Shell Builtins.
@@ -10850,12 +10861,12 @@ D.1 Index of Shell Builtin Commands
(line 343)
* trap: Bourne Shell Builtins.
(line 349)
* type: Bash Builtins. (line 564)
* typeset: Bash Builtins. (line 596)
* ulimit: Bash Builtins. (line 602)
* type: Bash Builtins. (line 567)
* typeset: Bash Builtins. (line 599)
* ulimit: Bash Builtins. (line 605)
* umask: Bourne Shell Builtins.
(line 398)
* unalias: Bash Builtins. (line 701)
* unalias: Bash Builtins. (line 704)
* unset: Bourne Shell Builtins.
(line 416)
* wait: Job Control Builtins.
@@ -11412,7 +11423,7 @@ D.5 Concept Index
* history list: Bash History Facilities.
(line 6)
* History, how to use: A Programmable Completion Example.
(line 114)
(line 113)
* identifier: Definitions. (line 51)
* initialization file, readline: Readline Init File. (line 6)
* installation: Basic Installation. (line 6)
@@ -11490,134 +11501,134 @@ D.5 Concept Index

Tag Table:
Node: Top891
Node: Introduction2805
Node: What is Bash?3021
Node: What is a shell?4135
Node: Definitions6673
Node: Basic Shell Features9624
Node: Shell Syntax10843
Node: Shell Operation11869
Node: Quoting13162
Node: Escape Character14462
Node: Single Quotes14947
Node: Double Quotes15295
Node: ANSI-C Quoting16573
Node: Locale Translation17832
Node: Comments18728
Node: Shell Commands19346
Node: Simple Commands20218
Node: Pipelines20849
Node: Lists23781
Node: Compound Commands25520
Node: Looping Constructs26532
Node: Conditional Constructs29027
Node: Command Grouping40082
Node: Coprocesses41561
Node: GNU Parallel43393
Node: Shell Functions47366
Node: Shell Parameters54565
Node: Positional Parameters58978
Node: Special Parameters59878
Node: Shell Expansions63215
Node: Brace Expansion65309
Node: Tilde Expansion68143
Node: Shell Parameter Expansion70491
Node: Command Substitution84623
Node: Arithmetic Expansion85978
Node: Process Substitution86910
Node: Word Splitting88030
Node: Filename Expansion89974
Node: Pattern Matching92348
Node: Quote Removal96334
Node: Redirections96629
Node: Executing Commands106187
Node: Simple Command Expansion106857
Node: Command Search and Execution108787
Node: Command Execution Environment111123
Node: Environment114107
Node: Exit Status115766
Node: Signals117436
Node: Shell Scripts119403
Node: Shell Builtin Commands121918
Node: Bourne Shell Builtins123952
Node: Bash Builtins144552
Node: Modifying Shell Behavior173197
Node: The Set Builtin173542
Node: The Shopt Builtin183955
Node: Special Builtins199853
Node: Shell Variables200832
Node: Bourne Shell Variables201269
Node: Bash Variables203373
Node: Bash Features233166
Node: Invoking Bash234065
Node: Bash Startup Files240014
Node: Interactive Shells245117
Node: What is an Interactive Shell?245527
Node: Is this Shell Interactive?246176
Node: Interactive Shell Behavior246991
Node: Bash Conditional Expressions250479
Node: Shell Arithmetic254845
Node: Aliases257662
Node: Arrays260210
Node: The Directory Stack265372
Node: Directory Stack Builtins266156
Node: Controlling the Prompt269124
Node: The Restricted Shell271886
Node: Bash POSIX Mode273711
Node: Job Control284062
Node: Job Control Basics284522
Node: Job Control Builtins289490
Node: Job Control Variables294217
Node: Command Line Editing295373
Node: Introduction and Notation297044
Node: Readline Interaction298667
Node: Readline Bare Essentials299858
Node: Readline Movement Commands301641
Node: Readline Killing Commands302601
Node: Readline Arguments304519
Node: Searching305563
Node: Readline Init File307749
Node: Readline Init File Syntax308896
Node: Conditional Init Constructs329083
Node: Sample Init File331608
Node: Bindable Readline Commands334725
Node: Commands For Moving335929
Node: Commands For History337778
Node: Commands For Text342073
Node: Commands For Killing345462
Node: Numeric Arguments347943
Node: Commands For Completion349082
Node: Keyboard Macros353273
Node: Miscellaneous Commands353960
Node: Readline vi Mode359836
Node: Programmable Completion360743
Node: Programmable Completion Builtins368204
Node: A Programmable Completion Example378090
Node: Using History Interactively383342
Node: Bash History Facilities384026
Node: Bash History Builtins387027
Node: History Interaction391319
Node: Event Designators394283
Node: Word Designators395502
Node: Modifiers397139
Node: Installing Bash398541
Node: Basic Installation399678
Node: Compilers and Options402369
Node: Compiling For Multiple Architectures403110
Node: Installation Names404773
Node: Specifying the System Type405591
Node: Sharing Defaults406307
Node: Operation Controls406980
Node: Optional Features407938
Node: Reporting Bugs418464
Node: Major Differences From The Bourne Shell419658
Node: GNU Free Documentation License436510
Node: Indexes461687
Node: Builtin Index462141
Node: Reserved Word Index468968
Node: Variable Index471416
Node: Function Index487094
Node: Concept Index500397
Node: Top889
Node: Introduction2801
Node: What is Bash?3017
Node: What is a shell?4131
Node: Definitions6669
Node: Basic Shell Features9620
Node: Shell Syntax10839
Node: Shell Operation11865
Node: Quoting13158
Node: Escape Character14458
Node: Single Quotes14943
Node: Double Quotes15291
Node: ANSI-C Quoting16569
Node: Locale Translation17828
Node: Comments18724
Node: Shell Commands19342
Node: Simple Commands20214
Node: Pipelines20845
Node: Lists23777
Node: Compound Commands25516
Node: Looping Constructs26528
Node: Conditional Constructs29023
Node: Command Grouping40078
Node: Coprocesses41557
Node: GNU Parallel43389
Node: Shell Functions47363
Node: Shell Parameters54562
Node: Positional Parameters58975
Node: Special Parameters59875
Node: Shell Expansions63212
Node: Brace Expansion65335
Node: Tilde Expansion68169
Node: Shell Parameter Expansion70517
Node: Command Substitution84649
Node: Arithmetic Expansion86004
Node: Process Substitution86936
Node: Word Splitting88056
Node: Filename Expansion90000
Node: Pattern Matching92374
Node: Quote Removal96360
Node: Redirections96655
Node: Executing Commands106213
Node: Simple Command Expansion106883
Node: Command Search and Execution108813
Node: Command Execution Environment111149
Node: Environment114133
Node: Exit Status115792
Node: Signals117462
Node: Shell Scripts119429
Node: Shell Builtin Commands121944
Node: Bourne Shell Builtins123978
Node: Bash Builtins144578
Node: Modifying Shell Behavior173487
Node: The Set Builtin173832
Node: The Shopt Builtin184245
Node: Special Builtins200580
Node: Shell Variables201559
Node: Bourne Shell Variables201996
Node: Bash Variables204100
Node: Bash Features233893
Node: Invoking Bash234792
Node: Bash Startup Files240741
Node: Interactive Shells245844
Node: What is an Interactive Shell?246254
Node: Is this Shell Interactive?246903
Node: Interactive Shell Behavior247718
Node: Bash Conditional Expressions251206
Node: Shell Arithmetic255572
Node: Aliases258389
Node: Arrays260937
Node: The Directory Stack266099
Node: Directory Stack Builtins266883
Node: Controlling the Prompt269851
Node: The Restricted Shell272613
Node: Bash POSIX Mode274438
Node: Job Control284789
Node: Job Control Basics285249
Node: Job Control Builtins290217
Node: Job Control Variables294944
Node: Command Line Editing296100
Node: Introduction and Notation297771
Node: Readline Interaction299394
Node: Readline Bare Essentials300585
Node: Readline Movement Commands302368
Node: Readline Killing Commands303328
Node: Readline Arguments305246
Node: Searching306290
Node: Readline Init File308476
Node: Readline Init File Syntax309623
Node: Conditional Init Constructs329810
Node: Sample Init File332335
Node: Bindable Readline Commands335452
Node: Commands For Moving336656
Node: Commands For History338505
Node: Commands For Text342800
Node: Commands For Killing346189
Node: Numeric Arguments348670
Node: Commands For Completion349809
Node: Keyboard Macros354000
Node: Miscellaneous Commands354687
Node: Readline vi Mode360563
Node: Programmable Completion361470
Node: Programmable Completion Builtins368931
Node: A Programmable Completion Example378817
Node: Using History Interactively384068
Node: Bash History Facilities384752
Node: Bash History Builtins387753
Node: History Interaction392045
Node: Event Designators395009
Node: Word Designators396228
Node: Modifiers397865
Node: Installing Bash399267
Node: Basic Installation400404
Node: Compilers and Options403095
Node: Compiling For Multiple Architectures403836
Node: Installation Names405499
Node: Specifying the System Type406317
Node: Sharing Defaults407033
Node: Operation Controls407706
Node: Optional Features408664
Node: Reporting Bugs419190
Node: Major Differences From The Bourne Shell420384
Node: GNU Free Documentation License437236
Node: Indexes462413
Node: Builtin Index462867
Node: Reserved Word Index469694
Node: Variable Index472142
Node: Function Index487820
Node: Concept Index501123

End Tag Table
+10 -10
View File
@@ -1,4 +1,4 @@
This is pdfTeX, Version 3.14159265-2.6-1.40.17 (TeX Live 2016/MacPorts 2016_4) (preloaded format=pdfetex 2017.1.6) 3 APR 2017 16:34
This is pdfTeX, Version 3.14159265-2.6-1.40.17 (TeX Live 2016/MacPorts 2016_5) (preloaded format=pdfetex 2017.1.6) 26 JUN 2017 09:16
entering extended mode
restricted \write18 enabled.
file:line:error style messages enabled.
@@ -243,7 +243,7 @@ arallel -k traceroute[]
[43] [44]
[45] [46] [47] [48] [49] [50] [51] [52] [53] [54] [55]
Overfull \hbox (26.76846pt too wide) in paragraph at lines 4348--4348
Overfull \hbox (26.76846pt too wide) in paragraph at lines 4349--4349
[]@texttt mapfile [-d @textttsl de-lim@texttt ] [-n @textttsl count@texttt ] [
-O @textttsl ori-gin@texttt ] [-s @textttsl count@texttt ] [-t] [-u @textttsl f
d@texttt ][]
@@ -257,7 +257,7 @@ d@texttt ][]
.etc.
[56] [57]
Overfull \hbox (38.26584pt too wide) in paragraph at lines 4552--4552
Overfull \hbox (38.26584pt too wide) in paragraph at lines 4557--4557
[]@texttt readarray [-d @textttsl de-lim@texttt ] [-n @textttsl count@texttt ]
[-O @textttsl ori-gin@texttt ] [-s @textttsl count@texttt ] [-t] [-u @textttsl
fd@texttt ][]
@@ -272,7 +272,7 @@ Overfull \hbox (38.26584pt too wide) in paragraph at lines 4552--4552
[58] [59] [60] [61] [62] [63] [64] [65] [66] [67] [68] [69] [70] Chapter 5
[71] [72] [73] [74] [75] [76] [77] [78] [79] [80] [81] [82] Chapter 6 [83]
Overfull \hbox (49.43388pt too wide) in paragraph at lines 6299--6299
Overfull \hbox (49.43388pt too wide) in paragraph at lines 6311--6311
[]@texttt bash [long-opt] [-ir] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@t
exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
@@ -285,7 +285,7 @@ exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
.etc.
Overfull \hbox (72.42863pt too wide) in paragraph at lines 6300--6300
Overfull \hbox (72.42863pt too wide) in paragraph at lines 6312--6312
[]@texttt bash [long-opt] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@texttt
] [-O @textttsl shopt_option@texttt ] -c @textttsl string @texttt [@textttsl ar
-
@@ -299,7 +299,7 @@ Overfull \hbox (72.42863pt too wide) in paragraph at lines 6300--6300
.etc.
Overfull \hbox (32.18782pt too wide) in paragraph at lines 6301--6301
Overfull \hbox (32.18782pt too wide) in paragraph at lines 6313--6313
[]@texttt bash [long-opt] -s [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@text
tt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
@@ -389,7 +389,7 @@ texinfo.tex: doing @include of fdl.texi
Here is how much of TeX's memory you used:
4064 strings out of 497105
47069 string characters out of 6206776
136513 words of memory out of 5000000
136551 words of memory out of 5000000
4846 multiletter control sequences out of 15000+600000
34315 words of font info for 116 fonts, out of 8000000 for 9000
51 hyphenation exceptions out of 8191
@@ -411,10 +411,10 @@ e/fonts/type1/public/amsfonts/cm/cmtt12.pfb></opt/local/share/texmf-texlive/fon
ts/type1/public/amsfonts/cm/cmtt9.pfb></opt/local/share/texmf-texlive/fonts/typ
e1/public/cm-super/sfrm1095.pfb></opt/local/share/texmf-texlive/fonts/type1/pub
lic/cm-super/sfrm1440.pfb>
Output written on bashref.pdf (182 pages, 742837 bytes).
Output written on bashref.pdf (182 pages, 743436 bytes).
PDF statistics:
2606 PDF objects out of 2984 (max. 8388607)
2379 compressed objects within 24 object streams
2608 PDF objects out of 2984 (max. 8388607)
2381 compressed objects within 24 object streams
308 named destinations out of 1000 (max. 500000)
1125 words of extra memory for PDF output out of 10000 (max. 10000000)
BIN
View File
Binary file not shown.
+357 -338
View File
@@ -1,7 +1,7 @@
%!PS-Adobe-2.0
%%Creator: dvips(k) 5.996 Copyright 2016 Radical Eye Software
%%Title: bashref.dvi
%%CreationDate: Mon Apr 3 16:34:02 2017
%%CreationDate: Mon Jun 26 09:16:48 2017
%%Pages: 182
%%PageOrder: Ascend
%%BoundingBox: 0 0 612 792
@@ -12,7 +12,7 @@
%DVIPSWebPage: (www.radicaleye.com)
%DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps bashref.dvi
%DVIPSParameters: dpi=600
%DVIPSSource: TeX output 2017.04.03:1634
%DVIPSSource: TeX output 2017.06.26:0916
%%BeginProcSet: tex.pro 0 0
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -7596,7 +7596,7 @@ ifelse
TeXDict begin 1 0 bop 150 1318 a Fv(Bash)64 b(Reference)j(Man)-5
b(ual)p 150 1385 3600 34 v 2361 1481 a Fu(Reference)31
b(Do)s(cumen)m(tation)i(for)d(Bash)2428 1589 y(Edition)h(4.4,)g(for)f
Ft(Bash)g Fu(V)-8 b(ersion)31 b(4.4.)3285 1697 y(Marc)m(h)g(2017)150
Ft(Bash)g Fu(V)-8 b(ersion)31 b(4.4.)3350 1697 y(June)e(2017)150
4927 y Fs(Chet)45 b(Ramey)-11 b(,)46 b(Case)g(W)-11 b(estern)46
b(Reserv)l(e)g(Univ)l(ersit)l(y)150 5068 y(Brian)f(F)-11
b(o)l(x,)45 b(F)-11 b(ree)45 b(Soft)l(w)l(are)h(F)-11
@@ -7604,10 +7604,10 @@ b(oundation)p 150 5141 3600 17 v eop end
%%Page: 2 2
TeXDict begin 2 1 bop 150 4279 a Fu(This)35 b(text)h(is)g(a)g(brief)f
(description)h(of)f(the)h(features)g(that)g(are)g(presen)m(t)g(in)f
(the)h(Bash)f(shell)h(\(v)m(ersion)150 4389 y(4.4,)c(22)f(Marc)m(h)g
(2017\).)150 4523 y(This)f(is)h(Edition)f(4.4,)i(last)g(up)s(dated)d
(22)j(Marc)m(h)f(2017,)i(of)e Fr(The)f(GNU)h(Bash)g(Reference)g(Man)m
(ual)p Fu(,)h(for)150 4633 y Ft(Bash)p Fu(,)d(V)-8 b(ersion)31
(the)h(Bash)f(shell)h(\(v)m(ersion)150 4389 y(4.4,)c(23)f(June)e
(2017\).)150 4523 y(This)34 b(is)h(Edition)g(4.4,)i(last)e(up)s(dated)f
(23)h(June)f(2017,)k(of)d Fr(The)f(GNU)i(Bash)f(Reference)g(Man)m(ual)p
Fu(,)i(for)150 4633 y Ft(Bash)p Fu(,)29 b(V)-8 b(ersion)31
b(4.4.)150 4767 y(Cop)m(yrigh)m(t)602 4764 y(c)577 4767
y Fq(\015)f Fu(1988{2017)35 b(F)-8 b(ree)31 b(Soft)m(w)m(are)h(F)-8
b(oundation,)31 b(Inc.)390 4902 y(P)m(ermission)21 b(is)f(gran)m(ted)h
@@ -9209,9 +9209,9 @@ b(the)g Ft(-k)g Fu(option)390 811 y Ft({)47 b(echo)g(foss.org.my)e(;)i
f(to)150 1189 y(`)p Ft(cat)g(file)f(|)h(bash)p Fu('.)53
b(It)35 b(is)g(not)g(uncommon)f(to)i(tak)m(e)g(a)f(list)h(of)f
(\014lenames,)h(create)g(a)g(series)f(of)g(shell)150
1298 y(commands)27 b(to)h(op)s(erate)h(on)e(them,)h(and)f(feed)h(that)g
(list)g(of)g(commnds)e(to)j(a)f(shell.)40 b(P)m(arallel)29
b(can)f(sp)s(eed)150 1408 y(this)i(up.)40 b(Assuming)30
1298 y(commands)24 b(to)h(op)s(erate)h(on)e(them,)i(and)e(feed)g(that)h
(list)h(of)e(commands)g(to)i(a)f(shell.)39 b(P)m(arallel)26
b(can)f(sp)s(eed)150 1408 y(this)30 b(up.)40 b(Assuming)30
b(that)h Ft(file)e Fu(con)m(tains)i(a)g(list)g(of)g(shell)f(commands,)h
(one)f(p)s(er)g(line,)390 1542 y Ft(parallel)46 b(-j)h(10)g(<)g(file)
150 1676 y Fu(will)37 b(ev)-5 b(aluate)38 b(the)f(commands)f(using)g
@@ -9673,17 +9673,18 @@ Fu(.)50 b(This)33 b(is)h(p)s(erformed)e(at)j(the)f(same)g(time)g(as)g
(haracters)h(presen)m(t)e(in)g(the)g(original)i(w)m(ord)e(are)150
2872 y(remo)m(v)m(ed)h(unless)f(they)h(ha)m(v)m(e)g(b)s(een)f(quoted)g
(themselv)m(es)i(\()p Fr(quote)f(remo)m(v)-5 b(al)t Fu(\).)275
3011 y(Only)35 b(brace)i(expansion,)h(w)m(ord)e(splitting,)j(and)d
(\014lename)g(expansion)g(can)h(c)m(hange)h(the)e(n)m(um)m(b)s(er)150
3121 y(of)h(w)m(ords)f(of)g(the)h(expansion;)i(other)e(expansions)f
(expand)g(a)h(single)g(w)m(ord)f(to)h(a)g(single)g(w)m(ord.)58
b(The)150 3230 y(only)32 b(exceptions)i(to)f(this)f(are)h(the)f
(expansions)g(of)h Ft("$@")e Fu(\(see)i(Section)g(3.4.2)h([Sp)s(ecial)f
(P)m(arameters],)150 3340 y(page)e(21\))h(and)d Ft("${)p
Fj(name)p Ft([@]}")e Fu(\(see)32 b(Section)f(6.7)g([Arra)m(ys],)h(page)
f(93\).)275 3478 y(After)41 b(all)i(expansions,)h Ft(quote)29
b(removal)40 b Fu(\(see)i(Section)h(3.5.9)g([Quote)f(Remo)m(v)-5
b(al],)47 b(page)42 b(33\))h(is)150 3588 y(p)s(erformed.)150
3011 y(Only)31 b(brace)i(expansion,)h(w)m(ord)e(splitting,)i(and)e
(\014lename)h(expansion)f(can)h(increase)g(the)g(n)m(um)m(b)s(er)150
3121 y(of)24 b(w)m(ords)g(of)g(the)h(expansion;)h(other)e(expansions)g
(expand)g(a)g(single)h(w)m(ord)f(to)h(a)f(single)h(w)m(ord.)38
b(The)24 b(only)150 3230 y(exceptions)i(to)f(this)g(are)g(the)g
(expansions)g(of)g Ft("$@")f Fu(and)g Ft($*)g Fu(\(see)i(Section)f
(3.4.2)i([Sp)s(ecial)e(P)m(arameters],)150 3340 y(page)31
b(21\),)h(and)e Ft("${)p Fj(name)p Ft([@]}")d Fu(and)i
Ft(${)p Fj(name)p Ft([*]})f Fu(\(see)j(Section)h(6.7)f([Arra)m(ys],)g
(page)g(93\).)275 3478 y(After)41 b(all)i(expansions,)h
Ft(quote)29 b(removal)40 b Fu(\(see)i(Section)h(3.5.9)g([Quote)f(Remo)m
(v)-5 b(al],)47 b(page)42 b(33\))h(is)150 3588 y(p)s(erformed.)150
3791 y Fk(3.5.1)63 b(Brace)40 b(Expansion)150 3938 y
Fu(Brace)32 b(expansion)f(is)f(a)i(mec)m(hanism)f(b)m(y)f(whic)m(h)h
(arbitrary)f(strings)h(ma)m(y)g(b)s(e)f(generated.)43
@@ -12183,63 +12184,65 @@ b(when)e(the)i(function)f(returns.)37 b(The)24 b(return)f(status)i(is)f
(zero)i(unless)d Ft(local)g Fu(is)i(used)630 518 y(outside)k(a)f
(function,)h(an)f(in)m(v)-5 b(alid)29 b Fr(name)k Fu(is)28
b(supplied,)g(or)g Fr(name)34 b Fu(is)28 b(a)h(readonly)f(v)-5
b(ariable.)150 681 y Ft(logout)870 817 y(logout)46 b([)p
Fj(n)p Ft(])630 953 y Fu(Exit)31 b(a)g(login)g(shell,)g(returning)e(a)i
b(ariable.)150 674 y Ft(logout)870 807 y(logout)46 b([)p
Fj(n)p Ft(])630 940 y Fu(Exit)31 b(a)g(login)g(shell,)g(returning)e(a)i
(status)g(of)f Fr(n)g Fu(to)h(the)g(shell's)f(paren)m(t.)150
1116 y Ft(mapfile)870 1252 y(mapfile)46 b([-d)h Fj(delim)p
1096 y Ft(mapfile)870 1229 y(mapfile)46 b([-d)h Fj(delim)p
Ft(])f([-n)h Fj(count)p Ft(])f([-O)h Fj(origin)p Ft(])f([-s)g
Fj(count)p Ft(])h([-t])f([-u)h Fj(fd)p Ft(])1061 1362
Fj(count)p Ft(])h([-t])f([-u)h Fj(fd)p Ft(])1061 1338
y([-C)g Fj(callback)p Ft(])e([-c)i Fj(quantum)p Ft(])f([)p
Fj(array)p Ft(])630 1498 y Fu(Read)38 b(lines)f(from)g(the)h(standard)e
Fj(array)p Ft(])630 1471 y Fu(Read)38 b(lines)f(from)g(the)h(standard)e
(input)g(in)m(to)j(the)e(indexed)g(arra)m(y)h(v)-5 b(ariable)38
b Fr(arra)m(y)p Fu(,)i(or)630 1607 y(from)28 b(\014le)h(descriptor)f
b Fr(arra)m(y)p Fu(,)i(or)630 1581 y(from)28 b(\014le)h(descriptor)f
Fr(fd)k Fu(if)c(the)h Ft(-u)f Fu(option)h(is)g(supplied.)39
b(The)28 b(v)-5 b(ariable)29 b Ft(MAPFILE)e Fu(is)i(the)630
1717 y(default)i Fr(arra)m(y)p Fu(.)41 b(Options,)30
1690 y(default)i Fr(arra)m(y)p Fu(.)41 b(Options,)30
b(if)g(supplied,)g(ha)m(v)m(e)h(the)g(follo)m(wing)h(meanings:)630
1880 y Ft(-d)384 b Fu(The)37 b(\014rst)g(c)m(haracter)i(of)f
1846 y Ft(-d)384 b Fu(The)37 b(\014rst)g(c)m(haracter)i(of)f
Fr(delim)g Fu(is)f(used)g(to)h(terminate)h(eac)m(h)g(input)d(line,)1110
1989 y(rather)30 b(than)g(newline.)630 2152 y Ft(-n)384
b Fu(Cop)m(y)30 b(at)h(most)g Fr(coun)m(t)i Fu(lines.)41
b(If)30 b Fr(coun)m(t)j Fu(is)d(0,)h(all)h(lines)e(are)h(copied.)630
2315 y Ft(-O)384 b Fu(Begin)31 b(assigning)g(to)g Fr(arra)m(y)39
b Fu(at)31 b(index)f Fr(origin)p Fu(.)41 b(The)30 b(default)h(index)f
(is)g(0.)630 2477 y Ft(-s)384 b Fu(Discard)31 b(the)f(\014rst)g
Fr(coun)m(t)j Fu(lines)e(read.)630 2640 y Ft(-t)384 b
Fu(Remo)m(v)m(e)32 b(a)f(trailing)g Fr(delim)g Fu(\(default)g
(newline\))f(from)g(eac)m(h)i(line)f(read.)630 2803 y
Ft(-u)384 b Fu(Read)31 b(lines)f(from)g(\014le)h(descriptor)f
Fr(fd)j Fu(instead)e(of)f(the)h(standard)e(input.)630
2966 y Ft(-C)384 b Fu(Ev)-5 b(aluate)33 b Fr(callbac)m(k)39
b Fu(eac)m(h)33 b(time)f Fr(quan)m(tum)p Fu(P)f(lines)h(are)g(read.)45
b(The)31 b Ft(-c)g Fu(op-)1110 3075 y(tion)g(sp)s(eci\014es)f
Fr(quan)m(tum)p Fu(.)630 3238 y Ft(-c)384 b Fu(Sp)s(ecify)30
b(the)g(n)m(um)m(b)s(er)f(of)i(lines)f(read)h(b)s(et)m(w)m(een)g(eac)m
(h)g(call)h(to)f Fr(callbac)m(k)p Fu(.)630 3401 y(If)36
b Ft(-C)g Fu(is)g(sp)s(eci\014ed)g(without)g Ft(-c)p
Fu(,)h(the)g(default)f(quan)m(tum)g(is)h(5000.)60 b(When)36
b Fr(callbac)m(k)44 b Fu(is)630 3510 y(ev)-5 b(aluated,)30
b(it)e(is)g(supplied)f(the)h(index)f(of)i(the)f(next)g(arra)m(y)g
(elemen)m(t)h(to)g(b)s(e)e(assigned)i(and)630 3620 y(the)39
b(line)g(to)h(b)s(e)e(assigned)h(to)h(that)f(elemen)m(t)i(as)e
(additional)h(argumen)m(ts.)66 b Fr(callbac)m(k)47 b
Fu(is)630 3729 y(ev)-5 b(aluated)32 b(after)e(the)h(line)g(is)f(read)g
(but)g(b)s(efore)g(the)h(arra)m(y)g(elemen)m(t)g(is)g(assigned.)630
3866 y(If)25 b(not)g(supplied)f(with)h(an)g(explicit)i(origin,)g
1956 y(rather)41 b(than)h(newline.)74 b(If)41 b Fr(delim)h
Fu(is)g(the)f(empt)m(y)h(string,)j Ft(mapfile)40 b Fu(will)1110
2066 y(terminate)31 b(a)g(line)g(when)e(it)i(reads)f(a)h(NUL)g(c)m
(haracter.)630 2222 y Ft(-n)384 b Fu(Cop)m(y)30 b(at)h(most)g
Fr(coun)m(t)i Fu(lines.)41 b(If)30 b Fr(coun)m(t)j Fu(is)d(0,)h(all)h
(lines)e(are)h(copied.)630 2378 y Ft(-O)384 b Fu(Begin)31
b(assigning)g(to)g Fr(arra)m(y)39 b Fu(at)31 b(index)f
Fr(origin)p Fu(.)41 b(The)30 b(default)h(index)f(is)g(0.)630
2534 y Ft(-s)384 b Fu(Discard)31 b(the)f(\014rst)g Fr(coun)m(t)j
Fu(lines)e(read.)630 2690 y Ft(-t)384 b Fu(Remo)m(v)m(e)32
b(a)f(trailing)g Fr(delim)g Fu(\(default)g(newline\))f(from)g(eac)m(h)i
(line)f(read.)630 2846 y Ft(-u)384 b Fu(Read)31 b(lines)f(from)g
(\014le)h(descriptor)f Fr(fd)j Fu(instead)e(of)f(the)h(standard)e
(input.)630 3002 y Ft(-C)384 b Fu(Ev)-5 b(aluate)33 b
Fr(callbac)m(k)39 b Fu(eac)m(h)33 b(time)f Fr(quan)m(tum)p
Fu(P)f(lines)h(are)g(read.)45 b(The)31 b Ft(-c)g Fu(op-)1110
3112 y(tion)g(sp)s(eci\014es)f Fr(quan)m(tum)p Fu(.)630
3268 y Ft(-c)384 b Fu(Sp)s(ecify)30 b(the)g(n)m(um)m(b)s(er)f(of)i
(lines)f(read)h(b)s(et)m(w)m(een)g(eac)m(h)g(call)h(to)f
Fr(callbac)m(k)p Fu(.)630 3424 y(If)36 b Ft(-C)g Fu(is)g(sp)s
(eci\014ed)g(without)g Ft(-c)p Fu(,)h(the)g(default)f(quan)m(tum)g(is)h
(5000.)60 b(When)36 b Fr(callbac)m(k)44 b Fu(is)630 3533
y(ev)-5 b(aluated,)30 b(it)e(is)g(supplied)f(the)h(index)f(of)i(the)f
(next)g(arra)m(y)g(elemen)m(t)h(to)g(b)s(e)e(assigned)i(and)630
3643 y(the)39 b(line)g(to)h(b)s(e)e(assigned)h(to)h(that)f(elemen)m(t)i
(as)e(additional)h(argumen)m(ts.)66 b Fr(callbac)m(k)47
b Fu(is)630 3753 y(ev)-5 b(aluated)32 b(after)e(the)h(line)g(is)f(read)
g(but)g(b)s(efore)g(the)h(arra)m(y)g(elemen)m(t)g(is)g(assigned.)630
3885 y(If)25 b(not)g(supplied)f(with)h(an)g(explicit)i(origin,)g
Ft(mapfile)c Fu(will)j(clear)g Fr(arra)m(y)34 b Fu(b)s(efore)24
b(assigning)630 3975 y(to)31 b(it.)630 4111 y Ft(mapfile)41
b(assigning)630 3995 y(to)31 b(it.)630 4128 y Ft(mapfile)41
b Fu(returns)g(successfully)i(unless)e(an)i(in)m(v)-5
b(alid)43 b(option)g(or)g(option)g(argumen)m(t)g(is)630
4221 y(supplied,)29 b Fr(arra)m(y)39 b Fu(is)30 b(in)m(v)-5
4237 y(supplied,)29 b Fr(arra)m(y)39 b Fu(is)30 b(in)m(v)-5
b(alid)31 b(or)g(unassignable,)f(or)h Fr(arra)m(y)38
b Fu(is)31 b(not)f(an)h(indexed)e(arra)m(y)-8 b(.)150
4384 y Ft(printf)870 4520 y(printf)46 b([-v)h Fj(var)p
Ft(])g Fj(format)f Ft([)p Fj(arguments)p Ft(])630 4656
4394 y Ft(printf)870 4526 y(printf)46 b([-v)h Fj(var)p
Ft(])g Fj(format)f Ft([)p Fj(arguments)p Ft(])630 4659
y Fu(W)-8 b(rite)27 b(the)g(formatted)f Fr(argumen)m(ts)k
Fu(to)d(the)f(standard)f(output)h(under)e(the)i(con)m(trol)i(of)e(the)
630 4765 y Fr(format)p Fu(.)66 b(The)39 b Ft(-v)f Fu(option)h(causes)g
630 4769 y Fr(format)p Fu(.)66 b(The)39 b Ft(-v)f Fu(option)h(causes)g
(the)g(output)g(to)g(b)s(e)f(assigned)h(to)h(the)f(v)-5
b(ariable)39 b Fr(v)-5 b(ar)630 4875 y Fu(rather)30 b(than)g(b)s(eing)g
b(ariable)39 b Fr(v)-5 b(ar)630 4878 y Fu(rather)30 b(than)g(b)s(eing)g
(prin)m(ted)g(to)h(the)g(standard)e(output.)630 5011
y(The)36 b Fr(format)i Fu(is)f(a)f(c)m(haracter)i(string)e(whic)m(h)g
(con)m(tains)i(three)e(t)m(yp)s(es)g(of)h(ob)5 b(jects:)53
@@ -12341,199 +12344,204 @@ b Fj(aname)114 b Fu(The)34 b(w)m(ords)f(are)i(assigned)f(to)h(sequen)m
b(elemen)m(ts)h(are)e(remo)m(v)m(ed)i(from)d Fr(aname)34
b Fu(b)s(efore)1110 518 y(the)d(assignmen)m(t.)41 b(Other)30
b Fr(name)36 b Fu(argumen)m(ts)30 b(are)h(ignored.)630
667 y Ft(-d)f Fj(delim)114 b Fu(The)41 b(\014rst)h(c)m(haracter)h(of)f
671 y Ft(-d)f Fj(delim)114 b Fu(The)41 b(\014rst)h(c)m(haracter)h(of)f
Fr(delim)g Fu(is)g(used)g(to)g(terminate)h(the)f(input)f(line,)1110
777 y(rather)30 b(than)g(newline.)630 927 y Ft(-e)384
b Fu(Readline)46 b(\(see)g(Chapter)e(8)h([Command)f(Line)h(Editing],)50
b(page)45 b(106\))i(is)1110 1036 y(used)37 b(to)i(obtain)g(the)f(line.)
65 b(Readline)39 b(uses)e(the)i(curren)m(t)f(\(or)g(default,)j(if)1110
1146 y(line)31 b(editing)g(w)m(as)f(not)h(previously)f(activ)m(e\))j
(editing)e(settings.)630 1295 y Ft(-i)f Fj(text)162 b
Fu(If)36 b(Readline)i(is)f(b)s(eing)g(used)f(to)h(read)g(the)g(line,)j
Fr(text)f Fu(is)e(placed)h(in)m(to)g(the)1110 1405 y(editing)31
b(bu\013er)e(b)s(efore)h(editing)h(b)s(egins.)630 1554
y Ft(-n)f Fj(nchars)66 b Ft(read)38 b Fu(returns)f(after)j(reading)f
Fr(nc)m(hars)j Fu(c)m(haracters)e(rather)f(than)g(w)m(aiting)1110
1664 y(for)d(a)h(complete)h(line)f(of)g(input,)g(but)f(honors)g(a)h
(delimiter)g(if)f(few)m(er)h(than)1110 1773 y Fr(nc)m(hars)d
Fu(c)m(haracters)e(are)e(read)h(b)s(efore)f(the)g(delimiter.)630
1923 y Ft(-N)g Fj(nchars)66 b Ft(read)39 b Fu(returns)f(after)j
(reading)e(exactly)j Fr(nc)m(hars)h Fu(c)m(haracters)f(rather)d(than)
1110 2032 y(w)m(aiting)32 b(for)f(a)g(complete)i(line)e(of)g(input,)g
(unless)f(EOF)h(is)g(encoun)m(tered)g(or)1110 2142 y
Ft(read)f Fu(times)i(out.)43 b(Delimiter)33 b(c)m(haracters)f(encoun)m
(tered)g(in)f(the)g(input)g(are)1110 2252 y(not)g(treated)h(sp)s
(ecially)f(and)f(do)h(not)g(cause)g Ft(read)e Fu(to)j(return)d(un)m
(til)i Fr(nc)m(hars)1110 2361 y Fu(c)m(haracters)26 b(are)f(read.)38
b(The)24 b(result)g(is)h(not)f(split)h(on)f(the)h(c)m(haracters)h(in)e
Ft(IFS)p Fu(;)1110 2471 y(the)e(in)m(ten)m(t)i(is)e(that)h(the)f(v)-5
781 y(rather)31 b(than)g(newline.)42 b(If)30 b Fr(delim)h
Fu(is)g(the)h(empt)m(y)f(string,)g Ft(read)f Fu(will)h(termi-)1110
891 y(nate)g(a)g(line)f(when)g(it)h(reads)f(a)h(NUL)f(c)m(haracter.)630
1044 y Ft(-e)384 b Fu(Readline)46 b(\(see)g(Chapter)e(8)h([Command)f
(Line)h(Editing],)50 b(page)45 b(106\))i(is)1110 1154
y(used)37 b(to)i(obtain)g(the)f(line.)65 b(Readline)39
b(uses)e(the)i(curren)m(t)f(\(or)g(default,)j(if)1110
1263 y(line)h(editing)g(w)m(as)g(not)g(previously)f(activ)m(e\))k
(editing)d(settings,)j(but)c(uses)1110 1373 y(Readline's)31
b(default)g(\014lename)f(completion.)630 1526 y Ft(-i)g
Fj(text)162 b Fu(If)36 b(Readline)i(is)f(b)s(eing)g(used)f(to)h(read)g
(the)g(line,)j Fr(text)f Fu(is)e(placed)h(in)m(to)g(the)1110
1636 y(editing)31 b(bu\013er)e(b)s(efore)h(editing)h(b)s(egins.)630
1789 y Ft(-n)f Fj(nchars)66 b Ft(read)38 b Fu(returns)f(after)j
(reading)f Fr(nc)m(hars)j Fu(c)m(haracters)e(rather)f(than)g(w)m
(aiting)1110 1899 y(for)d(a)h(complete)h(line)f(of)g(input,)g(but)f
(honors)g(a)h(delimiter)g(if)f(few)m(er)h(than)1110 2008
y Fr(nc)m(hars)d Fu(c)m(haracters)e(are)e(read)h(b)s(efore)f(the)g
(delimiter.)630 2162 y Ft(-N)g Fj(nchars)66 b Ft(read)39
b Fu(returns)f(after)j(reading)e(exactly)j Fr(nc)m(hars)h
Fu(c)m(haracters)f(rather)d(than)1110 2271 y(w)m(aiting)32
b(for)f(a)g(complete)i(line)e(of)g(input,)g(unless)f(EOF)h(is)g(encoun)
m(tered)g(or)1110 2381 y Ft(read)f Fu(times)i(out.)43
b(Delimiter)33 b(c)m(haracters)f(encoun)m(tered)g(in)f(the)g(input)g
(are)1110 2491 y(not)g(treated)h(sp)s(ecially)f(and)f(do)h(not)g(cause)
g Ft(read)e Fu(to)j(return)d(un)m(til)i Fr(nc)m(hars)1110
2600 y Fu(c)m(haracters)26 b(are)f(read.)38 b(The)24
b(result)g(is)h(not)f(split)h(on)f(the)h(c)m(haracters)h(in)e
Ft(IFS)p Fu(;)1110 2710 y(the)e(in)m(ten)m(t)i(is)e(that)h(the)f(v)-5
b(ariable)23 b(is)f(assigned)g(exactly)i(the)e(c)m(haracters)i(read)
1110 2580 y(\(with)30 b(the)h(exception)h(of)e(bac)m(kslash;)h(see)g
(the)g Ft(-r)f Fu(option)h(b)s(elo)m(w\).)630 2730 y
1110 2819 y(\(with)30 b(the)h(exception)h(of)e(bac)m(kslash;)h(see)g
(the)g Ft(-r)f Fu(option)h(b)s(elo)m(w\).)630 2973 y
Ft(-p)f Fj(prompt)66 b Fu(Displa)m(y)38 b Fr(prompt)p
Fu(,)g(without)e(a)h(trailing)h(newline,)h(b)s(efore)d(attempting)i(to)
1110 2839 y(read)f(an)m(y)h(input.)60 b(The)37 b(prompt)g(is)g(displa)m
(y)m(ed)h(only)f(if)g(input)g(is)g(coming)1110 2949 y(from)30
b(a)h(terminal.)630 3098 y Ft(-r)384 b Fu(If)21 b(this)h(option)g(is)f
1110 3082 y(read)f(an)m(y)h(input.)60 b(The)37 b(prompt)g(is)g(displa)m
(y)m(ed)h(only)f(if)g(input)g(is)g(coming)1110 3192 y(from)30
b(a)h(terminal.)630 3345 y Ft(-r)384 b Fu(If)21 b(this)h(option)g(is)f
(giv)m(en,)k(bac)m(kslash)d(do)s(es)f(not)h(act)h(as)f(an)f(escap)s(e)h
(c)m(haracter.)1110 3208 y(The)30 b(bac)m(kslash)i(is)f(considered)g
(c)m(haracter.)1110 3455 y(The)30 b(bac)m(kslash)i(is)f(considered)g
(to)h(b)s(e)e(part)h(of)g(the)g(line.)43 b(In)30 b(particular,)i(a)1110
3318 y(bac)m(kslash-newline)f(pair)f(ma)m(y)h(not)g(b)s(e)f(used)f(as)i
(a)g(line)f(con)m(tin)m(uation.)630 3467 y Ft(-s)384
3565 y(bac)m(kslash-newline)f(pair)f(ma)m(y)h(not)g(b)s(e)f(used)f(as)i
(a)g(line)f(con)m(tin)m(uation.)630 3718 y Ft(-s)384
b Fu(Silen)m(t)28 b(mo)s(de.)40 b(If)27 b(input)f(is)i(coming)g(from)f
(a)h(terminal,)h(c)m(haracters)g(are)f(not)1110 3577
y(ec)m(ho)s(ed.)630 3726 y Ft(-t)i Fj(timeout)1110 3836
(a)h(terminal,)h(c)m(haracters)g(are)f(not)1110 3828
y(ec)m(ho)s(ed.)630 3981 y Ft(-t)i Fj(timeout)1110 4091
y Fu(Cause)42 b Ft(read)g Fu(to)h(time)h(out)f(and)f(return)f(failure)i
(if)g(a)g(complete)h(line)f(of)1110 3945 y(input)26 b(\(or)h(a)g(sp)s
(if)g(a)g(complete)h(line)f(of)1110 4200 y(input)26 b(\(or)h(a)g(sp)s
(eci\014ed)f(n)m(um)m(b)s(er)g(of)h(c)m(haracters\))h(is)f(not)g(read)g
(within)f Fr(time-)1110 4055 y(out)37 b Fu(seconds.)53
(within)f Fr(time-)1110 4310 y(out)37 b Fu(seconds.)53
b Fr(timeout)38 b Fu(ma)m(y)d(b)s(e)f(a)h(decimal)h(n)m(um)m(b)s(er)d
(with)h(a)h(fractional)1110 4164 y(p)s(ortion)29 b(follo)m(wing)h(the)f
(with)h(a)h(fractional)1110 4419 y(p)s(ortion)29 b(follo)m(wing)h(the)f
(decimal)h(p)s(oin)m(t.)40 b(This)29 b(option)g(is)g(only)g(e\013ectiv)
m(e)j(if)1110 4274 y Ft(read)j Fu(is)i(reading)g(input)e(from)h(a)h
m(e)j(if)1110 4529 y Ft(read)j Fu(is)i(reading)g(input)e(from)h(a)h
(terminal,)i(pip)s(e,)e(or)g(other)f(sp)s(ecial)i(\014le;)1110
4384 y(it)31 b(has)g(no)g(e\013ect)h(when)e(reading)h(from)g(regular)g
4639 y(it)31 b(has)g(no)g(e\013ect)h(when)e(reading)h(from)g(regular)g
(\014les.)42 b(If)30 b Ft(read)g Fu(times)h(out,)1110
4493 y Ft(read)d Fu(sa)m(v)m(es)j(an)m(y)f(partial)h(input)d(read)i(in)
4748 y Ft(read)d Fu(sa)m(v)m(es)j(an)m(y)f(partial)h(input)d(read)i(in)
m(to)h(the)e(sp)s(eci\014ed)g(v)-5 b(ariable)31 b Fr(name)p
Fu(.)1110 4603 y(If)k Fr(timeout)j Fu(is)e(0,)h Ft(read)e
Fu(.)1110 4858 y(If)k Fr(timeout)j Fu(is)e(0,)h Ft(read)e
Fu(returns)f(immediately)-8 b(,)39 b(without)c(trying)h(to)g(read)1110
4712 y(and)30 b(data.)44 b(The)30 b(exit)i(status)f(is)g(0)g(if)g
4967 y(and)30 b(data.)44 b(The)30 b(exit)i(status)f(is)g(0)g(if)g
(input)f(is)h(a)m(v)-5 b(ailable)34 b(on)c(the)i(sp)s(eci\014ed)1110
4822 y(\014le)g(descriptor,)g(non-zero)h(otherwise.)46
b(The)31 b(exit)i(status)f(is)g(greater)h(than)1110 4932
y(128)f(if)e(the)h(timeout)g(is)f(exceeded.)630 5081
5077 y(\014le)g(descriptor,)g(non-zero)h(otherwise.)46
b(The)31 b(exit)i(status)f(is)g(greater)h(than)1110 5187
y(128)f(if)e(the)h(timeout)g(is)f(exceeded.)630 5340
y Ft(-u)g Fj(fd)258 b Fu(Read)31 b(input)e(from)h(\014le)g(descriptor)h
Fr(fd)p Fu(.)150 5230 y Ft(readarray)870 5340 y(readarray)45
b([-d)i Fj(delim)p Ft(])f([-n)h Fj(count)p Ft(])f([-O)h
Fj(origin)p Ft(])f([-s)h Fj(count)p Ft(])f([-t])h([-u)g
Fj(fd)p Ft(])p eop end
Fr(fd)p Fu(.)p eop end
%%Page: 59 65
TeXDict begin 59 64 bop 150 -116 a Fu(Chapter)30 b(4:)41
b(Shell)30 b(Builtin)h(Commands)2069 b(59)1061 299 y
Ft([-C)47 b Fj(callback)p Ft(])e([-c)i Fj(quantum)p Ft(])f([)p
Fj(array)p Ft(])630 433 y Fu(Read)38 b(lines)f(from)g(the)h(standard)e
(input)g(in)m(to)j(the)e(indexed)g(arra)m(y)h(v)-5 b(ariable)38
b Fr(arra)m(y)p Fu(,)i(or)630 543 y(from)30 b(\014le)g(descriptor)h
Fr(fd)i Fu(if)d(the)h Ft(-u)e Fu(option)i(is)g(supplied.)630
677 y(A)f(synon)m(ym)g(for)g Ft(mapfile)p Fu(.)150 836
y Ft(source)870 971 y(source)46 b Fj(filename)630 1105
y Fu(A)30 b(synon)m(ym)g(for)g Ft(.)g Fu(\(see)i(Section)f(4.1)g
([Bourne)g(Shell)f(Builtins],)h(page)g(43\).)150 1264
y Ft(type)870 1398 y(type)47 b([-afptP])e([)p Fj(name)i
Ft(...)o(])630 1533 y Fu(F)-8 b(or)42 b(eac)m(h)g Fr(name)p
Fu(,)i(indicate)e(ho)m(w)g(it)f(w)m(ould)g(b)s(e)g(in)m(terpreted)g(if)
g(used)f(as)i(a)f(command)630 1642 y(name.)630 1777 y(If)g(the)g
Ft(-t)g Fu(option)h(is)f(used,)j Ft(type)c Fu(prin)m(ts)h(a)h(single)g
(w)m(ord)f(whic)m(h)g(is)g(one)h(of)g(`)p Ft(alias)p
Fu(',)630 1886 y(`)p Ft(function)p Fu(',)32 b(`)p Ft(builtin)p
Fu(',)g(`)p Ft(file)p Fu(')g(or)h(`)p Ft(keyword)p Fu(',)f(if)h
Fr(name)38 b Fu(is)33 b(an)f(alias,)j(shell)e(function,)630
1996 y(shell)i(builtin,)g(disk)g(\014le,)h(or)e(shell)h(reserv)m(ed)g
(w)m(ord,)h(resp)s(ectiv)m(ely)-8 b(.)55 b(If)34 b(the)h
Fr(name)40 b Fu(is)35 b(not)630 2105 y(found,)29 b(then)h(nothing)h(is)
f(prin)m(ted,)g(and)g Ft(type)f Fu(returns)g(a)i(failure)g(status.)630
2240 y(If)25 b(the)g Ft(-p)g Fu(option)h(is)f(used,)h
Ft(type)e Fu(either)h(returns)g(the)g(name)g(of)h(the)f(disk)g(\014le)g
(that)h(w)m(ould)630 2349 y(b)s(e)k(executed,)h(or)g(nothing)f(if)g
b(Shell)30 b(Builtin)h(Commands)2069 b(59)150 299 y Ft(readarray)870
408 y(readarray)45 b([-d)i Fj(delim)p Ft(])f([-n)h Fj(count)p
Ft(])f([-O)h Fj(origin)p Ft(])f([-s)h Fj(count)p Ft(])f([-t])h([-u)g
Fj(fd)p Ft(])1061 518 y([-C)g Fj(callback)p Ft(])e([-c)i
Fj(quantum)p Ft(])f([)p Fj(array)p Ft(])630 650 y Fu(Read)38
b(lines)f(from)g(the)h(standard)e(input)g(in)m(to)j(the)e(indexed)g
(arra)m(y)h(v)-5 b(ariable)38 b Fr(arra)m(y)p Fu(,)i(or)630
760 y(from)30 b(\014le)g(descriptor)h Fr(fd)i Fu(if)d(the)h
Ft(-u)e Fu(option)i(is)g(supplied.)630 892 y(A)f(synon)m(ym)g(for)g
Ft(mapfile)p Fu(.)150 1047 y Ft(source)870 1179 y(source)46
b Fj(filename)630 1312 y Fu(A)30 b(synon)m(ym)g(for)g
Ft(.)g Fu(\(see)i(Section)f(4.1)g([Bourne)g(Shell)f(Builtins],)h(page)g
(43\).)150 1467 y Ft(type)870 1599 y(type)47 b([-afptP])e([)p
Fj(name)i Ft(...)o(])630 1731 y Fu(F)-8 b(or)42 b(eac)m(h)g
Fr(name)p Fu(,)i(indicate)e(ho)m(w)g(it)f(w)m(ould)g(b)s(e)g(in)m
(terpreted)g(if)g(used)f(as)i(a)f(command)630 1841 y(name.)630
1973 y(If)g(the)g Ft(-t)g Fu(option)h(is)f(used,)j Ft(type)c
Fu(prin)m(ts)h(a)h(single)g(w)m(ord)f(whic)m(h)g(is)g(one)h(of)g(`)p
Ft(alias)p Fu(',)630 2083 y(`)p Ft(function)p Fu(',)32
b(`)p Ft(builtin)p Fu(',)g(`)p Ft(file)p Fu(')g(or)h(`)p
Ft(keyword)p Fu(',)f(if)h Fr(name)38 b Fu(is)33 b(an)f(alias,)j(shell)e
(function,)630 2192 y(shell)i(builtin,)g(disk)g(\014le,)h(or)e(shell)h
(reserv)m(ed)g(w)m(ord,)h(resp)s(ectiv)m(ely)-8 b(.)55
b(If)34 b(the)h Fr(name)40 b Fu(is)35 b(not)630 2302
y(found,)29 b(then)h(nothing)h(is)f(prin)m(ted,)g(and)g
Ft(type)f Fu(returns)g(a)i(failure)g(status.)630 2434
y(If)25 b(the)g Ft(-p)g Fu(option)h(is)f(used,)h Ft(type)e
Fu(either)h(returns)g(the)g(name)g(of)h(the)f(disk)g(\014le)g(that)h(w)
m(ould)630 2544 y(b)s(e)k(executed,)h(or)g(nothing)f(if)g
Ft(-t)g Fu(w)m(ould)g(not)h(return)e(`)p Ft(file)p Fu('.)630
2484 y(The)h Ft(-P)g Fu(option)h(forces)g(a)g(path)f(searc)m(h)h(for)g
2676 y(The)h Ft(-P)g Fu(option)h(forces)g(a)g(path)f(searc)m(h)h(for)g
(eac)m(h)g Fr(name)p Fu(,)g(ev)m(en)g(if)g Ft(-t)f Fu(w)m(ould)g(not)h
(return)630 2593 y(`)p Ft(file)p Fu('.)630 2728 y(If)f(a)g(command)g
(return)630 2785 y(`)p Ft(file)p Fu('.)630 2918 y(If)f(a)g(command)g
(is)g(hashed,)f Ft(-p)h Fu(and)f Ft(-P)g Fu(prin)m(t)h(the)g(hashed)f
(v)-5 b(alue,)31 b(whic)m(h)f(is)g(not)g(neces-)630 2837
(v)-5 b(alue,)31 b(whic)m(h)f(is)g(not)g(neces-)630 3027
y(sarily)h(the)f(\014le)h(that)g(app)s(ears)e(\014rst)h(in)g
Ft($PATH)p Fu(.)630 2971 y(If)22 b(the)i Ft(-a)e Fu(option)h(is)g
Ft($PATH)p Fu(.)630 3160 y(If)22 b(the)i Ft(-a)e Fu(option)h(is)g
(used,)h Ft(type)e Fu(returns)f(all)j(of)f(the)g(places)h(that)f(con)m
(tain)i(an)d(executable)630 3081 y(named)32 b Fr(\014le)p
(tain)i(an)d(executable)630 3269 y(named)32 b Fr(\014le)p
Fu(.)49 b(This)32 b(includes)h(aliases)h(and)e(functions,)i(if)f(and)f
(only)h(if)g(the)g Ft(-p)f Fu(option)i(is)630 3191 y(not)d(also)g
(used.)630 3325 y(If)f(the)g Ft(-f)g Fu(option)g(is)h(used,)e
(only)h(if)g(the)g Ft(-p)f Fu(option)i(is)630 3379 y(not)d(also)g
(used.)630 3511 y(If)f(the)g Ft(-f)g Fu(option)g(is)h(used,)e
Ft(type)g Fu(do)s(es)h(not)h(attempt)g(to)g(\014nd)d(shell)j
(functions,)f(as)g(with)630 3435 y(the)h Ft(command)d
Fu(builtin.)630 3569 y(The)j(return)f(status)h(is)g(zero)h(if)f(all)h
(functions,)f(as)g(with)630 3621 y(the)h Ft(command)d
Fu(builtin.)630 3753 y(The)j(return)f(status)h(is)g(zero)h(if)f(all)h
(of)f(the)h Fr(names)i Fu(are)e(found,)e(non-zero)i(if)f(an)m(y)g(are)h
(not)630 3678 y(found.)150 3838 y Ft(typeset)870 3972
(not)630 3862 y(found.)150 4017 y Ft(typeset)870 4150
y(typeset)46 b([-afFgrxilnrtux])d([-p])k([)p Fj(name)p
Ft([=)p Fj(value)p Ft(])d(...)o(])630 4106 y Fu(The)31
Ft([=)p Fj(value)p Ft(])d(...)o(])630 4282 y Fu(The)31
b Ft(typeset)e Fu(command)i(is)g(supplied)f(for)h(compatibilit)m(y)i
(with)e(the)g(Korn)f(shell.)44 b(It)31 b(is)630 4216
(with)e(the)g(Korn)f(shell.)44 b(It)31 b(is)630 4391
y(a)g(synon)m(ym)f(for)g(the)g Ft(declare)f Fu(builtin)h(command.)150
4375 y Ft(ulimit)870 4509 y(ulimit)46 b([-HSabcdefiklmnpqrstuvxPT)o(])c
([)p Fj(limit)p Ft(])630 4644 y(ulimit)25 b Fu(pro)m(vides)h(con)m
4546 y Ft(ulimit)870 4679 y(ulimit)46 b([-HSabcdefiklmnpqrstuvxPT)o(])c
([)p Fj(limit)p Ft(])630 4811 y(ulimit)25 b Fu(pro)m(vides)h(con)m
(trol)i(o)m(v)m(er)g(the)f(resources)f(a)m(v)-5 b(ailable)29
b(to)e(pro)s(cesses)f(started)h(b)m(y)g(the)630 4753
b(to)e(pro)s(cesses)f(started)h(b)m(y)g(the)630 4921
y(shell,)i(on)f(systems)g(that)h(allo)m(w)h(suc)m(h)e(con)m(trol.)41
b(If)28 b(an)g(option)h(is)f(giv)m(en,)i(it)e(is)h(in)m(terpreted)630
4863 y(as)i(follo)m(ws:)630 5022 y Ft(-S)384 b Fu(Change)30
5030 y(as)i(follo)m(ws:)630 5185 y Ft(-S)384 b Fu(Change)30
b(and)g(rep)s(ort)g(the)g(soft)h(limit)g(asso)s(ciated)h(with)e(a)h
(resource.)630 5181 y Ft(-H)384 b Fu(Change)30 b(and)g(rep)s(ort)g(the)
g(hard)g(limit)h(asso)s(ciated)h(with)e(a)h(resource.)630
5340 y Ft(-a)384 b Fu(All)31 b(curren)m(t)f(limits)h(are)g(rep)s
(orted.)p eop end
(resource.)630 5340 y Ft(-H)384 b Fu(Change)30 b(and)g(rep)s(ort)g(the)
g(hard)g(limit)h(asso)s(ciated)h(with)e(a)h(resource.)p
eop end
%%Page: 60 66
TeXDict begin 60 65 bop 150 -116 a Fu(Chapter)30 b(4:)41
b(Shell)30 b(Builtin)h(Commands)2069 b(60)630 299 y Ft(-b)384
b Fu(The)30 b(maxim)m(um)g(so)s(c)m(k)m(et)i(bu\013er)e(size.)630
462 y Ft(-c)384 b Fu(The)30 b(maxim)m(um)g(size)h(of)g(core)g(\014les)f
(created.)630 625 y Ft(-d)384 b Fu(The)30 b(maxim)m(um)g(size)h(of)g(a)
g(pro)s(cess's)f(data)h(segmen)m(t.)630 788 y Ft(-e)384
b Fu(The)30 b(maxim)m(um)g(sc)m(heduling)h(priorit)m(y)f(\()p
Ft(")p Fu(nice)p Ft(")p Fu(\).)630 951 y Ft(-f)384 b
Fu(The)30 b(maxim)m(um)g(size)h(of)g(\014les)f(written)h(b)m(y)f(the)g
(shell)h(and)f(its)h(c)m(hildren.)630 1114 y Ft(-i)384
b(Shell)30 b(Builtin)h(Commands)2069 b(60)630 299 y Ft(-a)384
b Fu(All)31 b(curren)m(t)f(limits)h(are)g(rep)s(orted.)630
454 y Ft(-b)384 b Fu(The)30 b(maxim)m(um)g(so)s(c)m(k)m(et)i(bu\013er)e
(size.)630 610 y Ft(-c)384 b Fu(The)30 b(maxim)m(um)g(size)h(of)g(core)
g(\014les)f(created.)630 765 y Ft(-d)384 b Fu(The)30
b(maxim)m(um)g(size)h(of)g(a)g(pro)s(cess's)f(data)h(segmen)m(t.)630
921 y Ft(-e)384 b Fu(The)30 b(maxim)m(um)g(sc)m(heduling)h(priorit)m(y)
f(\()p Ft(")p Fu(nice)p Ft(")p Fu(\).)630 1076 y Ft(-f)384
b Fu(The)30 b(maxim)m(um)g(size)h(of)g(\014les)f(written)h(b)m(y)f(the)
g(shell)h(and)f(its)h(c)m(hildren.)630 1232 y Ft(-i)384
b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(p)s(ending)e
(signals.)630 1277 y Ft(-k)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s
(signals.)630 1387 y Ft(-k)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s
(er)f(of)i(kqueues)f(that)h(ma)m(y)g(b)s(e)e(allo)s(cated.)630
1440 y Ft(-l)384 b Fu(The)30 b(maxim)m(um)g(size)h(that)g(ma)m(y)g(b)s
(e)f(lo)s(c)m(k)m(ed)i(in)m(to)f(memory)-8 b(.)630 1603
1543 y Ft(-l)384 b Fu(The)30 b(maxim)m(um)g(size)h(that)g(ma)m(y)g(b)s
(e)f(lo)s(c)m(k)m(ed)i(in)m(to)f(memory)-8 b(.)630 1698
y Ft(-m)384 b Fu(The)36 b(maxim)m(um)g(residen)m(t)h(set)g(size)g
(\(man)m(y)g(systems)f(do)h(not)f(honor)g(this)1110 1713
y(limit\).)630 1876 y Ft(-n)384 b Fu(The)38 b(maxim)m(um)h(n)m(um)m(b)s
(\(man)m(y)g(systems)f(do)h(not)f(honor)g(this)1110 1808
y(limit\).)630 1963 y Ft(-n)384 b Fu(The)38 b(maxim)m(um)h(n)m(um)m(b)s
(er)e(of)i(op)s(en)f(\014le)h(descriptors)g(\(most)g(systems)g(do)1110
1985 y(not)31 b(allo)m(w)g(this)g(v)-5 b(alue)31 b(to)g(b)s(e)e(set\).)
630 2149 y Ft(-p)384 b Fu(The)30 b(pip)s(e)f(bu\013er)h(size.)630
2312 y Ft(-q)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(b)m
(ytes)g(in)f(POSIX)f(message)j(queues.)630 2475 y Ft(-r)384
2073 y(not)31 b(allo)m(w)g(this)g(v)-5 b(alue)31 b(to)g(b)s(e)e(set\).)
630 2228 y Ft(-p)384 b Fu(The)30 b(pip)s(e)f(bu\013er)h(size.)630
2384 y Ft(-q)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(b)m
(ytes)g(in)f(POSIX)f(message)j(queues.)630 2539 y Ft(-r)384
b Fu(The)30 b(maxim)m(um)g(real-time)i(sc)m(heduling)f(priorit)m(y)-8
b(.)630 2638 y Ft(-s)384 b Fu(The)30 b(maxim)m(um)g(stac)m(k)i(size.)
630 2801 y Ft(-t)384 b Fu(The)30 b(maxim)m(um)g(amoun)m(t)h(of)f(cpu)g
(time)h(in)f(seconds.)630 2964 y Ft(-u)384 b Fu(The)30
b(.)630 2695 y Ft(-s)384 b Fu(The)30 b(maxim)m(um)g(stac)m(k)i(size.)
630 2850 y Ft(-t)384 b Fu(The)30 b(maxim)m(um)g(amoun)m(t)h(of)f(cpu)g
(time)h(in)f(seconds.)630 3005 y Ft(-u)384 b Fu(The)30
b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(pro)s(cesses)f(a)m(v)-5
b(ailable)33 b(to)e(a)f(single)i(user.)630 3127 y Ft(-v)384
b(ailable)33 b(to)e(a)f(single)i(user.)630 3161 y Ft(-v)384
b Fu(The)41 b(maxim)m(um)h(amoun)m(t)g(of)h(virtual)f(memory)g(a)m(v)-5
b(ailable)44 b(to)e(the)g(shell,)1110 3236 y(and,)30
b(ailable)44 b(to)e(the)g(shell,)1110 3271 y(and,)30
b(on)g(some)h(systems,)g(to)g(its)g(c)m(hildren.)630
3399 y Ft(-x)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i
(\014le)f(lo)s(c)m(ks.)630 3562 y Ft(-P)384 b Fu(The)30
3426 y Ft(-x)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i
(\014le)f(lo)s(c)m(ks.)630 3581 y Ft(-P)384 b Fu(The)30
b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i(pseudoterminals.)630
3726 y Ft(-T)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i
(threads.)630 3889 y(If)36 b Fr(limit)k Fu(is)c(giv)m(en,)k(and)c(the)h
3737 y Ft(-T)384 b Fu(The)30 b(maxim)m(um)g(n)m(um)m(b)s(er)f(of)i
(threads.)630 3892 y(If)36 b Fr(limit)k Fu(is)c(giv)m(en,)k(and)c(the)h
Ft(-a)f Fu(option)h(is)f(not)h(used,)h Fr(limit)h Fu(is)e(the)g(new)f
(v)-5 b(alue)37 b(of)g(the)630 3998 y(sp)s(eci\014ed)c(resource.)51
(v)-5 b(alue)37 b(of)g(the)630 4002 y(sp)s(eci\014ed)c(resource.)51
b(The)34 b(sp)s(ecial)g Fr(limit)j Fu(v)-5 b(alues)34
b Ft(hard)p Fu(,)g Ft(soft)p Fu(,)g(and)f Ft(unlimited)e
Fu(stand)630 4108 y(for)h(the)g(curren)m(t)g(hard)f(limit,)i(the)g
Fu(stand)630 4112 y(for)h(the)g(curren)m(t)g(hard)f(limit,)i(the)g
(curren)m(t)f(soft)g(limit,)h(and)f(no)g(limit,)h(resp)s(ectiv)m(ely)-8
b(.)48 b(A)630 4217 y(hard)37 b(limit)h(cannot)h(b)s(e)e(increased)h(b)
b(.)48 b(A)630 4221 y(hard)37 b(limit)h(cannot)h(b)s(e)e(increased)h(b)
m(y)f(a)h(non-ro)s(ot)g(user)f(once)i(it)f(is)g(set;)k(a)c(soft)g
(limit)630 4327 y(ma)m(y)j(b)s(e)e(increased)i(up)e(to)h(the)h(v)-5
(limit)630 4331 y(ma)m(y)j(b)s(e)e(increased)i(up)e(to)h(the)h(v)-5
b(alue)40 b(of)g(the)h(hard)e(limit.)70 b(Otherwise,)43
b(the)d(curren)m(t)630 4437 y(v)-5 b(alue)29 b(of)h(the)f(soft)g(limit)
b(the)d(curren)m(t)630 4440 y(v)-5 b(alue)29 b(of)h(the)f(soft)g(limit)
h(for)e(the)h(sp)s(eci\014ed)g(resource)g(is)g(prin)m(ted,)g(unless)f
(the)h Ft(-H)f Fu(option)630 4546 y(is)h(supplied.)39
(the)h Ft(-H)f Fu(option)630 4550 y(is)h(supplied.)39
b(When)29 b(setting)h(new)f(limits,)h(if)f(neither)g
Ft(-H)g Fu(nor)f Ft(-S)h Fu(is)g(supplied,)f(b)s(oth)h(the)630
4656 y(hard)i(and)h(soft)h(limits)g(are)f(set.)48 b(If)31
4660 y(hard)i(and)h(soft)h(limits)g(are)f(set.)48 b(If)31
b(no)i(option)f(is)h(giv)m(en,)h(then)e Ft(-f)g Fu(is)g(assumed.)46
b(V)-8 b(alues)630 4765 y(are)31 b(in)f(1024-b)m(yte)j(incremen)m(ts,)e
b(V)-8 b(alues)630 4769 y(are)31 b(in)f(1024-b)m(yte)j(incremen)m(ts,)e
(except)g(for)f Ft(-t)p Fu(,)g(whic)m(h)g(is)g(in)g(seconds;)h
Ft(-p)p Fu(,)f(whic)m(h)g(is)g(in)630 4875 y(units)h(of)g(512-b)m(yte)j
Ft(-p)p Fu(,)f(whic)m(h)g(is)g(in)630 4879 y(units)h(of)g(512-b)m(yte)j
(blo)s(c)m(ks;)e Ft(-P)p Fu(,)f Ft(-T)p Fu(,)h Ft(-b)p
Fu(,)f Ft(-k)p Fu(,)g Ft(-n)g Fu(and)f Ft(-u)p Fu(,)h(whic)m(h)h(are)f
(unscaled)g(v)-5 b(alues;)630 4984 y(and,)31 b(when)f(in)g
(unscaled)g(v)-5 b(alues;)630 4988 y(and,)31 b(when)f(in)g
Fm(posix)g Fu(Mo)s(de)h(\(see)h(Section)g(6.11)g([Bash)g(POSIX)e(Mo)s
(de],)h(page)h(98\),)h Ft(-c)630 5094 y Fu(and)d Ft(-f)p
(de],)h(page)h(98\),)h Ft(-c)630 5098 y Fu(and)d Ft(-f)p
Fu(,)g(whic)m(h)g(are)h(in)f(512-b)m(yte)i(incremen)m(ts.)630
5230 y(The)i(return)g(status)h(is)f(zero)i(unless)e(an)g(in)m(v)-5
b(alid)36 b(option)f(or)f(argumen)m(t)i(is)e(supplied,)h(or)630
@@ -12884,111 +12892,117 @@ b(If)41 b(an)m(y)g(jobs)f(are)i(running,)g(this)f(causes)1110
(command)f(\(see)h(Chapter)e(7)h([Job)g(Con)m(trol],)i(page)f(102\).)40
b(The)1110 2436 y(shell)31 b(alw)m(a)m(ys)g(p)s(ostp)s(ones)f(exiting)h
(if)g(an)m(y)f(jobs)g(are)h(stopp)s(ed.)630 2600 y Ft(checkwinsize)1110
2710 y Fu(If)41 b(set,)k(Bash)c(c)m(hec)m(ks)i(the)f(windo)m(w)e(size)j
(after)f(eac)m(h)g(command)f(and,)j(if)1110 2819 y(necessary)-8
b(,)31 b(up)s(dates)f(the)g(v)-5 b(alues)31 b(of)g Ft(LINES)e
Fu(and)g Ft(COLUMNS)p Fu(.)630 2984 y Ft(cmdhist)144
2710 y Fu(If)23 b(set,)j(Bash)e(c)m(hec)m(ks)h(the)f(windo)m(w)f(size)h
(after)h(eac)m(h)f(external)h(\(non-builtin\))1110 2819
y(command)55 b(and,)60 b(if)55 b(necessary)-8 b(,)62
b(up)s(dates)54 b(the)h(v)-5 b(alues)55 b(of)g Ft(LINES)f
Fu(and)1110 2929 y Ft(COLUMNS)p Fu(.)630 3093 y Ft(cmdhist)144
b Fu(If)33 b(set,)j(Bash)e(attempts)h(to)g(sa)m(v)m(e)g(all)g(lines)f
(of)g(a)h(m)m(ultiple-line)g(command)1110 3093 y(in)c(the)g(same)g
(of)g(a)h(m)m(ultiple-line)g(command)1110 3203 y(in)c(the)g(same)g
(history)g(en)m(try)-8 b(.)42 b(This)30 b(allo)m(ws)i(easy)g
(re-editing)g(of)f(m)m(ulti-line)1110 3203 y(commands.)630
3367 y Ft(compat31)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s
(eha)m(vior)f(to)i(that)f(of)f(v)m(ersion)h(3.1)h(with)e(resp)s(ect)
1110 3477 y(to)39 b(quoted)f(argumen)m(ts)g(to)h(the)f(conditional)h
(command's)f(`)p Ft(=~)p Fu(')g(op)s(erator)1110 3587
(re-editing)g(of)f(m)m(ulti-line)1110 3313 y(commands.)79
b(This)43 b(option)g(is)h(enabled)f(b)m(y)g(default,)k(but)c(only)g
(has)g(an)1110 3422 y(e\013ect)30 b(if)e(command)g(history)g(is)h
(enabled)f(\(see)h(Section)g(9.1)h([Bash)e(History)1110
3532 y(F)-8 b(acilities],)34 b(page)d(140\).)630 3696
y Ft(compat31)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s(eha)
m(vior)f(to)i(that)f(of)f(v)m(ersion)h(3.1)h(with)e(resp)s(ect)1110
3806 y(to)39 b(quoted)f(argumen)m(ts)g(to)h(the)f(conditional)h
(command's)f(`)p Ft(=~)p Fu(')g(op)s(erator)1110 3915
y(and)i(with)f(resp)s(ect)i(to)g(lo)s(cale-sp)s(eci\014c)h(string)e
(comparison)g(when)f(using)1110 3696 y(the)31 b Ft([[)e
(comparison)g(when)f(using)1110 4025 y(the)31 b Ft([[)e
Fu(conditional)j(command's)e(`)p Ft(<)p Fu(')h(and)f(`)p
Ft(>)p Fu(')g(op)s(erators.)41 b(Bash)31 b(v)m(ersions)1110
3806 y(prior)g(to)h(bash-4.1)g(use)g(ASCI)s(I)e(collation)j(and)e
(strcmp\(3\);)i(bash-4.1)g(and)1110 3915 y(later)e(use)f(the)h(curren)m
4134 y(prior)g(to)h(bash-4.1)g(use)g(ASCI)s(I)e(collation)j(and)e
(strcmp\(3\);)i(bash-4.1)g(and)1110 4244 y(later)e(use)f(the)h(curren)m
(t)f(lo)s(cale's)i(collation)h(sequence)e(and)f(strcoll\(3\).)630
4080 y Ft(compat32)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s
4408 y Ft(compat32)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s
(eha)m(vior)f(to)i(that)f(of)f(v)m(ersion)h(3.2)h(with)e(resp)s(ect)
1110 4189 y(to)34 b(lo)s(cale-sp)s(eci\014c)h(string)e(comparison)g
(when)f(using)h(the)g Ft([[)g Fu(conditional)1110 4299
1110 4518 y(to)34 b(lo)s(cale-sp)s(eci\014c)h(string)e(comparison)g
(when)f(using)h(the)g Ft([[)g Fu(conditional)1110 4628
y(command's)21 b(`)p Ft(<)p Fu(')g(and)f(`)p Ft(>)p Fu(')h(op)s
(erators)g(\(see)h(previous)e(item\))i(and)e(the)h(e\013ect)i(of)1110
4408 y(in)m(terrupting)h(a)h(command)e(list.)40 b(Bash)24
4737 y(in)m(terrupting)h(a)h(command)e(list.)40 b(Bash)24
b(v)m(ersions)h(3.2)g(and)f(earlier)h(con)m(tin)m(ue)1110
4518 y(with)33 b(the)g(next)g(command)g(in)g(the)g(list)h(after)f(one)h
(terminates)g(due)e(to)i(an)1110 4628 y(in)m(terrupt.)630
4792 y Ft(compat40)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s
4847 y(with)33 b(the)g(next)g(command)g(in)g(the)g(list)h(after)f(one)h
(terminates)g(due)e(to)i(an)1110 4956 y(in)m(terrupt.)630
5121 y Ft(compat40)96 b Fu(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s
(eha)m(vior)f(to)i(that)f(of)f(v)m(ersion)h(4.0)h(with)e(resp)s(ect)
1110 4902 y(to)34 b(lo)s(cale-sp)s(eci\014c)h(string)e(comparison)g
(when)f(using)h(the)g Ft([[)g Fu(conditional)1110 5011
1110 5230 y(to)34 b(lo)s(cale-sp)s(eci\014c)h(string)e(comparison)g
(when)f(using)h(the)g Ft([[)g Fu(conditional)1110 5340
y(command's)28 b(`)p Ft(<)p Fu(')h(and)f(`)p Ft(>)p Fu(')h(op)s
(erators)f(\(see)i(description)e(of)h Ft(compat31)p Fu(\))e(and)1110
5121 y(the)38 b(e\013ect)i(of)e(in)m(terrupting)f(a)i(command)e(list.)
64 b(Bash)38 b(v)m(ersions)h(4.0)g(and)1110 5230 y(later)24
b(in)m(terrupt)f(the)g(list)h(as)g(if)f(the)h(shell)f(receiv)m(ed)i
(the)e(in)m(terrupt;)i(previous)1110 5340 y(v)m(ersions)31
b(con)m(tin)m(ue)g(with)f(the)h(next)g(command)f(in)g(the)g(list.)p
(erators)f(\(see)i(description)e(of)h Ft(compat31)p Fu(\))e(and)p
eop end
%%Page: 67 73
TeXDict begin 67 72 bop 150 -116 a Fu(Chapter)30 b(4:)41
b(Shell)30 b(Builtin)h(Commands)2069 b(67)630 299 y Ft(compat41)96
b Fu(If)25 b(set,)j(Bash,)e(when)f(in)g Fm(posix)g Fu(mo)s(de,)i
(treats)f(a)g(single)h(quote)f(in)f(a)h(double-)1110
408 y(quoted)46 b(parameter)h(expansion)f(as)g(a)h(sp)s(ecial)f(c)m
(haracter.)90 b(The)45 b(single)1110 518 y(quotes)34
b(m)m(ust)g(matc)m(h)h(\(an)f(ev)m(en)h(n)m(um)m(b)s(er\))e(and)g(the)h
(c)m(haracters)h(b)s(et)m(w)m(een)1110 628 y(the)40 b(single)g(quotes)g
(are)g(considered)g(quoted.)69 b(This)38 b(is)i(the)g(b)s(eha)m(vior)g
(of)1110 737 y Fm(posix)f Fu(mo)s(de)g(through)g(v)m(ersion)h(4.1.)69
b(Shell)30 b(Builtin)h(Commands)2069 b(67)1110 299 y(the)38
b(e\013ect)i(of)e(in)m(terrupting)f(a)i(command)e(list.)64
b(Bash)38 b(v)m(ersions)h(4.0)g(and)1110 408 y(later)24
b(in)m(terrupt)f(the)g(list)h(as)g(if)f(the)h(shell)f(receiv)m(ed)i
(the)e(in)m(terrupt;)i(previous)1110 518 y(v)m(ersions)31
b(con)m(tin)m(ue)g(with)f(the)h(next)g(command)f(in)g(the)g(list.)630
669 y Ft(compat41)96 b Fu(If)25 b(set,)j(Bash,)e(when)f(in)g
Fm(posix)g Fu(mo)s(de,)i(treats)f(a)g(single)h(quote)f(in)f(a)h
(double-)1110 778 y(quoted)46 b(parameter)h(expansion)f(as)g(a)h(sp)s
(ecial)f(c)m(haracter.)90 b(The)45 b(single)1110 888
y(quotes)34 b(m)m(ust)g(matc)m(h)h(\(an)f(ev)m(en)h(n)m(um)m(b)s(er\))e
(and)g(the)h(c)m(haracters)h(b)s(et)m(w)m(een)1110 998
y(the)40 b(single)g(quotes)g(are)g(considered)g(quoted.)69
b(This)38 b(is)i(the)g(b)s(eha)m(vior)g(of)1110 1107
y Fm(posix)f Fu(mo)s(de)g(through)g(v)m(ersion)h(4.1.)69
b(The)39 b(default)g(Bash)h(b)s(eha)m(vior)g(re-)1110
847 y(mains)30 b(as)h(in)f(previous)g(v)m(ersions.)630
1050 y Ft(compat42)96 b Fu(If)29 b(set,)i(Bash)f(do)s(es)f(not)h(pro)s
1217 y(mains)30 b(as)h(in)f(previous)g(v)m(ersions.)630
1367 y Ft(compat42)96 b Fu(If)29 b(set,)i(Bash)f(do)s(es)f(not)h(pro)s
(cess)g(the)g(replacemen)m(t)h(string)e(in)h(the)g(pattern)1110
1160 y(substitution)g(w)m(ord)g(expansion)g(using)g(quote)h(remo)m(v)-5
b(al.)630 1363 y Ft(compat43)96 b Fu(If)24 b(set,)j(Bash)e(do)s(es)g
1477 y(substitution)g(w)m(ord)g(expansion)g(using)g(quote)h(remo)m(v)-5
b(al.)630 1628 y Ft(compat43)96 b Fu(If)24 b(set,)j(Bash)e(do)s(es)g
(not)g(prin)m(t)g(a)g(w)m(arning)g(message)h(if)f(an)g(attempt)h(is)f
(made)1110 1473 y(to)43 b(use)g(a)g(quoted)f(comp)s(ound)f(arra)m(y)i
(assignmen)m(t)h(as)f(an)f(argumen)m(t)h(to)1110 1583
(made)1110 1737 y(to)43 b(use)g(a)g(quoted)f(comp)s(ound)f(arra)m(y)i
(assignmen)m(t)h(as)f(an)f(argumen)m(t)h(to)1110 1847
y Ft(declare)p Fu(,)31 b(mak)m(es)i(w)m(ord)f(expansion)g(errors)g
(non-fatal)i(errors)d(that)i(cause)1110 1692 y(the)28
(non-fatal)i(errors)d(that)i(cause)1110 1956 y(the)28
b(curren)m(t)h(command)f(to)h(fail)g(\(the)f(default)h(b)s(eha)m(vior)f
(is)h(to)g(mak)m(e)g(them)1110 1802 y(fatal)42 b(errors)e(that)i(cause)
(is)h(to)g(mak)m(e)g(them)1110 2066 y(fatal)42 b(errors)e(that)i(cause)
f(the)h(shell)f(to)g(exit\),)k(and)c(do)s(es)f(not)h(reset)h(the)1110
1911 y(lo)s(op)34 b(state)h(when)f(a)g(shell)g(function)g(is)g
2176 y(lo)s(op)34 b(state)h(when)f(a)g(shell)g(function)g(is)g
(executed)h(\(this)f(allo)m(ws)h Ft(break)e Fu(or)1110
2021 y Ft(continue)25 b Fu(in)j(a)g(shell)g(function)f(to)i(a\013ect)g
(lo)s(ops)f(in)f(the)h(caller's)h(con)m(text\).)630 2225
y Ft(complete_fullquote)1110 2334 y Fu(If)i(set,)g(Bash)h(quotes)f(all)
2285 y Ft(continue)25 b Fu(in)j(a)g(shell)g(function)f(to)i(a\013ect)g
(lo)s(ops)f(in)f(the)h(caller's)h(con)m(text\).)630 2436
y Ft(complete_fullquote)1110 2545 y Fu(If)i(set,)g(Bash)h(quotes)f(all)
h(shell)f(metac)m(haracters)i(in)e(\014lenames)g(and)g(direc-)1110
2444 y(tory)g(names)f(when)g(p)s(erforming)f(completion.)43
b(If)30 b(not)h(set,)g(Bash)g(remo)m(v)m(es)1110 2553
2655 y(tory)g(names)f(when)g(p)s(erforming)f(completion.)43
b(If)30 b(not)h(set,)g(Bash)g(remo)m(v)m(es)1110 2765
y(metac)m(haracters)40 b(suc)m(h)d(as)h(the)g(dollar)g(sign)g(from)f
(the)h(set)g(of)f(c)m(haracters)1110 2663 y(that)f(will)g(b)s(e)f
(the)h(set)g(of)f(c)m(haracters)1110 2874 y(that)f(will)g(b)s(e)f
(quoted)g(in)g(completed)i(\014lenames)e(when)f(these)i(metac)m(har-)
1110 2772 y(acters)29 b(app)s(ear)e(in)g(shell)h(v)-5
1110 2984 y(acters)29 b(app)s(ear)e(in)g(shell)h(v)-5
b(ariable)28 b(references)g(in)f(w)m(ords)g(to)i(b)s(e)e(completed.)
1110 2882 y(This)k(means)i(that)g(dollar)f(signs)g(in)g(v)-5
1110 3093 y(This)k(means)i(that)g(dollar)f(signs)g(in)g(v)-5
b(ariable)33 b(names)g(that)f(expand)g(to)h(di-)1110
2992 y(rectories)28 b(will)g(not)f(b)s(e)f(quoted;)j(ho)m(w)m(ev)m(er,)
g(an)m(y)e(dollar)h(signs)f(app)s(earing)f(in)1110 3101
3203 y(rectories)28 b(will)g(not)f(b)s(e)f(quoted;)j(ho)m(w)m(ev)m(er,)
g(an)m(y)e(dollar)h(signs)f(app)s(earing)f(in)1110 3313
y(\014lenames)j(will)h(not)f(b)s(e)g(quoted,)h(either.)41
b(This)28 b(is)i(activ)m(e)h(only)e(when)g(bash)1110
3211 y(is)39 b(using)f(bac)m(kslashes)i(to)g(quote)g(completed)f
(\014lenames.)67 b(This)38 b(v)-5 b(ariable)1110 3320
3422 y(is)39 b(using)f(bac)m(kslashes)i(to)g(quote)g(completed)f
(\014lenames.)67 b(This)38 b(v)-5 b(ariable)1110 3532
y(is)41 b(set)g(b)m(y)g(default,)j(whic)m(h)c(is)h(the)g(default)g
(Bash)g(b)s(eha)m(vior)g(in)g(v)m(ersions)1110 3430 y(through)30
b(4.2.)630 3634 y Ft(direxpand)1110 3743 y Fu(If)k(set,)i(Bash)f
(Bash)g(b)s(eha)m(vior)g(in)g(v)m(ersions)1110 3641 y(through)30
b(4.2.)630 3792 y Ft(direxpand)1110 3902 y Fu(If)k(set,)i(Bash)f
(replaces)g(directory)g(names)g(with)f(the)g(results)h(of)f(w)m(ord)g
(ex-)1110 3853 y(pansion)k(when)g(p)s(erforming)f(\014lename)i
(completion.)67 b(This)38 b(c)m(hanges)i(the)1110 3962
(ex-)1110 4011 y(pansion)k(when)g(p)s(erforming)f(\014lename)i
(completion.)67 b(This)38 b(c)m(hanges)i(the)1110 4121
y(con)m(ten)m(ts)29 b(of)e(the)g(readline)h(editing)g(bu\013er.)38
b(If)27 b(not)g(set,)i(Bash)e(attempts)h(to)1110 4072
b(If)27 b(not)g(set,)i(Bash)e(attempts)h(to)1110 4230
y(preserv)m(e)j(what)f(the)g(user)g(t)m(yp)s(ed.)630
4275 y Ft(dirspell)96 b Fu(If)26 b(set,)i(Bash)f(attempts)g(sp)s
4381 y Ft(dirspell)96 b Fu(If)26 b(set,)i(Bash)f(attempts)g(sp)s
(elling)g(correction)g(on)g(directory)g(names)f(during)1110
4385 y(w)m(ord)36 b(completion)h(if)f(the)g(directory)g(name)g
(initially)h(supplied)e(do)s(es)h(not)1110 4495 y(exist.)630
4698 y Ft(dotglob)144 b Fu(If)36 b(set,)i(Bash)e(includes)g
4491 y(w)m(ord)36 b(completion)h(if)f(the)g(directory)g(name)g
(initially)h(supplied)e(do)s(es)h(not)1110 4600 y(exist.)630
4751 y Ft(dotglob)144 b Fu(If)36 b(set,)i(Bash)e(includes)g
(\014lenames)g(b)s(eginning)f(with)h(a)g(`.')58 b(in)36
b(the)g(results)1110 4808 y(of)f(\014lename)f(expansion.)53
b(the)g(results)1110 4861 y(of)f(\014lename)f(expansion.)53
b(The)33 b(\014lenames)i(`)p Ft(.)p Fu(')f(and)g(`)p
Ft(..)p Fu(')g(m)m(ust)h(alw)m(a)m(ys)h(b)s(e)1110 4917
Ft(..)p Fu(')g(m)m(ust)h(alw)m(a)m(ys)h(b)s(e)1110 4970
y(matc)m(hed)31 b(explicitly)-8 b(,)33 b(ev)m(en)e(if)f
Ft(dotglob)f Fu(is)h(set.)630 5121 y Ft(execfail)96 b
Fu(If)24 b(this)h(is)f(set,)j(a)e(non-in)m(teractiv)m(e)i(shell)e(will)
@@ -13126,95 +13140,100 @@ Ft(cmdhist)e Fu(option)j(is)f(enabled,)i(m)m(ulti-line)f(commands)1110
b(separators)f(where)e(p)s(ossible.)p eop end
%%Page: 70 76
TeXDict begin 70 75 bop 150 -116 a Fu(Chapter)30 b(4:)41
b(Shell)30 b(Builtin)h(Commands)2069 b(70)630 299 y Ft(login_shell)1110
408 y Fu(The)35 b(shell)h(sets)g(this)f(option)h(if)g(it)g(is)f
(started)h(as)g(a)g(login)g(shell)g(\(see)g(Sec-)1110
518 y(tion)29 b(6.1)g([In)m(v)m(oking)h(Bash],)f(page)g(84\).)41
b(The)28 b(v)-5 b(alue)29 b(ma)m(y)g(not)f(b)s(e)g(c)m(hanged.)630
682 y Ft(mailwarn)96 b Fu(If)34 b(set,)i(and)e(a)h(\014le)g(that)g
b(Shell)30 b(Builtin)h(Commands)2069 b(70)630 299 y Ft
(localvar_inherit)1110 408 y Fu(If)32 b(set,)h(lo)s(cal)g(v)-5
b(ariables)33 b(inherit)f(the)g(v)-5 b(alue)32 b(and)g(attributes)h(of)
f(a)g(v)-5 b(ariable)1110 518 y(of)36 b(the)g(same)g(name)g(that)h
(exists)f(at)h(a)f(previous)g(scop)s(e)g(b)s(efore)f(an)m(y)h(new)1110
628 y(v)-5 b(alue)31 b(is)f(assigned.)41 b(The)30 b Fr(nameref)48
b Fu(attribute)31 b(is)f(not)h(inherited.)630 792 y Ft(login_shell)1110
902 y Fu(The)k(shell)h(sets)g(this)f(option)h(if)g(it)g(is)f(started)h
(as)g(a)g(login)g(shell)g(\(see)g(Sec-)1110 1011 y(tion)29
b(6.1)g([In)m(v)m(oking)h(Bash],)f(page)g(84\).)41 b(The)28
b(v)-5 b(alue)29 b(ma)m(y)g(not)f(b)s(e)g(c)m(hanged.)630
1176 y Ft(mailwarn)96 b Fu(If)34 b(set,)i(and)e(a)h(\014le)g(that)g
(Bash)f(is)h(c)m(hec)m(king)h(for)f(mail)g(has)f(b)s(een)g(accessed)
1110 792 y(since)24 b(the)h(last)g(time)f(it)h(w)m(as)f(c)m(hec)m(k)m
1110 1285 y(since)24 b(the)h(last)g(time)f(it)h(w)m(as)f(c)m(hec)m(k)m
(ed,)k(the)c(message)h Ft("The)k(mail)h(in)f Fj(mail-)1110
902 y(file)g Ft(has)h(been)f(read")g Fu(is)h(displa)m(y)m(ed.)630
1066 y Ft(no_empty_cmd_completion)1110 1176 y Fu(If)g(set,)g(and)g
1395 y(file)g Ft(has)h(been)f(read")g Fu(is)h(displa)m(y)m(ed.)630
1559 y Ft(no_empty_cmd_completion)1110 1669 y Fu(If)g(set,)g(and)g
(Readline)g(is)h(b)s(eing)e(used,)h(Bash)g(will)g(not)g(attempt)i(to)e
(searc)m(h)1110 1285 y(the)25 b Ft(PATH)f Fu(for)h(p)s(ossible)f
(searc)m(h)1110 1778 y(the)25 b Ft(PATH)f Fu(for)h(p)s(ossible)f
(completions)j(when)d(completion)i(is)f(attempted)h(on)1110
1395 y(an)k(empt)m(y)h(line.)630 1559 y Ft(nocaseglob)1110
1669 y Fu(If)38 b(set,)k(Bash)d(matc)m(hes)g(\014lenames)g(in)f(a)h
(case-insensitiv)m(e)j(fashion)c(when)1110 1778 y(p)s(erforming)29
b(\014lename)i(expansion.)630 1943 y Ft(nocasematch)1110
2052 y Fu(If)42 b(set,)k(Bash)d(matc)m(hes)g(patterns)g(in)f(a)h
(case-insensitiv)m(e)i(fashion)d(when)1110 2162 y(p)s(erforming)31
1888 y(an)k(empt)m(y)h(line.)630 2052 y Ft(nocaseglob)1110
2162 y Fu(If)38 b(set,)k(Bash)d(matc)m(hes)g(\014lenames)g(in)f(a)h
(case-insensitiv)m(e)j(fashion)c(when)1110 2271 y(p)s(erforming)29
b(\014lename)i(expansion.)630 2436 y Ft(nocasematch)1110
2545 y Fu(If)42 b(set,)k(Bash)d(matc)m(hes)g(patterns)g(in)f(a)h
(case-insensitiv)m(e)i(fashion)d(when)1110 2655 y(p)s(erforming)31
b(matc)m(hing)i(while)f(executing)i Ft(case)d Fu(or)h
Ft([[)g Fu(conditional)h(com-)1110 2271 y(mands,)d(when)g(p)s
Ft([[)g Fu(conditional)h(com-)1110 2765 y(mands,)d(when)g(p)s
(erforming)g(pattern)h(substitution)g(w)m(ord)g(expansions,)g(or)1110
2381 y(when)g(\014ltering)i(p)s(ossible)f(completions)h(as)g(part)f(of)
h(programmable)f(com-)1110 2491 y(pletion.)630 2655 y
2874 y(when)g(\014ltering)i(p)s(ossible)f(completions)h(as)g(part)f(of)
h(programmable)f(com-)1110 2984 y(pletion.)630 3148 y
Ft(nullglob)96 b Fu(If)23 b(set,)j(Bash)e(allo)m(ws)g(\014lename)g
(patterns)g(whic)m(h)f(matc)m(h)h(no)g(\014les)f(to)i(expand)1110
2765 y(to)31 b(a)g(n)m(ull)f(string,)h(rather)f(than)g(themselv)m(es.)
630 2929 y Ft(progcomp)96 b Fu(If)25 b(set,)i(the)f(programmable)g
3258 y(to)31 b(a)g(n)m(ull)f(string,)h(rather)f(than)g(themselv)m(es.)
630 3422 y Ft(progcomp)96 b Fu(If)25 b(set,)i(the)f(programmable)g
(completion)g(facilities)i(\(see)f(Section)f(8.6)h([Pro-)1110
3039 y(grammable)45 b(Completion],)k(page)c(131\))h(are)f(enabled.)82
b(This)44 b(option)h(is)1110 3148 y(enabled)30 b(b)m(y)h(default.)630
3313 y Ft(promptvars)1110 3422 y Fu(If)50 b(set,)56 b(prompt)49
3532 y(grammable)45 b(Completion],)k(page)c(131\))h(are)f(enabled.)82
b(This)44 b(option)h(is)1110 3641 y(enabled)30 b(b)m(y)h(default.)630
3806 y Ft(promptvars)1110 3915 y Fu(If)50 b(set,)56 b(prompt)49
b(strings)h(undergo)g(parameter)h(expansion,)k(command)1110
3532 y(substitution,)35 b(arithmetic)g(expansion,)g(and)e(quote)i(remo)
m(v)-5 b(al)35 b(after)f(b)s(eing)1110 3641 y(expanded)53
4025 y(substitution,)35 b(arithmetic)g(expansion,)g(and)e(quote)i(remo)
m(v)-5 b(al)35 b(after)f(b)s(eing)1110 4134 y(expanded)53
b(as)h(describ)s(ed)e(b)s(elo)m(w)i(\(see)h(Section)f(6.9)h([Con)m
(trolling)g(the)1110 3751 y(Prompt],)30 b(page)h(96\).)42
(trolling)g(the)1110 4244 y(Prompt],)30 b(page)h(96\).)42
b(This)30 b(option)h(is)f(enabled)h(b)m(y)f(default.)630
3915 y Ft(restricted_shell)1110 4025 y Fu(The)40 b(shell)h(sets)g(this)
4408 y Ft(restricted_shell)1110 4518 y Fu(The)40 b(shell)h(sets)g(this)
g(option)g(if)g(it)h(is)e(started)i(in)e(restricted)i(mo)s(de)e(\(see)
1110 4134 y(Section)c(6.10)g([The)f(Restricted)g(Shell],)i(page)e
1110 4628 y(Section)c(6.10)g([The)f(Restricted)g(Shell],)i(page)e
(97\).)56 b(The)34 b(v)-5 b(alue)35 b(ma)m(y)h(not)1110
4244 y(b)s(e)c(c)m(hanged.)49 b(This)32 b(is)h(not)h(reset)f(when)f
(the)h(startup)g(\014les)f(are)i(executed,)1110 4354
4737 y(b)s(e)c(c)m(hanged.)49 b(This)32 b(is)h(not)h(reset)f(when)f
(the)h(startup)g(\014les)f(are)i(executed,)1110 4847
y(allo)m(wing)k(the)e(startup)f(\014les)h(to)g(disco)m(v)m(er)h
(whether)f(or)f(not)i(a)f(shell)g(is)g(re-)1110 4463
y(stricted.)630 4628 y Ft(shift_verbose)1110 4737 y Fu(If)g(this)g(is)g
(whether)f(or)f(not)i(a)f(shell)g(is)g(re-)1110 4956
y(stricted.)630 5121 y Ft(shift_verbose)1110 5230 y Fu(If)g(this)g(is)g
(set,)j(the)d Ft(shift)f Fu(builtin)h(prin)m(ts)f(an)h(error)g(message)
i(when)d(the)1110 4847 y(shift)30 b(coun)m(t)h(exceeds)g(the)g(n)m(um)m
(b)s(er)e(of)h(p)s(ositional)i(parameters.)630 5011 y
Ft(sourcepath)1110 5121 y Fu(If)22 b(set,)j(the)e Ft(source)e
Fu(builtin)h(uses)g(the)h(v)-5 b(alue)23 b(of)g Ft(PATH)e
Fu(to)j(\014nd)d(the)h(directory)1110 5230 y(con)m(taining)29
b(the)e(\014le)h(supplied)e(as)h(an)g(argumen)m(t.)40
b(This)27 b(option)h(is)f(enabled)1110 5340 y(b)m(y)j(default.)p
eop end
i(when)d(the)1110 5340 y(shift)30 b(coun)m(t)h(exceeds)g(the)g(n)m(um)m
(b)s(er)e(of)h(p)s(ositional)i(parameters.)p eop end
%%Page: 71 77
TeXDict begin 71 76 bop 150 -116 a Fu(Chapter)30 b(4:)41
b(Shell)30 b(Builtin)h(Commands)2069 b(71)630 299 y Ft(xpg_echo)96
b Fu(If)31 b(set,)h(the)g Ft(echo)e Fu(builtin)h(expands)f(bac)m
(kslash-escap)s(e)j(sequences)f(b)m(y)f(de-)1110 408
y(fault.)630 568 y(The)c(return)f(status)i(when)f(listing)h(options)g
(is)f(zero)i(if)e(all)i Fr(optnames)i Fu(are)d(enabled,)g(non-)630
677 y(zero)40 b(otherwise.)66 b(When)39 b(setting)h(or)f(unsetting)g
(options,)i(the)e(return)f(status)h(is)g(zero)630 787
y(unless)30 b(an)g Fr(optname)36 b Fu(is)30 b(not)h(a)g(v)-5
b(alid)30 b(shell)h(option.)150 1028 y Fs(4.4)68 b(Sp)t(ecial)45
b(Builtins)150 1187 y Fu(F)-8 b(or)35 b(historical)h(reasons,)g(the)e
Fm(posix)g Fu(standard)f(has)i(classi\014ed)f(sev)m(eral)i(builtin)e
(commands)g(as)h Fl(sp)-5 b(e-)150 1297 y(cial)p Fu(.)47
b(When)33 b(Bash)f(is)h(executing)g(in)f Fm(posix)g Fu(mo)s(de,)h(the)g
(sp)s(ecial)g(builtins)e(di\013er)i(from)f(other)g(builtin)150
1406 y(commands)e(in)g(three)h(resp)s(ects:)199 1541
b(Shell)30 b(Builtin)h(Commands)2069 b(71)630 299 y Ft(sourcepath)1110
408 y Fu(If)22 b(set,)j(the)e Ft(source)e Fu(builtin)h(uses)g(the)h(v)
-5 b(alue)23 b(of)g Ft(PATH)e Fu(to)j(\014nd)d(the)h(directory)1110
518 y(con)m(taining)29 b(the)e(\014le)h(supplied)e(as)h(an)g(argumen)m
(t.)40 b(This)27 b(option)h(is)f(enabled)1110 628 y(b)m(y)j(default.)
630 787 y Ft(xpg_echo)96 b Fu(If)31 b(set,)h(the)g Ft(echo)e
Fu(builtin)h(expands)f(bac)m(kslash-escap)s(e)j(sequences)f(b)m(y)f
(de-)1110 897 y(fault.)630 1056 y(The)c(return)f(status)i(when)f
(listing)h(options)g(is)f(zero)i(if)e(all)i Fr(optnames)i
Fu(are)d(enabled,)g(non-)630 1166 y(zero)40 b(otherwise.)66
b(When)39 b(setting)h(or)f(unsetting)g(options,)i(the)e(return)f
(status)h(is)g(zero)630 1275 y(unless)30 b(an)g Fr(optname)36
b Fu(is)30 b(not)h(a)g(v)-5 b(alid)30 b(shell)h(option.)150
1516 y Fs(4.4)68 b(Sp)t(ecial)45 b(Builtins)150 1675
y Fu(F)-8 b(or)35 b(historical)h(reasons,)g(the)e Fm(posix)g
Fu(standard)f(has)i(classi\014ed)f(sev)m(eral)i(builtin)e(commands)g
(as)h Fl(sp)-5 b(e-)150 1785 y(cial)p Fu(.)47 b(When)33
b(Bash)f(is)h(executing)g(in)f Fm(posix)g Fu(mo)s(de,)h(the)g(sp)s
(ecial)g(builtins)e(di\013er)i(from)f(other)g(builtin)150
1895 y(commands)e(in)g(three)h(resp)s(ects:)199 2029
y(1.)61 b(Sp)s(ecial)31 b(builtins)e(are)i(found)e(b)s(efore)h(shell)h
(functions)f(during)f(command)h(lo)s(okup.)199 1675 y(2.)61
(functions)f(during)f(command)h(lo)s(okup.)199 2164 y(2.)61
b(If)30 b(a)h(sp)s(ecial)g(builtin)f(returns)f(an)h(error)g(status,)h
(a)g(non-in)m(teractiv)m(e)i(shell)d(exits.)199 1810
(a)g(non-in)m(teractiv)m(e)i(shell)d(exits.)199 2298
y(3.)61 b(Assignmen)m(t)30 b(statemen)m(ts)h(preceding)f(the)f(command)
g(sta)m(y)i(in)e(e\013ect)i(in)e(the)h(shell)f(en)m(vironmen)m(t)330
1919 y(after)i(the)f(command)h(completes.)275 2079 y(When)36
2408 y(after)i(the)f(command)h(completes.)275 2567 y(When)36
b(Bash)g(is)h(not)f(executing)i(in)e Fm(posix)f Fu(mo)s(de,)j(these)f
(builtins)f(b)s(eha)m(v)m(e)h(no)f(di\013eren)m(tly)h(than)150
2188 y(the)31 b(rest)f(of)h(the)f(Bash)h(builtin)e(commands.)41
2677 y(the)31 b(rest)f(of)h(the)f(Bash)h(builtin)e(commands.)41
b(The)30 b(Bash)g Fm(posix)g Fu(mo)s(de)g(is)g(describ)s(ed)f(in)h
(Section)h(6.11)150 2298 y([Bash)g(POSIX)e(Mo)s(de],)i(page)g(98.)275
2433 y(These)f(are)g(the)h Fm(posix)f Fu(sp)s(ecial)h(builtins:)390
2567 y Ft(break)46 b(:)i(.)f(continue)f(eval)g(exec)h(exit)g(export)f
(readonly)f(return)h(set)390 2677 y(shift)g(trap)h(unset)p
(Section)h(6.11)150 2786 y([Bash)g(POSIX)e(Mo)s(de],)i(page)g(98.)275
2921 y(These)f(are)g(the)h Fm(posix)f Fu(sp)s(ecial)h(builtins:)390
3055 y Ft(break)46 b(:)i(.)f(continue)f(eval)g(exec)h(exit)g(export)f
(readonly)f(return)h(set)390 3165 y(shift)g(trap)h(unset)p
eop end
%%Page: 72 78
TeXDict begin 72 77 bop 3659 -116 a Fu(72)150 299 y Fp(5)80
@@ -17773,14 +17792,14 @@ Fu(pro)m(vide)i(is)h(to)f(use)g(a)h(shell)f(function)g(and)g(bind)e(it)
j(to)g(a)g(particular)150 1151 y(command)h(using)g Ft(complete)e(-F)p
Fu(.)275 1294 y(The)j(follo)m(wing)j(function)e(pro)m(vides)g
(completions)i(for)e(the)g Ft(cd)g Fu(builtin.)46 b(It)32
b(is)h(a)f(reasonably)h(go)s(o)s(d)150 1403 y(example)e(of)f(what)g
(shell)g(functions)g(m)m(ust)f(do)h(when)f(used)h(for)f(completion.)42
b(This)29 b(function)h(uses)g(the)150 1513 y(w)m(ord)38
b(passsed)g(as)h Ft($2)g Fu(to)g(determine)g(the)g(directory)g(name)g
(to)g(complete.)67 b(Y)-8 b(ou)40 b(can)f(also)g(use)g(the)150
1623 y Ft(COMP_WORDS)28 b Fu(arra)m(y)i(v)-5 b(ariable;)32
b(the)e(curren)m(t)h(w)m(ord)f(is)g(indexed)g(b)m(y)g(the)h
Ft(COMP_CWORD)c Fu(v)-5 b(ariable.)275 1766 y(The)42
b(is)h(a)f(reasonably)h(go)s(o)s(d)150 1403 y(example)41
b(of)g(what)f(shell)h(functions)f(m)m(ust)g(do)h(when)e(used)h(for)g
(completion.)73 b(This)39 b(function)h(uses)150 1513
y(the)32 b(w)m(ord)f(passed)g(as)h Ft($2)f Fu(to)h(determine)g(the)f
(directory)h(name)g(to)g(complete.)46 b(Y)-8 b(ou)32
b(can)g(also)g(use)g(the)150 1623 y Ft(COMP_WORDS)c Fu(arra)m(y)i(v)-5
b(ariable;)32 b(the)e(curren)m(t)h(w)m(ord)f(is)g(indexed)g(b)m(y)g
(the)h Ft(COMP_CWORD)c Fu(v)-5 b(ariable.)275 1766 y(The)42
b(function)h(relies)h(on)e(the)i Ft(complete)c Fu(and)j
Ft(compgen)e Fu(builtins)h(to)i(do)f(m)m(uc)m(h)g(of)g(the)h(w)m(ork,)
150 1875 y(adding)25 b(only)h(the)g(things)g(that)g(the)g(Bash)g
@@ -20067,7 +20086,7 @@ g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f
g(:)g(:)g(:)26 b Fb(57)2025 4339 y Fe(readarray)15 b
Fc(:)g(:)f(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g
(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)
g(:)g(:)30 b Fb(58)2025 4427 y Fe(readonly)18 b Fc(:)d(:)e(:)g(:)g(:)g
g(:)g(:)30 b Fb(59)2025 4427 y Fe(readonly)18 b Fc(:)d(:)e(:)g(:)g(:)g
(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)
h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)33
b Fb(46)2025 4515 y Fe(return)6 b Fc(:)14 b(:)f(:)h(:)f(:)g(:)g(:)g(:)g
+5 -4
View File
@@ -1776,10 +1776,11 @@ original word are removed unless they have been quoted themselves
(@var{quote removal}).
Only brace expansion, word splitting, and filename expansion
can change the number of words of the expansion; other expansions
can increase the number of words of the expansion; other expansions
expand a single word to a single word.
The only exceptions to this are the expansions of
@code{"$@@"} (@pxref{Special Parameters}) and @code{"$@{@var{name}[@@]@}"}
@code{"$@@"} and @code{$*} (@pxref{Special Parameters}), and
@code{"$@{@var{name}[@@]@}"} and @code{$@{@var{name}[*]@}}
(@pxref{Arrays}).
After all expansions, @code{quote removal} (@pxref{Quote Removal})
@@ -5128,8 +5129,8 @@ intervening command (@pxref{Job Control}).
The shell always postpones exiting if any jobs are stopped.
@item checkwinsize
If set, Bash checks the window size after each command
and, if necessary, updates the values of
If set, Bash checks the window size after each external (non-builtin)
command and, if necessary, updates the values of
@env{LINES} and @env{COLUMNS}.
@item cmdhist
+288 -276
View File
@@ -597,7 +597,7 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
plete, the edited commands are echoed and executed.
In the second form, _c_o_m_m_a_n_d is re-executed after each instance
of _p_a_t is replaced by _r_e_p. _C_o_m_m_a_n_d is intepreted the same as
of _p_a_t is replaced by _r_e_p. _C_o_m_m_a_n_d is interpreted the same as
_f_i_r_s_t above. A useful alias to use with this is ``r="fc -s"'',
so that typing ``r cc'' runs the last command beginning with
``cc'' and typing ``r'' re-executes the last command.
@@ -816,7 +816,9 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
plied. The variable MMAAPPFFIILLEE is the default _a_r_r_a_y. Options, if
supplied, have the following meanings:
--dd The first character of _d_e_l_i_m is used to terminate each
input line, rather than newline.
input line, rather than newline. If _d_e_l_i_m is the empty
string, mmaappffiillee will terminate a line when it reads a NUL
character.
--nn Copy at most _c_o_u_n_t lines. If _c_o_u_n_t is 0, all lines are
copied.
--OO Begin assigning to _a_r_r_a_y at index _o_r_i_g_i_n. The default
@@ -964,27 +966,30 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
ignored.
--dd _d_e_l_i_m
The first character of _d_e_l_i_m is used to terminate the
input line, rather than newline.
input line, rather than newline. If _d_e_l_i_m is the empty
string, rreeaadd will terminate a line when it reads a NUL
character.
--ee If the standard input is coming from a terminal, rreeaaddlliinnee
(see RREEAADDLLIINNEE above) is used to obtain the line. Read-
line uses the current (or default, if line editing was
not previously active) editing settings.
not previously active) editing settings, but uses Read-
line's default filename completion.
--ii _t_e_x_t
If rreeaaddlliinnee is being used to read the line, _t_e_x_t is
If rreeaaddlliinnee is being used to read the line, _t_e_x_t is
placed into the editing buffer before editing begins.
--nn _n_c_h_a_r_s
rreeaadd returns after reading _n_c_h_a_r_s characters rather than
rreeaadd returns after reading _n_c_h_a_r_s characters rather than
waiting for a complete line of input, but honors a delim-
iter if fewer than _n_c_h_a_r_s characters are read before the
iter if fewer than _n_c_h_a_r_s characters are read before the
delimiter.
--NN _n_c_h_a_r_s
rreeaadd returns after reading exactly _n_c_h_a_r_s characters
rather than waiting for a complete line of input, unless
EOF is encountered or rreeaadd times out. Delimiter charac-
ters encountered in the input are not treated specially
and do not cause rreeaadd to return until _n_c_h_a_r_s characters
are read. The result is not split on the characters in
IIFFSS; the intent is that the variable is assigned exactly
rreeaadd returns after reading exactly _n_c_h_a_r_s characters
rather than waiting for a complete line of input, unless
EOF is encountered or rreeaadd times out. Delimiter charac-
ters encountered in the input are not treated specially
and do not cause rreeaadd to return until _n_c_h_a_r_s characters
are read. The result is not split on the characters in
IIFFSS; the intent is that the variable is assigned exactly
the characters read (with the exception of backslash; see
the --rr option below).
--pp _p_r_o_m_p_t
@@ -992,131 +997,131 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
line, before attempting to read any input. The prompt is
displayed only if input is coming from a terminal.
--rr Backslash does not act as an escape character. The back-
slash is considered to be part of the line. In particu-
lar, a backslash-newline pair may not be used as a line
slash is considered to be part of the line. In particu-
lar, a backslash-newline pair may not be used as a line
continuation.
--ss Silent mode. If input is coming from a terminal, charac-
ters are not echoed.
--tt _t_i_m_e_o_u_t
Cause rreeaadd to time out and return failure if a complete
line of input (or a specified number of characters) is
not read within _t_i_m_e_o_u_t seconds. _t_i_m_e_o_u_t may be a deci-
mal number with a fractional portion following the deci-
mal point. This option is only effective if rreeaadd is
reading input from a terminal, pipe, or other special
file; it has no effect when reading from regular files.
Cause rreeaadd to time out and return failure if a complete
line of input (or a specified number of characters) is
not read within _t_i_m_e_o_u_t seconds. _t_i_m_e_o_u_t may be a deci-
mal number with a fractional portion following the deci-
mal point. This option is only effective if rreeaadd is
reading input from a terminal, pipe, or other special
file; it has no effect when reading from regular files.
If rreeaadd times out, rreeaadd saves any partial input read into
the specified variable _n_a_m_e. If _t_i_m_e_o_u_t is 0, rreeaadd
returns immediately, without trying to read any data.
The exit status is 0 if input is available on the speci-
fied file descriptor, non-zero otherwise. The exit sta-
the specified variable _n_a_m_e. If _t_i_m_e_o_u_t is 0, rreeaadd
returns immediately, without trying to read any data.
The exit status is 0 if input is available on the speci-
fied file descriptor, non-zero otherwise. The exit sta-
tus is greater than 128 if the timeout is exceeded.
--uu _f_d Read input from file descriptor _f_d.
If no _n_a_m_e_s are supplied, the line read is assigned to the vari-
able RREEPPLLYY. The exit status is zero, unless end-of-file is
able RREEPPLLYY. The exit status is zero, unless end-of-file is
encountered, rreeaadd times out (in which case the status is greater
than 128), a variable assignment error (such as assigning to a
than 128), a variable assignment error (such as assigning to a
readonly variable) occurs, or an invalid file descriptor is sup-
plied as the argument to --uu.
rreeaaddoonnllyy [--aaAAff] [--pp] [_n_a_m_e[=_w_o_r_d] ...]
The given _n_a_m_e_s are marked readonly; the values of these _n_a_m_e_s
may not be changed by subsequent assignment. If the --ff option
is supplied, the functions corresponding to the _n_a_m_e_s are so
marked. The --aa option restricts the variables to indexed
arrays; the --AA option restricts the variables to associative
arrays. If both options are supplied, --AA takes precedence. If
no _n_a_m_e arguments are given, or if the --pp option is supplied, a
The given _n_a_m_e_s are marked readonly; the values of these _n_a_m_e_s
may not be changed by subsequent assignment. If the --ff option
is supplied, the functions corresponding to the _n_a_m_e_s are so
marked. The --aa option restricts the variables to indexed
arrays; the --AA option restricts the variables to associative
arrays. If both options are supplied, --AA takes precedence. If
no _n_a_m_e arguments are given, or if the --pp option is supplied, a
list of all readonly names is printed. The other options may be
used to restrict the output to a subset of the set of readonly
names. The --pp option causes output to be displayed in a format
that may be reused as input. If a variable name is followed by
=_w_o_r_d, the value of the variable is set to _w_o_r_d. The return
status is 0 unless an invalid option is encountered, one of the
used to restrict the output to a subset of the set of readonly
names. The --pp option causes output to be displayed in a format
that may be reused as input. If a variable name is followed by
=_w_o_r_d, the value of the variable is set to _w_o_r_d. The return
status is 0 unless an invalid option is encountered, one of the
_n_a_m_e_s is not a valid shell variable name, or --ff is supplied with
a _n_a_m_e that is not a function.
rreettuurrnn [_n]
Causes a function to stop executing and return the value speci-
fied by _n to its caller. If _n is omitted, the return status is
that of the last command executed in the function body. If
rreettuurrnn is executed by a trap handler, the last command used to
determine the status is the last command executed before the
trap handler. if rreettuurrnn is executed during a DDEEBBUUGG trap, the
last command used to determine the status is the last command
executed by the trap handler before rreettuurrnn was invoked. If
rreettuurrnn is used outside a function, but during execution of a
script by the .. (ssoouurrccee) command, it causes the shell to stop
executing that script and return either _n or the exit status of
the last command executed within the script as the exit status
of the script. If _n is supplied, the return value is its least
significant 8 bits. The return status is non-zero if rreettuurrnn is
supplied a non-numeric argument, or is used outside a function
and not during execution of a script by .. or ssoouurrccee. Any com-
mand associated with the RREETTUURRNN trap is executed before execu-
Causes a function to stop executing and return the value speci-
fied by _n to its caller. If _n is omitted, the return status is
that of the last command executed in the function body. If
rreettuurrnn is executed by a trap handler, the last command used to
determine the status is the last command executed before the
trap handler. if rreettuurrnn is executed during a DDEEBBUUGG trap, the
last command used to determine the status is the last command
executed by the trap handler before rreettuurrnn was invoked. If
rreettuurrnn is used outside a function, but during execution of a
script by the .. (ssoouurrccee) command, it causes the shell to stop
executing that script and return either _n or the exit status of
the last command executed within the script as the exit status
of the script. If _n is supplied, the return value is its least
significant 8 bits. The return status is non-zero if rreettuurrnn is
supplied a non-numeric argument, or is used outside a function
and not during execution of a script by .. or ssoouurrccee. Any com-
mand associated with the RREETTUURRNN trap is executed before execu-
tion resumes after the function or script.
sseett [----aabbeeffhhkkmmnnppttuuvvxxBBCCEEHHPPTT] [--oo _o_p_t_i_o_n_-_n_a_m_e] [_a_r_g ...]
sseett [++aabbeeffhhkkmmnnppttuuvvxxBBCCEEHHPPTT] [++oo _o_p_t_i_o_n_-_n_a_m_e] [_a_r_g ...]
Without options, the name and value of each shell variable are
Without options, the name and value of each shell variable are
displayed in a format that can be reused as input for setting or
resetting the currently-set variables. Read-only variables can-
not be reset. In _p_o_s_i_x mode, only shell variables are listed.
The output is sorted according to the current locale. When
options are specified, they set or unset shell attributes. Any
arguments remaining after option processing are treated as val-
not be reset. In _p_o_s_i_x mode, only shell variables are listed.
The output is sorted according to the current locale. When
options are specified, they set or unset shell attributes. Any
arguments remaining after option processing are treated as val-
ues for the positional parameters and are assigned, in order, to
$$11, $$22, ...... $$_n. Options, if specified, have the following
$$11, $$22, ...... $$_n. Options, if specified, have the following
meanings:
--aa Each variable or function that is created or modified is
given the export attribute and marked for export to the
given the export attribute and marked for export to the
environment of subsequent commands.
--bb Report the status of terminated background jobs immedi-
--bb Report the status of terminated background jobs immedi-
ately, rather than before the next primary prompt. This
is effective only when job control is enabled.
--ee Exit immediately if a _p_i_p_e_l_i_n_e (which may consist of a
single _s_i_m_p_l_e _c_o_m_m_a_n_d), a _l_i_s_t, or a _c_o_m_p_o_u_n_d _c_o_m_m_a_n_d
--ee Exit immediately if a _p_i_p_e_l_i_n_e (which may consist of a
single _s_i_m_p_l_e _c_o_m_m_a_n_d), a _l_i_s_t, or a _c_o_m_p_o_u_n_d _c_o_m_m_a_n_d
(see SSHHEELLLL GGRRAAMMMMAARR above), exits with a non-zero status.
The shell does not exit if the command that fails is
part of the command list immediately following a wwhhiillee
or uunnttiill keyword, part of the test following the iiff or
eelliiff reserved words, part of any command executed in a
&&&& or |||| list except the command following the final &&&&
The shell does not exit if the command that fails is
part of the command list immediately following a wwhhiillee
or uunnttiill keyword, part of the test following the iiff or
eelliiff reserved words, part of any command executed in a
&&&& or |||| list except the command following the final &&&&
or ||||, any command in a pipeline but the last, or if the
command's return value is being inverted with !!. If a
compound command other than a subshell returns a non-
zero status because a command failed while --ee was being
ignored, the shell does not exit. A trap on EERRRR, if
set, is executed before the shell exits. This option
command's return value is being inverted with !!. If a
compound command other than a subshell returns a non-
zero status because a command failed while --ee was being
ignored, the shell does not exit. A trap on EERRRR, if
set, is executed before the shell exits. This option
applies to the shell environment and each subshell envi-
ronment separately (see CCOOMMMMAANNDD EEXXEECCUUTTIIOONN EENNVVIIRROONNMMEENNTT
ronment separately (see CCOOMMMMAANNDD EEXXEECCUUTTIIOONN EENNVVIIRROONNMMEENNTT
above), and may cause subshells to exit before executing
all the commands in the subshell.
If a compound command or shell function executes in a
context where --ee is being ignored, none of the commands
executed within the compound command or function body
will be affected by the --ee setting, even if --ee is set
and a command returns a failure status. If a compound
command or shell function sets --ee while executing in a
context where --ee is ignored, that setting will not have
any effect until the compound command or the command
If a compound command or shell function executes in a
context where --ee is being ignored, none of the commands
executed within the compound command or function body
will be affected by the --ee setting, even if --ee is set
and a command returns a failure status. If a compound
command or shell function sets --ee while executing in a
context where --ee is ignored, that setting will not have
any effect until the compound command or the command
containing the function call completes.
--ff Disable pathname expansion.
--hh Remember the location of commands as they are looked up
--hh Remember the location of commands as they are looked up
for execution. This is enabled by default.
--kk All arguments in the form of assignment statements are
placed in the environment for a command, not just those
--kk All arguments in the form of assignment statements are
placed in the environment for a command, not just those
that precede the command name.
--mm Monitor mode. Job control is enabled. This option is
on by default for interactive shells on systems that
support it (see JJOOBB CCOONNTTRROOLL above). All processes run
--mm Monitor mode. Job control is enabled. This option is
on by default for interactive shells on systems that
support it (see JJOOBB CCOONNTTRROOLL above). All processes run
in a separate process group. When a background job com-
pletes, the shell prints a line containing its exit sta-
tus.
--nn Read commands but do not execute them. This may be used
to check a shell script for syntax errors. This is
to check a shell script for syntax errors. This is
ignored by interactive shells.
--oo _o_p_t_i_o_n_-_n_a_m_e
The _o_p_t_i_o_n_-_n_a_m_e can be one of the following:
@@ -1124,10 +1129,10 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
Same as --aa.
bbrraacceeeexxppaanndd
Same as --BB.
eemmaaccss Use an emacs-style command line editing inter-
eemmaaccss Use an emacs-style command line editing inter-
face. This is enabled by default when the shell
is interactive, unless the shell is started with
the ----nnooeeddiittiinngg option. This also affects the
the ----nnooeeddiittiinngg option. This also affects the
editing interface used for rreeaadd --ee.
eerrrreexxiitt Same as --ee.
eerrrrttrraaccee
@@ -1141,8 +1146,8 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
HHIISSTTOORRYY. This option is on by default in inter-
active shells.
iiggnnoorreeeeooff
The effect is as if the shell command
``IGNOREEOF=10'' had been executed (see SShheellll
The effect is as if the shell command
``IGNOREEOF=10'' had been executed (see SShheellll
VVaarriiaabblleess above).
kkeeyywwoorrdd Same as --kk.
mmoonniittoorr Same as --mm.
@@ -1157,341 +1162,348 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
pphhyyssiiccaall
Same as --PP.
ppiippeeffaaiill
If set, the return value of a pipeline is the
value of the last (rightmost) command to exit
with a non-zero status, or zero if all commands
in the pipeline exit successfully. This option
If set, the return value of a pipeline is the
value of the last (rightmost) command to exit
with a non-zero status, or zero if all commands
in the pipeline exit successfully. This option
is disabled by default.
ppoossiixx Change the behavior of bbaasshh where the default
operation differs from the POSIX standard to
match the standard (_p_o_s_i_x _m_o_d_e). See SSEEEE AALLSSOO
ppoossiixx Change the behavior of bbaasshh where the default
operation differs from the POSIX standard to
match the standard (_p_o_s_i_x _m_o_d_e). See SSEEEE AALLSSOO
below for a reference to a document that details
how posix mode affects bash's behavior.
pprriivviilleeggeedd
Same as --pp.
vveerrbboossee Same as --vv.
vvii Use a vi-style command line editing interface.
vvii Use a vi-style command line editing interface.
This also affects the editing interface used for
rreeaadd --ee.
xxttrraaccee Same as --xx.
If --oo is supplied with no _o_p_t_i_o_n_-_n_a_m_e, the values of the
current options are printed. If ++oo is supplied with no
_o_p_t_i_o_n_-_n_a_m_e, a series of sseett commands to recreate the
current option settings is displayed on the standard
current options are printed. If ++oo is supplied with no
_o_p_t_i_o_n_-_n_a_m_e, a series of sseett commands to recreate the
current option settings is displayed on the standard
output.
--pp Turn on _p_r_i_v_i_l_e_g_e_d mode. In this mode, the $$EENNVV and
$$BBAASSHH__EENNVV files are not processed, shell functions are
not inherited from the environment, and the SSHHEELLLLOOPPTTSS,
BBAASSHHOOPPTTSS, CCDDPPAATTHH, and GGLLOOBBIIGGNNOORREE variables, if they
--pp Turn on _p_r_i_v_i_l_e_g_e_d mode. In this mode, the $$EENNVV and
$$BBAASSHH__EENNVV files are not processed, shell functions are
not inherited from the environment, and the SSHHEELLLLOOPPTTSS,
BBAASSHHOOPPTTSS, CCDDPPAATTHH, and GGLLOOBBIIGGNNOORREE variables, if they
appear in the environment, are ignored. If the shell is
started with the effective user (group) id not equal to
the real user (group) id, and the --pp option is not sup-
started with the effective user (group) id not equal to
the real user (group) id, and the --pp option is not sup-
plied, these actions are taken and the effective user id
is set to the real user id. If the --pp option is sup-
plied at startup, the effective user id is not reset.
Turning this option off causes the effective user and
is set to the real user id. If the --pp option is sup-
plied at startup, the effective user id is not reset.
Turning this option off causes the effective user and
group ids to be set to the real user and group ids.
--tt Exit after reading and executing one command.
--uu Treat unset variables and parameters other than the spe-
cial parameters "@" and "*" as an error when performing
parameter expansion. If expansion is attempted on an
unset variable or parameter, the shell prints an error
message, and, if not interactive, exits with a non-zero
cial parameters "@" and "*" as an error when performing
parameter expansion. If expansion is attempted on an
unset variable or parameter, the shell prints an error
message, and, if not interactive, exits with a non-zero
status.
--vv Print shell input lines as they are read.
--xx After expanding each _s_i_m_p_l_e _c_o_m_m_a_n_d, ffoorr command, ccaassee
--xx After expanding each _s_i_m_p_l_e _c_o_m_m_a_n_d, ffoorr command, ccaassee
command, sseelleecctt command, or arithmetic ffoorr command, dis-
play the expanded value of PPSS44, followed by the command
play the expanded value of PPSS44, followed by the command
and its expanded arguments or associated word list.
--BB The shell performs brace expansion (see BBrraaccee EExxppaannssiioonn
--BB The shell performs brace expansion (see BBrraaccee EExxppaannssiioonn
above). This is on by default.
--CC If set, bbaasshh does not overwrite an existing file with
the >>, >>&&, and <<>> redirection operators. This may be
--CC If set, bbaasshh does not overwrite an existing file with
the >>, >>&&, and <<>> redirection operators. This may be
overridden when creating output files by using the redi-
rection operator >>|| instead of >>.
--EE If set, any trap on EERRRR is inherited by shell functions,
command substitutions, and commands executed in a sub-
shell environment. The EERRRR trap is normally not inher-
command substitutions, and commands executed in a sub-
shell environment. The EERRRR trap is normally not inher-
ited in such cases.
--HH Enable !! style history substitution. This option is on
by default when the shell is interactive.
--PP If set, the shell does not resolve symbolic links when
executing commands such as ccdd that change the current
--PP If set, the shell does not resolve symbolic links when
executing commands such as ccdd that change the current
working directory. It uses the physical directory
structure instead. By default, bbaasshh follows the logical
chain of directories when performing commands which
chain of directories when performing commands which
change the current directory.
--TT If set, any traps on DDEEBBUUGG and RREETTUURRNN are inherited by
shell functions, command substitutions, and commands
executed in a subshell environment. The DDEEBBUUGG and
--TT If set, any traps on DDEEBBUUGG and RREETTUURRNN are inherited by
shell functions, command substitutions, and commands
executed in a subshell environment. The DDEEBBUUGG and
RREETTUURRNN traps are normally not inherited in such cases.
---- If no arguments follow this option, then the positional
---- If no arguments follow this option, then the positional
parameters are unset. Otherwise, the positional parame-
ters are set to the _a_r_gs, even if some of them begin
ters are set to the _a_r_gs, even if some of them begin
with a --.
-- Signal the end of options, cause all remaining _a_r_gs to
-- Signal the end of options, cause all remaining _a_r_gs to
be assigned to the positional parameters. The --xx and --vv
options are turned off. If there are no _a_r_gs, the posi-
tional parameters remain unchanged.
The options are off by default unless otherwise noted. Using +
rather than - causes these options to be turned off. The
options can also be specified as arguments to an invocation of
the shell. The current set of options may be found in $$--. The
The options are off by default unless otherwise noted. Using +
rather than - causes these options to be turned off. The
options can also be specified as arguments to an invocation of
the shell. The current set of options may be found in $$--. The
return status is always true unless an invalid option is encoun-
tered.
sshhiifftt [_n]
The positional parameters from _n+1 ... are renamed to $$11 ........
Parameters represented by the numbers $$## down to $$##-_n+1 are
unset. _n must be a non-negative number less than or equal to
$$##. If _n is 0, no parameters are changed. If _n is not given,
it is assumed to be 1. If _n is greater than $$##, the positional
parameters are not changed. The return status is greater than
The positional parameters from _n+1 ... are renamed to $$11 ........
Parameters represented by the numbers $$## down to $$##-_n+1 are
unset. _n must be a non-negative number less than or equal to
$$##. If _n is 0, no parameters are changed. If _n is not given,
it is assumed to be 1. If _n is greater than $$##, the positional
parameters are not changed. The return status is greater than
zero if _n is greater than $$## or less than zero; otherwise 0.
sshhoopptt [--ppqqssuu] [--oo] [_o_p_t_n_a_m_e ...]
Toggle the values of settings controlling optional shell behav-
ior. The settings can be either those listed below, or, if the
Toggle the values of settings controlling optional shell behav-
ior. The settings can be either those listed below, or, if the
--oo option is used, those available with the --oo option to the sseett
builtin command. With no options, or with the --pp option, a list
of all settable options is displayed, with an indication of
whether or not each is set. The --pp option causes output to be
displayed in a form that may be reused as input. Other options
of all settable options is displayed, with an indication of
whether or not each is set. The --pp option causes output to be
displayed in a form that may be reused as input. Other options
have the following meanings:
--ss Enable (set) each _o_p_t_n_a_m_e.
--uu Disable (unset) each _o_p_t_n_a_m_e.
--qq Suppresses normal output (quiet mode); the return status
--qq Suppresses normal output (quiet mode); the return status
indicates whether the _o_p_t_n_a_m_e is set or unset. If multi-
ple _o_p_t_n_a_m_e arguments are given with --qq, the return sta-
tus is zero if all _o_p_t_n_a_m_e_s are enabled; non-zero other-
ple _o_p_t_n_a_m_e arguments are given with --qq, the return sta-
tus is zero if all _o_p_t_n_a_m_e_s are enabled; non-zero other-
wise.
--oo Restricts the values of _o_p_t_n_a_m_e to be those defined for
--oo Restricts the values of _o_p_t_n_a_m_e to be those defined for
the --oo option to the sseett builtin.
If either --ss or --uu is used with no _o_p_t_n_a_m_e arguments, sshhoopptt
shows only those options which are set or unset, respectively.
Unless otherwise noted, the sshhoopptt options are disabled (unset)
If either --ss or --uu is used with no _o_p_t_n_a_m_e arguments, sshhoopptt
shows only those options which are set or unset, respectively.
Unless otherwise noted, the sshhoopptt options are disabled (unset)
by default.
The return status when listing options is zero if all _o_p_t_n_a_m_e_s
are enabled, non-zero otherwise. When setting or unsetting
options, the return status is zero unless an _o_p_t_n_a_m_e is not a
The return status when listing options is zero if all _o_p_t_n_a_m_e_s
are enabled, non-zero otherwise. When setting or unsetting
options, the return status is zero unless an _o_p_t_n_a_m_e is not a
valid shell option.
The list of sshhoopptt options is:
aauuttooccdd If set, a command name that is the name of a directory
is executed as if it were the argument to the ccdd com-
aauuttooccdd If set, a command name that is the name of a directory
is executed as if it were the argument to the ccdd com-
mand. This option is only used by interactive shells.
ccddaabbllee__vvaarrss
If set, an argument to the ccdd builtin command that is
not a directory is assumed to be the name of a variable
If set, an argument to the ccdd builtin command that is
not a directory is assumed to be the name of a variable
whose value is the directory to change to.
ccddssppeellll If set, minor errors in the spelling of a directory com-
ponent in a ccdd command will be corrected. The errors
ponent in a ccdd command will be corrected. The errors
checked for are transposed characters, a missing charac-
ter, and one character too many. If a correction is
found, the corrected filename is printed, and the com-
mand proceeds. This option is only used by interactive
ter, and one character too many. If a correction is
found, the corrected filename is printed, and the com-
mand proceeds. This option is only used by interactive
shells.
cchheecckkhhaasshh
If set, bbaasshh checks that a command found in the hash ta-
ble exists before trying to execute it. If a hashed
command no longer exists, a normal path search is per-
ble exists before trying to execute it. If a hashed
command no longer exists, a normal path search is per-
formed.
cchheecckkjjoobbss
If set, bbaasshh lists the status of any stopped and running
jobs before exiting an interactive shell. If any jobs
jobs before exiting an interactive shell. If any jobs
are running, this causes the exit to be deferred until a
second exit is attempted without an intervening command
(see JJOOBB CCOONNTTRROOLL above). The shell always postpones
second exit is attempted without an intervening command
(see JJOOBB CCOONNTTRROOLL above). The shell always postpones
exiting if any jobs are stopped.
cchheecckkwwiinnssiizzee
If set, bbaasshh checks the window size after each command
and, if necessary, updates the values of LLIINNEESS and CCOOLL--
UUMMNNSS.
ccmmddhhiisstt If set, bbaasshh attempts to save all lines of a multiple-
line command in the same history entry. This allows
easy re-editing of multi-line commands.
If set, bbaasshh checks the window size after each external
(non-builtin) command and, if necessary, updates the
values of LLIINNEESS and CCOOLLUUMMNNSS.
ccmmddhhiisstt If set, bbaasshh attempts to save all lines of a multiple-
line command in the same history entry. This allows
easy re-editing of multi-line commands. This option is
enabled by default, but only has an effect if command
history is enabled, as described above under HHIISSTTOORRYY.
ccoommppaatt3311
If set, bbaasshh changes its behavior to that of version 3.1
with respect to quoted arguments to the [[[[ conditional
with respect to quoted arguments to the [[[[ conditional
command's ==~~ operator and locale-specific string compar-
ison when using the [[[[ conditional command's << and >>
operators. Bash versions prior to bash-4.1 use ASCII
ison when using the [[[[ conditional command's << and >>
operators. Bash versions prior to bash-4.1 use ASCII
collation and _s_t_r_c_m_p(3); bash-4.1 and later use the cur-
rent locale's collation sequence and _s_t_r_c_o_l_l(3).
ccoommppaatt3322
If set, bbaasshh changes its behavior to that of version 3.2
with respect to locale-specific string comparison when
using the [[[[ conditional command's << and >> operators
(see previous item) and the effect of interrupting a
command list. Bash versions 3.2 and earlier continue
with the next command in the list after one terminates
with respect to locale-specific string comparison when
using the [[[[ conditional command's << and >> operators
(see previous item) and the effect of interrupting a
command list. Bash versions 3.2 and earlier continue
with the next command in the list after one terminates
due to an interrupt.
ccoommppaatt4400
If set, bbaasshh changes its behavior to that of version 4.0
with respect to locale-specific string comparison when
using the [[[[ conditional command's << and >> operators
(see description of ccoommppaatt3311) and the effect of inter-
rupting a command list. Bash versions 4.0 and later
interrupt the list as if the shell received the inter-
rupt; previous versions continue with the next command
with respect to locale-specific string comparison when
using the [[[[ conditional command's << and >> operators
(see description of ccoommppaatt3311) and the effect of inter-
rupting a command list. Bash versions 4.0 and later
interrupt the list as if the shell received the inter-
rupt; previous versions continue with the next command
in the list.
ccoommppaatt4411
If set, bbaasshh, when in _p_o_s_i_x mode, treats a single quote
in a double-quoted parameter expansion as a special
character. The single quotes must match (an even num-
ber) and the characters between the single quotes are
considered quoted. This is the behavior of posix mode
through version 4.1. The default bash behavior remains
If set, bbaasshh, when in _p_o_s_i_x mode, treats a single quote
in a double-quoted parameter expansion as a special
character. The single quotes must match (an even num-
ber) and the characters between the single quotes are
considered quoted. This is the behavior of posix mode
through version 4.1. The default bash behavior remains
as in previous versions.
ccoommppaatt4422
If set, bbaasshh does not process the replacement string in
the pattern substitution word expansion using quote
If set, bbaasshh does not process the replacement string in
the pattern substitution word expansion using quote
removal.
ccoommppaatt4433
If set, bbaasshh does not print a warning message if an
attempt is made to use a quoted compound array assign-
ment as an argument to ddeeccllaarree, makes word expansion
errors non-fatal errors that cause the current command
to fail (the default behavior is to make them fatal
If set, bbaasshh does not print a warning message if an
attempt is made to use a quoted compound array assign-
ment as an argument to ddeeccllaarree, makes word expansion
errors non-fatal errors that cause the current command
to fail (the default behavior is to make them fatal
errors that cause the shell to exit), and does not reset
the loop state when a shell function is executed (this
allows bbrreeaakk or ccoonnttiinnuuee in a shell function to affect
the loop state when a shell function is executed (this
allows bbrreeaakk or ccoonnttiinnuuee in a shell function to affect
loops in the caller's context).
ccoommpplleettee__ffuullllqquuoottee
If set, bbaasshh quotes all shell metacharacters in file-
names and directory names when performing completion.
If set, bbaasshh quotes all shell metacharacters in file-
names and directory names when performing completion.
If not set, bbaasshh removes metacharacters such as the dol-
lar sign from the set of characters that will be quoted
in completed filenames when these metacharacters appear
in shell variable references in words to be completed.
This means that dollar signs in variable names that
expand to directories will not be quoted; however, any
dollar signs appearing in filenames will not be quoted,
either. This is active only when bash is using back-
slashes to quote completed filenames. This variable is
set by default, which is the default bash behavior in
lar sign from the set of characters that will be quoted
in completed filenames when these metacharacters appear
in shell variable references in words to be completed.
This means that dollar signs in variable names that
expand to directories will not be quoted; however, any
dollar signs appearing in filenames will not be quoted,
either. This is active only when bash is using back-
slashes to quote completed filenames. This variable is
set by default, which is the default bash behavior in
versions through 4.2.
ddiirreexxppaanndd
If set, bbaasshh replaces directory names with the results
of word expansion when performing filename completion.
This changes the contents of the readline editing buf-
fer. If not set, bbaasshh attempts to preserve what the
If set, bbaasshh replaces directory names with the results
of word expansion when performing filename completion.
This changes the contents of the readline editing buf-
fer. If not set, bbaasshh attempts to preserve what the
user typed.
ddiirrssppeellll
If set, bbaasshh attempts spelling correction on directory
names during word completion if the directory name ini-
If set, bbaasshh attempts spelling correction on directory
names during word completion if the directory name ini-
tially supplied does not exist.
ddoottgglloobb If set, bbaasshh includes filenames beginning with a `.' in
the results of pathname expansion. The filenames ````..''''
and ````....'''' must always be matched explicitly, even if
ddoottgglloobb If set, bbaasshh includes filenames beginning with a `.' in
the results of pathname expansion. The filenames ````..''''
and ````....'''' must always be matched explicitly, even if
ddoottgglloobb is set.
eexxeeccffaaiill
If set, a non-interactive shell will not exit if it can-
not execute the file specified as an argument to the
eexxeecc builtin command. An interactive shell does not
not execute the file specified as an argument to the
eexxeecc builtin command. An interactive shell does not
exit if eexxeecc fails.
eexxppaanndd__aalliiaasseess
If set, aliases are expanded as described above under
If set, aliases are expanded as described above under
AALLIIAASSEESS. This option is enabled by default for interac-
tive shells.
eexxttddeebbuugg
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-
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.
22.. If the command run by the DDEEBBUUGG trap returns a
non-zero value, the next command is skipped and
22.. If the command run by the DDEEBBUUGG trap returns a
non-zero value, the next command is skipped and
not executed.
33.. If the command run by the DDEEBBUUGG trap returns a
value of 2, and the shell is executing in a sub-
routine (a shell function or a shell script exe-
cuted by the .. or ssoouurrccee builtins), the shell
33.. If the command run by the DDEEBBUUGG trap returns a
value of 2, and the shell is executing in a sub-
routine (a shell function or a shell script exe-
cuted by the .. or ssoouurrccee builtins), the shell
simulates a call to rreettuurrnn.
44.. BBAASSHH__AARRGGCC and BBAASSHH__AARRGGVV are updated as described
44.. BBAASSHH__AARRGGCC and BBAASSHH__AARRGGVV are updated as described
in their descriptions above.
55.. Function tracing is enabled: command substitu-
55.. Function tracing is enabled: command substitu-
tion, shell functions, and subshells invoked with
(( _c_o_m_m_a_n_d )) inherit the DDEEBBUUGG and RREETTUURRNN traps.
66.. Error tracing is enabled: command substitution,
shell functions, and subshells invoked with ((
66.. Error tracing is enabled: command substitution,
shell functions, and subshells invoked with ((
_c_o_m_m_a_n_d )) inherit the EERRRR trap.
eexxttgglloobb If set, the extended pattern matching features described
above under PPaatthhnnaammee EExxppaannssiioonn are enabled.
eexxttqquuoottee
If set, $$'_s_t_r_i_n_g' and $$"_s_t_r_i_n_g" quoting is performed
within $${{_p_a_r_a_m_e_t_e_r}} expansions enclosed in double
If set, $$'_s_t_r_i_n_g' and $$"_s_t_r_i_n_g" quoting is performed
within $${{_p_a_r_a_m_e_t_e_r}} expansions enclosed in double
quotes. This option is enabled by default.
ffaaiillgglloobb
If set, patterns which fail to match filenames during
If set, patterns which fail to match filenames during
pathname expansion result in an expansion error.
ffoorrccee__ffiiggnnoorree
If set, the suffixes specified by the FFIIGGNNOORREE shell
variable cause words to be ignored when performing word
If set, the suffixes specified by the FFIIGGNNOORREE shell
variable cause words to be ignored when performing word
completion even if the ignored words are the only possi-
ble completions. See SSHHEELLLL VVAARRIIAABBLLEESS above for a
description of FFIIGGNNOORREE. This option is enabled by
description of FFIIGGNNOORREE. This option is enabled by
default.
gglloobbaasscciiiirraannggeess
If set, range expressions used in pattern matching
bracket expressions (see PPaatttteerrnn MMaattcchhiinngg above) behave
as if in the traditional C locale when performing com-
If set, range expressions used in pattern matching
bracket expressions (see PPaatttteerrnn MMaattcchhiinngg above) behave
as if in the traditional C locale when performing com-
parisons. That is, the current locale's collating
sequence is not taken into account, so bb will not col-
late between AA and BB, and upper-case and lower-case
sequence is not taken into account, so bb will not col-
late between AA and BB, and upper-case and lower-case
ASCII characters will collate together.
gglloobbssttaarr
If set, the pattern **** used in a pathname expansion con-
text will match all files and zero or more directories
and subdirectories. If the pattern is followed by a //,
text will match all files and zero or more directories
and subdirectories. If the pattern is followed by a //,
only directories and subdirectories match.
ggnnuu__eerrrrffmmtt
If set, shell error messages are written in the standard
GNU error message format.
hhiissttaappppeenndd
If set, the history list is appended to the file named
by the value of the HHIISSTTFFIILLEE variable when the shell
If set, the history list is appended to the file named
by the value of the HHIISSTTFFIILLEE variable when the shell
exits, rather than overwriting the file.
hhiissttrreeeeddiitt
If set, and rreeaaddlliinnee is being used, a user is given the
If set, and rreeaaddlliinnee is being used, a user is given the
opportunity to re-edit a failed history substitution.
hhiissttvveerriiffyy
If set, and rreeaaddlliinnee is being used, the results of his-
tory substitution are not immediately passed to the
shell parser. Instead, the resulting line is loaded
If set, and rreeaaddlliinnee is being used, the results of his-
tory substitution are not immediately passed to the
shell parser. Instead, the resulting line is loaded
into the rreeaaddlliinnee editing buffer, allowing further modi-
fication.
hhoossttccoommpplleettee
If set, and rreeaaddlliinnee is being used, bbaasshh will attempt to
perform hostname completion when a word containing a @@
is being completed (see CCoommpplleettiinngg under RREEAADDLLIINNEE
perform hostname completion when a word containing a @@
is being completed (see CCoommpplleettiinngg under RREEAADDLLIINNEE
above). This is enabled by default.
hhuuppoonneexxiitt
If set, bbaasshh will send SSIIGGHHUUPP to all jobs when an inter-
active login shell exits.
iinnhheerriitt__eerrrreexxiitt
If set, command substitution inherits the value of the
eerrrreexxiitt option, instead of unsetting it in the subshell
environment. This option is enabled when _p_o_s_i_x _m_o_d_e is
If set, command substitution inherits the value of the
eerrrreexxiitt option, instead of unsetting it in the subshell
environment. This option is enabled when _p_o_s_i_x _m_o_d_e is
enabled.
iinntteerraaccttiivvee__ccoommmmeennttss
If set, allow a word beginning with ## to cause that word
and all remaining characters on that line to be ignored
in an interactive shell (see CCOOMMMMEENNTTSS above). This
and all remaining characters on that line to be ignored
in an interactive shell (see CCOOMMMMEENNTTSS above). This
option is enabled by default.
llaassttppiippee
If set, and job control is not active, the shell runs
If set, and job control is not active, the shell runs
the last command of a pipeline not executed in the back-
ground in the current shell environment.
lliitthhiisstt If set, and the ccmmddhhiisstt option is enabled, multi-line
lliitthhiisstt If set, and the ccmmddhhiisstt option is enabled, multi-line
commands are saved to the history with embedded newlines
rather than using semicolon separators where possible.
llooccaallvvaarr__iinnhheerriitt
If set, local variables inherit the value and attributes
of a variable of the same name that exists at a previous
scope before any new value is assigned. The nameref
attribute is not inherited.
llooggiinn__sshheellll
The shell sets this option if it is started as a login
shell (see IINNVVOOCCAATTIIOONN above). The value may not be
@@ -1782,7 +1794,7 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
option is supplied, wwaaiitt waits for any job to terminate and
returns its exit status. If the --ff option is supplied, and job
control is enabled, wwaaiitt forces _i_d to terminate before returning
its status, intead of returning when it changes status. If _i_d
its status, instead of returning when it changes status. If _i_d
specifies a non-existent process or job, the return status is
127. Otherwise, the return status is the exit status of the
last process or job waited for.
+943 -924
View File
File diff suppressed because it is too large Load Diff
+1 -1
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.22.3
%%CreationDate: Mon Apr 3 16:33:54 2017
%%CreationDate: Mon Jun 26 09:16:27 2017
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%DocumentSuppliedResources: procset grops 1.22 3
+3 -3
View File
@@ -2,10 +2,10 @@
Copyright (C) 1988-2017 Free Software Foundation, Inc.
@end ignore
@set LASTCHANGE Thu May 25 16:01:44 EDT 2017
@set LASTCHANGE Fri Jun 23 12:42:54 EDT 2017
@set EDITION 4.4
@set VERSION 4.4
@set UPDATED 25 May 2017
@set UPDATED-MONTH May 2017
@set UPDATED 23 June 2017
@set UPDATED-MONTH June 2017