From: Chet Ramey Date: Sat, 3 Dec 2011 18:44:53 +0000 (-0500) Subject: commit bash-20050317 snapshot X-Git-Tag: bash-3.1-alpha~15 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=3ee6b87dbc2abce64e3a151c29ae0d88c70d2e87;p=thirdparty%2Fbash.git commit bash-20050317 snapshot --- diff --git a/CWRU/CWRU.chlog b/CWRU/CWRU.chlog index 18732f80e..8d4cea726 100644 --- a/CWRU/CWRU.chlog +++ b/CWRU/CWRU.chlog @@ -11183,3 +11183,28 @@ lib/sh/zread.c builtins/evalstring.c - don't allow parse_and_execute to short-circuit and call exec() if the command's return value is being inverted + + 3/15 + ---- +builtins/printf.def + - new macro PC to call putchar and increment number of chars printed - + fixes bug in computation of value for %n format char + - `tw' is now a global var so printstr can modify it using PC() + - convert PF macro to use asprintf into a local buffer + Preparation for printf -v var + - add code to add the text printed to a `variable buffer' if -v option + supplied. The buffer grows as needed + - printf now takes a `-v var' option to put the output into the variable + VAR rather than sending it to stdout. It does not: + print partial output on error (e.g., format string error) + handle NULs in the variable value, as usual + + 3/16 + ---- +parse.y + - fix bug in prompt string decoding that caused a core dump when PS1 + contained \W and PWD was unset (null pointer deref) + +builtins/printf.def + - changed -v var behavior so it stores partial output into the named + variable upon an error diff --git a/MANIFEST b/MANIFEST index 3007ed495..c27be69f5 100644 --- a/MANIFEST +++ b/MANIFEST @@ -805,6 +805,7 @@ tests/posix2.tests f tests/posix2.right f tests/posixpat.tests f tests/posixpat.right f +tests/posix-ifs.sh f tests/prec.right f tests/precedence f tests/printf.tests f diff --git a/builtins/printf.def b/builtins/printf.def index 5342a7312..8e44462f0 100644 --- a/builtins/printf.def +++ b/builtins/printf.def @@ -1,7 +1,7 @@ This file is printf.def, from which is created printf.c. It implements the builtin "printf" in Bash. -Copyright (C) 1997-2003 Free Software Foundation, Inc. +Copyright (C) 1997-2005 Free Software Foundation, Inc. This file is part of GNU Bash, the Bourne Again SHell. @@ -23,7 +23,7 @@ $PRODUCES printf.c $BUILTIN printf $FUNCTION printf_builtin -$SHORT_DOC printf format [arguments] +$SHORT_DOC printf [-v var] format [arguments] printf formats and prints ARGUMENTS under control of the FORMAT. FORMAT is a character string which contains three types of objects: plain characters, which are simply copied to standard output, character escape @@ -32,6 +32,8 @@ format specifications, each of which causes printing of the next successive argument. In addition to the standard printf(1) formats, %b means to expand backslash escape sequences in the corresponding argument, and %q means to quote the argument in a way that can be reused as shell input. +If the -v option is supplied, the output is placed into the value of the +shell variable VAR rather than being sent to the standard output. $END #include @@ -74,28 +76,58 @@ $END extern int errno; #endif +#define PC(c) \ + do { \ + char b[2]; \ + tw++; \ + b[0] = c; b[1] = '\0'; \ + if (vflag) \ + vbadd (b, 1); \ + else \ + putchar (c); \ + } while (0) + #define PF(f, func) \ do { \ + char *b = 0; \ + int nw; \ if (have_fieldwidth && have_precision) \ - tw += printf(f, fieldwidth, precision, func); \ + nw = asprintf(&b, f, fieldwidth, precision, func); \ else if (have_fieldwidth) \ - tw += printf(f, fieldwidth, func); \ + nw = asprintf(&b, f, fieldwidth, func); \ else if (have_precision) \ - tw += printf(f, precision, func); \ + nw = asprintf(&b, f, precision, func); \ else \ - tw += printf(f, func); \ + nw = asprintf(&b, f, func); \ + tw += nw; \ + if (b) \ + { \ + if (vflag) \ + (void)vbadd (b, nw); \ + else \ + (void)fputs (b, stdout); \ + free (b); \ + } \ } while (0) /* We free the buffer used by mklong() if it's `too big'. */ #define PRETURN(value) \ do \ { \ + if (vflag) \ + bind_variable (vname, vbuf, 0); \ if (conv_bufsize > 4096 ) \ { \ - free(conv_buf); \ + free (conv_buf); \ conv_bufsize = 0; \ conv_buf = 0; \ } \ + if (vbsize > 4096) \ + { \ + free (vbuf); \ + vbsize = 0; \ + vbuf = 0; \ + } \ fflush (stdout); \ return (value); \ } \ @@ -108,6 +140,7 @@ static void printf_erange __P((char *)); static int printstr __P((char *, char *, int, int, int)); static int tescape __P((char *, char *, int *)); static char *bexpand __P((char *, int, int *, int *)); +static char *vbadd __P((char *, int)); static char *mklong __P((char *, char *, size_t)); static int getchr __P((void)); static char *getstr __P((void)); @@ -132,6 +165,14 @@ static WORD_LIST *garglist; static int retval; static int conversion_error; +/* printf -v var support */ +static int vflag = 0; +static char *vbuf, *vname; +static size_t vbsize; +static int vblen; + +static intmax_t tw; + static char *conv_buf; static size_t conv_bufsize; @@ -141,14 +182,35 @@ printf_builtin (list) { int ch, fieldwidth, precision; int have_fieldwidth, have_precision; - intmax_t tw; char convch, thisch, nextch, *format, *modstart, *fmt, *start; conversion_error = 0; retval = EXECUTION_SUCCESS; - if (no_options (list)) - return (EX_USAGE); + vflag = 0; + + reset_internal_getopt (); + while ((ch = internal_getopt (list, "v:")) != -1) + { + switch (ch) + { + case 'v': + if (legal_identifier (vname = list_optarg)) + { + vflag = 1; + vblen = 0; + } + else + { + sh_invalidid (vname); + return (EX_USAGE); + } + break; + default: + builtin_usage (); + return (EX_USAGE); + } + } list = loptend; /* skip over possible `--' */ if (list == 0) @@ -161,6 +223,7 @@ printf_builtin (list) return (EXECUTION_SUCCESS); format = list->word->word; + tw = 0; garglist = list->next; @@ -189,14 +252,14 @@ printf_builtin (list) /* A NULL third argument to tescape means to bypass the special processing for arguments to %b. */ fmt += tescape (fmt, &nextch, (int *)NULL); - putchar (nextch); + PC (nextch); fmt--; /* for loop will increment it for us again */ continue; } if (*fmt != '%') { - putchar (*fmt); + PC (*fmt); continue; } @@ -205,7 +268,7 @@ printf_builtin (list) if (*fmt == '%') /* %% prints a % */ { - putchar ('%'); + PC ('%'); continue; } @@ -544,15 +607,15 @@ printstr (fmt, string, len, fieldwidth, precision) /* leading pad characters */ for (; padlen > 0; padlen--) - putchar (' '); + PC (' '); /* output NC characters from STRING */ for (i = 0; i < nc; i++) - putchar (string[i]); + PC (string[i]); /* output any necessary trailing padding */ for (; padlen < 0; padlen++) - putchar (' '); + PC (' '); return (ferror (stdout) ? -1 : 0); } @@ -712,6 +775,35 @@ bexpand (string, len, sawc, lenp) return ret; } +static char * +vbadd (buf, blen) + char *buf; + int blen; +{ + size_t nlen; + + nlen = vblen + blen + 1; + if (nlen >= vbsize) + { + vbsize = ((nlen + 63) >> 6) << 6; + vbuf = (char *)xrealloc (vbuf, vbsize); + } + + if (blen == 1) + vbuf[vblen++] = buf[0]; + else + { + FASTCOPY (buf, vbuf + vblen, blen); + vblen += blen; + } + vbuf[vblen] = '\0'; + +if (strlen (vbuf) != vblen) + internal_error ("printf:vbadd: vblen (%d) != strlen (vbuf) (%d)", vblen, strlen (vbuf)); + + return vbuf; +} + static char * mklong (str, modifiers, mlen) char *str; diff --git a/doc/bash.0 b/doc/bash.0 index 0080f894e..3d8d77763 100644 --- a/doc/bash.0 +++ b/doc/bash.0 @@ -4047,7 +4047,7 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS tent directory stack entry is specified, or the directory change fails. - pprriinnttff _f_o_r_m_a_t [_a_r_g_u_m_e_n_t_s] + pprriinnttff [--vv _v_a_r] _f_o_r_m_a_t [_a_r_g_u_m_e_n_t_s] Write the formatted _a_r_g_u_m_e_n_t_s to the standard output under the control of the _f_o_r_m_a_t. The _f_o_r_m_a_t is a character string which contains three types of objects: plain characters, which are @@ -4062,59 +4062,62 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS pprriinnttff to output the corresponding _a_r_g_u_m_e_n_t in a format that can be reused as shell input. - The _f_o_r_m_a_t is reused as necessary to consume all of the _a_r_g_u_- + The --vv option causes the output to be assigned to the variable + _v_a_r rather than being printed to the standard output. + + The _f_o_r_m_a_t is reused as necessary to consume all of the _a_r_g_u_- _m_e_n_t_s. If the _f_o_r_m_a_t requires more _a_r_g_u_m_e_n_t_s than are supplied, - the extra format specifications behave as if a zero value or - null string, as appropriate, had been supplied. The return + the extra format specifications behave as if a zero value or + null string, as appropriate, had been supplied. The return value is zero on success, non-zero on failure. ppuusshhdd [--nn] [_d_i_r] ppuusshhdd [--nn] [+_n] [-_n] - Adds a directory to the top of the directory stack, or rotates - the stack, making the new top of the stack the current working + Adds a directory to the top of the directory stack, or rotates + the stack, making the new top of the stack the current working directory. With no arguments, exchanges the top two directories - and returns 0, unless the directory stack is empty. Arguments, + and returns 0, unless the directory stack is empty. Arguments, if supplied, have the following meanings: - ++_n Rotates the stack so that the _nth directory (counting - from the left of the list shown by ddiirrss, starting with + ++_n Rotates the stack so that the _nth directory (counting + from the left of the list shown by ddiirrss, starting with zero) is at the top. - --_n Rotates the stack so that the _nth directory (counting - from the right of the list shown by ddiirrss, starting with + --_n Rotates the stack so that the _nth directory (counting + from the right of the list shown by ddiirrss, starting with zero) is at the top. - --nn Suppresses the normal change of directory when adding - directories to the stack, so that only the stack is + --nn Suppresses the normal change of directory when adding + directories to the stack, so that only the stack is manipulated. _d_i_r Adds _d_i_r to the directory stack at the top, making it the new current working directory. If the ppuusshhdd command is successful, a ddiirrss is performed as well. - If the first form is used, ppuusshhdd returns 0 unless the cd to _d_i_r - fails. With the second form, ppuusshhdd returns 0 unless the direc- - tory stack is empty, a non-existent directory stack element is - specified, or the directory change to the specified new current + If the first form is used, ppuusshhdd returns 0 unless the cd to _d_i_r + fails. With the second form, ppuusshhdd returns 0 unless the direc- + tory stack is empty, a non-existent directory stack element is + specified, or the directory change to the specified new current directory fails. ppwwdd [--LLPP] - Print the absolute pathname of the current working directory. + Print the absolute pathname of the current working directory. The pathname printed contains no symbolic links if the --PP option is supplied or the --oo pphhyyssiiccaall option to the sseett builtin command - is enabled. If the --LL option is used, the pathname printed may - contain symbolic links. The return status is 0 unless an error - occurs while reading the name of the current directory or an + is enabled. If the --LL option is used, the pathname printed may + contain symbolic links. The return status is 0 unless an error + occurs while reading the name of the current directory or an invalid option is supplied. rreeaadd [--eerrss] [--uu _f_d] [--tt _t_i_m_e_o_u_t] [--aa _a_n_a_m_e] [--pp _p_r_o_m_p_t] [--nn _n_c_h_a_r_s] [--dd _d_e_l_i_m] [_n_a_m_e ...] - One line is read from the standard input, or from the file - descriptor _f_d supplied as an argument to the --uu option, and the + One line is read from the standard input, or from the file + descriptor _f_d supplied as an argument to the --uu option, and the first word is assigned to the first _n_a_m_e, the second word to the - second _n_a_m_e, and so on, with leftover words and their interven- - ing separators assigned to the last _n_a_m_e. If there are fewer + second _n_a_m_e, and so on, with leftover words and their interven- + ing separators assigned to the last _n_a_m_e. If there are fewer words read from the input stream than names, the remaining names - are assigned empty values. The characters in IIFFSS are used to - split the line into words. The backslash character (\\) may be - used to remove any special meaning for the next character read - and for line continuation. Options, if supplied, have the fol- + are assigned empty values. The characters in IIFFSS are used to + split the line into words. The backslash character (\\) may be + used to remove any special meaning for the next character read + and for line continuation. Options, if supplied, have the fol- lowing meanings: --aa _a_n_a_m_e The words are assigned to sequential indices of the array @@ -4122,100 +4125,100 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS new values are assigned. Other _n_a_m_e arguments are ignored. --dd _d_e_l_i_m - The first character of _d_e_l_i_m is used to terminate the + The first character of _d_e_l_i_m is used to terminate the input line, rather than newline. --ee If the standard input is coming from a terminal, rreeaaddlliinnee (see RREEAADDLLIINNEE above) is used to obtain the line. --nn _n_c_h_a_r_s - rreeaadd returns after reading _n_c_h_a_r_s characters rather than + rreeaadd returns after reading _n_c_h_a_r_s characters rather than waiting for a complete line of input. --pp _p_r_o_m_p_t Display _p_r_o_m_p_t on standard error, without a trailing new- line, before attempting to read any input. The prompt is displayed only if input is coming from a terminal. --rr Backslash does not act as an escape character. The back- - slash is considered to be part of the line. In particu- - lar, a backslash-newline pair may not be used as a line + slash is considered to be part of the line. In particu- + lar, a backslash-newline pair may not be used as a line continuation. --ss Silent mode. If input is coming from a terminal, charac- ters are not echoed. --tt _t_i_m_e_o_u_t - Cause rreeaadd to time out and return failure if a complete - line of input is not read within _t_i_m_e_o_u_t seconds. This - option has no effect if rreeaadd is not reading input from + Cause rreeaadd to time out and return failure if a complete + line of input is not read within _t_i_m_e_o_u_t seconds. This + option has no effect if rreeaadd is not reading input from the terminal or a pipe. --uu _f_d Read input from file descriptor _f_d. If no _n_a_m_e_s are supplied, the line read is assigned to the vari- - able RREEPPLLYY. The return code is zero, unless end-of-file is - encountered, rreeaadd times out, or an invalid file descriptor is + able RREEPPLLYY. The return code is zero, unless end-of-file is + encountered, rreeaadd times out, or an invalid file descriptor is supplied as the argument to --uu. rreeaaddoonnllyy [--aappff] [_n_a_m_e[=_w_o_r_d] ...] - The given _n_a_m_e_s are marked readonly; the values of these _n_a_m_e_s - may not be changed by subsequent assignment. If the --ff option - is supplied, the functions corresponding to the _n_a_m_e_s are so + The given _n_a_m_e_s are marked readonly; the values of these _n_a_m_e_s + may not be changed by subsequent assignment. If the --ff option + is supplied, the functions corresponding to the _n_a_m_e_s are so marked. The --aa option restricts the variables to arrays. If no - _n_a_m_e arguments are given, or if the --pp option is supplied, a - list of all readonly names is printed. The --pp option causes - output to be displayed in a format that may be reused as input. - If a variable name is followed by =_w_o_r_d, the value of the vari- - able is set to _w_o_r_d. The return status is 0 unless an invalid - option is encountered, one of the _n_a_m_e_s is not a valid shell + _n_a_m_e arguments are given, or if the --pp option is supplied, a + list of all readonly names is printed. The --pp option causes + output to be displayed in a format that may be reused as input. + If a variable name is followed by =_w_o_r_d, the value of the vari- + able is set to _w_o_r_d. The return status is 0 unless an invalid + option is encountered, one of the _n_a_m_e_s is not a valid shell variable name, or --ff is supplied with a _n_a_m_e that is not a func- tion. rreettuurrnn [_n] - Causes a function to exit with the return value specified by _n. - If _n is omitted, the return status is that of the last command - executed in the function body. If used outside a function, but - during execution of a script by the .. (ssoouurrccee) command, it + Causes a function to exit with the return value specified by _n. + If _n is omitted, the return status is that of the last command + executed in the function body. If used outside a function, but + during execution of a script by the .. (ssoouurrccee) command, it causes the shell to stop executing that script and return either - _n or the exit status of the last command executed within the - script as the exit status of the script. If used outside a - function and not during execution of a script by .., the return + _n or the exit status of the last command executed within the + script as the exit status of the script. If used outside a + function and not during execution of a script by .., the return status is false. Any command associated with the RREETTUURRNN trap is - executed before execution resumes after the function or script. + executed before execution resumes after the function or script. sseett [----aabbeeffhhkkmmnnppttuuvvxxBBCCHHPP] [--oo _o_p_t_i_o_n] [_a_r_g ...] - Without options, the name and value of each shell variable are + Without options, the name and value of each shell variable are displayed in a format that can be reused as input for setting or - resetting the currently-set variables. Read-only variables can- - not be reset. In _p_o_s_i_x _m_o_d_e, only shell variables are listed. - The output is sorted according to the current locale. When - options are specified, they set or unset shell attributes. Any - arguments remaining after the options are processed are treated - as values for the positional parameters and are assigned, in - order, to $$11, $$22, ...... $$_n. Options, if specified, have the fol- - lowing meanings: - --aa Automatically mark variables and functions which are - modified or created for export to the environment of + resetting the currently-set variables. Read-only variables + cannot be reset. In _p_o_s_i_x _m_o_d_e, only shell variables are + listed. The output is sorted according to the current locale. + When options are specified, they set or unset shell attributes. + Any arguments remaining after the options are processed are + treated as values for the positional parameters and are + assigned, in order, to $$11, $$22, ...... $$_n. Options, if specified, + have the following meanings: + --aa Automatically mark variables and functions which are + modified or created for export to the environment of subsequent commands. - --bb Report the status of terminated background jobs immedi- + --bb Report the status of terminated background jobs immedi- ately, rather than before the next primary prompt. This is effective only when job control is enabled. - --ee Exit immediately if a _s_i_m_p_l_e _c_o_m_m_a_n_d (see SSHHEELLLL GGRRAAMMMMAARR + --ee Exit immediately if a _s_i_m_p_l_e _c_o_m_m_a_n_d (see SSHHEELLLL GGRRAAMMMMAARR above) exits with a non-zero status. The shell does not - exit if the command that fails is part of the command - list immediately following a wwhhiillee or uunnttiill keyword, - part of the test in an _i_f statement, part of a &&&& or |||| + exit if the command that fails is part of the command + list immediately following a wwhhiillee or uunnttiill keyword, + part of the test in an _i_f statement, part of a &&&& or |||| list, or if the command's return value is being inverted - via !!. A trap on EERRRR, if set, is executed before the + via !!. A trap on EERRRR, if set, is executed before the shell exits. --ff Disable pathname expansion. - --hh Remember the location of commands as they are looked up + --hh Remember the location of commands as they are looked up for execution. This is enabled by default. - --kk All arguments in the form of assignment statements are - placed in the environment for a command, not just those + --kk All arguments in the form of assignment statements are + placed in the environment for a command, not just those that precede the command name. - --mm Monitor mode. Job control is enabled. This option is - on by default for interactive shells on systems that - support it (see JJOOBB CCOONNTTRROOLL above). Background pro- - cesses run in a separate process group and a line con- - taining their exit status is printed upon their comple- + --mm Monitor mode. Job control is enabled. This option is + on by default for interactive shells on systems that + support it (see JJOOBB CCOONNTTRROOLL above). Background pro- + cesses run in a separate process group and a line con- + taining their exit status is printed upon their comple- tion. --nn Read commands but do not execute them. This may be used - to check a shell script for syntax errors. This is + to check a shell script for syntax errors. This is ignored by interactive shells. --oo _o_p_t_i_o_n_-_n_a_m_e The _o_p_t_i_o_n_-_n_a_m_e can be one of the following: @@ -4223,7 +4226,7 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS Same as --aa. bbrraacceeeexxppaanndd Same as --BB. - eemmaaccss Use an emacs-style command line editing inter- + eemmaaccss Use an emacs-style command line editing inter- face. This is enabled by default when the shell is interactive, unless the shell is started with the ----nnooeeddiittiinngg option. @@ -4239,8 +4242,8 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS HHIISSTTOORRYY. This option is on by default in inter- active shells. iiggnnoorreeeeooff - The effect is as if the shell command - ``IGNOREEOF=10'' had been executed (see SShheellll + The effect is as if the shell command + ``IGNOREEOF=10'' had been executed (see SShheellll VVaarriiaabblleess above). kkeeyywwoorrdd Same as --kk. mmoonniittoorr Same as --mm. @@ -4254,12 +4257,12 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS pphhyyssiiccaall Same as --PP. ppiippeeffaaiill - If set, the return value of a pipeline is the - value of the last (rightmost) command to exit - with a non-zero status, or zero if all commands - in the pipeline exit successfully. This option + If set, the return value of a pipeline is the + value of the last (rightmost) command to exit + with a non-zero status, or zero if all commands + in the pipeline exit successfully. This option is disabled by default. - ppoossiixx Change the behavior of bbaasshh where the default + ppoossiixx Change the behavior of bbaasshh where the default operation differs from the POSIX 1003.2 standard to match the standard (_p_o_s_i_x _m_o_d_e). pprriivviilleeggeedd @@ -4268,236 +4271,236 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS vvii Use a vi-style command line editing interface. xxttrraaccee Same as --xx. If --oo is supplied with no _o_p_t_i_o_n_-_n_a_m_e, the values of the - current options are printed. If ++oo is supplied with no - _o_p_t_i_o_n_-_n_a_m_e, a series of sseett commands to recreate the - current option settings is displayed on the standard + current options are printed. If ++oo is supplied with no + _o_p_t_i_o_n_-_n_a_m_e, a series of sseett commands to recreate the + current option settings is displayed on the standard output. - --pp Turn on _p_r_i_v_i_l_e_g_e_d mode. In this mode, the $$EENNVV and - $$BBAASSHH__EENNVV files are not processed, shell functions are - not inherited from the environment, and the SSHHEELLLLOOPPTTSS - variable, if it appears in the environment, is ignored. - If the shell is started with the effective user (group) - id not equal to the real user (group) id, and the --pp - option is not supplied, these actions are taken and the + --pp Turn on _p_r_i_v_i_l_e_g_e_d mode. In this mode, the $$EENNVV and + $$BBAASSHH__EENNVV files are not processed, shell functions are + not inherited from the environment, and the SSHHEELLLLOOPPTTSS + variable, if it appears in the environment, is ignored. + If the shell is started with the effective user (group) + id not equal to the real user (group) id, and the --pp + option is not supplied, these actions are taken and the effective user id is set to the real user id. If the --pp - option is supplied at startup, the effective user id is + option is supplied at startup, the effective user id is not reset. Turning this option off causes the effective - user and group ids to be set to the real user and group + user and group ids to be set to the real user and group ids. --tt Exit after reading and executing one command. --uu Treat unset variables as an error when performing param- - eter expansion. If expansion is attempted on an unset + eter expansion. If expansion is attempted on an unset variable, the shell prints an error message, and, if not interactive, exits with a non-zero status. --vv Print shell input lines as they are read. - --xx After expanding each _s_i_m_p_l_e _c_o_m_m_a_n_d, ffoorr command, ccaassee + --xx After expanding each _s_i_m_p_l_e _c_o_m_m_a_n_d, ffoorr command, ccaassee command, sseelleecctt command, or arithmetic ffoorr command, dis- - play the expanded value of PPSS44, followed by the command + play the expanded value of PPSS44, followed by the command and its expanded arguments or associated word list. - --BB The shell performs brace expansion (see BBrraaccee EExxppaannssiioonn + --BB The shell performs brace expansion (see BBrraaccee EExxppaannssiioonn above). This is on by default. - --CC If set, bbaasshh does not overwrite an existing file with - the >>, >>&&, and <<>> redirection operators. This may be + --CC If set, bbaasshh does not overwrite an existing file with + the >>, >>&&, and <<>> redirection operators. This may be overridden when creating output files by using the redi- rection operator >>|| instead of >>. --EE If set, any trap on EERRRR is inherited by shell functions, - command substitutions, and commands executed in a sub- - shell environment. The EERRRR trap is normally not inher- + command substitutions, and commands executed in a sub- + shell environment. The EERRRR trap is normally not inher- ited in such cases. --HH Enable !! style history substitution. This option is on by default when the shell is interactive. - --PP If set, the shell does not follow symbolic links when - executing commands such as ccdd that change the current + --PP If set, the shell does not follow symbolic links when + executing commands such as ccdd that change the current working directory. It uses the physical directory structure instead. By default, bbaasshh follows the logical - chain of directories when performing commands which + chain of directories when performing commands which change the current directory. - --TT If set, any traps on DDEEBBUUGG and RREETTUURRNN are inherited by - shell functions, command substitutions, and commands - executed in a subshell environment. The DDEEBBUUGG and + --TT If set, any traps on DDEEBBUUGG and RREETTUURRNN are inherited by + shell functions, command substitutions, and commands + executed in a subshell environment. The DDEEBBUUGG and RREETTUURRNN traps are normally not inherited in such cases. - ---- If no arguments follow this option, then the positional + ---- If no arguments follow this option, then the positional parameters are unset. Otherwise, the positional parame- - ters are set to the _a_r_gs, even if some of them begin + ters are set to the _a_r_gs, even if some of them begin with a --. - -- Signal the end of options, cause all remaining _a_r_gs to + -- Signal the end of options, cause all remaining _a_r_gs to be assigned to the positional parameters. The --xx and --vv options are turned off. If there are no _a_r_gs, the posi- tional parameters remain unchanged. - The options are off by default unless otherwise noted. Using + - rather than - causes these options to be turned off. The - options can also be specified as arguments to an invocation of - the shell. The current set of options may be found in $$--. The + The options are off by default unless otherwise noted. Using + + rather than - causes these options to be turned off. The + options can also be specified as arguments to an invocation of + the shell. The current set of options may be found in $$--. The return status is always true unless an invalid option is encoun- tered. sshhiifftt [_n] - The positional parameters from _n+1 ... are renamed to $$11 ........ - Parameters represented by the numbers $$## down to $$##-_n+1 are - unset. _n must be a non-negative number less than or equal to - $$##. If _n is 0, no parameters are changed. If _n is not given, - it is assumed to be 1. If _n is greater than $$##, the positional - parameters are not changed. The return status is greater than + The positional parameters from _n+1 ... are renamed to $$11 ........ + Parameters represented by the numbers $$## down to $$##-_n+1 are + unset. _n must be a non-negative number less than or equal to + $$##. If _n is 0, no parameters are changed. If _n is not given, + it is assumed to be 1. If _n is greater than $$##, the positional + parameters are not changed. The return status is greater than zero if _n is greater than $$## or less than zero; otherwise 0. sshhoopptt [--ppqqssuu] [--oo] [_o_p_t_n_a_m_e ...] Toggle the values of variables controlling optional shell behav- ior. With no options, or with the --pp option, a list of all set- table options is displayed, with an indication of whether or not - each is set. The --pp option causes output to be displayed in a - form that may be reused as input. Other options have the fol- + each is set. The --pp option causes output to be displayed in a + form that may be reused as input. Other options have the fol- lowing meanings: --ss Enable (set) each _o_p_t_n_a_m_e. --uu Disable (unset) each _o_p_t_n_a_m_e. - --qq Suppresses normal output (quiet mode); the return status + --qq Suppresses normal output (quiet mode); the return status indicates whether the _o_p_t_n_a_m_e is set or unset. If multi- - ple _o_p_t_n_a_m_e arguments are given with --qq, the return sta- - tus is zero if all _o_p_t_n_a_m_e_s are enabled; non-zero other- + ple _o_p_t_n_a_m_e arguments are given with --qq, the return sta- + tus is zero if all _o_p_t_n_a_m_e_s are enabled; non-zero other- wise. - --oo Restricts the values of _o_p_t_n_a_m_e to be those defined for + --oo Restricts the values of _o_p_t_n_a_m_e to be those defined for the --oo option to the sseett builtin. - If either --ss or --uu is used with no _o_p_t_n_a_m_e arguments, the dis- + If either --ss or --uu is used with no _o_p_t_n_a_m_e arguments, the dis- play is limited to those options which are set or unset, respec- - tively. Unless otherwise noted, the sshhoopptt options are disabled + tively. Unless otherwise noted, the sshhoopptt options are disabled (unset) by default. - The return status when listing options is zero if all _o_p_t_n_a_m_e_s - are enabled, non-zero otherwise. When setting or unsetting - options, the return status is zero unless an _o_p_t_n_a_m_e is not a + The return status when listing options is zero if all _o_p_t_n_a_m_e_s + are enabled, non-zero otherwise. When setting or unsetting + options, the return status is zero unless an _o_p_t_n_a_m_e is not a valid shell option. The list of sshhoopptt options is: 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 file name 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 file name 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. cchheecckkwwiinnssiizzee - If set, bbaasshh checks the window size after each command - and, if necessary, updates the values of LLIINNEESS and + If set, bbaasshh checks the window size after each 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 + 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. - ddoottgglloobb If set, bbaasshh includes filenames beginning with a `.' in + ddoottgglloobb If set, bbaasshh includes filenames beginning with a `.' in the results of pathname expansion. 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, behavior intended for use by debuggers is + If set, behavior 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), a call to + 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), a call to rreettuurrnn is simulated. - 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 EERRRROORR 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. 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. 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. - 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. 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. 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-- @@ -4505,44 +4508,44 @@ SSHHEELLLL 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 - signal. The --ff option says not to complain if this is a login - shell; just suspend anyway. The return status is 0 unless the + Suspend the execution of this shell until it receives a SSIIGGCCOONNTT + signal. The --ff option says not to complain if this is a login + shell; just suspend anyway. The return status is 0 unless the shell is a login shell and --ff is not supplied, or if job control is not enabled. tteesstt _e_x_p_r [[ _e_x_p_r ]] - Return a status of 0 or 1 depending on the evaluation of the - conditional expression _e_x_p_r. Each operator and operand must be - a separate argument. Expressions are composed of the primaries + Return a status of 0 or 1 depending on the evaluation of the + conditional expression _e_x_p_r. Each operator and operand must be + a separate argument. Expressions are composed of the primaries described above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS. - Expressions may be combined using the following operators, + Expressions may be combined using the following operators, listed in decreasing order of precedence. !! _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. @@ -4559,109 +4562,109 @@ SSHHEELLLL 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 - 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. If the - first argument is !!, the value is the negation of the - two-argument test using the second and third arguments. + using the first and third arguments as operands. 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. Otherwise, the expression is false. - The --aa and --oo operators are considered binary operators + is exactly )), the result is the one-argument test of the + second argument. Otherwise, the expression is false. + The --aa and --oo operators are considered binary operators in this case. 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. - 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 - case insensitive and the SIG 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 executed before every + 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 SIG 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 executed 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 EERRRR, - the command _a_r_g is executed whenever a simple command has a - non-zero exit status, subject to 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, + 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 EERRRR, + the command _a_r_g is executed whenever a simple command has a + non-zero exit status, subject to 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, part of a &&&& or |||| list, or - if the command's return value is being inverted via !!. These - are the same conditions obeyed by the eerrrreexxiitt option. If a + if the command's return value is being inverted via !!. These + are the same conditions obeyed by the eerrrreexxiitt option. 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. Signals ignored upon entry to the shell cannot - be trapped or reset. Trapped signals are reset to their origi- - nal values in a child process when it is created. The return - status is false if any _s_i_g_s_p_e_c is invalid; otherwise ttrraapp + be trapped or reset. Trapped signals are reset to their origi- + nal values in a child process when it 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, not necessarily the + hashed, --pp and --PP print the hashed value, not necessarily 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 func- - tion lookup, as with the ccoommmmaanndd builtin. ttyyppee returns true if + 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 func- + tion lookup, as with the ccoommmmaanndd builtin. ttyyppee returns true if any of the arguments are found, false if none are found. uulliimmiitt [--SSHHaaccddffllmmnnppssttuuvv [_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 once - it is set; a soft limit may be increased up to the value of the - hard limit. If neither --HH nor --SS is specified, both the soft - and hard limits are set. The value of _l_i_m_i_t can be a number in + for the given resource. A hard limit cannot be increased once + it is set; a soft limit may be increased up to the value of the + hard limit. If neither --HH nor --SS is specified, 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 given. When more - than one resource is specified, the limit name and unit are + 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 given. When more + than one resource is specified, the limit name and unit are printed before the value. Other options are interpreted as fol- lows: --aa All current limits are reported @@ -4675,63 +4678,63 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS --pp The pipe size in 512-byte blocks (this may not be set) --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 If _l_i_m_i_t is given, it is the new value of the specified resource (the --aa option is display only). 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, - and --nn and --uu, which are unscaled values. The return status is - 0 unless an invalid option or argument is supplied, or an error + is assumed. Values are in 1024-byte increments, except for --tt, + which is in seconds, --pp, which is in units of 512-byte blocks, + and --nn and --uu, which are unscaled values. The return status is + 0 unless an invalid option or argument 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] [_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 no options are supplied, or the --vv option is given, each _n_a_m_e - refers to a shell variable. 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. Each unset vari- - able or function is removed from the environment passed to sub- - sequent commands. If any of RRAANNDDOOMM, SSEECCOONNDDSS, LLIINNEENNOO, HHIISSTTCCMMDD, + refers to a shell variable. 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. Each unset vari- + able or function is removed from the environment passed to sub- + sequent commands. If any of RRAANNDDOOMM, SSEECCOONNDDSS, LLIINNEENNOO, HHIISSTTCCMMDD, FFUUNNCCNNAAMMEE, GGRROOUUPPSS, or DDIIRRSSTTAACCKK are unset, they lose their special - properties, even if they are subsequently reset. The exit - status is true unless a _n_a_m_e is readonly. + properties, even if they are subsequently reset. The exit sta- + tus is true unless a _n_a_m_e is readonly. wwaaiitt [_n _._._.] - Wait for each specified process and return its termination sta- - tus. Each _n 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 _n is not given, all currently active child pro- - cesses are waited for, and the return status is zero. If _n - specifies a non-existent process or job, the return status is - 127. Otherwise, the return status is the exit status of the + Wait for each specified process and return its termination sta- + tus. Each _n 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 _n is not given, all currently active child pro- + cesses are waited for, and the return status is zero. If _n + 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. RREESSTTRRIICCTTEEDD SSHHEELLLL If bbaasshh is started with the name rrbbaasshh, or the --rr option is supplied at - invocation, the shell becomes restricted. A restricted shell is used - to set up an environment more controlled than the standard shell. It - behaves identically to bbaasshh with the exception that the following are + invocation, the shell becomes restricted. A restricted shell is used + to set up an environment more controlled than the standard shell. It + behaves identically to bbaasshh with the exception that the following are disallowed or not performed: +o changing directories with ccdd @@ -4740,28 +4743,28 @@ RREESSTTRRIICCTTEEDD SSHHEELLLL +o specifying command names containing // - +o specifying a file name containing a // as an argument to the .. + +o specifying a file name containing a // as an argument to the .. builtin command - +o Specifying a filename containing a slash as an argument to the + +o Specifying a filename containing a slash as an argument to the --pp option to the hhaasshh builtin command - +o importing function definitions from the shell environment at + +o importing function definitions from the shell environment at startup - +o parsing the value of SSHHEELLLLOOPPTTSS from the shell environment at + +o parsing the value of SSHHEELLLLOOPPTTSS from the shell environment at startup - +o redirecting output using the >, >|, <>, >&, &>, and >> redirec- + +o redirecting output using the >, >|, <>, >&, &>, and >> redirec- tion operators +o using the eexxeecc builtin command to replace the shell with another command - +o adding or deleting builtin commands with the --ff and --dd options + +o adding or deleting builtin commands with the --ff and --dd options to the eennaabbllee builtin command - +o Using the eennaabbllee builtin command to enable disabled shell + +o Using the eennaabbllee builtin command to enable disabled shell builtins +o specifying the --pp option to the ccoommmmaanndd builtin command @@ -4771,14 +4774,14 @@ RREESSTTRRIICCTTEEDD SSHHEELLLL These restrictions are enforced after any startup files are read. When a command that is found to be a shell script is executed (see CCOOMM-- - MMAANNDD EEXXEECCUUTTIIOONN above), rrbbaasshh turns off any restrictions in the shell + MMAANNDD EEXXEECCUUTTIIOONN above), rrbbaasshh turns off any restrictions in the shell spawned to execute the script. SSEEEE AALLSSOO _B_a_s_h _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, Brian Fox and Chet Ramey _T_h_e _G_n_u _R_e_a_d_l_i_n_e _L_i_b_r_a_r_y, Brian Fox and Chet Ramey _T_h_e _G_n_u _H_i_s_t_o_r_y _L_i_b_r_a_r_y, Brian Fox and Chet Ramey - _P_o_r_t_a_b_l_e _O_p_e_r_a_t_i_n_g _S_y_s_t_e_m _I_n_t_e_r_f_a_c_e _(_P_O_S_I_X_) _P_a_r_t _2_: _S_h_e_l_l _a_n_d _U_t_i_l_i_- + _P_o_r_t_a_b_l_e _O_p_e_r_a_t_i_n_g _S_y_s_t_e_m _I_n_t_e_r_f_a_c_e _(_P_O_S_I_X_) _P_a_r_t _2_: _S_h_e_l_l _a_n_d _U_t_i_l_i_- _t_i_e_s, IEEE _s_h(1), _k_s_h(1), _c_s_h(1) _e_m_a_c_s(1), _v_i(1) @@ -4794,7 +4797,7 @@ FFIILLEESS _~_/_._b_a_s_h_r_c The individual per-interactive-shell startup file _~_/_._b_a_s_h___l_o_g_o_u_t - The individual login shell cleanup file, executed when a login + The individual login shell cleanup file, executed when a login shell exits _~_/_._i_n_p_u_t_r_c Individual _r_e_a_d_l_i_n_e initialization file @@ -4808,14 +4811,14 @@ AAUUTTHHOORRSS BBUUGG RREEPPOORRTTSS If you find a bug in bbaasshh,, you should report it. But first, you should - make sure that it really is a bug, and that it appears in the latest - version of bbaasshh. The latest version is always available from + make sure that it really is a bug, and that it appears in the latest + version of bbaasshh. The latest version is always available from _f_t_p_:_/_/_f_t_p_._g_n_u_._o_r_g_/_p_u_b_/_b_a_s_h_/. - Once you have determined that a bug actually exists, use the _b_a_s_h_b_u_g - command to submit a bug report. If you have a fix, you are encouraged - to mail that as well! Suggestions and `philosophical' bug reports may - be mailed to _b_u_g_-_b_a_s_h_@_g_n_u_._o_r_g or posted to the Usenet newsgroup + Once you have determined that a bug actually exists, use the _b_a_s_h_b_u_g + command to submit a bug report. If you have a fix, you are encouraged + to mail that as well! Suggestions and `philosophical' bug reports may + be mailed to _b_u_g_-_b_a_s_h_@_g_n_u_._o_r_g or posted to the Usenet newsgroup ggnnuu..bbaasshh..bbuugg. ALL bug reports should include: @@ -4826,7 +4829,7 @@ BBUUGG RREEPPOORRTTSS A description of the bug behaviour A short script or `recipe' which exercises the bug - _b_a_s_h_b_u_g inserts the first three items automatically into the template + _b_a_s_h_b_u_g inserts the first three items automatically into the template it provides for filing a bug report. Comments and bug reports concerning this manual page should be directed @@ -4843,19 +4846,19 @@ BBUUGGSS Shell builtin commands and functions are not stoppable/restartable. Compound commands and command sequences of the form `a ; b ; c' are not - handled gracefully when process suspension is attempted. When a pro- + handled gracefully when process suspension is attempted. When a pro- cess is stopped, the shell immediately executes the next command in the sequence. It suffices to place the sequence of commands between paren- theses to force it into a subshell, which may be stopped as a unit. - Commands inside of $$((...)) command substitution are not parsed until - substitution is attempted. This will delay error reporting until some + Commands inside of $$((...)) command substitution are not parsed until + substitution is attempted. This will delay error reporting until some time after the command is entered. For example, unmatched parentheses, - even inside shell comments, will result in error messages while the + even inside shell comments, will result in error messages while the construct is being read. Array variables may not (yet) be exported. -GNU Bash-3.1-devel 2005 Feb 19 BASH(1) +GNU Bash-3.1-devel 2005 Mar 15 BASH(1) diff --git a/doc/bash.1 b/doc/bash.1 index abf2a50a4..160351ccc 100644 --- a/doc/bash.1 +++ b/doc/bash.1 @@ -6,12 +6,12 @@ .\" Case Western Reserve University .\" chet@po.CWRU.Edu .\" -.\" Last Change: Sat Feb 19 17:38:29 EST 2005 +.\" Last Change: Tue Mar 15 17:21:41 EST 2005 .\" .\" bash_builtins, strip all but Built-Ins section .if \n(zZ=1 .ig zZ .if \n(zY=1 .ig zY -.TH BASH 1 "2005 Feb 19" "GNU Bash-3.1-devel" +.TH BASH 1 "2005 Mar 15" "GNU Bash-3.1-devel" .\" .\" There's some problem with having a `@' .\" in a tagged paragraph with the BSD man macros. @@ -7290,7 +7290,7 @@ is empty, a non-existent directory stack entry is specified, or the directory change fails. .RE .TP -\fBprintf\fP \fIformat\fP [\fIarguments\fP] +\fBprintf\fP [\fB\-v\fP \fIvar\fP] \fIformat\fP [\fIarguments\fP] Write the formatted \fIarguments\fP to the standard output under the control of the \fIformat\fP. The \fIformat\fP is a character string which contains three types of objects: @@ -7306,6 +7306,9 @@ beginning with \fB\e0\fP may contain up to four digits), and \fB%q\fP causes \fBprintf\fP to output the corresponding \fIargument\fP in a format that can be reused as shell input. .sp 1 +The \fB\-v\fP option causes the output to be assigned to the variable +\fIvar\fP rather than being printed to the standard output. +.sp 1 The \fIformat\fP is reused as necessary to consume all of the \fIarguments\fP. If the \fIformat\fP requires more \fIarguments\fP than are supplied, the extra format specifications behave as if a zero value or null string, as diff --git a/doc/bash.html b/doc/bash.html index 0fb83b4c6..163566399 100644 --- a/doc/bash.html +++ b/doc/bash.html @@ -2,7 +2,7 @@ BASH(1) Manual Page -
BASH(1)2005 Feb 19BASH(1) +BASH(1)2005 Mar 15BASH(1)

Index
@@ -9384,7 +9384,7 @@ is empty, a non-existent directory stack entry is specified, or the directory change fails. -
printf format [arguments]
+
printf [-v var] format [arguments]
Write the formatted arguments to the standard output under the control of the format. The format is a character string which contains three types of objects: @@ -9400,6 +9400,9 @@ beginning with \0 may contain up to four digits), and %q causes printf to output the corresponding argument in a format that can be reused as shell input.

+The -v option causes the output to be assigned to the variable +var rather than being printed to the standard output. +

The format is reused as necessary to consume all of the arguments. If the format requires more arguments than are supplied, the extra format specifications behave as if a zero value or null string, as @@ -11484,6 +11487,6 @@ Array variables may not (yet) be exported.

This document was created by man2html from bash.1.
-Time: 22 February 2005 13:44:29 EST +Time: 15 March 2005 17:27:07 EST diff --git a/doc/bash.ps b/doc/bash.ps index d8658616a..80990cc71 100644 --- a/doc/bash.ps +++ b/doc/bash.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.18.1 -%%CreationDate: Tue Feb 22 13:37:34 2005 +%%CreationDate: Tue Mar 15 17:26:55 2005 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -326,8 +326,8 @@ E F2(po)2.5 E F0(\(portable object\) \214le format.)2.5 E F2 144 686.4 Q .3 -.15(ve \()-.25 H(see).15 E F4(INV)2.5 E(OCA)-.405 E (TION)-.855 E F0(belo)2.25 E(w\).)-.25 E F2(\255\255login)108 703.2 Q F0 (Equi)144 715.2 Q -.25(va)-.25 G(lent to).25 E F22.5 E F0(.)A -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(1)204 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(1)203.17 E 0 Cg EP %%Page: 2 3 %%BeginPageSetup BP @@ -449,8 +449,8 @@ F(ariable)-.25 E F3 -.27(BA)108 679.2 S(SH_ENV).27 E F0 1.01(in the en) 108 727.2 S 2.5(tt).2 G(he v)-2.5 E(alue of the)-.25 E F3 -.666(PA)2.5 G (TH)-.189 E F0 -.25(va)2.25 G (riable is not used to search for the \214le name.).25 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(2)204 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(2)203.17 E 0 Cg EP %%Page: 3 4 %%BeginPageSetup BP @@ -575,8 +575,8 @@ F1(Pipelines)87 679.2 Q F0(A)108 691.2 Q F2(pipeline)2.919 E F0 .419 F F1(|)2.92 E F0 5.42(.T)C .42(he format for a pipeline)-5.42 F(is:)108 703.2 Q([)144 720 Q F1(time)A F0([)2.5 E F1A F0(]] [ ! ])A F2 (command)2.5 E F0([)2.5 E F1(|)2.5 E F2(command2)2.5 E F0(... ])2.5 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(3)204 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(3)203.17 E 0 Cg EP %%Page: 4 5 %%BeginPageSetup BP @@ -696,8 +696,8 @@ A({)108 573.6 Q F1(list)2.5 E F0 2.5(;})C F1(list)3.89 E F0 .402 F(SIONS)144 727.2 Q F5(.)A F0 -.8(Wo)5.633 G 1.133 (rd splitting and pathname e).8 F 1.133 (xpansion are not performed on the w)-.15 F 1.133(ords between the)-.1 F -F3([[)3.632 E F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G -(005 Feb 19)-124.42 E(4)204 E 0 Cg EP +F3([[)3.632 E F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G +(005 Mar 15)-123.59 E(4)203.17 E 0 Cg EP %%Page: 5 6 %%BeginPageSetup BP @@ -834,8 +834,8 @@ F 1.538(played w)144 715.2 R 1.538(ords, then the v)-.1 F 1.538(alue of) F 1.537(ords and)-.1 F .065(prompt are displayed ag)144 727.2 R 2.565 (ain. If)-.05 F .065(EOF is read, the command completes.)2.565 F(An) 5.066 E 2.566(yo)-.15 G .066(ther v)-2.566 F .066(alue read causes)-.25 -F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(5)204 E 0 Cg EP +F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(5)203.17 E 0 Cg EP %%Page: 6 7 %%BeginPageSetup BP @@ -972,8 +972,8 @@ F0 1.337(option is on by def)3.837 F 1.337(ault in)-.1 F(interacti)108 -.25 F F1(history e)108 715.2 Q(xpansion)-.2 E F0(character)2.5 E 2.5 (,u)-.4 G(sually)-2.5 E F2(!)2.5 E F0 2.5(,m)C(ust be quoted to pre)-2.5 E -.15(ve)-.25 G(nt history e).15 E(xpansion.)-.15 E(GNU Bash-3.1-de)72 -768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(6)204 E 0 Cg -EP +768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(6)203.17 E 0 +Cg EP %%Page: 7 8 %%BeginPageSetup BP @@ -1094,8 +1094,8 @@ F0(belo)3.401 E 3.401(w\). W)-.25 F .901 (alias)3.648 E F0(,)A F2(declar)3.648 E(e)-.18 E F0(,)A F2(typeset)3.648 E F0(,)A F2(export)3.648 E F0(,)A F2 -.18(re)108 729.6 S(adonly).18 E F0 2.5(,a)C(nd)-2.5 E F2(local)2.5 E F0 -.2(bu)2.5 G(iltin commands.).2 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(7)204 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(7)203.17 E 0 Cg EP %%Page: 8 9 %%BeginPageSetup BP @@ -1227,8 +1227,8 @@ F2 -.3(BA)108 672 S(SH_ARGC).3 E F0 1.039(An array v)144 684 R 1.039 (cuted, the number of).15 F 1.525(parameters passed is pushed onto)144 720 R F2 -.3(BA)4.024 G(SH_ARGC).3 E F0 6.524(.T)C 1.524(he shell sets) -6.524 F F2 -.3(BA)4.024 G(SH_ARGC).3 E F0 1.524(only when in)4.024 F -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(8)204 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(8)203.17 E 0 Cg EP %%Page: 9 10 %%BeginPageSetup BP @@ -1329,8 +1329,8 @@ F .667(If the)5.667 F .535 F(in)144 721.2 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(db).1 G 2.5(yt)-2.5 G (he programmable completion f)-2.5 E(acilities \(see)-.1 E F1(Pr)2.5 E (ogrammable Completion)-.18 E F0(belo)2.5 E(w\).)-.25 E(GNU Bash-3.1-de) -72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(9)204 E 0 -Cg EP +72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(9)203.17 E +0 Cg EP %%Page: 10 11 %%BeginPageSetup BP @@ -1423,8 +1423,8 @@ F1(cd)2.5 E F0(command.)2.5 E F1(OPT)108 681.6 Q(ARG)-.9 E F0 1.627 (gument processed by the)-.18 F F1(getopts)4.127 E F0 -.2(bu)4.127 G 1.626(iltin command \(see).2 F F2(SHELL)4.126 E -.09(BU)144 705.6 S(IL) .09 E(TIN COMMANDS)-.828 E F0(belo)2.25 E(w\).)-.25 E(GNU Bash-3.1-de)72 -768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(10)199 E 0 Cg -EP +768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(10)198.17 E 0 +Cg EP %%Page: 11 12 %%BeginPageSetup BP @@ -1519,8 +1519,8 @@ en printing selection lists.).2 F (in)144 705.6 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(db).1 G 2.5(yt)-2.5 G (he programmable completion f)-2.5 E(acility \(see)-.1 E F1(Pr)2.5 E (ogrammable Completion)-.18 E F0(belo)2.5 E(w\).)-.25 E(GNU Bash-3.1-de) -72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(11)199 E 0 -Cg EP +72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(11)198.17 E +0 Cg EP %%Page: 12 13 %%BeginPageSetup BP @@ -1639,8 +1639,8 @@ R F1(history)3.173 E F0 -.2(bu)3.172 G 3.172(iltin. If).2 F .672(this v) (adds the contents of the ne)3.215 F 3.215<778c>-.25 G .715(le to the e) -3.215 F .715(xisting list.)-.15 F(If)5.716 E F3(HOSTFILE)3.216 E F0 .716(is set, b)2.966 F .716(ut has no v)-.2 F(alue,)-.25 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(12)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(12)198.17 E 0 Cg EP %%Page: 13 14 %%BeginPageSetup BP @@ -1746,8 +1746,8 @@ F F3 .359(SHELL B)144 636 R(UIL)-.09 E .359(TIN COMMANDS)-.828 F F0 -.1 F 26.329(administrator who installs)144 708 R F1(bash)28.829 E F0 31.329(.A)C 26.328(common v)-2.501 F 26.328(alue is)-.25 F/F4 10 /Courier@0 SF(/usr/gnu/bin:/usr/local/bin:/usr/ucb:/bin:/usr/bin)144 720 -Q F0(.)A(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G -(005 Feb 19)-124.42 E(13)199 E 0 Cg EP +Q F0(.)A(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G +(005 Mar 15)-123.59 E(13)198.17 E 0 Cg EP %%Page: 14 15 %%BeginPageSetup BP @@ -1864,8 +1864,8 @@ F F2(substring)3.125 E F0 3.125(,t).22 G .625 .833(job identi\214er \(see)5.833 F F4 .834(JOB CONTR)3.334 F(OL)-.27 E F0(belo)3.084 E 3.334(w\). If)-.25 F .834(set to an)3.334 F 3.334(yo) -.15 G .834(ther v)-3.334 F .834(alue, the supplied string)-.25 F -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(14)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(14)198.17 E 0 Cg EP %%Page: 15 16 %%BeginPageSetup BP @@ -2008,8 +2008,8 @@ E .471(The order of e)108 703.2 R .471(xpansions is: brace e)-.15 F .471 .47(ariable and arithmetic e)-3.221 F(xpansion)-.15 E (and command substitution \(done in a left-to-right f)108 715.2 Q (ashion\), w)-.1 E(ord splitting, and pathname e)-.1 E(xpansion.)-.15 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(15)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(15)198.17 E 0 Cg EP %%Page: 16 17 %%BeginPageSetup BP @@ -2140,8 +2140,8 @@ ith the corresponding element from the directory stack, as it w)108 (consist of a number without a leading `+' or `\255', `+' is assumed.) 108 712.8 Q(If the login name is in)108 729.6 Q -.25(va)-.4 G (lid, or the tilde e).25 E(xpansion f)-.15 E(ails, the w)-.1 E -(ord is unchanged.)-.1 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 -(l2).15 G(005 Feb 19)-124.42 E(16)199 E 0 Cg EP +(ord is unchanged.)-.1 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59 +(l2).15 G(005 Mar 15)-123.59 E(16)198.17 E 0 Cg EP %%Page: 17 18 %%BeginPageSetup BP @@ -2272,8 +2272,8 @@ F0 .111(is tak)2.61 F .111(en relati)-.1 F .411 -.15(ve t)-.25 H 2.611 (id being confused with the :- e).2 F 3.141(xpansion. Substring)-.15 F (inde)3.141 E .641(xing is zero-based unless the)-.15 F (positional parameters are used, in which case the inde)144 712.8 Q -(xing starts at 1.)-.15 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 -(l2).15 G(005 Feb 19)-124.42 E(17)199 E 0 Cg EP +(xing starts at 1.)-.15 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59 +(l2).15 G(005 Mar 15)-123.59 E(17)198.17 E 0 Cg EP %%Page: 18 19 %%BeginPageSetup BP @@ -2392,7 +2392,8 @@ F1(`)A(Bash)108 715.2 Q F0 .019(performs the e)2.519 F .019 (dard output of the command, with an)108 727.2 R 3.268(yt)-.15 G .768 (railing ne)-3.268 F .768(wlines deleted.)-.25 F .768(Embedded ne)5.768 F .768(wlines are not deleted, b)-.25 F(ut)-.2 E(GNU Bash-3.1-de)72 768 -Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(18)199 E 0 Cg EP +Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(18)198.17 E 0 Cg +EP %%Page: 19 20 %%BeginPageSetup BP @@ -2520,7 +2521,7 @@ F .765(ord is left unchanged.)-.1 F .765(If the)5.765 F F1(nullglob) 2.065(is printed and the command is not e)108 727.2 R -.15(xe)-.15 G 4.565(cuted. If).15 F 2.065(the shell option)4.565 F F1(nocaseglob)4.565 E F0 2.066(is enabled, the match is)4.566 F(GNU Bash-3.1-de)72 768 Q --.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(19)199 E 0 Cg EP +-.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(19)198.17 E 0 Cg EP %%Page: 20 21 %%BeginPageSetup BP @@ -2638,8 +2639,8 @@ F0(.)A(Composite patterns may be formed using one or more of the follo) (Matches one or more occurrences of the gi)180 682.8 Q -.15(ve)-.25 G 2.5(np).15 G(atterns)-2.5 E F1(@\()144 694.8 Q F3(pattern-list).833 E F1 (\)).833 E F0(Matches one of the gi)180 706.8 Q -.15(ve)-.25 G 2.5(np) -.15 G(atterns)-2.5 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2) -.15 G(005 Feb 19)-124.42 E(20)199 E 0 Cg EP +.15 G(atterns)-2.5 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2) +.15 G(005 Mar 15)-123.59 E(20)198.17 E 0 Cg EP %%Page: 21 22 %%BeginPageSetup BP @@ -2730,7 +2731,7 @@ hould be used with care, as the)108 626.4 R 3.447(ym)-.15 G .947 (is not speci\214ed.)2.74 E (The general format for redirecting input is:)108 696 Q([)144 712.8 Q F2 (n)A F0(])A F1(<)A F2(wor)A(d)-.37 E F0(GNU Bash-3.1-de)72 768 Q -.15 -(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(21)199 E 0 Cg EP +(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(21)198.17 E 0 Cg EP %%Page: 22 23 %%BeginPageSetup BP @@ -2820,8 +2821,8 @@ F0 .774(are quoted, the)4.044 F F2(delimiter)3.624 E F0 .774 (<<<)144 679.2 Q F2(wor)A(d)-.37 E F0(The)108 696 Q F2(wor)2.5 E(d)-.37 E F0(is e)2.5 E (xpanded and supplied to the command on its standard input.)-.15 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(22)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(22)198.17 E 0 Cg EP %%Page: 23 24 %%BeginPageSetup BP @@ -2935,8 +2936,8 @@ E .436 (another command does not tak)108 727.2 R 3.662(ee)-.1 G -.25(ff)-3.662 G 1.162(ect until the ne).25 F 1.162(xt line of input is read.)-.15 F 1.162(The commands follo)6.162 F 1.162(wing the)-.25 F(GNU Bash-3.1-de) -72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(23)199 E 0 -Cg EP +72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(23)198.17 E +0 Cg EP %%Page: 24 25 %%BeginPageSetup BP @@ -3058,8 +3059,8 @@ F .206(gers with no)-.15 F .429(check for o)108 537.6 R -.15(ve)-.15 G (multiplication, di)10.72 E(vision, remainder)-.25 E F1 2.5<2bad>108 674.4 S F0(addition, subtraction)19.6 E F1(<< >>)108 686.4 Q F0 (left and right bitwise shifts)10.7 E F1(<= >= < >)108 698.4 Q F0 -(comparison)144 710.4 Q(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 -(l2).15 G(005 Feb 19)-124.42 E(24)199 E 0 Cg EP +(comparison)144 710.4 Q(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59 +(l2).15 G(005 Mar 15)-123.59 E(24)198.17 E 0 Cg EP %%Page: 25 26 %%BeginPageSetup BP @@ -3164,7 +3165,7 @@ F2(\214le)2.5 E F0 -.35(Tr)10.02 G(ue if).35 E F2(\214le)2.5 E F0 -.15 (ex)2.5 G(ists and its set-user).15 E(-id bit is set.)-.2 E F1108 708 Q F2(\214le)2.5 E F0 -.35(Tr)8.36 G(ue if).35 E F2(\214le)2.5 E F0 -.15(ex)2.5 G(ists and is writable.).15 E(GNU Bash-3.1-de)72 768 Q -.15 -(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(25)199 E 0 Cg EP +(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(25)198.17 E 0 Cg EP %%Page: 26 27 %%BeginPageSetup BP @@ -3265,7 +3266,7 @@ R(an)3.176 E 3.176(yo)-.15 G 3.176(ft)-3.176 G .677 .149(ut do not af)-.2 F .149(fect the current shell en)-.25 F 2.649 (vironment. A)-.4 F(redirection error causes the command to e)108 729.6 Q(xit with a non-zero status.)-.15 E(GNU Bash-3.1-de)72 768 Q -.15(ve) --.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(26)199 E 0 Cg EP +-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(26)198.17 E 0 Cg EP %%Page: 27 28 %%BeginPageSetup BP @@ -3376,8 +3377,8 @@ F4($PPID)2.5 E F0 .426(When a simple command other than a b)108 686.4 R -2.927 G(eparate)-2.927 E -.15(exe)108 698.4 S .134(cution en).15 F .134 (vironment that consists of the follo)-.4 F 2.634(wing. Unless)-.25 F .133(otherwise noted, the v)2.634 F .133(alues are inherited from)-.25 F -(the shell.)108 710.4 Q(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 -(l2).15 G(005 Feb 19)-124.42 E(27)199 E 0 Cg EP +(the shell.)108 710.4 Q(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59 +(l2).15 G(005 Mar 15)-123.59 E(27)198.17 E 0 Cg EP %%Page: 28 29 %%BeginPageSetup BP @@ -3494,8 +3495,8 @@ F0 .202(itself returns the e)2.702 F .202 (cuted, unless a syntax error occurs, in which case).15 F(it e)108 705.6 Q(xits with a non-zero v)-.15 E 2.5(alue. See)-.25 F(also the)2.5 E F1 (exit)2.5 E F0 -.2(bu)2.5 G(iltin command belo).2 E -.65(w.)-.25 G -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(28)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(28)198.17 E 0 Cg EP %%Page: 29 30 %%BeginPageSetup BP @@ -3632,8 +3633,8 @@ E F0 .277(refers to a stopped)2.777 F F2(ce)2.777 E F0(job)2.777 E 5.277 724.8 R F2(bash)2.88 E F0 .38(reports an error)2.88 F 5.38(.U)-.55 G (sing)-5.38 E F2(%?ce)2.88 E F0 2.88(,o)C 2.88(nt)-2.88 G .38 (he other hand, refers to an)-2.88 F 2.88(yj)-.15 G(ob)-2.88 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(29)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(29)198.17 E 0 Cg EP %%Page: 30 31 %%BeginPageSetup BP @@ -3737,8 +3738,8 @@ uld be used to embed a terminal)-.15 F(control sequence into the prompt) (end a sequence of non-printing characters)29.89 E .119 (The command number and the history number are usually dif)108 720 R .12 (ferent: the history number of a command is its)-.25 F(GNU Bash-3.1-de) -72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(30)199 E 0 -Cg EP +72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(30)198.17 E +0 Cg EP %%Page: 31 32 %%BeginPageSetup BP @@ -3868,8 +3869,8 @@ F0(,).72 E F4(SP)2.5 E -.3(AC)-.9 G(E).3 E F0 2.5(,a).73 G(nd)-2.5 E F4 E F4(macr)4.042 E(o)-.45 E F0(,)A F4 -.1(ke)4.042 G(yname)-.2 E F0 1.542 (is the name of a k)4.222 F 1.841 -.15(ey s)-.1 H 1.541(pelled out in) .15 F 2.5(English. F)108 717.6 R(or e)-.15 E(xample:)-.15 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(31)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(31)198.17 E 0 Cg EP %%Page: 32 33 %%BeginPageSetup BP @@ -3957,8 +3958,8 @@ F0 .01(Controls what happens when readline w)144 700.8 R .011 F0 3.44(,r)C .94(eadline uses a visible bell if one is a)-3.44 F -.25 (va)-.2 G 3.44(ilable. If).25 F .94(set to)3.44 F F2(audible)3.44 E F0 (,)A(readline attempts to ring the terminal')144 724.8 Q 2.5(sb)-.55 G -(ell.)-2.5 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G -(005 Feb 19)-124.42 E(32)199 E 0 Cg EP +(ell.)-2.5 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G +(005 Mar 15)-123.59 E(32)198.17 E 0 Cg EP %%Page: 33 34 %%BeginPageSetup BP @@ -4056,8 +4057,8 @@ E(ault k)-.1 E -.15(ey)-.1 G(map.).15 E F1(mark\255dir)108 672 Q .15 E F1(mark\255modi\214ed\255lines \(Off\))108 696 Q F0(If set to)144 708 Q F1(On)2.5 E F0 2.5(,h)C(istory lines that ha)-2.5 E .3 -.15(ve b) -.2 H(een modi\214ed are displayed with a preceding asterisk \().15 E F1 -(*)A F0(\).)A(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G -(005 Feb 19)-124.42 E(33)199 E 0 Cg EP +(*)A F0(\).)A(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G +(005 Mar 15)-123.59 E(33)198.17 E 0 Cg EP %%Page: 34 35 %%BeginPageSetup BP @@ -4156,8 +4157,8 @@ Q F1(application)3.003 E F0 .503 (ey s)-.1 H .397(equence that quotes the).15 F(current or pre)180 684 Q (vious w)-.25 E(ord in Bash:)-.1 E F1($if)180 708 Q F0(Bash)2.5 E 2.5 (#Q)180 720 S(uote the current or pre)-2.5 E(vious w)-.25 E(ord)-.1 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(34)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(34)198.17 E 0 Cg EP %%Page: 35 36 %%BeginPageSetup BP @@ -4248,7 +4249,7 @@ Q .822 -.15(ve f)-.15 H(orw).15 E .522(ard to the end of the ne)-.1 F (ack to the start of the current or pre).15 F 1.41(vious w)-.25 F 3.91 (ord. W)-.1 F 1.41(ords are composed of alphanumeric)-.8 F (characters \(letters and digits\).)144 696 Q(GNU Bash-3.1-de)72 768 Q --.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(35)199 E 0 Cg EP +-.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(35)198.17 E 0 Cg EP %%Page: 36 37 %%BeginPageSetup BP @@ -4345,8 +4346,8 @@ E(g)-.1 E F0(mo)3.236 E -.15(ve)-.15 G .728 (See)5.939 E F2(HIST)3.439 E(OR)-.162 E 3.189(YE)-.315 G(XP)-3.189 E (ANSION)-.666 E F0(belo)3.189 E 3.439(wf)-.25 G .939(or a descrip-) -3.439 F(tion of history e)144 724.8 Q(xpansion.)-.15 E(GNU Bash-3.1-de) -72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(36)199 E 0 -Cg EP +72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(36)198.17 E +0 Cg EP %%Page: 37 38 %%BeginPageSetup BP @@ -4449,8 +4450,8 @@ F(ferently)-.25 E 6.894(.E)-.65 G 1.894(ach call to)-6.894 F F4 -.37(re) (mode. In)144 724.8 R -.15(ove)3.968 G 1.468 (rwrite mode, characters bound to).15 F F1(self\255insert)3.969 E F0 1.469(replace the te)3.969 F 1.469(xt at point rather than)-.15 F -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(37)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(37)198.17 E 0 Cg EP %%Page: 38 39 %%BeginPageSetup BP @@ -4534,8 +4535,8 @@ F0(or)2.5 E F1(yank\255pop)2.5 E F0(.)A F1(Numeric Ar)87 549.6 Q (cuting this function the \214rst time mak).15 F .378(es the ar)-.1 F .378(gument count)-.18 F(four)144 681.6 Q 2.5(,as)-.4 G(econd time mak) -2.5 E(es the ar)-.1 E(gument count sixteen, and so on.)-.18 E F1 -(Completing)87 698.4 Q F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 -(l2).15 G(005 Feb 19)-124.42 E(38)199 E 0 Cg EP +(Completing)87 698.4 Q F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59 +(l2).15 G(005 Mar 15)-123.59 E(38)198.17 E 0 Cg EP %%Page: 39 40 %%BeginPageSetup BP @@ -4627,8 +4628,8 @@ in braces so)144 648 R(the list is a)144 660 Q -.25(va)-.2 G E(start\255kbd\255macr)108 688.8 Q 2.5(o\()-.18 G(C\255x \()-2.5 E(\)) .833 E F0(Be)144 700.8 Q(gin sa)-.15 E (ving the characters typed into the current k)-.2 E -.15(ey)-.1 G -(board macro.).15 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2) -.15 G(005 Feb 19)-124.42 E(39)199 E 0 Cg EP +(board macro.).15 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2) +.15 G(005 Mar 15)-123.59 E(39)198.17 E 0 Cg EP %%Page: 40 41 %%BeginPageSetup BP @@ -4727,7 +4728,7 @@ F .872(the line is redra)144 712.8 R 3.372(wn. If)-.15 F 3.372(an)3.372 G .872(umeric ar)-3.372 F .872 (gument is supplied, an asterisk is appended before pathname)-.18 F -.15 (ex)144 724.8 S(pansion.).15 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G -124.42(l2).15 G(005 Feb 19)-124.42 E(40)199 E 0 Cg EP +123.59(l2).15 G(005 Mar 15)-123.59 E(40)198.17 E 0 Cg EP %%Page: 41 42 %%BeginPageSetup BP @@ -4850,7 +4851,7 @@ F12.581 E F0 .081(option is in)2.581 F -.2(vo)-.4 G -.1(ke).2 G .377(After all of the possible completions are generated, an)108 720 R 2.877<798c>-.15 G .377(lter speci\214ed with the)-2.877 F F12.876 E F0 .376(option is applied to the)2.876 F(GNU Bash-3.1-de)72 768 Q -.15 -(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(41)199 E 0 Cg EP +(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(41)198.17 E 0 Cg EP %%Page: 42 43 %%BeginPageSetup BP @@ -4995,8 +4996,8 @@ H .374(he command with embedded ne).15 F .373 2.014(can be disabled using the)108 720 R F1(+H)4.514 E F0 2.014 (option to the)4.514 F F1(set)4.514 E F0 -.2(bu)4.514 G 2.014 (iltin command \(see).2 F F4 2.013(SHELL B)4.513 F(UIL)-.09 E 2.013 -(TIN COMMANDS)-.828 F F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 -(l2).15 G(005 Feb 19)-124.42 E(42)199 E 0 Cg EP +(TIN COMMANDS)-.828 F F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59 +(l2).15 G(005 Mar 15)-123.59 E(42)198.17 E 0 Cg EP %%Page: 43 44 %%BeginPageSetup BP @@ -5115,8 +5116,8 @@ F2 2.5(0\()108 667.2 S(zer)-2.5 E(o\))-.18 E F0(The zeroth w)144 679.2 Q F1(n)108.36 691.2 Q F0(The)30.64 E F1(n)2.5 E F0(th w)A(ord.)-.1 E F2(^) 108 703.2 Q F0(The \214rst ar)32.67 E 2.5(gument. That)-.18 F(is, w)2.5 E(ord 1.)-.1 E F2($)108 715.2 Q F0(The last ar)31 E(gument.)-.18 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(43)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(43)198.17 E 0 Cg EP %%Page: 44 45 %%BeginPageSetup BP @@ -5242,7 +5243,7 @@ F 1.313(plied, the name and v)144 730.8 R 1.314 (alue of the alias is printed.)-.25 F F1(Alias)6.314 E F0 1.314 (returns true unless a)3.814 F F2(name)3.814 E F0 1.314(is gi)3.814 F -.15(ve)-.25 G 3.814(nf).15 G(or)-3.814 E(GNU Bash-3.1-de)72 768 Q -.15 -(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(44)199 E 0 Cg EP +(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(44)198.17 E 0 Cg EP %%Page: 45 46 %%BeginPageSetup BP @@ -5356,8 +5357,8 @@ R F2(dir)2.71 E F0 5.21(.T)C .21(he v)-5.21 F(ariable)-.25 E/F4 9 (de\214nes the search path for the directory containing)144 724.8 R F2 (dir)3.276 E F0 5.776(.A).73 G(lternati)-5.776 E 1.076 -.15(ve d)-.25 H .776(irectory names in).15 F F4(CDP)3.276 E -.855(AT)-.666 G(H).855 E F0 -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(45)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(45)198.17 E 0 Cg EP %%Page: 46 47 %%BeginPageSetup BP @@ -5488,8 +5489,8 @@ F23.223 E F0 .722 (options\) should be quoted to protect them from e)3.223 F(xpan-)-.15 E (sion before the)144 715.2 Q F2(complete)2.5 E F0 -.2(bu)2.5 G (iltin is in).2 E -.2(vo)-.4 G -.1(ke).2 G(d.).1 E(GNU Bash-3.1-de)72 -768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(46)199 E 0 Cg -EP +768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(46)198.17 E 0 +Cg EP %%Page: 47 48 %%BeginPageSetup BP @@ -5560,8 +5561,8 @@ F0(option to the)2.5 E F1(set)2.5 E F0 -.2(bu)2.5 G(iltin.).2 E F1 (May also be speci\214ed as)5 E F12.5 E F0(.)A F1 -.1(va)184 708 S (riable).1 E F0(Names of all shell v)5.1 E 2.5(ariables. May)-.25 F (also be speci\214ed as)2.5 E F12.5 E F0(.)A(GNU Bash-3.1-de)72 -768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(47)199 E 0 Cg -EP +768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(47)198.17 E 0 +Cg EP %%Page: 48 49 %%BeginPageSetup BP @@ -5682,8 +5683,8 @@ E(UG)-.1 E F0(and)2.929 E F1(RETURN)2.929 E F0 .801(return v)144 727.2 R .801(alue is 0 unless an in)-.25 F -.25(va)-.4 G .8 (lid option is encountered, an attempt is made to de\214ne a function) -.25 F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G -(005 Feb 19)-124.42 E(48)199 E 0 Cg EP +.25 F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G +(005 Mar 15)-123.59 E(48)198.17 E 0 Cg EP %%Page: 49 50 %%BeginPageSetup BP @@ -5794,8 +5795,8 @@ F3(\214lename)2.5 E F0 2.5(][)C F3(name)-2.5 E F0(...])2.5 E .277 (ws a disk command which has)-.25 F .834(the same name as a shell b)144 720 R .834(uiltin to be e)-.2 F -.15(xe)-.15 G .834 (cuted without specifying a full pathname, e).15 F -.15(ve)-.25 G 3.333 -(nt).15 G(hough)-3.333 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 -(l2).15 G(005 Feb 19)-124.42 E(49)199 E 0 Cg EP +(nt).15 G(hough)-3.333 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59 +(l2).15 G(005 Mar 15)-123.59 E(49)198.17 E 0 Cg EP %%Page: 50 51 %%BeginPageSetup BP @@ -5938,7 +5939,7 @@ F0 -.25(va)2.881 G .631(riable is used, and the v).25 F .631(alue of) (ariable is set,)-.25 F F2(vi)5.116 E F0 .95(is used.)5.116 F .951 (When editing is complete, the edited commands are echoed and)5.95 F -.15(exe)144 708 S(cuted.).15 E(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G -124.42(l2).15 G(005 Feb 19)-124.42 E(50)199 E 0 Cg EP +123.59(l2).15 G(005 Mar 15)-123.59 E(50)198.17 E 0 Cg EP %%Page: 51 52 %%BeginPageSetup BP @@ -6066,8 +6067,8 @@ F32.952 E F0 .452(option causes the shell to for)2.952 F .453 (If the)144 722.4 R F34.206 E F0 1.706 (option is supplied, the full pathname to which each)4.206 F F1(name) 4.206 E F0 1.707(corresponds is printed.)4.207 F(If)6.707 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(51)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(51)198.17 E 0 Cg EP %%Page: 52 53 %%BeginPageSetup BP @@ -6177,8 +6178,8 @@ E F1(jobspec)4.24 E F0(is supplied.)2.81 E 2.067(If the)144 724.8 R F2 4.567 E F0 2.067(option is supplied,)4.567 F F2(jobs)4.567 E F0 2.067(replaces an)4.567 F(y)-.15 E F1(jobspec)6.307 E F0 2.067(found in) 4.877 F F1(command)4.767 E F0(or)5.337 E F1(ar)4.897 E(gs)-.37 E F0 -2.066(with the)4.836 F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 -(l2).15 G(005 Feb 19)-124.42 E(52)199 E 0 Cg EP +2.066(with the)4.836 F(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59 +(l2).15 G(005 Mar 15)-123.59 E(52)198.17 E 0 Cg EP %%Page: 53 54 %%BeginPageSetup BP @@ -6272,9 +6273,9 @@ F0 .644(is performed as well, and the return status is 0.)3.143 F F2 (lid option is encountered, the directory stack is empty).25 F 2.915 (,an)-.65 G(on-e)-2.915 E .415(xistent direc-)-.15 F (tory stack entry is speci\214ed, or the directory change f)144 520.8 Q -(ails.)-.1 E F2(printf)108 537.6 Q F1(format)2.5 E F0([)2.5 E F1(ar)A -(guments)-.37 E F0(])A .372(Write the formatted)144 549.6 R F1(ar)2.872 -E(guments)-.37 E F0 .372 +(ails.)-.1 E F2(printf)108 537.6 Q F0([)2.5 E F2A F1(var)2.5 E F0 +(])A F1(format)2.5 E F0([)2.5 E F1(ar)A(guments)-.37 E F0(])A .372 +(Write the formatted)144 549.6 R F1(ar)2.872 E(guments)-.37 E F0 .372 (to the standard output under the control of the)2.872 F F1(format)2.872 E F0 5.372(.T)C(he)-5.372 E F1(format)2.872 E F0 1.804(is a character s\ tring which contains three types of objects: plain characters, which ar\ @@ -6296,17 +6297,20 @@ F -.15(ve)-.15 G .922(d, and octal escapes be).15 F .922(ginning with) F F2(%q)144 633.6 Q F0(causes)3.631 E F2(printf)3.631 E F0 1.131 (to output the corresponding)3.631 F F1(ar)3.631 E(gument)-.37 E F0 1.13 (in a format that can be reused as shell)3.631 F(input.)144 645.6 Q(The) -144 669.6 Q F1(format)3.423 E F0 .923 -(is reused as necessary to consume all of the)3.423 F F1(ar)3.423 E +144 669.6 Q F22.903 E F0 .404 +(option causes the output to be assigned to the v)2.903 F(ariable)-.25 E +F1(var)2.904 E F0 .404(rather than being printed to the)2.904 F +(standard output.)144 681.6 Q(The)144 705.6 Q F1(format)3.424 E F0 .923 +(is reused as necessary to consume all of the)3.424 F F1(ar)3.423 E (guments)-.37 E F0 5.923(.I)C 3.423(ft)-5.923 G(he)-3.423 E F1(format) -3.423 E F0 .924(requires more)3.424 F F1(ar)144 681.6 Q(guments)-.37 E -F0 .033(than are supplied, the e)2.534 F .033 +3.423 E F0 .923(requires more)3.423 F F1(ar)144 717.6 Q(guments)-.37 E +F0 .033(than are supplied, the e)2.533 F .033 (xtra format speci\214cations beha)-.15 F .333 -.15(ve a)-.2 H 2.533(si) -.15 G 2.533(faz)-2.533 G .033(ero v)-2.533 F .033(alue or null string,) --.25 F(as appropriate, had been supplied.)144 693.6 Q(The return v)5 E +.15 G 2.533(faz)-2.533 G .033(ero v)-2.533 F .034(alue or null string,) +-.25 F(as appropriate, had been supplied.)144 729.6 Q(The return v)5 E (alue is zero on success, non-zero on f)-.25 E(ailure.)-.1 E -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(53)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(53)198.17 E 0 Cg EP %%Page: 54 55 %%BeginPageSetup BP @@ -6315,17 +6319,17 @@ BP -.35 E/F1 10/Times-Bold@0 SF(pushd)108 84 Q F0([)2.5 E F1A F0 2.5 (][)C/F2 10/Times-Italic@0 SF(dir)-2.5 E F0(])A F1(pushd)108 96 Q F0([) 2.5 E F1A F0 2.5(][)C(+)-2.5 E F2(n)A F0 2.5(][)C-2.5 E F2(n)A -F0(])A .639(Adds a directory to the top of the directory stack, or rota\ -tes the stack, making the ne)144 108 R 3.14(wt)-.25 G .64(op of the) --3.14 F 1.316(stack the current w)144 120 R 1.316(orking directory)-.1 F -6.316(.W)-.65 G 1.315(ith no ar)-6.716 F 1.315(guments, e)-.18 F 1.315 -(xchanges the top tw)-.15 F 3.815(od)-.1 G 1.315(irectories and)-3.815 F -.871(returns 0, unless the directory stack is empty)144 132 R 5.871(.A) --.65 G -.18(rg)-5.871 G .872(uments, if supplied, ha).18 F 1.172 -.15 -(ve t)-.2 H .872(he follo).15 F .872(wing mean-)-.25 F(ings:)144 144 Q -F1(+)144 156 Q F2(n)A F0 1.268(Rotates the stack so that the)25.3 F F2 -(n)3.768 E F0 1.267 -(th directory \(counting from the left of the list sho)B 1.267(wn by) +F0(])A .64(Adds a directory to the top of the directory stack, or rotat\ +es the stack, making the ne)144 108 R 3.139(wt)-.25 G .639(op of the) +-3.139 F 1.315(stack the current w)144 120 R 1.315(orking directory)-.1 +F 6.315(.W)-.65 G 1.315(ith no ar)-6.715 F 1.315(guments, e)-.18 F 1.316 +(xchanges the top tw)-.15 F 3.816(od)-.1 G 1.316(irectories and)-3.816 F +.872(returns 0, unless the directory stack is empty)144 132 R 5.871(.A) +-.65 G -.18(rg)-5.871 G .871(uments, if supplied, ha).18 F 1.171 -.15 +(ve t)-.2 H .871(he follo).15 F .871(wing mean-)-.25 F(ings:)144 144 Q +F1(+)144 156 Q F2(n)A F0 1.267(Rotates the stack so that the)25.3 F F2 +(n)3.767 E F0 1.268 +(th directory \(counting from the left of the list sho)B 1.268(wn by) -.25 F F1(dirs)180 168 Q F0 2.5(,s)C(tarting with zero\) is at the top.) -2.5 E F1144 180 Q F2(n)A F0 .92(Rotates the stack so that the)25.3 F F2(n)3.42 E F0 .92 @@ -6336,26 +6340,26 @@ hen adding directories to the stack, so that)24.74 F (only the stack is manipulated.)180 216 Q F2(dir)144.35 228 Q F0(Adds) 23.98 E F2(dir)2.85 E F0 (to the directory stack at the top, making it the ne)3.23 E 2.5(wc)-.25 -G(urrent w)-2.5 E(orking directory)-.1 E(.)-.65 E .488(If the)144 244.8 -R F1(pushd)2.988 E F0 .488(command is successful, a)2.988 F F1(dirs) -2.988 E F0 .488(is performed as well.)2.988 F .489 -(If the \214rst form is used,)5.488 F F1(pushd)2.989 E F0 1.04 -(returns 0 unless the cd to)144 256.8 R F2(dir)3.89 E F0 -.1(fa)4.27 G -3.539(ils. W).1 F 1.039(ith the second form,)-.4 F F1(pushd)3.539 E F0 -1.039(returns 0 unless the directory)3.539 F .846(stack is empty)144 -268.8 R 3.346(,an)-.65 G(on-e)-3.346 E .847(xistent directory stack ele\ -ment is speci\214ed, or the directory change to the)-.15 F -(speci\214ed ne)144 280.8 Q 2.5(wc)-.25 G(urrent directory f)-2.5 E -(ails.)-.1 E F1(pwd)108 297.6 Q F0([)2.5 E F1(\255LP)A F0(])A .845 +G(urrent w)-2.5 E(orking directory)-.1 E(.)-.65 E .489(If the)144 244.8 +R F1(pushd)2.989 E F0 .489(command is successful, a)2.989 F F1(dirs) +2.988 E F0 .488(is performed as well.)2.988 F .488 +(If the \214rst form is used,)5.488 F F1(pushd)2.988 E F0 1.039 +(returns 0 unless the cd to)144 256.8 R F2(dir)3.889 E F0 -.1(fa)4.269 G +3.539(ils. W).1 F 1.039(ith the second form,)-.4 F F1(pushd)3.54 E F0 +1.04(returns 0 unless the directory)3.54 F .847(stack is empty)144 268.8 +R 3.347(,an)-.65 G(on-e)-3.347 E .847(xistent directory stack element i\ +s speci\214ed, or the directory change to the)-.15 F(speci\214ed ne)144 +280.8 Q 2.5(wc)-.25 G(urrent directory f)-2.5 E(ails.)-.1 E F1(pwd)108 +297.6 Q F0([)2.5 E F1(\255LP)A F0(])A .844 (Print the absolute pathname of the current w)144 309.6 R .845 -(orking directory)-.1 F 5.844(.T)-.65 G .844 -(he pathname printed contains no)-5.844 F .181(symbolic links if the)144 +(orking directory)-.1 F 5.845(.T)-.65 G .845 +(he pathname printed contains no)-5.845 F .182(symbolic links if the)144 321.6 R F12.681 E F0 .181(option is supplied or the)2.681 F F1 .181(\255o ph)2.681 F(ysical)-.15 E F0 .181(option to the)2.681 F F1 -(set)2.681 E F0 -.2(bu)2.681 G .182(iltin command is).2 F 3.264 -(enabled. If)144 333.6 R(the)3.264 E F13.264 E F0 .763 -(option is used, the pathname printed may contain symbolic links.)3.264 -F .763(The return)5.763 F 1.36(status is 0 unless an error occurs while\ +(set)2.681 E F0 -.2(bu)2.681 G .181(iltin command is).2 F 3.263 +(enabled. If)144 333.6 R(the)3.263 E F13.263 E F0 .763 +(option is used, the pathname printed may contain symbolic links.)3.263 +F .764(The return)5.764 F 1.36(status is 0 unless an error occurs while\ reading the name of the current directory or an in)144 345.6 R -.25(va) -.4 G(lid).25 E(option is supplied.)144 357.6 Q F1 -.18(re)108 374.4 S (ad).18 E F0([)2.5 E F1(\255ers)A F0 2.5(][)C F1-2.5 E F2(fd)2.5 E @@ -6364,130 +6368,130 @@ F2(aname)2.5 E F0 2.5(][)C F1-2.5 E F2(pr)2.5 E(ompt)-.45 E F0 2.5 (][)C F1-2.5 E F2(nc)2.5 E(har)-.15 E(s)-.1 E F0 2.5(][)C F1 -2.5 E F2(delim)2.5 E F0 2.5(][)C F2(name)-2.5 E F0(...])2.5 E .516(One\ line is read from the standard input, or from the \214le descriptor)144 -386.4 R F2(fd)3.016 E F0 .516(supplied as an ar)3.016 F .516(gument to) --.18 F(the)144 398.4 Q F12.538 E F0 .038 -(option, and the \214rst w)2.538 F .038(ord is assigned to the \214rst) --.1 F F2(name)2.539 E F0 2.539(,t).18 G .039(he second w)-2.539 F .039 -(ord to the second)-.1 F F2(name)2.539 E F0(,).18 E .42 +386.4 R F2(fd)3.016 E F0 .516(supplied as an ar)3.016 F .517(gument to) +-.18 F(the)144 398.4 Q F12.539 E F0 .039 +(option, and the \214rst w)2.539 F .038(ord is assigned to the \214rst) +-.1 F F2(name)2.538 E F0 2.538(,t).18 G .038(he second w)-2.538 F .038 +(ord to the second)-.1 F F2(name)2.538 E F0(,).18 E .42 (and so on, with lefto)144 410.4 R -.15(ve)-.15 G 2.92(rw).15 G .42 (ords and their interv)-3.02 F .42 (ening separators assigned to the last)-.15 F F2(name)2.92 E F0 5.42(.I) -.18 G 2.92(ft)-5.42 G(here)-2.92 E .54(are fe)144 422.4 R .54(wer w)-.25 -F .541(ords read from the input stream than names, the remaining names \ -are assigned empty)-.1 F -.25(va)144 434.4 S 2.511(lues. The).25 F .011 -(characters in)2.511 F/F3 9/Times-Bold@0 SF(IFS)2.511 E F0 .011 +.18 G 2.92(ft)-5.42 G(here)-2.92 E .541(are fe)144 422.4 R .541(wer w) +-.25 F .541(ords read from the input stream than names, the remaining n\ +ames are assigned empty)-.1 F -.25(va)144 434.4 S 2.51(lues. The).25 F +.011(characters in)2.511 F/F3 9/Times-Bold@0 SF(IFS)2.511 E F0 .011 (are used to split the line into w)2.261 F 2.511(ords. The)-.1 F .011 -(backslash character \()2.511 F F1(\\)A F0 2.51(\)m)C(ay)-2.51 E 1.89 -(be used to remo)144 446.4 R 2.19 -.15(ve a)-.15 H 2.19 -.15(ny s).15 H -1.891(pecial meaning for the ne).15 F 1.891 +(backslash character \()2.511 F F1(\\)A F0 2.511(\)m)C(ay)-2.511 E 1.891 +(be used to remo)144 446.4 R 2.191 -.15(ve a)-.15 H 2.191 -.15(ny s).15 +H 1.891(pecial meaning for the ne).15 F 1.89 (xt character read and for line continuation.)-.15 F (Options, if supplied, ha)144 458.4 Q .3 -.15(ve t)-.2 H(he follo).15 E -(wing meanings:)-.25 E F1144 470.4 Q F2(aname)2.5 E F0 1.05(The w) -180 482.4 R 1.049 +(wing meanings:)-.25 E F1144 470.4 Q F2(aname)2.5 E F0 1.049 +(The w)180 482.4 R 1.049 (ords are assigned to sequential indices of the array v)-.1 F(ariable) --.25 E F2(aname)3.549 E F0 3.549(,s).18 G 1.049(tarting at 0.)-3.549 F -F2(aname)180.33 494.4 Q F0(is unset before an)2.68 E 2.5(yn)-.15 G .5 --.25(ew va)-2.5 H(lues are assigned.).25 E(Other)5 E F2(name)2.5 E F0 -(ar)2.5 E(guments are ignored.)-.18 E F1144 506.4 Q F2(delim)2.5 E -F0(The \214rst character of)180 518.4 Q F2(delim)2.5 E F0 +-.25 E F2(aname)3.55 E F0 3.55(,s).18 G 1.05(tarting at 0.)-3.55 F F2 +(aname)180.33 494.4 Q F0(is unset before an)2.68 E 2.5(yn)-.15 G .5 -.25 +(ew va)-2.5 H(lues are assigned.).25 E(Other)5 E F2(name)2.5 E F0(ar)2.5 +E(guments are ignored.)-.18 E F1144 506.4 Q F2(delim)2.5 E F0 +(The \214rst character of)180 518.4 Q F2(delim)2.5 E F0 (is used to terminate the input line, rather than ne)2.5 E(wline.)-.25 E -F1144 530.4 Q F0 .372 +F1144 530.4 Q F0 .373 (If the standard input is coming from a terminal,)25.86 F F1 -.18(re) -2.873 G(adline).18 E F0(\(see)2.873 E F3(READLINE)2.873 E F0(abo)2.623 E --.15(ve)-.15 G 2.873(\)i).15 G 2.873(su)-2.873 G(sed)-2.873 E +2.873 G(adline).18 E F0(\(see)2.873 E F3(READLINE)2.872 E F0(abo)2.622 E +-.15(ve)-.15 G 2.872(\)i).15 G 2.872(su)-2.872 G(sed)-2.872 E (to obtain the line.)180 542.4 Q F1144 554.4 Q F2(nc)2.5 E(har) --.15 E(s)-.1 E F1 -.18(re)180 566.4 S(ad).18 E F0 1.395 -(returns after reading)3.895 F F2(nc)3.895 E(har)-.15 E(s)-.1 E F0 1.395 -(characters rather than w)3.895 F 1.394(aiting for a complete line of) +-.15 E(s)-.1 E F1 -.18(re)180 566.4 S(ad).18 E F0 1.394 +(returns after reading)3.894 F F2(nc)3.894 E(har)-.15 E(s)-.1 E F0 1.395 +(characters rather than w)3.894 F 1.395(aiting for a complete line of) -.1 F(input.)180 578.4 Q F1144 590.4 Q F2(pr)2.5 E(ompt)-.45 E F0 -(Display)180 602.4 Q F2(pr)3.66 E(ompt)-.45 E F0 1.161 -(on standard error)3.66 F 3.661(,w)-.4 G 1.161(ithout a trailing ne) +(Display)180 602.4 Q F2(pr)3.661 E(ompt)-.45 E F0 1.161 +(on standard error)3.661 F 3.661(,w)-.4 G 1.161(ithout a trailing ne) -3.661 F 1.161(wline, before attempting to read)-.25 F(an)180 614.4 Q 2.5(yi)-.15 G 2.5(nput. The)-2.5 F (prompt is displayed only if input is coming from a terminal.)2.5 E F1 -144 626.4 Q F0 .544(Backslash does not act as an escape character) -25.86 F 5.543(.T)-.55 G .543(he backslash is considered to be part of) +144 626.4 Q F0 .543(Backslash does not act as an escape character) +25.86 F 5.543(.T)-.55 G .544(he backslash is considered to be part of) -5.543 F(the line.)180 638.4 Q(In particular)5 E 2.5(,ab)-.4 G (ackslash-ne)-2.5 E(wline pair may not be used as a line continuation.) -.25 E F1144 650.4 Q F0(Silent mode.)26.41 E (If input is coming from a terminal, characters are not echoed.)5 E F1 -144 662.4 Q F2(timeout)2.5 E F0(Cause)180 674.4 Q F1 -.18(re)3.548 -G(ad).18 E F0 1.048(to time out and return f)3.548 F 1.048 +144 662.4 Q F2(timeout)2.5 E F0(Cause)180 674.4 Q F1 -.18(re)3.549 +G(ad).18 E F0 1.048(to time out and return f)3.549 F 1.048 (ailure if a complete line of input is not read within)-.1 F F2(timeout) 180 686.4 Q F0 2.92(seconds. This)2.92 F .42(option has no ef)2.92 F .42 (fect if)-.25 F F1 -.18(re)2.92 G(ad).18 E F0 .42 (is not reading input from the terminal)2.92 F(or a pipe.)180 698.4 Q F1 144 710.4 Q F2(fd)2.5 E/F4 10/Palatino-Roman@0 SF(Read input fr) 14.46 E(om \214le descriptor)-.18 E/F5 10/Palatino-Italic@0 SF(fd)2.5 E -F4(.)A .335(If no)144 727.2 R F5(names)3.095 E F4(ar)2.895 E 2.835(es) --.18 G .335(upplied, the line r)-2.835 F .336 +F4(.)A .336(If no)144 727.2 R F5(names)3.096 E F4(ar)2.896 E 2.836(es) +-.18 G .336(upplied, the line r)-2.836 F .336 (ead is assigned to the variable)-.18 F/F6 9/Palatino-Bold@0 SF(REPL) -2.836 E(Y)-.828 E/F7 9/Palatino-Roman@0 SF(.)A F4 .336(The r)4.836 F -.336(eturn code)-.18 F F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42 -(l2).15 G(005 Feb 19)-124.42 E(54)199 E 0 Cg EP +2.835 E(Y)-.828 E/F7 9/Palatino-Roman@0 SF(.)A F4 .335(The r)4.835 F +.335(eturn code)-.18 F F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59 +(l2).15 G(005 Mar 15)-123.59 E(54)198.17 E 0 Cg EP %%Page: 55 56 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) --.35 E/F1 10/Palatino-Roman@0 SF 1.058(is zer)144 84 R 1.058 +-.35 E/F1 10/Palatino-Roman@0 SF 1.057(is zer)144 84 R 1.058 (o, unless end-of-\214le is encounter)-.18 F(ed,)-.18 E/F2 10 /Palatino-Bold@0 SF(read)3.558 E F1 1.058 (times out, or an invalid \214le descriptor is)3.558 F (supplied as the ar)144 96 Q(gument to)-.18 E F22.5 E F1(.)A F2 (readonly)108 112.8 Q F1([)2.5 E F2(\255apf)A F1 2.5(][)C/F3 10 /Palatino-Italic@0 SF(name)-2.5 E F1([=)A F3(word)A F1 2.5(].)C(..])-2.5 -E .587(The given)144 124.8 R F3(names)3.087 E F1(ar)3.087 E 3.087(em) --.18 G .587(arked r)-3.087 F .587(eadonly; the values of these)-.18 F F3 -(names)3.347 E F1 .588(may not be changed by)3.148 F .833 -(subsequent assignment.)144 136.8 R .833(If the)5.833 F F23.333 E -F1 .832(option is supplied, the functions corr)3.333 F .832 -(esponding to the)-.18 F F3(names)144 148.8 Q F1(ar)3.809 E 3.809(es) --.18 G 3.809(om)-3.809 G 3.809(arked. The)-3.809 F F23.809 E F1 -1.309(option r)3.809 F 1.309(estricts the variables to arrays.)-.18 F -1.31(If no)6.31 F F3(name)4.07 E F1(ar)4.16 E(gu-)-.18 E 1.058(ments ar) +E .588(The given)144 124.8 R F3(names)3.088 E F1(ar)3.088 E 3.088(em) +-.18 G .588(arked r)-3.088 F .587(eadonly; the values of these)-.18 F F3 +(names)3.347 E F1 .587(may not be changed by)3.147 F .832 +(subsequent assignment.)144 136.8 R .832(If the)5.832 F F23.332 E +F1 .833(option is supplied, the functions corr)3.332 F .833 +(esponding to the)-.18 F F3(names)144 148.8 Q F1(ar)3.81 E 3.81(es)-.18 +G 3.81(om)-3.81 G 3.81(arked. The)-3.81 F F23.81 E F1 1.309 +(option r)3.809 F 1.309(estricts the variables to arrays.)-.18 F 1.309 +(If no)6.309 F F3(name)4.069 E F1(ar)4.159 E(gu-)-.18 E 1.057(ments ar) 144 160.8 R 3.557(eg)-.18 G 1.057(iven, or if the)-3.557 F F23.557 E F1 1.057(option is supplied, a list of all r)3.557 F 1.057 -(eadonly names is printed.)-.18 F(The)144 172.8 Q F22.577 E F1 +(eadonly names is printed.)-.18 F(The)144 172.8 Q F22.578 E F1 .077(option causes output to be displayed in a format that may be r) -2.577 F .078(eused as input.)-.18 F .078(If a)5.078 F .903 -(variable name is followed by =)144 184.8 R F3(word)A F1 3.403(,t)C .902 -(he value of the variable is set to)-3.403 F F3(word)3.402 E F1 5.902 -(.T)C .902(he r)-5.902 F(eturn)-.18 E .997 +2.578 F .077(eused as input.)-.18 F .077(If a)5.077 F .902 +(variable name is followed by =)144 184.8 R F3(word)A F1 3.402(,t)C .903 +(he value of the variable is set to)-3.402 F F3(word)3.403 E F1 5.903 +(.T)C .903(he r)-5.903 F(eturn)-.18 E .998 (status is 0 unless an invalid option is encounter)144 196.8 R .998 -(ed, one of the)-.18 F F3(names)3.758 E F1 .998(is not a valid shell) -3.558 F(variable name, or)144 208.8 Q F22.5 E F1 +(ed, one of the)-.18 F F3(names)3.757 E F1 .997(is not a valid shell) +3.557 F(variable name, or)144 208.8 Q F22.5 E F1 (is supplied with a)2.5 E F3(name)2.76 E F1(that is not a function.)2.85 E F2(return)108 225.6 Q F1([)2.5 E F3(n)A F1(])A .563 (Causes a function to exit with the r)144 237.6 R .563 (eturn value speci\214ed by)-.18 F F3(n)3.063 E F1 5.563(.I).08 G(f) -5.563 E F3(n)3.323 E F1 .563(is omitted, the r)3.143 F(eturn)-.18 E -.544(status is that of the last command executed in the function body) -144 249.6 R 5.545(.I)-1.11 G 3.045(fu)-5.545 G .545(sed outside a func-) --3.045 F 1.148(tion, but during execution of a script by the)144 261.6 R +.545(status is that of the last command executed in the function body) +144 249.6 R 5.544(.I)-1.11 G 3.044(fu)-5.544 G .544(sed outside a func-) +-3.044 F 1.148(tion, but during execution of a script by the)144 261.6 R F2(.)3.648 E F1(\()6.148 E F2(source)A F1 3.648(\)c)C 1.148 -(ommand, it causes the shell to)-3.648 F .63 -(stop executing that script and r)144 273.6 R .63(eturn either)-.18 F F3 -(n)3.391 E F1 .631(or the exit status of the last command exe-)3.211 F -.541(cuted within the script as the exit status of the script.)144 285.6 -R .54(If used outside a function and not)5.54 F .037 +(ommand, it causes the shell to)-3.648 F .631 +(stop executing that script and r)144 273.6 R .631(eturn either)-.18 F +F3(n)3.391 E F1 .63(or the exit status of the last command exe-)3.211 F +.54(cuted within the script as the exit status of the script.)144 285.6 +R .541(If used outside a function and not)5.541 F .038 (during execution of a script by)144 297.6 R F2(.)2.538 E F1 2.538(,t) -.833 G .038(he r)-2.538 F .038(eturn status is false.)-.18 F .038 +.833 G .038(he r)-2.538 F .038(eturn status is false.)-.18 F .037 (Any command associated with)5.038 F(the)144 309.6 Q F2(RETURN)2.5 E F1 (trap is executed befor)2.5 E 2.5(ee)-.18 G(xecution r)-2.5 E (esumes after the function or script.)-.18 E F2(set)108 326.4 Q F1([)2.5 E F2(\255\255abefhkmnptuvxBCHP)A F1 2.5(][)C F2-2.5 E F3(option) 2.5 E F1 2.5(][)C F3(ar)-2.5 E(g)-.18 E F1(...])2.5 E -.55(Wi)144 338.4 -S .246(thout options, the name and value of each shell variable ar).55 F -2.745(ed)-.18 G .245(isplayed in a format that)-2.745 F .233(can be r) +S .245(thout options, the name and value of each shell variable ar).55 F +2.746(ed)-.18 G .246(isplayed in a format that)-2.746 F .234(can be r) 144 350.4 R .233(eused as input for setting or r)-.18 F .233 -(esetting the curr)-.18 F .233(ently-set variables.)-.18 F .234 +(esetting the curr)-.18 F .233(ently-set variables.)-.18 F .233 (Read-only vari-)5.233 F .748(ables cannot be r)144 362.4 R 3.248 (eset. In)-.18 F F3 .748(posix mode)3.248 F F1 3.248(,o)C .748 (nly shell variables ar)-3.248 F 3.248(el)-.18 G 3.248(isted. The)-3.248 -F .748(output is sorted)3.248 F(accor)144 374.4 Q 2.607 -(ding to the curr)-.18 F 2.607(ent locale.)-.18 F 2.608(When options ar) -7.608 F 5.108(es)-.18 G 2.608(peci\214ed, they set or unset shell)-5.108 +F .748(output is sorted)3.248 F(accor)144 374.4 Q 2.608 +(ding to the curr)-.18 F 2.608(ent locale.)-.18 F 2.608(When options ar) +7.608 F 5.108(es)-.18 G 2.607(peci\214ed, they set or unset shell)-5.108 F 3.455(attributes. Any)144 386.4 R(ar)3.455 E .955(guments r)-.18 F .955(emaining after the options ar)-.18 F 3.455(ep)-.18 G -.18(ro)-3.455 G .955(cessed ar).18 F 3.455(et)-.18 G -.18(re)-3.455 G .955 @@ -6503,33 +6507,33 @@ F2144 446.4 Q F1 .096(Report the status of terminated backgr)27.83 F .096(ound jobs immediately)-.18 F 2.596(,r)-1.11 G .096 (ather than befor)-2.596 F(e)-.18 E(the next primary pr)184 458.4 Q 2.5 (ompt. This)-.18 F(is ef)2.5 E(fective only when job contr)-.18 E -(ol is enabled.)-.18 E F2144 470.4 Q F1 .179 -(Exit immediately if a)28.94 F F3 .178(simple command)2.679 F F1(\(see) -2.678 E/F4 9/Palatino-Bold@0 SF .178(SHELL GRAMMAR)2.678 F F1 .178 -(above\) exits with a)2.428 F(non-zer)184 482.4 Q 3.232(os)-.18 G 3.232 -(tatus. The)-3.232 F .733 -(shell does not exit if the command that fails is part of the)3.232 F -.696(command list immediately following a)184 494.4 R F2(while)3.196 E +(ol is enabled.)-.18 E F2144 470.4 Q F1 .178 +(Exit immediately if a)28.94 F F3 .178(simple command)2.678 F F1(\(see) +2.678 E/F4 9/Palatino-Bold@0 SF .178(SHELL GRAMMAR)2.678 F F1 .179 +(above\) exits with a)2.429 F(non-zer)184 482.4 Q 3.233(os)-.18 G 3.233 +(tatus. The)-3.233 F .733 +(shell does not exit if the command that fails is part of the)3.233 F +.695(command list immediately following a)184 494.4 R F2(while)3.196 E F1(or)3.196 E F2(until)3.196 E F1(keywor)3.196 E .696 -(d, part of the test)-.18 F .98(in an)184 506.4 R F3(if)3.64 E F1 .98 -(statement, part of a)5.33 F F2(&&)3.48 E F1(or)3.481 E/F5 10/Symbol SF -3.481 E F1 .981(list, or if the command's r)3.481 F .981 +(d, part of the test)-.18 F .981(in an)184 506.4 R F3(if)3.641 E F1 .981 +(statement, part of a)5.331 F F2(&&)3.481 E F1(or)3.481 E/F5 10/Symbol +SF3.481 E F1 .98(list, or if the command's r)3.481 F .98 (eturn value is)-.18 F(being inverted via)184 518.4 Q F2(!)2.5 E F1 5 (.A)C(trap on)-2.5 E F2(ERR)2.5 E F1 2.5(,i)C 2.5(fs)-2.5 G (et, is executed befor)-2.5 E 2.5(et)-.18 G(he shell exits.)-2.5 E F2 144 530.4 Q F1(Disable pathname expansion.)30.05 E F2144 -542.4 Q F1 .592(Remember the location of commands as they ar)27.83 F -3.092(el)-.18 G .591(ooked up for execution.)-3.092 F(This)5.591 E -(is enabled by default.)184 554.4 Q F2144 566.4 Q F1 .934(All ar) +542.4 Q F1 .591(Remember the location of commands as they ar)27.83 F +3.092(el)-.18 G .592(ooked up for execution.)-3.092 F(This)5.592 E +(is enabled by default.)184 554.4 Q F2144 566.4 Q F1 .935(All ar) 27.83 F .934(guments in the form of assignment statements ar)-.18 F -3.434(ep)-.18 G .935(laced in the envir)-3.434 F(on-)-.18 E +3.434(ep)-.18 G .934(laced in the envir)-3.434 F(on-)-.18 E (ment for a command, not just those that pr)184 578.4 Q -(ecede the command name.)-.18 E F2144 590.4 Q F1 .711 -(Monitor mode.)25.05 F .711(Job contr)5.711 F .711(ol is enabled.)-.18 F -.711(This option is on by default for interac-)5.711 F 1.164 -(tive shells on systems that support it \(see)184 602.4 R F4 1.165 -(JOB CONTROL)3.665 F F1 3.665(above\). Backgr)3.415 F(ound)-.18 E(pr)184 -614.4 Q .54(ocesses r)-.18 F .54(un in a separate pr)-.08 F .539 +(ecede the command name.)-.18 E F2144 590.4 Q F1 .71 +(Monitor mode.)25.05 F .71(Job contr)5.71 F .711(ol is enabled.)-.18 F +.711(This option is on by default for interac-)5.711 F 1.165 +(tive shells on systems that support it \(see)184 602.4 R F4 1.164 +(JOB CONTROL)3.664 F F1 3.664(above\). Backgr)3.414 F(ound)-.18 E(pr)184 +614.4 Q .539(ocesses r)-.18 F .539(un in a separate pr)-.08 F .539 (ocess gr)-.18 F .539(oup and a line containing their exit status)-.18 F (is printed upon their completion.)184 626.4 Q F2144 638.4 Q F1 1.313(Read commands but do not execute them.)27.83 F 1.313 @@ -6538,8 +6542,8 @@ F1(or)3.196 E F2(until)3.196 E F1(keywor)3.196 E .696 -.18 E F2144 662.4 Q F3(option\255name)2.5 E F1(The)184 674.4 Q F3 (option\255name)2.5 E F1(can be one of the following:)2.5 E F2 (allexport)184 686.4 Q F1(Same as)224 698.4 Q F22.5 E F1(.)A F0 -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(55)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(55)198.17 E 0 Cg EP %%Page: 56 57 %%BeginPageSetup BP @@ -6555,13 +6559,13 @@ ive, unless the shell is started with the)224 120 R F1 224 168 Q F12.5 E F2(.)A F1(errexit)184 180 Q F2(Same as)10.56 E F12.5 E F2(.)A F1(hashall)184 192 Q F2(Same as)6.68 E F12.5 E F2(.)A F1(histexpand)184 204 Q F2(Same as)224 216 Q F12.5 E F2 -(.)A F1(history)184 228 Q F2 2.271(Enable command history)7.78 F 4.771 +(.)A F1(history)184 228 Q F2 2.27(Enable command history)7.78 F 4.771 (,a)-1.11 G 4.771(sd)-4.771 G 2.271(escribed above under)-4.771 F/F3 9 /Palatino-Bold@0 SF(HISTOR)4.771 E(Y)-.495 E/F4 9/Palatino-Roman@0 SF(.) -A F2(This)6.77 E(option is on by default in interactive shells.)224 240 -Q F1(ignoreeof)184 252 Q F2 1.673(The ef)224 264 R 1.673 +A F2(This)6.771 E(option is on by default in interactive shells.)224 240 +Q F1(ignoreeof)184 252 Q F2 1.674(The ef)224 264 R 1.674 (fect is as if the shell command)-.18 F/F5 10/Courier@0 SF(IGNOREEOF=10) -4.174 E F2 1.674(had been exe-)4.174 F(cuted \(see)224 276 Q F1(Shell V) +4.173 E F2 1.673(had been exe-)4.173 F(cuted \(see)224 276 Q F1(Shell V) 2.5 E(ariables)-1.11 E F2(above\).)2.5 E F1(keyword)184 288 Q F2 (Same as)224 300 Q F12.5 E F2(.)A F1(monitor)184 312 Q F2(Same as) 224 324 Q F12.5 E F2(.)A F1(noclobber)184 336 Q F2(Same as)224 348 @@ -6571,11 +6575,11 @@ E F2(.)A F1(noglob)184 372 Q F2(Same as)7.77 E F12.5 E F2(.)A F1 Q F2(Same as)12.22 E F12.5 E F2(.)A F1(nounset)184 396 Q F2 (Same as)224 408 Q F12.5 E F2(.)A F1(onecmd)184 420 Q F2(Same as) 224 432 Q F12.5 E F2(.)A F1(physical)184 444 Q F2(Same as)224 456 -Q F12.5 E F2(.)A F1(pipefail)184 468 Q F2 .735(If set, the r)224 +Q F12.5 E F2(.)A F1(pipefail)184 468 Q F2 .734(If set, the r)224 480 R .734 (eturn value of a pipeline is the value of the last \(rightmost\))-.18 F -.31(command to exit with a non-zer)224 492 R 2.811(os)-.18 G .311 -(tatus, or zer)-2.811 F 2.811(oi)-.18 G 2.811(fa)-2.811 G .311 +.311(command to exit with a non-zer)224 492 R 2.811(os)-.18 G .311 +(tatus, or zer)-2.811 F 2.811(oi)-.18 G 2.811(fa)-2.811 G .31 (ll commands in the)-2.811 F(pipeline exit successfully)224 504 Q 5(.T) -1.11 G(his option is disabled by default.)-5 E F1(posix)184 516 Q F2 .815(Change the behavior of)15.56 F F1(bash)3.315 E F2(wher)3.315 E @@ -6586,35 +6590,35 @@ G(atch the standar)-2.5 E 2.5(d\()-.18 G/F6 10/Palatino-Italic@0 SF F12.5 E F2(.)A F1(verbose)184 564 Q F2(Same as)224 576 Q F1 2.5 E F2(.)A F1(vi)184 588 Q F2 (Use a vi-style command line editing interface.)31.11 E F1(xtrace)184 -600 Q F2(Same as)13.34 E F12.5 E F2(.)A(If)184 618 Q F14.63 -E F2 2.131(is supplied with no)4.63 F F6(option\255name)4.631 E F2 4.631 -(,t)C 2.131(he values of the curr)-4.631 F 2.131(ent options ar)-.18 F -(e)-.18 E 4.412(printed. If)184 630 R F1(+o)4.412 E F2 1.912 -(is supplied with no)4.412 F F6(option\255name)4.412 E F2 4.411(,as)C -1.911(eries of)-4.411 F F1(set)4.411 E F2 1.911(commands to)4.411 F -.18 +600 Q F2(Same as)13.34 E F12.5 E F2(.)A(If)184 618 Q F14.631 +E F2 2.131(is supplied with no)4.631 F F6(option\255name)4.631 E F2 +4.631(,t)C 2.131(he values of the curr)-4.631 F 2.13(ent options ar)-.18 +F(e)-.18 E 4.411(printed. If)184 630 R F1(+o)4.411 E F2 1.911 +(is supplied with no)4.411 F F6(option\255name)4.412 E F2 4.412(,as)C +1.912(eries of)-4.412 F F1(set)4.412 E F2 1.912(commands to)4.412 F -.18 (re)184 642 S(cr).18 E(eate the curr)-.18 E (ent option settings is displayed on the standar)-.18 E 2.5(do)-.18 G -(utput.)-2.5 E F1144 654 Q F2 -.9(Tu)27.83 G .853(rn on).9 F F6 -(privileged)3.923 E F2 3.353(mode. In)3.683 F .853(this mode, the)3.353 -F F3($ENV)3.353 E F2(and)3.103 E F3($BASH_ENV)3.354 E F2 .854 -(\214les ar)3.104 F 3.354(en)-.18 G(ot)-3.354 E(pr)184 666 Q 2.873 +(utput.)-2.5 E F1144 654 Q F2 -.9(Tu)27.83 G .854(rn on).9 F F6 +(privileged)3.924 E F2 3.354(mode. In)3.684 F .853(this mode, the)3.353 +F F3($ENV)3.353 E F2(and)3.103 E F3($BASH_ENV)3.353 E F2 .853 +(\214les ar)3.103 F 3.353(en)-.18 G(ot)-3.353 E(pr)184 666 Q 2.873 (ocessed, shell functions ar)-.18 F 5.373(en)-.18 G 2.873 (ot inherited fr)-5.373 F 2.873(om the envir)-.18 F 2.873 -(onment, and the)-.18 F F3(SHELLOPTS)184 678 Q F2 .548 -(variable, if it appears in the envir)2.798 F .548(onment, is ignor)-.18 -F 3.049(ed. If)-.18 F .549(the shell is)3.049 F 1.115 +(onment, and the)-.18 F F3(SHELLOPTS)184 678 Q F2 .549 +(variable, if it appears in the envir)2.799 F .548(onment, is ignor)-.18 +F 3.048(ed. If)-.18 F .548(the shell is)3.048 F 1.115 (started with the ef)184 690 R 1.115(fective user \(gr)-.18 F 1.115 (oup\) id not equal to the r)-.18 F 1.115(eal user \(gr)-.18 F 1.115 -(oup\) id,)-.18 F .497(and the)184 702 R F12.997 E F2 .498 +(oup\) id,)-.18 F .498(and the)184 702 R F12.998 E F2 .498 (option is not supplied, these actions ar)2.998 F 2.998(et)-.18 G .498 -(aken and the ef)-2.998 F .498(fective user)-.18 F .685 +(aken and the ef)-2.998 F .497(fective user)-.18 F .684 (id is set to the r)184 714 R .685(eal user id.)-.18 F .685(If the)5.685 -F F13.185 E F2 .684(option is supplied at startup, the ef)3.185 F -(fective)-.18 E .752(user id is not r)184 726 R 3.252(eset. T)-.18 F +F F13.185 E F2 .685(option is supplied at startup, the ef)3.185 F +(fective)-.18 E .753(user id is not r)184 726 R 3.252(eset. T)-.18 F .752(urning this option of)-.9 F 3.252(fc)-.18 G .752(auses the ef) --3.252 F .753(fective user and gr)-.18 F(oup)-.18 E F0(GNU Bash-3.1-de) -72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(56)199 E 0 -Cg EP +-3.252 F .752(fective user and gr)-.18 F(oup)-.18 E F0(GNU Bash-3.1-de) +72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(56)198.17 E +0 Cg EP %%Page: 57 58 %%BeginPageSetup BP @@ -6627,82 +6631,82 @@ E F2144 108 Q F1 -.88 -.9(Tr e)27.83 H 2.498 (at unset variables as an err).9 F 2.498 (or when performing parameter expansion.)-.18 F(If)7.498 E .869 (expansion is attempted on an unset variable, the shell prints an err) -184 120 R .87(or message,)-.18 F +184 120 R .869(or message,)-.18 F (and, if not interactive, exits with a non-zer)184 132 Q 2.5(os)-.18 G (tatus.)-2.5 E F2144 144 Q F1(Print shell input lines as they ar) -28.38 E 2.5(er)-.18 G(ead.)-2.68 E F2144 156 Q F1 2.637 +28.38 E 2.5(er)-.18 G(ead.)-2.68 E F2144 156 Q F1 2.636 (After expanding each)28.94 F/F3 10/Palatino-Italic@0 SF 2.637 -(simple command)5.137 F F1(,)A F2(for)5.137 E F1(command,)5.137 E F2 -(case)5.136 E F1(command,)5.136 E F2(select)5.136 E F1 .954 -(command, or arithmetic)184 168 R F2(for)3.454 E F1 .955 +(simple command)5.136 F F1(,)A F2(for)5.137 E F1(command,)5.137 E F2 +(case)5.137 E F1(command,)5.137 E F2(select)5.137 E F1 .955 +(command, or arithmetic)184 168 R F2(for)3.455 E F1 .955 (command, display the expanded value of)3.455 F/F4 9/Palatino-Bold@0 SF -(PS4)3.455 E/F5 9/Palatino-Roman@0 SF(,)A F1(fol-)3.205 E +(PS4)3.454 E/F5 9/Palatino-Roman@0 SF(,)A F1(fol-)3.204 E (lowed by the command and its expanded ar)184 180 Q (guments or associated wor)-.18 E 2.5(dl)-.18 G(ist.)-2.5 E F2144 192 Q F1 .484(The shell performs brace expansion \(see)27.27 F F2 .484 -(Brace Expansion)2.984 F F1 2.984(above\). This)2.984 F .484(is on by) -2.984 F(default.)184 204 Q F2144 216 Q F1 .077(If set,)26.72 F F2 -(bash)2.577 E F1 .077(does not overwrite an existing \214le with the) -2.577 F F2(>)2.578 E F1(,)A F2(>&)2.578 E F1 2.578(,a)C(nd)-2.578 E F2 -(<>)2.578 E F1 -.18(re)2.578 G(dir).18 E(ection)-.18 E 2.645 +(Brace Expansion)2.984 F F1 2.984(above\). This)2.984 F .485(is on by) +2.984 F(default.)184 204 Q F2144 216 Q F1 .078(If set,)26.72 F F2 +(bash)2.578 E F1 .077(does not overwrite an existing \214le with the) +2.578 F F2(>)2.577 E F1(,)A F2(>&)2.577 E F1 2.577(,a)C(nd)-2.577 E F2 +(<>)2.577 E F1 -.18(re)2.577 G(dir).18 E(ection)-.18 E 2.645 (operators. This)184 228 R .145(may be overridden when cr)2.645 F .145 (eating output \214les by using the r)-.18 F(edi-)-.18 E -.18(re)184 240 S(ction operator).18 E F2(>|)2.5 E F1(instead of)2.5 E F2(>)2.5 E F1(.)A -F2144 252 Q F1 .901(If set, any trap on)27.83 F F2(ERR)3.402 E F1 -.902(is inherited by shell functions, command substitutions,)3.402 F .75 +F2144 252 Q F1 .902(If set, any trap on)27.83 F F2(ERR)3.402 E F1 +.901(is inherited by shell functions, command substitutions,)3.402 F .75 (and commands executed in a subshell envir)184 264 R 3.25(onment. The) -.18 F F2(ERR)3.25 E F1 .75(trap is normally)3.25 F (not inherited in such cases.)184 276 Q F2144 288 Q F1(Enable) -25.61 E F2(!)2.515 E F1 .015(style history substitution.)5.015 F .016 +25.61 E F2(!)2.516 E F1 .016(style history substitution.)5.016 F .016 (This option is on by default when the shell is)5.016 F(interactive.)184 -300 Q F2144 312 Q F1 .693(If set, the shell does not follow symbo\ -lic links when executing commands such)27.83 F(as)184 324 Q F2(cd)3.569 -E F1 1.069(that change the curr)3.569 F 1.069(ent working dir)-.18 F -(ectory)-.18 E 6.069(.I)-1.11 G 3.569(tu)-6.069 G 1.07 +300 Q F2144 312 Q F1 .692(If set, the shell does not follow symbo\ +lic links when executing commands such)27.83 F(as)184 324 Q F2(cd)3.57 E +F1 1.069(that change the curr)3.57 F 1.069(ent working dir)-.18 F +(ectory)-.18 E 6.069(.I)-1.11 G 3.569(tu)-6.069 G 1.069 (ses the physical dir)-3.569 F(ectory)-.18 E(str)184 336 Q(uctur)-.08 E -2.912(ei)-.18 G 2.912(nstead. By)-2.912 F(default,)2.912 E F2(bash)2.912 -E F1 .412(follows the logical chain of dir)2.912 F .411(ectories when) +2.911(ei)-.18 G 2.911(nstead. By)-2.911 F(default,)2.912 E F2(bash)2.912 +E F1 .412(follows the logical chain of dir)2.912 F .412(ectories when) -.18 F(performing commands which change the curr)184 348 Q(ent dir)-.18 E(ectory)-.18 E(.)-1.11 E F2144 360 Q F1 .22(If set, any traps on) 27.27 F F2(DEBUG)2.72 E F1(and)2.72 E F2(RETURN)2.72 E F1(ar)2.72 E 2.72 (ei)-.18 G .22(nherited by shell functions, com-)-2.72 F 1.573 (mand substitutions, and commands executed in a subshell envir)184 372 R -4.073(onment. The)-.18 F F2(DEBUG)184 384 Q F1(and)2.5 E F2(RETURN)2.5 E +4.074(onment. The)-.18 F F2(DEBUG)184 384 Q F1(and)2.5 E F2(RETURN)2.5 E F1(traps ar)2.5 E 2.5(en)-.18 G(ormally not inherited in such cases.) --2.5 E F2144 396 Q F1 1.781(If no ar)27.88 F 1.782 +-2.5 E F2144 396 Q F1 1.782(If no ar)27.88 F 1.782 (guments follow this option, then the positional parameters ar)-.18 F -4.282(eu)-.18 G(nset.)-4.282 E 1.303 +4.281(eu)-.18 G(nset.)-4.281 E 1.303 (Otherwise, the positional parameters ar)184 408 R 3.803(es)-.18 G 1.303 (et to the)-3.803 F F3(ar)3.803 E(g)-.18 E F1 1.303 (s, even if some of them)B(begin with a)184 420 Q F22.5 E F1(.)A F2 -144 432 Q F1 1.295(Signal the end of options, cause all r)33.94 F +144 432 Q F1 1.296(Signal the end of options, cause all r)33.94 F (emaining)-.18 E F3(ar)3.796 E(g)-.18 E F1 3.796(st)C 3.796(ob)-3.796 G -3.796(ea)-3.796 G 1.296(ssigned to the posi-)-3.796 F .042 -(tional parameters.)184 444 R(The)5.042 E F22.542 E F1(and)2.542 E -F22.542 E F1 .041(options ar)2.541 F 2.541(et)-.18 G .041 -(urned of)-2.541 F 2.541(f. If)-.18 F(ther)2.541 E 2.541(ea)-.18 G .401 --.18(re n)-2.541 H(o).18 E F3(ar)2.541 E(g)-.18 E F1 .041(s, the)B -(positional parameters r)184 456 Q(emain unchanged.)-.18 E .12 -(The options ar)144 472.8 R 2.62(eo)-.18 G .48 -.18(ff b)-2.62 H 2.62 -(yd).18 G .121(efault unless otherwise noted.)-2.62 F .121 -(Using + rather than \255 causes these)5.121 F .278 -(options to be turned of)144 484.8 R 2.778(f. The)-.18 F .277 -(options can also be speci\214ed as ar)2.777 F .277 -(guments to an invocation)-.18 F .722(of the shell.)144 496.8 R .723 +3.795(ea)-3.796 G 1.295(ssigned to the posi-)-3.795 F .041 +(tional parameters.)184 444 R(The)5.041 E F22.541 E F1(and)2.541 E +F22.541 E F1 .041(options ar)2.541 F 2.541(et)-.18 G .041 +(urned of)-2.541 F 2.541(f. If)-.18 F(ther)2.542 E 2.542(ea)-.18 G .402 +-.18(re n)-2.542 H(o).18 E F3(ar)2.542 E(g)-.18 E F1 .042(s, the)B +(positional parameters r)184 456 Q(emain unchanged.)-.18 E .121 +(The options ar)144 472.8 R 2.621(eo)-.18 G .481 -.18(ff b)-2.621 H +2.621(yd).18 G .121(efault unless otherwise noted.)-2.621 F .12 +(Using + rather than \255 causes these)5.121 F .277 +(options to be turned of)144 484.8 R 2.777(f. The)-.18 F .277 +(options can also be speci\214ed as ar)2.777 F .278 +(guments to an invocation)-.18 F .723(of the shell.)144 496.8 R .723 (The curr)5.723 F .723(ent set of options may be found in)-.18 F F2 <24ad>3.223 E F1 5.723(.T)C .723(he r)-5.723 F .723 (eturn status is always)-.18 F(tr)144 508.8 Q (ue unless an invalid option is encounter)-.08 E(ed.)-.18 E F2(shift)108 -525.6 Q F1([)2.5 E F3(n)A F1(])A .807(The positional parameters fr)144 +525.6 Q F1([)2.5 E F3(n)A F1(])A .806(The positional parameters fr)144 537.6 R(om)-.18 E F3(n)3.306 E F1 .806(+1 ... ar)B 3.306(er)-.18 G .806 -(enamed to)-3.486 F F2 .806($1 ....)3.306 F F1 .806(Parameters r)5.806 F -(epr)-.18 E .806(esented by)-.18 F .055(the numbers)144 549.6 R F2($#) +(enamed to)-3.486 F F2 .806($1 ....)3.306 F F1 .807(Parameters r)5.806 F +(epr)-.18 E .807(esented by)-.18 F .055(the numbers)144 549.6 R F2($#) 2.555 E F1 .055(down to)2.555 F F2($#)2.555 E F1A F3(n)A F1 .055 (+1 ar)B 2.555(eu)-.18 G(nset.)-2.555 E F3(n)5.315 E F1 .055 -(must be a non-negative number less than or)2.635 F .495(equal to)144 -561.6 R F2($#)2.995 E F1 5.495(.I)C(f)-5.495 E F3(n)3.255 E F1 .494 -(is 0, no parameters ar)3.075 F 2.994(ec)-.18 G 2.994(hanged. If)-2.994 -F F3(n)3.254 E F1 .494(is not given, it is assumed to be 1.)3.074 F(If) +(must be a non-negative number less than or)2.635 F .494(equal to)144 +561.6 R F2($#)2.994 E F1 5.494(.I)C(f)-5.494 E F3(n)3.254 E F1 .494 +(is 0, no parameters ar)3.074 F 2.994(ec)-.18 G 2.994(hanged. If)-2.994 +F F3(n)3.254 E F1 .495(is not given, it is assumed to be 1.)3.074 F(If) 144 573.6 Q F3(n)4.052 E F1 1.292(is gr)3.872 F 1.292(eater than)-.18 F F2($#)3.792 E F1 3.792(,t)C 1.292(he positional parameters ar)-3.792 F 3.792(en)-.18 G 1.292(ot changed.)-3.792 F 1.292(The r)6.292 F 1.292 @@ -6710,12 +6714,12 @@ F2($#)3.792 E F1 3.792(,t)C 1.292(he positional parameters ar)-3.792 F G(f)-2.5 E F3(n)2.76 E F1(is gr)2.58 E(eater than)-.18 E F2($#)2.5 E F1 (or less than zer)2.5 E(o; otherwise 0.)-.18 E F2(shopt)108 602.4 Q F1 ([)2.5 E F2(\255pqsu)A F1 2.5(][)C F2-2.5 E F1 2.5(][)C F3 -(optname)-2.5 E F1(...])2.5 E -.92(To)144 614.4 S 1.523 -(ggle the values of variables contr).92 F 1.522 -(olling optional shell behavior)-.18 F 6.522(.W)-.74 G 1.522 -(ith no options, or)-7.072 F 2.531(with the)144 626.4 R F25.031 E +(optname)-2.5 E F1(...])2.5 E -.92(To)144 614.4 S 1.522 +(ggle the values of variables contr).92 F 1.523 +(olling optional shell behavior)-.18 F 6.523(.W)-.74 G 1.523 +(ith no options, or)-7.073 F 2.532(with the)144 626.4 R F25.032 E F1 2.531(option, a list of all settable options is displayed, with an i\ -ndication of)5.031 F .962(whether or not each is set.)144 638.4 R(The) +ndication of)5.032 F .961(whether or not each is set.)144 638.4 R(The) 5.962 E F23.462 E F1 .962 (option causes output to be displayed in a form that)3.462 F(may be r) 144 650.4 Q(eused as input.)-.18 E @@ -6724,13 +6728,13 @@ ndication of)5.031 F .962(whether or not each is set.)144 638.4 R(The) F1(Disable \(unset\) each)23.83 E F3(optname)2.5 E F1(.)A F2144 686.4 Q F1(Suppr)23.83 E .903(esses normal output \(quiet mode\); the r) -.18 F .903(eturn status indicates whether the)-.18 F F3(optname)180 -698.4 Q F1 1.679(is set or unset.)4.179 F 1.679(If multiple)6.679 F F3 -(optname)4.178 E F1(ar)4.178 E 1.678(guments ar)-.18 F 4.178(eg)-.18 G -1.678(iven with)-4.178 F F24.178 E F1 4.178(,t)C(he)-4.178 E -.18 +698.4 Q F1 1.678(is set or unset.)4.178 F 1.678(If multiple)6.678 F F3 +(optname)4.178 E F1(ar)4.179 E 1.679(guments ar)-.18 F 4.179(eg)-.18 G +1.679(iven with)-4.179 F F24.179 E F1 4.179(,t)C(he)-4.179 E -.18 (re)180 710.4 S(turn status is zer).18 E 2.5(oi)-.18 G 2.5(fa)-2.5 G(ll) -2.5 E F3(optnames)2.5 E F1(ar)2.5 E 2.5(ee)-.18 G(nabled; non-zer)-2.5 E 2.5(oo)-.18 G(therwise.)-2.5 E F0(GNU Bash-3.1-de)72 768 Q -.15(ve) --.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(57)199 E 0 Cg EP +-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(57)198.17 E 0 Cg EP %%Page: 58 59 %%BeginPageSetup BP @@ -6742,51 +6746,51 @@ BP 3.848 E F2 1.348(option to the)3.848 F F1(set)3.848 E F2(builtin.)180 96 Q 1.86(If either)144 112.8 R F14.36 E F2(or)4.36 E F14.36 E F2 1.86(is used with no)4.36 F F3(optname)4.36 E F2(ar)4.36 E 1.86 -(guments, the display is limited to those)-.18 F 1.061(options which ar) -144 124.8 R 3.561(es)-.18 G 1.062(et or unset, r)-3.561 F(espectively) --.18 E 6.062(.U)-1.11 G 1.062(nless otherwise noted, the)-6.062 F F1 -(shopt)3.562 E F2(options)3.562 E(ar)144 136.8 Q 2.5(ed)-.18 G -(isabled \(unset\) by default.)-2.5 E .473(The r)144 153.6 R .473 +(guments, the display is limited to those)-.18 F 1.062(options which ar) +144 124.8 R 3.562(es)-.18 G 1.062(et or unset, r)-3.562 F(espectively) +-.18 E 6.062(.U)-1.11 G 1.061(nless otherwise noted, the)-6.062 F F1 +(shopt)3.561 E F2(options)3.561 E(ar)144 136.8 Q 2.5(ed)-.18 G +(isabled \(unset\) by default.)-2.5 E .472(The r)144 153.6 R .473 (eturn status when listing options is zer)-.18 F 2.973(oi)-.18 G 2.973 (fa)-2.973 G(ll)-2.973 E F3(optnames)2.973 E F2(ar)2.973 E 2.973(ee)-.18 -G .472(nabled, non-zer)-2.973 F 2.972(oo)-.18 G(ther)-2.972 E(-)-.18 E -2.601(wise. When)144 165.6 R .101(setting or unsetting options, the r) -2.601 F .101(eturn status is zer)-.18 F 2.602(ou)-.18 G .102(nless an) --2.602 F F3(optname)2.602 E F2 .102(is not)2.602 F 2.5(av)144 177.6 S +G .473(nabled, non-zer)-2.973 F 2.973(oo)-.18 G(ther)-2.973 E(-)-.18 E +2.602(wise. When)144 165.6 R .102(setting or unsetting options, the r) +2.602 F .101(eturn status is zer)-.18 F 2.601(ou)-.18 G .101(nless an) +-2.601 F F3(optname)2.601 E F2 .101(is not)2.601 F 2.5(av)144 177.6 S (alid shell option.)-2.5 E(The list of)144 194.4 Q F1(shopt)2.5 E F2 (options is:)2.5 E F1(cdable_vars)144 212.4 Q F2 .364(If set, an ar)184 224.4 R .364(gument to the)-.18 F F1(cd)2.864 E F2 .364 (builtin command that is not a dir)2.864 F .364(ectory is assumed)-.18 F (to be the name of a variable whose value is the dir)184 236.4 Q -(ectory to change to.)-.18 E F1(cdspell)144 248.4 Q F2 1.137 +(ectory to change to.)-.18 E F1(cdspell)144 248.4 Q F2 1.138 (If set, minor err)7.24 F 1.138(ors in the spelling of a dir)-.18 F -1.138(ectory component in a)-.18 F F1(cd)3.638 E F2(command)3.638 E -1.289(will be corr)184 260.4 R 3.788(ected. The)-.18 F(err)3.788 E 1.288 -(ors checked for ar)-.18 F 3.788(et)-.18 G 1.288 -(ransposed characters, a missing)-3.788 F(character)184 272.4 Q 2.74(,a) --.74 G .24(nd one character too many)-2.74 F 5.241(.I)-1.11 G 2.741(fac) --5.241 G(orr)-2.741 E .241(ection is found, the corr)-.18 F .241 -(ected \214le)-.18 F .431(name is printed, and the command pr)184 284.4 -R 2.931(oceeds. This)-.18 F .43(option is only used by inter)2.931 F(-) --.18 E(active shells.)184 296.4 Q F1(checkhash)144 308.4 Q F2 .762 -(If set,)184 320.4 R F1(bash)3.262 E F2 .763 +1.138(ectory component in a)-.18 F F1(cd)3.637 E F2(command)3.637 E +1.288(will be corr)184 260.4 R 3.788(ected. The)-.18 F(err)3.788 E 1.288 +(ors checked for ar)-.18 F 3.788(et)-.18 G 1.289 +(ransposed characters, a missing)-3.788 F(character)184 272.4 Q 2.741 +(,a)-.74 G .241(nd one character too many)-2.741 F 5.241(.I)-1.11 G +2.741(fac)-5.241 G(orr)-2.741 E .241(ection is found, the corr)-.18 F +.24(ected \214le)-.18 F .43(name is printed, and the command pr)184 +284.4 R 2.931(oceeds. This)-.18 F .431(option is only used by inter) +2.931 F(-)-.18 E(active shells.)184 296.4 Q F1(checkhash)144 308.4 Q F2 +.763(If set,)184 320.4 R F1(bash)3.263 E F2 .763 (checks that a command found in the hash table exists befor)3.263 F -3.263(et)-.18 G(rying)-3.263 E .023(to execute it.)184 332.4 R .023 -(If a hashed command no longer exists, a normal path sear)5.023 F .022 +3.262(et)-.18 G(rying)-3.262 E .022(to execute it.)184 332.4 R .023 +(If a hashed command no longer exists, a normal path sear)5.022 F .023 (ch is per)-.18 F(-)-.18 E(formed.)184 344.4 Q F1(checkwinsize)144 356.4 -Q F2 2.584(If set,)184 368.4 R F1(bash)5.084 E F2 2.584 +Q F2 2.585(If set,)184 368.4 R F1(bash)5.085 E F2 2.584 (checks the window size after each command and, if necessary)5.084 F(,) -1.11 E(updates the values of)184 380.4 Q/F4 9/Palatino-Bold@0 SF(LINES) 2.5 E F2(and)2.25 E F4(COLUMNS)2.5 E/F5 9/Palatino-Roman@0 SF(.)A F1 -(cmdhist)144 392.4 Q F2 1.298(If set,)184 404.4 R F1(bash)3.798 E F2 +(cmdhist)144 392.4 Q F2 1.297(If set,)184 404.4 R F1(bash)3.797 E F2 1.297(attempts to save all lines of a multiple-line command in the same) 3.797 F(history entry)184 416.4 Q 5(.T)-1.11 G(his allows easy r)-5 E (e-editing of multi-line commands.)-.18 E F1(dotglob)144 428.4 Q F2 -1.338(If set,)184 440.4 R F1(bash)3.838 E F2 1.338 -(includes \214lenames beginning with a `.' in the r)3.838 F 1.339 +1.339(If set,)184 440.4 R F1(bash)3.839 E F2 1.338 +(includes \214lenames beginning with a `.' in the r)3.839 F 1.338 (esults of pathname)-.18 F(expansion.)184 452.4 Q F1(execfail)144 464.4 Q F2 .315(If set, a non-interactive shell will not exit if it cannot ex\ -ecute the \214le speci\214ed as)5.01 F .783(an ar)184 476.4 R .783 +ecute the \214le speci\214ed as)5.01 F .784(an ar)184 476.4 R .783 (gument to the)-.18 F F1(exec)3.283 E F2 .783(builtin command.)3.283 F .783(An interactive shell does not exit if)5.783 F F1(exec)184 488.4 Q F2(fails.)2.5 E F1(expand_aliases)144 500.4 Q F2 1.159 @@ -6795,34 +6799,34 @@ F2(fails.)2.5 E F1(expand_aliases)144 500.4 Q F2 1.159 1.159(This option is)5.659 F(enabled by default for interactive shells.) 184 524.4 Q F1(extdebug)144 536.4 Q F2 (If set, behavior intended for use by debuggers is enabled:)184 548.4 Q -F1(1.)184 560.4 Q F2(The)28.5 E F13.607 E F2 1.107(option to the) -3.607 F F1(declare)3.607 E F2 1.108(builtin displays the sour)3.607 F -1.108(ce \214le name and)-.18 F .624(line number corr)220 572.4 R .624 +F1(1.)184 560.4 Q F2(The)28.5 E F13.608 E F2 1.108(option to the) +3.608 F F1(declare)3.608 E F2 1.107(builtin displays the sour)3.608 F +1.107(ce \214le name and)-.18 F .624(line number corr)220 572.4 R .624 (esponding to each function name supplied as an ar)-.18 F(gu-)-.18 E (ment.)220 584.4 Q F1(2.)184 596.4 Q F2 .98(If the command r)28.5 F .98 (un by the)-.08 F F1(DEBUG)3.48 E F2 .98(trap r)3.48 F .98 (eturns a non-zer)-.18 F 3.48(ov)-.18 G .98(alue, the)-3.48 F (next command is skipped and not executed.)220 608.4 Q F1(3.)184 620.4 Q -F2 1.107(If the command r)28.5 F 1.107(un by the)-.08 F F1(DEBUG)3.607 E -F2 1.106(trap r)3.606 F 1.106(eturns a value of 2, and the)-.18 F .87 +F2 1.106(If the command r)28.5 F 1.106(un by the)-.08 F F1(DEBUG)3.606 E +F2 1.106(trap r)3.606 F 1.107(eturns a value of 2, and the)-.18 F .871 (shell is executing in a subr)220 632.4 R .871 (outine \(a shell function or a shell script exe-)-.18 F(cuted by the) 220 644.4 Q F1(.)2.5 E F2(or)2.5 E F1(source)2.5 E F2 (builtins\), a call to)2.5 E F1(return)2.5 E F2(is simulated.)2.5 E F1 -26(4. BASH_ARGC)184 656.4 R F2(and)5.149 E F1(BASH_ARGV)5.149 E F2(ar) +26(4. BASH_ARGC)184 656.4 R F2(and)5.148 E F1(BASH_ARGV)5.148 E F2(ar) 5.149 E 5.149(eu)-.18 G 2.649(pdated as described in their)-5.149 F -(descriptions above.)220 668.4 Q F1(5.)184 680.4 Q F2 .163 +(descriptions above.)220 668.4 Q F1(5.)184 680.4 Q F2 .164 (Function tracing is enabled:)28.5 F .164 (command substitution, shell functions, and)5.164 F 1.112 (subshells invoked with)220 692.4 R F1(\()3.612 E F3(command)3.612 E F1 (\))3.612 E F2 1.112(inherit the)3.612 F F1(DEBUG)3.612 E F2(and)3.612 E F1(RETURN)3.612 E F2(traps.)220 704.4 Q F1(6.)184 716.4 Q F2(Err)28.5 E -2.171(or tracing is enabled:)-.18 F 2.171 +2.172(or tracing is enabled:)-.18 F 2.171 (command substitution, shell functions, and)7.171 F (subshells invoked with)220 728.4 Q F1(\()2.5 E F3(command)2.5 E F1(\)) 2.5 E F2(inherit the)2.5 E F1(ERROR)2.5 E F2(trap.)2.5 E F0 -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(58)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(58)198.17 E 0 Cg EP %%Page: 59 60 %%BeginPageSetup BP @@ -6839,36 +6843,37 @@ F2(ar)2.5 E 2.5(ee)-.18 G(nabled.)-2.5 E F1(extquote)144 108 Q F2 .143 132 Q(This option is enabled by default.)5 E F1(failglob)144 144 Q F2 .507(If set, patterns which fail to match \214lenames during pathname e\ xpansion r)184 156 R(esult)-.18 E(in an expansion err)184 168 Q(or)-.18 -E(.)-.74 E F1(force_\214gnore)144 180 Q F2 1.118(If set, the suf)184 192 -R 1.118(\214xes speci\214ed by the)-.18 F F1(FIGNORE)3.618 E F2 1.119 -(shell variable cause wor)3.619 F 1.119(ds to be)-.18 F(ignor)184 204 Q +E(.)-.74 E F1(force_\214gnore)144 180 Q F2 1.119(If set, the suf)184 192 +R 1.119(\214xes speci\214ed by the)-.18 F F1(FIGNORE)3.618 E F2 1.118 +(shell variable cause wor)3.618 F 1.118(ds to be)-.18 F(ignor)184 204 Q 1.291(ed when performing wor)-.18 F 3.791(dc)-.18 G 1.291 (ompletion even if the ignor)-3.791 F 1.291(ed wor)-.18 F 1.291(ds ar) --.18 F 3.79(et)-.18 G(he)-3.79 E 1.7(only possible completions.)184 216 -R(See)6.7 E/F4 9/Palatino-Bold@0 SF 1.7(SHELL V)4.2 F(ARIABLES)-1.161 E -F2 1.701(above for a description of)3.95 F F1(FIGNORE)184 228 Q F2 5(.T) -C(his option is enabled by default.)-5 E F1(gnu_errfmt)144 240 Q F2 .843 -(If set, shell err)184 252 R .843(or messages ar)-.18 F 3.342(ew)-.18 G -.842(ritten in the standar)-3.342 F 3.342(dG)-.18 G .842(NU err)-3.342 F -.842(or message for)-.18 F(-)-.18 E(mat.)184 264 Q F1(histappend)144 276 -Q F2 1.127(If set, the history list is appended to the \214le named by \ -the value of the)184 288 R F1(HIST)3.627 E(-)-.92 E(FILE)184 300 Q F2 +-.18 F 3.791(et)-.18 G(he)-3.791 E 1.701(only possible completions.)184 +216 R(See)6.701 E/F4 9/Palatino-Bold@0 SF 1.7(SHELL V)4.2 F(ARIABLES) +-1.161 E F2 1.7(above for a description of)3.95 F F1(FIGNORE)184 228 Q +F2 5(.T)C(his option is enabled by default.)-5 E F1(gnu_errfmt)144 240 Q +F2 .842(If set, shell err)184 252 R .842(or messages ar)-.18 F 3.342(ew) +-.18 G .842(ritten in the standar)-3.342 F 3.343(dG)-.18 G .843(NU err) +-3.343 F .843(or message for)-.18 F(-)-.18 E(mat.)184 264 Q F1 +(histappend)144 276 Q F2 1.127(If set, the history list is appended to \ +the \214le named by the value of the)184 288 R F1(HIST)3.626 E(-)-.92 E +(FILE)184 300 Q F2 (variable when the shell exits, rather than overwriting the \214le.)2.5 -E F1(histreedit)144 312 Q F2 1.381(If set, and)184 324 R F1(readline) -3.881 E F2 1.381(is being used, a user is given the opportunity to r) -3.881 F 1.38(e-edit a)-.18 F(failed history substitution.)184 336 Q F1 -(histverify)144 348 Q F2 2.133(If set, and)184 360 R F1(readline)4.633 E +E F1(histreedit)144 312 Q F2 1.38(If set, and)184 324 R F1(readline)3.88 +E F2 1.381(is being used, a user is given the opportunity to r)3.88 F +1.381(e-edit a)-.18 F(failed history substitution.)184 336 Q F1 +(histverify)144 348 Q F2 2.134(If set, and)184 360 R F1(readline)4.633 E F2 2.133(is being used, the r)4.633 F 2.133 -(esults of history substitution ar)-.18 F 4.634(en)-.18 G(ot)-4.634 E -.383(immediately passed to the shell parser)184 372 R 5.383(.I)-.74 G -.382(nstead, the r)-5.383 F .382(esulting line is loaded into)-.18 F +(esults of history substitution ar)-.18 F 4.633(en)-.18 G(ot)-4.633 E +.382(immediately passed to the shell parser)184 372 R 5.382(.I)-.74 G +.383(nstead, the r)-5.382 F .383(esulting line is loaded into)-.18 F (the)184 384 Q F1(readline)2.5 E F2(editing buf)2.5 E(fer)-.18 E 2.5(,a) -.74 G(llowing further modi\214cation.)-2.5 E F1(hostcomplete)144 396 Q -F2 .647(If set, and)184 408 R F1(readline)3.147 E F2 .648 -(is being used,)3.147 F F1(bash)3.148 E F2 .648 -(will attempt to perform hostname com-)3.148 F .44(pletion when a wor) +F2 .648(If set, and)184 408 R F1(readline)3.148 E F2 .648 +(is being used,)3.148 F F1(bash)3.148 E F2 .647 +(will attempt to perform hostname com-)3.148 F .439(pletion when a wor) 184 420 R 2.939(dc)-.18 G .439(ontaining a)-2.939 F F1(@)2.939 E F2 .439 -(is being completed \(see)2.939 F F1(Completing)2.939 E F2(under)2.939 E +(is being completed \(see)2.939 F F1(Completing)2.94 E F2(under)2.94 E F4(READLINE)184 432 Q F2 2.5(above\). This)2.25 F (is enabled by default.)2.5 E F1(huponexit)144 444 Q F2(If set,)184 456 Q F1(bash)2.5 E F2(will send)2.5 E F4(SIGHUP)2.5 E F2 @@ -6878,20 +6883,20 @@ Q F1(bash)2.5 E F2(will send)2.5 E F4(SIGHUP)2.5 E F2 (to cause that wor)2.76 F 2.76(da)-.18 G .26(nd all r)-2.76 F .26 (emaining char)-.18 F(-)-.18 E .512(acters on that line to be ignor)184 492 R .512(ed in an interactive shell \(see)-.18 F F4(COMMENTS)3.012 E -F2(above\).)2.762 E(This option is enabled by default.)184 504 Q F1 +F2(above\).)2.763 E(This option is enabled by default.)184 504 Q F1 (lithist)144 516 Q F2 .513(If set, and the)12.8 F F1(cmdhist)3.013 E F2 .513(option is enabled, multi-line commands ar)3.013 F 3.013(es)-.18 G .513(aved to the)-3.013 F .643(history with embedded newlines rather th\ an using semicolon separators wher)184 528 R(e)-.18 E(possible.)184 540 Q F1(login_shell)144 552 Q F2 2.454 (The shell sets this option if it is started as a login shell \(see)184 -564 R F4(INVOCA)4.954 E(TION)-.828 E F2 2.5(above\). The)184 576 R -(value may not be changed.)2.5 E F1(mailwarn)144 588 Q F2 .965 -(If set, and a \214le that)184 600 R F1(bash)3.465 E F2 .964 +564 R F4(INVOCA)4.953 E(TION)-.828 E F2 2.5(above\). The)184 576 R +(value may not be changed.)2.5 E F1(mailwarn)144 588 Q F2 .964 +(If set, and a \214le that)184 600 R F1(bash)3.464 E F2 .965 (is checking for mail has been accessed since the last)3.464 F 1.647 (time it was checked, the message `)184 612 R 1.647(`The mail in)-.37 F -F3(mail\214le)4.147 E F2 1.647(has been r)4.147 F(ead')-.18 E 4.148('i) --.37 G 4.148(sd)-4.148 G(is-)-4.148 E(played.)184 624 Q F1 +F3(mail\214le)4.147 E F2 1.647(has been r)4.147 F(ead')-.18 E 4.147('i) +-.37 G 4.147(sd)-4.147 G(is-)-4.147 E(played.)184 624 Q F1 (no_empty_cmd_completion)144 636 Q F2 .572(If set, and)184 648 R F1 (readline)3.072 E F2 .572(is being used,)3.072 F F1(bash)3.072 E F2 .572 (will not attempt to sear)3.072 F .572(ch the)-.18 F F1 -.74(PA)3.072 G @@ -6901,8 +6906,8 @@ F3(mail\214le)4.147 E F2 1.647(has been r)4.147 F(ead')-.18 E 4.148('i) F2 1.548 (matches \214lenames in a case\255insensitive fashion when performing) 4.048 F(pathname expansion \(see)184 696 Q F1(Pathname Expansion)2.5 E -F2(above\).)2.5 E F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2) -.15 G(005 Feb 19)-124.42 E(59)199 E 0 Cg EP +F2(above\).)2.5 E F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2) +.15 G(005 Mar 15)-123.59 E(59)198.17 E 0 Cg EP %%Page: 60 61 %%BeginPageSetup BP @@ -6917,31 +6922,31 @@ E F2(conditional commands.)2.5 E F1(nullglob)144 120 Q F2 2.34(If set,) (allows patterns which match no \214les \(see)4.84 F F1 2.34 (Pathname Expansion)4.84 F F2 (above\) to expand to a null string, rather than themselves.)184 144 Q -F1(progcomp)144 156 Q F2 1.199(If set, the pr)184 168 R 1.199 -(ogrammable completion facilities \(see)-.18 F F1 1.198 -(Programmable Completion)3.698 F F2(above\) ar)184 180 Q 2.5(ee)-.18 G +F1(progcomp)144 156 Q F2 1.198(If set, the pr)184 168 R 1.199 +(ogrammable completion facilities \(see)-.18 F F1 1.199 +(Programmable Completion)3.699 F F2(above\) ar)184 180 Q 2.5(ee)-.18 G 2.5(nabled. This)-2.5 F(option is enabled by default.)2.5 E F1 -(promptvars)144 192 Q F2 2.552(If set, pr)184 204 R 2.552 -(ompt strings under)-.18 F 2.553 +(promptvars)144 192 Q F2 2.553(If set, pr)184 204 R 2.553 +(ompt strings under)-.18 F 2.552 (go parameter expansion, command substitution,)-.18 F 1.007 (arithmetic expansion, and quote r)184 216 R 1.007 (emoval after being expanded as described in)-.18 F/F3 9/Palatino-Bold@0 SF(PROMPTING)184 228 Q F2 2.5(above. This)2.25 F (option is enabled by default.)2.5 E F1(restricted_shell)144 240 Q F2 -1.743(The shell sets this option if it is started in r)184 252 R 1.743 -(estricted mode \(see)-.18 F F3(RESTRICTED)4.243 E(SHELL)184 264 Q F2 -4.862(below\). The)4.613 F 2.362(value may not be changed.)4.862 F 2.362 -(This is not r)7.362 F 2.362(eset when the)-.18 F .293 +1.743(The shell sets this option if it is started in r)184 252 R 1.742 +(estricted mode \(see)-.18 F F3(RESTRICTED)4.242 E(SHELL)184 264 Q F2 +4.862(below\). The)4.612 F 2.362(value may not be changed.)4.862 F 2.362 +(This is not r)7.362 F 2.362(eset when the)-.18 F .294 (startup \214les ar)184 276 R 2.794(ee)-.18 G .294 (xecuted, allowing the startup \214les to discover whether or not a) -2.794 F(shell is r)184 288 Q(estricted.)-.18 E F1(shift_verbose)144 300 -Q F2 .528(If set, the)184 312 R F1(shift)3.028 E F2 .528 +Q F2 .527(If set, the)184 312 R F1(shift)3.028 E F2 .528 (builtin prints an err)3.028 F .528 (or message when the shift count exceeds the)-.18 F (number of positional parameters.)184 324 Q F1(sourcepath)144 336 Q F2 -.514(If set, the)184 348 R F1(source)3.014 E F2(\()3.014 E F1(.)A F2 +.515(If set, the)184 348 R F1(source)3.015 E F2(\()3.014 E F1(.)A F2 3.014(\)b)C .514(uiltin uses the value of)-3.014 F F3 -.666(PA)3.014 G -(TH)-.162 E F2 .515(to \214nd the dir)2.764 F .515(ectory contain-)-.18 +(TH)-.162 E F2 .514(to \214nd the dir)2.764 F .514(ectory contain-)-.18 F(ing the \214le supplied as an ar)184 360 Q 2.5(gument. This)-.18 F (option is enabled by default.)2.5 E F1(xpg_echo)144 372 Q F2 (If set, the)184 384 Q F1(echo)2.5 E F2 @@ -6949,7 +6954,7 @@ F(ing the \214le supplied as an ar)184 360 Q 2.5(gument. This)-.18 F (suspend)108 396 Q F2([)2.5 E F1A F2(])A .048 (Suspend the execution of this shell until it r)144 408 R .048 (eceives a)-.18 F F3(SIGCONT)2.548 E F2 2.548(signal. The)2.298 F F1 -2.548 E F2 .047(option says)2.547 F .327 +2.548 E F2 .048(option says)2.548 F .327 (not to complain if this is a login shell; just suspend anyway)144 420 R 5.327(.T)-1.11 G .327(he r)-5.327 F .327(eturn status is 0 unless)-.18 F (the shell is a login shell and)144 432 Q F12.5 E F2 @@ -6957,13 +6962,13 @@ F(ing the \214le supplied as an ar)184 360 Q 2.5(gument. This)-.18 F (test)108 444 Q/F4 10/Palatino-Italic@0 SF(expr)2.5 E F1([)108 456 Q F4 (expr)2.5 E F1(])2.5 E F2 .544(Return a status of 0 or 1 depending on t\ he evaluation of the conditional expr)6.56 F(ession)-.18 E F4(expr)3.044 -E F2(.).45 E .788(Each operator and operand must be a separate ar)144 -468 R 3.289(gument. Expr)-.18 F .789(essions ar)-.18 F 3.289(ec)-.18 G -.789(omposed of)-3.289 F(the primaries described above under)144 480 Q +E F2(.).45 E .789(Each operator and operand must be a separate ar)144 +468 R 3.288(gument. Expr)-.18 F .788(essions ar)-.18 F 3.288(ec)-.18 G +.788(omposed of)-3.288 F(the primaries described above under)144 480 Q F3(CONDITIONAL EXPRESSIONS)2.5 E/F5 9/Palatino-Roman@0 SF(.)A F2(Expr) 144 498 Q .054 (essions may be combined using the following operators, listed in decr) --.18 F .054(easing or)-.18 F .054(der of)-.18 F(pr)144 510 Q(ecedence.) +-.18 F .055(easing or)-.18 F .055(der of)-.18 F(pr)144 510 Q(ecedence.) -.18 E F1(!)144 522 Q F4(expr)2.5 E F2 -.78 -.9(Tr u)12.94 H 2.5(ei).9 G (f)-2.5 E F4(expr)2.85 E F2(is false.)2.95 E F1(\()144 534 Q F4(expr)2.5 E F1(\))2.5 E F2 .847(Returns the value of)6.56 F F4(expr)3.347 E F2 @@ -6981,154 +6986,154 @@ G(oth)-2.5 E F4(expr1)2.85 E F2(and)2.5 E F4(expr2)2.85 E F2(ar)2.5 E (ession is false.)-.18 E 2.5(1a)144 664.8 S -.18(rg)-2.5 G(ument).18 E (The expr)180 676.8 Q(ession is tr)-.18 E(ue if and only if the ar)-.08 E(gument is not null.)-.18 E 2.5(2a)144 688.8 S -.18(rg)-2.5 G(uments) -.18 E .208(If the \214rst ar)180 700.8 R .208(gument is)-.18 F F1(!) +.18 E .209(If the \214rst ar)180 700.8 R .208(gument is)-.18 F F1(!) 2.708 E F2 2.708(,t)C .208(he expr)-2.708 F .208(ession is tr)-.18 F -.208(ue if and only if the second ar)-.08 F(gument)-.18 E 2.144 -(is null.)180 712.8 R 2.144(If the \214rst ar)7.144 F 2.144 -(gument is one of the unary conditional operators listed)-.18 F 1.401 +.208(ue if and only if the second ar)-.08 F(gument)-.18 E 2.143 +(is null.)180 712.8 R 2.144(If the \214rst ar)7.143 F 2.144 +(gument is one of the unary conditional operators listed)-.18 F 1.402 (above under)180 724.8 R F3 1.401(CONDITIONAL EXPRESSIONS)3.901 F F5(,)A F2 1.401(the expr)3.651 F 1.401(ession is tr)-.18 F 1.401 (ue if the unary)-.08 F F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G -124.42(l2).15 G(005 Feb 19)-124.42 E(60)199 E 0 Cg EP +123.59(l2).15 G(005 Mar 15)-123.59 E(60)198.17 E 0 Cg EP %%Page: 61 62 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) --.35 E/F1 10/Palatino-Roman@0 SF 1.356(test is tr)180 84 R 3.856(ue. If) --.08 F 1.356(the \214rst ar)3.856 F 1.356 -(gument is not a valid unary conditional operator)-.18 F 3.855(,t)-.74 G -(he)-3.855 E(expr)180 96 Q(ession is false.)-.18 E 2.5(3a)144 108 S -.18 -(rg)-2.5 G(uments).18 E 1.499(If the second ar)180 120 R 1.499 +-.35 E/F1 10/Palatino-Roman@0 SF 1.355(test is tr)180 84 R 3.855(ue. If) +-.08 F 1.356(the \214rst ar)3.855 F 1.356 +(gument is not a valid unary conditional operator)-.18 F 3.856(,t)-.74 G +(he)-3.856 E(expr)180 96 Q(ession is false.)-.18 E 2.5(3a)144 108 S -.18 +(rg)-2.5 G(uments).18 E 1.5(If the second ar)180 120 R 1.499 (gument is one of the binary conditional operators listed above)-.18 F (under)180 132 Q/F2 9/Palatino-Bold@0 SF .64(CONDITIONAL EXPRESSIONS) -3.141 F/F3 9/Palatino-Roman@0 SF(,)A F1 .64(the r)2.89 F .64 -(esult of the expr)-.18 F .64(ession is the r)-.18 F .64(esult of)-.18 F -.528(the binary test using the \214rst and thir)180 144 R 3.029(da)-.18 -G -.18(rg)-3.029 G .529(uments as operands.).18 F .529 -(If the \214rst ar)5.529 F(gu-)-.18 E .107(ment is)180 156 R/F4 10 -/Palatino-Bold@0 SF(!)2.607 E F1 2.607(,t)C .107 -(he value is the negation of the two-ar)-2.607 F .106 -(gument test using the second and)-.18 F(thir)180 168 Q 4.632(da)-.18 G --.18(rg)-4.632 G 4.632(uments. If).18 F 2.132(the \214rst ar)4.632 F -2.132(gument is exactly)-.18 F F4(\()4.632 E F1 2.133(and the thir)4.632 -F 4.633(da)-.18 G -.18(rg)-4.633 G 2.133(ument is).18 F(exactly)180 180 -Q F4(\))2.926 E F1 2.926(,t)C .426(he r)-2.926 F .426 +3.14 F/F3 9/Palatino-Roman@0 SF(,)A F1 .64(the r)2.89 F .64 +(esult of the expr)-.18 F .64(ession is the r)-.18 F .641(esult of)-.18 +F .529(the binary test using the \214rst and thir)180 144 R 3.029(da) +-.18 G -.18(rg)-3.029 G .528(uments as operands.).18 F .528 +(If the \214rst ar)5.528 F(gu-)-.18 E .106(ment is)180 156 R/F4 10 +/Palatino-Bold@0 SF(!)2.606 E F1 2.606(,t)C .107 +(he value is the negation of the two-ar)-2.606 F .107 +(gument test using the second and)-.18 F(thir)180 168 Q 4.633(da)-.18 G +-.18(rg)-4.633 G 4.633(uments. If).18 F 2.133(the \214rst ar)4.633 F +2.132(gument is exactly)-.18 F F4(\()4.632 E F1 2.132(and the thir)4.632 +F 4.632(da)-.18 G -.18(rg)-4.632 G 2.132(ument is).18 F(exactly)180 180 +Q F4(\))2.925 E F1 2.925(,t)C .426(he r)-2.925 F .426 (esult is the one-ar)-.18 F .426(gument test of the second ar)-.18 F -2.925(gument. Otherwise,)-.18 F .43(the expr)180 192 R .43 +2.926(gument. Otherwise,)-.18 F .43(the expr)180 192 R .43 (ession is false.)-.18 F(The)5.43 E F42.93 E F1(and)2.93 E F4 2.93 E F1 .43(operators ar)2.93 F 2.93(ec)-.18 G(onsider)-2.93 E .43(ed binary operators)-.18 F(in this case.)180 204 Q 2.5(4a)144 216 S --.18(rg)-2.5 G(uments).18 E .669(If the \214rst ar)180 228 R .669 -(gument is)-.18 F F4(!)3.169 E F1 3.169(,t)C .669(he r)-3.169 F .668 -(esult is the negation of the thr)-.18 F(ee-ar)-.18 E .668(gument expr) +-.18(rg)-2.5 G(uments).18 E .668(If the \214rst ar)180 228 R .668 +(gument is)-.18 F F4(!)3.168 E F1 3.168(,t)C .669(he r)-3.168 F .669 +(esult is the negation of the thr)-.18 F(ee-ar)-.18 E .669(gument expr) -.18 F(es-)-.18 E .409(sion composed of the r)180 240 R .409 (emaining ar)-.18 F 2.909(guments. Otherwise,)-.18 F .409(the expr)2.909 F .409(ession is parsed)-.18 F(and evaluated accor)180 252 Q(ding to pr) -.18 E(ecedence using the r)-.18 E(ules listed above.)-.08 E 2.5(5o)144 264 S 2.5(rm)-2.5 G(or)-2.5 E 2.5(ea)-.18 G -.18(rg)-2.5 G(uments).18 E -.782(The expr)180 276 R .782(ession is parsed and evaluated accor)-.18 F -.782(ding to pr)-.18 F .781(ecedence using the r)-.18 F(ules)-.08 E +.781(The expr)180 276 R .782(ession is parsed and evaluated accor)-.18 F +.782(ding to pr)-.18 F .782(ecedence using the r)-.18 F(ules)-.08 E (listed above.)180 288 Q F4(times)108 304.8 Q F1 .334 (Print the accumulated user and system times for the shell and for pr) 11.01 F .334(ocesses r)-.18 F .334(un fr)-.08 F .334(om the)-.18 F 2.5 (shell. The)144 316.8 R -.18(re)2.5 G(turn status is 0.).18 E F4(trap) 108 333.6 Q F1([)2.5 E F4(\255lp)A F1 2.5(][)C([)-2.5 E/F5 10 /Palatino-Italic@0 SF(ar)A(g)-.18 E F1(])A F5(sigspec)2.5 E F1(...])2.5 -E .564(The command)144 345.6 R F5(ar)3.524 E(g)-.18 E F1 .564 -(is to be r)3.544 F .563(ead and executed when the shell r)-.18 F .563 -(eceives signal\(s\))-.18 F F5(sigspec)3.063 E F1 5.563(.I).32 G(f) --5.563 E F5(ar)144.46 357.6 Q(g)-.18 E F1 .152(is absent \(and ther) -3.132 F 2.653(ei)-.18 G 2.653(sas)-2.653 G(ingle)-2.653 E F5(sigspec) +E .563(The command)144 345.6 R F5(ar)3.523 E(g)-.18 E F1 .563 +(is to be r)3.543 F .563(ead and executed when the shell r)-.18 F .564 +(eceives signal\(s\))-.18 F F5(sigspec)3.064 E F1 5.564(.I).32 G(f) +-5.564 E F5(ar)144.46 357.6 Q(g)-.18 E F1 .153(is absent \(and ther) +3.133 F 2.653(ei)-.18 G 2.653(sas)-2.653 G(ingle)-2.653 E F5(sigspec) 2.653 E F1 2.653(\)o)C(r)-2.653 E F42.653 E F1 2.653(,e)C .153 -(ach speci\214ed signal is r)-2.653 F .153(eset to its original)-.18 F -.07(disposition \(the value it had upon entrance to the shell\).)144 -369.6 R(If)5.069 E F5(ar)3.029 E(g)-.18 E F1 .069 -(is the null string the signal)3.049 F .141(speci\214ed by each)144 -381.6 R F5(sigspec)3.051 E F1 .142(is ignor)2.961 F .142 -(ed by the shell and by the commands it invokes.)-.18 F(If)5.142 E F5 -(ar)3.102 E(g)-.18 E F1(is)3.122 E 1.796(not pr)144 393.6 R 1.796 -(esent and)-.18 F F44.296 E F1 1.795 -(has been supplied, then the trap commands associated with each)4.296 F -F5(sigspec)144.41 405.6 Q F1(ar)3.217 E 2.897(ed)-.18 G 2.897 -(isplayed. If)-2.897 F .397(no ar)2.897 F .397(guments ar)-.18 F 2.897 -(es)-.18 G .398(upplied or if only)-2.897 F F42.898 E F1 .398 -(is given,)2.898 F F4(trap)2.898 E F1 .398(prints the)2.898 F .036 +(ach speci\214ed signal is r)-2.653 F .152(eset to its original)-.18 F +.069(disposition \(the value it had upon entrance to the shell\).)144 +369.6 R(If)5.069 E F5(ar)3.03 E(g)-.18 E F1 .07 +(is the null string the signal)3.05 F .142(speci\214ed by each)144 381.6 +R F5(sigspec)3.052 E F1 .142(is ignor)2.962 F .142 +(ed by the shell and by the commands it invokes.)-.18 F(If)5.141 E F5 +(ar)3.101 E(g)-.18 E F1(is)3.121 E 1.795(not pr)144 393.6 R 1.795 +(esent and)-.18 F F44.295 E F1 1.796 +(has been supplied, then the trap commands associated with each)4.295 F +F5(sigspec)144.41 405.6 Q F1(ar)3.218 E 2.898(ed)-.18 G 2.898 +(isplayed. If)-2.898 F .398(no ar)2.898 F .398(guments ar)-.18 F 2.898 +(es)-.18 G .397(upplied or if only)-2.898 F F42.897 E F1 .397 +(is given,)2.897 F F4(trap)2.897 E F1 .397(prints the)2.897 F .035 (list of commands associated with each signal.)144 417.6 R(The)5.036 E -F42.536 E F1 .035(option causes the shell to print a list)2.536 F -1.094(of signal names and their corr)144 429.6 R 1.095 -(esponding numbers.)-.18 F(Each)6.095 E F5(sigspec)4.005 E F1 1.095 -(is either a signal name)3.915 F .673(de\214ned in <)144 441.6 R F5 +F42.536 E F1 .036(option causes the shell to print a list)2.536 F +1.095(of signal names and their corr)144 429.6 R 1.095 +(esponding numbers.)-.18 F(Each)6.095 E F5(sigspec)4.005 E F1 1.094 +(is either a signal name)3.914 F .672(de\214ned in <)144 441.6 R F5 (signal.h)A F1 .673(>, or a signal number)B 5.673(.S)-.74 G .673 (ignal names ar)-5.673 F 3.173(ec)-.18 G .673 -(ase insensitive and the SIG)-3.173 F(pr)144 453.6 Q .976 +(ase insensitive and the SIG)-3.173 F(pr)144 453.6 Q .977 (e\214x is optional.)-.18 F .976(If a)5.976 F F5(sigspec)3.886 E F1(is) 3.796 E F2(EXIT)3.476 E F1 .976(\(0\) the command)3.226 F F5(ar)3.936 E -(g)-.18 E F1 .976(is executed on exit fr)3.956 F .977(om the)-.18 F -3.405(shell. If)144 465.6 R(a)3.405 E F5(sigspec)3.815 E F1(is)3.725 E -F2(DEBUG)3.405 E F3(,)A F1 .904(the command)3.155 F F5(ar)3.864 E(g)-.18 -E F1 .904(is executed befor)3.884 F 3.404(ee)-.18 G(very)-3.404 E F5 -.904(simple command)3.404 F F1(,)A F5(for)144 477.6 Q F1(command,)3.015 -E F5(case)3.015 E F1(command,)3.015 E F5(select)3.015 E F1 .515 -(command, every arithmetic)3.015 F F5(for)3.016 E F1 .516 -(command, and befor)3.016 F(e)-.18 E 1.001 +(g)-.18 E F1 .976(is executed on exit fr)3.956 F .976(om the)-.18 F +3.404(shell. If)144 465.6 R(a)3.404 E F5(sigspec)3.814 E F1(is)3.724 E +F2(DEBUG)3.404 E F3(,)A F1 .904(the command)3.154 F F5(ar)3.864 E(g)-.18 +E F1 .905(is executed befor)3.885 F 3.405(ee)-.18 G(very)-3.405 E F5 +.905(simple command)3.405 F F1(,)A F5(for)144 477.6 Q F1(command,)3.016 +E F5(case)3.016 E F1(command,)3.016 E F5(select)3.016 E F1 .515 +(command, every arithmetic)3.016 F F5(for)3.015 E F1 .515 +(command, and befor)3.015 F(e)-.18 E 1.001 (the \214rst command executes in a shell function \(see)144 489.6 R F2 -1.001(SHELL GRAMMAR)3.501 F F1 3.5(above\). Refer)3.25 F(to)3.5 E .678 -(the description of the)144 501.6 R F4(extdebug)3.178 E F1 .678 +1.001(SHELL GRAMMAR)3.501 F F1 3.501(above\). Refer)3.251 F(to)3.501 E +.679(the description of the)144 501.6 R F4(extdebug)3.178 E F1 .678 (option to the)3.178 F F4(shopt)3.178 E F1 .678 -(builtin for details of its ef)3.178 F .679(fect on the)-.18 F F4(DEBUG) +(builtin for details of its ef)3.178 F .678(fect on the)-.18 F F4(DEBUG) 144 513.6 Q F1 3.153(trap. If)3.153 F(a)3.153 E F5(sigspec)3.563 E F1 (is)3.473 E F2(ERR)3.153 E F3(,)A F1 .653(the command)2.903 F F5(ar) -3.613 E(g)-.18 E F1 .653(is executed whenever a simple com-)3.633 F .24 -(mand has a non\255zer)144 525.6 R 2.74(oe)-.18 G .24 -(xit status, subject to the following conditions.)-2.74 F(The)5.241 E F2 -(ERR)2.741 E F1 .241(trap is not)2.491 F 1.926(executed if the failed c\ -ommand is part of the command list immediately following a)144 537.6 R -F4(while)144 549.6 Q F1(or)2.551 E F4(until)2.551 E F1(keywor)2.552 E -.052(d, part of the test in an)-.18 F F5(if)2.712 E F1 .052 +3.613 E(g)-.18 E F1 .653(is executed whenever a simple com-)3.633 F .241 +(mand has a non\255zer)144 525.6 R 2.741(oe)-.18 G .24 +(xit status, subject to the following conditions.)-2.741 F(The)5.24 E F2 +(ERR)2.74 E F1 .24(trap is not)2.49 F 1.926(executed if the failed comm\ +and is part of the command list immediately following a)144 537.6 R F4 +(while)144 549.6 Q F1(or)2.552 E F4(until)2.552 E F1(keywor)2.552 E .052 +(d, part of the test in an)-.18 F F5(if)2.712 E F1 .052 (statement, part of a)4.402 F F4(&&)2.552 E F1(or)2.552 E/F6 10/Symbol -SF2.552 E F1 .052(list, or if the)2.552 F .093(command's r)144 +SF2.552 E F1 .051(list, or if the)2.552 F .092(command's r)144 561.6 R .092(eturn value is being inverted via)-.18 F F4(!)2.592 E F1 5.092(.T)C .092(hese ar)-5.092 F 2.592(et)-.18 G .092 -(he same conditions obeyed by)-2.592 F(the)144 573.6 Q F4(errexit)2.824 -E F1 2.824(option. If)2.824 F(a)2.824 E F5(sigspec)3.234 E F1(is)3.144 E -F2(RETURN)2.824 E F3(,)A F1 .325(the command)2.575 F F5(ar)3.285 E(g) --.18 E F1 .325(is executed each time a shell)3.305 F 1.951 +(he same conditions obeyed by)-2.592 F(the)144 573.6 Q F4(errexit)2.825 +E F1 2.825(option. If)2.825 F(a)2.825 E F5(sigspec)3.235 E F1(is)3.145 E +F2(RETURN)2.825 E F3(,)A F1 .325(the command)2.575 F F5(ar)3.284 E(g) +-.18 E F1 .324(is executed each time a shell)3.304 F 1.95 (function or a script executed with the)144 585.6 R F4(.)4.451 E F1(or) -4.451 E F4(source)4.451 E F1 1.95(builtins \214nishes executing.)4.451 F -(Signals)6.95 E(ignor)144 597.6 Q .846 -(ed upon entry to the shell cannot be trapped or r)-.18 F 3.347(eset. T) --.18 F .847(rapped signals ar)-.9 F 3.347(er)-.18 G .847(eset to)-3.527 -F .299(their original values in a child pr)144 609.6 R .299 -(ocess when it is cr)-.18 F 2.799(eated. The)-.18 F -.18(re)2.799 G .298 +4.451 E F4(source)4.451 E F1 1.951(builtins \214nishes executing.)4.451 +F(Signals)6.951 E(ignor)144 597.6 Q .847 +(ed upon entry to the shell cannot be trapped or r)-.18 F 3.346(eset. T) +-.18 F .846(rapped signals ar)-.9 F 3.346(er)-.18 G .846(eset to)-3.526 +F .298(their original values in a child pr)144 609.6 R .299 +(ocess when it is cr)-.18 F 2.799(eated. The)-.18 F -.18(re)2.799 G .299 (turn status is false if any).18 F F5(sigspec)144.41 621.6 Q F1 (is invalid; otherwise)2.82 E F4(trap)2.5 E F1 -.18(re)2.5 G(turns tr) .18 E(ue.)-.08 E F4(type)108 638.4 Q F1([)2.5 E F4(\255aftpP)A F1(])A F5 -(name)2.5 E F1([)2.5 E F5(name)A F1(...])2.5 E -.55(Wi)144 650.4 S 1.475 +(name)2.5 E F1([)2.5 E F5(name)A F1(...])2.5 E -.55(Wi)144 650.4 S 1.476 (th no options, indicate how each).55 F F5(name)4.236 E F1 1.476 -(would be interpr)4.326 F 1.476(eted if used as a command)-.18 F 2.726 -(name. If)144 662.4 R(the)2.726 E F42.726 E F1 .226 -(option is used,)2.726 F F4(type)2.725 E F1 .225 -(prints a string which is one of)2.725 F F5(alias)2.725 E F1(,).06 E F5 -(keyword)2.725 E F1(,).33 E F5(function)2.725 E F1(,).08 E F5(builtin) -144 674.4 Q F1 2.555(,o).08 G(r)-2.555 E F5(\214le)4.675 E F1(if)2.905 E -F5(name)2.815 E F1 .056(is an alias, shell r)2.905 F .056(eserved wor) --.18 F .056(d, function, builtin, or disk \214le, r)-.18 F(espec-)-.18 E -(tively)144 686.4 Q 6.635(.I)-1.11 G 4.135(ft)-6.635 G(he)-4.135 E F5 -(name)4.395 E F1 1.635 +(would be interpr)4.326 F 1.475(eted if used as a command)-.18 F 2.725 +(name. If)144 662.4 R(the)2.725 E F42.725 E F1 .225 +(option is used,)2.725 F F4(type)2.725 E F1 .225 +(prints a string which is one of)2.725 F F5(alias)2.726 E F1(,).06 E F5 +(keyword)2.726 E F1(,).33 E F5(function)2.726 E F1(,).08 E F5(builtin) +144 674.4 Q F1 2.556(,o).08 G(r)-2.556 E F5(\214le)4.676 E F1(if)2.906 E +F5(name)2.816 E F1 .056(is an alias, shell r)2.906 F .056(eserved wor) +-.18 F .055(d, function, builtin, or disk \214le, r)-.18 F(espec-)-.18 E +(tively)144 686.4 Q 6.634(.I)-1.11 G 4.134(ft)-6.634 G(he)-4.134 E F5 +(name)4.394 E F1 1.635 (is not found, then nothing is printed, and an exit status of false is) -4.485 F -.18(re)144 698.4 S 2.522(turned. If).18 F(the)2.523 E F4 +4.484 F -.18(re)144 698.4 S 2.523(turned. If).18 F(the)2.523 E F4 2.523 E F1 .023(option is used,)2.523 F F4(type)2.523 E F1 .023 (either r)2.523 F .023(eturns the name of the disk \214le that would) -.18 F 1.086(be executed if)144 710.4 R F5(name)3.846 E F1(wer)3.936 E 3.586(es)-.18 G 1.086(peci\214ed as a command name, or nothing if)-3.586 -F/F7 10/Courier@0 SF 1.086(type -t name)3.586 F F1 .015(would not r)144 -722.4 R(eturn)-.18 E F5(\214le)2.515 E F1 5.015(.T).35 G(he)-5.015 E F4 -2.515 E F1 .015(option for)2.515 F .015(ces a)-.18 F F2 -.666(PA) -2.515 G(TH)-.162 E F1(sear)2.266 E .016(ch for each)-.18 F F5(name)2.516 -E F1 2.516(,e)C .016(ven if)-2.516 F F7 .016(type -t)2.516 F F0 -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(61)199 E 0 Cg EP +F/F7 10/Courier@0 SF 1.086(type -t name)3.586 F F1 .016(would not r)144 +722.4 R(eturn)-.18 E F5(\214le)2.516 E F1 5.016(.T).35 G(he)-5.016 E F4 +2.516 E F1 .016(option for)2.516 F .016(ces a)-.18 F F2 -.666(PA) +2.515 G(TH)-.162 E F1(sear)2.265 E .015(ch for each)-.18 F F5(name)2.515 +E F1 2.515(,e)C .015(ven if)-2.515 F F7 .015(type -t)2.515 F F0 +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(61)198.17 E 0 Cg EP %%Page: 62 63 %%BeginPageSetup BP @@ -7138,56 +7143,56 @@ BP (would not r)3.145 F(eturn)-.18 E/F3 10/Palatino-Italic@0 SF(\214le) 3.145 E F2 5.645(.I).35 G 3.145(fac)-5.645 G .645(ommand is hashed,) -3.145 F/F4 10/Palatino-Bold@0 SF3.145 E F2(and)3.145 E F4 -3.145 E F2 .645(print the hashed value,)3.145 F .41 +3.145 E F2 .645(print the hashed value,)3.145 F .411 (not necessarily the \214le that appears \214rst in)144 96 R/F5 9 /Palatino-Bold@0 SF -.666(PA)2.911 G(TH)-.162 E/F6 9/Palatino-Roman@0 SF (.)A F2 .411(If the)4.911 F F42.911 E F2 .411(option is used,) -2.911 F F4(type)2.911 E F2 .411(prints all)2.911 F .164 +2.911 F F4(type)2.91 E F2 .41(prints all)2.91 F .164 (of the places that contain an executable named)144 108 R F3(name)2.664 E F2 5.164(.T).35 G .164(his includes aliases and functions,)-5.164 F .73(if and only if the)144 120 R F43.23 E F2 .73 (option is not also used.)3.23 F .73 -(The table of hashed commands is not con-)5.73 F .498(sulted when using) +(The table of hashed commands is not con-)5.73 F .497(sulted when using) 144 132 R F42.998 E F2 5.498(.T)C(he)-5.498 E F42.998 E F2 .498(option suppr)2.998 F .498(esses shell function lookup, as with the) --.18 F F4(com-)2.997 E(mand)144 144 Q F2(builtin.)4.557 E F4(type)7.057 -E F2 -.18(re)4.557 G 2.057(turns tr).18 F 2.057(ue if any of the ar)-.08 -F 2.057(guments ar)-.18 F 4.558(ef)-.18 G 2.058(ound, false if none ar) --4.558 F(e)-.18 E(found.)144 156 Q F4(ulimit)108 172.8 Q F2([)2.5 E F4 +-.18 F F4(com-)2.998 E(mand)144 144 Q F2(builtin.)4.558 E F4(type)7.058 +E F2 -.18(re)4.558 G 2.058(turns tr).18 F 2.057(ue if any of the ar)-.08 +F 2.057(guments ar)-.18 F 4.557(ef)-.18 G 2.057(ound, false if none ar) +-4.557 F(e)-.18 E(found.)144 156 Q F4(ulimit)108 172.8 Q F2([)2.5 E F4 (\255SHacd\215mnpstuv)A F2([)2.5 E F3(limit)A F2(]])A(Pr)144 184.8 Q -.062(ovides contr)-.18 F .062(ol over the r)-.18 F(esour)-.18 E .061 -(ces available to the shell and to pr)-.18 F .061 -(ocesses started by it, on)-.18 F 1.496(systems that allow such contr) -144 196.8 R 3.996(ol. The)-.18 F F43.997 E F2(and)3.997 E F4 -3.997 E F2 1.497(options specify that the har)3.997 F 3.997(do)-.18 G -3.997(rs)-3.997 G(oft)-3.997 E .884(limit is set for the given r)144 +.061(ovides contr)-.18 F .061(ol over the r)-.18 F(esour)-.18 E .061 +(ces available to the shell and to pr)-.18 F .062 +(ocesses started by it, on)-.18 F 1.497(systems that allow such contr) +144 196.8 R 3.997(ol. The)-.18 F F43.997 E F2(and)3.997 E F4 +3.997 E F2 1.496(options specify that the har)3.997 F 3.996(do)-.18 G +3.996(rs)-3.996 G(oft)-3.996 E .884(limit is set for the given r)144 208.8 R(esour)-.18 E 3.384(ce. A)-.18 F(har)3.384 E 3.384(dl)-.18 G .884 (imit cannot be incr)-3.384 F .884(eased once it is set; a soft)-.18 F -.088(limit may be incr)144 220.8 R .088 +.089(limit may be incr)144 220.8 R .088 (eased up to the value of the har)-.18 F 2.588(dl)-.18 G 2.588(imit. If) --2.588 F(neither)2.589 E F42.589 E F2(nor)2.589 E F42.589 E -F2 .089(is speci\214ed,)2.589 F .163(both the soft and har)144 232.8 R -2.663(dl)-.18 G .163(imits ar)-2.663 F 2.663(es)-.18 G 2.663(et. The) --2.663 F .163(value of)2.663 F F3(limit)2.803 E F2 .162 -(can be a number in the unit speci-)2.933 F .175(\214ed for the r)144 -244.8 R(esour)-.18 E .175(ce or one of the special values)-.18 F F4 -(hard)2.676 E F2(,)A F4(soft)2.676 E F2 2.676(,o)C(r)-2.676 E F4 -(unlimited)2.676 E F2 2.676(,w)C .176(hich stand for)-2.676 F .243 -(the curr)144 256.8 R .243(ent har)-.18 F 2.743(dl)-.18 G .243 -(imit, the curr)-2.743 F .243(ent soft limit, and no limit, r)-.18 F -(espectively)-.18 E 5.242(.I)-1.11 G(f)-5.242 E F3(limit)2.882 E F2 .242 -(is omitted,)3.012 F .081(the curr)144 268.8 R .081 +-2.588 F(neither)2.588 E F42.588 E F2(nor)2.588 E F42.588 E +F2 .088(is speci\214ed,)2.588 F .162(both the soft and har)144 232.8 R +2.662(dl)-.18 G .162(imits ar)-2.662 F 2.662(es)-.18 G 2.663(et. The) +-2.662 F .163(value of)2.663 F F3(limit)2.803 E F2 .163 +(can be a number in the unit speci-)2.933 F .176(\214ed for the r)144 +244.8 R(esour)-.18 E .176(ce or one of the special values)-.18 F F4 +(hard)2.676 E F2(,)A F4(soft)2.675 E F2 2.675(,o)C(r)-2.675 E F4 +(unlimited)2.675 E F2 2.675(,w)C .175(hich stand for)-2.675 F .242 +(the curr)144 256.8 R .242(ent har)-.18 F 2.742(dl)-.18 G .242 +(imit, the curr)-2.742 F .243(ent soft limit, and no limit, r)-.18 F +(espectively)-.18 E 5.243(.I)-1.11 G(f)-5.243 E F3(limit)2.883 E F2 .243 +(is omitted,)3.013 F .082(the curr)144 268.8 R .081 (ent value of the soft limit of the r)-.18 F(esour)-.18 E .081 -(ce is printed, unless the)-.18 F F42.581 E F2 .082 -(option is given.)2.582 F .33(When mor)144 280.8 R 2.83(et)-.18 G .33 -(han one r)-2.83 F(esour)-.18 E .329 -(ce is speci\214ed, the limit name and unit ar)-.18 F 2.829(ep)-.18 G -.329(rinted befor)-2.829 F 2.829(et)-.18 G(he)-2.829 E 2.5(value. Other) -144 292.8 R(options ar)2.5 E 2.5(ei)-.18 G(nterpr)-2.5 E -(eted as follows:)-.18 E F4144 304.8 Q F2(All curr)24.94 E -(ent limits ar)-.18 E 2.5(er)-.18 G(eported)-2.68 E F4144 316.8 Q -F2(The maximum size of cor)25.5 E 2.5<658c>-.18 G(les cr)-2.5 E(eated) --.18 E F4144 328.8 Q F2(The maximum size of a pr)23.83 E +(ce is printed, unless the)-.18 F F42.581 E F2 .081 +(option is given.)2.581 F .329(When mor)144 280.8 R 2.829(et)-.18 G .329 +(han one r)-2.829 F(esour)-.18 E .329 +(ce is speci\214ed, the limit name and unit ar)-.18 F 2.83(ep)-.18 G .33 +(rinted befor)-2.83 F 2.83(et)-.18 G(he)-2.83 E 2.5(value. Other)144 +292.8 R(options ar)2.5 E 2.5(ei)-.18 G(nterpr)-2.5 E(eted as follows:) +-.18 E F4144 304.8 Q F2(All curr)24.94 E(ent limits ar)-.18 E 2.5 +(er)-.18 G(eported)-2.68 E F4144 316.8 Q F2 +(The maximum size of cor)25.5 E 2.5<658c>-.18 G(les cr)-2.5 E(eated)-.18 +E F4144 328.8 Q F2(The maximum size of a pr)23.83 E (ocess's data segment)-.18 E F4144 340.8 Q F2 (The maximum size of \214les cr)26.05 E(eated by the shell)-.18 E F4 144 352.8 Q F2(The maximum size that may be locked into memory) @@ -7201,67 +7206,67 @@ F2(The maximum amount of cpu time in seconds)26.61 E F4144 436.8 Q F2(The maximum number of pr)23.83 E(ocesses available to a single user) -.18 E F4144 448.8 Q F2 (The maximum amount of virtual memory available to the shell)24.38 E(If) -144 465.6 Q F3(limit)4.151 E F2 1.511 -(is given, it is the new value of the speci\214ed r)4.281 F(esour)-.18 E -1.51(ce \(the)-.18 F F44.01 E F2 1.51(option is display)4.01 F +144 465.6 Q F3(limit)4.15 E F2 1.51 +(is given, it is the new value of the speci\214ed r)4.28 F(esour)-.18 E +1.511(ce \(the)-.18 F F44.011 E F2 1.511(option is display)4.011 F 4.315(only\). If)144 477.6 R 1.815(no option is given, then)4.315 F F4 4.315 E F2 1.815(is assumed.)4.315 F -.92(Va)6.815 G 1.815 (lues ar).92 F 4.315(ei)-.18 G 4.315(n1)-4.315 G 1.815(024-byte incr) --4.315 F(ements,)-.18 E .973(except for)144 489.6 R F43.473 E F2 +-4.315 F(ements,)-.18 E .972(except for)144 489.6 R F43.473 E F2 3.473(,w)C .973(hich is in seconds,)-3.473 F F43.473 E F2 3.473 (,w)C .973(hich is in units of 512-byte blocks, and)-3.473 F F4 -3.473 E F2(and)3.472 E F4144 501.6 Q F2 3.517(,w)C 1.017(hich ar) --3.517 F 3.517(eu)-.18 G 1.017(nscaled values.)-3.517 F 1.017(The r) -6.017 F 1.018(eturn status is 0 unless an invalid option or ar)-.18 F +3.473 E F2(and)3.473 E F4144 501.6 Q F2 3.518(,w)C 1.018(hich ar) +-3.518 F 3.518(eu)-.18 G 1.018(nscaled values.)-3.518 F 1.017(The r) +6.018 F 1.017(eturn status is 0 unless an invalid option or ar)-.18 F (gu-)-.18 E(ment is supplied, or an err)144 513.6 Q (or occurs while setting a new limit.)-.18 E F4(umask)108 530.4 Q F2([) 2.5 E F4A F2 2.5(][)C F4-2.5 E F2 2.5(][)C F3(mode)-2.5 E F2 -(])A .536(The user \214le-cr)144 542.4 R .536(eation mask is set to)-.18 -F F3(mode)3.035 E F2 5.535(.I).35 G(f)-5.535 E F3(mode)3.295 E F2 .535 -(begins with a digit, it is interpr)3.385 F .535(eted as)-.18 F 1.826 -(an octal number; otherwise it is interpr)144 554.4 R 1.827 -(eted as a symbolic mode mask similar to that)-.18 F .951(accepted by) -144 566.4 R F3(chmod)3.451 E F2 3.451(\(1\). If).33 F F3(mode)3.711 E F2 -.951(is omitted, the curr)3.801 F .95(ent value of the mask is printed.) --.18 F(The)5.95 E F4144 578.4 Q F2 .607(option causes the mask to\ - be printed in symbolic form; the default output is an octal)3.106 F -(number)144 590.4 Q 6.02(.I)-.74 G 3.52(ft)-6.02 G(he)-3.52 E F4 -3.52 E F2 1.02(option is supplied, and)3.52 F F3(mode)3.78 E F2 1.02 -(is omitted, the output is in a form that)3.87 F .236(may be r)144 602.4 -R .236(eused as input.)-.18 F .236(The r)5.236 F .237 +(])A .535(The user \214le-cr)144 542.4 R .535(eation mask is set to)-.18 +F F3(mode)3.035 E F2 5.535(.I).35 G(f)-5.535 E F3(mode)3.295 E F2 .536 +(begins with a digit, it is interpr)3.385 F .536(eted as)-.18 F 1.827 +(an octal number; otherwise it is interpr)144 554.4 R 1.826 +(eted as a symbolic mode mask similar to that)-.18 F .95(accepted by)144 +566.4 R F3(chmod)3.45 E F2 3.45(\(1\). If).33 F F3(mode)3.71 E F2 .951 +(is omitted, the curr)3.8 F .951(ent value of the mask is printed.)-.18 +F(The)5.951 E F4144 578.4 Q F2 .607(option causes the mask to be \ +printed in symbolic form; the default output is an octal)3.107 F(number) +144 590.4 Q 6.02(.I)-.74 G 3.52(ft)-6.02 G(he)-3.52 E F43.52 E F2 +1.02(option is supplied, and)3.52 F F3(mode)3.78 E F2 1.02 +(is omitted, the output is in a form that)3.87 F .237(may be r)144 602.4 +R .237(eused as input.)-.18 F .237(The r)5.237 F .236 (eturn status is 0 if the mode was successfully changed or if)-.18 F(no) 144 614.4 Q F3(mode)2.5 E F2(ar)2.5 E (gument was supplied, and false otherwise.)-.18 E F4(unalias)108 631.2 Q -F2<5bad>2.5 E F4(a)A F2 2.5(][)C F3(name)-2.5 E F2(...])2.5 E .719 -(Remove each)144 643.2 R F3(name)3.219 E F2(fr)3.219 E .719 +F2<5bad>2.5 E F4(a)A F2 2.5(][)C F3(name)-2.5 E F2(...])2.5 E .718 +(Remove each)144 643.2 R F3(name)3.218 E F2(fr)3.218 E .719 (om the list of de\214ned aliases.)-.18 F(If)5.719 E F43.219 E F2 -.718(is supplied, all alias de\214nitions)3.218 F(ar)144 655.2 Q 2.5(er) +.719(is supplied, all alias de\214nitions)3.219 F(ar)144 655.2 Q 2.5(er) -.18 G 2.5(emoved. The)-2.68 F -.18(re)2.5 G(turn value is tr).18 E (ue unless a supplied)-.08 E F3(name)2.76 E F2 (is not a de\214ned alias.)2.85 E F4(unset)108 672 Q F2<5bad>2.5 E F4 (fv)A F2 2.5(][)C F3(name)-2.5 E F2(...])2.5 E 1.61(For each)144 684 R F3(name)4.11 E F2 4.11(,r).35 G 1.61(emove the corr)-4.29 F 1.61 (esponding variable or function.)-.18 F 1.61(If no options ar)6.61 F -4.11(es)-.18 G(up-)-4.11 E .474(plied, or the)144 696 R F42.974 E -F2 .473(option is given, each)2.974 F F3(name)3.233 E F2 -.18(re)3.323 G -.473(fers to a shell variable.).18 F .473(Read-only variables)5.473 F +4.11(es)-.18 G(up-)-4.11 E .473(plied, or the)144 696 R F42.973 E +F2 .473(option is given, each)2.973 F F3(name)3.233 E F2 -.18(re)3.323 G +.474(fers to a shell variable.).18 F .474(Read-only variables)5.474 F .32(may not be unset.)144 708 R(If)5.32 E F42.82 E F2 .32 (is speci\214ed, each)2.82 F F3(name)3.08 E F2 -.18(re)3.17 G .32 (fers to a shell function, and the function).18 F .405 (de\214nition is r)144 720 R 2.905(emoved. Each)-.18 F .405 (unset variable or function is r)2.905 F .405(emoved fr)-.18 F .405 (om the envir)-.18 F(onment)-.18 E F0(GNU Bash-3.1-de)72 768 Q -.15(ve) --.25 G 124.42(l2).15 G(005 Feb 19)-124.42 E(62)199 E 0 Cg EP +-.25 G 123.59(l2).15 G(005 Mar 15)-123.59 E(62)198.17 E 0 Cg EP %%Page: 63 64 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S 389.54(SH\(1\) B).35 F(ASH\(1\)) --.35 E/F1 10/Palatino-Roman@0 SF 1.474(passed to subsequent commands.) +-.35 E/F1 10/Palatino-Roman@0 SF 1.475(passed to subsequent commands.) 144 84 R 1.475(If any of)6.475 F/F2 9/Palatino-Bold@0 SF(RANDOM)3.975 E -/F3 9/Palatino-Roman@0 SF(,)A F2(SECONDS)3.725 E F3(,)A F2(LINENO)3.725 -E F3(,)A F2(HISTCMD)3.725 E F3(,)A F2(FUNCNAME)144 96 Q F3(,)A F2 -(GROUPS)2.804 E F3(,)A F1(or)2.803 E F2(DIRST)3.053 E(ACK)-.828 E F1(ar) +/F3 9/Palatino-Roman@0 SF(,)A F2(SECONDS)3.725 E F3(,)A F2(LINENO)3.724 +E F3(,)A F2(HISTCMD)3.724 E F3(,)A F2(FUNCNAME)144 96 Q F3(,)A F2 +(GROUPS)2.803 E F3(,)A F1(or)2.803 E F2(DIRST)3.053 E(ACK)-.828 E F1(ar) 2.803 E 3.053(eu)-.18 G .553(nset, they lose their special pr)-3.053 F .553(operties, even if)-.18 F(they ar)144 108 Q 2.5(es)-.18 G (ubsequently r)-2.5 E 2.5(eset. The)-.18 F(exit status is tr)2.5 E @@ -7272,27 +7277,27 @@ E(eadonly)-.18 E(.)-1.11 E/F5 10/Palatino-Bold@0 SF(wait)108 124.8 Q F1 (eturn its termination status.)-.18 F(Each)5.016 E F4(n)2.776 E F1 .016 (may be a pr)2.596 F(ocess)-.18 E 1.733 (ID or a job speci\214cation; if a job spec is given, all pr)144 148.8 R -1.733(ocesses in that job's pipeline ar)-.18 F(e)-.18 E 1.014 -(waited for)144 160.8 R 6.014(.I)-.74 G(f)-6.014 E F4(n)3.774 E F1 1.014 -(is not given, all curr)3.594 F 1.014(ently active child pr)-.18 F 1.015 -(ocesses ar)-.18 F 3.515(ew)-.18 G 1.015(aited for)-3.515 F 3.515(,a) --.74 G 1.015(nd the)-3.515 F -.18(re)144 172.8 S .694 +1.733(ocesses in that job's pipeline ar)-.18 F(e)-.18 E 1.015 +(waited for)144 160.8 R 6.015(.I)-.74 G(f)-6.015 E F4(n)3.775 E F1 1.015 +(is not given, all curr)3.595 F 1.014(ently active child pr)-.18 F 1.014 +(ocesses ar)-.18 F 3.514(ew)-.18 G 1.014(aited for)-3.514 F 3.514(,a) +-.74 G 1.014(nd the)-3.514 F -.18(re)144 172.8 S .693 (turn status is zer).18 F 3.193(o. If)-.18 F F4(n)3.453 E F1 .693 (speci\214es a non-existent pr)3.273 F .693(ocess or job, the r)-.18 F -.693(eturn status is 127.)-.18 F(Otherwise, the r)144 184.8 Q +.694(eturn status is 127.)-.18 F(Otherwise, the r)144 184.8 Q (eturn status is the exit status of the last pr)-.18 E (ocess or job waited for)-.18 E(.)-.74 E/F6 10.95/Palatino-Bold@0 SF -(RESTRICTED SHELL)72 201.6 Q F1(If)108 213.6 Q F5(bash)4.638 E F1 2.138 -(is started with the name)4.638 F F5(rbash)4.638 E F1 4.638(,o)C 4.638 -(rt)-4.638 G(he)-4.638 E F54.638 E F1 2.139 +(RESTRICTED SHELL)72 201.6 Q F1(If)108 213.6 Q F5(bash)4.639 E F1 2.139 +(is started with the name)4.639 F F5(rbash)4.638 E F1 4.638(,o)C 4.638 +(rt)-4.638 G(he)-4.638 E F54.638 E F1 2.138 (option is supplied at invocation, the shell)4.638 F .618(becomes r)108 225.6 R 3.118(estricted. A)-.18 F -.18(re)3.118 G .618 (stricted shell is used to set up an envir).18 F .618(onment mor)-.18 F 3.118(ec)-.18 G(ontr)-3.118 E .618(olled than the)-.18 F(standar)108 -237.6 Q 4.197(ds)-.18 G 4.197(hell. It)-4.197 F 1.697 +237.6 Q 4.198(ds)-.18 G 4.198(hell. It)-4.198 F 1.697 (behaves identically to)4.197 F F5(bash)4.197 E F1 1.697 -(with the exception that the following ar)4.197 F 4.198(ed)-.18 G(isal-) --4.198 E(lowed or not performed:)108 249.6 Q 29.94<8363>108 266.4 S +(with the exception that the following ar)4.197 F 4.197(ed)-.18 G(isal-) +-4.197 E(lowed or not performed:)108 249.6 Q 29.94<8363>108 266.4 S (hanging dir)-29.94 E(ectories with)-.18 E F5(cd)2.5 E F1 29.94<8373>108 283.2 S(etting or unsetting the values of)-29.94 E F5(SHELL)2.5 E F1(,)A F5 -.74(PA)2.5 G(TH)-.18 E F1(,)A F5(ENV)2.5 E F1 2.5(,o)C(r)-2.5 E F5 @@ -7300,10 +7305,10 @@ F5 -.74(PA)2.5 G(TH)-.18 E F1(,)A F5(ENV)2.5 E F1 2.5(,o)C(r)-2.5 E F5 (pecifying command names containing)-29.94 E F5(/)2.5 E F1 29.94<8373> 108 316.8 S(pecifying a \214le name containing a)-29.94 E F5(/)2.5 E F1 (as an ar)2.5 E(gument to the)-.18 E F5(.)2.5 E F1(builtin command)5 E -29.94<8353>108 333.6 S 1.565 +29.94<8353>108 333.6 S 1.564 (pecifying a \214lename containing a slash as an ar)-29.94 F 1.565 -(gument to the)-.18 F F54.064 E F1 1.564(option to the)4.064 F F5 -(hash)4.064 E F1(builtin command)144 345.6 Q 29.94<8369>108 362.4 S +(gument to the)-.18 F F54.065 E F1 1.565(option to the)4.065 F F5 +(hash)4.065 E F1(builtin command)144 345.6 Q 29.94<8369>108 362.4 S (mporting function de\214nitions fr)-29.94 E(om the shell envir)-.18 E (onment at startup)-.18 E 29.94<8370>108 379.2 S(arsing the value of) -29.94 E F5(SHELLOPTS)2.5 E F1(fr)2.5 E(om the shell envir)-.18 E @@ -7314,7 +7319,7 @@ F5 -.74(PA)2.5 G(TH)-.18 E F1(,)A F5(ENV)2.5 E F1 2.5(,o)C(r)-2.5 E F5 (eplace the shell with another command)-.18 E 29.94<8361>108 429.6 S 1.208(dding or deleting builtin commands with the)-29.94 F F53.708 E F1(and)3.708 E F53.708 E F1 1.208(options to the)3.708 F F5 -(enable)3.708 E F1(builtin)3.708 E(command)144 441.6 Q 29.94<8355>108 +(enable)3.707 E F1(builtin)3.707 E(command)144 441.6 Q 29.94<8355>108 458.4 S(sing the)-29.94 E F5(enable)2.5 E F1 (builtin command to enable disabled shell builtins)2.5 E 29.94<8373>108 475.2 S(pecifying the)-29.94 E F52.5 E F1(option to the)2.5 E F5 @@ -7340,8 +7345,8 @@ F4(sh)108 614.4 Q F1(\(1\),)A F4(ksh)2.5 E F1(\(1\),)A F4(csh)2.5 E F1 (/bin/bash)109.666 667.2 Q F1(The)144 679.2 Q F5(bash)2.5 E F1 (executable)2.5 E F4(/etc/pr)109.666 691.2 Q(o\214le)-.18 E F1 (The systemwide initialization \214le, executed for login shells)144 -703.2 Q F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G -(005 Feb 19)-124.42 E(63)199 E 0 Cg EP +703.2 Q F0(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G +(005 Mar 15)-123.59 E(63)198.17 E 0 Cg EP %%Page: 64 65 %%BeginPageSetup BP @@ -7369,11 +7374,11 @@ hell exits)144 144 Q F1(~/.inputr)109.666 156 Q(c)-.18 E F2(Individual) (ftp://ftp.gnu.or)108 290.4 Q(g/pub/bash/)-.18 E F2(.)A .558 (Once you have determined that a bug actually exists, use the)108 307.2 R F1(bashbug)3.188 E F2 .558(command to submit a bug)3.538 F -.18(re)108 -319.2 S 3.162(port. If).18 F .662(you have a \214x, you ar)3.162 F 3.162 -(ee)-.18 G .662(ncouraged to mail that as well!)-3.162 F .661 -(Suggestions and `philosophi-)5.662 F 3.73(cal' bug r)108 331.2 R 3.731 +319.2 S 3.161(port. If).18 F .662(you have a \214x, you ar)3.161 F 3.162 +(ee)-.18 G .662(ncouraged to mail that as well!)-3.162 F .662 +(Suggestions and `philosophi-)5.662 F 3.731(cal' bug r)108 331.2 R 3.731 (eports may be mailed to)-.18 F F1(bug-bash@gnu.or)6.231 E(g)-.18 E F2 -3.731(or posted to the Usenet newsgr)6.231 F(oup)-.18 E F4(gnu.bash.bug) +3.73(or posted to the Usenet newsgr)6.231 F(oup)-.18 E F4(gnu.bash.bug) 108 343.2 Q F2(.)A(ALL bug r)108 360 Q(eports should include:)-.18 E (The version number of)108 376.8 Q F4(bash)2.5 E F2(The har)108 388.8 Q (dwar)-.18 E 2.5(ea)-.18 G(nd operating system)-2.5 E @@ -7382,38 +7387,38 @@ R F1(bashbug)3.188 E F2 .558(command to submit a bug)3.538 F -.18(re)108 (hort script or `r)-2.5 E(ecipe' which exer)-.18 E(cises the bug)-.18 E F1(bashbug)108.13 441.6 Q F2 1.316(inserts the \214rst thr)4.296 F 1.316 (ee items automatically into the template it pr)-.18 F 1.316 -(ovides for \214ling a bug)-.18 F -.18(re)108 453.6 S(port.).18 E 7.697 +(ovides for \214ling a bug)-.18 F -.18(re)108 453.6 S(port.).18 E 7.698 (Comments and bug r)108 470.4 R 7.697 -(eports concerning this manual page should be dir)-.18 F 7.698(ected to) +(eports concerning this manual page should be dir)-.18 F 7.697(ected to) -.18 F F1(chet@po.CWRU.Edu)108 482.4 Q F2(.).06 E F3(BUGS)72 499.2 Q F2 -(It's too big and too slow)108 511.2 Q(.)-.92 E(Ther)108 528 Q 2.833(ea) --.18 G .693 -.18(re s)-2.833 H .332(ome subtle dif).18 F(fer)-.18 E .332 +(It's too big and too slow)108 511.2 Q(.)-.92 E(Ther)108 528 Q 2.832(ea) +-.18 G .692 -.18(re s)-2.832 H .332(ome subtle dif).18 F(fer)-.18 E .332 (ences between)-.18 F F4(bash)2.832 E F2 .332 -(and traditional versions of)2.832 F F4(sh)2.832 E F2 2.832(,m)C .332 +(and traditional versions of)2.832 F F4(sh)2.832 E F2 2.832(,m)C .333 (ostly because of)-2.832 F(the)108 540 Q/F5 9/Palatino-Bold@0 SF(POSIX) 2.5 E F2(speci\214cation.)2.25 E(Aliases ar)108 556.8 Q 2.5(ec)-.18 G (onfusing in some uses.)-2.5 E(Shell builtin commands and functions ar) -108 573.6 Q 2.5(en)-.18 G(ot stoppable/r)-2.5 E(estartable.)-.18 E .462 +108 573.6 Q 2.5(en)-.18 G(ot stoppable/r)-2.5 E(estartable.)-.18 E .463 (Compound commands and command sequences of the form `a ; b ; c' ar)108 -590.4 R 2.963(en)-.18 G .463(ot handled gracefully)-2.963 F 1.257 +590.4 R 2.962(en)-.18 G .462(ot handled gracefully)-2.962 F 1.256 (when pr)108 602.4 R 1.257(ocess suspension is attempted.)-.18 F 1.257 (When a pr)6.257 F 1.257(ocess is stopped, the shell immediately exe-) --.18 F .373(cutes the next command in the sequence.)108 614.4 R .373 -(It suf)5.373 F .374(\214ces to place the sequence of commands between) +-.18 F .374(cutes the next command in the sequence.)108 614.4 R .373 +(It suf)5.373 F .373(\214ces to place the sequence of commands between) -.18 F(par)108 626.4 Q(entheses to for)-.18 E -(ce it into a subshell, which may be stopped as a unit.)-.18 E .951 +(ce it into a subshell, which may be stopped as a unit.)-.18 E .95 (Commands inside of)108 643.2 R F4($\()3.451 E F2(...)A F4(\))A F2 .951 (command substitution ar)3.451 F 3.451(en)-.18 G .951 -(ot parsed until substitution is attempted.)-3.451 F 2.131 -(This will delay err)108 655.2 R 2.131(or r)-.18 F 2.131 -(eporting until some time after the command is enter)-.18 F 4.632 -(ed. For)-.18 F(example,)4.632 E .431(unmatched par)108 667.2 R .431 +(ot parsed until substitution is attempted.)-3.451 F 2.132 +(This will delay err)108 655.2 R 2.132(or r)-.18 F 2.131 +(eporting until some time after the command is enter)-.18 F 4.631 +(ed. For)-.18 F(example,)4.631 E .43(unmatched par)108 667.2 R .431 (entheses, even inside shell comments, will r)-.18 F .431(esult in err) --.18 F .43(or messages while the con-)-.18 F(str)108 679.2 Q +-.18 F .431(or messages while the con-)-.18 F(str)108 679.2 Q (uct is being r)-.08 E(ead.)-.18 E (Array variables may not \(yet\) be exported.)108 696 Q F0 -(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 124.42(l2).15 G(005 Feb 19) --124.42 E(64)199 E 0 Cg EP +(GNU Bash-3.1-de)72 768 Q -.15(ve)-.25 G 123.59(l2).15 G(005 Mar 15) +-123.59 E(64)198.17 E 0 Cg EP %%Trailer end %%EOF diff --git a/doc/bashref.dvi b/doc/bashref.dvi index 9d89da2cf..4fc383089 100644 Binary files a/doc/bashref.dvi and b/doc/bashref.dvi differ diff --git a/doc/bashref.html b/doc/bashref.html index af3fcbf15..af584e5f9 100644 --- a/doc/bashref.html +++ b/doc/bashref.html @@ -1,6 +1,6 @@ - +