pmodules/bash
0
0
Fork 0
mirror of https://https.git.savannah.gnu.org/git/bash.git synced 2026-06-28 07:59:50 +02:00
Code Issues Packages Projects Releases Wiki Activity

commit bash-20180302 snapshot

Browse Source
This commit is contained in:
Chet Ramey
2018-03-05 10:22:03 -05:00
parent 6ca5e50062
commit a28518042b
26 changed files with 8468 additions and 8118 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.gitignore
+63
View File
@@ -1,3 +1,66 @@
# don't push out -i
-i
parser-built
*.save
.DS_Store
.DS_Store?
._*
.Spotlight-V100
#
# these files are all created by the build process; none are in the repository
#
*.o
*.a
*.dSYM
.build
.made
Makefile
bash
bashbug
bashversion
builtins/Makefile
builtins/builtext.h
builtins/builtins.c
builtins/mkbuiltins
builtins/pipesize.h
builtins/psize.aux
config.h
config.status
doc/Makefile
examples/loadables/Makefile
examples/loadables/Makefile.inc
examples/loadables/perl/Makefile
lib/glob/Makefile
lib/intl/Makefile
lib/intl/charset.alias
lib/intl/libgnuintl.h
lib/intl/libintl.h
lib/intl/ref-add.sed
lib/intl/ref-del.sed
lib/malloc/Makefile
lib/readline/Makefile
lib/sh/Makefile
lib/termcap/Makefile
lib/tilde/Makefile
lsignames.h
mksignames
mksyntax
pathnames.h
po/Makefile
po/Makefile.in
po/POTFILES
printenv
recho
signames.h
stamp-h
support/Makefile
support/bash.pc
support/man2html
syntax.c
tests/printenv
tests/recho
tests/xcase
tests/zecho
version.h
xcase
zecho
INSTALL
+19 -5
View File
@@ -38,10 +38,24 @@ don't want to keep, you may remove or edit it.
To find out more about the options and arguments that the 'configure'
script understands, type
bash-2.04$ ./configure --help
bash-4.2$ ./configure --help
at the Bash prompt in your Bash source directory.
If you want to build Bash in a directory separate from the source
directory - to build for multiple architectures, for example - just use
the full path to the configure script. The following commands will
build bash in a directory under '/usr/local/build' from the source code
in '/usr/local/src/bash-4.4':
mkdir /usr/local/build/bash-4.4
cd /usr/local/build/bash-4.4
bash /usr/local/src/bash-4.4/configure
make
See *note Compiling For Multiple Architectures:: for more information
about building in a directory separate from the source.
If you need to do unusual things to compile Bash, please try to figure
out how 'configure' could check whether or not to do them, and mail
diffs or instructions to <bash-maintainers@gnu.org> so they can be
@@ -82,10 +96,10 @@ time, by placing the object files for each architecture in their own
directory. To do this, you must use a version of 'make' that supports
the 'VPATH' variable, such as GNU 'make'. 'cd' to the directory where
you want the object files and executables to go and run the 'configure'
script from the source directory. You may need to supply the
'--srcdir=PATH' argument to tell 'configure' where the source files are.
'configure' automatically checks for the source code in the directory
that 'configure' is in and in '..'.
script from the source directory (*note Basic Installation::). You may
need to supply the '--srcdir=PATH' argument to tell 'configure' where
the source files are. 'configure' automatically checks for the source
code in the directory that 'configure' is in and in '..'.
If you have to use a 'make' that does not supports the 'VPATH' variable,
you can compile Bash for one architecture at a time in the source code
doc/bash.0
+443 -423
View File
File diff suppressed because it is too large Load Diff
doc/bash.1
+6 -4
View File
@@ -5,12 +5,12 @@
.\" Case Western Reserve University
.\" chet.ramey@case.edu
.\"
.\" Last Change: Wed Jan 31 11:23:23 EST 2018
.\" Last Change: Fri Mar 2 16:07:55 EST 2018
.\"
.\" bash_builtins, strip all but Built-Ins section
.if \n(zZ=1 .ig zZ
.if \n(zY=1 .ig zY
.TH BASH 1 "2018 January 31" "GNU Bash 4.4"
.TH BASH 1 "2018 March 2" "GNU Bash 4.4"
.\"
.\" There's some problem with having a `@'
.\" in a tagged paragraph with the BSD man macros.
@@ -658,7 +658,7 @@ An OR list has the form
.RE
.PP
.I command2
is executed if and only if
is executed if, and only if,
.I command1
returns a non-zero exit status.
The return status of
@@ -4297,8 +4297,10 @@ The \fBunset\fP builtin also acts using the same dynamic scope: if a
variable is local to the current scope, \fBunset\fP will unset it;
otherwise the unset will refer to the variable found in any calling scope
as described above.
If a variable at the local scope is unset, it will remain so
If a variable at the current local scope is unset, it will remain so
until it is reset in that scope or until the function returns.
Once the function returns, any instance of the variable at a previous
scope will become visible.
If the unset acts on a variable at a previous scope, any instance of a
variable with that name that had been shadowed will become visible.
.PP
doc/bash.html
+38 -12
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 December 28<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2018 March 2<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<BR><A HREF="#index">Index</A>
@@ -42,7 +42,7 @@ bash - GNU Bourne-Again SHell
<H3>COPYRIGHT</H3>
Bash is Copyright &#169; 1989-2017 by the Free Software Foundation, Inc.
Bash is Copyright &#169; 1989-2018 by the Free Software Foundation, Inc.
<A NAME="lbAE">&nbsp;</A>
<H3>DESCRIPTION</H3>
@@ -878,7 +878,7 @@ An OR list has the form
<I>command2</I>
is executed if and only if
is executed if, and only if,
<I>command1</I>
returns a non-zero exit status.
@@ -1224,7 +1224,8 @@ command (see
below).
The file descriptors can be utilized as arguments to shell commands
and redirections using standard word expansions.
The file descriptors are not available in subshells.
Other than those created to execute command and process substitutions,
the file descriptors are not available in subshells.
The process ID of the shell spawned to execute the coprocess is
available as the value of the variable <I>NAME</I>_PID.
The <B>wait</B>
@@ -1920,7 +1921,9 @@ only when in extended debugging mode (see the description of the
option to the
<B>shopt</B>
builtin below)
builtin below).
Setting <B>extdebug</B> after the shell has started to execute a script
may result in inconsistent values.
<DT><B>BASH_ARGV</B>
<DD>
@@ -1943,7 +1946,9 @@ only when in extended debugging mode
option to the
<B>shopt</B>
builtin below)
builtin below).
Setting <B>extdebug</B> after the shell has started to execute a script
may result in inconsistent values.
<DT><B>BASH_ARGV0</B>
<DD>
@@ -5472,8 +5477,10 @@ The <B>unset</B> builtin also acts using the same dynamic scope: if a
variable is local to the current scope, <B>unset</B> will unset it;
otherwise the unset will refer to the variable found in any calling scope
as described above.
If a variable at the local scope is unset, it will remain so
If a variable at the current local scope is unset, it will remain so
until it is reset in that scope or until the function returns.
Once the function returns, any instance of the variable at a previous
scope will become visible.
If the unset acts on a variable at a previous scope, any instance of a
variable with that name that had been shadowed will become visible.
<P>
@@ -8884,7 +8891,7 @@ for information on setting and unsetting shell options.
The shell supports a history expansion feature that
is similar to the history expansion in
<B>csh.</B>
<B>csh</B>.
This section describes what syntax features are available. This
feature is enabled by default for interactive shells, and can be
@@ -10527,7 +10534,7 @@ where a negative number is used as an offset from the current
command number). If
<I>last</I>
is not specified it is set to
is not specified, it is set to
the current command for listing (so that
<TT>fc -l -10</TT>
@@ -10538,7 +10545,7 @@ otherwise.
If
<I>first</I>
is not specified it is set to the previous
is not specified, it is set to the previous
command for editing and -16 for listing.
<P>
The
@@ -10856,6 +10863,7 @@ The return status is 0 unless no command matches
<DT><B>history</B> <B>-c</B><DD>
<DT><B>history -d</B> <I>offset</I><DD>
<DT><B>history -d</B> <I>start</I>-<I>end</I><DD>
<DT><B>history</B> <B>-anrw</B> [<I>filename</I>]<DD>
<DT><B>history</B> <B>-p</B> <I>arg</I> [<I>arg ...</I>]<DD>
<DT><B>history</B> <B>-s</B> <I>arg</I> [<I>arg ...</I>]<DD>
@@ -10900,6 +10908,10 @@ If <I>offset</I> is negative, it is interpreted as relative to one greater
than the last history position, so negative indices count back from the
end of the history, and an index of -1 refers to the current
<B>history -d</B> command.
<DT><B>-d</B> <I>start</I>-<I>end</I><DD>
Delete the history entries between positions <I>start</I> and <I>end</I>,
inclusive. Positive and negative values for <I>start</I> and <I>end</I>
are interpreted as described above.
<DT><B>-a</B>
<DD>
@@ -12279,6 +12291,12 @@ The list of <B>shopt</B> options is:
<DL COMPACT>
<DT><B>assoc_expand_once</B>
<DD>
If set, the shell suppresses multiple evaluation of associative array
subscripts during arithmetic expression evaluation and while executing
builtins that can perform variable assignments.
<DT><B>autocd</B>
<DD>
@@ -12424,6 +12442,14 @@ 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 <B>break</B> or
<B>continue</B> in a shell function to affect loops in the caller's context).
<DT><B>compat44</B>
<DD>
If set,
<B>bash</B>
saves the positional parameters to BASH_ARGV and BASH_ARGC before they are
used, regardless of whether or not extended debugging mode is enabled.
<DT><B>complete_fullquote</B>
<DD>
@@ -13797,7 +13823,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 December 28<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>GNU Bash 4.4<TH ALIGN=CENTER width=33%>2018 March 2<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<HR>
@@ -13903,6 +13929,6 @@ There may be only one active coprocess at a time.
</DL>
<HR>
This document was created by man2html from bash.1.<BR>
Time: 02 January 2018 10:55:16 EST
Time: 02 March 2018 16:08:40 EST
</BODY>
</HTML>
doc/bash.info
+286 -249
View File
@@ -2,12 +2,12 @@ This is bash.info, produced by makeinfo version 6.5 from
bashref.texi.
This text is a brief description of the features that are present in the
Bash shell (version 4.4, 19 December 2017).
Bash shell (version 4.4, 2 March 2018).
This is Edition 4.4, last updated 19 December 2017, of 'The GNU Bash
This is Edition 4.4, last updated 2 March 2018, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Copyright (C) 1988-2017 Free Software Foundation, Inc.
Copyright (C) 1988-2018 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
@@ -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, 19 December 2017). The Bash home page is
Bash shell (version 4.4, 2 March 2018). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 4.4, last updated 19 December 2017, of 'The GNU Bash
This is Edition 4.4, last updated 2 March 2018, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Bash contains features that appear in other popular shells, and some
@@ -1038,7 +1038,8 @@ a file descriptor in the executing shell, and that file descriptor is
assigned to 'NAME'[1]. This pipe is established before any redirections
specified by the command (*note Redirections::). The file descriptors
can be utilized as arguments to shell commands and redirections using
standard word expansions. The file descriptors are not available in
standard word expansions. Other than those created to execute command
and process substitutions, the file descriptors are not available in
subshells.
The process ID of the shell spawned to execute the coprocess is
@@ -1263,10 +1264,12 @@ script displays
The 'unset' builtin also acts using the same dynamic scope: if a
variable is local to the current scope, 'unset' will unset it; otherwise
the unset will refer to the variable found in any calling scope as
described above. If a variable at the local scope is unset, it will
remain so until it is reset in that scope or until the function returns.
If the unset acts on a variable at a previous scope, any instance of a
variable with that name that had been shadowed will become visible.
described above. If a variable at the current local scope is unset, it
will remain so until it is reset in that scope or until the function
returns. Once the function returns, any instance of the variable at a
previous scope will become visible. If the unset acts on a variable at
a previous scope, any instance of a variable with that name that had
been shadowed will become visible.
Function names and definitions may be listed with the '-f' option to
the 'declare' ('typeset') builtin command (*note Bash Builtins::). The
@@ -3050,7 +3053,7 @@ standard.
locations. The '-d' option causes the shell to forget the
remembered location of each NAME. If the '-t' option is supplied,
the full pathname to which each NAME corresponds is printed. If
multiple NAME arguments are supplied with '-t' the NAME is printed
multiple NAME arguments are supplied with '-t', the NAME is printed
before the hashed full pathname. The '-l' option causes output to
be displayed in a format that may be reused as input. If no
arguments are given, or if only '-l' is supplied, information about
@@ -3158,7 +3161,7 @@ standard.
The expression is false.
1 argument
The expression is true if and only if the argument is not
The expression is true if, and only if, the argument is not
null.
2 arguments
@@ -3678,7 +3681,7 @@ standard.
Read lines from file descriptor FD instead of the standard
input.
'-C'
Evaluate CALLBACK each time QUANTUMP lines are read. The '-c'
Evaluate CALLBACK each time QUANTUM lines are read. The '-c'
option specifies QUANTUM.
'-c'
Specify the number of lines read between each call to
@@ -4335,6 +4338,12 @@ This builtin allows you to change additional shell optional behavior.
The list of 'shopt' options is:
'assoc_expand_once'
If set, the shell suppresses multiple evaluation of
associative array subscripts during arithmetic expression
evaluation and while executing builtins that can perform
variable assignments.
'autocd'
If set, a command name that is the name of a directory is
executed as if it were the argument to the 'cd' command. This
@@ -4426,6 +4435,11 @@ This builtin allows you to change additional shell optional behavior.
executed (this allows 'break' or 'continue' in a shell
function to affect loops in the caller's context).
'compat44'
If set, Bash saves the positional parameters to BASH_ARGV and
BASH_ARGC before they are used, regardless of whether or not
extended debugging mode is enabled.
'complete_fullquote'
If set, Bash quotes all shell metacharacters in filenames and
directory names when performing completion. If not set, Bash
@@ -4804,7 +4818,9 @@ Variables::).
subroutine is executed, the number of parameters passed is pushed
onto 'BASH_ARGC'. The shell sets 'BASH_ARGC' only when in extended
debugging mode (see *note The Shopt Builtin:: for a description of
the 'extdebug' option to the 'shopt' builtin).
the 'extdebug' option to the 'shopt' builtin). Setting 'extdebug'
after the shell has started to execute a script may result in
inconsistent values.
'BASH_ARGV'
An array variable containing all of the parameters in the current
@@ -4814,7 +4830,8 @@ Variables::).
the parameters supplied are pushed onto 'BASH_ARGV'. The shell
sets 'BASH_ARGV' only when in extended debugging mode (see *note
The Shopt Builtin:: for a description of the 'extdebug' option to
the 'shopt' builtin).
the 'shopt' builtin). Setting 'extdebug' after the shell has
started to execute a script may result in inconsistent values.
'BASH_ARGV0'
When referenced, this variable expands to the name of the shell or
@@ -9112,7 +9129,7 @@ of a multi-line command in the same history entry, adding semicolons
where necessary to preserve syntactic correctness. The 'lithist' shell
option causes the shell to save the command with embedded newlines
instead of semicolons. The 'shopt' builtin is used to set these
options. *Note Bash Builtins::, for a description of 'shopt'.
options. *Note The Shopt Builtin::, for a description of 'shopt'.

File: bash.info, Node: Bash History Builtins, Next: History Interaction, Prev: Bash History Facilities, Up: Using History Interactively
@@ -9132,8 +9149,8 @@ history file.
FIRST and LAST may be specified as a string (to locate the most
recent command beginning with that string) or as a number (an index
into the history list, where a negative number is used as an offset
from the current command number). If LAST is not specified it is
set to FIRST. If FIRST is not specified it is set to the previous
from the current command number). If LAST is not specified, it is
set to FIRST. If FIRST is not specified, it is set to the previous
command for editing and -16 for listing. If the '-l' flag is
given, the commands are listed on standard output. The '-n' flag
suppresses the command numbers when listing. The '-r' flag
@@ -9157,6 +9174,7 @@ history file.
history [N]
history -c
history -d OFFSET
history -d START-END
history [-anrw] [FILENAME]
history -ps ARG
@@ -9183,6 +9201,11 @@ history file.
history, and an index of '-1' refers to the current 'history
-d' command.
'-d START-END'
Delete the history entries between positions START and END,
inclusive. Positive and negative values for START and END are
interpreted as described above.
'-a'
Append the new history lines to the history file. These are
history lines entered since the beginning of the current Bash
@@ -9247,15 +9270,15 @@ may be used to escape the history expansion character, but the history
expansion character is also treated as quoted if it immediately precedes
the closing double quote in a double-quoted string.
Several shell options settable with the 'shopt' builtin (*note Bash
Builtins::) may be used to tailor the behavior of history expansion. If
the 'histverify' shell option is enabled, and Readline is being used,
history substitutions are not immediately passed to the shell parser.
Instead, the expanded line is reloaded into the Readline editing buffer
for further modification. If Readline is being used, and the
'histreedit' shell option is enabled, a failed history expansion will be
reloaded into the Readline editing buffer for correction. The '-p'
option to the 'history' builtin command may be used to see what a
Several shell options settable with the 'shopt' builtin (*note The
Shopt Builtin::) may be used to tailor the behavior of history
expansion. If the 'histverify' shell option is enabled, and Readline is
being used, history substitutions are not immediately passed to the
shell parser. Instead, the expanded line is reloaded into the Readline
editing buffer for further modification. If Readline is being used, and
the 'histreedit' shell option is enabled, a failed history expansion
will be reloaded into the Readline editing buffer for correction. The
'-p' option to the 'history' builtin command may be used to see what a
history expansion will do before using it. The '-s' option to the
'history' builtin may be used to add commands to the end of the history
list without actually executing them, so that they are available for
@@ -9495,10 +9518,24 @@ don't want to keep, you may remove or edit it.
To find out more about the options and arguments that the 'configure'
script understands, type
bash-2.04$ ./configure --help
bash-4.2$ ./configure --help
at the Bash prompt in your Bash source directory.
If you want to build Bash in a directory separate from the source
directory - to build for multiple architectures, for example - just use
the full path to the configure script. The following commands will
build bash in a directory under '/usr/local/build' from the source code
in '/usr/local/src/bash-4.4':
mkdir /usr/local/build/bash-4.4
cd /usr/local/build/bash-4.4
bash /usr/local/src/bash-4.4/configure
make
See *note Compiling For Multiple Architectures:: for more information
about building in a directory separate from the source.
If you need to do unusual things to compile Bash, please try to
figure out how 'configure' could check whether or not to do them, and
mail diffs or instructions to <bash-maintainers@gnu.org> so they can be
@@ -9545,10 +9582,10 @@ time, by placing the object files for each architecture in their own
directory. To do this, you must use a version of 'make' that supports
the 'VPATH' variable, such as GNU 'make'. 'cd' to the directory where
you want the object files and executables to go and run the 'configure'
script from the source directory. You may need to supply the
'--srcdir=PATH' argument to tell 'configure' where the source files are.
'configure' automatically checks for the source code in the directory
that 'configure' is in and in '..'.
script from the source directory (*note Basic Installation::). You may
need to supply the '--srcdir=PATH' argument to tell 'configure' where
the source files are. 'configure' automatically checks for the source
code in the directory that 'configure' is in and in '..'.
If you have to use a 'make' that does not supports the 'VPATH'
variable, you can compile Bash for one architecture at a time in the
@@ -10985,21 +11022,21 @@ D.3 Parameter and Variable Index
* BASHPID: Bash Variables. (line 25)
* BASH_ALIASES: Bash Variables. (line 32)
* BASH_ARGC: Bash Variables. (line 41)
* BASH_ARGV: Bash Variables. (line 51)
* BASH_ARGV0: Bash Variables. (line 61)
* BASH_CMDS: Bash Variables. (line 69)
* BASH_COMMAND: Bash Variables. (line 78)
* BASH_COMPAT: Bash Variables. (line 83)
* BASH_ENV: Bash Variables. (line 98)
* BASH_EXECUTION_STRING: Bash Variables. (line 104)
* BASH_LINENO: Bash Variables. (line 107)
* BASH_LOADABLES_PATH: Bash Variables. (line 115)
* BASH_REMATCH: Bash Variables. (line 119)
* BASH_SOURCE: Bash Variables. (line 127)
* BASH_SUBSHELL: Bash Variables. (line 134)
* BASH_VERSINFO: Bash Variables. (line 139)
* BASH_VERSION: Bash Variables. (line 162)
* BASH_XTRACEFD: Bash Variables. (line 165)
* BASH_ARGV: Bash Variables. (line 53)
* BASH_ARGV0: Bash Variables. (line 64)
* BASH_CMDS: Bash Variables. (line 72)
* BASH_COMMAND: Bash Variables. (line 81)
* BASH_COMPAT: Bash Variables. (line 86)
* BASH_ENV: Bash Variables. (line 101)
* BASH_EXECUTION_STRING: Bash Variables. (line 107)
* BASH_LINENO: Bash Variables. (line 110)
* BASH_LOADABLES_PATH: Bash Variables. (line 118)
* BASH_REMATCH: Bash Variables. (line 122)
* BASH_SOURCE: Bash Variables. (line 130)
* BASH_SUBSHELL: Bash Variables. (line 137)
* BASH_VERSINFO: Bash Variables. (line 142)
* BASH_VERSION: Bash Variables. (line 165)
* BASH_XTRACEFD: Bash Variables. (line 168)
* bell-style: Readline Init File Syntax.
(line 38)
* bind-tty-special-chars: Readline Init File Syntax.
@@ -11008,12 +11045,12 @@ D.3 Parameter and Variable Index
(line 50)
* CDPATH: Bourne Shell Variables.
(line 9)
* CHILD_MAX: Bash Variables. (line 176)
* CHILD_MAX: Bash Variables. (line 179)
* colored-completion-prefix: Readline Init File Syntax.
(line 55)
* colored-stats: Readline Init File Syntax.
(line 62)
* COLUMNS: Bash Variables. (line 183)
* COLUMNS: Bash Variables. (line 186)
* comment-begin: Readline Init File Syntax.
(line 68)
* completion-display-width: Readline Init File Syntax.
@@ -11026,90 +11063,90 @@ D.3 Parameter and Variable Index
(line 91)
* completion-query-items: Readline Init File Syntax.
(line 98)
* COMPREPLY: Bash Variables. (line 235)
* COMP_CWORD: Bash Variables. (line 189)
* COMP_KEY: Bash Variables. (line 218)
* COMP_LINE: Bash Variables. (line 195)
* COMP_POINT: Bash Variables. (line 200)
* COMP_TYPE: Bash Variables. (line 208)
* COMP_WORDBREAKS: Bash Variables. (line 222)
* COMP_WORDS: Bash Variables. (line 228)
* COMPREPLY: Bash Variables. (line 238)
* COMP_CWORD: Bash Variables. (line 192)
* COMP_KEY: Bash Variables. (line 221)
* COMP_LINE: Bash Variables. (line 198)
* COMP_POINT: Bash Variables. (line 203)
* COMP_TYPE: Bash Variables. (line 211)
* COMP_WORDBREAKS: Bash Variables. (line 225)
* COMP_WORDS: Bash Variables. (line 231)
* convert-meta: Readline Init File Syntax.
(line 108)
* COPROC: Bash Variables. (line 241)
* DIRSTACK: Bash Variables. (line 245)
* COPROC: Bash Variables. (line 244)
* DIRSTACK: Bash Variables. (line 248)
* disable-completion: Readline Init File Syntax.
(line 116)
* echo-control-characters: Readline Init File Syntax.
(line 121)
* editing-mode: Readline Init File Syntax.
(line 126)
* EMACS: Bash Variables. (line 255)
* EMACS: Bash Variables. (line 258)
* emacs-mode-string: Readline Init File Syntax.
(line 132)
* enable-bracketed-paste: Readline Init File Syntax.
(line 142)
* enable-keypad: Readline Init File Syntax.
(line 150)
* ENV: Bash Variables. (line 260)
* EPOCHREALTIME: Bash Variables. (line 264)
* EPOCHSECONDS: Bash Variables. (line 272)
* EUID: Bash Variables. (line 279)
* EXECIGNORE: Bash Variables. (line 283)
* ENV: Bash Variables. (line 263)
* EPOCHREALTIME: Bash Variables. (line 267)
* EPOCHSECONDS: Bash Variables. (line 275)
* EUID: Bash Variables. (line 282)
* EXECIGNORE: Bash Variables. (line 286)
* expand-tilde: Readline Init File Syntax.
(line 161)
* FCEDIT: Bash Variables. (line 296)
* FIGNORE: Bash Variables. (line 300)
* FUNCNAME: Bash Variables. (line 306)
* FUNCNEST: Bash Variables. (line 323)
* GLOBIGNORE: Bash Variables. (line 328)
* GROUPS: Bash Variables. (line 335)
* histchars: Bash Variables. (line 341)
* HISTCMD: Bash Variables. (line 356)
* HISTCONTROL: Bash Variables. (line 361)
* HISTFILE: Bash Variables. (line 377)
* HISTFILESIZE: Bash Variables. (line 381)
* HISTIGNORE: Bash Variables. (line 392)
* FCEDIT: Bash Variables. (line 299)
* FIGNORE: Bash Variables. (line 303)
* FUNCNAME: Bash Variables. (line 309)
* FUNCNEST: Bash Variables. (line 326)
* GLOBIGNORE: Bash Variables. (line 331)
* GROUPS: Bash Variables. (line 338)
* histchars: Bash Variables. (line 344)
* HISTCMD: Bash Variables. (line 359)
* HISTCONTROL: Bash Variables. (line 364)
* HISTFILE: Bash Variables. (line 380)
* HISTFILESIZE: Bash Variables. (line 384)
* HISTIGNORE: Bash Variables. (line 395)
* history-preserve-point: Readline Init File Syntax.
(line 165)
* history-size: Readline Init File Syntax.
(line 171)
* HISTSIZE: Bash Variables. (line 412)
* HISTTIMEFORMAT: Bash Variables. (line 419)
* HISTSIZE: Bash Variables. (line 415)
* HISTTIMEFORMAT: Bash Variables. (line 422)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 180)
* HOSTFILE: Bash Variables. (line 427)
* HOSTNAME: Bash Variables. (line 438)
* HOSTTYPE: Bash Variables. (line 441)
* HOSTFILE: Bash Variables. (line 430)
* HOSTNAME: Bash Variables. (line 441)
* HOSTTYPE: Bash Variables. (line 444)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 444)
* IGNOREEOF: Bash Variables. (line 447)
* input-meta: Readline Init File Syntax.
(line 187)
* INPUTRC: Bash Variables. (line 454)
* INPUTRC: Bash Variables. (line 457)
* isearch-terminators: Readline Init File Syntax.
(line 195)
* keymap: Readline Init File Syntax.
(line 202)
* LANG: Bash Variables. (line 458)
* LC_ALL: Bash Variables. (line 462)
* LC_COLLATE: Bash Variables. (line 466)
* LC_CTYPE: Bash Variables. (line 473)
* LANG: Bash Variables. (line 461)
* LC_ALL: Bash Variables. (line 465)
* LC_COLLATE: Bash Variables. (line 469)
* LC_CTYPE: Bash Variables. (line 476)
* LC_MESSAGES: Locale Translation. (line 11)
* LC_MESSAGES <1>: Bash Variables. (line 478)
* LC_NUMERIC: Bash Variables. (line 482)
* LC_TIME: Bash Variables. (line 486)
* LINENO: Bash Variables. (line 490)
* LINES: Bash Variables. (line 494)
* MACHTYPE: Bash Variables. (line 500)
* LC_MESSAGES <1>: Bash Variables. (line 481)
* LC_NUMERIC: Bash Variables. (line 485)
* LC_TIME: Bash Variables. (line 489)
* LINENO: Bash Variables. (line 493)
* LINES: Bash Variables. (line 497)
* MACHTYPE: Bash Variables. (line 503)
* MAIL: Bourne Shell Variables.
(line 22)
* MAILCHECK: Bash Variables. (line 504)
* MAILCHECK: Bash Variables. (line 507)
* MAILPATH: Bourne Shell Variables.
(line 27)
* MAPFILE: Bash Variables. (line 512)
* MAPFILE: Bash Variables. (line 515)
* mark-modified-lines: Readline Init File Syntax.
(line 232)
* mark-symlinked-directories: Readline Init File Syntax.
@@ -11120,42 +11157,42 @@ D.3 Parameter and Variable Index
(line 249)
* meta-flag: Readline Init File Syntax.
(line 187)
* OLDPWD: Bash Variables. (line 516)
* OLDPWD: Bash Variables. (line 519)
* OPTARG: Bourne Shell Variables.
(line 34)
* OPTERR: Bash Variables. (line 519)
* OPTERR: Bash Variables. (line 522)
* OPTIND: Bourne Shell Variables.
(line 38)
* OSTYPE: Bash Variables. (line 523)
* OSTYPE: Bash Variables. (line 526)
* output-meta: Readline Init File Syntax.
(line 254)
* page-completions: Readline Init File Syntax.
(line 260)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 526)
* POSIXLY_CORRECT: Bash Variables. (line 531)
* PPID: Bash Variables. (line 540)
* PROMPT_COMMAND: Bash Variables. (line 544)
* PROMPT_DIRTRIM: Bash Variables. (line 548)
* PS0: Bash Variables. (line 554)
* PIPESTATUS: Bash Variables. (line 529)
* POSIXLY_CORRECT: Bash Variables. (line 534)
* PPID: Bash Variables. (line 543)
* PROMPT_COMMAND: Bash Variables. (line 547)
* PROMPT_DIRTRIM: Bash Variables. (line 551)
* PS0: Bash Variables. (line 557)
* PS1: Bourne Shell Variables.
(line 48)
* PS2: Bourne Shell Variables.
(line 53)
* PS3: Bash Variables. (line 559)
* PS4: Bash Variables. (line 564)
* PWD: Bash Variables. (line 572)
* RANDOM: Bash Variables. (line 575)
* READLINE_LINE: Bash Variables. (line 580)
* READLINE_POINT: Bash Variables. (line 584)
* REPLY: Bash Variables. (line 588)
* PS3: Bash Variables. (line 562)
* PS4: Bash Variables. (line 567)
* PWD: Bash Variables. (line 575)
* RANDOM: Bash Variables. (line 578)
* READLINE_LINE: Bash Variables. (line 583)
* READLINE_POINT: Bash Variables. (line 587)
* REPLY: Bash Variables. (line 591)
* revert-all-at-newline: Readline Init File Syntax.
(line 270)
* SECONDS: Bash Variables. (line 591)
* SHELL: Bash Variables. (line 597)
* SHELLOPTS: Bash Variables. (line 602)
* SHLVL: Bash Variables. (line 611)
* SECONDS: Bash Variables. (line 594)
* SHELL: Bash Variables. (line 600)
* SHELLOPTS: Bash Variables. (line 605)
* SHLVL: Bash Variables. (line 614)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 276)
* show-all-if-unmodified: Readline Init File Syntax.
@@ -11166,10 +11203,10 @@ D.3 Parameter and Variable Index
(line 297)
* TEXTDOMAIN: Locale Translation. (line 11)
* TEXTDOMAINDIR: Locale Translation. (line 11)
* TIMEFORMAT: Bash Variables. (line 616)
* TMOUT: Bash Variables. (line 654)
* TMPDIR: Bash Variables. (line 666)
* UID: Bash Variables. (line 670)
* TIMEFORMAT: Bash Variables. (line 619)
* TMOUT: Bash Variables. (line 657)
* TMPDIR: Bash Variables. (line 669)
* UID: Bash Variables. (line 673)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 310)
* vi-ins-mode-string: Readline Init File Syntax.
@@ -11538,134 +11575,134 @@ D.5 Concept Index

Tag Table:
Node: Top897
Node: Introduction2817
Node: What is Bash?3033
Node: What is a shell?4147
Node: Definitions6685
Node: Basic Shell Features9636
Node: Shell Syntax10855
Node: Shell Operation11881
Node: Quoting13174
Node: Escape Character14474
Node: Single Quotes14959
Node: Double Quotes15307
Node: ANSI-C Quoting16585
Node: Locale Translation17844
Node: Comments18740
Node: Shell Commands19358
Node: Simple Commands20230
Node: Pipelines20861
Node: Lists23793
Node: Compound Commands25532
Node: Looping Constructs26544
Node: Conditional Constructs29039
Node: Command Grouping40094
Node: Coprocesses41573
Node: GNU Parallel43405
Node: Shell Functions47379
Node: Shell Parameters54355
Node: Positional Parameters58768
Node: Special Parameters59668
Node: Shell Expansions63005
Node: Brace Expansion65128
Node: Tilde Expansion67852
Node: Shell Parameter Expansion70200
Node: Command Substitution84488
Node: Arithmetic Expansion85843
Node: Process Substitution86775
Node: Word Splitting87895
Node: Filename Expansion89839
Node: Pattern Matching92213
Node: Quote Removal96199
Node: Redirections96494
Node: Executing Commands106052
Node: Simple Command Expansion106722
Node: Command Search and Execution108652
Node: Command Execution Environment111028
Node: Environment114012
Node: Exit Status115671
Node: Signals117341
Node: Shell Scripts119308
Node: Shell Builtin Commands121823
Node: Bourne Shell Builtins123861
Node: Bash Builtins144516
Node: Modifying Shell Behavior173425
Node: The Set Builtin173770
Node: The Shopt Builtin184183
Node: Special Builtins200592
Node: Shell Variables201571
Node: Bourne Shell Variables202008
Node: Bash Variables204112
Node: Bash Features233905
Node: Invoking Bash234804
Node: Bash Startup Files240790
Node: Interactive Shells245893
Node: What is an Interactive Shell?246303
Node: Is this Shell Interactive?246952
Node: Interactive Shell Behavior247767
Node: Bash Conditional Expressions251255
Node: Shell Arithmetic255621
Node: Aliases258438
Node: Arrays260986
Node: The Directory Stack266352
Node: Directory Stack Builtins267136
Node: Controlling the Prompt270104
Node: The Restricted Shell272866
Node: Bash POSIX Mode274691
Node: Job Control285042
Node: Job Control Basics285502
Node: Job Control Builtins290470
Node: Job Control Variables295197
Node: Command Line Editing296353
Node: Introduction and Notation298024
Node: Readline Interaction299647
Node: Readline Bare Essentials300838
Node: Readline Movement Commands302621
Node: Readline Killing Commands303581
Node: Readline Arguments305499
Node: Searching306543
Node: Readline Init File308729
Node: Readline Init File Syntax309876
Node: Conditional Init Constructs330247
Node: Sample Init File334443
Node: Bindable Readline Commands337560
Node: Commands For Moving338764
Node: Commands For History340613
Node: Commands For Text344908
Node: Commands For Killing348297
Node: Numeric Arguments350778
Node: Commands For Completion351917
Node: Keyboard Macros356108
Node: Miscellaneous Commands356795
Node: Readline vi Mode362748
Node: Programmable Completion363655
Node: Programmable Completion Builtins371116
Node: A Programmable Completion Example381002
Node: Using History Interactively386253
Node: Bash History Facilities386937
Node: Bash History Builtins389938
Node: History Interaction394230
Node: Event Designators397292
Node: Word Designators398511
Node: Modifiers400148
Node: Installing Bash401550
Node: Basic Installation402687
Node: Compilers and Options405378
Node: Compiling For Multiple Architectures406119
Node: Installation Names407782
Node: Specifying the System Type408600
Node: Sharing Defaults409316
Node: Operation Controls409989
Node: Optional Features410947
Node: Reporting Bugs421473
Node: Major Differences From The Bourne Shell422667
Node: GNU Free Documentation License439519
Node: Indexes464696
Node: Builtin Index465150
Node: Reserved Word Index471977
Node: Variable Index474425
Node: Function Index490103
Node: Concept Index503406
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 Parallel43460
Node: Shell Functions47434
Node: Shell Parameters54517
Node: Positional Parameters58930
Node: Special Parameters59830
Node: Shell Expansions63167
Node: Brace Expansion65290
Node: Tilde Expansion68014
Node: Shell Parameter Expansion70362
Node: Command Substitution84650
Node: Arithmetic Expansion86005
Node: Process Substitution86937
Node: Word Splitting88057
Node: Filename Expansion90001
Node: Pattern Matching92375
Node: Quote Removal96361
Node: Redirections96656
Node: Executing Commands106214
Node: Simple Command Expansion106884
Node: Command Search and Execution108814
Node: Command Execution Environment111190
Node: Environment114174
Node: Exit Status115833
Node: Signals117503
Node: Shell Scripts119470
Node: Shell Builtin Commands121985
Node: Bourne Shell Builtins124023
Node: Bash Builtins144681
Node: Modifying Shell Behavior173589
Node: The Set Builtin173934
Node: The Shopt Builtin184347
Node: Special Builtins201217
Node: Shell Variables202196
Node: Bourne Shell Variables202633
Node: Bash Variables204737
Node: Bash Features234751
Node: Invoking Bash235650
Node: Bash Startup Files241636
Node: Interactive Shells246739
Node: What is an Interactive Shell?247149
Node: Is this Shell Interactive?247798
Node: Interactive Shell Behavior248613
Node: Bash Conditional Expressions252101
Node: Shell Arithmetic256467
Node: Aliases259284
Node: Arrays261832
Node: The Directory Stack267198
Node: Directory Stack Builtins267982
Node: Controlling the Prompt270950
Node: The Restricted Shell273712
Node: Bash POSIX Mode275537
Node: Job Control285888
Node: Job Control Basics286348
Node: Job Control Builtins291316
Node: Job Control Variables296043
Node: Command Line Editing297199
Node: Introduction and Notation298870
Node: Readline Interaction300493
Node: Readline Bare Essentials301684
Node: Readline Movement Commands303467
Node: Readline Killing Commands304427
Node: Readline Arguments306345
Node: Searching307389
Node: Readline Init File309575
Node: Readline Init File Syntax310722
Node: Conditional Init Constructs331093
Node: Sample Init File335289
Node: Bindable Readline Commands338406
Node: Commands For Moving339610
Node: Commands For History341459
Node: Commands For Text345754
Node: Commands For Killing349143
Node: Numeric Arguments351624
Node: Commands For Completion352763
Node: Keyboard Macros356954
Node: Miscellaneous Commands357641
Node: Readline vi Mode363594
Node: Programmable Completion364501
Node: Programmable Completion Builtins371962
Node: A Programmable Completion Example381848
Node: Using History Interactively387099
Node: Bash History Facilities387783
Node: Bash History Builtins390788
Node: History Interaction395319
Node: Event Designators398386
Node: Word Designators399605
Node: Modifiers401242
Node: Installing Bash402644
Node: Basic Installation403781
Node: Compilers and Options407039
Node: Compiling For Multiple Architectures407780
Node: Installation Names409473
Node: Specifying the System Type410291
Node: Sharing Defaults411007
Node: Operation Controls411680
Node: Optional Features412638
Node: Reporting Bugs423164
Node: Major Differences From The Bourne Shell424358
Node: GNU Free Documentation License441210
Node: Indexes466387
Node: Builtin Index466841
Node: Reserved Word Index473668
Node: Variable Index476116
Node: Function Index491794
Node: Concept Index505097

End Tag Table
doc/bash.pdf
BIN
View File
Binary file not shown.
doc/bash.ps
+4293 -4263
View File
File diff suppressed because it is too large Load Diff
doc/bashref.aux
+6 -6
View File
@@ -332,29 +332,29 @@
@xrdef{Installing Bash-snt}{Chapter@tie 10}
@xrdef{Basic Installation-title}{Basic Installation}
@xrdef{Basic Installation-snt}{Section@tie 10.1}
@xrdef{Compilers and Options-title}{Compilers and Options}
@xrdef{Compilers and Options-snt}{Section@tie 10.2}
@xrdef{Installing Bash-pg}{145}
@xrdef{Basic Installation-pg}{145}
@xrdef{Compilers and Options-title}{Compilers and Options}
@xrdef{Compilers and Options-snt}{Section@tie 10.2}
@xrdef{Compiling For Multiple Architectures-title}{Compiling For Multiple Architectures}
@xrdef{Compiling For Multiple Architectures-snt}{Section@tie 10.3}
@xrdef{Installation Names-title}{Installation Names}
@xrdef{Installation Names-snt}{Section@tie 10.4}
@xrdef{Specifying the System Type-title}{Specifying the System Type}
@xrdef{Specifying the System Type-snt}{Section@tie 10.5}
@xrdef{Compilers and Options-pg}{146}
@xrdef{Compiling For Multiple Architectures-pg}{146}
@xrdef{Installation Names-pg}{146}
@xrdef{Specifying the System Type-pg}{146}
@xrdef{Specifying the System Type-title}{Specifying the System Type}
@xrdef{Specifying the System Type-snt}{Section@tie 10.5}
@xrdef{Sharing Defaults-title}{Sharing Defaults}
@xrdef{Sharing Defaults-snt}{Section@tie 10.6}
@xrdef{Operation Controls-title}{Operation Controls}
@xrdef{Operation Controls-snt}{Section@tie 10.7}
@xrdef{Optional Features-title}{Optional Features}
@xrdef{Optional Features-snt}{Section@tie 10.8}
@xrdef{Specifying the System Type-pg}{147}
@xrdef{Sharing Defaults-pg}{147}
@xrdef{Operation Controls-pg}{147}
@xrdef{Optional Features-pg}{147}
@xrdef{Optional Features-pg}{148}
@xrdef{Reporting Bugs-title}{Reporting Bugs}
@xrdef{Reporting Bugs-snt}{Appendix@tie @char65{}}
@xrdef{Reporting Bugs-pg}{153}
doc/bashref.bt
+1 -1
View File
@@ -55,5 +55,5 @@
\entry{compgen}{133}{\code {compgen}}
\entry{complete}{133}{\code {complete}}
\entry{compopt}{136}{\code {compopt}}
\entry{fc}{140}{\code {fc}}
\entry{fc}{141}{\code {fc}}
\entry{history}{141}{\code {history}}
doc/bashref.bts
+1 -1
View File
@@ -31,7 +31,7 @@
\entry {\code {exit}}{45}
\entry {\code {export}}{45}
\initial {F}
\entry {\code {fc}}{140}
\entry {\code {fc}}{141}
\entry {\code {fg}}{103}
\initial {G}
\entry {\code {getopts}}{45}
doc/bashref.dvi
BIN
View File
Binary file not shown.
doc/bashref.html
+60 -16
View File
@@ -1,13 +1,13 @@
<!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, 19 December 2017).
the Bash shell (version 4.4, 2 March 2018).
This is Edition 4.4, last updated 19 December 2017,
This is Edition 4.4, last updated 2 March 2018,
of The GNU Bash Reference Manual,
for Bash, Version 4.4.
Copyright (C) 1988-2017 Free Software Foundation, Inc.
Copyright (C) 1988-2018 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
@@ -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, 19 December 2017).
the Bash shell (version 4.4, 2 March 2018).
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 19 December 2017,
<p>This is Edition 4.4, last updated 2 March 2018,
of <cite>The GNU Bash Reference Manual</cite>,
for <code>Bash</code>, Version 4.4.
</p>
@@ -1644,7 +1644,8 @@ This pipe is established before any redirections specified by the
command (see <a href="#Redirections">Redirections</a>).
The file descriptors can be utilized as arguments to shell commands
and redirections using standard word expansions.
The file descriptors are not available in subshells.
Other than those created to execute command and process substitutions,
the file descriptors are not available in subshells.
</p>
<p>The process ID of the shell spawned to execute the coprocess is
available as the value of the variable <code>NAME</code>_PID.
@@ -1930,8 +1931,10 @@ func1
variable is local to the current scope, <code>unset</code> will unset it;
otherwise the unset will refer to the variable found in any calling scope
as described above.
If a variable at the local scope is unset, it will remain so
If a variable at the current local scope is unset, it will remain so
until it is reset in that scope or until the function returns.
Once the function returns, any instance of the variable at a previous
scope will become visible.
If the unset acts on a variable at a previous scope, any instance of a
variable with that name that had been shadowed will become visible.
</p>
@@ -4252,7 +4255,7 @@ The <samp>-d</samp> option causes the shell to forget the remembered location
of each <var>name</var>.
If the <samp>-t</samp> option is supplied, the full pathname to which each
<var>name</var> corresponds is printed. If multiple <var>name</var> arguments are
supplied with <samp>-t</samp> the <var>name</var> is printed before the hashed
supplied with <samp>-t</samp>, the <var>name</var> is printed before the hashed
full pathname.
The <samp>-l</samp> option causes output to be displayed in a format
that may be reused as input.
@@ -4405,7 +4408,7 @@ expressions using a set of rules based on the number of arguments.
</p>
</dd>
<dt>1 argument</dt>
<dd><p>The expression is true if and only if the argument is not null.
<dd><p>The expression is true if, and only if, the argument is not null.
</p>
</dd>
<dt>2 arguments</dt>
@@ -5103,7 +5106,7 @@ The default index is 0.
<dd><p>Read lines from file descriptor <var>fd</var> instead of the standard input.
</p></dd>
<dt><code>-C</code></dt>
<dd><p>Evaluate <var>callback</var> each time <var>quantum</var>P lines are read.
<dd><p>Evaluate <var>callback</var> each time <var>quantum</var> lines are read.
The <samp>-c</samp> option specifies <var>quantum</var>.
</p></dd>
<dt><code>-c</code></dt>
@@ -5943,6 +5946,12 @@ option.
</p>
<p>The list of <code>shopt</code> options is:
</p><dl compact="compact">
<dt><code>assoc_expand_once</code></dt>
<dd><p>If set, the shell suppresses multiple evaluation of associative array
subscripts during arithmetic expression evaluation and while executing
builtins that can perform variable assignments.
</p>
</dd>
<dt><code>autocd</code></dt>
<dd><p>If set, a command name that is the name of a directory is executed as if
it were the argument to the <code>cd</code> command.
@@ -6052,6 +6061,12 @@ loop state when a shell function is executed (this allows <code>break</code> or
<code>continue</code> in a shell function to affect loops in the caller&rsquo;s context).
</p>
</dd>
<dt><code>compat44</code></dt>
<dd><p>If set, Bash
saves the positional parameters to BASH_ARGV and BASH_ARGC before they are
used, regardless of whether or not extended debugging mode is enabled.
</p>
</dd>
<dt><code>complete_fullquote</code></dt>
<dd><p>If set, Bash
quotes all shell metacharacters in filenames and directory names when
@@ -6553,6 +6568,8 @@ The shell sets <code>BASH_ARGC</code> only when in extended debugging mode
(see <a href="#The-Shopt-Builtin">The Shopt Builtin</a>
for a description of the <code>extdebug</code> option to the <code>shopt</code>
builtin).
Setting <code>extdebug</code> after the shell has started to execute a script
may result in inconsistent values.
</p>
</dd>
<dt><code>BASH_ARGV</code>
@@ -6567,6 +6584,8 @@ The shell sets <code>BASH_ARGV</code> only when in extended debugging mode
(see <a href="#The-Shopt-Builtin">The Shopt Builtin</a>
for a description of the <code>extdebug</code> option to the <code>shopt</code>
builtin).
Setting <code>extdebug</code> after the shell has started to execute a script
may result in inconsistent values.
</p>
</dd>
<dt><code>BASH_ARGV0</code>
@@ -12441,7 +12460,7 @@ The <code>lithist</code>
shell option causes the shell to save the command with embedded newlines
instead of semicolons.
The <code>shopt</code> builtin is used to set these options.
See <a href="#Bash-Builtins">Bash Builtins</a>, for a description of <code>shopt</code>.
See <a href="#The-Shopt-Builtin">The Shopt Builtin</a>, for a description of <code>shopt</code>.
</p>
<hr>
<a name="Bash-History-Builtins"></a>
@@ -12471,8 +12490,8 @@ Both <var>first</var> and
<var>last</var> may be specified as a string (to locate the most recent
command beginning with that string) or as a number (an index into the
history list, where a negative number is used as an offset from the
current command number). If <var>last</var> is not specified it is set to
<var>first</var>. If <var>first</var> is not specified it is set to the previous
current command number). If <var>last</var> is not specified, it is set to
<var>first</var>. If <var>first</var> is not specified, it is set to the previous
command for editing and -16 for listing. If the <samp>-l</samp> flag is
given, the commands are listed on standard output. The <samp>-n</samp> flag
suppresses the command numbers when listing. The <samp>-r</samp> flag
@@ -12499,6 +12518,7 @@ and typing &lsquo;<samp>r</samp>&rsquo; re-executes the last command (see <a hre
<pre class="example">history [<var>n</var>]
history -c
history -d <var>offset</var>
history -d <var>start</var>-<var>end</var>
history [-anrw] [<var>filename</var>]
history -ps <var>arg</var>
</pre></div>
@@ -12530,6 +12550,12 @@ end of the history, and an index of &lsquo;<samp>-1</samp>&rsquo; refers to the
<code>history -d</code> command.
</p>
</dd>
<dt><code>-d <var>start</var>-<var>end</var></code></dt>
<dd><p>Delete the history entries between positions <var>start</var> and <var>end</var>,
inclusive. Positive and negative values for <var>start</var> and <var>end</var>
are interpreted as described above.
</p>
</dd>
<dt><code>-a</code></dt>
<dd><p>Append the new history lines to the history file.
These are history lines entered since the beginning of the current
@@ -12612,7 +12638,7 @@ also treated as quoted if it immediately precedes the closing double quote
in a double-quoted string.
</p>
<p>Several shell options settable with the <code>shopt</code>
builtin (see <a href="#Bash-Builtins">Bash Builtins</a>) may be used to tailor
builtin (see <a href="#The-Shopt-Builtin">The Shopt Builtin</a>) may be used to tailor
the behavior of history expansion. If the
<code>histverify</code> shell option is enabled, and Readline
is being used, history substitutions are not immediately passed to
@@ -12955,11 +12981,27 @@ may remove or edit it.
<code>configure</code> script understands, type
</p>
<div class="example">
<pre class="example">bash-2.04$ ./configure --help
<pre class="example">bash-4.2$ ./configure --help
</pre></div>
<p>at the Bash prompt in your Bash source directory.
</p>
<p>If you want to build Bash in a directory separate from the source
directory &ndash; to build for multiple architectures, for example &ndash;
just use the full path to the configure script. The following commands
will build bash in a directory under <samp>/usr/local/build</samp> from
the source code in <samp>/usr/local/src/bash-4.4</samp>:
</p>
<div class="example">
<pre class="example">mkdir /usr/local/build/bash-4.4
cd /usr/local/build/bash-4.4
bash /usr/local/src/bash-4.4/configure
make
</pre></div>
<p>See <a href="#Compiling-For-Multiple-Architectures">Compiling For Multiple Architectures</a> for more information
about building in a directory separate from the source.
</p>
<p>If you need to do unusual things to compile Bash, please
try to figure out how <code>configure</code> could check whether or not
to do them, and mail diffs or instructions to
@@ -13021,7 +13063,9 @@ own directory. To do this, you must use a version of <code>make</code> that
supports the <code>VPATH</code> variable, such as GNU <code>make</code>.
<code>cd</code> to the
directory where you want the object files and executables to go and run
the <code>configure</code> script from the source directory. You may need to
the <code>configure</code> script from the source directory
(see <a href="#Basic-Installation">Basic Installation</a>).
You may need to
supply the <samp>--srcdir=PATH</samp> argument to tell <code>configure</code> where the
source files are. <code>configure</code> automatically checks for the
source code in the directory that <code>configure</code> is in and in &lsquo;..&rsquo;.
doc/bashref.info
+286 -249
View File
@@ -2,12 +2,12 @@ This is bashref.info, produced by makeinfo version 6.5 from
bashref.texi.
This text is a brief description of the features that are present in the
Bash shell (version 4.4, 19 December 2017).
Bash shell (version 4.4, 2 March 2018).
This is Edition 4.4, last updated 19 December 2017, of 'The GNU Bash
This is Edition 4.4, last updated 2 March 2018, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Copyright (C) 1988-2017 Free Software Foundation, Inc.
Copyright (C) 1988-2018 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
@@ -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, 19 December 2017). The Bash home page is
Bash shell (version 4.4, 2 March 2018). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 4.4, last updated 19 December 2017, of 'The GNU Bash
This is Edition 4.4, last updated 2 March 2018, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Bash contains features that appear in other popular shells, and some
@@ -1038,7 +1038,8 @@ a file descriptor in the executing shell, and that file descriptor is
assigned to 'NAME'[1]. This pipe is established before any redirections
specified by the command (*note Redirections::). The file descriptors
can be utilized as arguments to shell commands and redirections using
standard word expansions. The file descriptors are not available in
standard word expansions. Other than those created to execute command
and process substitutions, the file descriptors are not available in
subshells.
The process ID of the shell spawned to execute the coprocess is
@@ -1263,10 +1264,12 @@ script displays
The 'unset' builtin also acts using the same dynamic scope: if a
variable is local to the current scope, 'unset' will unset it; otherwise
the unset will refer to the variable found in any calling scope as
described above. If a variable at the local scope is unset, it will
remain so until it is reset in that scope or until the function returns.
If the unset acts on a variable at a previous scope, any instance of a
variable with that name that had been shadowed will become visible.
described above. If a variable at the current local scope is unset, it
will remain so until it is reset in that scope or until the function
returns. Once the function returns, any instance of the variable at a
previous scope will become visible. If the unset acts on a variable at
a previous scope, any instance of a variable with that name that had
been shadowed will become visible.
Function names and definitions may be listed with the '-f' option to
the 'declare' ('typeset') builtin command (*note Bash Builtins::). The
@@ -3050,7 +3053,7 @@ standard.
locations. The '-d' option causes the shell to forget the
remembered location of each NAME. If the '-t' option is supplied,
the full pathname to which each NAME corresponds is printed. If
multiple NAME arguments are supplied with '-t' the NAME is printed
multiple NAME arguments are supplied with '-t', the NAME is printed
before the hashed full pathname. The '-l' option causes output to
be displayed in a format that may be reused as input. If no
arguments are given, or if only '-l' is supplied, information about
@@ -3158,7 +3161,7 @@ standard.
The expression is false.
1 argument
The expression is true if and only if the argument is not
The expression is true if, and only if, the argument is not
null.
2 arguments
@@ -3678,7 +3681,7 @@ standard.
Read lines from file descriptor FD instead of the standard
input.
'-C'
Evaluate CALLBACK each time QUANTUMP lines are read. The '-c'
Evaluate CALLBACK each time QUANTUM lines are read. The '-c'
option specifies QUANTUM.
'-c'
Specify the number of lines read between each call to
@@ -4335,6 +4338,12 @@ This builtin allows you to change additional shell optional behavior.
The list of 'shopt' options is:
'assoc_expand_once'
If set, the shell suppresses multiple evaluation of
associative array subscripts during arithmetic expression
evaluation and while executing builtins that can perform
variable assignments.
'autocd'
If set, a command name that is the name of a directory is
executed as if it were the argument to the 'cd' command. This
@@ -4426,6 +4435,11 @@ This builtin allows you to change additional shell optional behavior.
executed (this allows 'break' or 'continue' in a shell
function to affect loops in the caller's context).
'compat44'
If set, Bash saves the positional parameters to BASH_ARGV and
BASH_ARGC before they are used, regardless of whether or not
extended debugging mode is enabled.
'complete_fullquote'
If set, Bash quotes all shell metacharacters in filenames and
directory names when performing completion. If not set, Bash
@@ -4804,7 +4818,9 @@ Variables::).
subroutine is executed, the number of parameters passed is pushed
onto 'BASH_ARGC'. The shell sets 'BASH_ARGC' only when in extended
debugging mode (see *note The Shopt Builtin:: for a description of
the 'extdebug' option to the 'shopt' builtin).
the 'extdebug' option to the 'shopt' builtin). Setting 'extdebug'
after the shell has started to execute a script may result in
inconsistent values.
'BASH_ARGV'
An array variable containing all of the parameters in the current
@@ -4814,7 +4830,8 @@ Variables::).
the parameters supplied are pushed onto 'BASH_ARGV'. The shell
sets 'BASH_ARGV' only when in extended debugging mode (see *note
The Shopt Builtin:: for a description of the 'extdebug' option to
the 'shopt' builtin).
the 'shopt' builtin). Setting 'extdebug' after the shell has
started to execute a script may result in inconsistent values.
'BASH_ARGV0'
When referenced, this variable expands to the name of the shell or
@@ -9112,7 +9129,7 @@ of a multi-line command in the same history entry, adding semicolons
where necessary to preserve syntactic correctness. The 'lithist' shell
option causes the shell to save the command with embedded newlines
instead of semicolons. The 'shopt' builtin is used to set these
options. *Note Bash Builtins::, for a description of 'shopt'.
options. *Note The Shopt Builtin::, for a description of 'shopt'.

File: bashref.info, Node: Bash History Builtins, Next: History Interaction, Prev: Bash History Facilities, Up: Using History Interactively
@@ -9132,8 +9149,8 @@ history file.
FIRST and LAST may be specified as a string (to locate the most
recent command beginning with that string) or as a number (an index
into the history list, where a negative number is used as an offset
from the current command number). If LAST is not specified it is
set to FIRST. If FIRST is not specified it is set to the previous
from the current command number). If LAST is not specified, it is
set to FIRST. If FIRST is not specified, it is set to the previous
command for editing and -16 for listing. If the '-l' flag is
given, the commands are listed on standard output. The '-n' flag
suppresses the command numbers when listing. The '-r' flag
@@ -9157,6 +9174,7 @@ history file.
history [N]
history -c
history -d OFFSET
history -d START-END
history [-anrw] [FILENAME]
history -ps ARG
@@ -9183,6 +9201,11 @@ history file.
history, and an index of '-1' refers to the current 'history
-d' command.
'-d START-END'
Delete the history entries between positions START and END,
inclusive. Positive and negative values for START and END are
interpreted as described above.
'-a'
Append the new history lines to the history file. These are
history lines entered since the beginning of the current Bash
@@ -9247,15 +9270,15 @@ may be used to escape the history expansion character, but the history
expansion character is also treated as quoted if it immediately precedes
the closing double quote in a double-quoted string.
Several shell options settable with the 'shopt' builtin (*note Bash
Builtins::) may be used to tailor the behavior of history expansion. If
the 'histverify' shell option is enabled, and Readline is being used,
history substitutions are not immediately passed to the shell parser.
Instead, the expanded line is reloaded into the Readline editing buffer
for further modification. If Readline is being used, and the
'histreedit' shell option is enabled, a failed history expansion will be
reloaded into the Readline editing buffer for correction. The '-p'
option to the 'history' builtin command may be used to see what a
Several shell options settable with the 'shopt' builtin (*note The
Shopt Builtin::) may be used to tailor the behavior of history
expansion. If the 'histverify' shell option is enabled, and Readline is
being used, history substitutions are not immediately passed to the
shell parser. Instead, the expanded line is reloaded into the Readline
editing buffer for further modification. If Readline is being used, and
the 'histreedit' shell option is enabled, a failed history expansion
will be reloaded into the Readline editing buffer for correction. The
'-p' option to the 'history' builtin command may be used to see what a
history expansion will do before using it. The '-s' option to the
'history' builtin may be used to add commands to the end of the history
list without actually executing them, so that they are available for
@@ -9495,10 +9518,24 @@ don't want to keep, you may remove or edit it.
To find out more about the options and arguments that the 'configure'
script understands, type
bash-2.04$ ./configure --help
bash-4.2$ ./configure --help
at the Bash prompt in your Bash source directory.
If you want to build Bash in a directory separate from the source
directory - to build for multiple architectures, for example - just use
the full path to the configure script. The following commands will
build bash in a directory under '/usr/local/build' from the source code
in '/usr/local/src/bash-4.4':
mkdir /usr/local/build/bash-4.4
cd /usr/local/build/bash-4.4
bash /usr/local/src/bash-4.4/configure
make
See *note Compiling For Multiple Architectures:: for more information
about building in a directory separate from the source.
If you need to do unusual things to compile Bash, please try to
figure out how 'configure' could check whether or not to do them, and
mail diffs or instructions to <bash-maintainers@gnu.org> so they can be
@@ -9545,10 +9582,10 @@ time, by placing the object files for each architecture in their own
directory. To do this, you must use a version of 'make' that supports
the 'VPATH' variable, such as GNU 'make'. 'cd' to the directory where
you want the object files and executables to go and run the 'configure'
script from the source directory. You may need to supply the
'--srcdir=PATH' argument to tell 'configure' where the source files are.
'configure' automatically checks for the source code in the directory
that 'configure' is in and in '..'.
script from the source directory (*note Basic Installation::). You may
need to supply the '--srcdir=PATH' argument to tell 'configure' where
the source files are. 'configure' automatically checks for the source
code in the directory that 'configure' is in and in '..'.
If you have to use a 'make' that does not supports the 'VPATH'
variable, you can compile Bash for one architecture at a time in the
@@ -10985,21 +11022,21 @@ D.3 Parameter and Variable Index
* BASHPID: Bash Variables. (line 25)
* BASH_ALIASES: Bash Variables. (line 32)
* BASH_ARGC: Bash Variables. (line 41)
* BASH_ARGV: Bash Variables. (line 51)
* BASH_ARGV0: Bash Variables. (line 61)
* BASH_CMDS: Bash Variables. (line 69)
* BASH_COMMAND: Bash Variables. (line 78)
* BASH_COMPAT: Bash Variables. (line 83)
* BASH_ENV: Bash Variables. (line 98)
* BASH_EXECUTION_STRING: Bash Variables. (line 104)
* BASH_LINENO: Bash Variables. (line 107)
* BASH_LOADABLES_PATH: Bash Variables. (line 115)
* BASH_REMATCH: Bash Variables. (line 119)
* BASH_SOURCE: Bash Variables. (line 127)
* BASH_SUBSHELL: Bash Variables. (line 134)
* BASH_VERSINFO: Bash Variables. (line 139)
* BASH_VERSION: Bash Variables. (line 162)
* BASH_XTRACEFD: Bash Variables. (line 165)
* BASH_ARGV: Bash Variables. (line 53)
* BASH_ARGV0: Bash Variables. (line 64)
* BASH_CMDS: Bash Variables. (line 72)
* BASH_COMMAND: Bash Variables. (line 81)
* BASH_COMPAT: Bash Variables. (line 86)
* BASH_ENV: Bash Variables. (line 101)
* BASH_EXECUTION_STRING: Bash Variables. (line 107)
* BASH_LINENO: Bash Variables. (line 110)
* BASH_LOADABLES_PATH: Bash Variables. (line 118)
* BASH_REMATCH: Bash Variables. (line 122)
* BASH_SOURCE: Bash Variables. (line 130)
* BASH_SUBSHELL: Bash Variables. (line 137)
* BASH_VERSINFO: Bash Variables. (line 142)
* BASH_VERSION: Bash Variables. (line 165)
* BASH_XTRACEFD: Bash Variables. (line 168)
* bell-style: Readline Init File Syntax.
(line 38)
* bind-tty-special-chars: Readline Init File Syntax.
@@ -11008,12 +11045,12 @@ D.3 Parameter and Variable Index
(line 50)
* CDPATH: Bourne Shell Variables.
(line 9)
* CHILD_MAX: Bash Variables. (line 176)
* CHILD_MAX: Bash Variables. (line 179)
* colored-completion-prefix: Readline Init File Syntax.
(line 55)
* colored-stats: Readline Init File Syntax.
(line 62)
* COLUMNS: Bash Variables. (line 183)
* COLUMNS: Bash Variables. (line 186)
* comment-begin: Readline Init File Syntax.
(line 68)
* completion-display-width: Readline Init File Syntax.
@@ -11026,90 +11063,90 @@ D.3 Parameter and Variable Index
(line 91)
* completion-query-items: Readline Init File Syntax.
(line 98)
* COMPREPLY: Bash Variables. (line 235)
* COMP_CWORD: Bash Variables. (line 189)
* COMP_KEY: Bash Variables. (line 218)
* COMP_LINE: Bash Variables. (line 195)
* COMP_POINT: Bash Variables. (line 200)
* COMP_TYPE: Bash Variables. (line 208)
* COMP_WORDBREAKS: Bash Variables. (line 222)
* COMP_WORDS: Bash Variables. (line 228)
* COMPREPLY: Bash Variables. (line 238)
* COMP_CWORD: Bash Variables. (line 192)
* COMP_KEY: Bash Variables. (line 221)
* COMP_LINE: Bash Variables. (line 198)
* COMP_POINT: Bash Variables. (line 203)
* COMP_TYPE: Bash Variables. (line 211)
* COMP_WORDBREAKS: Bash Variables. (line 225)
* COMP_WORDS: Bash Variables. (line 231)
* convert-meta: Readline Init File Syntax.
(line 108)
* COPROC: Bash Variables. (line 241)
* DIRSTACK: Bash Variables. (line 245)
* COPROC: Bash Variables. (line 244)
* DIRSTACK: Bash Variables. (line 248)
* disable-completion: Readline Init File Syntax.
(line 116)
* echo-control-characters: Readline Init File Syntax.
(line 121)
* editing-mode: Readline Init File Syntax.
(line 126)
* EMACS: Bash Variables. (line 255)
* EMACS: Bash Variables. (line 258)
* emacs-mode-string: Readline Init File Syntax.
(line 132)
* enable-bracketed-paste: Readline Init File Syntax.
(line 142)
* enable-keypad: Readline Init File Syntax.
(line 150)
* ENV: Bash Variables. (line 260)
* EPOCHREALTIME: Bash Variables. (line 264)
* EPOCHSECONDS: Bash Variables. (line 272)
* EUID: Bash Variables. (line 279)
* EXECIGNORE: Bash Variables. (line 283)
* ENV: Bash Variables. (line 263)
* EPOCHREALTIME: Bash Variables. (line 267)
* EPOCHSECONDS: Bash Variables. (line 275)
* EUID: Bash Variables. (line 282)
* EXECIGNORE: Bash Variables. (line 286)
* expand-tilde: Readline Init File Syntax.
(line 161)
* FCEDIT: Bash Variables. (line 296)
* FIGNORE: Bash Variables. (line 300)
* FUNCNAME: Bash Variables. (line 306)
* FUNCNEST: Bash Variables. (line 323)
* GLOBIGNORE: Bash Variables. (line 328)
* GROUPS: Bash Variables. (line 335)
* histchars: Bash Variables. (line 341)
* HISTCMD: Bash Variables. (line 356)
* HISTCONTROL: Bash Variables. (line 361)
* HISTFILE: Bash Variables. (line 377)
* HISTFILESIZE: Bash Variables. (line 381)
* HISTIGNORE: Bash Variables. (line 392)
* FCEDIT: Bash Variables. (line 299)
* FIGNORE: Bash Variables. (line 303)
* FUNCNAME: Bash Variables. (line 309)
* FUNCNEST: Bash Variables. (line 326)
* GLOBIGNORE: Bash Variables. (line 331)
* GROUPS: Bash Variables. (line 338)
* histchars: Bash Variables. (line 344)
* HISTCMD: Bash Variables. (line 359)
* HISTCONTROL: Bash Variables. (line 364)
* HISTFILE: Bash Variables. (line 380)
* HISTFILESIZE: Bash Variables. (line 384)
* HISTIGNORE: Bash Variables. (line 395)
* history-preserve-point: Readline Init File Syntax.
(line 165)
* history-size: Readline Init File Syntax.
(line 171)
* HISTSIZE: Bash Variables. (line 412)
* HISTTIMEFORMAT: Bash Variables. (line 419)
* HISTSIZE: Bash Variables. (line 415)
* HISTTIMEFORMAT: Bash Variables. (line 422)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 180)
* HOSTFILE: Bash Variables. (line 427)
* HOSTNAME: Bash Variables. (line 438)
* HOSTTYPE: Bash Variables. (line 441)
* HOSTFILE: Bash Variables. (line 430)
* HOSTNAME: Bash Variables. (line 441)
* HOSTTYPE: Bash Variables. (line 444)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 444)
* IGNOREEOF: Bash Variables. (line 447)
* input-meta: Readline Init File Syntax.
(line 187)
* INPUTRC: Bash Variables. (line 454)
* INPUTRC: Bash Variables. (line 457)
* isearch-terminators: Readline Init File Syntax.
(line 195)
* keymap: Readline Init File Syntax.
(line 202)
* LANG: Bash Variables. (line 458)
* LC_ALL: Bash Variables. (line 462)
* LC_COLLATE: Bash Variables. (line 466)
* LC_CTYPE: Bash Variables. (line 473)
* LANG: Bash Variables. (line 461)
* LC_ALL: Bash Variables. (line 465)
* LC_COLLATE: Bash Variables. (line 469)
* LC_CTYPE: Bash Variables. (line 476)
* LC_MESSAGES: Locale Translation. (line 11)
* LC_MESSAGES <1>: Bash Variables. (line 478)
* LC_NUMERIC: Bash Variables. (line 482)
* LC_TIME: Bash Variables. (line 486)
* LINENO: Bash Variables. (line 490)
* LINES: Bash Variables. (line 494)
* MACHTYPE: Bash Variables. (line 500)
* LC_MESSAGES <1>: Bash Variables. (line 481)
* LC_NUMERIC: Bash Variables. (line 485)
* LC_TIME: Bash Variables. (line 489)
* LINENO: Bash Variables. (line 493)
* LINES: Bash Variables. (line 497)
* MACHTYPE: Bash Variables. (line 503)
* MAIL: Bourne Shell Variables.
(line 22)
* MAILCHECK: Bash Variables. (line 504)
* MAILCHECK: Bash Variables. (line 507)
* MAILPATH: Bourne Shell Variables.
(line 27)
* MAPFILE: Bash Variables. (line 512)
* MAPFILE: Bash Variables. (line 515)
* mark-modified-lines: Readline Init File Syntax.
(line 232)
* mark-symlinked-directories: Readline Init File Syntax.
@@ -11120,42 +11157,42 @@ D.3 Parameter and Variable Index
(line 249)
* meta-flag: Readline Init File Syntax.
(line 187)
* OLDPWD: Bash Variables. (line 516)
* OLDPWD: Bash Variables. (line 519)
* OPTARG: Bourne Shell Variables.
(line 34)
* OPTERR: Bash Variables. (line 519)
* OPTERR: Bash Variables. (line 522)
* OPTIND: Bourne Shell Variables.
(line 38)
* OSTYPE: Bash Variables. (line 523)
* OSTYPE: Bash Variables. (line 526)
* output-meta: Readline Init File Syntax.
(line 254)
* page-completions: Readline Init File Syntax.
(line 260)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 526)
* POSIXLY_CORRECT: Bash Variables. (line 531)
* PPID: Bash Variables. (line 540)
* PROMPT_COMMAND: Bash Variables. (line 544)
* PROMPT_DIRTRIM: Bash Variables. (line 548)
* PS0: Bash Variables. (line 554)
* PIPESTATUS: Bash Variables. (line 529)
* POSIXLY_CORRECT: Bash Variables. (line 534)
* PPID: Bash Variables. (line 543)
* PROMPT_COMMAND: Bash Variables. (line 547)
* PROMPT_DIRTRIM: Bash Variables. (line 551)
* PS0: Bash Variables. (line 557)
* PS1: Bourne Shell Variables.
(line 48)
* PS2: Bourne Shell Variables.
(line 53)
* PS3: Bash Variables. (line 559)
* PS4: Bash Variables. (line 564)
* PWD: Bash Variables. (line 572)
* RANDOM: Bash Variables. (line 575)
* READLINE_LINE: Bash Variables. (line 580)
* READLINE_POINT: Bash Variables. (line 584)
* REPLY: Bash Variables. (line 588)
* PS3: Bash Variables. (line 562)
* PS4: Bash Variables. (line 567)
* PWD: Bash Variables. (line 575)
* RANDOM: Bash Variables. (line 578)
* READLINE_LINE: Bash Variables. (line 583)
* READLINE_POINT: Bash Variables. (line 587)
* REPLY: Bash Variables. (line 591)
* revert-all-at-newline: Readline Init File Syntax.
(line 270)
* SECONDS: Bash Variables. (line 591)
* SHELL: Bash Variables. (line 597)
* SHELLOPTS: Bash Variables. (line 602)
* SHLVL: Bash Variables. (line 611)
* SECONDS: Bash Variables. (line 594)
* SHELL: Bash Variables. (line 600)
* SHELLOPTS: Bash Variables. (line 605)
* SHLVL: Bash Variables. (line 614)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 276)
* show-all-if-unmodified: Readline Init File Syntax.
@@ -11166,10 +11203,10 @@ D.3 Parameter and Variable Index
(line 297)
* TEXTDOMAIN: Locale Translation. (line 11)
* TEXTDOMAINDIR: Locale Translation. (line 11)
* TIMEFORMAT: Bash Variables. (line 616)
* TMOUT: Bash Variables. (line 654)
* TMPDIR: Bash Variables. (line 666)
* UID: Bash Variables. (line 670)
* TIMEFORMAT: Bash Variables. (line 619)
* TMOUT: Bash Variables. (line 657)
* TMPDIR: Bash Variables. (line 669)
* UID: Bash Variables. (line 673)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 310)
* vi-ins-mode-string: Readline Init File Syntax.
@@ -11538,134 +11575,134 @@ D.5 Concept Index

Tag Table:
Node: Top897
Node: Introduction2817
Node: What is Bash?3033
Node: What is a shell?4147
Node: Definitions6685
Node: Basic Shell Features9636
Node: Shell Syntax10855
Node: Shell Operation11881
Node: Quoting13174
Node: Escape Character14474
Node: Single Quotes14959
Node: Double Quotes15307
Node: ANSI-C Quoting16585
Node: Locale Translation17844
Node: Comments18740
Node: Shell Commands19358
Node: Simple Commands20230
Node: Pipelines20861
Node: Lists23793
Node: Compound Commands25532
Node: Looping Constructs26544
Node: Conditional Constructs29039
Node: Command Grouping40094
Node: Coprocesses41573
Node: GNU Parallel43405
Node: Shell Functions47379
Node: Shell Parameters54355
Node: Positional Parameters58768
Node: Special Parameters59668
Node: Shell Expansions63005
Node: Brace Expansion65128
Node: Tilde Expansion67852
Node: Shell Parameter Expansion70200
Node: Command Substitution84488
Node: Arithmetic Expansion85843
Node: Process Substitution86775
Node: Word Splitting87895
Node: Filename Expansion89839
Node: Pattern Matching92213
Node: Quote Removal96199
Node: Redirections96494
Node: Executing Commands106052
Node: Simple Command Expansion106722
Node: Command Search and Execution108652
Node: Command Execution Environment111028
Node: Environment114012
Node: Exit Status115671
Node: Signals117341
Node: Shell Scripts119308
Node: Shell Builtin Commands121823
Node: Bourne Shell Builtins123861
Node: Bash Builtins144516
Node: Modifying Shell Behavior173425
Node: The Set Builtin173770
Node: The Shopt Builtin184183
Node: Special Builtins200592
Node: Shell Variables201571
Node: Bourne Shell Variables202008
Node: Bash Variables204112
Node: Bash Features233905
Node: Invoking Bash234804
Node: Bash Startup Files240790
Node: Interactive Shells245893
Node: What is an Interactive Shell?246303
Node: Is this Shell Interactive?246952
Node: Interactive Shell Behavior247767
Node: Bash Conditional Expressions251255
Node: Shell Arithmetic255621
Node: Aliases258438
Node: Arrays260986
Node: The Directory Stack266352
Node: Directory Stack Builtins267136
Node: Controlling the Prompt270104
Node: The Restricted Shell272866
Node: Bash POSIX Mode274691
Node: Job Control285042
Node: Job Control Basics285502
Node: Job Control Builtins290470
Node: Job Control Variables295197
Node: Command Line Editing296353
Node: Introduction and Notation298024
Node: Readline Interaction299647
Node: Readline Bare Essentials300838
Node: Readline Movement Commands302621
Node: Readline Killing Commands303581
Node: Readline Arguments305499
Node: Searching306543
Node: Readline Init File308729
Node: Readline Init File Syntax309876
Node: Conditional Init Constructs330247
Node: Sample Init File334443
Node: Bindable Readline Commands337560
Node: Commands For Moving338764
Node: Commands For History340613
Node: Commands For Text344908
Node: Commands For Killing348297
Node: Numeric Arguments350778
Node: Commands For Completion351917
Node: Keyboard Macros356108
Node: Miscellaneous Commands356795
Node: Readline vi Mode362748
Node: Programmable Completion363655
Node: Programmable Completion Builtins371116
Node: A Programmable Completion Example381002
Node: Using History Interactively386253
Node: Bash History Facilities386937
Node: Bash History Builtins389938
Node: History Interaction394230
Node: Event Designators397292
Node: Word Designators398511
Node: Modifiers400148
Node: Installing Bash401550
Node: Basic Installation402687
Node: Compilers and Options405378
Node: Compiling For Multiple Architectures406119
Node: Installation Names407782
Node: Specifying the System Type408600
Node: Sharing Defaults409316
Node: Operation Controls409989
Node: Optional Features410947
Node: Reporting Bugs421473
Node: Major Differences From The Bourne Shell422667
Node: GNU Free Documentation License439519
Node: Indexes464696
Node: Builtin Index465150
Node: Reserved Word Index471977
Node: Variable Index474425
Node: Function Index490103
Node: Concept Index503406
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 Parallel43460
Node: Shell Functions47434
Node: Shell Parameters54517
Node: Positional Parameters58930
Node: Special Parameters59830
Node: Shell Expansions63167
Node: Brace Expansion65290
Node: Tilde Expansion68014
Node: Shell Parameter Expansion70362
Node: Command Substitution84650
Node: Arithmetic Expansion86005
Node: Process Substitution86937
Node: Word Splitting88057
Node: Filename Expansion90001
Node: Pattern Matching92375
Node: Quote Removal96361
Node: Redirections96656
Node: Executing Commands106214
Node: Simple Command Expansion106884
Node: Command Search and Execution108814
Node: Command Execution Environment111190
Node: Environment114174
Node: Exit Status115833
Node: Signals117503
Node: Shell Scripts119470
Node: Shell Builtin Commands121985
Node: Bourne Shell Builtins124023
Node: Bash Builtins144681
Node: Modifying Shell Behavior173589
Node: The Set Builtin173934
Node: The Shopt Builtin184347
Node: Special Builtins201217
Node: Shell Variables202196
Node: Bourne Shell Variables202633
Node: Bash Variables204737
Node: Bash Features234751
Node: Invoking Bash235650
Node: Bash Startup Files241636
Node: Interactive Shells246739
Node: What is an Interactive Shell?247149
Node: Is this Shell Interactive?247798
Node: Interactive Shell Behavior248613
Node: Bash Conditional Expressions252101
Node: Shell Arithmetic256467
Node: Aliases259284
Node: Arrays261832
Node: The Directory Stack267198
Node: Directory Stack Builtins267982
Node: Controlling the Prompt270950
Node: The Restricted Shell273712
Node: Bash POSIX Mode275537
Node: Job Control285888
Node: Job Control Basics286348
Node: Job Control Builtins291316
Node: Job Control Variables296043
Node: Command Line Editing297199
Node: Introduction and Notation298870
Node: Readline Interaction300493
Node: Readline Bare Essentials301684
Node: Readline Movement Commands303467
Node: Readline Killing Commands304427
Node: Readline Arguments306345
Node: Searching307389
Node: Readline Init File309575
Node: Readline Init File Syntax310722
Node: Conditional Init Constructs331093
Node: Sample Init File335289
Node: Bindable Readline Commands338406
Node: Commands For Moving339610
Node: Commands For History341459
Node: Commands For Text345754
Node: Commands For Killing349143
Node: Numeric Arguments351624
Node: Commands For Completion352763
Node: Keyboard Macros356954
Node: Miscellaneous Commands357641
Node: Readline vi Mode363594
Node: Programmable Completion364501
Node: Programmable Completion Builtins371962
Node: A Programmable Completion Example381848
Node: Using History Interactively387099
Node: Bash History Facilities387783
Node: Bash History Builtins390788
Node: History Interaction395319
Node: Event Designators398386
Node: Word Designators399605
Node: Modifiers401242
Node: Installing Bash402644
Node: Basic Installation403781
Node: Compilers and Options407039
Node: Compiling For Multiple Architectures407780
Node: Installation Names409473
Node: Specifying the System Type410291
Node: Sharing Defaults411007
Node: Operation Controls411680
Node: Optional Features412638
Node: Reporting Bugs423164
Node: Major Differences From The Bourne Shell424358
Node: GNU Free Documentation License441210
Node: Indexes466387
Node: Builtin Index466841
Node: Reserved Word Index473668
Node: Variable Index476116
Node: Function Index491794
Node: Concept Index505097

End Tag Table
doc/bashref.log
+13 -13
View File
@@ -1,4 +1,4 @@
This is pdfTeX, Version 3.14159265-2.6-1.40.18 (TeX Live 2017/MacPorts 2017_2) (preloaded format=pdfetex 2017.7.5) 2 JAN 2018 10:55
This is pdfTeX, Version 3.14159265-2.6-1.40.18 (TeX Live 2017/MacPorts 2017_2) (preloaded format=pdfetex 2017.7.5) 2 MAR 2018 16:08
entering extended mode
restricted \write18 enabled.
file:line:error style messages enabled.
@@ -198,7 +198,7 @@ textttsl pattern@texttt ][]) @textttsl command-list @texttt ;;][] esac[]
.etc.
[11] [12] [13] [14] [15]
Overfull \hbox (89.6747pt too wide) in paragraph at lines 1285--1285
Overfull \hbox (89.6747pt too wide) in paragraph at lines 1286--1286
[]@texttt cat list | parallel "do-something1 {} config-{} ; do-something2 < {}
" | process-output[]
@@ -211,7 +211,7 @@ Overfull \hbox (89.6747pt too wide) in paragraph at lines 1285--1285
.etc.
[16]
Overfull \hbox (89.6747pt too wide) in paragraph at lines 1308--1308
Overfull \hbox (89.6747pt too wide) in paragraph at lines 1309--1309
[]@texttt { echo foss.org.my ; echo debian.org; echo freenetproject.org; } | p
arallel traceroute[]
@@ -224,7 +224,7 @@ arallel traceroute[]
.etc.
Overfull \hbox (106.92076pt too wide) in paragraph at lines 1314--1314
Overfull \hbox (106.92076pt too wide) in paragraph at lines 1315--1315
[]@texttt { echo foss.org.my ; echo debian.org; echo freenetproject.org; } | p
arallel -k traceroute[]
@@ -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 4347--4347
Overfull \hbox (26.76846pt too wide) in paragraph at lines 4350--4350
[]@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 4555--4555
Overfull \hbox (38.26584pt too wide) in paragraph at lines 4558--4558
[]@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 4555--4555
[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 6310--6310
Overfull \hbox (49.43388pt too wide) in paragraph at lines 6327--6327
[]@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 6311--6311
Overfull \hbox (72.42863pt too wide) in paragraph at lines 6328--6328
[]@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 6311--6311
.etc.
Overfull \hbox (32.18782pt too wide) in paragraph at lines 6312--6312
Overfull \hbox (32.18782pt too wide) in paragraph at lines 6329--6329
[]@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 497104
47069 string characters out of 6206767
136559 words of memory out of 5000000
136546 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, 745404 bytes).
Output written on bashref.pdf (182 pages, 747172 bytes).
PDF statistics:
2608 PDF objects out of 2984 (max. 8388607)
2381 compressed objects within 24 object streams
2611 PDF objects out of 2984 (max. 8388607)
2384 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)
doc/bashref.pdf
BIN
View File
Binary file not shown.
doc/bashref.ps
+1390 -1349
View File
File diff suppressed because it is too large Load Diff
doc/bashref.texi
+11 -4
View File
@@ -1490,8 +1490,10 @@ The @code{unset} builtin also acts using the same dynamic scope: if a
variable is local to the current scope, @code{unset} will unset it;
otherwise the unset will refer to the variable found in any calling scope
as described above.
If a variable at the local scope is unset, it will remain so
If a variable at the current local scope is unset, it will remain so
until it is reset in that scope or until the function returns.
Once the function returns, any instance of the variable at a previous
scope will become visible.
If the unset acts on a variable at a previous scope, any instance of a
variable with that name that had been shadowed will become visible.
@@ -3748,7 +3750,7 @@ expressions using a set of rules based on the number of arguments.
The expression is false.
@item 1 argument
The expression is true if and only if the argument is not null.
The expression is true if, and only if, the argument is not null.
@item 2 arguments
If the first argument is @samp{!}, the expression is true if and
@@ -8158,7 +8160,7 @@ To find out more about the options and arguments that the
@code{configure} script understands, type
@example
bash-2.04$ ./configure --help
bash-4.2$ ./configure --help
@end example
@noindent
@@ -8177,6 +8179,9 @@ bash /usr/local/src/bash-4.4/configure
make
@end example
See @ref{Compiling For Multiple Architectures} for more information
about building in a directory separate from the source.
If you need to do unusual things to compile Bash, please
try to figure out how @code{configure} could check whether or not
to do them, and mail diffs or instructions to
@@ -8226,7 +8231,9 @@ own directory. To do this, you must use a version of @code{make} that
supports the @code{VPATH} variable, such as GNU @code{make}.
@code{cd} to the
directory where you want the object files and executables to go and run
the @code{configure} script from the source directory. You may need to
the @code{configure} script from the source directory
(@pxref{Basic Installation}).
You may need to
supply the @option{--srcdir=PATH} argument to tell @code{configure} where the
source files are. @code{configure} automatically checks for the
source code in the directory that @code{configure} is in and in `..'.
doc/bashref.toc
+2 -2
View File
@@ -123,10 +123,10 @@
@numsecentry{Compilers and Options}{10.2}{Compilers and Options}{146}
@numsecentry{Compiling For Multiple Architectures}{10.3}{Compiling For Multiple Architectures}{146}
@numsecentry{Installation Names}{10.4}{Installation Names}{146}
@numsecentry{Specifying the System Type}{10.5}{Specifying the System Type}{146}
@numsecentry{Specifying the System Type}{10.5}{Specifying the System Type}{147}
@numsecentry{Sharing Defaults}{10.6}{Sharing Defaults}{147}
@numsecentry{Operation Controls}{10.7}{Operation Controls}{147}
@numsecentry{Optional Features}{10.8}{Optional Features}{147}
@numsecentry{Optional Features}{10.8}{Optional Features}{148}
@appentry{Reporting Bugs}{A}{Reporting Bugs}{153}
@appentry{Major Differences From The Bourne Shell}{B}{Major Differences From The Bourne Shell}{154}
@appsecentry{Implementation Differences From The SVR4.2 Shell}{B.1}{}{158}
doc/bashref.vr
+1 -1
View File
@@ -51,7 +51,7 @@
\entry{BASH_XTRACEFD}{75}{\code {BASH_XTRACEFD}}
\entry{CHILD_MAX}{75}{\code {CHILD_MAX}}
\entry{COLUMNS}{75}{\code {COLUMNS}}
\entry{COMP_CWORD}{75}{\code {COMP_CWORD}}
\entry{COMP_CWORD}{76}{\code {COMP_CWORD}}
\entry{COMP_LINE}{76}{\code {COMP_LINE}}
\entry{COMP_POINT}{76}{\code {COMP_POINT}}
\entry{COMP_TYPE}{76}{\code {COMP_TYPE}}
doc/bashref.vrs
+1 -1
View File
@@ -58,7 +58,7 @@
\entry {\code {colored-stats}}{110}
\entry {\code {COLUMNS}}{75}
\entry {\code {comment-begin}}{110}
\entry {\code {COMP_CWORD}}{75}
\entry {\code {COMP_CWORD}}{76}
\entry {\code {COMP_KEY}}{76}
\entry {\code {COMP_LINE}}{76}
\entry {\code {COMP_POINT}}{76}
doc/builtins.0
+251 -237
View File
@@ -583,9 +583,9 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
the last command beginning with that string) or as a number (an
index into the history list, where a negative number is used as
an offset from the current command number). If _l_a_s_t is not
specified it is set to the current command for listing (so that
specified, it is set to the current command for listing (so that
``fc -l -10'' prints the last 10 commands) and to _f_i_r_s_t other-
wise. If _f_i_r_s_t is not specified it is set to the previous com-
wise. If _f_i_r_s_t is not specified, it is set to the previous com-
mand for editing and -16 for listing.
The --nn option suppresses the command numbers when listing. The
@@ -699,6 +699,7 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
hhiissttoorryy [[_n]]
hhiissttoorryy --cc
hhiissttoorryy --dd _o_f_f_s_e_t
hhiissttoorryy --dd _s_t_a_r_t-_e_n_d
hhiissttoorryy --aannrrww [_f_i_l_e_n_a_m_e]
hhiissttoorryy --pp _a_r_g [_a_r_g _._._.]
hhiissttoorryy --ss _a_r_g [_a_r_g _._._.]
@@ -719,6 +720,10 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
than the last history position, so negative indices count
back from the end of the history, and an index of -1
refers to the current hhiissttoorryy --dd command.
--dd _s_t_a_r_t-_e_n_d
Delete the history entries between positions _s_t_a_r_t and
_e_n_d, inclusive. Positive and negative values for _s_t_a_r_t
and _e_n_d are interpreted as described above.
--aa Append the ``new'' history lines to the history file.
These are history lines entered since the beginning of
the current bbaasshh session, but not already appended to the
@@ -1288,250 +1293,259 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
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-
aassssoocc__eexxppaanndd__oonnccee
If set, the shell suppresses multiple evaluation of
associative array subscripts during arithmetic expres-
sion evaluation and while executing builtins that can
perform variable assignments.
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 external
(non-builtin) command and, if necessary, updates the
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
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).
ccoommppaatt4444
If set, bbaasshh saves the positional parameters to
BASH_ARGV and BASH_ARGC before they are used, regardless
of whether or not extended debugging mode is enabled.
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
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
The shell sets this option if it is started as a login
shell (see IINNVVOOCCAATTIIOONN above). The value may not be
changed.
mmaaiillwwaarrnn
If set, and a file that bbaasshh is checking for mail has
been accessed since the last time it was checked, the
message ``The mail in _m_a_i_l_f_i_l_e has been read'' is dis-
If set, and a file that bbaasshh is checking for mail has
been accessed since the last time it was checked, the
message ``The mail in _m_a_i_l_f_i_l_e has been read'' is dis-
played.
nnoo__eemmppttyy__ccmmdd__ccoommpplleettiioonn
If set, and rreeaaddlliinnee is being used, bbaasshh will not
If set, and rreeaaddlliinnee is being used, bbaasshh will not
attempt to search the PPAATTHH for possible completions when
completion is attempted on an empty line.
nnooccaasseegglloobb
If set, bbaasshh matches filenames in a case-insensitive
If set, bbaasshh matches filenames in a case-insensitive
fashion when performing pathname expansion (see PPaatthhnnaammee
EExxppaannssiioonn above).
nnooccaasseemmaattcchh
If set, bbaasshh matches patterns in a case-insensitive
If set, bbaasshh matches patterns in a case-insensitive
fashion when performing matching while executing ccaassee or
[[[[ conditional commands, when performing pattern substi-
tution word expansions, or when filtering possible com-
tution word expansions, or when filtering possible com-
pletions as part of programmable completion.
nnuullllgglloobb
If set, bbaasshh allows patterns which match no files (see
PPaatthhnnaammee EExxppaannssiioonn above) to expand to a null string,
If set, bbaasshh allows patterns which match no files (see
PPaatthhnnaammee EExxppaannssiioonn above) to expand to a null string,
rather than themselves.
pprrooggccoommpp
If set, the programmable completion facilities (see PPrroo--
@@ -1539,50 +1553,50 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
enabled by default.
pprroommppttvvaarrss
If set, prompt strings undergo parameter expansion, com-
mand substitution, arithmetic expansion, and quote
removal after being expanded as described in PPRROOMMPPTTIINNGG
mand substitution, arithmetic expansion, and quote
removal after being expanded as described in PPRROOMMPPTTIINNGG
above. This option is enabled by default.
rreessttrriicctteedd__sshheellll
The shell sets this option if it is started in
The shell sets this option if it is started in
restricted mode (see RREESSTTRRIICCTTEEDD SSHHEELLLL below). The value
may not be changed. This is not reset when the startup
files are executed, allowing the startup files to dis-
may not be changed. This is not reset when the startup
files are executed, allowing the startup files to dis-
cover whether or not a shell is restricted.
sshhiifftt__vveerrbboossee
If set, the sshhiifftt builtin prints an error message when
If set, the sshhiifftt builtin prints an error message when
the shift count exceeds the number of positional parame-
ters.
ssoouurrcceeppaatthh
If set, the ssoouurrccee (..) builtin uses the value of PPAATTHH to
find the directory containing the file supplied as an
find the directory containing the file supplied as an
argument. This option is enabled by default.
xxppgg__eecchhoo
If set, the eecchhoo builtin expands backslash-escape
If set, the eecchhoo builtin expands backslash-escape
sequences by default.
ssuussppeenndd [--ff]
Suspend the execution of this shell until it receives a SSIIGGCCOONNTT
Suspend the execution of this shell until it receives a SSIIGGCCOONNTT
signal. A login shell cannot be suspended; the --ff option can be
used to override this and force the suspension. The return sta-
tus is 0 unless the shell is a login shell and --ff is not sup-
tus is 0 unless the shell is a login shell and --ff is not sup-
plied, or if job control is not enabled.
tteesstt _e_x_p_r
[[ _e_x_p_r ]]
Return a status of 0 (true) or 1 (false) depending on the evalu-
ation of the conditional expression _e_x_p_r. Each operator and op-
erand must be a separate argument. Expressions are composed of
the primaries described above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS.
tteesstt does not accept any options, nor does it accept and ignore
erand must be a separate argument. Expressions are composed of
the primaries described above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS.
tteesstt does not accept any options, nor does it accept and ignore
an argument of ---- as signifying the end of options.
Expressions may be combined using the following operators,
Expressions may be combined using the following operators,
listed in decreasing order of precedence. The evaluation
depends on the number of arguments; see below. Operator prece-
depends on the number of arguments; see below. Operator prece-
dence is used when there are five or more arguments.
!! _e_x_p_r True if _e_x_p_r is false.
(( _e_x_p_r ))
Returns the value of _e_x_p_r. This may be used to override
Returns the value of _e_x_p_r. This may be used to override
the normal precedence of operators.
_e_x_p_r_1 -aa _e_x_p_r_2
True if both _e_x_p_r_1 and _e_x_p_r_2 are true.
@@ -1599,120 +1613,120 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
null.
2 arguments
If the first argument is !!, the expression is true if and
only if the second argument is null. If the first argu-
ment is one of the unary conditional operators listed
above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS, the expression is
only if the second argument is null. If the first argu-
ment is one of the unary conditional operators listed
above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS, the expression is
true if the unary test is true. If the first argument is
not a valid unary conditional operator, the expression is
false.
3 arguments
The following conditions are applied in the order listed.
If the second argument is one of the binary conditional
If the second argument is one of the binary conditional
operators listed above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS, the
result of the expression is the result of the binary test
using the first and third arguments as operands. The --aa
and --oo operators are considered binary operators when
there are three arguments. If the first argument is !!,
the value is the negation of the two-argument test using
using the first and third arguments as operands. The --aa
and --oo operators are considered binary operators when
there are three arguments. If the first argument is !!,
the value is the negation of the two-argument test using
the second and third arguments. If the first argument is
exactly (( and the third argument is exactly )), the result
is the one-argument test of the second argument. Other-
is the one-argument test of the second argument. Other-
wise, the expression is false.
4 arguments
If the first argument is !!, the result is the negation of
the three-argument expression composed of the remaining
the three-argument expression composed of the remaining
arguments. Otherwise, the expression is parsed and eval-
uated according to precedence using the rules listed
uated according to precedence using the rules listed
above.
5 or more arguments
The expression is parsed and evaluated according to
The expression is parsed and evaluated according to
precedence using the rules listed above.
When used with tteesstt or [[, the << and >> operators sort lexico-
When used with tteesstt or [[, the << and >> operators sort lexico-
graphically using ASCII ordering.
ttiimmeess Print the accumulated user and system times for the shell and
ttiimmeess Print the accumulated user and system times for the shell and
for processes run from the shell. The return status is 0.
ttrraapp [--llpp] [[_a_r_g] _s_i_g_s_p_e_c ...]
The command _a_r_g is to be read and executed when the shell
receives signal(s) _s_i_g_s_p_e_c. If _a_r_g is absent (and there is a
single _s_i_g_s_p_e_c) or --, each specified signal is reset to its
original disposition (the value it had upon entrance to the
shell). If _a_r_g is the null string the signal specified by each
_s_i_g_s_p_e_c is ignored by the shell and by the commands it invokes.
If _a_r_g is not present and --pp has been supplied, then the trap
commands associated with each _s_i_g_s_p_e_c are displayed. If no
arguments are supplied or if only --pp is given, ttrraapp prints the
list of commands associated with each signal. The --ll option
causes the shell to print a list of signal names and their cor-
responding numbers. Each _s_i_g_s_p_e_c is either a signal name
defined in <_s_i_g_n_a_l_._h>, or a signal number. Signal names are
The command _a_r_g is to be read and executed when the shell
receives signal(s) _s_i_g_s_p_e_c. If _a_r_g is absent (and there is a
single _s_i_g_s_p_e_c) or --, each specified signal is reset to its
original disposition (the value it had upon entrance to the
shell). If _a_r_g is the null string the signal specified by each
_s_i_g_s_p_e_c is ignored by the shell and by the commands it invokes.
If _a_r_g is not present and --pp has been supplied, then the trap
commands associated with each _s_i_g_s_p_e_c are displayed. If no
arguments are supplied or if only --pp is given, ttrraapp prints the
list of commands associated with each signal. The --ll option
causes the shell to print a list of signal names and their cor-
responding numbers. Each _s_i_g_s_p_e_c is either a signal name
defined in <_s_i_g_n_a_l_._h>, or a signal number. Signal names are
case insensitive and the SSIIGG prefix is optional.
If a _s_i_g_s_p_e_c is EEXXIITT (0) the command _a_r_g is executed on exit
from the shell. If a _s_i_g_s_p_e_c is DDEEBBUUGG, the command _a_r_g is exe-
cuted before every _s_i_m_p_l_e _c_o_m_m_a_n_d, _f_o_r command, _c_a_s_e command,
_s_e_l_e_c_t command, every arithmetic _f_o_r command, and before the
first command executes in a shell function (see SSHHEELLLL GGRRAAMMMMAARR
above). Refer to the description of the eexxttddeebbuugg option to the
If a _s_i_g_s_p_e_c is EEXXIITT (0) the command _a_r_g is executed on exit
from the shell. If a _s_i_g_s_p_e_c is DDEEBBUUGG, the command _a_r_g is exe-
cuted before every _s_i_m_p_l_e _c_o_m_m_a_n_d, _f_o_r command, _c_a_s_e command,
_s_e_l_e_c_t command, every arithmetic _f_o_r command, and before the
first command executes in a shell function (see SSHHEELLLL GGRRAAMMMMAARR
above). Refer to the description of the eexxttddeebbuugg option to the
sshhoopptt builtin for details of its effect on the DDEEBBUUGG trap. If a
_s_i_g_s_p_e_c is RREETTUURRNN, the command _a_r_g is executed each time a shell
function or a script executed with the .. or ssoouurrccee builtins fin-
ishes executing.
If a _s_i_g_s_p_e_c is EERRRR, the command _a_r_g is executed whenever a
If a _s_i_g_s_p_e_c is EERRRR, the command _a_r_g is executed whenever a
pipeline (which may consist of a single simple command), a list,
or a compound command returns a non-zero exit status, subject to
the following conditions. The EERRRR trap is not executed if the
the following conditions. The EERRRR trap is not executed if the
failed command is part of the command list immediately following
a wwhhiillee or uunnttiill keyword, part of the test in an _i_f statement,
a wwhhiillee or uunnttiill keyword, part of the test in an _i_f statement,
part of a 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 using
!!. These are the same conditions obeyed by the eerrrreexxiitt (--ee)
following the final &&&& or ||||, any command in a pipeline but the
last, or if the command's return value is being inverted using
!!. These are the same conditions obeyed by the eerrrreexxiitt (--ee)
option.
Signals ignored upon entry to the shell cannot be trapped or
reset. Trapped signals that are not being ignored are reset to
Signals ignored upon entry to the shell cannot be trapped or
reset. Trapped signals that are not being ignored are reset to
their original values in a subshell or subshell environment when
one is created. The return status is false if any _s_i_g_s_p_e_c is
one is created. The return status is false if any _s_i_g_s_p_e_c is
invalid; otherwise ttrraapp returns true.
ttyyppee [--aaffttppPP] _n_a_m_e [_n_a_m_e ...]
With no options, indicate how each _n_a_m_e would be interpreted if
With no options, indicate how each _n_a_m_e would be interpreted if
used as a command name. If the --tt option is used, ttyyppee prints a
string which is one of _a_l_i_a_s, _k_e_y_w_o_r_d, _f_u_n_c_t_i_o_n, _b_u_i_l_t_i_n, or
_f_i_l_e if _n_a_m_e is an alias, shell reserved word, function,
builtin, or disk file, respectively. If the _n_a_m_e is not found,
then nothing is printed, and an exit status of false is
returned. If the --pp option is used, ttyyppee either returns the
string which is one of _a_l_i_a_s, _k_e_y_w_o_r_d, _f_u_n_c_t_i_o_n, _b_u_i_l_t_i_n, or
_f_i_l_e if _n_a_m_e is an alias, shell reserved word, function,
builtin, or disk file, respectively. If the _n_a_m_e is not found,
then nothing is printed, and an exit status of false is
returned. If the --pp option is used, ttyyppee either returns the
name of the disk file that would be executed if _n_a_m_e were speci-
fied as a command name, or nothing if ``type -t name'' would not
return _f_i_l_e. The --PP option forces a PPAATTHH search for each _n_a_m_e,
return _f_i_l_e. The --PP option forces a PPAATTHH search for each _n_a_m_e,
even if ``type -t name'' would not return _f_i_l_e. If a command is
hashed, --pp and --PP print the hashed value, which is not necessar-
ily the file that appears first in PPAATTHH. If the --aa option is
used, ttyyppee prints all of the places that contain an executable
ily the file that appears first in PPAATTHH. If the --aa option is
used, ttyyppee prints all of the places that contain an executable
named _n_a_m_e. This includes aliases and functions, if and only if
the --pp option is not also used. The table of hashed commands is
not consulted when using --aa. The --ff option suppresses shell
not consulted when using --aa. The --ff option suppresses shell
function lookup, as with the ccoommmmaanndd builtin. ttyyppee returns true
if all of the arguments are found, false if any are not found.
uulliimmiitt [--HHSSaabbccddeeffiikkllmmnnppqqrrssttuuvvxxPPTT [_l_i_m_i_t]]
Provides control over the resources available to the shell and
to processes started by it, on systems that allow such control.
Provides control over the resources available to the shell and
to processes started by it, on systems that allow such control.
The --HH and --SS options specify that the hard or soft limit is set
for the given resource. A hard limit cannot be increased by a
non-root user once it is set; a soft limit may be increased up
to the value of the hard limit. If neither --HH nor --SS is speci-
for the given resource. A hard limit cannot be increased by a
non-root user once it is set; a soft limit may be increased up
to the value of the hard limit. If neither --HH nor --SS is speci-
fied, both the soft and hard limits are set. The value of _l_i_m_i_t
can be a number in the unit specified for the resource or one of
the special values hhaarrdd, ssoofftt, or uunnlliimmiitteedd, which stand for the
current hard limit, the current soft limit, and no limit,
respectively. If _l_i_m_i_t is omitted, the current value of the
soft limit of the resource is printed, unless the --HH option is
current hard limit, the current soft limit, and no limit,
respectively. If _l_i_m_i_t is omitted, the current value of the
soft limit of the resource is printed, unless the --HH option is
given. When more than one resource is specified, the limit name
and unit are printed before the value. Other options are inter-
preted as follows:
@@ -1721,12 +1735,12 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
--cc The maximum size of core files created
--dd The maximum size of a process's data segment
--ee The maximum scheduling priority ("nice")
--ff The maximum size of files written by the shell and its
--ff The maximum size of files written by the shell and its
children
--ii The maximum number of pending signals
--kk The maximum number of kqueues that may be allocated
--ll The maximum size that may be locked into memory
--mm The maximum resident set size (many systems do not honor
--mm The maximum resident set size (many systems do not honor
this limit)
--nn The maximum number of open file descriptors (most systems
do not allow this value to be set)
@@ -1735,53 +1749,53 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
--rr The maximum real-time scheduling priority
--ss The maximum stack size
--tt The maximum amount of cpu time in seconds
--uu The maximum number of processes available to a single
--uu The maximum number of processes available to a single
user
--vv The maximum amount of virtual memory available to the
--vv The maximum amount of virtual memory available to the
shell and, on some systems, to its children
--xx The maximum number of file locks
--PP The maximum number of pseudoterminals
--TT The maximum number of threads
If _l_i_m_i_t is given, and the --aa option is not used, _l_i_m_i_t is the
new value of the specified resource. If no option is given,
then --ff is assumed. Values are in 1024-byte increments, except
for --tt, which is in seconds; --pp, which is in units of 512-byte
blocks; --PP, --TT, --bb, --kk, --nn, and --uu, which are unscaled values;
If _l_i_m_i_t is given, and the --aa option is not used, _l_i_m_i_t is the
new value of the specified resource. If no option is given,
then --ff is assumed. Values are in 1024-byte increments, except
for --tt, which is in seconds; --pp, which is in units of 512-byte
blocks; --PP, --TT, --bb, --kk, --nn, and --uu, which are unscaled values;
and, when in Posix mode, --cc and --ff, which are in 512-byte incre-
ments. The return status is 0 unless an invalid option or argu-
ment is supplied, or an error occurs while setting a new limit.
uummaasskk [--pp] [--SS] [_m_o_d_e]
The user file-creation mask is set to _m_o_d_e. If _m_o_d_e begins with
a digit, it is interpreted as an octal number; otherwise it is
interpreted as a symbolic mode mask similar to that accepted by
_c_h_m_o_d(1). If _m_o_d_e is omitted, the current value of the mask is
printed. The --SS option causes the mask to be printed in sym-
bolic form; the default output is an octal number. If the --pp
a digit, it is interpreted as an octal number; otherwise it is
interpreted as a symbolic mode mask similar to that accepted by
_c_h_m_o_d(1). If _m_o_d_e is omitted, the current value of the mask is
printed. The --SS option causes the mask to be printed in sym-
bolic form; the default output is an octal number. If the --pp
option is supplied, and _m_o_d_e is omitted, the output is in a form
that may be reused as input. The return status is 0 if the mode
was successfully changed or if no _m_o_d_e argument was supplied,
was successfully changed or if no _m_o_d_e argument was supplied,
and false otherwise.
uunnaalliiaass [-aa] [_n_a_m_e ...]
Remove each _n_a_m_e from the list of defined aliases. If --aa is
supplied, all alias definitions are removed. The return value
Remove each _n_a_m_e from the list of defined aliases. If --aa is
supplied, all alias definitions are removed. The return value
is true unless a supplied _n_a_m_e is not a defined alias.
uunnsseett [-ffvv] [-nn] [_n_a_m_e ...]
For each _n_a_m_e, remove the corresponding variable or function.
For each _n_a_m_e, remove the corresponding variable or function.
If the --vv option is given, each _n_a_m_e refers to a shell variable,
and that variable is removed. Read-only variables may not be
unset. If --ff is specified, each _n_a_m_e refers to a shell func-
tion, and the function definition is removed. If the --nn option
is supplied, and _n_a_m_e is a variable with the _n_a_m_e_r_e_f attribute,
_n_a_m_e will be unset rather than the variable it references. --nn
has no effect if the --ff option is supplied. If no options are
supplied, each _n_a_m_e refers to a variable; if there is no vari-
able by that name, any function with that name is unset. Each
unset variable or function is removed from the environment
passed to subsequent commands. If any of CCOOMMPP__WWOORRDDBBRREEAAKKSS, RRAANN--
and that variable is removed. Read-only variables may not be
unset. If --ff is specified, each _n_a_m_e refers to a shell func-
tion, and the function definition is removed. If the --nn option
is supplied, and _n_a_m_e is a variable with the _n_a_m_e_r_e_f attribute,
_n_a_m_e will be unset rather than the variable it references. --nn
has no effect if the --ff option is supplied. If no options are
supplied, each _n_a_m_e refers to a variable; if there is no vari-
able by that name, any function with that name is unset. Each
unset variable or function is removed from the environment
passed to subsequent commands. If any of CCOOMMPP__WWOORRDDBBRREEAAKKSS, RRAANN--
DDOOMM, SSEECCOONNDDSS, LLIINNEENNOO, HHIISSTTCCMMDD, FFUUNNCCNNAAMMEE, GGRROOUUPPSS, or DDIIRRSSTTAACCKK are
unset, they lose their special properties, even if they are sub-
sequently reset. The exit status is true unless a _n_a_m_e is read-
@@ -1789,16 +1803,16 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
wwaaiitt [--ffnn] [_i_d _._._.]
Wait for each specified child process and return its termination
status. Each _i_d may be a process ID or a job specification; if
a job spec is given, all processes in that job's pipeline are
status. Each _i_d may be a process ID or a job specification; if
a job spec is given, all processes in that job's pipeline are
waited for. If _i_d is not given, all currently active child pro-
cesses are waited for, and the return status is zero. If the --nn
option is supplied, wwaaiitt waits for any job to terminate and
returns its exit status. If the --ff option is supplied, and job
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, 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
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.
SSEEEE AALLSSOO
doc/builtins.ps
+1291 -1273
View File
File diff suppressed because it is too large Load Diff
doc/rbash.ps
+1 -1
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.22.3
%%CreationDate: Tue Jan 2 10:55:05 2018
%%CreationDate: Fri Mar 2 16:08:28 2018
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%DocumentSuppliedResources: procset grops 1.22 3
doc/version.texi
+3 -3
View File
@@ -2,10 +2,10 @@
Copyright (C) 1988-2018 Free Software Foundation, Inc.
@end ignore
@set LASTCHANGE Sun Feb 25 16:17:31 EST 2018
@set LASTCHANGE Fri Mar 2 16:08:12 EST 2018
@set EDITION 4.4
@set VERSION 4.4
@set UPDATED 25 February 2018
@set UPDATED-MONTH February 2018
@set UPDATED 2 March 2018
@set UPDATED-MONTH March 2018
nojobs.c
+2 -5
View File
@@ -270,12 +270,9 @@ set_pid_status (pid, status)
#endif
#if defined (PROCESS_SUBSTITUTION)
if ((ind = find_procsub_child (pid)) >= 0)
{
itrace("waitchld: calling set_procsub_status (%d, %d)", ind, pid);
set_procsub_status (ind, pid, WSTATUS (status));
if ((slot = find_procsub_child (pid)) >= 0)
set_procsub_status (slot, pid, WSTATUS (status));
/* XXX - also saving in list below */
}
#endif
slot = find_index_by_pid (pid);