diff options
| author | Chet Ramey <chet@caleb.ins.cwru.edu> | 2012-08-13 11:56:43 -0400 |
|---|---|---|
| committer | Chet Ramey <chet@caleb.ins.cwru.edu> | 2012-08-13 11:56:43 -0400 |
| commit | aaf6036e86e8abdcd6888dc2099d0af503006d69 (patch) | |
| tree | ed6bfc8979cc6a49799a8663051f8ad095fc3020 | |
| parent | 49cf78286e41b8b509347f1429bf34c5c83ed742 (diff) | |
| download | bash-aaf6036e86e8abdcd6888dc2099d0af503006d69.tar.gz | |
commit bash-20120720 snapshot
| -rw-r--r-- | doc/bash.0 | 623 | ||||
| -rw-r--r-- | doc/bash.html | 12 | ||||
| -rw-r--r-- | doc/bash.pdf | bin | 303011 -> 306941 bytes | |||
| -rw-r--r-- | doc/bash.ps | 1366 | ||||
| -rw-r--r-- | doc/bashref.dvi | bin | 708852 -> 709392 bytes | |||
| -rw-r--r-- | doc/bashref.html | 18 | ||||
| -rw-r--r-- | doc/bashref.info | 273 | ||||
| -rw-r--r-- | doc/bashref.log | 22 | ||||
| -rw-r--r-- | doc/bashref.pdf | bin | 505876 -> 456864 bytes | |||
| -rw-r--r-- | doc/bashref.ps | 880 | ||||
| -rw-r--r-- | doc/builtins.0 | 575 | ||||
| -rw-r--r-- | doc/builtins.ps | 941 | ||||
| -rw-r--r-- | doc/rbash.ps | 2 |
13 files changed, 2394 insertions, 2318 deletions
@@ -4851,21 +4851,28 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS applies to the shell environment and each subshell envi- ronment separately (see CCOOMMMMAANNDD EEXXEECCUUTTIIOONN EENNVVIIRROONNMMEENNTT above), and may cause subshells to exit before executing - all the commands in the subshell. + all the commands in the subshell. If a shell function + executes in a context where --ee is being ignored, even if + --ee is set, none of the commands executed within the + function body will be affected by the --ee setting. If a + shell function sets --ee while executing in a context + where --ee is ignored, that setting will not have any + effect until the command containing the function call + completes. --ff Disable pathname expansion. - --hh Remember the location of commands as they are looked up + --hh Remember the location of commands as they are looked up for execution. This is enabled by default. - --kk All arguments in the form of assignment statements are - placed in the environment for a command, not just those + --kk All arguments in the form of assignment statements are + placed in the environment for a command, not just those that precede the command name. - --mm Monitor mode. Job control is enabled. This option is - on by default for interactive shells on systems that - support it (see JJOOBB CCOONNTTRROOLL above). All processes run + --mm Monitor mode. Job control is enabled. This option is + on by default for interactive shells on systems that + support it (see JJOOBB CCOONNTTRROOLL above). All processes run in a separate process group. When a background job com- pletes, the shell prints a line containing its exit sta- tus. --nn Read commands but do not execute them. This may be used - to check a shell script for syntax errors. This is + to check a shell script for syntax errors. This is ignored by interactive shells. --oo _o_p_t_i_o_n_-_n_a_m_e The _o_p_t_i_o_n_-_n_a_m_e can be one of the following: @@ -4873,10 +4880,10 @@ 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. This also affects the + the ----nnooeeddiittiinngg option. This also affects the editing interface used for rreeaadd --ee. eerrrreexxiitt Same as --ee. eerrrrttrraaccee @@ -4890,8 +4897,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. @@ -4906,335 +4913,335 @@ 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 - operation differs from the POSIX standard to + ppoossiixx Change the behavior of bbaasshh where the default + operation differs from the POSIX standard to match the standard (_p_o_s_i_x _m_o_d_e). pprriivviilleeggeedd Same as --pp. vveerrbboossee Same as --vv. - vvii Use a vi-style command line editing interface. + vvii Use a vi-style command line editing interface. This also affects the editing interface used for rreeaadd --ee. xxttrraaccee Same as --xx. If --oo is supplied with no _o_p_t_i_o_n_-_n_a_m_e, the values of the - current options are printed. If ++oo is supplied with no - _o_p_t_i_o_n_-_n_a_m_e, a series of sseett commands to recreate the - current option settings is displayed on the standard + current options are printed. If ++oo is supplied with no + _o_p_t_i_o_n_-_n_a_m_e, a series of sseett commands to recreate the + current option settings is displayed on the standard output. - --pp Turn on _p_r_i_v_i_l_e_g_e_d mode. In this mode, the $$EENNVV and - $$BBAASSHH__EENNVV files are not processed, shell functions are - not inherited from the environment, and the SSHHEELLLLOOPPTTSS, - BBAASSHHOOPPTTSS, CCDDPPAATTHH, and GGLLOOBBIIGGNNOORREE variables, if they + --pp Turn on _p_r_i_v_i_l_e_g_e_d mode. In this mode, the $$EENNVV and + $$BBAASSHH__EENNVV files are not processed, shell functions are + not inherited from the environment, and the SSHHEELLLLOOPPTTSS, + BBAASSHHOOPPTTSS, CCDDPPAATTHH, and GGLLOOBBIIGGNNOORREE variables, if they appear in the environment, are ignored. If the shell is - started with the effective user (group) id not equal to - the real user (group) id, and the --pp option is not sup- + started with the effective user (group) id not equal to + the real user (group) id, and the --pp option is not sup- plied, these actions are taken and the effective user id - is set to the real user id. If the --pp option is sup- - plied at startup, the effective user id is not reset. - Turning this option off causes the effective user and + is set to the real user id. If the --pp option is sup- + plied at startup, the effective user id is not reset. + Turning this option off causes the effective user and group ids to be set to the real user and group ids. --tt Exit after reading and executing one command. --uu Treat unset variables and parameters other than the spe- - cial parameters "@" and "*" as an error when performing - parameter expansion. If expansion is attempted on an - unset variable or parameter, the shell prints an error - message, and, if not interactive, exits with a non-zero + cial parameters "@" and "*" as an error when performing + parameter expansion. If expansion is attempted on an + unset variable or parameter, the shell prints an error + message, and, if not interactive, exits with a non-zero status. --vv Print shell input lines as they are read. - --xx After expanding each _s_i_m_p_l_e _c_o_m_m_a_n_d, ffoorr command, ccaassee + --xx After expanding each _s_i_m_p_l_e _c_o_m_m_a_n_d, ffoorr command, ccaassee command, sseelleecctt command, or arithmetic ffoorr command, dis- - play the expanded value of PPSS44, followed by the command + play the expanded value of PPSS44, followed by the command and its expanded arguments or associated word list. - --BB The shell performs brace expansion (see BBrraaccee EExxppaannssiioonn + --BB The shell performs brace expansion (see BBrraaccee EExxppaannssiioonn above). This is on by default. - --CC If set, bbaasshh does not overwrite an existing file with - the >>, >>&&, and <<>> redirection operators. This may be + --CC If set, bbaasshh does not overwrite an existing file with + the >>, >>&&, and <<>> redirection operators. This may be overridden when creating output files by using the redi- rection operator >>|| instead of >>. --EE If set, any trap on EERRRR is inherited by shell functions, - command substitutions, and commands executed in a sub- - shell environment. The EERRRR trap is normally not inher- + command substitutions, and commands executed in a sub- + shell environment. The EERRRR trap is normally not inher- ited in such cases. --HH Enable !! style history substitution. This option is on by default when the shell is interactive. - --PP If set, the shell does not resolve symbolic links when - executing commands such as ccdd that change the current + --PP If set, the shell does not resolve symbolic links when + executing commands such as ccdd that change the current working directory. It uses the physical directory structure instead. By default, bbaasshh follows the logical - chain of directories when performing commands which + chain of directories when performing commands which change the current directory. - --TT If set, any traps on DDEEBBUUGG and RREETTUURRNN are inherited by - shell functions, command substitutions, and commands - executed in a subshell environment. The DDEEBBUUGG and + --TT If set, any traps on DDEEBBUUGG and RREETTUURRNN are inherited by + shell functions, command substitutions, and commands + executed in a subshell environment. The DDEEBBUUGG and RREETTUURRNN traps are normally not inherited in such cases. - ---- If no arguments follow this option, then the positional + ---- If no arguments follow this option, then the positional parameters are unset. Otherwise, the positional parame- - ters are set to the _a_r_gs, even if some of them begin + ters are set to the _a_r_gs, even if some of them begin with a --. - -- Signal the end of options, cause all remaining _a_r_gs to + -- Signal the end of options, cause all remaining _a_r_gs to be assigned to the positional parameters. The --xx and --vv options are turned off. If there are no _a_r_gs, the posi- tional parameters remain unchanged. - The options are off by default unless otherwise noted. Using + - rather than - causes these options to be turned off. The - options can also be specified as arguments to an invocation of - the shell. The current set of options may be found in $$--. The + The options are off by default unless otherwise noted. Using + + rather than - causes these options to be turned off. The + options can also be specified as arguments to an invocation of + the shell. The current set of options may be found in $$--. The return status is always true unless an invalid option is encoun- tered. sshhiifftt [_n] - The positional parameters from _n+1 ... are renamed to $$11 ........ - Parameters represented by the numbers $$## down to $$##-_n+1 are - unset. _n must be a non-negative number less than or equal to - $$##. If _n is 0, no parameters are changed. If _n is not given, - it is assumed to be 1. If _n is greater than $$##, the positional - parameters are not changed. The return status is greater than + The positional parameters from _n+1 ... are renamed to $$11 ........ + Parameters represented by the numbers $$## down to $$##-_n+1 are + unset. _n must be a non-negative number less than or equal to + $$##. If _n is 0, no parameters are changed. If _n is not given, + it is assumed to be 1. If _n is greater than $$##, the positional + parameters are not changed. The return status is greater than zero if _n is greater than $$## or less than zero; otherwise 0. sshhoopptt [--ppqqssuu] [--oo] [_o_p_t_n_a_m_e ...] Toggle the values of 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, sshhoopptt - shows only those options which are set or unset, respectively. - Unless otherwise noted, the sshhoopptt options are disabled (unset) + If either --ss or --uu is used with no _o_p_t_n_a_m_e arguments, sshhoopptt + shows only those options which are set or unset, respectively. + Unless otherwise noted, the sshhoopptt options are disabled (unset) by default. - The return status when listing options is zero if all _o_p_t_n_a_m_e_s - are enabled, non-zero otherwise. When setting or unsetting - options, the return status is zero unless an _o_p_t_n_a_m_e is not a + The return status when listing options is zero if all _o_p_t_n_a_m_e_s + are enabled, non-zero otherwise. When setting or unsetting + options, the return status is zero unless an _o_p_t_n_a_m_e is not a valid shell option. The list of sshhoopptt options is: - aauuttooccdd If set, a command name that is the name of a directory - is executed as if it were the argument to the ccdd com- + aauuttooccdd If set, a command name that is the name of a directory + is executed as if it were the argument to the ccdd com- mand. This option is only used by interactive shells. ccddaabbllee__vvaarrss - If set, an argument to the ccdd builtin command that is - not a directory is assumed to be the name of a variable + If set, an argument to the ccdd builtin command that is + not a directory is assumed to be the name of a variable whose value is the directory to change to. ccddssppeellll If set, minor errors in the spelling of a directory com- - ponent in a ccdd command will be corrected. The errors + ponent in a ccdd command will be corrected. The errors checked for are transposed characters, a missing charac- - ter, and one character too many. If a correction is - found, the corrected filename is printed, and the com- - mand proceeds. This option is only used by interactive + ter, and one character too many. If a correction is + found, the corrected filename is printed, and the com- + mand proceeds. This option is only used by interactive shells. cchheecckkhhaasshh If set, bbaasshh checks that a command found in the hash ta- - ble exists before trying to execute it. If a hashed - command no longer exists, a normal path search is per- + ble exists before trying to execute it. If a hashed + command no longer exists, a normal path search is per- formed. cchheecckkjjoobbss If set, bbaasshh lists the status of any stopped and running - jobs before exiting an interactive shell. If any jobs + jobs before exiting an interactive shell. If any jobs are running, this causes the exit to be deferred until a - second exit is attempted without an intervening command - (see JJOOBB CCOONNTTRROOLL above). The shell always postpones + second exit is attempted without an intervening command + (see JJOOBB CCOONNTTRROOLL above). The shell always postpones exiting if any jobs are stopped. cchheecckkwwiinnssiizzee - If set, bbaasshh checks the window size after each command - and, if necessary, updates the values of LLIINNEESS and CCOOLL-- + If set, bbaasshh checks the window size after each command + and, if necessary, updates the values of LLIINNEESS and CCOOLL-- UUMMNNSS. - ccmmddhhiisstt If set, bbaasshh attempts to save all lines of a multiple- - line command in the same history entry. This allows + 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. ccoommppaatt3311 If set, bbaasshh changes its behavior to that of version 3.1 - with respect to quoted arguments to the [[[[ conditional + with respect to quoted arguments to the [[[[ conditional command's ==~~ operator and locale-specific string compar- - ison when using the [[[[ conditional command's << and >> - operators. Bash versions prior to bash-4.1 use ASCII + ison when using the [[[[ conditional command's << and >> + operators. Bash versions prior to bash-4.1 use ASCII collation and _s_t_r_c_m_p(3); bash-4.1 and later use the cur- rent locale's collation sequence and _s_t_r_c_o_l_l(3). ccoommppaatt3322 If set, bbaasshh changes its behavior to that of version 3.2 - with respect to locale-specific string comparison when - using the [[[[ conditional command's << and >> operators + with respect to locale-specific string comparison when + using the [[[[ conditional command's << and >> operators (see previous item). ccoommppaatt4400 If set, bbaasshh changes its behavior to that of version 4.0 - with respect to locale-specific string comparison when - using the [[[[ conditional command's << and >> operators - (see description of ccoommppaatt3311) and the effect of inter- - rupting a command list. Bash versions 4.0 and later - interrupt the list as if the shell received the inter- - rupt; previous versions continue with the next command + with respect to locale-specific string comparison when + using the [[[[ conditional command's << and >> operators + (see description of ccoommppaatt3311) and the effect of inter- + rupting a command list. Bash versions 4.0 and later + interrupt the list as if the shell received the inter- + rupt; previous versions continue with the next command in the list. ccoommppaatt4411 - If set, bbaasshh, when in posix mode, treats a single quote - in a double-quoted parameter expansion as a special - character. The single quotes must match (an even num- - ber) and the characters between the single quotes are - considered quoted. This is the behavior of posix mode - through version 4.1. The default bash behavior remains + If set, bbaasshh, when in posix mode, treats a single quote + in a double-quoted parameter expansion as a special + character. The single quotes must match (an even num- + ber) and the characters between the single quotes are + considered quoted. This is the behavior of posix mode + through version 4.1. The default bash behavior remains as in previous versions. ccoommpplleettee__ffuullllqquuoottee - If set, bbaasshh quotes all shell metacharacters in file- - names and directory names when performing completion. + If set, bbaasshh quotes all shell metacharacters in file- + names and directory names when performing completion. If not set, bbaasshh removes metacharacters such as the dol- - lar sign from the set of characters that will be quoted - in completed filenames when these metacharacters appear - in shell variable references in words to be completed. - This means that dollar signs in variable names that - expand to directories will not be quoted; however, any - dollar signs appearing in filenames will not be quoted, - either. This is active only when bash is using back- - slashes to quote completed filenames. This variable is - set by default, which is the default bash behavior in + lar sign from the set of characters that will be quoted + in completed filenames when these metacharacters appear + in shell variable references in words to be completed. + This means that dollar signs in variable names that + expand to directories will not be quoted; however, any + dollar signs appearing in filenames will not be quoted, + either. This is active only when bash is using back- + slashes to quote completed filenames. This variable is + set by default, which is the default bash behavior in versions through 4.2. ddiirreexxppaanndd - If set, bbaasshh replaces directory names with the results - of word expansion when performing filename completion. + If set, bbaasshh replaces directory names with the results + of word expansion when performing filename completion. This changes the contents of the readline editing - buffer. If not set, bbaasshh attempts to preserve what the + buffer. If not set, bbaasshh attempts to preserve what the user typed. ddiirrssppeellll - If set, bbaasshh attempts spelling correction on directory - names during word completion if the directory name ini- + If set, bbaasshh attempts spelling correction on directory + names during word completion if the directory name ini- tially supplied does not exist. - ddoottgglloobb If set, bbaasshh includes filenames beginning with a `.' in + 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 EERRRR trap. eexxttgglloobb If set, the extended pattern matching features described above under PPaatthhnnaammee EExxppaannssiioonn are enabled. eexxttqquuoottee - If set, $$'_s_t_r_i_n_g' and $$"_s_t_r_i_n_g" quoting is performed - within $${{_p_a_r_a_m_e_t_e_r}} expansions enclosed in double + If set, $$'_s_t_r_i_n_g' and $$"_s_t_r_i_n_g" quoting is performed + within $${{_p_a_r_a_m_e_t_e_r}} expansions enclosed in double quotes. This option is enabled by default. ffaaiillgglloobb - If set, patterns which fail to match filenames during + If set, patterns which fail to match filenames during pathname expansion result in an expansion error. ffoorrccee__ffiiggnnoorree - If set, the suffixes specified by the FFIIGGNNOORREE shell - variable cause words to be ignored when performing word + If set, the suffixes specified by the FFIIGGNNOORREE shell + variable cause words to be ignored when performing word completion even if the ignored words are the only possi- ble completions. See SSHHEELLLL VVAARRIIAABBLLEESS above for a - description of FFIIGGNNOORREE. This option is enabled by + description of FFIIGGNNOORREE. This option is enabled by default. gglloobbaasscciiiirraannggeess - If set, range expressions used in pattern matching (see - PPaatttteerrnn MMaattcchhiinngg above) behave as if in the traditional + If set, range expressions used in pattern matching (see + PPaatttteerrnn MMaattcchhiinngg above) behave as if in the traditional C locale when performing comparisons. That is, the cur- - rent locale's collating sequence is not taken into - account, so bb will not collate between AA and BB, and - upper-case and lower-case ASCII characters will collate + rent locale's collating sequence is not taken into + account, so bb will not collate between AA and BB, and + upper-case and lower-case ASCII characters will collate together. gglloobbssttaarr If set, the pattern **** used in a pathname expansion con- - text will match all files and zero or more directories - and subdirectories. If the pattern is followed by a //, + text will match all files and zero or more directories + and subdirectories. If the pattern is followed by a //, only directories and subdirectories match. ggnnuu__eerrrrffmmtt If set, shell error messages are written in the standard GNU error message format. hhiissttaappppeenndd - If set, the history list is appended to the file named - by the value of the HHIISSTTFFIILLEE variable when the shell + If set, the history list is appended to the file named + by the value of the HHIISSTTFFIILLEE variable when the shell exits, rather than overwriting the file. hhiissttrreeeeddiitt - If set, and rreeaaddlliinnee is being used, a user is given the + If set, and rreeaaddlliinnee is being used, a user is given the opportunity to re-edit a failed history substitution. hhiissttvveerriiffyy - If set, and rreeaaddlliinnee is being used, the results of his- - tory substitution are not immediately passed to the - shell parser. Instead, the resulting line is loaded + If set, and rreeaaddlliinnee is being used, the results of his- + tory substitution are not immediately passed to the + shell parser. Instead, the resulting line is loaded into the rreeaaddlliinnee editing buffer, allowing further modi- fication. hhoossttccoommpplleettee If set, and rreeaaddlliinnee is being used, bbaasshh will attempt to - perform hostname completion when a word containing a @@ - is being completed (see CCoommpplleettiinngg under RREEAADDLLIINNEE + perform hostname completion when a word containing a @@ + is being completed (see CCoommpplleettiinngg under RREEAADDLLIINNEE above). This is enabled by default. hhuuppoonneexxiitt If set, bbaasshh will send SSIIGGHHUUPP to all jobs when an inter- active login shell exits. iinntteerraaccttiivvee__ccoommmmeennttss If set, allow a word beginning with ## to cause that word - and all remaining characters on that line to be ignored - in an interactive shell (see CCOOMMMMEENNTTSS above). This + and all remaining characters on that line to be ignored + in an interactive shell (see CCOOMMMMEENNTTSS above). This option is enabled by default. llaassttppiippee - If set, and job control is not active, the shell runs + If set, and job control is not active, the shell runs the last command of a pipeline not executed in the back- ground in the current shell environment. - lliitthhiisstt If set, and the ccmmddhhiisstt option is enabled, multi-line + lliitthhiisstt If set, and the ccmmddhhiisstt option is enabled, multi-line commands are saved to the history with embedded newlines rather than using semicolon separators where possible. 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-- @@ -5242,50 +5249,50 @@ 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 + Suspend the execution of this shell until it receives a SSIIGGCCOONNTT signal. A login shell cannot be suspended; the --ff option can be used to override this and force the suspension. The return sta- - tus is 0 unless the shell is a login shell and --ff is not sup- + tus is 0 unless the shell is a login shell and --ff is not sup- plied, or if job control is not enabled. tteesstt _e_x_p_r [[ _e_x_p_r ]] Return a status of 0 (true) or 1 (false) depending on the evalu- ation of the conditional expression _e_x_p_r. Each operator and op- - erand must be a separate argument. Expressions are composed of - the primaries described above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS. - tteesstt does not accept any options, nor does it accept and ignore + erand must be a separate argument. Expressions are composed of + the primaries described above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS. + tteesstt does not accept any options, nor does it accept and ignore an argument of ---- as signifying the end of options. - Expressions may be combined using the following operators, + Expressions may be combined using the following operators, listed in decreasing order of precedence. The evaluation - depends on the number of arguments; see below. Operator prece- + depends on the number of arguments; see below. Operator prece- dence is used when there are five or more arguments. !! _e_x_p_r True if _e_x_p_r is false. (( _e_x_p_r )) - Returns the value of _e_x_p_r. This may be used to override + Returns the value of _e_x_p_r. This may be used to override the normal precedence of operators. _e_x_p_r_1 -aa _e_x_p_r_2 True if both _e_x_p_r_1 and _e_x_p_r_2 are true. @@ -5302,63 +5309,63 @@ 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 The following conditions are applied in the order listed. - If the second argument is one of the binary conditional + If the second argument is one of the binary conditional operators listed above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS, the result of the expression is the result of the binary test - using the first and third arguments as operands. The --aa - and --oo operators are considered binary operators when - there are three arguments. If the first argument is !!, - the value is the negation of the two-argument test using + using the first and third arguments as operands. The --aa + and --oo operators are considered binary operators when + there are three arguments. If the first argument is !!, + the value is the negation of the two-argument test using the second and third arguments. If the first argument is exactly (( and the third argument is exactly )), the result - is the one-argument test of the second argument. Other- + is the one-argument test of the second argument. Other- wise, the expression is false. 4 arguments If the first argument is !!, the result is the negation of - the three-argument expression composed of the remaining + the three-argument expression composed of the remaining arguments. Otherwise, the expression is parsed and eval- - uated according to precedence using the rules listed + uated according to precedence using the rules listed above. 5 or more arguments - The expression is parsed and evaluated according to + The expression is parsed and evaluated according to precedence using the rules listed above. - When used with tteesstt or [[, the << and >> operators sort lexico- + When used with tteesstt or [[, the << and >> operators sort lexico- graphically using ASCII ordering. - ttiimmeess Print the accumulated user and system times for the shell and + ttiimmeess Print the accumulated user and system times for the shell and for processes run from the shell. The return status is 0. ttrraapp [--llpp] [[_a_r_g] _s_i_g_s_p_e_c ...] - The command _a_r_g is to be read and executed when the shell - receives signal(s) _s_i_g_s_p_e_c. If _a_r_g is absent (and there is a - single _s_i_g_s_p_e_c) or --, each specified signal is reset to its - original disposition (the value it had upon entrance to the - shell). If _a_r_g is the null string the signal specified by each - _s_i_g_s_p_e_c is ignored by the shell and by the commands it invokes. - If _a_r_g is not present and --pp has been supplied, then the trap - commands associated with each _s_i_g_s_p_e_c are displayed. If no - arguments are supplied or if only --pp is given, ttrraapp prints the - list of commands associated with each signal. The --ll option - causes the shell to print a list of signal names and their cor- - responding numbers. Each _s_i_g_s_p_e_c is either a signal name - defined in <_s_i_g_n_a_l_._h>, or a signal number. Signal names are + The command _a_r_g is to be read and executed when the shell + receives signal(s) _s_i_g_s_p_e_c. If _a_r_g is absent (and there is a + single _s_i_g_s_p_e_c) or --, each specified signal is reset to its + original disposition (the value it had upon entrance to the + shell). If _a_r_g is the null string the signal specified by each + _s_i_g_s_p_e_c is ignored by the shell and by the commands it invokes. + If _a_r_g is not present and --pp has been supplied, then the trap + commands associated with each _s_i_g_s_p_e_c are displayed. If no + arguments are supplied or if only --pp is given, ttrraapp prints the + list of commands associated with each signal. The --ll option + causes the shell to print a list of signal names and their cor- + responding numbers. Each _s_i_g_s_p_e_c is either a signal name + defined in <_s_i_g_n_a_l_._h>, or a signal number. Signal names are case insensitive and the SSIIGG prefix is optional. - If a _s_i_g_s_p_e_c is EEXXIITT (0) the command _a_r_g is executed on exit - from the shell. If a _s_i_g_s_p_e_c is DDEEBBUUGG, the command _a_r_g is exe- - cuted before every _s_i_m_p_l_e _c_o_m_m_a_n_d, _f_o_r command, _c_a_s_e command, - _s_e_l_e_c_t command, every arithmetic _f_o_r command, and before the - first command executes in a shell function (see SSHHEELLLL GGRRAAMMMMAARR - above). Refer to the description of the eexxttddeebbuugg option to the + If a _s_i_g_s_p_e_c is EEXXIITT (0) the command _a_r_g is executed on exit + from the shell. If a _s_i_g_s_p_e_c is DDEEBBUUGG, the command _a_r_g is exe- + cuted before every _s_i_m_p_l_e _c_o_m_m_a_n_d, _f_o_r command, _c_a_s_e command, + _s_e_l_e_c_t command, every arithmetic _f_o_r command, and before the + first command executes in a shell function (see SSHHEELLLL GGRRAAMMMMAARR + above). Refer to the description of the eexxttddeebbuugg option to the sshhoopptt builtin for details of its effect on the DDEEBBUUGG trap. If a _s_i_g_s_p_e_c is RREETTUURRNN, the command _a_r_g is executed each time a shell function or a script executed with the .. or ssoouurrccee builtins fin- @@ -5366,53 +5373,53 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS If a _s_i_g_s_p_e_c is EERRRR, the command _a_r_g is executed whenever a sim- ple 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 - command executed in a &&&& or |||| list, or if the command's return - value is being inverted via !!. These are the same conditions + 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 + command executed in a &&&& or |||| list, or if the command's return + value is being inverted via !!. These are the same conditions obeyed by the eerrrreexxiitt option. - Signals ignored upon entry to the shell cannot be trapped or - reset. Trapped signals that are not being ignored are reset to + Signals ignored upon entry to the shell cannot be trapped or + reset. Trapped signals that are not being ignored are reset to their original values in a subshell or subshell environment when - one is created. The return status is false if any _s_i_g_s_p_e_c is + one is created. The return status is false if any _s_i_g_s_p_e_c is invalid; otherwise ttrraapp returns true. ttyyppee [--aaffttppPP] _n_a_m_e [_n_a_m_e ...] - With no options, indicate how each _n_a_m_e would be interpreted if + With no options, indicate how each _n_a_m_e would be interpreted if used as a command name. If the --tt option is used, ttyyppee prints a - string which is one of _a_l_i_a_s, _k_e_y_w_o_r_d, _f_u_n_c_t_i_o_n, _b_u_i_l_t_i_n, or - _f_i_l_e if _n_a_m_e is an alias, shell reserved word, function, - builtin, or disk file, respectively. If the _n_a_m_e is not found, - then nothing is printed, and an exit status of false is - returned. If the --pp option is used, ttyyppee either returns the + string which is one of _a_l_i_a_s, _k_e_y_w_o_r_d, _f_u_n_c_t_i_o_n, _b_u_i_l_t_i_n, or + _f_i_l_e if _n_a_m_e is an alias, shell reserved word, function, + builtin, or disk file, respectively. If the _n_a_m_e is not found, + then nothing is printed, and an exit status of false is + returned. If the --pp option is used, ttyyppee either returns the name of the disk file that would be executed if _n_a_m_e were speci- fied as a command name, or nothing if ``type -t name'' would not - return _f_i_l_e. The --PP option forces a PPAATTHH search for each _n_a_m_e, + return _f_i_l_e. The --PP option forces a PPAATTHH search for each _n_a_m_e, even if ``type -t name'' would not return _f_i_l_e. If a command is hashed, --pp and --PP print the hashed value, which is not necessar- - ily the file that appears first in PPAATTHH. If the --aa option is - used, ttyyppee prints all of the places that contain an executable + ily the file that appears first in PPAATTHH. If the --aa option is + used, ttyyppee prints all of the places that contain an executable named _n_a_m_e. This includes aliases and functions, if and only if the --pp option is not also used. The table of hashed commands is - not consulted when using --aa. The --ff option suppresses shell + not consulted when using --aa. The --ff option suppresses shell function lookup, as with the ccoommmmaanndd builtin. ttyyppee returns true if all of the arguments are found, false if any are not found. uulliimmiitt [--HHSSTTaabbccddeeffiillmmnnppqqrrssttuuvvxx [_l_i_m_i_t]] - Provides control over the resources available to the shell and - to processes started by it, on systems that allow such control. + Provides control over the resources available to the shell and + to processes started by it, on systems that allow such control. The --HH and --SS options specify that the hard or soft limit is set - for the given resource. A hard limit cannot be increased by a - non-root user once it is set; a soft limit may be increased up - to the value of the hard limit. If neither --HH nor --SS is speci- + for the given resource. A hard limit cannot be increased by a + non-root user once it is set; a soft limit may be increased up + to the value of the hard limit. If neither --HH nor --SS is speci- fied, both the soft and hard limits are set. The value of _l_i_m_i_t can be a number in the unit specified for the resource or one of the special values hhaarrdd, ssoofftt, or uunnlliimmiitteedd, which stand for the - current hard limit, the current soft limit, and no limit, - respectively. If _l_i_m_i_t is omitted, the current value of the - soft limit of the resource is printed, unless the --HH option is + current hard limit, the current soft limit, and no limit, + respectively. If _l_i_m_i_t is omitted, the current value of the + soft limit of the resource is printed, unless the --HH option is given. When more than one resource is specified, the limit name and unit are printed before the value. Other options are inter- preted as follows: @@ -5421,11 +5428,11 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS --cc The maximum size of core files created --dd The maximum size of a process's data segment --ee The maximum scheduling priority ("nice") - --ff The maximum size of files written by the shell and its + --ff The maximum size of files written by the shell and its children --ii The maximum number of pending signals --ll The maximum size that may be locked into memory - --mm The maximum resident set size (many systems do not honor + --mm The maximum resident set size (many systems do not honor this limit) --nn The maximum number of open file descriptors (most systems do not allow this value to be set) @@ -5434,71 +5441,71 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS --rr The maximum real-time scheduling priority --ss The maximum stack size --tt The maximum amount of cpu time in seconds - --uu The maximum number of processes available to a single + --uu The maximum number of processes available to a single user - --vv The maximum amount of virtual memory available to the + --vv The maximum amount of virtual memory available to the shell and, on some systems, to its children --xx The maximum number of file locks --TT The maximum number of threads - If _l_i_m_i_t is given, and the --aa option is not used, _l_i_m_i_t is the - new value of the specified resource. If no option is given, - then --ff is assumed. Values are in 1024-byte increments, except - for --tt, which is in seconds; --pp, which is in units of 512-byte - blocks; and --TT, --bb, --nn, and --uu, which are unscaled values. The - return status is 0 unless an invalid option or argument is sup- + If _l_i_m_i_t is given, and the --aa option is not used, _l_i_m_i_t is the + new value of the specified resource. If no option is given, + then --ff is assumed. Values are in 1024-byte increments, except + for --tt, which is in seconds; --pp, which is in units of 512-byte + blocks; and --TT, --bb, --nn, and --uu, which are unscaled values. The + return status is 0 unless an invalid option or argument is sup- plied, or an error occurs while setting a new limit. uummaasskk [--pp] [--SS] [_m_o_d_e] The user file-creation mask is set to _m_o_d_e. If _m_o_d_e begins with - a digit, it is interpreted as an octal number; otherwise it is - interpreted as a symbolic mode mask similar to that accepted by - _c_h_m_o_d(1). If _m_o_d_e is omitted, the current value of the mask is - printed. The --SS option causes the mask to be printed in sym- - bolic form; the default output is an octal number. If the --pp + a digit, it is interpreted as an octal number; otherwise it is + interpreted as a symbolic mode mask similar to that accepted by + _c_h_m_o_d(1). If _m_o_d_e is omitted, the current value of the mask is + printed. The --SS option causes the mask to be printed in sym- + bolic form; the default output is an octal number. If the --pp option is supplied, and _m_o_d_e is omitted, the output is in a form that may be reused as input. The return status is 0 if the mode - was successfully changed or if no _m_o_d_e argument was supplied, + was successfully changed or if no _m_o_d_e argument was supplied, and false otherwise. uunnaalliiaass [-aa] [_n_a_m_e ...] - Remove each _n_a_m_e from the list of defined aliases. If --aa is - supplied, all alias definitions are removed. The return value + Remove each _n_a_m_e from the list of defined aliases. If --aa is + supplied, all alias definitions are removed. The return value is true unless a supplied _n_a_m_e is not a defined alias. uunnsseett [-ffvv] [-nn] [_n_a_m_e ...] - For each _n_a_m_e, remove the corresponding variable or function. + For each _n_a_m_e, remove the corresponding variable or function. If the --vv option is given, each _n_a_m_e refers to a shell variable, - and that variable is removed. Read-only variables may not be - unset. If --ff is specified, each _n_a_m_e refers to a shell func- - tion, and the function definition is removed. If the --nn option - is supplied, and _n_a_m_e is a variable with the _n_a_m_e_r_e_f attribute, - _n_a_m_e will be unset rather than the variable it references. --nn - has no effect if the --ff option is supplied. If no options are - supplied, each _n_a_m_e refers to a variable; if there is no vari- - able by that name, any function with that name is unset. Each - unset variable or function is removed from the environment - passed to subsequent commands. If any of CCOOMMPP__WWOORRDDBBRREEAAKKSS, RRAANN-- + and that variable is removed. Read-only variables may not be + unset. If --ff is specified, each _n_a_m_e refers to a shell func- + tion, and the function definition is removed. If the --nn option + is supplied, and _n_a_m_e is a variable with the _n_a_m_e_r_e_f attribute, + _n_a_m_e will be unset rather than the variable it references. --nn + has no effect if the --ff option is supplied. If no options are + supplied, each _n_a_m_e refers to a variable; if there is no vari- + able by that name, any function with that name is unset. Each + unset variable or function is removed from the environment + passed to subsequent commands. If any of CCOOMMPP__WWOORRDDBBRREEAAKKSS, RRAANN-- DDOOMM, SSEECCOONNDDSS, LLIINNEENNOO, HHIISSTTCCMMDD, FFUUNNCCNNAAMMEE, GGRROOUUPPSS, or DDIIRRSSTTAACCKK are unset, they lose their special properties, even if they are sub- sequently reset. The exit status is true unless a _n_a_m_e is read- only. 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 @@ -5507,16 +5514,16 @@ RREESSTTRRIICCTTEEDD SSHHEELLLL +o specifying command names containing // - +o specifying a filename containing a // as an argument to the .. + +o specifying a filename 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 >> redirect- @@ -5525,10 +5532,10 @@ RREESSTTRRIICCTTEEDD SSHHEELLLL +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 @@ -5538,14 +5545,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) @@ -5561,7 +5568,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 @@ -5575,14 +5582,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_/_g_n_u_/_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: @@ -5593,7 +5600,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 @@ -5610,10 +5617,10 @@ 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 - process is stopped, the shell immediately executes the next command in - the sequence. It suffices to place the sequence of commands between - parentheses to force it into a subshell, which may be stopped as a + handled gracefully when process suspension is attempted. When a + process is stopped, the shell immediately executes the next command in + the sequence. It suffices to place the sequence of commands between + parentheses to force it into a subshell, which may be stopped as a unit. Array variables may not (yet) be exported. @@ -5622,4 +5629,4 @@ BBUUGGSS -GNU Bash 4.2 2012 July 5 BASH(1) +GNU Bash 4.2 2012 July 14 BASH(1) diff --git a/doc/bash.html b/doc/bash.html index 89355f0b..2d841683 100644 --- a/doc/bash.html +++ b/doc/bash.html @@ -3,7 +3,7 @@ </HEAD> <BODY><TABLE WIDTH=100%> <TR> -<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2012 July 5<TH ALIGN=RIGHT width=33%>BASH(1) +<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2012 July 14<TH ALIGN=RIGHT width=33%>BASH(1) </TR> </TABLE> <BR><A HREF="#index">Index</A> @@ -11085,6 +11085,12 @@ separately (see </FONT> above), and may cause subshells to exit before executing all the commands in the subshell. +If a shell function executes in a context where <B>-e</B> is being ignored, +even if <B>-e</B> is set, none of the commands executed within the function +body will be affected by the <B>-e</B> setting. +If a shell function sets <B>-e</B> while executing in a context where +<B>-e</B> is ignored, that setting will not have any effect until the +command containing the function call completes. <DT><B>-f</B> <DD> @@ -13005,7 +13011,7 @@ There may be only one active coprocess at a time. <HR> <TABLE WIDTH=100%> <TR> -<TH ALIGN=LEFT width=33%>GNU Bash 4.2<TH ALIGN=CENTER width=33%>2012 July 5<TH ALIGN=RIGHT width=33%>BASH(1) +<TH ALIGN=LEFT width=33%>GNU Bash 4.2<TH ALIGN=CENTER width=33%>2012 July 14<TH ALIGN=RIGHT width=33%>BASH(1) </TR> </TABLE> <HR> @@ -13111,6 +13117,6 @@ There may be only one active coprocess at a time. </DL> <HR> This document was created by man2html from bash.1.<BR> -Time: 05 July 2012 20:43:10 EDT +Time: 16 July 2012 16:12:38 EDT </BODY> </HTML> diff --git a/doc/bash.pdf b/doc/bash.pdf Binary files differindex 919321ae..b16e0452 100644 --- a/doc/bash.pdf +++ b/doc/bash.pdf diff --git a/doc/bash.ps b/doc/bash.ps index 138d5c54..cde00bc9 100644 --- a/doc/bash.ps +++ b/doc/bash.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.19.2 -%%CreationDate: Thu Jul 5 20:43:03 2012 +%%CreationDate: Mon Jul 16 16:12:24 2012 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -329,7 +329,7 @@ F .474(xtended deb)-.15 F(ug-)-.2 E (~/.bashr)3.599 E(c)-.37 E F0 1.599(if the)4.409 F(shell is interacti) 144 698.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(GNU Bash 4.2)72 768 Q -(2012 July 5)151.505 E(1)205.665 E 0 Cg EP +(2012 July 14)149.005 E(1)203.165 E 0 Cg EP %%Page: 2 2 %%BeginPageSetup BP @@ -447,8 +447,8 @@ F(ariable)-.25 E F3 -.27(BA)108 708 S(SH_ENV).27 E F0 1.011(in the en) 1.01(alue as the)-.25 F(name of a \214le to read and e)108 720 Q -.15 (xe)-.15 G(cute.).15 E F1(Bash)5 E F0(beha)2.5 E -.15(ve)-.2 G 2.5(sa) .15 G 2.5(si)-2.5 G 2.5(ft)-2.5 G(he follo)-2.5 E(wing command were e) --.25 E -.15(xe)-.15 G(cuted:).15 E(GNU Bash 4.2)72 768 Q(2012 July 5) -151.505 E(2)205.665 E 0 Cg EP +-.25 E -.15(xe)-.15 G(cuted:).15 E(GNU Bash 4.2)72 768 Q(2012 July 14) +149.005 E(2)203.165 E 0 Cg EP %%Page: 3 3 %%BeginPageSetup BP @@ -580,7 +580,7 @@ F .388(wed by)-.25 F F3(blank)2.888 E F0 .388(-separated w)B .388 (simple command)2.676 F F0 .175(is its e)2.676 F .175 (xit status, or 128+)-.15 F F4(n)A F0 .175 (if the command is terminated by signal)3.508 F F4(n)2.675 E F0(.).24 E -(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(3)205.665 E 0 Cg EP +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(3)203.165 E 0 Cg EP %%Page: 4 4 %%BeginPageSetup BP @@ -688,7 +688,7 @@ Q F2 1.054(compound command)3.554 F F0 1.054(is one of the follo)3.554 F -3.553 F 1.026(separated from the rest of the command by one or more ne) 108 698.4 R 1.026(wlines, and may be follo)-.25 F 1.027(wed by a ne)-.25 F 1.027(wline in)-.25 F(place of a semicolon.)108 710.4 Q(GNU Bash 4.2) -72 768 Q(2012 July 5)151.505 E(4)205.665 E 0 Cg EP +72 768 Q(2012 July 14)149.005 E(4)203.165 E 0 Cg EP %%Page: 5 5 %%BeginPageSetup BP @@ -816,7 +816,7 @@ E F0(th parenthesized sube)A(xpression.)-.15 E .786 (ex)2.5 G(pr).2 E(ession2)-.37 E F0 -.35(Tr)180 716.4 S(ue if either).35 E F1 -.2(ex)2.5 G(pr).2 E(ession1)-.37 E F0(or)2.5 E F1 -.2(ex)2.5 G(pr) .2 E(ession2)-.37 E F0(is true.)2.52 E(GNU Bash 4.2)72 768 Q -(2012 July 5)151.505 E(5)205.665 E 0 Cg EP +(2012 July 14)149.005 E(5)203.165 E 0 Cg EP %%Page: 6 6 %%BeginPageSetup BP @@ -971,8 +971,8 @@ F .204(The e)5.204 F .204(xit status of the)-.15 F F1(while)2.704 E F0 (and)2.704 E F1(until)2.704 E F0 .205(commands is the e)2.704 F .205 (xit status of the last command)-.15 F -.15(exe)144 700.8 S(cuted in).15 E F2(list-2)2.5 E F0 2.5(,o)C 2.5(rz)-2.5 G(ero if none w)-2.5 E(as e) --.1 E -.15(xe)-.15 G(cuted.).15 E(GNU Bash 4.2)72 768 Q(2012 July 5) -151.505 E(6)205.665 E 0 Cg EP +-.1 E -.15(xe)-.15 G(cuted.).15 E(GNU Bash 4.2)72 768 Q(2012 July 14) +149.005 E(6)203.165 E 0 Cg EP %%Page: 7 7 %%BeginPageSetup BP @@ -1108,7 +1108,7 @@ F0 1.336(option is on by def)3.836 F 1.336(ault in)-.1 F(interacti)108 G(he)-2.974 E F2 .474(escape c)2.974 F(har)-.15 E(acter)-.15 E F0 5.474 (.I).73 G 2.974(tp)-5.474 G(reserv)-2.974 E .474(es the literal v)-.15 F .474(alue of the ne)-.25 F .475(xt character that)-.15 F(GNU Bash 4.2)72 -768 Q(2012 July 5)151.505 E(7)205.665 E 0 Cg EP +768 Q(2012 July 14)149.005 E(7)203.165 E 0 Cg EP %%Page: 8 8 %%BeginPageSetup BP @@ -1211,7 +1211,7 @@ F0(=[)A F3(value)A F0(])A(If)108 724.8 Q F3(value)3.023 E F0 .233 (is not gi)2.913 F -.15(ve)-.25 G .233(n, the v).15 F .232 (ariable is assigned the null string.)-.25 F(All)5.232 E F3(values)3.022 E F0(under)3.002 E .232(go tilde e)-.18 F .232(xpansion, parameter)-.15 -F(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(8)205.665 E 0 Cg EP +F(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(8)203.165 E 0 Cg EP %%Page: 9 9 %%BeginPageSetup BP @@ -1363,7 +1363,7 @@ F 2.614(ord. That)-.1 F .113(is, ")2.613 F F2($@)A F0 2.613("i)C 2.613 (the last part of the original w)144 720 R 2.837(ord. When)-.1 F .338 (there are no positional parameters, ")2.837 F F2($@)A F0 2.838("a)C(nd) -2.838 E F2($@)2.838 E F0 -.15(ex)2.838 G(pand).15 E(GNU Bash 4.2)72 768 -Q(2012 July 5)151.505 E(9)205.665 E 0 Cg EP +Q(2012 July 14)149.005 E(9)203.165 E 0 Cg EP %%Page: 10 10 %%BeginPageSetup BP @@ -1478,7 +1478,7 @@ E F0 1.243(The command currently being e)144 693.6 R -.15(xe)-.15 G (cuted, unless the shell is e).15 F -.15(xe)-.15 G 1.242(cuting a).15 F (command as the result of a trap, in which case it is the command e)144 705.6 Q -.15(xe)-.15 G(cuting at the time of the trap.).15 E -(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(10)200.665 E 0 Cg EP +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(10)198.165 E 0 Cg EP %%Page: 11 11 %%BeginPageSetup BP @@ -1586,8 +1586,8 @@ F0 4.052(,f)C 1.552(or menu completion.)-4.052 F 1.552(This v)6.552 F (ternal commands in).15 F -.2(vo)-.4 G -.1(ke).2 G 5.429(db).1 G 5.429 (yt)-5.429 G 2.929(he programmable completion f)-5.429 F 2.929 (acilities \(see)-.1 F F1(Pr)5.429 E(ogrammable)-.18 E(Completion)144 -714 Q F0(belo)2.5 E(w\).)-.25 E(GNU Bash 4.2)72 768 Q(2012 July 5) -151.505 E(11)200.665 E 0 Cg EP +714 Q F0(belo)2.5 E(w\).)-.25 E(GNU Bash 4.2)72 768 Q(2012 July 14) +149.005 E(11)198.165 E 0 Cg EP %%Page: 12 12 %%BeginPageSetup BP @@ -1697,8 +1697,8 @@ G 2.5(ti)-2.5 G 2.5(ss)-2.5 G(ubsequently reset.)-2.5 E F1(MA)108 678 Q es the system type on which)144 690 R F1(bash)3.398 E F0 .899(is e)3.398 F -.15(xe)-.15 G .899(cuting, in).15 F(the standard GNU)144 702 Q F4 (cpu-company-system)2.5 E F0 2.5(format. The)2.5 F(def)2.5 E -(ault is system-dependent.)-.1 E(GNU Bash 4.2)72 768 Q(2012 July 5) -151.505 E(12)200.665 E 0 Cg EP +(ault is system-dependent.)-.1 E(GNU Bash 4.2)72 768 Q(2012 July 14) +149.005 E(12)198.165 E 0 Cg EP %%Page: 13 13 %%BeginPageSetup BP @@ -1796,7 +1796,7 @@ Q -.65(w.)-.25 G F1 -.3(BA)108 657.6 S(SH_ENV).3 E F0 .505 (xpansion before being interpreted)-.15 F(as a \214lename.)144 705.6 Q F2 -.666(PA)5 G(TH)-.189 E F0 (is not used to search for the resultant \214lename.)2.25 E -(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(13)200.665 E 0 Cg EP +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(13)198.165 E 0 Cg EP %%Page: 14 14 %%BeginPageSetup BP @@ -1913,8 +1913,8 @@ ted to this size after writing it when a)5.87 F 1.245(shell e)144 708 R (Non-numeric v)6.244 F 1.244(alues and)-.25 F 1.021(numeric v)144 720 R 1.022(alues less than zero inhibit truncation.)-.25 F 1.022 (The shell sets the def)6.022 F 1.022(ault v)-.1 F 1.022(alue to the v) --.25 F 1.022(alue of)-.25 F(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E -(14)200.665 E 0 Cg EP +-.25 F 1.022(alue of)-.25 F(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E +(14)198.165 E 0 Cg EP %%Page: 15 15 %%BeginPageSetup BP @@ -2023,7 +2023,7 @@ ermines the collation order used when sorting the results of pathname e) (xpansion and pattern matching.)-.15 E F1(LC_MESSA)108 696 Q(GES)-.55 E F0(This v)144 708 Q(ariable determines the locale used to translate dou\ ble-quoted strings preceded by a)-.25 E F1($)2.5 E F0(.)A(GNU Bash 4.2) -72 768 Q(2012 July 5)151.505 E(15)200.665 E 0 Cg EP +72 768 Q(2012 July 14)149.005 E(15)198.165 E 0 Cg EP %%Page: 16 16 %%BeginPageSetup BP @@ -2143,7 +2143,7 @@ G(ogin shell.)-2.5 E F1(TIMEFORMA)108 672 Q(T)-.95 E F0 .826(The v)144 .712(alue or other information.)-.25 F .712(The escape sequences)5.712 F (and their meanings are as follo)144 720 Q (ws; the braces denote optional portions.)-.25 E(GNU Bash 4.2)72 768 Q -(2012 July 5)151.505 E(16)200.665 E 0 Cg EP +(2012 July 14)149.005 E(16)198.165 E 0 Cg EP %%Page: 17 17 %%BeginPageSetup BP @@ -2266,7 +2266,7 @@ F2(sub-)A(script)108 720 Q F0(]=)A F2(value)A F0 6.549(.T)C(he)-6.549 E F2(subscript)4.389 E F0 1.549(is treated as an arithmetic e)4.729 F 1.549(xpression that must e)-.15 F -.25(va)-.25 G 1.548 (luate to a number).25 F 6.548(.T)-.55 G(o)-7.348 E(GNU Bash 4.2)72 768 -Q(2012 July 5)151.505 E(17)200.665 E 0 Cg EP +Q(2012 July 14)149.005 E(17)198.165 E 0 Cg EP %%Page: 18 18 %%BeginPageSetup BP @@ -2412,7 +2412,7 @@ Q F2(Br)108.58 703.2 Q .606(ace e)-.15 F(xpansion)-.2 E F0 .606 (he)-2.915 E 2.28(form of an optional)108 727.2 R F2(pr)4.78 E(eamble) -.37 E F0 4.78(,f).18 G(ollo)-4.78 E 2.28 (wed by either a series of comma-separated strings or a sequence)-.25 F -(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(18)200.665 E 0 Cg EP +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(18)198.165 E 0 Cg EP %%Page: 19 19 %%BeginPageSetup BP @@ -2544,8 +2544,8 @@ F0 .167(or the \214rst)2.667 F F2(=)2.667 E F0 5.167(.I)C(n)-5.167 E 712.8 Q F3 -.666(PA)2.5 G(TH)-.189 E F4(,)A F3(MAILP)2.25 E -.855(AT) -.666 G(H).855 E F4(,)A F0(and)2.25 E F3(CDP)2.5 E -.855(AT)-.666 G(H) .855 E F4(,)A F0(and the shell assigns the e)2.25 E(xpanded v)-.15 E -(alue.)-.25 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(19)200.665 E 0 -Cg EP +(alue.)-.25 E(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(19)198.165 E +0 Cg EP %%Page: 20 20 %%BeginPageSetup BP @@ -2669,8 +2669,8 @@ F0 .558(and that result.)3.058 F .557(Note that a ne)5.557 F -.05(ga) -.15 G(ti).05 E .857 -.15(ve o)-.25 H -.25(ff).15 G .557(set must be).25 F(separated from the colon by at least one space to a)144 712.8 Q -.2 (vo)-.2 G(id being confused with the).2 E F1(:-)2.5 E F0 -.15(ex)2.5 G -(pansion.).15 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(20)200.665 E -0 Cg EP +(pansion.).15 E(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(20)198.165 +E 0 Cg EP %%Page: 21 21 %%BeginPageSetup BP @@ -2806,7 +2806,7 @@ E F1(pattern)2.66 E F0(be)2.66 E .16(gins with)-.15 F F2(/)2.66 E F0 (If)5.807 E F1(pattern)3.307 E F0(be)3.307 E .807(gins with)-.15 F F2(#) 3.307 E F0 3.306(,i)C 3.306(tm)-3.306 G .806(ust match at the be)-3.306 F .806(ginning of the e)-.15 F(xpanded)-.15 E(GNU Bash 4.2)72 768 Q -(2012 July 5)151.505 E(21)200.665 E 0 Cg EP +(2012 July 14)149.005 E(21)198.165 E 0 Cg EP %%Page: 22 22 %%BeginPageSetup BP @@ -2918,7 +2918,7 @@ F1 -.2(ex)2.665 G(pr).2 E(ession)-.37 E F0 .165 (If)5.879 E F1 -.2(ex)108 700.8 S(pr).2 E(ession)-.37 E F0(is in)2.74 E -.25(va)-.4 G(lid,).25 E F2(bash)2.5 E F0(prints a message indicating f) 2.5 E(ailure and no substitution occurs.)-.1 E(GNU Bash 4.2)72 768 Q -(2012 July 5)151.505 E(22)200.665 E 0 Cg EP +(2012 July 14)149.005 E(22)198.165 E 0 Cg EP %%Page: 23 23 %%BeginPageSetup BP @@ -3062,8 +3062,8 @@ R 1.12(NUL character may not occur in a pattern.)3.62 F 3.62(Ab)6.12 G (The special pattern characters must be quoted if the)5.576 F 3.076(ya) -.15 G(re)-3.076 E(to be matched literally)108 703.2 Q(.)-.65 E (The special pattern characters ha)108 720 Q .3 -.15(ve t)-.2 H -(he follo).15 E(wing meanings:)-.25 E(GNU Bash 4.2)72 768 Q(2012 July 5) -151.505 E(23)200.665 E 0 Cg EP +(he follo).15 E(wing meanings:)-.25 E(GNU Bash 4.2)72 768 Q +(2012 July 14)149.005 E(23)198.165 E 0 Cg EP %%Page: 24 24 %%BeginPageSetup BP @@ -3174,7 +3174,7 @@ stead be preceded by a w)108 709.2 R .772(ord of)-.1 F .293(the form {) 108 721.2 R F2(varname)A F0 2.793(}. In)B .293 (this case, for each redirection operator e)2.793 F .293 (xcept >&- and <&-, the shell will allocate)-.15 F(GNU Bash 4.2)72 768 Q -(2012 July 5)151.505 E(24)200.665 E 0 Cg EP +(2012 July 14)149.005 E(24)198.165 E 0 Cg EP %%Page: 25 25 %%BeginPageSetup BP @@ -3268,7 +3268,7 @@ F1(n)A F0(])A F2(>)A F1(wor)A(d)-.37 E F0 .154 1.76(ail if the \214le whose name results from the e)-.1 F 1.759 (xpansion of)-.15 F F1(wor)4.259 E(d)-.37 E F0 -.15(ex)4.259 G 1.759 (ists and is a re).15 F 1.759(gular \214le.)-.15 F 1.759(If the)6.759 F -(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(25)200.665 E 0 Cg EP +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(25)198.165 E 0 Cg EP %%Page: 26 26 %%BeginPageSetup BP @@ -3351,8 +3351,8 @@ E F0 2.5(,a)C(nd)-2.5 E F1<92>2.5 E F0(.)A .601 (ws here-documents within shell scripts to be indented in a natural f) -.25 E(ashion.)-.1 E F1(Her)87 693.6 Q 2.5(eS)-.18 G(trings)-2.5 E F0 2.5(Av)108 705.6 S(ariant of here documents, the format is:)-2.75 E F1 -(<<<)144 722.4 Q F2(wor)A(d)-.37 E F0(GNU Bash 4.2)72 768 Q(2012 July 5) -151.505 E(26)200.665 E 0 Cg EP +(<<<)144 722.4 Q F2(wor)A(d)-.37 E F0(GNU Bash 4.2)72 768 Q +(2012 July 14)149.005 E(26)198.165 E 0 Cg EP %%Page: 27 27 %%BeginPageSetup BP @@ -3463,7 +3463,7 @@ E(Aliases are created and listed with the)108 669.6 Q F2(alias)2.5 E F0 (shell option is set)3.72 F(using)108 727.2 Q F2(shopt)2.5 E F0 (\(see the description of)2.5 E F2(shopt)2.5 E F0(under)2.5 E F4 (SHELL B)2.5 E(UIL)-.09 E(TIN COMMANDS)-.828 E F0(belo)2.25 E(w\).)-.25 -E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(27)200.665 E 0 Cg EP +E(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(27)198.165 E 0 Cg EP %%Page: 28 28 %%BeginPageSetup BP @@ -3603,7 +3603,7 @@ F .205(gers with no)-.15 F .428(check for o)108 667.2 R -.15(ve)-.15 G 1.919(wing list of operators is)-.25 F(grouped into le)108 691.2 Q -.15 (ve)-.25 G(ls of equal-precedence operators.).15 E(The le)5 E -.15(ve) -.25 G(ls are listed in order of decreasing precedence.).15 E -(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(28)200.665 E 0 Cg EP +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(28)198.165 E 0 Cg EP %%Page: 29 29 %%BeginPageSetup BP @@ -3697,7 +3697,7 @@ F2(<)3.596 E F0(and)3.595 E F2(>)3.595 E F0 1.095(operators sort le) E F2(test)3.595 E F0(com-)3.595 E(mand sorts using ASCII ordering.)108 690 Q F2<ad61>108 714 Q F1(\214le)2.5 E F0 -.35(Tr)10.58 G(ue if).35 E F1(\214le)2.5 E F0 -.15(ex)2.5 G(ists.).15 E(GNU Bash 4.2)72 768 Q -(2012 July 5)151.505 E(29)200.665 E 0 Cg EP +(2012 July 14)149.005 E(29)198.165 E 0 Cg EP %%Page: 30 30 %%BeginPageSetup BP @@ -3795,7 +3795,7 @@ E F0(may be positi)2.52 E .3 -.15(ve o)-.25 H 2.5(rn).15 G -2.25 -.15 .613(When a simple command is e)108 712.8 R -.15(xe)-.15 G .614 (cuted, the shell performs the follo).15 F .614(wing e)-.25 F .614 (xpansions, assignments, and redi-)-.15 F(rections, from left to right.) -108 724.8 Q(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(30)200.665 E 0 +108 724.8 Q(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(30)198.165 E 0 Cg EP %%Page: 31 31 %%BeginPageSetup @@ -3919,7 +3919,7 @@ F(command ar)108 681.6 Q(guments, if an)-.18 E -.65(y.)-.15 G F4 (COMMAND EXECUTION ENVIR)72 698.4 Q(ONMENT)-.329 E F0(The shell has an) 108 710.4 Q F5 -.2(ex)2.5 G(ecution en).2 E(vir)-.4 E(onment)-.45 E F0 2.5(,w)C(hich consists of the follo)-2.5 E(wing:)-.25 E(GNU Bash 4.2)72 -768 Q(2012 July 5)151.505 E(31)200.665 E 0 Cg EP +768 Q(2012 July 14)149.005 E(31)198.165 E 0 Cg EP %%Page: 32 32 %%BeginPageSetup BP @@ -4033,7 +4033,7 @@ E F1(unset)2.801 E F0 .301(command, plus an)2.801 F 2.801(ya)-.15 G .301 729.6 R .563(vironment for an)-.4 F(y)-.15 E F3 .563(simple command) 3.403 F F0 .562 (or function may be augmented temporarily by pre\214xing it with)3.833 F -(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(32)200.665 E 0 Cg EP +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(32)198.165 E 0 Cg EP %%Page: 33 33 %%BeginPageSetup BP @@ -4163,8 +4163,8 @@ E F0 .784(with each pipeline.)3.514 F .784(It k)5.784 F .785 2.841 E F0 2.841(command. When)2.841 F F3(bash)2.841 E F0 .341 (starts a job asynchronously \(in the)2.841 F F4(bac)2.84 E(kgr)-.2 E (ound)-.45 E F0 .34(\), it prints a line).77 F(that looks lik)108 708 Q -(e:)-.1 E([1] 25647)144 724.8 Q(GNU Bash 4.2)72 768 Q(2012 July 5) -151.505 E(33)200.665 E 0 Cg EP +(e:)-.1 E([1] 25647)144 724.8 Q(GNU Bash 4.2)72 768 Q(2012 July 14) +149.005 E(33)198.165 E 0 Cg EP %%Page: 34 34 %%BeginPageSetup BP @@ -4301,8 +4301,8 @@ ized by inserting a number of backslash-escaped special characters that\ are)108 669.6 R(decoded as follo)108 681.6 Q(ws:)-.25 E F1(\\a)144 693.6 Q F0(an ASCII bell character \(07\))28.22 E F1(\\d)144 705.6 Q F0 (the date in "W)27.66 E(eekday Month Date" format \(e.g., "T)-.8 E -(ue May 26"\))-.45 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(34) -200.665 E 0 Cg EP +(ue May 26"\))-.45 E(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(34) +198.165 E 0 Cg EP %%Page: 35 35 %%BeginPageSetup BP @@ -4413,8 +4413,8 @@ F0 .463(In this section, the Emacs-style notation is used to denote k) 1.018(auses that command to act in a backw)-3.518 F 1.019 (ard direction.)-.1 F(Com-)6.019 E(mands whose beha)108 715.2 Q (vior with ar)-.2 E(guments de)-.18 E(viates from this are noted belo) --.25 E -.65(w.)-.25 G(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(35) -200.665 E 0 Cg EP +-.25 E -.65(w.)-.25 G(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(35) +198.165 E 0 Cg EP %%Page: 36 36 %%BeginPageSetup BP @@ -4521,8 +4521,8 @@ G(rsal\255ar).1 E(gument)-.1 E F0(.)A F1 .315(C\255x C\255r)5.155 F F0 (Function Key 1)2.5 E F0(.)A (The full set of GNU Emacs style escape sequences is)108 693.6 Q F2 <5c43ad>144 705.6 Q F0(control pre\214x)20.3 E F2<5c4dad>144 717.6 Q F0 -(meta pre\214x)18.08 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(36) -200.665 E 0 Cg EP +(meta pre\214x)18.08 E(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(36) +198.165 E 0 Cg EP %%Page: 37 37 %%BeginPageSetup BP @@ -4619,7 +4619,7 @@ n ellipsis when displaying possible completions.).25 E F1 -.15 F .561(alue greater than or)-.25 F .783(equal to zero.)144 729.6 R .783(If the number of possible completions is greater than or equal to \ the v)5.783 F .782(alue of this)-.25 F(GNU Bash 4.2)72 768 Q -(2012 July 5)151.505 E(37)200.665 E 0 Cg EP +(2012 July 14)149.005 E(37)198.165 E 0 Cg EP %%Page: 38 38 %%BeginPageSetup BP @@ -4727,8 +4727,8 @@ F .05(If this v)5.05 F .05(ariable is set to a v)-.25 F(alue)-.25 E .051 E F2 -.37(re)2.551 G(adline).37 E F0 .051(will w)2.551 F .051 (ait until another k)-.1 F .352 -.15(ey i)-.1 H 2.552(sp).15 G(ressed) -2.552 E(to decide which k)144 720 Q .3 -.15(ey s)-.1 H -(equence to complete.).15 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E -(38)200.665 E 0 Cg EP +(equence to complete.).15 E(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E +(38)198.165 E 0 Cg EP %%Page: 39 39 %%BeginPageSetup BP @@ -4829,7 +4829,8 @@ F0 .463(construct allo)2.963 F .462(ws bindings to be made based on the\ (sed to test whether readline is in emacs or vi)-3.711 F 3.065 (mode. This)180 722.4 R .565(may be used in conjunction with the)3.065 F F1 .565(set k)3.065 F(eymap)-.1 E F0 .565(command, for instance, to) -3.065 F(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(39)200.665 E 0 Cg EP +3.065 F(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(39)198.165 E 0 Cg +EP %%Page: 40 40 %%BeginPageSetup BP @@ -4931,8 +4932,8 @@ E F0 .911(refers to the current cursor position, and)3.411 F F1(mark) (db).15 G 3.41(yt)-3.41 G(he)-3.41 E F2(set\255mark)108 700.8 Q F0 2.5 (command. The)2.5 F(te)2.5 E (xt between the point and mark is referred to as the)-.15 E F1 -.37(re) -2.5 G(gion)-.03 E F0(.)A(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(40) -200.665 E 0 Cg EP +2.5 G(gion)-.03 E F0(.)A(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E +(40)198.165 E 0 Cg EP %%Page: 41 41 %%BeginPageSetup BP @@ -5008,7 +5009,7 @@ a non-incremental search for a string supplied by the)-.1 F(user)144 -.25 E F0 .249(Search forw)144 712.8 R .249(ard through the history for\ the string of characters between the start of the current line)-.1 F (and the point.)144 724.8 Q(This is a non-incremental search.)5 E -(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(41)200.665 E 0 Cg EP +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(41)198.165 E 0 Cg EP %%Page: 42 42 %%BeginPageSetup BP @@ -5113,7 +5114,7 @@ A F1(backward\255delete\255char \(Rubout\))108 604.8 Q F0 .552 (erbatim. This)-.15 F .779(is ho)3.279 F 3.279(wt)-.25 G 3.279(oi)-3.279 G .779(nsert characters lik)-3.279 F(e)-.1 E F1(C\255q)3.279 E F0 3.279 (,f)C(or)-3.279 E -.15(ex)144 700.8 S(ample.).15 E(GNU Bash 4.2)72 768 Q -(2012 July 5)151.505 E(42)200.665 E 0 Cg EP +(2012 July 14)149.005 E(42)198.165 E 0 Cg EP %%Page: 43 43 %%BeginPageSetup BP @@ -5208,7 +5209,7 @@ F 5.364(.T)-.65 G .364(he killed te)-5.364 F .364(xt is sa)-.15 F -.15 (ord behind point, using white space and the slash character as the w) -.1 F .167(ord boundaries.)-.1 F(The)5.167 E(killed te)144 712.8 Q (xt is sa)-.15 E -.15(ve)-.2 G 2.5(do).15 G 2.5(nt)-2.5 G(he kill-ring.) --2.5 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(43)200.665 E 0 Cg EP +-2.5 E(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(43)198.165 E 0 Cg EP %%Page: 44 44 %%BeginPageSetup BP @@ -5308,7 +5309,7 @@ F1(delete\255char\255or\255list)108 681.6 Q F0 .234 (ve)-.2 G 2.925(si).15 G .425(dentically to)-2.925 F F1 (possible\255completions)2.925 E F0 5.425(.T)C .425 (his command is unbound)-5.425 F(by def)144 717.6 Q(ault.)-.1 E -(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(44)200.665 E 0 Cg EP +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(44)198.165 E 0 Cg EP %%Page: 45 45 %%BeginPageSetup BP @@ -5394,7 +5395,7 @@ C(..\))-2.5 E F0 1.756(If the meta\214ed character)144 669.6 R F2(x) (e\214x\255meta \(ESC\))-.18 E F0(Metafy the ne)144 705.6 Q (xt character typed.)-.15 E/F3 9/Times-Bold@0 SF(ESC)5 E F1(f)2.25 E F0 (is equi)2.5 E -.25(va)-.25 G(lent to).25 E F1(Meta\255f)2.5 E F0(.)A -(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(45)200.665 E 0 Cg EP +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(45)198.165 E 0 Cg EP %%Page: 46 46 %%BeginPageSetup BP @@ -5497,8 +5498,8 @@ le completions.)2.5 E F1(glob\255expand\255w)108 504 Q(ord \(C\255x *\)) 3.093(utput. If)-3.093 F 3.093(an)3.093 G(umeric)-3.093 E(ar)144 708 Q .528(gument is supplied, the output is formatted in such a w)-.18 F .528 (ay that it can be made part of an)-.1 F F2(inputr)3.027 E(c)-.37 E F0 -(\214le.)144 720 Q(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(46) -200.665 E 0 Cg EP +(\214le.)144 720 Q(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(46) +198.165 E 0 Cg EP %%Page: 47 47 %%BeginPageSetup BP @@ -5637,7 +5638,7 @@ possible completions.)108 712.8 Q .247(If the pre)108 729.6 R .247 (viously-applied actions do not generate an)-.25 F 2.747(ym)-.15 G .247 (atches, and the)-2.747 F F1 .247(\255o dir)2.747 F(names)-.15 E F0 .247 (option w)2.747 F .246(as supplied to)-.1 F(GNU Bash 4.2)72 768 Q -(2012 July 5)151.505 E(47)200.665 E 0 Cg EP +(2012 July 14)149.005 E(47)198.165 E 0 Cg EP %%Page: 48 48 %%BeginPageSetup BP @@ -5768,7 +5769,7 @@ F0 3.257(lines. If)3.007 F F5(HISTFILESIZE)3.257 E F0 .757 (The b)108 727.2 R 1.294(uiltin command)-.2 F F1(fc)3.794 E F0(\(see) 3.794 E F5 1.293(SHELL B)3.794 F(UIL)-.09 E 1.293(TIN COMMANDS)-.828 F F0(belo)3.543 E 1.293(w\) may be used to list or edit and re-)-.25 F -(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(48)200.665 E 0 Cg EP +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(48)198.165 E 0 Cg EP %%Page: 49 49 %%BeginPageSetup BP @@ -5897,7 +5898,7 @@ F4(n)2.5 E F0(.).24 E F1<21ad>108 679.2 Q F4(n)A F0 (This is a synon)5 E(ym for `!\2551'.)-.15 E F1(!)108 703.2 Q F4(string) A F0 .865(Refer to the most recent command preceding the current positi\ on in the history list starting with)9.33 F F4(string)144 715.2 Q F0(.) -.22 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(49)200.665 E 0 Cg EP +.22 E(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(49)198.165 E 0 Cg EP %%Page: 50 50 %%BeginPageSetup BP @@ -6014,8 +6015,8 @@ F1<adad>2.82 E F0 5.319(.O)C .319(ther b)-5.319 F .319 108 724.8 R 1.143(guments be)-.18 F 1.143(ginning with)-.15 F F1<ad> 3.643 E F0 1.143(as in)3.643 F -.25(va)-.4 G 1.143 (lid options and require).25 F F1<adad>3.644 E F0 1.144(to pre)3.644 F --.15(ve)-.25 G 1.144(nt this).15 F(GNU Bash 4.2)72 768 Q(2012 July 5) -151.505 E(50)200.665 E 0 Cg EP +-.15(ve)-.25 G 1.144(nt this).15 F(GNU Bash 4.2)72 768 Q(2012 July 14) +149.005 E(50)198.165 E 0 Cg EP %%Page: 51 51 %%BeginPageSetup BP @@ -6138,7 +6139,7 @@ F0(Display)24.74 E F1 -.18(re)2.5 G(adline).18 E F0 -.1(ke)2.5 G 2.5(ys) (alues in such a w)-.25 E(ay that the)-.1 E 2.5(yc)-.15 G (an be re-read.)-2.5 E F1<ad56>144 697.2 Q F0(List current)23.08 E F1 -.18(re)2.5 G(adline).18 E F0 -.25(va)2.5 G(riable names and v).25 E -(alues.)-.25 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(51)200.665 E +(alues.)-.25 E(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(51)198.165 E 0 Cg EP %%Page: 52 52 %%BeginPageSetup @@ -6268,7 +6269,7 @@ F0 .744(is the \214rst ar)3.244 F .744 (orking directory is written to the standard output.)-3.194 F .594 (The return)5.594 F -.25(va)144 708 S(lue is true if the directory w).25 E(as successfully changed; f)-.1 E(alse otherwise.)-.1 E(GNU Bash 4.2)72 -768 Q(2012 July 5)151.505 E(52)200.665 E 0 Cg EP +768 Q(2012 July 14)149.005 E(52)198.165 E 0 Cg EP %%Page: 53 53 %%BeginPageSetup BP @@ -6385,7 +6386,7 @@ e compspec generates \214lenames, so it can perform an).7 F 2.637<798c> 2.634(ea)-.1 G .134(dding a slash to directory names, quoting spe-) -2.634 F .45(cial characters, or suppressing trailing spaces\).)224 729.6 R .45(Intended to be used with shell)5.45 F(GNU Bash 4.2)72 768 Q -(2012 July 5)151.505 E(53)200.665 E 0 Cg EP +(2012 July 14)149.005 E(53)198.165 E 0 Cg EP %%Page: 54 54 %%BeginPageSetup BP @@ -6461,7 +6462,7 @@ F0(option to the)2.5 E F1(set)2.5 E F0 -.2(bu)2.5 G(iltin.).2 E F1 .101(When it \214nishes, the possible completions are retrie)5.101 F -.15(ve)-.25 G 2.602(df).15 G .102(rom the v)-2.602 F .102(alue of the) -.25 F F3(COMPREPL)184 696 Q(Y)-.828 E F0(array v)2.25 E(ariable.)-.25 E -(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(54)200.665 E 0 Cg EP +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(54)198.165 E 0 Cg EP %%Page: 55 55 %%BeginPageSetup BP @@ -6588,7 +6589,7 @@ E F1<ad61>144 691.2 Q F0(Each)25.3 E F2(name)2.5 E F0(is an inde)2.5 E F0(Each)23.08 E F2(name)2.5 E F0(is an associati)2.5 E .3 -.15(ve a)-.25 H(rray v).15 E(ariable \(see)-.25 E F1(Arrays)2.5 E F0(abo)2.5 E -.15 (ve)-.15 G(\).).15 E F1<ad66>144 715.2 Q F0(Use function names only) -26.97 E(.)-.65 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(55)200.665 +26.97 E(.)-.65 E(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(55)198.165 E 0 Cg EP %%Page: 56 56 %%BeginPageSetup @@ -6723,8 +6724,8 @@ F0([)2.5 E F1(\255neE)A F0 2.5(][)C F3(ar)-2.5 E(g)-.37 E F0(...])2.5 E (error occurs.)144 720 R(If)6.824 E F1<ad6e>4.324 E F0 1.824 (is speci\214ed, the trailing ne)4.324 F 1.824(wline is suppressed.)-.25 F 1.825(If the)6.825 F F1<ad65>4.325 E F0 1.825(option is gi)4.325 F --.15(ve)-.25 G(n,).15 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(56) -200.665 E 0 Cg EP +-.15(ve)-.25 G(n,).15 E(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(56) +198.165 E 0 Cg EP %%Page: 57 57 %%BeginPageSetup BP @@ -6840,8 +6841,8 @@ F(ail-)-.1 E 2.505(ure. An)144 686.4 R(interacti)2.505 E .305 -.15(ve s) (edirections tak)-3.036 F 3.036(ee)-.1 G -.25(ff)-3.036 G .536 (ect in the current shell, and the return status is 0.).25 F .536 (If there is a redirection)5.536 F(error)144 710.4 Q 2.5(,t)-.4 G -(he return status is 1.)-2.5 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 -E(57)200.665 E 0 Cg EP +(he return status is 1.)-2.5 E(GNU Bash 4.2)72 768 Q(2012 July 14) +149.005 E(57)198.165 E 0 Cg EP %%Page: 58 58 %%BeginPageSetup BP @@ -6982,7 +6983,7 @@ F0 .803(The shell does not reset)5.303 F F3(OPTIND)3.303 E F0 .804 (reset between multiple calls to)144 715.2 R F1(getopts)2.793 E F0 .293 (within the same shell in)2.793 F -.2(vo)-.4 G .293(cation if a ne).2 F 2.793(ws)-.25 G .293(et of parameters)-2.793 F(is to be used.)144 727.2 -Q(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(58)200.665 E 0 Cg EP +Q(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(58)198.165 E 0 Cg EP %%Page: 59 59 %%BeginPageSetup BP @@ -7093,8 +7094,8 @@ F3(n)3.24 E F0 .38(lists only the last)3.12 F F3(n)3.24 E F0 2.88 (is supplied, it is used as the name of the history \214le; if)2.676 F (not, the v)144 715.2 Q(alue of)-.25 E F2(HISTFILE)2.5 E F0(is used.) 2.25 E(Options, if supplied, ha)5 E .3 -.15(ve t)-.2 H(he follo).15 E -(wing meanings:)-.25 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(59) -200.665 E 0 Cg EP +(wing meanings:)-.25 E(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(59) +198.165 E 0 Cg EP %%Page: 60 60 %%BeginPageSetup BP @@ -7217,7 +7218,7 @@ C(hen)-5.652 E F1(local)3.152 E F0 .652 (writes a list of local v)3.665 F 1.165 (ariables to the standard output.)-.25 F 1.165(It is an error to use) 6.165 F F1(local)3.664 E F0 1.164(when not)3.664 F(GNU Bash 4.2)72 768 Q -(2012 July 5)151.505 E(60)200.665 E 0 Cg EP +(2012 July 14)149.005 E(60)198.165 E 0 Cg EP %%Page: 61 61 %%BeginPageSetup BP @@ -7340,8 +7341,8 @@ E F0(,)A F1(\\")3.108 E F0 3.108(,a)C(nd)-3.108 E F1(\\?)3.108 E F0 .608 (may contain up to four digits\).)2.5 E F1(%q)144 698.4 Q F0(causes) 20.44 E F1(printf)2.51 E F0 .01(to output the corresponding)2.51 F F2 (ar)2.51 E(gument)-.37 E F0 .01(in a format that can be reused as shell) -2.51 F(input.)180 710.4 Q(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E -(61)200.665 E 0 Cg EP +2.51 F(input.)180 710.4 Q(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E +(61)198.165 E 0 Cg EP %%Page: 62 62 %%BeginPageSetup BP @@ -7461,7 +7462,7 @@ F1<ad65>144 700.8 Q F0 .373 (Readline uses the current \(or def)5.218 F .218 (ault, if line editing w)-.1 F .218(as not pre)-.1 F(viously)-.25 E (acti)180 724.8 Q -.15(ve)-.25 G 2.5(\)e).15 G(diting settings.)-2.5 E -(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(62)200.665 E 0 Cg EP +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(62)198.165 E 0 Cg EP %%Page: 63 63 %%BeginPageSetup BP @@ -7595,8 +7596,8 @@ F1(set)108 703.2 Q F0([)2.5 E F1(+abefhkmnptuvxBCEHPT)A F0 2.5(][)C F1 (ariable are displayed in a format that can be)-.25 F .784 (reused as input for setting or resetting the currently-set v)144 727.2 R 3.284(ariables. Read-only)-.25 F -.25(va)3.284 G .784 -(riables cannot be).25 F(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(63) -200.665 E 0 Cg EP +(riables cannot be).25 F(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E +(63)198.165 E 0 Cg EP %%Page: 64 64 %%BeginPageSetup BP @@ -7655,1060 +7656,1073 @@ F2<ad65>3.612 E F0 -.1(wa)3.612 G 3.612(sb).1 G 1.112 -.4 F F3 .617(COMMAND EXE-)3.117 F .642(CUTION ENVIR)184 300 R(ONMENT) -.27 E F0(abo)2.893 E -.15(ve)-.15 G .643 (\), and may cause subshells to e).15 F .643(xit before e)-.15 F -.15 -(xe)-.15 G .643(cuting all).15 F(the commands in the subshell.)184 312 Q -F2<ad66>144 324 Q F0(Disable pathname e)30.97 E(xpansion.)-.15 E F2 -<ad68>144 336 Q F0 2.239(Remember the location of commands as the)28.74 -F 4.738(ya)-.15 G 2.238(re look)-4.738 F 2.238(ed up for e)-.1 F -.15 -(xe)-.15 G 4.738(cution. This).15 F(is)4.738 E(enabled by def)184 348 Q -(ault.)-.1 E F2<ad6b>144 360 Q F0 .513(All ar)28.74 F .514 +(xe)-.15 G .643(cuting all).15 F .016(the commands in the subshell.)184 +312 R .016(If a shell function e)5.016 F -.15(xe)-.15 G .015 +(cutes in a conte).15 F .015(xt where)-.15 F F2<ad65>2.515 E F0 .015 +(is being)2.515 F .347(ignored, e)184 324 R -.15(ve)-.25 G 2.847(ni).15 +G(f)-2.847 E F2<ad65>2.847 E F0 .347(is set, none of the commands e) +2.847 F -.15(xe)-.15 G .348(cuted within the function body will).15 F +1.239(be af)184 336 R 1.239(fected by the)-.25 F F2<ad65>3.738 E F0 +3.738(setting. If)3.738 F 3.738(as)3.738 G 1.238(hell function sets) +-3.738 F F2<ad65>3.738 E F0 1.238(while e)3.738 F -.15(xe)-.15 G 1.238 +(cuting in a conte).15 F(xt)-.15 E(where)184 348 Q F2<ad65>3.153 E F0 +.653(is ignored, that setting will not ha)3.153 F .954 -.15(ve a)-.2 H +.954 -.15(ny e).15 H -.25(ff).15 G .654 +(ect until the command containing).25 F(the function call completes.)184 +360 Q F2<ad66>144 372 Q F0(Disable pathname e)30.97 E(xpansion.)-.15 E +F2<ad68>144 384 Q F0 2.239(Remember the location of commands as the) +28.74 F 4.738(ya)-.15 G 2.238(re look)-4.738 F 2.238(ed up for e)-.1 F +-.15(xe)-.15 G 4.738(cution. This).15 F(is)4.738 E(enabled by def)184 +396 Q(ault.)-.1 E F2<ad6b>144 408 Q F0 .513(All ar)28.74 F .514 (guments in the form of assignment statements are placed in the en)-.18 F .514(vironment for a)-.4 F -(command, not just those that precede the command name.)184 372 Q F2 -<ad6d>144 384 Q F0 .149(Monitor mode.)25.97 F .149 +(command, not just those that precede the command name.)184 420 Q F2 +<ad6d>144 432 Q F0 .149(Monitor mode.)25.97 F .149 (Job control is enabled.)5.149 F .148(This option is on by def)5.149 F .148(ault for interacti)-.1 F .448 -.15(ve s)-.25 H(hells).15 E .65 -(on systems that support it \(see)184 396 R F3 .651(JOB CONTR)3.151 F +(on systems that support it \(see)184 444 R F3 .651(JOB CONTR)3.151 F (OL)-.27 E F0(abo)2.901 E -.15(ve)-.15 G 3.151(\). All).15 F .651 -(processes run in a separate)3.151 F .679(process group.)184 408 R .678 +(processes run in a separate)3.151 F .679(process group.)184 456 R .678 (When a background job completes, the shell prints a line containing it\ -s)5.679 F -.15(ex)184 420 S(it status.).15 E F2<ad6e>144 432 Q F0 .652 +s)5.679 F -.15(ex)184 468 S(it status.).15 E F2<ad6e>144 480 Q F0 .652 (Read commands b)28.74 F .652(ut do not e)-.2 F -.15(xe)-.15 G .652 (cute them.).15 F .653(This may be used to check a shell script for) -5.652 F(syntax errors.)184 444 Q(This is ignored by interacti)5 E .3 --.15(ve s)-.25 H(hells.).15 E F2<ad6f>144 456 Q F1(option\255name)2.5 E -F0(The)184 468 Q F1(option\255name)2.5 E F0(can be one of the follo)2.5 -E(wing:)-.25 E F2(allexport)184 480 Q F0(Same as)224 492 Q F2<ad61>2.5 E -F0(.)A F2(braceexpand)184 504 Q F0(Same as)224 516 Q F2<ad42>2.5 E F0(.) -A F2(emacs)184 528 Q F0 .089 +5.652 F(syntax errors.)184 492 Q(This is ignored by interacti)5 E .3 +-.15(ve s)-.25 H(hells.).15 E F2<ad6f>144 504 Q F1(option\255name)2.5 E +F0(The)184 516 Q F1(option\255name)2.5 E F0(can be one of the follo)2.5 +E(wing:)-.25 E F2(allexport)184 528 Q F0(Same as)224 540 Q F2<ad61>2.5 E +F0(.)A F2(braceexpand)184 552 Q F0(Same as)224 564 Q F2<ad42>2.5 E F0(.) +A F2(emacs)184 576 Q F0 .089 (Use an emacs-style command line editing interf)13.9 F 2.589(ace. This) -.1 F .089(is enabled by def)2.589 F(ault)-.1 E .95 -(when the shell is interacti)224 540 R -.15(ve)-.25 G 3.45(,u).15 G .95 +(when the shell is interacti)224 588 R -.15(ve)-.25 G 3.45(,u).15 G .95 (nless the shell is started with the)-3.45 F F2(\255\255noediting)3.45 E -F0 2.5(option. This)224 552 R(also af)2.5 E(fects the editing interf) +F0 2.5(option. This)224 600 R(also af)2.5 E(fects the editing interf) -.25 E(ace used for)-.1 E F2 -.18(re)2.5 G(ad \255e).18 E F0(.)A F2(err) -184 564 Q(exit)-.18 E F0(Same as)11.31 E F2<ad65>2.5 E F0(.)A F2 -(errtrace)184 576 Q F0(Same as)5.03 E F2<ad45>2.5 E F0(.)A F2(functrace) -184 588 Q F0(Same as)224 600 Q F2<ad54>2.5 E F0(.)A F2(hashall)184 612 Q -F0(Same as)9.43 E F2<ad68>2.5 E F0(.)A F2(histexpand)184 624 Q F0 -(Same as)224 636 Q F2<ad48>2.5 E F0(.)A F2(history)184 648 Q F0 .587 +184 612 Q(exit)-.18 E F0(Same as)11.31 E F2<ad65>2.5 E F0(.)A F2 +(errtrace)184 624 Q F0(Same as)5.03 E F2<ad45>2.5 E F0(.)A F2(functrace) +184 636 Q F0(Same as)224 648 Q F2<ad54>2.5 E F0(.)A F2(hashall)184 660 Q +F0(Same as)9.43 E F2<ad68>2.5 E F0(.)A F2(histexpand)184 672 Q F0 +(Same as)224 684 Q F2<ad48>2.5 E F0(.)A F2(history)184 696 Q F0 .587 (Enable command history)10 F 3.087(,a)-.65 G 3.087(sd)-3.087 G .587 (escribed abo)-3.087 F .887 -.15(ve u)-.15 H(nder).15 E F3(HIST)3.087 E (OR)-.162 E(Y)-.315 E/F4 9/Times-Roman@0 SF(.)A F0 .587(This option is) -5.087 F(on by def)224 660 Q(ault in interacti)-.1 E .3 -.15(ve s)-.25 H -(hells.).15 E F2(ignor)184 672 Q(eeof)-.18 E F0 1.656(The ef)224 684 R -1.656(fect is as if the shell command)-.25 F/F5 10/Courier@0 SF -(IGNOREEOF=10)4.157 E F0 1.657(had been e)4.157 F -.15(xe)-.15 G(cuted) -.15 E(\(see)224 696 Q F2(Shell V)2.5 E(ariables)-.92 E F0(abo)2.5 E -.15 -(ve)-.15 G(\).).15 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(64) -200.665 E 0 Cg EP +5.087 F(on by def)224 708 Q(ault in interacti)-.1 E .3 -.15(ve s)-.25 H +(hells.).15 E(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(64)198.165 E +0 Cg EP %%Page: 65 65 %%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/Times-Bold@0 SF -.1(ke)184 84 S(yw).1 E(ord)-.1 E F0 -(Same as)224 96 Q F1<ad6b>2.5 E F0(.)A F1(monitor)184 108 Q F0(Same as) -5.56 E F1<ad6d>2.5 E F0(.)A F1(noclob)184 120 Q(ber)-.1 E F0(Same as)224 -132 Q F1<ad43>2.5 E F0(.)A F1(noexec)184 144 Q F0(Same as)11.12 E F1 -<ad6e>2.5 E F0(.)A F1(noglob)184 156 Q F0(Same as)11.1 E F1<ad66>2.5 E -F0(.)A F1(nolog)184 168 Q F0(Currently ignored.)16.66 E F1(notify)184 -180 Q F0(Same as)15 E F1<ad62>2.5 E F0(.)A F1(nounset)184 192 Q F0 -(Same as)6.66 E F1<ad75>2.5 E F0(.)A F1(onecmd)184 204 Q F0(Same as)6.67 -E F1<ad74>2.5 E F0(.)A F1(ph)184 216 Q(ysical)-.15 E F0(Same as)5.14 E -F1<ad50>2.5 E F0(.)A F1(pipefail)184 228 Q F0 1.03(If set, the return v) -7.77 F 1.029(alue of a pipeline is the v)-.25 F 1.029 -(alue of the last \(rightmost\) com-)-.25 F 1.136(mand to e)224 240 R +-.35 E/F1 10/Times-Bold@0 SF(ignor)184 84 Q(eeof)-.18 E F0 1.656(The ef) +224 96 R 1.656(fect is as if the shell command)-.25 F/F2 10/Courier@0 SF +(IGNOREEOF=10)4.157 E F0 1.657(had been e)4.157 F -.15(xe)-.15 G(cuted) +.15 E(\(see)224 108 Q F1(Shell V)2.5 E(ariables)-.92 E F0(abo)2.5 E -.15 +(ve)-.15 G(\).).15 E F1 -.1(ke)184 120 S(yw).1 E(ord)-.1 E F0(Same as) +224 132 Q F1<ad6b>2.5 E F0(.)A F1(monitor)184 144 Q F0(Same as)5.56 E F1 +<ad6d>2.5 E F0(.)A F1(noclob)184 156 Q(ber)-.1 E F0(Same as)224 168 Q F1 +<ad43>2.5 E F0(.)A F1(noexec)184 180 Q F0(Same as)11.12 E F1<ad6e>2.5 E +F0(.)A F1(noglob)184 192 Q F0(Same as)11.1 E F1<ad66>2.5 E F0(.)A F1 +(nolog)184 204 Q F0(Currently ignored.)16.66 E F1(notify)184 216 Q F0 +(Same as)15 E F1<ad62>2.5 E F0(.)A F1(nounset)184 228 Q F0(Same as)6.66 +E F1<ad75>2.5 E F0(.)A F1(onecmd)184 240 Q F0(Same as)6.67 E F1<ad74>2.5 +E F0(.)A F1(ph)184 252 Q(ysical)-.15 E F0(Same as)5.14 E F1<ad50>2.5 E +F0(.)A F1(pipefail)184 264 Q F0 1.03(If set, the return v)7.77 F 1.029 +(alue of a pipeline is the v)-.25 F 1.029 +(alue of the last \(rightmost\) com-)-.25 F 1.136(mand to e)224 276 R 1.136 (xit with a non-zero status, or zero if all commands in the pipeline) --.15 F -.15(ex)224 252 S(it successfully).15 E 5(.T)-.65 G -(his option is disabled by def)-5 E(ault.)-.1 E F1(posix)184 264 Q F0 +-.15 F -.15(ex)224 288 S(it successfully).15 E 5(.T)-.65 G +(his option is disabled by def)-5 E(ault.)-.1 E F1(posix)184 300 Q F0 2.091(Change the beha)17.77 F 2.091(vior of)-.2 F F1(bash)4.591 E F0 2.091(where the def)4.591 F 2.091(ault operation dif)-.1 F 2.091 -(fers from the)-.25 F(POSIX standard to match the standard \()224 276 Q -/F2 10/Times-Italic@0 SF(posix mode)A F0(\).)A F1(pri)184 288 Q(vileged) --.1 E F0(Same as)224 300 Q F1<ad70>2.5 E F0(.)A F1 -.1(ve)184 312 S -(rbose).1 E F0(Same as)7.33 E F1<ad76>2.5 E F0(.)A F1(vi)184 324 Q F0 +(fers from the)-.25 F(POSIX standard to match the standard \()224 312 Q +/F3 10/Times-Italic@0 SF(posix mode)A F0(\).)A F1(pri)184 324 Q(vileged) +-.1 E F0(Same as)224 336 Q F1<ad70>2.5 E F0(.)A F1 -.1(ve)184 348 S +(rbose).1 E F0(Same as)7.33 E F1<ad76>2.5 E F0(.)A F1(vi)184 360 Q F0 1.465(Use a vi-style command line editing interf)32.22 F 3.966 (ace. This)-.1 F 1.466(also af)3.966 F 1.466(fects the editing)-.25 F -(interf)224 336 Q(ace used for)-.1 E F1 -.18(re)2.5 G(ad \255e).18 E F0 -(.)A F1(xtrace)184 348 Q F0(Same as)13.35 E F1<ad78>2.5 E F0(.)A(If)184 -366 Q F1<ad6f>3.053 E F0 .553(is supplied with no)3.053 F F2 +(interf)224 372 Q(ace used for)-.1 E F1 -.18(re)2.5 G(ad \255e).18 E F0 +(.)A F1(xtrace)184 384 Q F0(Same as)13.35 E F1<ad78>2.5 E F0(.)A(If)184 +402 Q F1<ad6f>3.053 E F0 .553(is supplied with no)3.053 F F3 (option\255name)3.053 E F0 3.053(,t)C .553(he v)-3.053 F .552 (alues of the current options are printed.)-.25 F(If)5.552 E F1(+o)184 -378 Q F0 1.071(is supplied with no)3.571 F F2(option\255name)3.571 E F0 +414 Q F0 1.071(is supplied with no)3.571 F F3(option\255name)3.571 E F0 3.571(,as)C 1.071(eries of)-3.571 F F1(set)3.572 E F0 1.072 (commands to recreate the current)3.572 F -(option settings is displayed on the standard output.)184 390 Q F1<ad70> -144 402 Q F0 -.45(Tu)28.74 G 1.072(rn on).45 F F2(privile)4.822 E -.1 +(option settings is displayed on the standard output.)184 426 Q F1<ad70> +144 438 Q F0 -.45(Tu)28.74 G 1.072(rn on).45 F F3(privile)4.822 E -.1 (ge)-.4 G(d).1 E F0 3.572(mode. In)4.342 F 1.072(this mode, the)3.572 F -/F3 9/Times-Bold@0 SF($ENV)3.572 E F0(and)3.322 E F3($B)3.572 E(ASH_ENV) +/F4 9/Times-Bold@0 SF($ENV)3.572 E F0(and)3.322 E F4($B)3.572 E(ASH_ENV) -.27 E F0 1.071(\214les are not pro-)3.322 F 1.5 -(cessed, shell functions are not inherited from the en)184 414 R 1.501 -(vironment, and the)-.4 F F3(SHELLOPTS)4.001 E/F4 9/Times-Roman@0 SF(,)A -F3 -.27(BA)184 426 S(SHOPTS).27 E F4(,)A F3(CDP)2.775 E -.855(AT)-.666 G -(H).855 E F4(,)A F0(and)2.775 E F3(GLOBIGNORE)3.025 E F0 -.25(va)2.775 G +(cessed, shell functions are not inherited from the en)184 450 R 1.501 +(vironment, and the)-.4 F F4(SHELLOPTS)4.001 E/F5 9/Times-Roman@0 SF(,)A +F4 -.27(BA)184 462 S(SHOPTS).27 E F5(,)A F4(CDP)2.775 E -.855(AT)-.666 G +(H).855 E F5(,)A F0(and)2.775 E F4(GLOBIGNORE)3.025 E F0 -.25(va)2.775 G .524(riables, if the).25 F 3.024(ya)-.15 G .524(ppear in the en)-3.024 F -(vironment,)-.4 E .379(are ignored.)184 438 R .379 +(vironment,)-.4 E .379(are ignored.)184 474 R .379 (If the shell is started with the ef)5.379 F(fecti)-.25 E .679 -.15 (ve u)-.25 H .38(ser \(group\) id not equal to the real).15 F .462 -(user \(group\) id, and the)184 450 R F1<ad70>2.961 E F0 .461 +(user \(group\) id, and the)184 486 R F1<ad70>2.961 E F0 .461 (option is not supplied, these actions are tak)2.961 F .461 -(en and the ef)-.1 F(fec-)-.25 E(ti)184 462 Q .694 -.15(ve u)-.25 H .394 +(en and the ef)-.1 F(fec-)-.25 E(ti)184 498 Q .694 -.15(ve u)-.25 H .394 (ser id is set to the real user id.).15 F .395(If the)5.395 F F1<ad70> 2.895 E F0 .395(option is supplied at startup, the ef)2.895 F(fecti)-.25 -E -.15(ve)-.25 G .387(user id is not reset.)184 474 R -.45(Tu)5.387 G +E -.15(ve)-.25 G .387(user id is not reset.)184 510 R -.45(Tu)5.387 G .387(rning this option of).45 F 2.886(fc)-.25 G .386(auses the ef)-2.886 F(fecti)-.25 E .686 -.15(ve u)-.25 H .386(ser and group ids to be).15 F -(set to the real user and group ids.)184 486 Q F1<ad74>144 498 Q F0 +(set to the real user and group ids.)184 522 Q F1<ad74>144 534 Q F0 (Exit after reading and e)30.97 E -.15(xe)-.15 G(cuting one command.).15 -E F1<ad75>144 510 Q F0 -.35(Tr)28.74 G .043(eat unset v).35 F .044(aria\ +E F1<ad75>144 546 Q F0 -.35(Tr)28.74 G .043(eat unset v).35 F .044(aria\ bles and parameters other than the special parameters "@" and "*" as an) --.25 F .183(error when performing parameter e)184 522 R 2.683 +-.25 F .183(error when performing parameter e)184 558 R 2.683 (xpansion. If)-.15 F -.15(ex)2.683 G .182 (pansion is attempted on an unset v).15 F(ari-)-.25 E .746 -(able or parameter)184 534 R 3.246(,t)-.4 G .746 +(able or parameter)184 570 R 3.246(,t)-.4 G .746 (he shell prints an error message, and, if not interacti)-3.246 F -.15 (ve)-.25 G 3.246(,e).15 G .746(xits with a)-3.396 F(non-zero status.)184 -546 Q F1<ad76>144 558 Q F0(Print shell input lines as the)29.3 E 2.5(ya) --.15 G(re read.)-2.5 E F1<ad78>144 570 Q F0 .315(After e)29.3 F .315 -(xpanding each)-.15 F F2 .315(simple command)2.815 F F0(,)A F1 -.25(fo) +582 Q F1<ad76>144 594 Q F0(Print shell input lines as the)29.3 E 2.5(ya) +-.15 G(re read.)-2.5 E F1<ad78>144 606 Q F0 .315(After e)29.3 F .315 +(xpanding each)-.15 F F3 .315(simple command)2.815 F F0(,)A F1 -.25(fo) 2.815 G(r).25 E F0(command,)2.815 E F1(case)2.815 E F0(command,)2.815 E -F1(select)2.815 E F0(command,)2.815 E 1.235(or arithmetic)184 582 R F1 +F1(select)2.815 E F0(command,)2.815 E 1.235(or arithmetic)184 618 R F1 -.25(fo)3.736 G(r).25 E F0 1.236(command, display the e)3.736 F 1.236 -(xpanded v)-.15 F 1.236(alue of)-.25 F F3(PS4)3.736 E F4(,)A F0(follo) -3.486 E 1.236(wed by the com-)-.25 F(mand and its e)184 594 Q +(xpanded v)-.15 F 1.236(alue of)-.25 F F4(PS4)3.736 E F5(,)A F0(follo) +3.486 E 1.236(wed by the com-)-.25 F(mand and its e)184 630 Q (xpanded ar)-.15 E(guments or associated w)-.18 E(ord list.)-.1 E F1 -<ad42>144 606 Q F0 2.579(The shell performs brace e)27.63 F 2.578 +<ad42>144 642 Q F0 2.579(The shell performs brace e)27.63 F 2.578 (xpansion \(see)-.15 F F1 2.578(Brace Expansion)5.078 F F0(abo)5.078 E --.15(ve)-.15 G 5.078(\). This).15 F 2.578(is on by)5.078 F(def)184 618 Q -(ault.)-.1 E F1<ad43>144 630 Q F0 .213(If set,)27.08 F F1(bash)2.713 E +-.15(ve)-.15 G 5.078(\). This).15 F 2.578(is on by)5.078 F(def)184 654 Q +(ault.)-.1 E F1<ad43>144 666 Q F0 .213(If set,)27.08 F F1(bash)2.713 E F0 .213(does not o)2.713 F -.15(ve)-.15 G .214(rwrite an e).15 F .214 (xisting \214le with the)-.15 F F1(>)2.714 E F0(,)A F1(>&)2.714 E F0 2.714(,a)C(nd)-2.714 E F1(<>)2.714 E F0 .214(redirection opera-)2.714 F -3.054(tors. This)184 642 R .553(may be o)3.053 F -.15(ve)-.15 G .553 +3.054(tors. This)184 678 R .553(may be o)3.053 F -.15(ve)-.15 G .553 (rridden when creating output \214les by using the redirection opera-) -.15 F(tor)184 654 Q F1(>|)2.5 E F0(instead of)2.5 E F1(>)2.5 E F0(.)A F1 -<ad45>144 666 Q F0 .103(If set, an)27.63 F 2.603(yt)-.15 G .103(rap on) +.15 F(tor)184 690 Q F1(>|)2.5 E F0(instead of)2.5 E F1(>)2.5 E F0(.)A F1 +<ad45>144 702 Q F0 .103(If set, an)27.63 F 2.603(yt)-.15 G .103(rap on) -2.603 F F1(ERR)2.603 E F0 .104 (is inherited by shell functions, command substitutions, and com-)2.603 -F .839(mands e)184 678 R -.15(xe)-.15 G .839(cuted in a subshell en).15 +F .839(mands e)184 714 R -.15(xe)-.15 G .839(cuted in a subshell en).15 F 3.339(vironment. The)-.4 F F1(ERR)3.338 E F0 .838 -(trap is normally not inherited in)3.338 F(such cases.)184 690 Q F1 -<ad48>144 702 Q F0(Enable)26.52 E F1(!)3.031 E F0 .531 -(style history substitution.)5.531 F .531(This option is on by def)5.531 -F .532(ault when the shell is inter)-.1 F(-)-.2 E(acti)184 714 Q -.15 -(ve)-.25 G(.).15 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(65) -200.665 E 0 Cg EP +(trap is normally not inherited in)3.338 F(such cases.)184 726 Q +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(65)198.165 E 0 Cg EP %%Page: 66 66 %%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/Times-Bold@0 SF<ad50>144 84 Q F0 .96 +-.35 E/F1 10/Times-Bold@0 SF<ad48>144 84 Q F0(Enable)26.52 E F1(!)3.031 +E F0 .531(style history substitution.)5.531 F .531 +(This option is on by def)5.531 F .532(ault when the shell is inter)-.1 +F(-)-.2 E(acti)184 96 Q -.15(ve)-.25 G(.).15 E F1<ad50>144 108 Q F0 .96 (If set, the shell does not resolv)28.19 F 3.459(es)-.15 G .959 (ymbolic links when e)-3.459 F -.15(xe)-.15 G .959 (cuting commands such as).15 F F1(cd)3.459 E F0 2.821 -(that change the current w)184 96 R 2.822(orking directory)-.1 F 7.822 +(that change the current w)184 120 R 2.822(orking directory)-.1 F 7.822 (.I)-.65 G 5.322(tu)-7.822 G 2.822(ses the ph)-5.322 F 2.822 -(ysical directory structure)-.05 F 2.686(instead. By)184 108 R(def)2.686 +(ysical directory structure)-.05 F 2.686(instead. By)184 132 R(def)2.686 E(ault,)-.1 E F1(bash)2.686 E F0(follo)2.686 E .186 (ws the logical chain of directories when performing com-)-.25 F -(mands which change the current directory)184 120 Q(.)-.65 E F1<ad54>144 -132 Q F0 .89(If set, an)27.63 F 3.39(yt)-.15 G .89(raps on)-3.39 F F1 +(mands which change the current directory)184 144 Q(.)-.65 E F1<ad54>144 +156 Q F0 .89(If set, an)27.63 F 3.39(yt)-.15 G .89(raps on)-3.39 F F1 (DEB)3.39 E(UG)-.1 E F0(and)3.39 E F1(RETURN)3.39 E F0 .89 (are inherited by shell functions, command)3.39 F 1.932 -(substitutions, and commands e)184 144 R -.15(xe)-.15 G 1.932 +(substitutions, and commands e)184 168 R -.15(xe)-.15 G 1.932 (cuted in a subshell en).15 F 4.432(vironment. The)-.4 F F1(DEB)4.432 E -(UG)-.1 E F0(and)4.432 E F1(RETURN)184 156 Q F0 -(traps are normally not inherited in such cases.)2.5 E F1<adad>144 168 Q +(UG)-.1 E F0(and)4.432 E F1(RETURN)184 180 Q F0 +(traps are normally not inherited in such cases.)2.5 E F1<adad>144 192 Q F0 .4(If no ar)28.6 F .401(guments follo)-.18 F 2.901(wt)-.25 G .401 (his option, then the positional parameters are unset.)-2.901 F -(Otherwise,)5.401 E(the positional parameters are set to the)184 180 Q +(Otherwise,)5.401 E(the positional parameters are set to the)184 204 Q /F2 10/Times-Italic@0 SF(ar)2.5 E(g)-.37 E F0(s, e)A -.15(ve)-.25 G 2.5 (ni).15 G 2.5(fs)-2.5 G(ome of them be)-2.5 E(gin with a)-.15 E F1<ad> -2.5 E F0(.)A F1<ad>144 192 Q F0 1.945 +2.5 E F0(.)A F1<ad>144 216 Q F0 1.945 (Signal the end of options, cause all remaining)34.3 F F2(ar)4.444 E(g) -.37 E F0 4.444(st)C 4.444(ob)-4.444 G 4.444(ea)-4.444 G 1.944 -(ssigned to the positional)-4.444 F 3.445(parameters. The)184 204 R F1 +(ssigned to the positional)-4.444 F 3.445(parameters. The)184 228 R F1 <ad78>3.445 E F0(and)3.445 E F1<ad76>3.445 E F0 .945 (options are turned of)3.445 F 3.445(f. If)-.25 F .946(there are no) 3.445 F F2(ar)3.446 E(g)-.37 E F0 .946(s, the positional)B -(parameters remain unchanged.)184 216 Q .425(The options are of)144 -232.8 R 2.925(fb)-.25 G 2.925(yd)-2.925 G(ef)-2.925 E .425 +(parameters remain unchanged.)184 240 Q .425(The options are of)144 +256.8 R 2.925(fb)-.25 G 2.925(yd)-2.925 G(ef)-2.925 E .425 (ault unless otherwise noted.)-.1 F .425 (Using + rather than \255 causes these options)5.425 F .177 -(to be turned of)144 244.8 R 2.677(f. The)-.25 F .178 +(to be turned of)144 268.8 R 2.677(f. The)-.25 F .178 (options can also be speci\214ed as ar)2.678 F .178(guments to an in) -.18 F -.2(vo)-.4 G .178(cation of the shell.).2 F(The)5.178 E .066 -(current set of options may be found in)144 256.8 R F1<24ad>2.566 E F0 +(current set of options may be found in)144 280.8 R F1<24ad>2.566 E F0 5.066(.T)C .066(he return status is al)-5.066 F -.1(wa)-.1 G .066 (ys true unless an in).1 F -.25(va)-.4 G .066(lid option).25 F -(is encountered.)144 268.8 Q F1(shift)108 285.6 Q F0([)2.5 E F2(n)A F0 -(])A .428(The positional parameters from)144 297.6 R F2(n)2.928 E F0 +(is encountered.)144 292.8 Q F1(shift)108 309.6 Q F0([)2.5 E F2(n)A F0 +(])A .428(The positional parameters from)144 321.6 R F2(n)2.928 E F0 .429(+1 ... are renamed to)B F1 .429($1 ....)2.929 F F0 -.15(Pa)5.429 G -.429(rameters represented by the num-).15 F(bers)144 309.6 Q F1($#)2.583 +.429(rameters represented by the num-).15 F(bers)144 333.6 Q F1($#)2.583 E F0(do)2.583 E .083(wn to)-.25 F F1($#)2.583 E F0<ad>A F2(n)A F0 .083 (+1 are unset.)B F2(n)5.443 E F0 .083(must be a non-ne)2.823 F -.05(ga) -.15 G(ti).05 E .382 -.15(ve n)-.25 H .082(umber less than or equal to) .15 F F1($#)2.582 E F0 5.082(.I)C(f)-5.082 E F2(n)2.942 E F0 .06 -(is 0, no parameters are changed.)144 321.6 R(If)5.06 E F2(n)2.92 E F0 +(is 0, no parameters are changed.)144 345.6 R(If)5.06 E F2(n)2.92 E F0 .06(is not gi)2.8 F -.15(ve)-.25 G .06(n, it is assumed to be 1.).15 F (If)5.06 E F2(n)2.92 E F0 .06(is greater than)2.8 F F1($#)2.56 E F0 2.56 -(,t)C(he)-2.56 E .144(positional parameters are not changed.)144 333.6 R +(,t)C(he)-2.56 E .144(positional parameters are not changed.)144 357.6 R .144(The return status is greater than zero if)5.144 F F2(n)3.003 E F0 .143(is greater than)2.883 F F1($#)2.643 E F0 -(or less than zero; otherwise 0.)144 345.6 Q F1(shopt)108 362.4 Q F0([) +(or less than zero; otherwise 0.)144 369.6 Q F1(shopt)108 386.4 Q F0([) 2.5 E F1(\255pqsu)A F0 2.5(][)C F1<ad6f>-2.5 E F0 2.5(][)C F2(optname) --2.5 E F0(...])2.5 E -.8(To)144 374.4 S .222(ggle the v).8 F .222 +-2.5 E F0(...])2.5 E -.8(To)144 398.4 S .222(ggle the v).8 F .222 (alues of v)-.25 F .222(ariables controlling optional shell beha)-.25 F (vior)-.2 E 5.222(.W)-.55 G .222(ith no options, or with the)-5.622 F F1 <ad70>2.722 E F0 .721(option, a list of all settable options is display\ -ed, with an indication of whether or not each is set.)144 386.4 R(The) -144 398.4 Q F1<ad70>2.827 E F0 .327(option causes output to be displaye\ +ed, with an indication of whether or not each is set.)144 410.4 R(The) +144 422.4 Q F1<ad70>2.827 E F0 .327(option causes output to be displaye\ d in a form that may be reused as input.)2.827 F .328(Other options) -5.328 F(ha)144 410.4 Q .3 -.15(ve t)-.2 H(he follo).15 E(wing meanings:) --.25 E F1<ad73>144 422.4 Q F0(Enable \(set\) each)26.41 E F2(optname)2.5 -E F0(.)A F1<ad75>144 434.4 Q F0(Disable \(unset\) each)24.74 E F2 -(optname)2.5 E F0(.)A F1<ad71>144 446.4 Q F0 .003(Suppresses normal out\ +5.328 F(ha)144 434.4 Q .3 -.15(ve t)-.2 H(he follo).15 E(wing meanings:) +-.25 E F1<ad73>144 446.4 Q F0(Enable \(set\) each)26.41 E F2(optname)2.5 +E F0(.)A F1<ad75>144 458.4 Q F0(Disable \(unset\) each)24.74 E F2 +(optname)2.5 E F0(.)A F1<ad71>144 470.4 Q F0 .003(Suppresses normal out\ put \(quiet mode\); the return status indicates whether the)24.74 F F2 -(optname)2.503 E F0(is)2.503 E .255(set or unset.)180 458.4 R .255 +(optname)2.503 E F0(is)2.503 E .255(set or unset.)180 482.4 R .255 (If multiple)5.255 F F2(optname)2.755 E F0(ar)2.755 E .256 (guments are gi)-.18 F -.15(ve)-.25 G 2.756(nw).15 G(ith)-2.756 E F1 <ad71>2.756 E F0 2.756(,t)C .256(he return status is zero if)-2.756 F -(all)180 470.4 Q F2(optnames)2.5 E F0(are enabled; non-zero otherwise.) -2.5 E F1<ad6f>144 482.4 Q F0(Restricts the v)25.3 E(alues of)-.25 E F2 +(all)180 494.4 Q F2(optnames)2.5 E F0(are enabled; non-zero otherwise.) +2.5 E F1<ad6f>144 506.4 Q F0(Restricts the v)25.3 E(alues of)-.25 E F2 (optname)2.5 E F0(to be those de\214ned for the)2.5 E F1<ad6f>2.5 E F0 (option to the)2.5 E F1(set)2.5 E F0 -.2(bu)2.5 G(iltin.).2 E .625 -(If either)144 499.2 R F1<ad73>3.125 E F0(or)3.124 E F1<ad75>3.124 E F0 +(If either)144 523.2 R F1<ad73>3.125 E F0(or)3.124 E F1<ad75>3.124 E F0 .624(is used with no)3.124 F F2(optname)3.124 E F0(ar)3.124 E(guments,) -.18 E F1(shopt)3.124 E F0(sho)3.124 E .624 (ws only those options which are)-.25 F 2.233(set or unset, respecti)144 -511.2 R -.15(ve)-.25 G(ly).15 E 7.234(.U)-.65 G 2.234 +535.2 R -.15(ve)-.25 G(ly).15 E 7.234(.U)-.65 G 2.234 (nless otherwise noted, the)-7.234 F F1(shopt)4.734 E F0 2.234 -(options are disabled \(unset\) by)4.734 F(def)144 523.2 Q(ault.)-.1 E -1.544(The return status when listing options is zero if all)144 540 R F2 +(options are disabled \(unset\) by)4.734 F(def)144 547.2 Q(ault.)-.1 E +1.544(The return status when listing options is zero if all)144 564 R F2 (optnames)4.044 E F0 1.544(are enabled, non-zero otherwise.)4.044 F .696 (When setting or unsetting options, the return status is zero unless an) -144 552 R F2(optname)3.196 E F0 .696(is not a v)3.196 F .696(alid shell) --.25 F(option.)144 564 Q(The list of)144 580.8 Q F1(shopt)2.5 E F0 -(options is:)2.5 E F1(autocd)144 598.8 Q F0 .2 +144 576 R F2(optname)3.196 E F0 .696(is not a v)3.196 F .696(alid shell) +-.25 F(option.)144 588 Q(The list of)144 604.8 Q F1(shopt)2.5 E F0 +(options is:)2.5 E F1(autocd)144 622.8 Q F0 .2 (If set, a command name that is the name of a directory is e)11.11 F -.15(xe)-.15 G .199(cuted as if it were the ar).15 F(gu-)-.18 E -(ment to the)184 610.8 Q F1(cd)2.5 E F0 2.5(command. This)2.5 F +(ment to the)184 634.8 Q F1(cd)2.5 E F0 2.5(command. This)2.5 F (option is only used by interacti)2.5 E .3 -.15(ve s)-.25 H(hells.).15 E -F1(cdable_v)144 622.8 Q(ars)-.1 E F0 .155(If set, an ar)184 634.8 R .155 +F1(cdable_v)144 646.8 Q(ars)-.1 E F0 .155(If set, an ar)184 658.8 R .155 (gument to the)-.18 F F1(cd)2.655 E F0 -.2(bu)2.655 G .156 (iltin command that is not a directory is assumed to be the).2 F -(name of a v)184 646.8 Q(ariable whose v)-.25 E -(alue is the directory to change to.)-.25 E F1(cdspell)144 658.8 Q F0 +(name of a v)184 670.8 Q(ariable whose v)-.25 E +(alue is the directory to change to.)-.25 E F1(cdspell)144 682.8 Q F0 1.055 (If set, minor errors in the spelling of a directory component in a) 10.55 F F1(cd)3.555 E F0 1.055(command will be)3.555 F 3.987 -(corrected. The)184 670.8 R 1.487(errors check)3.987 F 1.487 +(corrected. The)184 694.8 R 1.487(errors check)3.987 F 1.487 (ed for are transposed characters, a missing character)-.1 F 3.988(,a) --.4 G(nd)-3.988 E .77(one character too man)184 682.8 R 4.57 -.65(y. I) +-.4 G(nd)-3.988 E .77(one character too man)184 706.8 R 4.57 -.65(y. I) -.15 H 3.27(fac).65 G .77 (orrection is found, the corrected \214lename is printed, and)-3.27 F -(the command proceeds.)184 694.8 Q +(the command proceeds.)184 718.8 Q (This option is only used by interacti)5 E .3 -.15(ve s)-.25 H(hells.) -.15 E F1(checkhash)144 706.8 Q F0 2.079(If set,)184 718.8 R F1(bash) -4.579 E F0 2.079(checks that a command found in the hash table e)4.579 F -2.08(xists before trying to)-.15 F -.15(exe)184 730.8 S(cute it.).15 E -(If a hashed command no longer e)5 E -(xists, a normal path search is performed.)-.15 E(GNU Bash 4.2)72 768 Q -(2012 July 5)151.505 E(66)200.665 E 0 Cg EP +.15 E(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(66)198.165 E 0 Cg EP %%Page: 67 67 %%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/Times-Bold@0 SF(checkjobs)144 84 Q F0 .449(If set,)184 96 R -F1(bash)2.949 E F0 .449(lists the status of an)2.949 F 2.949(ys)-.15 G -.448(topped and running jobs before e)-2.949 F .448(xiting an interacti) --.15 F -.15(ve)-.25 G 3.438(shell. If)184 108 R(an)3.438 E 3.438(yj)-.15 -G .938(obs are running, this causes the e)-3.438 F .938 +-.35 E/F1 10/Times-Bold@0 SF(checkhash)144 84 Q F0 2.079(If set,)184 96 +R F1(bash)4.579 E F0 2.079 +(checks that a command found in the hash table e)4.579 F 2.08 +(xists before trying to)-.15 F -.15(exe)184 108 S(cute it.).15 E +(If a hashed command no longer e)5 E +(xists, a normal path search is performed.)-.15 E F1(checkjobs)144 120 Q +F0 .449(If set,)184 132 R F1(bash)2.949 E F0 .449 +(lists the status of an)2.949 F 2.949(ys)-.15 G .448 +(topped and running jobs before e)-2.949 F .448(xiting an interacti)-.15 +F -.15(ve)-.25 G 3.438(shell. If)184 144 R(an)3.438 E 3.438(yj)-.15 G +.938(obs are running, this causes the e)-3.438 F .938 (xit to be deferred until a second e)-.15 F .939(xit is)-.15 F 2.203 -(attempted without an interv)184 120 R 2.203(ening command \(see)-.15 F +(attempted without an interv)184 156 R 2.203(ening command \(see)-.15 F /F2 9/Times-Bold@0 SF 2.203(JOB CONTR)4.703 F(OL)-.27 E F0(abo)4.453 E --.15(ve)-.15 G 4.703(\). The).15 F(shell)4.703 E(al)184 132 Q -.1(wa)-.1 +-.15(ve)-.15 G 4.703(\). The).15 F(shell)4.703 E(al)184 168 Q -.1(wa)-.1 G(ys postpones e).1 E(xiting if an)-.15 E 2.5(yj)-.15 G -(obs are stopped.)-2.5 E F1(checkwinsize)144 144 Q F0 .796(If set,)184 -156 R F1(bash)3.296 E F0 .796(checks the windo)3.296 F 3.296(ws)-.25 G +(obs are stopped.)-2.5 E F1(checkwinsize)144 180 Q F0 .796(If set,)184 +192 R F1(bash)3.296 E F0 .796(checks the windo)3.296 F 3.296(ws)-.25 G .797(ize after each command and, if necessary)-3.296 F 3.297(,u)-.65 G -.797(pdates the)-3.297 F -.25(va)184 168 S(lues of).25 E F2(LINES)2.5 E +.797(pdates the)-3.297 F -.25(va)184 204 S(lues of).25 E F2(LINES)2.5 E F0(and)2.25 E F2(COLUMNS)2.5 E/F3 9/Times-Roman@0 SF(.)A F1(cmdhist)144 -180 Q F0 1.202(If set,)6.11 F F1(bash)3.702 E F0 1.202(attempts to sa) +216 Q F0 1.202(If set,)6.11 F F1(bash)3.702 E F0 1.202(attempts to sa) 3.702 F 1.502 -.15(ve a)-.2 H 1.202 (ll lines of a multiple-line command in the same history).15 F(entry)184 -192 Q 5(.T)-.65 G(his allo)-5 E -(ws easy re-editing of multi-line commands.)-.25 E F1(compat31)144 204 Q -F0 .419(If set,)184 216 R F1(bash)2.919 E F0 .419(changes its beha)2.919 +228 Q 5(.T)-.65 G(his allo)-5 E +(ws easy re-editing of multi-line commands.)-.25 E F1(compat31)144 240 Q +F0 .419(If set,)184 252 R F1(bash)2.919 E F0 .419(changes its beha)2.919 F .419(vior to that of v)-.2 F .42(ersion 3.1 with respect to quoted ar) --.15 F(guments)-.18 E .462(to the)184 228 R F1([[)2.962 E F0 .462 +-.15 F(guments)-.18 E .462(to the)184 264 R F1([[)2.962 E F0 .462 (conditional command')2.962 F(s)-.55 E F1(=~)2.962 E F0 .462 (operator and locale-speci\214c string comparison when)2.962 F .71 -(using the)184 240 R F1([[)3.21 E F0 .71(conditional command')3.21 F(s) +(using the)184 276 R F1([[)3.21 E F0 .71(conditional command')3.21 F(s) -.55 E F1(<)3.21 E F0(and)3.21 E F1(>)3.21 E F0 3.21(operators. Bash) 3.21 F -.15(ve)3.21 G .71(rsions prior to bash-4.1).15 F .821 -(use ASCII collation and)184 252 R/F4 10/Times-Italic@0 SF(str)3.321 E +(use ASCII collation and)184 288 R/F4 10/Times-Italic@0 SF(str)3.321 E (cmp)-.37 E F0 .821(\(3\); bash-4.1 and later use the current locale') -.19 F 3.32(sc)-.55 G(ollation)-3.32 E(sequence and)184 264 Q F4(str)2.5 -E(coll)-.37 E F0(\(3\).).51 E F1(compat32)144 276 Q F0 1.409(If set,)184 -288 R F1(bash)3.909 E F0 1.409(changes its beha)3.909 F 1.409 +.19 F 3.32(sc)-.55 G(ollation)-3.32 E(sequence and)184 300 Q F4(str)2.5 +E(coll)-.37 E F0(\(3\).).51 E F1(compat32)144 312 Q F0 1.409(If set,)184 +324 R F1(bash)3.909 E F0 1.409(changes its beha)3.909 F 1.409 (vior to that of v)-.2 F 1.41 (ersion 3.2 with respect to locale-speci\214c)-.15 F .423 -(string comparison when using the)184 300 R F1([[)2.922 E F0 .422 +(string comparison when using the)184 336 R F1([[)2.922 E F0 .422 (conditional command')2.922 F(s)-.55 E F1(<)2.922 E F0(and)2.922 E F1(>) -2.922 E F0 .422(operators \(see pre-)2.922 F(vious item\).)184 312 Q F1 -(compat40)144 324 Q F0 1.409(If set,)184 336 R F1(bash)3.909 E F0 1.409 +2.922 E F0 .422(operators \(see pre-)2.922 F(vious item\).)184 348 Q F1 +(compat40)144 360 Q F0 1.409(If set,)184 372 R F1(bash)3.909 E F0 1.409 (changes its beha)3.909 F 1.409(vior to that of v)-.2 F 1.41 (ersion 4.0 with respect to locale-speci\214c)-.15 F 2.008 -(string comparison when using the)184 348 R F1([[)4.508 E F0 2.007 +(string comparison when using the)184 384 R F1([[)4.508 E F0 2.007 (conditional command')4.508 F(s)-.55 E F1(<)4.507 E F0(and)4.507 E F1(>) -4.507 E F0 2.007(operators \(see)4.507 F .769(description of)184 360 R +4.507 E F0 2.007(operators \(see)4.507 F .769(description of)184 396 R F1(compat31)3.269 E F0 3.269(\)a)C .769(nd the ef)-3.269 F .769 (fect of interrupting a command list.)-.25 F .77(Bash v)5.77 F(ersions) -.15 E .087(4.0 and later interrupt the list as if the shell recei)184 -372 R -.15(ve)-.25 G 2.586(dt).15 G .086(he interrupt; pre)-2.586 F .086 -(vious v)-.25 F .086(ersions con-)-.15 F(tinue with the ne)184 384 Q -(xt command in the list.)-.15 E F1(compat41)144 396 Q F0 1.443(If set,) -184 408 R F1(bash)3.943 E F0 3.943(,w)C 1.444 +408 R -.15(ve)-.25 G 2.586(dt).15 G .086(he interrupt; pre)-2.586 F .086 +(vious v)-.25 F .086(ersions con-)-.15 F(tinue with the ne)184 420 Q +(xt command in the list.)-.15 E F1(compat41)144 432 Q F0 1.443(If set,) +184 444 R F1(bash)3.943 E F0 3.943(,w)C 1.444 (hen in posix mode, treats a single quote in a double-quoted parameter) --3.943 F -.15(ex)184 420 S .959(pansion as a special character).15 F +-3.943 F -.15(ex)184 456 S .959(pansion as a special character).15 F 5.959(.T)-.55 G .958(he single quotes must match \(an e)-5.959 F -.15 (ve)-.25 G 3.458(nn).15 G .958(umber\) and)-3.458 F .59 -(the characters between the single quotes are considered quoted.)184 432 +(the characters between the single quotes are considered quoted.)184 468 R .59(This is the beha)5.59 F .59(vior of)-.2 F .59 -(posix mode through v)184 444 R .589(ersion 4.1.)-.15 F .589(The def) +(posix mode through v)184 480 R .589(ersion 4.1.)-.15 F .589(The def) 5.589 F .589(ault bash beha)-.1 F .589(vior remains as in pre)-.2 F .589 -(vious v)-.25 F(er)-.15 E(-)-.2 E(sions.)184 456 Q F1 -(complete_fullquote)144 468 Q F0 .653(If set,)184 480 R F1(bash)3.153 E +(vious v)-.25 F(er)-.15 E(-)-.2 E(sions.)184 492 Q F1 +(complete_fullquote)144 504 Q F0 .653(If set,)184 516 R F1(bash)3.153 E F0 .653(quotes all shell metacharacters in \214lenames and directory na\ -mes when per)3.153 F(-)-.2 E 1.525(forming completion.)184 492 R 1.524 +mes when per)3.153 F(-)-.2 E 1.525(forming completion.)184 528 R 1.524 (If not set,)6.525 F F1(bash)4.024 E F0(remo)4.024 E -.15(ve)-.15 G 4.024(sm).15 G 1.524(etacharacters such as the dollar sign)-4.024 F 2.667(from the set of characters that will be quoted in completed \214l\ -enames when these)184 504 R .029(metacharacters appear in shell v)184 -516 R .028(ariable references in w)-.25 F .028(ords to be completed.)-.1 -F .028(This means)5.028 F 1.072(that dollar signs in v)184 528 R 1.073 +enames when these)184 540 R .029(metacharacters appear in shell v)184 +552 R .028(ariable references in w)-.25 F .028(ords to be completed.)-.1 +F .028(This means)5.028 F 1.072(that dollar signs in v)184 564 R 1.073 (ariable names that e)-.25 F 1.073 (xpand to directories will not be quoted; ho)-.15 F(w-)-.25 E -2.15 -.25 -(ev e)184 540 T 1.923 -.4(r, a).25 H 1.423 -.15(ny d).4 H 1.123 +(ev e)184 576 T 1.923 -.4(r, a).25 H 1.423 -.15(ny d).4 H 1.123 (ollar signs appearing in \214lenames will not be quoted, either).15 F 6.123(.T)-.55 G 1.122(his is acti)-6.123 F -.15(ve)-.25 G .59 (only when bash is using backslashes to quote completed \214lenames.)184 -552 R .59(This v)5.59 F .59(ariable is set)-.25 F(by def)184 564 Q +588 R .59(This v)5.59 F .59(ariable is set)-.25 F(by def)184 600 Q (ault, which is the def)-.1 E(ault bash beha)-.1 E(vior in v)-.2 E -(ersions through 4.2.)-.15 E F1(dir)144 576 Q(expand)-.18 E F0 .487 -(If set,)184 588 R F1(bash)2.987 E F0 .486 +(ersions through 4.2.)-.15 E F1(dir)144 612 Q(expand)-.18 E F0 .487 +(If set,)184 624 R F1(bash)2.987 E F0 .486 (replaces directory names with the results of w)2.986 F .486(ord e)-.1 F .486(xpansion when perform-)-.15 F .179(ing \214lename completion.)184 -600 R .179(This changes the contents of the readline editing b)5.179 F +636 R .179(This changes the contents of the readline editing b)5.179 F (uf)-.2 E(fer)-.25 E 5.18(.I)-.55 G 2.68(fn)-5.18 G(ot)-2.68 E(set,)184 -612 Q F1(bash)2.5 E F0(attempts to preserv)2.5 E 2.5(ew)-.15 G -(hat the user typed.)-2.5 E F1(dirspell)144 624 Q F0 .859(If set,)7.77 F +648 Q F1(bash)2.5 E F0(attempts to preserv)2.5 E 2.5(ew)-.15 G +(hat the user typed.)-2.5 E F1(dirspell)144 660 Q F0 .859(If set,)7.77 F F1(bash)3.359 E F0 .858 (attempts spelling correction on directory names during w)3.359 F .858 (ord completion if)-.1 F -(the directory name initially supplied does not e)184 636 Q(xist.)-.15 E -F1(dotglob)144 648 Q F0 .165(If set,)7.77 F F1(bash)2.665 E F0 .165 +(the directory name initially supplied does not e)184 672 Q(xist.)-.15 E +F1(dotglob)144 684 Q F0 .165(If set,)7.77 F F1(bash)2.665 E F0 .165 (includes \214lenames be)2.665 F .165(ginning with a `.)-.15 F 2.665('i) -.7 G 2.665(nt)-2.665 G .165(he results of pathname e)-2.665 F -(xpansion.)-.15 E F1(execfail)144 660 Q F0 1.387 +(xpansion.)-.15 E F1(execfail)144 696 Q F0 1.387 (If set, a non-interacti)7.79 F 1.687 -.15(ve s)-.25 H 1.386 (hell will not e).15 F 1.386(xit if it cannot e)-.15 F -.15(xe)-.15 G -1.386(cute the \214le speci\214ed as an).15 F(ar)184 672 Q +1.386(cute the \214le speci\214ed as an).15 F(ar)184 708 Q (gument to the)-.18 E F1(exec)2.5 E F0 -.2(bu)2.5 G(iltin command.).2 E (An interacti)5 E .3 -.15(ve s)-.25 H(hell does not e).15 E(xit if)-.15 -E F1(exec)2.5 E F0 -.1(fa)2.5 G(ils.).1 E F1(expand_aliases)144 684 Q F0 -.716(If set, aliases are e)184 696 R .717(xpanded as described abo)-.15 -F 1.017 -.15(ve u)-.15 H(nder).15 E F2(ALIASES)3.217 E F3(.)A F0 .717 -(This option is enabled)5.217 F(by def)184 708 Q(ault for interacti)-.1 -E .3 -.15(ve s)-.25 H(hells.).15 E(GNU Bash 4.2)72 768 Q(2012 July 5) -151.505 E(67)200.665 E 0 Cg EP +E F1(exec)2.5 E F0 -.1(fa)2.5 G(ils.).1 E(GNU Bash 4.2)72 768 Q +(2012 July 14)149.005 E(67)198.165 E 0 Cg EP %%Page: 68 68 %%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/Times-Bold@0 SF(extdeb)144 84 Q(ug)-.2 E F0(If set, beha) -184 96 Q(vior intended for use by deb)-.2 E(uggers is enabled:)-.2 E F1 -(1.)184 108 Q F0(The)28.5 E F1<ad46>4.251 E F0 1.751(option to the)4.251 -F F1(declar)4.251 E(e)-.18 E F0 -.2(bu)4.251 G 1.751 +-.35 E/F1 10/Times-Bold@0 SF(expand_aliases)144 84 Q F0 .716 +(If set, aliases are e)184 96 R .717(xpanded as described abo)-.15 F +1.017 -.15(ve u)-.15 H(nder).15 E/F2 9/Times-Bold@0 SF(ALIASES)3.217 E +/F3 9/Times-Roman@0 SF(.)A F0 .717(This option is enabled)5.217 F +(by def)184 108 Q(ault for interacti)-.1 E .3 -.15(ve s)-.25 H(hells.) +.15 E F1(extdeb)144 120 Q(ug)-.2 E F0(If set, beha)184 132 Q +(vior intended for use by deb)-.2 E(uggers is enabled:)-.2 E F1(1.)184 +144 Q F0(The)28.5 E F1<ad46>4.251 E F0 1.751(option to the)4.251 F F1 +(declar)4.251 E(e)-.18 E F0 -.2(bu)4.251 G 1.751 (iltin displays the source \214le name and line).2 F -(number corresponding to each function name supplied as an ar)220 120 Q -(gument.)-.18 E F1(2.)184 132 Q F0 1.667(If the command run by the)28.5 +(number corresponding to each function name supplied as an ar)220 156 Q +(gument.)-.18 E F1(2.)184 168 Q F0 1.667(If the command run by the)28.5 F F1(DEB)4.167 E(UG)-.1 E F0 1.667(trap returns a non-zero v)4.167 F -1.667(alue, the ne)-.25 F(xt)-.15 E(command is skipped and not e)220 144 -Q -.15(xe)-.15 G(cuted.).15 E F1(3.)184 156 Q F0 .841 +1.667(alue, the ne)-.25 F(xt)-.15 E(command is skipped and not e)220 180 +Q -.15(xe)-.15 G(cuted.).15 E F1(3.)184 192 Q F0 .841 (If the command run by the)28.5 F F1(DEB)3.341 E(UG)-.1 E F0 .841 (trap returns a v)3.341 F .84(alue of 2, and the shell is)-.25 F -.15 -(exe)220 168 S .488 +(exe)220 204 S .488 (cuting in a subroutine \(a shell function or a shell script e).15 F -.15(xe)-.15 G .488(cuted by the).15 F F1(.)2.988 E F0(or)2.988 E F1 -(sour)220 180 Q(ce)-.18 E F0 -.2(bu)2.5 G(iltins\), a call to).2 E F1 --.18(re)2.5 G(tur).18 E(n)-.15 E F0(is simulated.)2.5 E F1(4.)184 192 Q -/F2 9/Times-Bold@0 SF -.27(BA)28.5 G(SH_ARGC).27 E F0(and)3.154 E F2 --.27(BA)3.404 G(SH_ARGV).27 E F0 .904 -(are updated as described in their descriptions)3.154 F(abo)220 204 Q --.15(ve)-.15 G(.).15 E F1(5.)184 216 Q F0 1.359 +(sour)220 216 Q(ce)-.18 E F0 -.2(bu)2.5 G(iltins\), a call to).2 E F1 +-.18(re)2.5 G(tur).18 E(n)-.15 E F0(is simulated.)2.5 E F1(4.)184 228 Q +F2 -.27(BA)28.5 G(SH_ARGC).27 E F0(and)3.154 E F2 -.27(BA)3.404 G +(SH_ARGV).27 E F0 .904(are updated as described in their descriptions) +3.154 F(abo)220 240 Q -.15(ve)-.15 G(.).15 E F1(5.)184 252 Q F0 1.359 (Function tracing is enabled:)28.5 F 1.359 (command substitution, shell functions, and sub-)6.359 F(shells in)220 -228 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G(ith)-2.5 E F1(\()2.5 E/F3 10 +264 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G(ith)-2.5 E F1(\()2.5 E/F4 10 /Times-Italic@0 SF(command)2.5 E F1(\))2.5 E F0(inherit the)2.5 E F1 (DEB)2.5 E(UG)-.1 E F0(and)2.5 E F1(RETURN)2.5 E F0(traps.)2.5 E F1(6.) -184 240 Q F0 .805(Error tracing is enabled:)28.5 F .804 -(command substitution, shell functions, and subshells)5.805 F(in)220 252 -Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G(ith)-2.5 E F1(\()2.5 E F3 +184 276 Q F0 .805(Error tracing is enabled:)28.5 F .804 +(command substitution, shell functions, and subshells)5.805 F(in)220 288 +Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G(ith)-2.5 E F1(\()2.5 E F4 (command)2.5 E F1(\))2.5 E F0(inherit the)2.5 E F1(ERR)2.5 E F0(trap.) -2.5 E F1(extglob)144 264 Q F0 .4(If set, the e)8.89 F .4 +2.5 E F1(extglob)144 300 Q F0 .4(If set, the e)8.89 F .4 (xtended pattern matching features described abo)-.15 F .7 -.15(ve u) --.15 H(nder).15 E F1 -.1(Pa)2.9 G .4(thname Expan-).1 F(sion)184 276 Q -F0(are enabled.)2.5 E F1(extquote)144 288 Q F0 2.473(If set,)184 300 R -F1($)4.973 E F0<08>A F3(string)A F0 4.973<0861>C(nd)-4.973 E F1($)4.973 -E F0(")A F3(string)A F0 4.973("q)C 2.473(uoting is performed within) --4.973 F F1(${)4.973 E F3(par)A(ameter)-.15 E F1(})A F0 -.15(ex)4.973 G -(pansions).15 E(enclosed in double quotes.)184 312 Q -(This option is enabled by def)5 E(ault.)-.1 E F1(failglob)144 324 Q F0 +-.15 H(nder).15 E F1 -.1(Pa)2.9 G .4(thname Expan-).1 F(sion)184 312 Q +F0(are enabled.)2.5 E F1(extquote)144 324 Q F0 2.473(If set,)184 336 R +F1($)4.973 E F0<08>A F4(string)A F0 4.973<0861>C(nd)-4.973 E F1($)4.973 +E F0(")A F4(string)A F0 4.973("q)C 2.473(uoting is performed within) +-4.973 F F1(${)4.973 E F4(par)A(ameter)-.15 E F1(})A F0 -.15(ex)4.973 G +(pansions).15 E(enclosed in double quotes.)184 348 Q +(This option is enabled by def)5 E(ault.)-.1 E F1(failglob)144 360 Q F0 1.424(If set, patterns which f)7.77 F 1.425 (ail to match \214lenames during pathname e)-.1 F 1.425 -(xpansion result in an)-.15 F -.15(ex)184 336 S(pansion error).15 E(.) --.55 E F1 -.25(fo)144 348 S -.18(rc).25 G(e_\214gnor).18 E(e)-.18 E F0 -.937(If set, the suf)184 360 R<8c78>-.25 E .936(es speci\214ed by the) +(xpansion result in an)-.15 F -.15(ex)184 372 S(pansion error).15 E(.) +-.55 E F1 -.25(fo)144 384 S -.18(rc).25 G(e_\214gnor).18 E(e)-.18 E F0 +.937(If set, the suf)184 396 R<8c78>-.25 E .936(es speci\214ed by the) -.15 F F2(FIGNORE)3.436 E F0 .936(shell v)3.186 F .936(ariable cause w) --.25 F .936(ords to be ignored)-.1 F .32(when performing w)184 372 R .32 +-.25 F .936(ords to be ignored)-.1 F .32(when performing w)184 408 R .32 (ord completion e)-.1 F -.15(ve)-.25 G 2.82(ni).15 G 2.82(ft)-2.82 G .32 (he ignored w)-2.82 F .32(ords are the only possible com-)-.1 F 2.948 -(pletions. See)184 384 R F2 .448(SHELL V)2.948 F(ARIABLES)-1.215 E F0 +(pletions. See)184 420 R F2 .448(SHELL V)2.948 F(ARIABLES)-1.215 E F0 (abo)2.698 E .748 -.15(ve f)-.15 H .448(or a description of).15 F F2 -(FIGNORE)2.947 E/F4 9/Times-Roman@0 SF(.)A F0 .447(This option is)4.947 -F(enabled by def)184 396 Q(ault.)-.1 E F1(globasciiranges)144 408 Q F0 -.805(If set, range e)184 420 R .806 +(FIGNORE)2.947 E F3(.)A F0 .447(This option is)4.947 F(enabled by def) +184 432 Q(ault.)-.1 E F1(globasciiranges)144 444 Q F0 .805 +(If set, range e)184 456 R .806 (xpressions used in pattern matching \(see)-.15 F F2 -.09(Pa)3.306 G (tter).09 E 3.056(nM)-.135 G(atching)-3.056 E F0(abo)3.056 E -.15(ve) -.15 G 3.306(\)b).15 G(eha)-3.306 E -.15(ve)-.2 G 2.089 -(as if in the traditional C locale when performing comparisons.)184 432 -R 2.089(That is, the current)7.089 F(locale')184 444 Q 2.613(sc)-.55 G +(as if in the traditional C locale when performing comparisons.)184 468 +R 2.089(That is, the current)7.089 F(locale')184 480 Q 2.613(sc)-.55 G .113(ollating sequence is not tak)-2.613 F .113(en into account, so)-.1 F F1(b)2.613 E F0 .114(will not collate between)2.613 F F1(A)2.614 E F0 -(and)2.614 E F1(B)184 456 Q F0 2.5(,a)C(nd upper)-2.5 E(-case and lo)-.2 +(and)2.614 E F1(B)184 492 Q F0 2.5(,a)C(nd upper)-2.5 E(-case and lo)-.2 E(wer)-.25 E(-case ASCII characters will collate together)-.2 E(.)-.55 E -F1(globstar)144 468 Q F0 .519(If set, the pattern)5 F F1(**)3.019 E F0 +F1(globstar)144 504 Q F0 .519(If set, the pattern)5 F F1(**)3.019 E F0 .519(used in a pathname e)3.019 F .519(xpansion conte)-.15 F .518 (xt will match all \214les and zero)-.15 F .431 -(or more directories and subdirectories.)184 480 R .431 +(or more directories and subdirectories.)184 516 R .431 (If the pattern is follo)5.431 F .432(wed by a)-.25 F F1(/)2.932 E F0 2.932(,o)C .432(nly directories)-2.932 F(and subdirectories match.)184 -492 Q F1(gnu_errfmt)144 504 Q F0(If set, shell error messages are writt\ -en in the standard GNU error message format.)184 516 Q F1(histappend)144 -528 Q F0 .676 +528 Q F1(gnu_errfmt)144 540 Q F0(If set, shell error messages are writt\ +en in the standard GNU error message format.)184 552 Q F1(histappend)144 +564 Q F0 .676 (If set, the history list is appended to the \214le named by the v)184 -540 R .676(alue of the)-.25 F F2(HISTFILE)3.176 E F0 -.25(va)2.926 G -(ri-).25 E(able when the shell e)184 552 Q(xits, rather than o)-.15 E --.15(ve)-.15 G(rwriting the \214le.).15 E F1(histr)144 564 Q(eedit)-.18 -E F0 .575(If set, and)184 576 R F1 -.18(re)3.075 G(adline).18 E F0 .575 +576 R .676(alue of the)-.25 F F2(HISTFILE)3.176 E F0 -.25(va)2.926 G +(ri-).25 E(able when the shell e)184 588 Q(xits, rather than o)-.15 E +-.15(ve)-.15 G(rwriting the \214le.).15 E F1(histr)144 600 Q(eedit)-.18 +E F0 .575(If set, and)184 612 R F1 -.18(re)3.075 G(adline).18 E F0 .575 (is being used, a user is gi)3.075 F -.15(ve)-.25 G 3.075(nt).15 G .576 (he opportunity to re-edit a f)-3.075 F .576(ailed his-)-.1 F -(tory substitution.)184 588 Q F1(histv)144 600 Q(erify)-.1 E F0 .403 -(If set, and)184 612 R F1 -.18(re)2.903 G(adline).18 E F0 .403 +(tory substitution.)184 624 Q F1(histv)144 636 Q(erify)-.1 E F0 .403 +(If set, and)184 648 R F1 -.18(re)2.903 G(adline).18 E F0 .403 (is being used, the results of history substitution are not immediately) -2.903 F .661(passed to the shell parser)184 624 R 5.661(.I)-.55 G .662 +2.903 F .661(passed to the shell parser)184 660 R 5.661(.I)-.55 G .662 (nstead, the resulting line is loaded into the)-5.661 F F1 -.18(re)3.162 -G(adline).18 E F0(editing)3.162 E -.2(bu)184 636 S -.25(ff).2 G(er).25 E +G(adline).18 E F0(editing)3.162 E -.2(bu)184 672 S -.25(ff).2 G(er).25 E 2.5(,a)-.4 G(llo)-2.5 E(wing further modi\214cation.)-.25 E F1 -(hostcomplete)144 648 Q F0 1.182(If set, and)184 660 R F1 -.18(re)3.682 +(hostcomplete)144 684 Q F0 1.182(If set, and)184 696 R F1 -.18(re)3.682 G(adline).18 E F0 1.182(is being used,)3.682 F F1(bash)3.682 E F0 1.181 (will attempt to perform hostname completion)3.681 F 1.38(when a w)184 -672 R 1.38(ord containing a)-.1 F F1(@)3.881 E F0 1.381 +708 R 1.38(ord containing a)-.1 F F1(@)3.881 E F0 1.381 (is being completed \(see)3.881 F F1(Completing)3.881 E F0(under)3.881 E -F2(READLINE)3.881 E F0(abo)184 684 Q -.15(ve)-.15 G 2.5(\). This).15 F -(is enabled by def)2.5 E(ault.)-.1 E F1(huponexit)144 696 Q F0(If set,) -184 708 Q F1(bash)2.5 E F0(will send)2.5 E F2(SIGHUP)2.5 E F0 -(to all jobs when an interacti)2.25 E .3 -.15(ve l)-.25 H(ogin shell e) -.15 E(xits.)-.15 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(68) -200.665 E 0 Cg EP +F2(READLINE)3.881 E F0(abo)184 720 Q -.15(ve)-.15 G 2.5(\). This).15 F +(is enabled by def)2.5 E(ault.)-.1 E(GNU Bash 4.2)72 768 Q(2012 July 14) +149.005 E(68)198.165 E 0 Cg EP %%Page: 69 69 %%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/Times-Bold@0 SF(interacti)144 84 Q -.1(ve)-.1 G(_comments) -.1 E F0 .33(If set, allo)184 96 R 2.83(waw)-.25 G .33(ord be)-2.93 F .33 +-.35 E/F1 10/Times-Bold@0 SF(huponexit)144 84 Q F0(If set,)184 96 Q F1 +(bash)2.5 E F0(will send)2.5 E/F2 9/Times-Bold@0 SF(SIGHUP)2.5 E F0 +(to all jobs when an interacti)2.25 E .3 -.15(ve l)-.25 H(ogin shell e) +.15 E(xits.)-.15 E F1(interacti)144 108 Q -.1(ve)-.1 G(_comments).1 E F0 +.33(If set, allo)184 120 R 2.83(waw)-.25 G .33(ord be)-2.93 F .33 (ginning with)-.15 F F1(#)2.83 E F0 .33(to cause that w)2.83 F .33 (ord and all remaining characters on)-.1 F .967 -(that line to be ignored in an interacti)184 108 R 1.267 -.15(ve s)-.25 -H .967(hell \(see).15 F/F2 9/Times-Bold@0 SF(COMMENTS)3.467 E F0(abo) -3.217 E -.15(ve)-.15 G 3.467(\). This).15 F .968(option is)3.468 F -(enabled by def)184 120 Q(ault.)-.1 E F1(lastpipe)144 132 Q F0 1.212 +(that line to be ignored in an interacti)184 132 R 1.267 -.15(ve s)-.25 +H .967(hell \(see).15 F F2(COMMENTS)3.467 E F0(abo)3.217 E -.15(ve)-.15 +G 3.467(\). This).15 F .968(option is)3.468 F(enabled by def)184 144 Q +(ault.)-.1 E F1(lastpipe)144 156 Q F0 1.212 (If set, and job control is not acti)6.66 F -.15(ve)-.25 G 3.712(,t).15 G 1.212(he shell runs the last command of a pipeline not)-3.712 F -.15 -(exe)184 144 S(cuted in the background in the current shell en).15 E -(vironment.)-.4 E F1(lithist)144 156 Q F0 .654(If set, and the)15.55 F +(exe)184 168 S(cuted in the background in the current shell en).15 E +(vironment.)-.4 E F1(lithist)144 180 Q F0 .654(If set, and the)15.55 F F1(cmdhist)3.154 E F0 .654 (option is enabled, multi-line commands are sa)3.154 F -.15(ve)-.2 G 3.155(dt).15 G 3.155(ot)-3.155 G .655(he history)-3.155 F -(with embedded ne)184 168 Q +(with embedded ne)184 192 Q (wlines rather than using semicolon separators where possible.)-.25 E F1 -(login_shell)144 180 Q F0 .486 +(login_shell)144 204 Q F0 .486 (The shell sets this option if it is started as a login shell \(see)184 -192 R F2(INV)2.986 E(OCA)-.405 E(TION)-.855 E F0(abo)2.736 E -.15(ve) --.15 G 2.986(\). The).15 F -.25(va)184 204 S(lue may not be changed.).25 -E F1(mailwar)144 216 Q(n)-.15 E F0 .814(If set, and a \214le that)184 -228 R F1(bash)3.314 E F0 .815 +216 R F2(INV)2.986 E(OCA)-.405 E(TION)-.855 E F0(abo)2.736 E -.15(ve) +-.15 G 2.986(\). The).15 F -.25(va)184 228 S(lue may not be changed.).25 +E F1(mailwar)144 240 Q(n)-.15 E F0 .814(If set, and a \214le that)184 +252 R F1(bash)3.314 E F0 .815 (is checking for mail has been accessed since the last time it)3.314 F --.1(wa)184 240 S 2.5(sc).1 G(heck)-2.5 E(ed, the message `)-.1 E +-.1(wa)184 264 S 2.5(sc).1 G(heck)-2.5 E(ed, the message `)-.1 E (`The mail in)-.74 E/F3 10/Times-Italic@0 SF(mail\214le)2.5 E F0 (has been read')2.5 E 2.5('i)-.74 G 2.5(sd)-2.5 G(isplayed.)-2.5 E F1 -(no_empty_cmd_completion)144 252 Q F0 .325(If set, and)184 264 R F1 -.18 +(no_empty_cmd_completion)144 276 Q F0 .325(If set, and)184 288 R F1 -.18 (re)2.825 G(adline).18 E F0 .325(is being used,)2.825 F F1(bash)2.824 E F0 .324(will not attempt to search the)2.824 F F2 -.666(PA)2.824 G(TH) -.189 E F0 .324(for possible)2.574 F -(completions when completion is attempted on an empty line.)184 276 Q F1 -(nocaseglob)144 288 Q F0 .436(If set,)184 300 R F1(bash)2.936 E F0 .436 +(completions when completion is attempted on an empty line.)184 300 Q F1 +(nocaseglob)144 312 Q F0 .436(If set,)184 324 R F1(bash)2.936 E F0 .436 (matches \214lenames in a case\255insensiti)2.936 F .737 -.15(ve f)-.25 -H .437(ashion when performing pathname).05 F -.15(ex)184 312 S +H .437(ashion when performing pathname).05 F -.15(ex)184 336 S (pansion \(see).15 E F1 -.1(Pa)2.5 G(thname Expansion).1 E F0(abo)2.5 E --.15(ve)-.15 G(\).).15 E F1(nocasematch)144 324 Q F0 1.194(If set,)184 -336 R F1(bash)3.694 E F0 1.194(matches patterns in a case\255insensiti) +-.15(ve)-.15 G(\).).15 E F1(nocasematch)144 348 Q F0 1.194(If set,)184 +360 R F1(bash)3.694 E F0 1.194(matches patterns in a case\255insensiti) 3.694 F 1.493 -.15(ve f)-.25 H 1.193(ashion when performing matching).05 -F(while e)184 348 Q -.15(xe)-.15 G(cuting).15 E F1(case)2.5 E F0(or)2.5 -E F1([[)2.5 E F0(conditional commands.)2.5 E F1(nullglob)144 360 Q F0 -.854(If set,)184 372 R F1(bash)3.354 E F0(allo)3.354 E .855 +F(while e)184 372 Q -.15(xe)-.15 G(cuting).15 E F1(case)2.5 E F0(or)2.5 +E F1([[)2.5 E F0(conditional commands.)2.5 E F1(nullglob)144 384 Q F0 +.854(If set,)184 396 R F1(bash)3.354 E F0(allo)3.354 E .855 (ws patterns which match no \214les \(see)-.25 F F1 -.1(Pa)3.355 G .855 (thname Expansion).1 F F0(abo)3.355 E -.15(ve)-.15 G 3.355(\)t).15 G(o) --3.355 E -.15(ex)184 384 S(pand to a null string, rather than themselv) -.15 E(es.)-.15 E F1(pr)144 396 Q(ogcomp)-.18 E F0 .677 -(If set, the programmable completion f)184 408 R .677(acilities \(see) +-3.355 E -.15(ex)184 408 S(pand to a null string, rather than themselv) +.15 E(es.)-.15 E F1(pr)144 420 Q(ogcomp)-.18 E F0 .677 +(If set, the programmable completion f)184 432 R .677(acilities \(see) -.1 F F1(Pr)3.176 E .676(ogrammable Completion)-.18 F F0(abo)3.176 E --.15(ve)-.15 G(\)).15 E(are enabled.)184 420 Q -(This option is enabled by def)5 E(ault.)-.1 E F1(pr)144 432 Q(omptv) --.18 E(ars)-.1 E F0 1.447(If set, prompt strings under)184 444 R 1.448 +-.15(ve)-.15 G(\)).15 E(are enabled.)184 444 Q +(This option is enabled by def)5 E(ault.)-.1 E F1(pr)144 456 Q(omptv) +-.18 E(ars)-.1 E F0 1.447(If set, prompt strings under)184 468 R 1.448 (go parameter e)-.18 F 1.448(xpansion, command substitution, arithmetic) --.15 F -.15(ex)184 456 S .171(pansion, and quote remo).15 F -.25(va)-.15 +-.15 F -.15(ex)184 480 S .171(pansion, and quote remo).15 F -.25(va)-.15 G 2.67(la).25 G .17(fter being e)-2.67 F .17(xpanded as described in) -.15 F F2(PR)2.67 E(OMPTING)-.27 E F0(abo)2.42 E -.15(ve)-.15 G(.).15 E -(This option is enabled by def)184 468 Q(ault.)-.1 E F1 -.18(re)144 480 +(This option is enabled by def)184 492 Q(ault.)-.1 E F1 -.18(re)144 504 S(stricted_shell).18 E F0 1.069 (The shell sets this option if it is started in restricted mode \(see) -184 492 R F2 1.069(RESTRICTED SHELL)3.569 F F0(belo)184 504 Q 4.178 +184 516 R F2 1.069(RESTRICTED SHELL)3.569 F F0(belo)184 528 Q 4.178 (w\). The)-.25 F -.25(va)4.178 G 1.678(lue may not be changed.).25 F 1.678(This is not reset when the startup \214les are)6.678 F -.15(exe) -184 516 S(cuted, allo).15 E(wing the startup \214les to disco)-.25 E +184 540 S(cuted, allo).15 E(wing the startup \214les to disco)-.25 E -.15(ve)-.15 G 2.5(rw).15 G(hether or not a shell is restricted.)-2.5 E -F1(shift_v)144 528 Q(erbose)-.1 E F0 .501(If set, the)184 540 R F1 +F1(shift_v)144 552 Q(erbose)-.1 E F0 .501(If set, the)184 564 R F1 (shift)3.001 E F0 -.2(bu)3.001 G .501 (iltin prints an error message when the shift count e).2 F .502 -(xceeds the number)-.15 F(of positional parameters.)184 552 Q F1(sour) -144 564 Q(cepath)-.18 E F0 .771(If set, the)184 576 R F1(sour)3.271 E +(xceeds the number)-.15 F(of positional parameters.)184 576 Q F1(sour) +144 588 Q(cepath)-.18 E F0 .771(If set, the)184 600 R F1(sour)3.271 E (ce)-.18 E F0(\()3.271 E F1(.)A F0 3.271(\)b)C .771(uiltin uses the v) -3.471 F .771(alue of)-.25 F F2 -.666(PA)3.27 G(TH)-.189 E F0 .77 (to \214nd the directory containing the)3.02 F(\214le supplied as an ar) -184 588 Q 2.5(gument. This)-.18 F(option is enabled by def)2.5 E(ault.) --.1 E F1(xpg_echo)144 600 Q F0(If set, the)184 612 Q F1(echo)2.5 E F0 +184 612 Q 2.5(gument. This)-.18 F(option is enabled by def)2.5 E(ault.) +-.1 E F1(xpg_echo)144 624 Q F0(If set, the)184 636 Q F1(echo)2.5 E F0 -.2(bu)2.5 G(iltin e).2 E(xpands backslash-escape sequences by def)-.15 -E(ault.)-.1 E F1(suspend)108 628.8 Q F0([)2.5 E F1<ad66>A F0(])A 1.001 -(Suspend the e)144 640.8 R -.15(xe)-.15 G 1.001 +E(ault.)-.1 E F1(suspend)108 652.8 Q F0([)2.5 E F1<ad66>A F0(])A 1.001 +(Suspend the e)144 664.8 R -.15(xe)-.15 G 1.001 (cution of this shell until it recei).15 F -.15(ve)-.25 G 3.501(sa).15 G F2(SIGCONT)A F0 3.502(signal. A)3.252 F 1.002(login shell cannot be) -3.502 F .023(suspended; the)144 652.8 R F1<ad66>2.523 E F0 .023 +3.502 F .023(suspended; the)144 676.8 R F1<ad66>2.523 E F0 .023 (option can be used to o)2.523 F -.15(ve)-.15 G .022 (rride this and force the suspension.).15 F .022(The return status is) -5.022 F 2.5(0u)144 664.8 S(nless the shell is a login shell and)-2.5 E +5.022 F 2.5(0u)144 688.8 S(nless the shell is a login shell and)-2.5 E F1<ad66>2.5 E F0(is not supplied, or if job control is not enabled.)2.5 -E F1(test)108 681.6 Q F3 -.2(ex)2.5 G(pr).2 E F1([)108 693.6 Q F3 -.2 +E F1(test)108 705.6 Q F3 -.2(ex)2.5 G(pr).2 E F1([)108 717.6 Q F3 -.2 (ex)2.5 G(pr).2 E F1(])2.5 E F0 .877 (Return a status of 0 \(true\) or 1 \(f)6.77 F .878 (alse\) depending on the e)-.1 F -.25(va)-.25 G .878 -(luation of the conditional e).25 F(xpression)-.15 E F3 -.2(ex)144 705.6 +(luation of the conditional e).25 F(xpression)-.15 E F3 -.2(ex)144 729.6 S(pr).2 E F0 5.53(.E).73 G .53 (ach operator and operand must be a separate ar)-5.53 F 3.03 -(gument. Expressions)-.18 F .53(are composed of the)3.03 F 3.079 -(primaries described abo)144 717.6 R 3.379 -.15(ve u)-.15 H(nder).15 E -F2(CONDITION)5.579 E 3.079(AL EXPRESSIONS)-.18 F/F4 9/Times-Roman@0 SF -(.)A F1(test)7.579 E F0 3.08(does not accept an)5.58 F(y)-.15 E -(options, nor does it accept and ignore an ar)144 729.6 Q(gument of)-.18 -E F1<adad>2.5 E F0(as signifying the end of options.)2.5 E(GNU Bash 4.2) -72 768 Q(2012 July 5)151.505 E(69)200.665 E 0 Cg EP +(gument. Expressions)-.18 F .53(are composed of the)3.03 F(GNU Bash 4.2) +72 768 Q(2012 July 14)149.005 E(69)198.165 E 0 Cg EP %%Page: 70 70 %%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 .786(Expressions may be combined using the follo)144 84 R .785 +-.35 E 3.079(primaries described abo)144 84 R 3.379 -.15(ve u)-.15 H +(nder).15 E/F1 9/Times-Bold@0 SF(CONDITION)5.579 E 3.079(AL EXPRESSIONS) +-.18 F/F2 9/Times-Roman@0 SF(.)A/F3 10/Times-Bold@0 SF(test)7.579 E F0 +3.08(does not accept an)5.58 F(y)-.15 E +(options, nor does it accept and ignore an ar)144 96 Q(gument of)-.18 E +F3<adad>2.5 E F0(as signifying the end of options.)2.5 E .786 +(Expressions may be combined using the follo)144 114 R .785 (wing operators, listed in decreasing order of prece-)-.25 F 3.411 -(dence. The)144 96 R -.25(eva)3.411 G .911 +(dence. The)144 126 R -.25(eva)3.411 G .911 (luation depends on the number of ar).25 F .912(guments; see belo)-.18 F 4.712 -.65(w. O)-.25 H .912(perator precedence is).65 F -(used when there are \214v)144 108 Q 2.5(eo)-.15 G 2.5(rm)-2.5 G(ore ar) --2.5 E(guments.)-.18 E/F1 10/Times-Bold@0 SF(!)144 120 Q/F2 10 -/Times-Italic@0 SF -.2(ex)2.5 G(pr).2 E F0 -.35(Tr)12.6 G(ue if).35 E F2 --.2(ex)2.5 G(pr).2 E F0(is f)3.23 E(alse.)-.1 E F1(\()144 132 Q F2 -.2 -(ex)2.5 G(pr).2 E F1(\))2.5 E F0 .26(Returns the v)6.77 F .26(alue of) --.25 F F2 -.2(ex)2.76 G(pr).2 E F0 5.26(.T)C .26(his may be used to o) --5.26 F -.15(ve)-.15 G .26(rride the normal precedence of opera-).15 F -(tors.)180 144 Q F2 -.2(ex)144 156 S(pr1).2 E F0<ad>2.5 E F1(a)A F2 -.2 -(ex)2.5 G(pr2).2 E F0 -.35(Tr)180 168 S(ue if both).35 E F2 -.2(ex)2.5 G -(pr1).2 E F0(and)2.5 E F2 -.2(ex)2.5 G(pr2).2 E F0(are true.)2.52 E F2 --.2(ex)144 180 S(pr1).2 E F0<ad>2.5 E F1(o)A F2 -.2(ex)2.5 G(pr2).2 E F0 --.35(Tr)180 192 S(ue if either).35 E F2 -.2(ex)2.5 G(pr1).2 E F0(or)2.5 -E F2 -.2(ex)2.5 G(pr2).2 E F0(is true.)2.52 E F1(test)144 208.8 Q F0 -(and)2.5 E F1([)2.5 E F0 -.25(eva)2.5 G(luate conditional e).25 E +(used when there are \214v)144 138 Q 2.5(eo)-.15 G 2.5(rm)-2.5 G(ore ar) +-2.5 E(guments.)-.18 E F3(!)144 150 Q/F4 10/Times-Italic@0 SF -.2(ex)2.5 +G(pr).2 E F0 -.35(Tr)12.6 G(ue if).35 E F4 -.2(ex)2.5 G(pr).2 E F0(is f) +3.23 E(alse.)-.1 E F3(\()144 162 Q F4 -.2(ex)2.5 G(pr).2 E F3(\))2.5 E +F0 .26(Returns the v)6.77 F .26(alue of)-.25 F F4 -.2(ex)2.76 G(pr).2 E +F0 5.26(.T)C .26(his may be used to o)-5.26 F -.15(ve)-.15 G .26 +(rride the normal precedence of opera-).15 F(tors.)180 174 Q F4 -.2(ex) +144 186 S(pr1).2 E F0<ad>2.5 E F3(a)A F4 -.2(ex)2.5 G(pr2).2 E F0 -.35 +(Tr)180 198 S(ue if both).35 E F4 -.2(ex)2.5 G(pr1).2 E F0(and)2.5 E F4 +-.2(ex)2.5 G(pr2).2 E F0(are true.)2.52 E F4 -.2(ex)144 210 S(pr1).2 E +F0<ad>2.5 E F3(o)A F4 -.2(ex)2.5 G(pr2).2 E F0 -.35(Tr)180 222 S +(ue if either).35 E F4 -.2(ex)2.5 G(pr1).2 E F0(or)2.5 E F4 -.2(ex)2.5 G +(pr2).2 E F0(is true.)2.52 E F3(test)144 238.8 Q F0(and)2.5 E F3([)2.5 E +F0 -.25(eva)2.5 G(luate conditional e).25 E (xpressions using a set of rules based on the number of ar)-.15 E -(guments.)-.18 E 2.5(0a)144 226.8 S -.18(rg)-2.5 G(uments).18 E(The e) -180 238.8 Q(xpression is f)-.15 E(alse.)-.1 E 2.5(1a)144 250.8 S -.18 -(rg)-2.5 G(ument).18 E(The e)180 262.8 Q +(guments.)-.18 E 2.5(0a)144 256.8 S -.18(rg)-2.5 G(uments).18 E(The e) +180 268.8 Q(xpression is f)-.15 E(alse.)-.1 E 2.5(1a)144 280.8 S -.18 +(rg)-2.5 G(ument).18 E(The e)180 292.8 Q (xpression is true if and only if the ar)-.15 E(gument is not null.)-.18 -E 2.5(2a)144 274.8 S -.18(rg)-2.5 G(uments).18 E .37(If the \214rst ar) -180 286.8 R .37(gument is)-.18 F F1(!)2.87 E F0 2.87(,t)C .37(he e)-2.87 +E 2.5(2a)144 304.8 S -.18(rg)-2.5 G(uments).18 E .37(If the \214rst ar) +180 316.8 R .37(gument is)-.18 F F3(!)2.87 E F0 2.87(,t)C .37(he e)-2.87 F .37(xpression is true if and only if the second ar)-.15 F .37 -(gument is null.)-.18 F .38(If the \214rst ar)180 298.8 R .38 +(gument is null.)-.18 F .38(If the \214rst ar)180 328.8 R .38 (gument is one of the unary conditional operators listed abo)-.18 F .679 --.15(ve u)-.15 H(nder).15 E/F3 9/Times-Bold@0 SF(CONDI-)2.879 E(TION)180 -310.8 Q .552(AL EXPRESSIONS)-.18 F/F4 9/Times-Roman@0 SF(,)A F0 .552 -(the e)2.802 F .552(xpression is true if the unary test is true.)-.15 F -.552(If the \214rst ar)5.552 F(gu-)-.18 E(ment is not a v)180 322.8 Q +-.15(ve u)-.15 H(nder).15 E F1(CONDI-)2.879 E(TION)180 340.8 Q .552 +(AL EXPRESSIONS)-.18 F F2(,)A F0 .552(the e)2.802 F .552 +(xpression is true if the unary test is true.)-.15 F .552 +(If the \214rst ar)5.552 F(gu-)-.18 E(ment is not a v)180 352.8 Q (alid unary conditional operator)-.25 E 2.5(,t)-.4 G(he e)-2.5 E -(xpression is f)-.15 E(alse.)-.1 E 2.5(3a)144 334.8 S -.18(rg)-2.5 G -(uments).18 E .236(The follo)180 346.8 R .236 +(xpression is f)-.15 E(alse.)-.1 E 2.5(3a)144 364.8 S -.18(rg)-2.5 G +(uments).18 E .236(The follo)180 376.8 R .236 (wing conditions are applied in the order listed.)-.25 F .236 (If the second ar)5.236 F .236(gument is one of)-.18 F .855 -(the binary conditional operators listed abo)180 358.8 R 1.155 -.15 -(ve u)-.15 H(nder).15 E F3(CONDITION)3.355 E .855(AL EXPRESSIONS)-.18 F -F4(,)A F0(the)3.105 E .579(result of the e)180 370.8 R .578(xpression i\ +(the binary conditional operators listed abo)180 388.8 R 1.155 -.15 +(ve u)-.15 H(nder).15 E F1(CONDITION)3.355 E .855(AL EXPRESSIONS)-.18 F +F2(,)A F0(the)3.105 E .579(result of the e)180 400.8 R .578(xpression i\ s the result of the binary test using the \214rst and third ar)-.15 F -(guments)-.18 E 1.332(as operands.)180 382.8 R(The)6.332 E F1<ad61>3.832 -E F0(and)3.832 E F1<ad6f>3.832 E F0 1.333 +(guments)-.18 E 1.332(as operands.)180 412.8 R(The)6.332 E F3<ad61>3.832 +E F0(and)3.832 E F3<ad6f>3.832 E F0 1.333 (operators are considered binary operators when there are)3.832 F .558 -(three ar)180 394.8 R 3.058(guments. If)-.18 F .558(the \214rst ar)3.058 -F .558(gument is)-.18 F F1(!)3.058 E F0 3.058(,t)C .558(he v)-3.058 F +(three ar)180 424.8 R 3.058(guments. If)-.18 F .558(the \214rst ar)3.058 +F .558(gument is)-.18 F F3(!)3.058 E F0 3.058(,t)C .558(he v)-3.058 F .558(alue is the ne)-.25 F -.05(ga)-.15 G .558(tion of the tw).05 F (o-ar)-.1 E(gument)-.18 E .52(test using the second and third ar)180 -406.8 R 3.021(guments. If)-.18 F .521(the \214rst ar)3.021 F .521 -(gument is e)-.18 F(xactly)-.15 E F1(\()3.021 E F0 .521(and the third) -3.021 F(ar)180 418.8 Q .485(gument is e)-.18 F(xactly)-.15 E F1(\))2.985 +436.8 R 3.021(guments. If)-.18 F .521(the \214rst ar)3.021 F .521 +(gument is e)-.18 F(xactly)-.15 E F3(\()3.021 E F0 .521(and the third) +3.021 F(ar)180 448.8 Q .485(gument is e)-.18 F(xactly)-.15 E F3(\))2.985 E F0 2.985(,t)C .485(he result is the one-ar)-2.985 F .485 (gument test of the second ar)-.18 F 2.985(gument. Other)-.18 F(-)-.2 E -(wise, the e)180 430.8 Q(xpression is f)-.15 E(alse.)-.1 E 2.5(4a)144 -442.8 S -.18(rg)-2.5 G(uments).18 E .384(If the \214rst ar)180 454.8 R -.384(gument is)-.18 F F1(!)2.884 E F0 2.885(,t)C .385 +(wise, the e)180 460.8 Q(xpression is f)-.15 E(alse.)-.1 E 2.5(4a)144 +472.8 S -.18(rg)-2.5 G(uments).18 E .384(If the \214rst ar)180 484.8 R +.384(gument is)-.18 F F3(!)2.884 E F0 2.885(,t)C .385 (he result is the ne)-2.885 F -.05(ga)-.15 G .385(tion of the three-ar) .05 F .385(gument e)-.18 F .385(xpression com-)-.15 F 1.648 -(posed of the remaining ar)180 466.8 R 4.147(guments. Otherwise,)-.18 F +(posed of the remaining ar)180 496.8 R 4.147(guments. Otherwise,)-.18 F 1.647(the e)4.147 F 1.647(xpression is parsed and e)-.15 F -.25(va)-.25 G(luated).25 E(according to precedence using the rules listed abo)180 -478.8 Q -.15(ve)-.15 G(.).15 E 2.5(5o)144 490.8 S 2.5(rm)-2.5 G(ore ar) --2.5 E(guments)-.18 E 1.635(The e)180 502.8 R 1.635 +508.8 Q -.15(ve)-.15 G(.).15 E 2.5(5o)144 520.8 S 2.5(rm)-2.5 G(ore ar) +-2.5 E(guments)-.18 E 1.635(The e)180 532.8 R 1.635 (xpression is parsed and e)-.15 F -.25(va)-.25 G 1.635 (luated according to precedence using the rules listed).25 F(abo)180 -514.8 Q -.15(ve)-.15 G(.).15 E(When used with)144 532.8 Q F1(test)2.5 E -F0(or)2.5 E F1([)2.5 E F0 2.5(,t)C(he)-2.5 E F1(<)2.5 E F0(and)2.5 E F1 +544.8 Q -.15(ve)-.15 G(.).15 E(When used with)144 562.8 Q F3(test)2.5 E +F0(or)2.5 E F3([)2.5 E F0 2.5(,t)C(he)-2.5 E F3(<)2.5 E F0(and)2.5 E F3 (>)2.5 E F0(operators sort le)2.5 E -(xicographically using ASCII ordering.)-.15 E F1(times)108 549.6 Q F0 +(xicographically using ASCII ordering.)-.15 E F3(times)108 579.6 Q F0 1.229(Print the accumulated user and system times for the shell and for\ - processes run from the shell.)13.23 F(The return status is 0.)144 561.6 -Q F1(trap)108 578.4 Q F0([)2.5 E F1(\255lp)A F0 2.5(][)C([)-2.5 E F2(ar) -A(g)-.37 E F0(])A F2(sigspec)2.5 E F0(...])2.5 E .702(The command)144 -590.4 R F2(ar)3.532 E(g)-.37 E F0 .702(is to be read and e)3.422 F -.15 + processes run from the shell.)13.23 F(The return status is 0.)144 591.6 +Q F3(trap)108 608.4 Q F0([)2.5 E F3(\255lp)A F0 2.5(][)C([)-2.5 E F4(ar) +A(g)-.37 E F0(])A F4(sigspec)2.5 E F0(...])2.5 E .702(The command)144 +620.4 R F4(ar)3.532 E(g)-.37 E F0 .702(is to be read and e)3.422 F -.15 (xe)-.15 G .702(cuted when the shell recei).15 F -.15(ve)-.25 G 3.203 -(ss).15 G(ignal\(s\))-3.203 E F2(sigspec)3.203 E F0 5.703(.I).31 G(f) --5.703 E F2(ar)3.533 E(g)-.37 E F0(is)3.423 E .609 -(absent \(and there is a single)144 602.4 R F2(sigspec)3.108 E F0 3.108 -(\)o)C(r)-3.108 E F1<ad>3.108 E F0 3.108(,e)C .608 +(ss).15 G(ignal\(s\))-3.203 E F4(sigspec)3.203 E F0 5.703(.I).31 G(f) +-5.703 E F4(ar)3.533 E(g)-.37 E F0(is)3.423 E .609 +(absent \(and there is a single)144 632.4 R F4(sigspec)3.108 E F0 3.108 +(\)o)C(r)-3.108 E F3<ad>3.108 E F0 3.108(,e)C .608 (ach speci\214ed signal is reset to its original disposition)-3.108 F -.658(\(the v)144 614.4 R .658(alue it had upon entrance to the shell\).) --.25 F(If)5.658 E F2(ar)3.488 E(g)-.37 E F0 .659 -(is the null string the signal speci\214ed by each)3.378 F F2(sigspec) -144.34 626.4 Q F0 .581 +.658(\(the v)144 644.4 R .658(alue it had upon entrance to the shell\).) +-.25 F(If)5.658 E F4(ar)3.488 E(g)-.37 E F0 .659 +(is the null string the signal speci\214ed by each)3.378 F F4(sigspec) +144.34 656.4 Q F0 .581 (is ignored by the shell and by the commands it in)3.391 F -.2(vo)-.4 G --.1(ke).2 G 3.08(s. If).1 F F2(ar)3.41 E(g)-.37 E F0 .58 -(is not present and)3.3 F F1<ad70>3.08 E F0(has)3.08 E 1.214 -(been supplied, then the trap commands associated with each)144 638.4 R -F2(sigspec)4.054 E F0 1.215(are displayed.)4.024 F 1.215(If no ar)6.215 -F(gu-)-.18 E .86(ments are supplied or if only)144 650.4 R F1<ad70>3.36 -E F0 .86(is gi)3.36 F -.15(ve)-.25 G(n,).15 E F1(trap)3.36 E F0 .86 +-.1(ke).2 G 3.08(s. If).1 F F4(ar)3.41 E(g)-.37 E F0 .58 +(is not present and)3.3 F F3<ad70>3.08 E F0(has)3.08 E 1.214 +(been supplied, then the trap commands associated with each)144 668.4 R +F4(sigspec)4.054 E F0 1.215(are displayed.)4.024 F 1.215(If no ar)6.215 +F(gu-)-.18 E .86(ments are supplied or if only)144 680.4 R F3<ad70>3.36 +E F0 .86(is gi)3.36 F -.15(ve)-.25 G(n,).15 E F3(trap)3.36 E F0 .86 (prints the list of commands associated with each)3.36 F 2.83 -(signal. The)144 662.4 R F1<ad6c>2.83 E F0 .33(option causes the shell \ +(signal. The)144 692.4 R F3<ad6c>2.83 E F0 .33(option causes the shell \ to print a list of signal names and their corresponding num-)2.83 F -4.311(bers. Each)144 674.4 R F2(sigspec)4.651 E F0 1.811 -(is either a signal name de\214ned in <)4.621 F F2(signal.h)A F0 1.81 +4.311(bers. Each)144 704.4 R F4(sigspec)4.651 E F0 1.811 +(is either a signal name de\214ned in <)4.621 F F4(signal.h)A F0 1.81 (>, or a signal number)B 6.81(.S)-.55 G(ignal)-6.81 E -(names are case insensiti)144 686.4 Q .3 -.15(ve a)-.25 H(nd the).15 E -F3(SIG)2.5 E F0(pre\214x is optional.)2.25 E 1.648(If a)144 704.4 R F2 -(sigspec)4.488 E F0(is)4.458 E F3(EXIT)4.148 E F0 1.648 -(\(0\) the command)3.898 F F2(ar)4.479 E(g)-.37 E F0 1.649(is e)4.369 F --.15(xe)-.15 G 1.649(cuted on e).15 F 1.649(xit from the shell.)-.15 F -1.649(If a)6.649 F F2(sigspec)4.489 E F0(is)4.459 E F3(DEB)144 716.4 Q -(UG)-.09 E F4(,)A F0 1.168(the command)3.418 F F2(ar)3.998 E(g)-.37 E F0 -1.168(is e)3.888 F -.15(xe)-.15 G 1.167(cuted before e).15 F -.15(ve) --.25 G(ry).15 E F2 1.167(simple command)3.667 F F0(,)A F2(for)3.667 E F0 -(command,)3.667 E F2(case)3.667 E F0(com-)3.667 E(mand,)144 728.4 Q F2 -(select)2.646 E F0 .146(command, e)2.646 F -.15(ve)-.25 G .146 -(ry arithmetic).15 F F2(for)2.646 E F0 .147 -(command, and before the \214rst command e)2.646 F -.15(xe)-.15 G .147 -(cutes in a).15 F(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E(70)200.665 -E 0 Cg EP +(names are case insensiti)144 716.4 Q .3 -.15(ve a)-.25 H(nd the).15 E +F1(SIG)2.5 E F0(pre\214x is optional.)2.25 E(GNU Bash 4.2)72 768 Q +(2012 July 14)149.005 E(70)198.165 E 0 Cg EP %%Page: 71 71 %%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 .146(shell function \(see)144 84 R/F1 9/Times-Bold@0 SF .146 +-.35 E 1.648(If a)144 84 R/F1 10/Times-Italic@0 SF(sigspec)4.488 E F0 +(is)4.458 E/F2 9/Times-Bold@0 SF(EXIT)4.148 E F0 1.648 +(\(0\) the command)3.898 F F1(ar)4.479 E(g)-.37 E F0 1.649(is e)4.369 F +-.15(xe)-.15 G 1.649(cuted on e).15 F 1.649(xit from the shell.)-.15 F +1.649(If a)6.649 F F1(sigspec)4.489 E F0(is)4.459 E F2(DEB)144 96 Q(UG) +-.09 E/F3 9/Times-Roman@0 SF(,)A F0 1.168(the command)3.418 F F1(ar) +3.998 E(g)-.37 E F0 1.168(is e)3.888 F -.15(xe)-.15 G 1.167 +(cuted before e).15 F -.15(ve)-.25 G(ry).15 E F1 1.167(simple command) +3.667 F F0(,)A F1(for)3.667 E F0(command,)3.667 E F1(case)3.667 E F0 +(com-)3.667 E(mand,)144 108 Q F1(select)2.646 E F0 .146(command, e)2.646 +F -.15(ve)-.25 G .146(ry arithmetic).15 F F1(for)2.646 E F0 .147 +(command, and before the \214rst command e)2.646 F -.15(xe)-.15 G .147 +(cutes in a).15 F .146(shell function \(see)144 120 R F2 .146 (SHELL GRAMMAR)2.646 F F0(abo)2.396 E -.15(ve)-.15 G 2.646(\). Refer).15 -F .146(to the description of the)2.646 F/F2 10/Times-Bold@0 SF(extdeb) -2.645 E(ug)-.2 E F0 .145(option to)2.645 F(the)144 96 Q F2(shopt)3.2 E +F .146(to the description of the)2.646 F/F4 10/Times-Bold@0 SF(extdeb) +2.645 E(ug)-.2 E F0 .145(option to)2.645 F(the)144 132 Q F4(shopt)3.2 E F0 -.2(bu)3.2 G .7(iltin for details of its ef).2 F .7(fect on the)-.25 -F F2(DEB)3.2 E(UG)-.1 E F0 3.2(trap. If)3.2 F(a)3.2 E/F3 10 -/Times-Italic@0 SF(sigspec)3.54 E F0(is)3.51 E F1(RETURN)3.2 E/F4 9 -/Times-Roman@0 SF(,)A F0 .701(the com-)2.951 F(mand)144 108 Q F3(ar) -3.474 E(g)-.37 E F0 .644(is e)3.364 F -.15(xe)-.15 G .643 +F F4(DEB)3.2 E(UG)-.1 E F0 3.2(trap. If)3.2 F(a)3.2 E F1(sigspec)3.54 E +F0(is)3.51 E F2(RETURN)3.2 E F3(,)A F0 .701(the com-)2.951 F(mand)144 +144 Q F1(ar)3.474 E(g)-.37 E F0 .644(is e)3.364 F -.15(xe)-.15 G .643 (cuted each time a shell function or a script e).15 F -.15(xe)-.15 G -.643(cuted with the).15 F F2(.)3.143 E F0(or)3.143 E F2(sour)3.143 E(ce) --.18 E F0 -.2(bu)3.143 G(iltins).2 E(\214nishes e)144 120 Q -.15(xe)-.15 -G(cuting.).15 E .928(If a)144 138 R F3(sigspec)3.768 E F0(is)3.738 E F1 -(ERR)3.429 E F4(,)A F0 .929(the command)3.179 F F3(ar)3.759 E(g)-.37 E +.643(cuted with the).15 F F4(.)3.143 E F0(or)3.143 E F4(sour)3.143 E(ce) +-.18 E F0 -.2(bu)3.143 G(iltins).2 E(\214nishes e)144 156 Q -.15(xe)-.15 +G(cuting.).15 E .928(If a)144 174 R F1(sigspec)3.768 E F0(is)3.738 E F2 +(ERR)3.429 E F3(,)A F0 .929(the command)3.179 F F1(ar)3.759 E(g)-.37 E F0 .929(is e)3.649 F -.15(xe)-.15 G .929(cuted whene).15 F -.15(ve)-.25 G 3.429(ras).15 G .929(imple command has a non\255zero)-3.429 F -.15(ex) -144 150 S 1.009(it status, subject to the follo).15 F 1.009 -(wing conditions.)-.25 F(The)6.009 E F1(ERR)3.509 E F0 1.009 +144 186 S 1.009(it status, subject to the follo).15 F 1.009 +(wing conditions.)-.25 F(The)6.009 E F2(ERR)3.509 E F0 1.009 (trap is not e)3.259 F -.15(xe)-.15 G 1.008(cuted if the f).15 F 1.008 (ailed com-)-.1 F .324 -(mand is part of the command list immediately follo)144 162 R .324 -(wing a)-.25 F F2(while)2.824 E F0(or)2.824 E F2(until)2.824 E F0 -.1 +(mand is part of the command list immediately follo)144 198 R .324 +(wing a)-.25 F F4(while)2.824 E F0(or)2.824 E F4(until)2.824 E F0 -.1 (ke)2.824 G(yw)-.05 E .324(ord, part of the test)-.1 F .151(in an)144 -174 R F3(if)2.661 E F0 .151(statement, part of a command e)4.611 F -.15 -(xe)-.15 G .151(cuted in a).15 F F2(&&)2.651 E F0(or)2.651 E F2(||)2.651 +210 R F1(if)2.661 E F0 .151(statement, part of a command e)4.611 F -.15 +(xe)-.15 G .151(cuted in a).15 F F4(&&)2.651 E F0(or)2.651 E F4(||)2.651 E F0 .151(list, or if the command')2.651 F 2.651(sr)-.55 G .151(eturn v) --2.651 F(alue)-.25 E(is being in)144 186 Q -.15(ve)-.4 G(rted via).15 E -F2(!)2.5 E F0 5(.T)C(hese are the same conditions obe)-5 E(yed by the) --.15 E F2(err)2.5 E(exit)-.18 E F0(option.)2.5 E 1.095 +-2.651 F(alue)-.25 E(is being in)144 222 Q -.15(ve)-.4 G(rted via).15 E +F4(!)2.5 E F0 5(.T)C(hese are the same conditions obe)-5 E(yed by the) +-.15 E F4(err)2.5 E(exit)-.18 E F0(option.)2.5 E 1.095 (Signals ignored upon entry to the shell cannot be trapped or reset.)144 -204 R -.35(Tr)6.095 G 1.095(apped signals that are not).35 F .662 -(being ignored are reset to their original v)144 216 R .662 +240 R -.35(Tr)6.095 G 1.095(apped signals that are not).35 F .662 +(being ignored are reset to their original v)144 252 R .662 (alues in a subshell or subshell en)-.25 F .661(vironment when one is) --.4 F 2.5(created. The)144 228 R(return status is f)2.5 E(alse if an)-.1 -E(y)-.15 E F3(sigspec)2.84 E F0(is in)2.81 E -.25(va)-.4 G -(lid; otherwise).25 E F2(trap)2.5 E F0(returns true.)2.5 E F2(type)108 -244.8 Q F0([)2.5 E F2(\255aftpP)A F0(])A F3(name)2.5 E F0([)2.5 E F3 -(name)A F0(...])2.5 E -.4(Wi)144 256.8 S .173 -(th no options, indicate ho).4 F 2.673(we)-.25 G(ach)-2.673 E F3(name) +-.4 F 2.5(created. The)144 264 R(return status is f)2.5 E(alse if an)-.1 +E(y)-.15 E F1(sigspec)2.84 E F0(is in)2.81 E -.25(va)-.4 G +(lid; otherwise).25 E F4(trap)2.5 E F0(returns true.)2.5 E F4(type)108 +280.8 Q F0([)2.5 E F4(\255aftpP)A F0(])A F1(name)2.5 E F0([)2.5 E F1 +(name)A F0(...])2.5 E -.4(Wi)144 292.8 S .173 +(th no options, indicate ho).4 F 2.673(we)-.25 G(ach)-2.673 E F1(name) 3.033 E F0 -.1(wo)2.853 G .174 (uld be interpreted if used as a command name.).1 F .174(If the)5.174 F -F2<ad74>144 268.8 Q F0 .843(option is used,)3.343 F F2(type)3.343 E F0 -.843(prints a string which is one of)3.343 F F3(alias)3.343 E F0(,).27 E -F3 -.1(ke)3.343 G(ywor)-.2 E(d)-.37 E F0(,).77 E F3(function)3.343 E F0 -(,).24 E F3 -.2(bu)3.342 G(iltin).2 E F0 3.342(,o).24 G(r)-3.342 E F3 -(\214le)5.252 E F0(if)3.522 E F3(name)144.36 280.8 Q F0 .086 +F4<ad74>144 304.8 Q F0 .843(option is used,)3.343 F F4(type)3.343 E F0 +.843(prints a string which is one of)3.343 F F1(alias)3.343 E F0(,).27 E +F1 -.1(ke)3.343 G(ywor)-.2 E(d)-.37 E F0(,).77 E F1(function)3.343 E F0 +(,).24 E F1 -.2(bu)3.342 G(iltin).2 E F0 3.342(,o).24 G(r)-3.342 E F1 +(\214le)5.252 E F0(if)3.522 E F1(name)144.36 316.8 Q F0 .086 (is an alias, shell reserv)2.766 F .086(ed w)-.15 F .086 (ord, function, b)-.1 F .087(uiltin, or disk \214le, respecti)-.2 F -.15 -(ve)-.25 G(ly).15 E 5.087(.I)-.65 G 2.587(ft)-5.087 G(he)-2.587 E F3 +(ve)-.25 G(ly).15 E 5.087(.I)-.65 G 2.587(ft)-5.087 G(he)-2.587 E F1 (name)2.947 E F0 .087(is not)2.767 F .119 -(found, then nothing is printed, and an e)144 292.8 R .118 +(found, then nothing is printed, and an e)144 328.8 R .118 (xit status of f)-.15 F .118(alse is returned.)-.1 F .118(If the)5.118 F -F2<ad70>2.618 E F0 .118(option is used,)2.618 F F2(type)2.618 E F0 .855 -(either returns the name of the disk \214le that w)144 304.8 R .855 -(ould be e)-.1 F -.15(xe)-.15 G .855(cuted if).15 F F3(name)3.715 E F0 +F4<ad70>2.618 E F0 .118(option is used,)2.618 F F4(type)2.618 E F0 .855 +(either returns the name of the disk \214le that w)144 340.8 R .855 +(ould be e)-.1 F -.15(xe)-.15 G .855(cuted if).15 F F1(name)3.715 E F0 .855(were speci\214ed as a com-)3.535 F .641(mand name, or nothing if) -144 316.8 R/F5 10/Courier@0 SF .641(type -t name)3.141 F F0 -.1(wo)3.141 -G .641(uld not return).1 F F3(\214le)3.14 E F0 5.64(.T).18 G(he)-5.64 E -F2<ad50>3.14 E F0 .64(option forces a)3.14 F F1 -.666(PA)3.14 G(TH)-.189 -E F0 .112(search for each)144 328.8 R F3(name)2.612 E F0 2.612(,e)C -.15 +144 352.8 R/F5 10/Courier@0 SF .641(type -t name)3.141 F F0 -.1(wo)3.141 +G .641(uld not return).1 F F1(\214le)3.14 E F0 5.64(.T).18 G(he)-5.64 E +F4<ad50>3.14 E F0 .64(option forces a)3.14 F F2 -.666(PA)3.14 G(TH)-.189 +E F0 .112(search for each)144 364.8 R F1(name)2.612 E F0 2.612(,e)C -.15 (ve)-2.862 G 2.613(ni).15 G(f)-2.613 E F5 .113(type -t name)2.613 F F0 --.1(wo)2.613 G .113(uld not return).1 F F3(\214le)2.613 E F0 5.113(.I) -.18 G 2.613(fac)-5.113 G .113(ommand is hashed,)-2.613 F F2<ad70>2.613 E -F0(and)144 340.8 Q F2<ad50>3.231 E F0 .731(print the hashed v)3.231 F +-.1(wo)2.613 G .113(uld not return).1 F F1(\214le)2.613 E F0 5.113(.I) +.18 G 2.613(fac)-5.113 G .113(ommand is hashed,)-2.613 F F4<ad70>2.613 E +F0(and)144 376.8 Q F4<ad50>3.231 E F0 .731(print the hashed v)3.231 F .73(alue, which is not necessarily the \214le that appears \214rst in) --.25 F F1 -.666(PA)3.23 G(TH)-.189 E F4(.)A F0 .73(If the)5.23 F F2 -<ad61>144 352.8 Q F0 1.748(option is used,)4.248 F F2(type)4.248 E F0 +-.25 F F2 -.666(PA)3.23 G(TH)-.189 E F3(.)A F0 .73(If the)5.23 F F4 +<ad61>144 388.8 Q F0 1.748(option is used,)4.248 F F4(type)4.248 E F0 1.748(prints all of the places that contain an e)4.248 F -.15(xe)-.15 G -1.748(cutable named).15 F F3(name)4.249 E F0 6.749(.T).18 G(his)-6.749 E -.744(includes aliases and functions, if and only if the)144 364.8 R F2 +1.748(cutable named).15 F F1(name)4.249 E F0 6.749(.T).18 G(his)-6.749 E +.744(includes aliases and functions, if and only if the)144 400.8 R F4 <ad70>3.244 E F0 .744(option is not also used.)3.244 F .743 (The table of hashed)5.744 F 1.223(commands is not consulted when using) -144 376.8 R F2<ad61>3.723 E F0 6.223(.T)C(he)-6.223 E F2<ad66>3.723 E F0 +144 412.8 R F4<ad61>3.723 E F0 6.223(.T)C(he)-6.223 E F4<ad66>3.723 E F0 1.223(option suppresses shell function lookup, as)3.723 F .326(with the) -144 388.8 R F2(command)2.826 E F0 -.2(bu)2.826 G(iltin.).2 E F2(type) +144 424.8 R F4(command)2.826 E F0 -.2(bu)2.826 G(iltin.).2 E F4(type) 5.326 E F0 .326(returns true if all of the ar)2.826 F .325 (guments are found, f)-.18 F .325(alse if an)-.1 F 2.825(ya)-.15 G .325 -(re not)-2.825 F(found.)144 400.8 Q F2(ulimit)108 417.6 Q F0([)2.5 E F2 -(\255HST)A(abcde\214lmnpqrstuvx)-.92 E F0([)2.5 E F3(limit)A F0(]])A -(Pro)144 429.6 Q .243(vides control o)-.15 F -.15(ve)-.15 G 2.743(rt).15 +(re not)-2.825 F(found.)144 436.8 Q F4(ulimit)108 453.6 Q F0([)2.5 E F4 +(\255HST)A(abcde\214lmnpqrstuvx)-.92 E F0([)2.5 E F1(limit)A F0(]])A +(Pro)144 465.6 Q .243(vides control o)-.15 F -.15(ve)-.15 G 2.743(rt).15 G .243(he resources a)-2.743 F -.25(va)-.2 G .244 (ilable to the shell and to processes started by it, on systems).25 F -.944(that allo)144 441.6 R 3.444(ws)-.25 G .944(uch control.)-3.444 F -(The)5.944 E F2<ad48>3.444 E F0(and)3.444 E F2<ad53>3.444 E F0 .943 +.944(that allo)144 477.6 R 3.444(ws)-.25 G .944(uch control.)-3.444 F +(The)5.944 E F4<ad48>3.444 E F0(and)3.444 E F4<ad53>3.444 E F0 .943 (options specify that the hard or soft limit is set for the)3.444 F(gi) -144 453.6 Q -.15(ve)-.25 G 2.708(nr).15 G 2.708(esource. A)-2.708 F .208 +144 489.6 Q -.15(ve)-.25 G 2.708(nr).15 G 2.708(esource. A)-2.708 F .208 (hard limit cannot be increased by a non-root user once it is set; a so\ -ft limit may)2.708 F .426(be increased up to the v)144 465.6 R .426 -(alue of the hard limit.)-.25 F .425(If neither)5.426 F F2<ad48>2.925 E -F0(nor)2.925 E F2<ad53>2.925 E F0 .425 +ft limit may)2.708 F .426(be increased up to the v)144 501.6 R .426 +(alue of the hard limit.)-.25 F .425(If neither)5.426 F F4<ad48>2.925 E +F0(nor)2.925 E F4<ad53>2.925 E F0 .425 (is speci\214ed, both the soft and)2.925 F .139(hard limits are set.)144 -477.6 R .139(The v)5.139 F .139(alue of)-.25 F F3(limit)2.729 E F0 .139 +513.6 R .139(The v)5.139 F .139(alue of)-.25 F F1(limit)2.729 E F0 .139 (can be a number in the unit speci\214ed for the resource or one)3.319 F -.742(of the special v)144 489.6 R(alues)-.25 E F2(hard)3.242 E F0(,)A F2 -(soft)3.241 E F0 3.241(,o)C(r)-3.241 E F2(unlimited)3.241 E F0 3.241(,w) +.742(of the special v)144 525.6 R(alues)-.25 E F4(hard)3.242 E F0(,)A F4 +(soft)3.241 E F0 3.241(,o)C(r)-3.241 E F4(unlimited)3.241 E F0 3.241(,w) C .741(hich stand for the current hard limit, the current)-3.241 F .78 -(soft limit, and no limit, respecti)144 501.6 R -.15(ve)-.25 G(ly).15 E -5.78(.I)-.65 G(f)-5.78 E F3(limit)3.37 E F0 .78 +(soft limit, and no limit, respecti)144 537.6 R -.15(ve)-.25 G(ly).15 E +5.78(.I)-.65 G(f)-5.78 E F1(limit)3.37 E F0 .78 (is omitted, the current v)3.96 F .78(alue of the soft limit of the)-.25 -F .499(resource is printed, unless the)144 513.6 R F2<ad48>2.999 E F0 +F .499(resource is printed, unless the)144 549.6 R F4<ad48>2.999 E F0 .499(option is gi)2.999 F -.15(ve)-.25 G 2.999(n. When).15 F .498 (more than one resource is speci\214ed, the)2.999 F -(limit name and unit are printed before the v)144 525.6 Q 2.5 -(alue. Other)-.25 F(options are interpreted as follo)2.5 E(ws:)-.25 E F2 -<ad61>144 537.6 Q F0(All current limits are reported)25.3 E F2<ad62>144 -549.6 Q F0(The maximum sock)24.74 E(et b)-.1 E(uf)-.2 E(fer size)-.25 E -F2<ad63>144 561.6 Q F0(The maximum size of core \214les created)25.86 E -F2<ad64>144 573.6 Q F0(The maximum size of a process')24.74 E 2.5(sd) --.55 G(ata se)-2.5 E(gment)-.15 E F2<ad65>144 585.6 Q F0 -(The maximum scheduling priority \("nice"\))25.86 E F2<ad66>144 597.6 Q +(limit name and unit are printed before the v)144 561.6 Q 2.5 +(alue. Other)-.25 F(options are interpreted as follo)2.5 E(ws:)-.25 E F4 +<ad61>144 573.6 Q F0(All current limits are reported)25.3 E F4<ad62>144 +585.6 Q F0(The maximum sock)24.74 E(et b)-.1 E(uf)-.2 E(fer size)-.25 E +F4<ad63>144 597.6 Q F0(The maximum size of core \214les created)25.86 E +F4<ad64>144 609.6 Q F0(The maximum size of a process')24.74 E 2.5(sd) +-.55 G(ata se)-2.5 E(gment)-.15 E F4<ad65>144 621.6 Q F0 +(The maximum scheduling priority \("nice"\))25.86 E F4<ad66>144 633.6 Q F0(The maximum size of \214les written by the shell and its children) -26.97 E F2<ad69>144 609.6 Q F0(The maximum number of pending signals) -27.52 E F2<ad6c>144 621.6 Q F0(The maximum size that may be lock)27.52 E -(ed into memory)-.1 E F2<ad6d>144 633.6 Q F0 +26.97 E F4<ad69>144 645.6 Q F0(The maximum number of pending signals) +27.52 E F4<ad6c>144 657.6 Q F0(The maximum size that may be lock)27.52 E +(ed into memory)-.1 E F4<ad6d>144 669.6 Q F0 (The maximum resident set size \(man)21.97 E 2.5(ys)-.15 G -(ystems do not honor this limit\))-2.5 E F2<ad6e>144 645.6 Q F0 .791(Th\ +(ystems do not honor this limit\))-2.5 E F4<ad6e>144 681.6 Q F0 .791(Th\ e maximum number of open \214le descriptors \(most systems do not allo) 24.74 F 3.291(wt)-.25 G .791(his v)-3.291 F .791(alue to)-.25 F -(be set\))180 657.6 Q F2<ad70>144 669.6 Q F0 -(The pipe size in 512-byte blocks \(this may not be set\))24.74 E F2 -<ad71>144 681.6 Q F0 -(The maximum number of bytes in POSIX message queues)24.74 E F2<ad72>144 -693.6 Q F0(The maximum real-time scheduling priority)25.86 E F2<ad73>144 -705.6 Q F0(The maximum stack size)26.41 E F2<ad74>144 717.6 Q F0 -(The maximum amount of cpu time in seconds)26.97 E(GNU Bash 4.2)72 768 Q -(2012 July 5)151.505 E(71)200.665 E 0 Cg EP +(be set\))180 693.6 Q F4<ad70>144 705.6 Q F0 +(The pipe size in 512-byte blocks \(this may not be set\))24.74 E F4 +<ad71>144 717.6 Q F0 +(The maximum number of bytes in POSIX message queues)24.74 E +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(71)198.165 E 0 Cg EP %%Page: 72 72 %%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/Times-Bold@0 SF<ad75>144 84 Q F0 +-.35 E/F1 10/Times-Bold@0 SF<ad72>144 84 Q F0 +(The maximum real-time scheduling priority)25.86 E F1<ad73>144 96 Q F0 +(The maximum stack size)26.41 E F1<ad74>144 108 Q F0 +(The maximum amount of cpu time in seconds)26.97 E F1<ad75>144 120 Q F0 (The maximum number of processes a)24.74 E -.25(va)-.2 G -(ilable to a single user).25 E F1<ad76>144 96 Q F0 .47 +(ilable to a single user).25 E F1<ad76>144 132 Q F0 .47 (The maximum amount of virtual memory a)25.3 F -.25(va)-.2 G .47 -(ilable to the shell and, on some systems, to).25 F(its children)180 108 -Q F1<ad78>144 120 Q F0(The maximum number of \214le locks)25.3 E F1 -<ad54>144 132 Q F0(The maximum number of threads)23.63 E(If)144 148.8 Q +(ilable to the shell and, on some systems, to).25 F(its children)180 144 +Q F1<ad78>144 156 Q F0(The maximum number of \214le locks)25.3 E F1 +<ad54>144 168 Q F0(The maximum number of threads)23.63 E(If)144 184.8 Q /F2 10/Times-Italic@0 SF(limit)3.058 E F0 .468(is gi)3.648 F -.15(ve) -.25 G .468(n, and the).15 F F1<ad61>2.968 E F0 .468 (option is not used,)2.968 F F2(limit)2.968 E F0 .468(is the ne)2.968 F 2.968(wv)-.25 G .468(alue of the speci\214ed resource.)-3.218 F(If)5.468 -E .045(no option is gi)144 160.8 R -.15(ve)-.25 G .045(n, then).15 F F1 +E .045(no option is gi)144 196.8 R -.15(ve)-.25 G .045(n, then).15 F F1 <ad66>2.545 E F0 .045(is assumed.)2.545 F -1.11(Va)5.045 G .045 (lues are in 1024-byte increments, e)1.11 F .044(xcept for)-.15 F F1 <ad74>2.544 E F0 2.544(,w)C .044(hich is)-2.544 F .402(in seconds;)144 -172.8 R F1<ad70>2.902 E F0 2.902(,w)C .402 +208.8 R F1<ad70>2.902 E F0 2.902(,w)C .402 (hich is in units of 512-byte blocks; and)-2.902 F F1<ad54>2.902 E F0(,) A F1<ad62>2.902 E F0(,)A F1<ad6e>2.902 E F0 2.902(,a)C(nd)-2.902 E F1 <ad75>2.903 E F0 2.903(,w)C .403(hich are unscaled)-2.903 F -.25(va)144 -184.8 S 3.083(lues. The).25 F .583(return status is 0 unless an in)3.083 +220.8 S 3.083(lues. The).25 F .583(return status is 0 unless an in)3.083 F -.25(va)-.4 G .583(lid option or ar).25 F .583 (gument is supplied, or an error occurs)-.18 F(while setting a ne)144 -196.8 Q 2.5(wl)-.25 G(imit.)-2.5 E F1(umask)108 213.6 Q F0([)2.5 E F1 +232.8 Q 2.5(wl)-.25 G(imit.)-2.5 E F1(umask)108 249.6 Q F0([)2.5 E F1 <ad70>A F0 2.5(][)C F1<ad53>-2.5 E F0 2.5(][)C F2(mode)-2.5 E F0(])A .2 -(The user \214le-creation mask is set to)144 225.6 R F2(mode)2.7 E F0 +(The user \214le-creation mask is set to)144 261.6 R F2(mode)2.7 E F0 5.2(.I).18 G(f)-5.2 E F2(mode)3.08 E F0(be)2.88 E .2 (gins with a digit, it is interpreted as an octal)-.15 F .066(number; o\ therwise it is interpreted as a symbolic mode mask similar to that acce\ -pted by)144 237.6 R F2 -.15(ch)2.566 G(mod).15 E F0(\(1\).).77 E(If)144 -249.6 Q F2(mode)3.262 E F0 .382(is omitted, the current v)3.062 F .382 +pted by)144 273.6 R F2 -.15(ch)2.566 G(mod).15 E F0(\(1\).).77 E(If)144 +285.6 Q F2(mode)3.262 E F0 .382(is omitted, the current v)3.062 F .382 (alue of the mask is printed.)-.25 F(The)5.382 E F1<ad53>2.882 E F0 .382 (option causes the mask to be)2.882 F .547 -(printed in symbolic form; the def)144 261.6 R .547 +(printed in symbolic form; the def)144 297.6 R .547 (ault output is an octal number)-.1 F 5.547(.I)-.55 G 3.047(ft)-5.547 G (he)-3.047 E F1<ad70>3.047 E F0 .547(option is supplied, and)3.047 F F2 -(mode)144.38 273.6 Q F0 .551 +(mode)144.38 309.6 Q F0 .551 (is omitted, the output is in a form that may be reused as input.)3.231 -F .552(The return status is 0 if the)5.552 F(mode w)144 285.6 Q +F .552(The return status is 0 if the)5.552 F(mode w)144 321.6 Q (as successfully changed or if no)-.1 E F2(mode)2.5 E F0(ar)2.5 E (gument w)-.18 E(as supplied, and f)-.1 E(alse otherwise.)-.1 E F1 -(unalias)108 302.4 Q F0<5bad>2.5 E F1(a)A F0 2.5(][)C F2(name)-2.5 E F0 -(...])2.5 E(Remo)144 314.4 Q 1.955 -.15(ve e)-.15 H(ach).15 E F2(name) +(unalias)108 338.4 Q F0<5bad>2.5 E F1(a)A F0 2.5(][)C F2(name)-2.5 E F0 +(...])2.5 E(Remo)144 350.4 Q 1.955 -.15(ve e)-.15 H(ach).15 E F2(name) 4.155 E F0 1.655(from the list of de\214ned aliases.)4.155 F(If)6.655 E F1<ad61>4.155 E F0 1.655(is supplied, all alias de\214nitions are)4.155 -F(remo)144 326.4 Q -.15(ve)-.15 G 2.5(d. The).15 F(return v)2.5 E +F(remo)144 362.4 Q -.15(ve)-.15 G 2.5(d. The).15 F(return v)2.5 E (alue is true unless a supplied)-.25 E F2(name)2.86 E F0 -(is not a de\214ned alias.)2.68 E F1(unset)108 343.2 Q F0<5bad>2.5 E F1 +(is not a de\214ned alias.)2.68 E F1(unset)108 379.2 Q F0<5bad>2.5 E F1 (fv)A F0 2.5(][)C<ad>-2.5 E F1(n)A F0 2.5(][)C F2(name)-2.5 E F0(...]) -2.5 E -.15(Fo)144 355.2 S 3.827(re).15 G(ach)-3.827 E F2(name)3.827 E F0 +2.5 E -.15(Fo)144 391.2 S 3.827(re).15 G(ach)-3.827 E F2(name)3.827 E F0 3.827(,r).18 G(emo)-3.827 E 1.627 -.15(ve t)-.15 H 1.327 (he corresponding v).15 F 1.327(ariable or function.)-.25 F 1.327 (If the)6.327 F F1<ad76>3.828 E F0 1.328(option is gi)3.828 F -.15(ve) --.25 G 1.328(n, each).15 F F2(name)144.36 367.2 Q F0 1.551 +-.25 G 1.328(n, each).15 F F2(name)144.36 403.2 Q F0 1.551 (refers to a shell v)4.231 F 1.551(ariable, and that v)-.25 F 1.551 (ariable is remo)-.25 F -.15(ve)-.15 G 4.05(d. Read-only).15 F -.25(va) -4.05 G 1.55(riables may not be).25 F 4.641(unset. If)144 379.2 R F1 +4.05 G 1.55(riables may not be).25 F 4.641(unset. If)144 415.2 R F1 <ad66>4.641 E F0 2.141(is speci\214ed, each)4.641 F F2(name)5.001 E F0 2.141(refers to a shell function, and the function de\214nition is)4.821 -F(remo)144 391.2 Q -.15(ve)-.15 G 2.538(d. If).15 F(the)2.537 E F1<ad6e> +F(remo)144 427.2 Q -.15(ve)-.15 G 2.538(d. If).15 F(the)2.537 E F1<ad6e> 2.537 E F0 .037(option is supplied, and)2.537 F F2(name)2.537 E F0 .037 (is a v)2.537 F .037(ariable with the)-.25 F F2(namer)2.537 E(ef)-.37 E F0(attrib)2.537 E(ute,)-.2 E F2(name)2.537 E F0(will)2.537 E .492 -(be unset rather than the v)144 403.2 R .492(ariable it references.)-.25 +(be unset rather than the v)144 439.2 R .492(ariable it references.)-.25 F F1<ad6e>5.492 E F0 .492(has no ef)2.992 F .492(fect if the)-.25 F F1 <ad66>2.992 E F0 .492(option is supplied.)2.992 F .493(If no)5.493 F -.221(options are supplied, each)144 415.2 R F2(name)2.721 E F0 .221 +.221(options are supplied, each)144 451.2 R F2(name)2.721 E F0 .221 (refers to a v)2.721 F .22(ariable; if there is no v)-.25 F .22 (ariable by that name, an)-.25 F 2.72(yf)-.15 G(unc-)-2.72 E 1.188 -(tion with that name is unset.)144 427.2 R 1.189(Each unset v)6.189 F +(tion with that name is unset.)144 463.2 R 1.189(Each unset v)6.189 F 1.189(ariable or function is remo)-.25 F -.15(ve)-.15 G 3.689(df).15 G 1.189(rom the en)-3.689 F(vironment)-.4 E 3.206 -(passed to subsequent commands.)144 439.2 R 3.206(If an)8.206 F 5.706 +(passed to subsequent commands.)144 475.2 R 3.206(If an)8.206 F 5.706 (yo)-.15 G(f)-5.706 E/F3 9/Times-Bold@0 SF(COMP_W)5.706 E(ORDBREAKS)-.09 E/F4 9/Times-Roman@0 SF(,)A F3(RANDOM)5.455 E F4(,)A F3(SECONDS)5.455 E -F4(,)A F3(LINENO)144 451.2 Q F4(,)A F3(HISTCMD)4.347 E F4(,)A F3(FUNCN) +F4(,)A F3(LINENO)144 487.2 Q F4(,)A F3(HISTCMD)4.347 E F4(,)A F3(FUNCN) 4.347 E(AME)-.18 E F4(,)A F3(GR)4.347 E(OUPS)-.27 E F4(,)A F0(or)4.348 E F3(DIRST)4.598 E -.495(AC)-.81 G(K).495 E F0 2.098(are unset, the)4.348 F 4.598(yl)-.15 G 2.098(ose their special)-4.598 F(properties, e)144 -463.2 Q -.15(ve)-.25 G 2.5(ni).15 G 2.5(ft)-2.5 G(he)-2.5 E 2.5(ya)-.15 +499.2 Q -.15(ve)-.25 G 2.5(ni).15 G 2.5(ft)-2.5 G(he)-2.5 E 2.5(ya)-.15 G(re subsequently reset.)-2.5 E(The e)5 E(xit status is true unless a) --.15 E F2(name)2.86 E F0(is readonly)2.68 E(.)-.65 E F1(wait)108 480 Q -F0([)2.5 E F2 2.5(n.)C(..)-2.5 E F0(])A -.8(Wa)144 492 S .288 +-.15 E F2(name)2.86 E F0(is readonly)2.68 E(.)-.65 E F1(wait)108 516 Q +F0([)2.5 E F2 2.5(n.)C(..)-2.5 E F0(])A -.8(Wa)144 528 S .288 (it for each speci\214ed process and return its termination status.).8 F (Each)5.288 E F2(n)3.148 E F0 .287(may be a process ID or a)3.028 F .722 -(job speci\214cation; if a job spec is gi)144 504 R -.15(ve)-.25 G .722 +(job speci\214cation; if a job spec is gi)144 540 R -.15(ve)-.25 G .722 (n, all processes in that job').15 F 3.222(sp)-.55 G .722(ipeline are w) -3.222 F .722(aited for)-.1 F 5.722(.I)-.55 G(f)-5.722 E F2(n)3.583 E F0 -(is)3.463 E 1.266(not gi)144 516 R -.15(ve)-.25 G 1.266 +(is)3.463 E 1.266(not gi)144 552 R -.15(ve)-.25 G 1.266 (n, all currently acti).15 F 1.566 -.15(ve c)-.25 H 1.265 (hild processes are w).15 F 1.265(aited for)-.1 F 3.765(,a)-.4 G 1.265 (nd the return status is zero.)-3.765 F(If)6.265 E F2(n)4.125 E F0 .456 -(speci\214es a non-e)144 528 R .457 +(speci\214es a non-e)144 564 R .457 (xistent process or job, the return status is 127.)-.15 F .457 -(Otherwise, the return status is the)5.457 F -.15(ex)144 540 S +(Otherwise, the return status is the)5.457 F -.15(ex)144 576 S (it status of the last process or job w).15 E(aited for)-.1 E(.)-.55 E -/F5 10.95/Times-Bold@0 SF(RESTRICTED SHELL)72 556.8 Q F0(If)108 568.8 Q +/F5 10.95/Times-Bold@0 SF(RESTRICTED SHELL)72 592.8 Q F0(If)108 604.8 Q F1(bash)4.397 E F0 1.897(is started with the name)4.397 F F1(rbash)4.397 E F0 4.397(,o)C 4.397(rt)-4.397 G(he)-4.397 E F1<ad72>4.397 E F0 1.896 (option is supplied at in)4.397 F -.2(vo)-.4 G 1.896 -(cation, the shell becomes).2 F 3.445(restricted. A)108 580.8 R .945 +(cation, the shell becomes).2 F 3.445(restricted. A)108 616.8 R .945 (restricted shell is used to set up an en)3.445 F .946 (vironment more controlled than the standard shell.)-.4 F(It)5.946 E -(beha)108 592.8 Q -.15(ve)-.2 G 2.5(si).15 G(dentically to)-2.5 E F1 +(beha)108 628.8 Q -.15(ve)-.2 G 2.5(si).15 G(dentically to)-2.5 E F1 (bash)2.5 E F0(with the e)2.5 E(xception that the follo)-.15 E (wing are disallo)-.25 E(wed or not performed:)-.25 E 32.5<8363>108 -609.6 S(hanging directories with)-32.5 E F1(cd)2.5 E F0 32.5<8373>108 -626.4 S(etting or unsetting the v)-32.5 E(alues of)-.25 E F3(SHELL)2.5 E +645.6 S(hanging directories with)-32.5 E F1(cd)2.5 E F0 32.5<8373>108 +662.4 S(etting or unsetting the v)-32.5 E(alues of)-.25 E F3(SHELL)2.5 E F4(,)A F3 -.666(PA)2.25 G(TH)-.189 E F4(,)A F3(ENV)2.25 E F4(,)A F0(or) -2.25 E F3 -.27(BA)2.5 G(SH_ENV).27 E F0 32.5<8373>108 643.2 S +2.25 E F3 -.27(BA)2.5 G(SH_ENV).27 E F0 32.5<8373>108 679.2 S (pecifying command names containing)-32.5 E F1(/)2.5 E F0 32.5<8373>108 -660 S(pecifying a \214lename containing a)-32.5 E F1(/)2.5 E F0 +696 S(pecifying a \214lename containing a)-32.5 E F1(/)2.5 E F0 (as an ar)2.5 E(gument to the)-.18 E F1(.)2.5 E F0 -.2(bu)5 G -(iltin command).2 E 32.5<8373>108 676.8 S .45 +(iltin command).2 E 32.5<8373>108 712.8 S .45 (pecifying a \214lename containing a slash as an ar)-32.5 F .449 (gument to the)-.18 F F1<ad70>2.949 E F0 .449(option to the)2.949 F F1 -(hash)2.949 E F0 -.2(bu)2.949 G .449(iltin com-).2 F(mand)144 688.8 Q -32.5<8369>108 705.6 S(mporting function de\214nitions from the shell en) --32.5 E(vironment at startup)-.4 E(GNU Bash 4.2)72 768 Q(2012 July 5) -151.505 E(72)200.665 E 0 Cg EP +(hash)2.949 E F0 -.2(bu)2.949 G .449(iltin com-).2 F(mand)144 724.8 Q +(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E(72)198.165 E 0 Cg EP %%Page: 73 73 %%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 32.5<8370>108 84 S(arsing the v)-32.5 E(alue of)-.25 E/F1 9 -/Times-Bold@0 SF(SHELLOPTS)2.5 E F0(from the shell en)2.25 E -(vironment at startup)-.4 E 32.5<8372>108 100.8 S(edirecting output usi\ -ng the >, >|, <>, >&, &>, and >> redirection operators)-32.5 E 32.5 -<8375>108 117.6 S(sing the)-32.5 E/F2 10/Times-Bold@0 SF(exec)2.5 E F0 --.2(bu)2.5 G(iltin command to replace the shell with another command).2 -E 32.5<8361>108 134.4 S(dding or deleting b)-32.5 E -(uiltin commands with the)-.2 E F2<ad66>2.5 E F0(and)2.5 E F2<ad64>2.5 E -F0(options to the)2.5 E F2(enable)2.5 E F0 -.2(bu)2.5 G(iltin command).2 -E 32.5<8375>108 151.2 S(sing the)-32.5 E F2(enable)2.5 E F0 -.2(bu)2.5 G +-.35 E 32.5<8369>108 84 S +(mporting function de\214nitions from the shell en)-32.5 E +(vironment at startup)-.4 E 32.5<8370>108 100.8 S(arsing the v)-32.5 E +(alue of)-.25 E/F1 9/Times-Bold@0 SF(SHELLOPTS)2.5 E F0 +(from the shell en)2.25 E(vironment at startup)-.4 E 32.5<8372>108 117.6 +S(edirecting output using the >, >|, <>, >&, &>, and >> redirection ope\ +rators)-32.5 E 32.5<8375>108 134.4 S(sing the)-32.5 E/F2 10/Times-Bold@0 +SF(exec)2.5 E F0 -.2(bu)2.5 G +(iltin command to replace the shell with another command).2 E 32.5<8361> +108 151.2 S(dding or deleting b)-32.5 E(uiltin commands with the)-.2 E +F2<ad66>2.5 E F0(and)2.5 E F2<ad64>2.5 E F0(options to the)2.5 E F2 +(enable)2.5 E F0 -.2(bu)2.5 G(iltin command).2 E 32.5<8375>108 168 S +(sing the)-32.5 E F2(enable)2.5 E F0 -.2(bu)2.5 G (iltin command to enable disabled shell b).2 E(uiltins)-.2 E 32.5<8373> -108 168 S(pecifying the)-32.5 E F2<ad70>2.5 E F0(option to the)2.5 E F2 -(command)2.5 E F0 -.2(bu)2.5 G(iltin command).2 E 32.5<8374>108 184.8 S -(urning of)-32.5 E 2.5(fr)-.25 G(estricted mode with)-2.5 E F2(set +r) +108 184.8 S(pecifying the)-32.5 E F2<ad70>2.5 E F0(option to the)2.5 E +F2(command)2.5 E F0 -.2(bu)2.5 G(iltin command).2 E 32.5<8374>108 201.6 +S(urning of)-32.5 E 2.5(fr)-.25 G(estricted mode with)-2.5 E F2(set +r) 2.5 E F0(or)2.5 E F2(set +o r)2.5 E(estricted)-.18 E F0(.)A -(These restrictions are enforced after an)108 201.6 Q 2.5(ys)-.15 G +(These restrictions are enforced after an)108 218.4 Q 2.5(ys)-.15 G (tartup \214les are read.)-2.5 E 1.566 -(When a command that is found to be a shell script is e)108 218.4 R -.15 +(When a command that is found to be a shell script is e)108 235.2 R -.15 (xe)-.15 G 1.567(cuted \(see).15 F F1 1.567(COMMAND EXECUTION)4.067 F F0 -(abo)3.817 E -.15(ve)-.15 G(\),).15 E F2(rbash)108 230.4 Q F0(turns of) +(abo)3.817 E -.15(ve)-.15 G(\),).15 E F2(rbash)108 247.2 Q F0(turns of) 2.5 E 2.5(fa)-.25 G .3 -.15(ny r)-2.5 H(estrictions in the shell spa).15 E(wned to e)-.15 E -.15(xe)-.15 G(cute the script.).15 E/F3 10.95 -/Times-Bold@0 SF(SEE ALSO)72 247.2 Q/F4 10/Times-Italic@0 SF(Bash Refer) -108 259.2 Q(ence Manual)-.37 E F0 2.5(,B)C(rian F)-2.5 E -(ox and Chet Rame)-.15 E(y)-.15 E F4(The Gnu Readline Libr)108 271.2 Q -(ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E(ox and Chet Rame)-.15 E(y)-.15 E -F4(The Gnu History Libr)108 283.2 Q(ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E -(ox and Chet Rame)-.15 E(y)-.15 E F4 -.8(Po)108 295.2 S(rtable Oper).8 E +/Times-Bold@0 SF(SEE ALSO)72 264 Q/F4 10/Times-Italic@0 SF(Bash Refer) +108 276 Q(ence Manual)-.37 E F0 2.5(,B)C(rian F)-2.5 E(ox and Chet Rame) +-.15 E(y)-.15 E F4(The Gnu Readline Libr)108 288 Q(ary)-.15 E F0 2.5(,B) +C(rian F)-2.5 E(ox and Chet Rame)-.15 E(y)-.15 E F4 +(The Gnu History Libr)108 300 Q(ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E +(ox and Chet Rame)-.15 E(y)-.15 E F4 -.8(Po)108 312 S(rtable Oper).8 E (ating System Interface \(POSIX\) P)-.15 E(art 2: Shell and Utilities) --.8 E F0 2.5(,I)C(EEE)-2.5 E F4(sh)108 307.2 Q F0(\(1\),)A F4(ksh)2.5 E -F0(\(1\),)A F4(csh)2.5 E F0(\(1\))A F4(emacs)108 319.2 Q F0(\(1\),)A F4 -(vi)2.5 E F0(\(1\))A F4 -.37(re)108 331.2 S(adline).37 E F0(\(3\))A F3 -(FILES)72 348 Q F4(/bin/bash)109.666 360 Q F0(The)144 372 Q F2(bash)2.5 -E F0 -.15(exe)2.5 G(cutable).15 E F4(/etc/pr)109.666 384 Q(o\214le)-.45 -E F0(The systemwide initialization \214le, e)144 396 Q -.15(xe)-.15 G -(cuted for login shells).15 E F4(~/.bash_pr)109.666 408 Q(o\214le)-.45 E -F0(The personal initialization \214le, e)144 420 Q -.15(xe)-.15 G -(cuted for login shells).15 E F4(~/.bashr)109.666 432 Q(c)-.37 E F0 -(The indi)144 444 Q(vidual per)-.25 E(-interacti)-.2 E -.15(ve)-.25 G -(-shell startup \214le).15 E F4(~/.bash_lo)109.666 456 Q(gout)-.1 E F0 -(The indi)144 468 Q(vidual login shell cleanup \214le, e)-.25 E -.15(xe) --.15 G(cuted when a login shell e).15 E(xits)-.15 E F4(~/.inputr)109.666 -480 Q(c)-.37 E F0(Indi)144 492 Q(vidual)-.25 E F4 -.37(re)2.5 G(adline) -.37 E F0(initialization \214le)2.5 E F3 -.548(AU)72 508.8 S(THORS).548 E -F0(Brian F)108 520.8 Q(ox, Free Softw)-.15 E(are F)-.1 E(oundation)-.15 -E(bfox@gnu.or)108 532.8 Q(g)-.18 E(Chet Rame)108 549.6 Q 1.3 -.65(y, C) --.15 H(ase W).65 E(estern Reserv)-.8 E 2.5(eU)-.15 G(ni)-2.5 E -.15(ve) --.25 G(rsity).15 E(chet.rame)108 561.6 Q(y@case.edu)-.15 E F3 -.11(BU)72 -578.4 S 2.738(GR).11 G(EPOR)-2.738 E(TS)-.438 E F0 .568 -(If you \214nd a b)108 590.4 R .568(ug in)-.2 F F2(bash,)3.068 E F0 .568 +-.8 E F0 2.5(,I)C(EEE)-2.5 E F4(sh)108 324 Q F0(\(1\),)A F4(ksh)2.5 E F0 +(\(1\),)A F4(csh)2.5 E F0(\(1\))A F4(emacs)108 336 Q F0(\(1\),)A F4(vi) +2.5 E F0(\(1\))A F4 -.37(re)108 348 S(adline).37 E F0(\(3\))A F3(FILES) +72 364.8 Q F4(/bin/bash)109.666 376.8 Q F0(The)144 388.8 Q F2(bash)2.5 E +F0 -.15(exe)2.5 G(cutable).15 E F4(/etc/pr)109.666 400.8 Q(o\214le)-.45 +E F0(The systemwide initialization \214le, e)144 412.8 Q -.15(xe)-.15 G +(cuted for login shells).15 E F4(~/.bash_pr)109.666 424.8 Q(o\214le)-.45 +E F0(The personal initialization \214le, e)144 436.8 Q -.15(xe)-.15 G +(cuted for login shells).15 E F4(~/.bashr)109.666 448.8 Q(c)-.37 E F0 +(The indi)144 460.8 Q(vidual per)-.25 E(-interacti)-.2 E -.15(ve)-.25 G +(-shell startup \214le).15 E F4(~/.bash_lo)109.666 472.8 Q(gout)-.1 E F0 +(The indi)144 484.8 Q(vidual login shell cleanup \214le, e)-.25 E -.15 +(xe)-.15 G(cuted when a login shell e).15 E(xits)-.15 E F4(~/.inputr) +109.666 496.8 Q(c)-.37 E F0(Indi)144 508.8 Q(vidual)-.25 E F4 -.37(re) +2.5 G(adline).37 E F0(initialization \214le)2.5 E F3 -.548(AU)72 525.6 S +(THORS).548 E F0(Brian F)108 537.6 Q(ox, Free Softw)-.15 E(are F)-.1 E +(oundation)-.15 E(bfox@gnu.or)108 549.6 Q(g)-.18 E(Chet Rame)108 566.4 Q +1.3 -.65(y, C)-.15 H(ase W).65 E(estern Reserv)-.8 E 2.5(eU)-.15 G(ni) +-2.5 E -.15(ve)-.25 G(rsity).15 E(chet.rame)108 578.4 Q(y@case.edu)-.15 +E F3 -.11(BU)72 595.2 S 2.738(GR).11 G(EPOR)-2.738 E(TS)-.438 E F0 .568 +(If you \214nd a b)108 607.2 R .568(ug in)-.2 F F2(bash,)3.068 E F0 .568 (you should report it.)3.068 F .568(But \214rst, you should mak)5.568 F 3.068(es)-.1 G .568(ure that it really is a b)-3.068 F .567(ug, and)-.2 -F 5.625(that it appears in the latest v)108 602.4 R 5.625(ersion of)-.15 +F 5.625(that it appears in the latest v)108 619.2 R 5.625(ersion of)-.15 F F2(bash)8.125 E F0 10.625(.T)C 5.625(he latest v)-10.625 F 5.626 (ersion is al)-.15 F -.1(wa)-.1 G 5.626(ys a).1 F -.25(va)-.2 G 5.626 -(ilable from).25 F F4(ftp://ftp.gnu.or)108 614.4 Q(g/pub/gnu/bash/)-.37 -E F0(.)A .411(Once you ha)108 631.2 R .711 -.15(ve d)-.2 H .411 +(ilable from).25 F F4(ftp://ftp.gnu.or)108 631.2 Q(g/pub/gnu/bash/)-.37 +E F0(.)A .411(Once you ha)108 648 R .711 -.15(ve d)-.2 H .411 (etermined that a b).15 F .411(ug actually e)-.2 F .411(xists, use the) -.15 F F4(bashb)3.18 E(ug)-.2 E F0 .41(command to submit a b)3.13 F .41 -(ug report.)-.2 F(If)5.41 E .594(you ha)108 643.2 R .894 -.15(ve a \214) +(ug report.)-.2 F(If)5.41 E .594(you ha)108 660 R .894 -.15(ve a \214) -.2 H .595(x, you are encouraged to mail that as well!).15 F .595 (Suggestions and `philosophical' b)5.595 F .595(ug reports may)-.2 F -(be mailed to)108 655.2 Q F4 -.2(bu)2.5 G(g-bash@gnu.or).2 E(g)-.37 E F0 +(be mailed to)108 672 Q F4 -.2(bu)2.5 G(g-bash@gnu.or).2 E(g)-.37 E F0 (or posted to the Usenet ne)2.5 E(wsgroup)-.25 E F2(gnu.bash.b)2.5 E(ug) --.2 E F0(.)A(ALL b)108 672 Q(ug reports should include:)-.2 E(The v)108 -688.8 Q(ersion number of)-.15 E F2(bash)2.5 E F0(The hardw)108 700.8 Q -(are and operating system)-.1 E(GNU Bash 4.2)72 768 Q(2012 July 5) -151.505 E(73)200.665 E 0 Cg EP +-.2 E F0(.)A(ALL b)108 688.8 Q(ug reports should include:)-.2 E(The v) +108 705.6 Q(ersion number of)-.15 E F2(bash)2.5 E F0(GNU Bash 4.2)72 768 +Q(2012 July 14)149.005 E(73)198.165 E 0 Cg EP %%Page: 74 74 %%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(The compiler used to compile)108 84 Q 2.5(Ad)108 96 S -(escription of the b)-2.5 E(ug beha)-.2 E(viour)-.2 E 2.5(As)108 108 S +-.35 E(The hardw)108 84 Q(are and operating system)-.1 E +(The compiler used to compile)108 96 Q 2.5(Ad)108 108 S +(escription of the b)-2.5 E(ug beha)-.2 E(viour)-.2 E 2.5(As)108 120 S (hort script or `recipe' which e)-2.5 E -.15(xe)-.15 G(rcises the b).15 -E(ug)-.2 E/F1 10/Times-Italic@0 SF(bashb)108.27 124.8 Q(ug)-.2 E F0 +E(ug)-.2 E/F1 10/Times-Italic@0 SF(bashb)108.27 136.8 Q(ug)-.2 E F0 (inserts the \214rst three items automatically into the template it pro) 2.72 E(vides for \214ling a b)-.15 E(ug report.)-.2 E(Comments and b)108 -141.6 Q(ug reports concerning this manual page should be directed to)-.2 +153.6 Q(ug reports concerning this manual page should be directed to)-.2 E F1 -.15(ch)2.5 G(et.r).15 E(ame)-.15 E(y@case)-.3 E(.edu)-.15 E F0(.) -.25 E/F2 10.95/Times-Bold@0 SF -.11(BU)72 158.4 S(GS).11 E F0(It')108 -170.4 Q 2.5(st)-.55 G(oo big and too slo)-2.5 E -.65(w.)-.25 G 1.869 -(There are some subtle dif)108 187.2 R 1.869(ferences between)-.25 F/F3 +.25 E/F2 10.95/Times-Bold@0 SF -.11(BU)72 170.4 S(GS).11 E F0(It')108 +182.4 Q 2.5(st)-.55 G(oo big and too slo)-2.5 E -.65(w.)-.25 G 1.869 +(There are some subtle dif)108 199.2 R 1.869(ferences between)-.25 F/F3 10/Times-Bold@0 SF(bash)4.369 E F0 1.869(and traditional v)4.369 F 1.869 (ersions of)-.15 F F3(sh)4.368 E F0 4.368(,m)C 1.868 -(ostly because of the)-4.368 F/F4 9/Times-Bold@0 SF(POSIX)108 199.2 Q F0 -(speci\214cation.)2.25 E(Aliases are confusing in some uses.)108 216 Q -(Shell b)108 232.8 Q +(ostly because of the)-4.368 F/F4 9/Times-Bold@0 SF(POSIX)108 211.2 Q F0 +(speci\214cation.)2.25 E(Aliases are confusing in some uses.)108 228 Q +(Shell b)108 244.8 Q (uiltin commands and functions are not stoppable/restartable.)-.2 E 1.315(Compound commands and command sequences of the form `a ; b ; c' a\ -re not handled gracefully when)108 249.6 R .39 -(process suspension is attempted.)108 261.6 R .389 +re not handled gracefully when)108 261.6 R .39 +(process suspension is attempted.)108 273.6 R .389 (When a process is stopped, the shell immediately e)5.39 F -.15(xe)-.15 G .389(cutes the ne).15 F .389(xt com-)-.15 F .192 -(mand in the sequence.)108 273.6 R .192(It suf)5.192 F .192(\214ces to \ +(mand in the sequence.)108 285.6 R .192(It suf)5.192 F .192(\214ces to \ place the sequence of commands between parentheses to force it into a) --.25 F(subshell, which may be stopped as a unit.)108 285.6 Q(Array v)108 -302.4 Q(ariables may not \(yet\) be e)-.25 E(xported.)-.15 E -(There may be only one acti)108 319.2 Q .3 -.15(ve c)-.25 H -(oprocess at a time.).15 E(GNU Bash 4.2)72 768 Q(2012 July 5)151.505 E -(74)200.665 E 0 Cg EP +-.25 F(subshell, which may be stopped as a unit.)108 297.6 Q(Array v)108 +314.4 Q(ariables may not \(yet\) be e)-.25 E(xported.)-.15 E +(There may be only one acti)108 331.2 Q .3 -.15(ve c)-.25 H +(oprocess at a time.).15 E(GNU Bash 4.2)72 768 Q(2012 July 14)149.005 E +(74)198.165 E 0 Cg EP %%Trailer end %%EOF diff --git a/doc/bashref.dvi b/doc/bashref.dvi Binary files differindex dea7491e..07deff8e 100644 --- a/doc/bashref.dvi +++ b/doc/bashref.dvi diff --git a/doc/bashref.html b/doc/bashref.html index f67b4e9f..5ba85297 100644 --- a/doc/bashref.html +++ b/doc/bashref.html @@ -1,6 +1,6 @@ <HTML> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<!-- Created on July, 5 2012 by texi2html 1.64 --> +<!-- Created on July, 16 2012 by texi2html 1.64 --> <!-- Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author) Karl Berry <karl@freefriends.org> @@ -33,10 +33,10 @@ Send bugs and suggestions to <texi2html@mathematik.uni-kl.de> <H1>Bash Reference Manual</H1></P><P> This text is a brief description of the features that are present in -the Bash shell (version 4.2, 5 July 2012). +the Bash shell (version 4.2, 14 July 2012). </P><P> -This is Edition 4.2, last updated 5 July 2012, +This is Edition 4.2, last updated 14 July 2012, of <CITE>The GNU Bash Reference Manual</CITE>, for <CODE>Bash</CODE>, Version 4.2. </P><P> @@ -5762,6 +5762,14 @@ separately (see section <A HREF="bashref.html#SEC54">3.7.3 Command Execution Env subshells to exit before executing all the commands in the subshell. </P><P> +If a shell function executes in a context where <SAMP>`-e'</SAMP> is being ignored, +even if <SAMP>`-e'</SAMP> is set, none of the commands executed within the function +body will be affected by the <SAMP>`-e'</SAMP> setting. +If a shell function sets <SAMP>`-e'</SAMP> while executing in a context where +<SAMP>`-e'</SAMP> is ignored, that setting will not have any effect until the +command containing the function call completes. +</P><P> + <DT><CODE>-f</CODE> <DD>Disable filename expansion (globbing). <P> @@ -17081,7 +17089,7 @@ to permit their use in free software. <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="bashref.html#SEC_About"> ? </A>]</TD> </TR></TABLE> <H1>About this document</H1> -This document was generated by <I>Chet Ramey</I> on <I>July, 5 2012</I> +This document was generated by <I>Chet Ramey</I> on <I>July, 16 2012</I> using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html "><I>texi2html</I></A> <P></P> @@ -17243,7 +17251,7 @@ the following structure: <BR> <FONT SIZE="-1"> This document was generated -by <I>Chet Ramey</I> on <I>July, 5 2012</I> +by <I>Chet Ramey</I> on <I>July, 16 2012</I> using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html "><I>texi2html</I></A> diff --git a/doc/bashref.info b/doc/bashref.info index 22c25916..a42831b4 100644 --- a/doc/bashref.info +++ b/doc/bashref.info @@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 4.13 from /usr/homes/chet/src/bash/src/doc/bashref.texi. This text is a brief description of the features that are present in -the Bash shell (version 4.2, 5 July 2012). +the Bash shell (version 4.2, 14 July 2012). - This is Edition 4.2, last updated 5 July 2012, of `The GNU Bash + This is Edition 4.2, last updated 14 July 2012, of `The GNU Bash Reference Manual', for `Bash', Version 4.2. Copyright (C) 1988-2012 Free Software Foundation, Inc. @@ -33,9 +33,9 @@ Bash Features ************* This text is a brief description of the features that are present in -the Bash shell (version 4.2, 5 July 2012). +the Bash shell (version 4.2, 14 July 2012). - This is Edition 4.2, last updated 5 July 2012, of `The GNU Bash + This is Edition 4.2, last updated 14 July 2012, of `The GNU Bash Reference Manual', for `Bash', Version 4.2. Bash contains features that appear in other popular shells, and some @@ -3903,6 +3903,13 @@ parameters, or to display the names and values of shell variables. Environment::), and may cause subshells to exit before executing all the commands in the subshell. + If a shell function executes in a context where `-e' is being + ignored, even if `-e' is set, none of the commands executed + within the function body will be affected by the `-e' setting. + If a shell function sets `-e' while executing in a context + where `-e' is ignored, that setting will not have any effect + until the command containing the function call completes. + `-f' Disable filename expansion (globbing). @@ -11000,134 +11007,134 @@ D.5 Concept Index Tag Table: -Node: Top1089 -Node: Introduction2939 -Node: What is Bash?3167 -Node: What is a shell?4280 -Node: Definitions6819 -Node: Basic Shell Features9737 -Node: Shell Syntax10956 -Node: Shell Operation11986 -Node: Quoting13280 -Node: Escape Character14583 -Node: Single Quotes15068 -Node: Double Quotes15416 -Node: ANSI-C Quoting16541 -Node: Locale Translation17785 -Node: Comments18681 -Node: Shell Commands19299 -Node: Simple Commands20171 -Node: Pipelines20802 -Node: Lists23501 -Node: Compound Commands25230 -Node: Looping Constructs26236 -Node: Conditional Constructs28699 -Node: Command Grouping39532 -Node: Coprocesses41011 -Node: GNU Parallel42739 -Node: Shell Functions45207 -Node: Shell Parameters50291 -Node: Positional Parameters54420 -Node: Special Parameters55320 -Node: Shell Expansions58284 -Node: Brace Expansion60210 -Node: Tilde Expansion62964 -Node: Shell Parameter Expansion65313 -Node: Command Substitution77317 -Node: Arithmetic Expansion78650 -Node: Process Substitution79500 -Node: Word Splitting80550 -Node: Filename Expansion82173 -Node: Pattern Matching84338 -Node: Quote Removal88038 -Node: Redirections88333 -Node: Executing Commands97497 -Node: Simple Command Expansion98167 -Node: Command Search and Execution100097 -Node: Command Execution Environment102434 -Node: Environment105420 -Node: Exit Status107079 -Node: Signals108701 -Node: Shell Scripts110669 -Node: Shell Builtin Commands113187 -Node: Bourne Shell Builtins115215 -Node: Bash Builtins134807 -Node: Modifying Shell Behavior161837 -Node: The Set Builtin162182 -Node: The Shopt Builtin171930 -Node: Special Builtins185981 -Node: Shell Variables186960 -Node: Bourne Shell Variables187400 -Node: Bash Variables189431 -Node: Bash Features214941 -Node: Invoking Bash215840 -Node: Bash Startup Files221618 -Node: Interactive Shells226637 -Node: What is an Interactive Shell?227047 -Node: Is this Shell Interactive?227696 -Node: Interactive Shell Behavior228511 -Node: Bash Conditional Expressions231799 -Node: Shell Arithmetic235587 -Node: Aliases238363 -Node: Arrays240919 -Node: The Directory Stack245205 -Node: Directory Stack Builtins245924 -Node: Controlling the Prompt248880 -Node: The Restricted Shell251652 -Node: Bash POSIX Mode253489 -Node: Job Control262876 -Node: Job Control Basics263336 -Node: Job Control Builtins268055 -Node: Job Control Variables272407 -Node: Command Line Editing273565 -Node: Introduction and Notation275237 -Node: Readline Interaction276859 -Node: Readline Bare Essentials278050 -Node: Readline Movement Commands279839 -Node: Readline Killing Commands280804 -Node: Readline Arguments282724 -Node: Searching283768 -Node: Readline Init File285954 -Node: Readline Init File Syntax287101 -Node: Conditional Init Constructs303534 -Node: Sample Init File306067 -Node: Bindable Readline Commands309184 -Node: Commands For Moving310391 -Node: Commands For History311535 -Node: Commands For Text315720 -Node: Commands For Killing318393 -Node: Numeric Arguments320850 -Node: Commands For Completion321989 -Node: Keyboard Macros326181 -Node: Miscellaneous Commands326869 -Node: Readline vi Mode332675 -Node: Programmable Completion333582 -Node: Programmable Completion Builtins340832 -Node: A Programmable Completion Example350578 -Node: Using History Interactively355828 -Node: Bash History Facilities356512 -Node: Bash History Builtins359511 -Node: History Interaction363439 -Node: Event Designators366144 -Node: Word Designators367366 -Node: Modifiers369005 -Node: Installing Bash370409 -Node: Basic Installation371546 -Node: Compilers and Options374238 -Node: Compiling For Multiple Architectures374979 -Node: Installation Names376643 -Node: Specifying the System Type377461 -Node: Sharing Defaults378177 -Node: Operation Controls378850 -Node: Optional Features379808 -Node: Reporting Bugs389380 -Node: Major Differences From The Bourne Shell390581 -Node: GNU Free Documentation License407273 -Node: Indexes432469 -Node: Builtin Index432923 -Node: Reserved Word Index439750 -Node: Variable Index442198 -Node: Function Index455434 -Node: Concept Index462662 +Node: Top1091 +Node: Introduction2943 +Node: What is Bash?3171 +Node: What is a shell?4284 +Node: Definitions6823 +Node: Basic Shell Features9741 +Node: Shell Syntax10960 +Node: Shell Operation11990 +Node: Quoting13284 +Node: Escape Character14587 +Node: Single Quotes15072 +Node: Double Quotes15420 +Node: ANSI-C Quoting16545 +Node: Locale Translation17789 +Node: Comments18685 +Node: Shell Commands19303 +Node: Simple Commands20175 +Node: Pipelines20806 +Node: Lists23505 +Node: Compound Commands25234 +Node: Looping Constructs26240 +Node: Conditional Constructs28703 +Node: Command Grouping39536 +Node: Coprocesses41015 +Node: GNU Parallel42743 +Node: Shell Functions45211 +Node: Shell Parameters50295 +Node: Positional Parameters54424 +Node: Special Parameters55324 +Node: Shell Expansions58288 +Node: Brace Expansion60214 +Node: Tilde Expansion62968 +Node: Shell Parameter Expansion65317 +Node: Command Substitution77321 +Node: Arithmetic Expansion78654 +Node: Process Substitution79504 +Node: Word Splitting80554 +Node: Filename Expansion82177 +Node: Pattern Matching84342 +Node: Quote Removal88042 +Node: Redirections88337 +Node: Executing Commands97501 +Node: Simple Command Expansion98171 +Node: Command Search and Execution100101 +Node: Command Execution Environment102438 +Node: Environment105424 +Node: Exit Status107083 +Node: Signals108705 +Node: Shell Scripts110673 +Node: Shell Builtin Commands113191 +Node: Bourne Shell Builtins115219 +Node: Bash Builtins134811 +Node: Modifying Shell Behavior161841 +Node: The Set Builtin162186 +Node: The Shopt Builtin172358 +Node: Special Builtins186409 +Node: Shell Variables187388 +Node: Bourne Shell Variables187828 +Node: Bash Variables189859 +Node: Bash Features215369 +Node: Invoking Bash216268 +Node: Bash Startup Files222046 +Node: Interactive Shells227065 +Node: What is an Interactive Shell?227475 +Node: Is this Shell Interactive?228124 +Node: Interactive Shell Behavior228939 +Node: Bash Conditional Expressions232227 +Node: Shell Arithmetic236015 +Node: Aliases238791 +Node: Arrays241347 +Node: The Directory Stack245633 +Node: Directory Stack Builtins246352 +Node: Controlling the Prompt249308 +Node: The Restricted Shell252080 +Node: Bash POSIX Mode253917 +Node: Job Control263304 +Node: Job Control Basics263764 +Node: Job Control Builtins268483 +Node: Job Control Variables272835 +Node: Command Line Editing273993 +Node: Introduction and Notation275665 +Node: Readline Interaction277287 +Node: Readline Bare Essentials278478 +Node: Readline Movement Commands280267 +Node: Readline Killing Commands281232 +Node: Readline Arguments283152 +Node: Searching284196 +Node: Readline Init File286382 +Node: Readline Init File Syntax287529 +Node: Conditional Init Constructs303962 +Node: Sample Init File306495 +Node: Bindable Readline Commands309612 +Node: Commands For Moving310819 +Node: Commands For History311963 +Node: Commands For Text316148 +Node: Commands For Killing318821 +Node: Numeric Arguments321278 +Node: Commands For Completion322417 +Node: Keyboard Macros326609 +Node: Miscellaneous Commands327297 +Node: Readline vi Mode333103 +Node: Programmable Completion334010 +Node: Programmable Completion Builtins341260 +Node: A Programmable Completion Example351006 +Node: Using History Interactively356256 +Node: Bash History Facilities356940 +Node: Bash History Builtins359939 +Node: History Interaction363867 +Node: Event Designators366572 +Node: Word Designators367794 +Node: Modifiers369433 +Node: Installing Bash370837 +Node: Basic Installation371974 +Node: Compilers and Options374666 +Node: Compiling For Multiple Architectures375407 +Node: Installation Names377071 +Node: Specifying the System Type377889 +Node: Sharing Defaults378605 +Node: Operation Controls379278 +Node: Optional Features380236 +Node: Reporting Bugs389808 +Node: Major Differences From The Bourne Shell391009 +Node: GNU Free Documentation License407701 +Node: Indexes432897 +Node: Builtin Index433351 +Node: Reserved Word Index440178 +Node: Variable Index442626 +Node: Function Index455862 +Node: Concept Index463090 End Tag Table diff --git a/doc/bashref.log b/doc/bashref.log index 26582a5c..f511aa89 100644 --- a/doc/bashref.log +++ b/doc/bashref.log @@ -1,4 +1,4 @@ -This is TeX, Version 3.1415926 (TeX Live 2011/Fink) (format=tex 2012.4.18) 5 JUL 2012 20:43 +This is TeX, Version 3.1415926 (TeX Live 2011/Fink) (format=tex 2012.4.18) 16 JUL 2012 16:12 **/usr/homes/chet/src/bash/src/doc/bashref.texi (/usr/homes/chet/src/bash/src/doc/bashref.texi (./texinfo.tex Loading texinfo [version 2009-01-18.17]: @@ -246,7 +246,7 @@ m , @texttt vi-move[]@textrm , @texttt vi-command[]@textrm , and [48] [49] [50] [51] [52] [53] [54] [55] [56] [57] [58] [59] [60] [61] [62] [63] [64] -Underfull \hbox (badness 5460) in paragraph at lines 4984--4990 +Underfull \hbox (badness 5460) in paragraph at lines 4991--4997 []@textrm If set, range ex-pres-sions used in pat-tern match-ing (see @hbox(8.2125+2.73749)x433.62, glue set 3.79674 @@ -257,9 +257,9 @@ Underfull \hbox (badness 5460) in paragraph at lines 4984--4990 .@glue 3.65 plus 1.825 minus 1.21666 .etc. -[65] [66] Chapter 5 [67] [68] [69] [70] [71] [72] [73] [74] [75] [76] [77] +[65] [66] [67] Chapter 5 [68] [69] [70] [71] [72] [73] [74] [75] [76] [77] Chapter 6 [78] -Overfull \hbox (51.96864pt too wide) in paragraph at lines 5884--5884 +Overfull \hbox (51.96864pt too wide) in paragraph at lines 5891--5891 []@texttt bash [long-opt] [-ir] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@t exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar- @@ -272,7 +272,7 @@ exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar- .etc. -Overfull \hbox (76.23077pt too wide) in paragraph at lines 5885--5885 +Overfull \hbox (76.23077pt too wide) in paragraph at lines 5892--5892 []@texttt bash [long-opt] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@texttt ] [-O @textttsl shopt_option@texttt ] -c @textttsl string @texttt [@textttsl ar - @@ -286,7 +286,7 @@ Overfull \hbox (76.23077pt too wide) in paragraph at lines 5885--5885 .etc. -Overfull \hbox (34.72258pt too wide) in paragraph at lines 5886--5886 +Overfull \hbox (34.72258pt too wide) in paragraph at lines 5893--5893 []@texttt bash [long-opt] -s [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@text tt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar- @@ -299,7 +299,7 @@ tt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar- .etc. [79] [80] -Underfull \hbox (badness 2245) in paragraph at lines 6058--6060 +Underfull \hbox (badness 2245) in paragraph at lines 6065--6067 []@textrm When a lo-gin shell ex-its, Bash reads and ex-e-cutes com-mands from the file @@ -312,7 +312,7 @@ the file .etc. [81] [82] [83] [84] [85] [86] [87] [88] [89] [90] [91] [92] [93] [94] -Underfull \hbox (badness 2521) in paragraph at lines 7256--7259 +Underfull \hbox (badness 2521) in paragraph at lines 7263--7266 @textrm `@texttt --enable-strict-posix-default[]@textrm '[] to @texttt configur e[] @textrm when build-ing (see Sec-tion 10.8 @@ -393,7 +393,7 @@ athname[] [131]) (/usr/homes/chet/src/bash/src/lib/readline/doc/hsuser.texi Chapter 9 [132] [133] [134] [135] [136]) Chapter 10 [137] [138] [139] [140] [141] -Underfull \hbox (badness 2772) in paragraph at lines 7862--7866 +Underfull \hbox (badness 2772) in paragraph at lines 7869--7873 []@textrm Enable sup-port for large files (@texttt http://www.sas.com/standard s/large_ @@ -413,10 +413,10 @@ s/large_ Here is how much of TeX's memory you used: 2085 strings out of 497974 28645 string characters out of 3220833 - 65554 words of memory out of 3000000 + 65556 words of memory out of 3000000 2901 multiletter control sequences out of 15000+200000 32127 words of font info for 112 fonts, out of 3000000 for 9000 51 hyphenation exceptions out of 8191 16i,6n,14p,319b,705s stack positions out of 5000i,500n,10000p,200000b,50000s -Output written on bashref.dvi (176 pages, 708852 bytes). +Output written on bashref.dvi (176 pages, 709392 bytes). diff --git a/doc/bashref.pdf b/doc/bashref.pdf Binary files differindex 1e47d7c4..51b0ee48 100644 --- a/doc/bashref.pdf +++ b/doc/bashref.pdf diff --git a/doc/bashref.ps b/doc/bashref.ps index 856d34b7..086f3527 100644 --- a/doc/bashref.ps +++ b/doc/bashref.ps @@ -1,7 +1,7 @@ %!PS-Adobe-2.0 %%Creator: dvips(k) 5.991 Copyright 2011 Radical Eye Software %%Title: bashref.dvi -%%CreationDate: Thu Jul 5 20:43:08 2012 +%%CreationDate: Mon Jul 16 16:12:34 2012 %%Pages: 176 %%PageOrder: Ascend %%BoundingBox: 0 0 612 792 @@ -12,7 +12,7 @@ %DVIPSWebPage: (www.radicaleye.com) %DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps bashref.dvi %DVIPSParameters: dpi=600 -%DVIPSSource: TeX output 2012.07.05:2043 +%DVIPSSource: TeX output 2012.07.16:1612 %%BeginProcSet: tex.pro 0 0 %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -6974,25 +6974,25 @@ b(oundation)p 150 5141 3600 17 v eop end %%Page: 2 2 TeXDict begin 2 1 bop 150 3352 a Ft(This)35 b(text)h(is)g(a)g(brief)f (description)h(of)f(the)h(features)g(that)g(are)g(presen)m(t)g(in)f -(the)h(Bash)f(shell)h(\(v)m(ersion)150 3462 y(4.2,)c(5)e(July)g -(2012\).)150 3597 y(This)38 b(is)h(Edition)g(4.2,)j(last)d(up)s(dated)f -(5)h(July)f(2012,)43 b(of)c Fq(The)f(GNU)i(Bash)f(Reference)g(Man)m -(ual)p Ft(,)j(for)150 3706 y Fs(Bash)p Ft(,)29 b(V)-8 -b(ersion)31 b(4.2.)150 3841 y(Cop)m(yrigh)m(t)602 3838 -y(c)577 3841 y Fp(\015)f Ft(1988{2012)35 b(F)-8 b(ree)31 -b(Soft)m(w)m(are)h(F)-8 b(oundation,)31 b(Inc.)150 3975 -y(P)m(ermission)h(is)h(gran)m(ted)g(to)f(mak)m(e)i(and)d(distribute)h -(v)m(erbatim)h(copies)g(of)f(this)g(man)m(ual)h(pro)m(vided)f(the)150 -4085 y(cop)m(yrigh)m(t)g(notice)f(and)f(this)g(p)s(ermission)g(notice)h -(are)g(preserv)m(ed)f(on)h(all)g(copies.)390 4219 y(P)m(ermission)21 -b(is)f(gran)m(ted)h(to)g(cop)m(y)-8 b(,)24 b(distribute)c(and/or)h(mo)s -(dify)e(this)i(do)s(cumen)m(t)f(under)f(the)390 4329 -y(terms)25 b(of)h(the)f(GNU)h(F)-8 b(ree)27 b(Do)s(cumen)m(tation)g -(License,)g(V)-8 b(ersion)26 b(1.3)g(or)f(an)m(y)h(later)g(v)m(ersion) -390 4438 y(published)43 b(b)m(y)h(the)h(F)-8 b(ree)46 -b(Soft)m(w)m(are)g(F)-8 b(oundation;)53 b(with)44 b(no)g(In)m(v)-5 -b(arian)m(t)46 b(Sections,)j(no)390 4548 y(F)-8 b(ron)m(t-Co)m(v)m(er) -31 b(T)-8 b(exts,)30 b(and)f(no)f(Bac)m(k-Co)m(v)m(er)k(T)-8 +(the)h(Bash)f(shell)h(\(v)m(ersion)150 3462 y(4.2,)c(14)f(July)f +(2012\).)150 3597 y(This)35 b(is)h(Edition)g(4.2,)j(last)d(up)s(dated)f +(14)i(July)e(2012,)k(of)d Fq(The)g(GNU)g(Bash)g(Reference)h(Man)m(ual)p +Ft(,)h(for)150 3706 y Fs(Bash)p Ft(,)29 b(V)-8 b(ersion)31 +b(4.2.)150 3841 y(Cop)m(yrigh)m(t)602 3838 y(c)577 3841 +y Fp(\015)f Ft(1988{2012)35 b(F)-8 b(ree)31 b(Soft)m(w)m(are)h(F)-8 +b(oundation,)31 b(Inc.)150 3975 y(P)m(ermission)h(is)h(gran)m(ted)g(to) +f(mak)m(e)i(and)d(distribute)h(v)m(erbatim)h(copies)g(of)f(this)g(man)m +(ual)h(pro)m(vided)f(the)150 4085 y(cop)m(yrigh)m(t)g(notice)f(and)f +(this)g(p)s(ermission)g(notice)h(are)g(preserv)m(ed)f(on)h(all)g +(copies.)390 4219 y(P)m(ermission)21 b(is)f(gran)m(ted)h(to)g(cop)m(y) +-8 b(,)24 b(distribute)c(and/or)h(mo)s(dify)e(this)i(do)s(cumen)m(t)f +(under)f(the)390 4329 y(terms)25 b(of)h(the)f(GNU)h(F)-8 +b(ree)27 b(Do)s(cumen)m(tation)g(License,)g(V)-8 b(ersion)26 +b(1.3)g(or)f(an)m(y)h(later)g(v)m(ersion)390 4438 y(published)43 +b(b)m(y)h(the)h(F)-8 b(ree)46 b(Soft)m(w)m(are)g(F)-8 +b(oundation;)53 b(with)44 b(no)g(In)m(v)-5 b(arian)m(t)46 +b(Sections,)j(no)390 4548 y(F)-8 b(ron)m(t-Co)m(v)m(er)31 +b(T)-8 b(exts,)30 b(and)f(no)f(Bac)m(k-Co)m(v)m(er)k(T)-8 b(exts.)41 b(A)29 b(cop)m(y)h(of)f(the)g(license)h(is)f(included)390 4658 y(in)h(the)h(section)g(en)m(titled)h(\\GNU)f(F)-8 b(ree)32 b(Do)s(cumen)m(tation)g(License".)150 4902 y(Published)d(b)m @@ -11703,561 +11703,573 @@ Ft(list)h(except)g(the)g(command)g(follo)m(wing)h(the)1110 Fs(-e)p Ft(')h(w)m(as)f(b)s(eing)g(ignored,)h(the)g(shell)g(do)s(es)f (not)1110 1395 y(exit.)42 b(A)30 b(trap)g(on)h Fs(ERR)p Ft(,)e(if)i(set,)g(is)f(executed)i(b)s(efore)e(the)g(shell)h(exits.) -1110 1529 y(This)f(option)h(applies)f(to)h(the)g(shell)g(en)m(vironmen) -m(t)g(and)f(eac)m(h)h(subshell)f(en-)1110 1638 y(vironmen)m(t)j +1110 1532 y(This)f(option)h(applies)f(to)h(the)g(shell)g(en)m(vironmen) +m(t)g(and)f(eac)m(h)h(subshell)f(en-)1110 1641 y(vironmen)m(t)j (separately)i(\(see)f(Section)g(3.7.3)h([Command)d(Execution)i(En-)1110 -1748 y(vironmen)m(t],)i(page)f(36\),)i(and)d(ma)m(y)h(cause)f -(subshells)g(to)h(exit)g(b)s(efore)f(exe-)1110 1857 y(cuting)d(all)g -(the)g(commands)f(in)g(the)g(subshell.)630 2016 y Fs(-f)384 -b Ft(Disable)31 b(\014lename)g(expansion)f(\(globbing\).)630 -2174 y Fs(-h)384 b Ft(Lo)s(cate)33 b(and)e(remem)m(b)s(er)h(\(hash\))g -(commands)f(as)h(they)g(are)g(lo)s(ok)m(ed)h(up)e(for)1110 -2284 y(execution.)42 b(This)29 b(option)i(is)g(enabled)f(b)m(y)g -(default.)630 2442 y Fs(-k)384 b Ft(All)34 b(argumen)m(ts)g(in)f(the)h -(form)f(of)g(assignmen)m(t)h(statemen)m(ts)i(are)d(placed)h(in)1110 -2552 y(the)k(en)m(vironmen)m(t)g(for)g(a)g(command,)h(not)f(just)f -(those)i(that)f(precede)g(the)1110 2661 y(command)30 -b(name.)630 2819 y Fs(-m)384 b Ft(Job)32 b(con)m(trol)h(is)f(enabled)g +1751 y(vironmen)m(t],)i(page)f(36\),)i(and)d(ma)m(y)h(cause)f +(subshells)g(to)h(exit)g(b)s(efore)f(exe-)1110 1861 y(cuting)d(all)g +(the)g(commands)f(in)g(the)g(subshell.)1110 1998 y(If)c(a)g(shell)h +(function)e(executes)j(in)e(a)g(con)m(text)i(where)e(`)p +Fs(-e)p Ft(')g(is)g(b)s(eing)g(ignored,)1110 2107 y(ev)m(en)j(if)f(`)p +Fs(-e)p Ft(')g(is)g(set,)h(none)f(of)g(the)g(commands)g(executed)h +(within)e(the)i(func-)1110 2217 y(tion)38 b(b)s(o)s(dy)e(will)i(b)s(e)e +(a\013ected)j(b)m(y)f(the)f(`)p Fs(-e)p Ft(')h(setting.)63 +b(If)37 b(a)h(shell)f(function)1110 2326 y(sets)i(`)p +Fs(-e)p Ft(')f(while)h(executing)g(in)f(a)h(con)m(text)i(where)d(`)p +Fs(-e)p Ft(')g(is)g(ignored,)j(that)1110 2436 y(setting)35 +b(will)f(not)g(ha)m(v)m(e)h(an)m(y)f(e\013ect)h(un)m(til)f(the)g +(command)f(con)m(taining)j(the)1110 2545 y(function)30 +b(call)i(completes.)630 2710 y Fs(-f)384 b Ft(Disable)31 +b(\014lename)g(expansion)f(\(globbing\).)630 2874 y Fs(-h)384 +b Ft(Lo)s(cate)33 b(and)e(remem)m(b)s(er)h(\(hash\))g(commands)f(as)h +(they)g(are)g(lo)s(ok)m(ed)h(up)e(for)1110 2984 y(execution.)42 +b(This)29 b(option)i(is)g(enabled)f(b)m(y)g(default.)630 +3148 y Fs(-k)384 b Ft(All)34 b(argumen)m(ts)g(in)f(the)h(form)f(of)g +(assignmen)m(t)h(statemen)m(ts)i(are)d(placed)h(in)1110 +3258 y(the)k(en)m(vironmen)m(t)g(for)g(a)g(command,)h(not)f(just)f +(those)i(that)f(precede)g(the)1110 3367 y(command)30 +b(name.)630 3532 y Fs(-m)384 b Ft(Job)32 b(con)m(trol)h(is)f(enabled)g (\(see)h(Chapter)f(7)g([Job)g(Con)m(trol],)i(page)e(97\).)47 -b(All)1110 2929 y(pro)s(cesses)27 b(run)f(in)i(a)g(separate)g(pro)s +b(All)1110 3641 y(pro)s(cesses)27 b(run)f(in)i(a)g(separate)g(pro)s (cess)f(group.)40 b(When)27 b(a)h(bac)m(kground)f(job)1110 -3039 y(completes,)32 b(the)f(shell)f(prin)m(ts)g(a)h(line)f(con)m -(taining)i(its)f(exit)g(status.)630 3197 y Fs(-n)384 +3751 y(completes,)32 b(the)f(shell)f(prin)m(ts)g(a)h(line)f(con)m +(taining)i(its)f(exit)g(status.)630 3915 y Fs(-n)384 b Ft(Read)21 b(commands)f(but)g(do)h(not)g(execute)h(them;)i(this)d(ma) -m(y)g(b)s(e)f(used)g(to)h(c)m(hec)m(k)1110 3306 y(a)42 +m(y)g(b)s(e)f(used)g(to)h(c)m(hec)m(k)1110 4025 y(a)42 b(script)g(for)g(syn)m(tax)g(errors.)75 b(This)41 b(option)h(is)g -(ignored)g(b)m(y)g(in)m(teractiv)m(e)1110 3416 y(shells.)630 -3574 y Fs(-o)30 b Fi(option-name)1110 3684 y Ft(Set)h(the)f(option)h +(ignored)g(b)m(y)g(in)m(teractiv)m(e)1110 4134 y(shells.)630 +4299 y Fs(-o)30 b Fi(option-name)1110 4408 y Ft(Set)h(the)f(option)h (corresp)s(onding)e(to)i Fq(option-name)5 b Ft(:)1110 -3842 y Fs(allexport)1590 3952 y Ft(Same)30 b(as)h Fs(-a)p -Ft(.)1110 4110 y Fs(braceexpand)1590 4220 y Ft(Same)f(as)h -Fs(-B)p Ft(.)1110 4378 y Fs(emacs)240 b Ft(Use)25 b(an)f +4573 y Fs(allexport)1590 4682 y Ft(Same)30 b(as)h Fs(-a)p +Ft(.)1110 4847 y Fs(braceexpand)1590 4956 y Ft(Same)f(as)h +Fs(-B)p Ft(.)1110 5121 y Fs(emacs)240 b Ft(Use)25 b(an)f Fs(emacs)p Ft(-st)m(yle)h(line)f(editing)h(in)m(terface)h(\(see)g -(Chapter)e(8)1590 4488 y([Command)33 b(Line)g(Editing],)h(page)h -(101\).)51 b(This)32 b(also)i(a\013ects)1590 4597 y(the)d(editing)g(in) -m(terface)h(used)d(for)h Fs(read)f(-e)p Ft(.)1110 4756 -y Fs(errexit)144 b Ft(Same)30 b(as)h Fs(-e)p Ft(.)1110 -4914 y Fs(errtrace)96 b Ft(Same)30 b(as)h Fs(-E)p Ft(.)1110 -5072 y Fs(functrace)1590 5182 y Ft(Same)f(as)h Fs(-T)p -Ft(.)1110 5340 y Fs(hashall)144 b Ft(Same)30 b(as)h Fs(-h)p -Ft(.)p eop end +(Chapter)e(8)1590 5230 y([Command)33 b(Line)g(Editing],)h(page)h +(101\).)51 b(This)32 b(also)i(a\013ects)1590 5340 y(the)d(editing)g(in) +m(terface)h(used)d(for)h Fs(read)f(-e)p Ft(.)p eop end %%Page: 60 66 TeXDict begin 60 65 bop 150 -116 a Ft(60)2572 b(Bash)31 -b(Reference)g(Man)m(ual)1110 299 y Fs(histexpand)1590 -408 y Ft(Same)f(as)h Fs(-H)p Ft(.)1110 570 y Fs(history)144 +b(Reference)g(Man)m(ual)1110 299 y Fs(errexit)144 b Ft(Same)30 +b(as)h Fs(-e)p Ft(.)1110 461 y Fs(errtrace)96 b Ft(Same)30 +b(as)h Fs(-E)p Ft(.)1110 622 y Fs(functrace)1590 732 +y Ft(Same)f(as)h Fs(-T)p Ft(.)1110 894 y Fs(hashall)144 +b Ft(Same)30 b(as)h Fs(-h)p Ft(.)1110 1056 y Fs(histexpand)1590 +1165 y Ft(Same)f(as)h Fs(-H)p Ft(.)1110 1327 y Fs(history)144 b Ft(Enable)39 b(command)g(history)-8 b(,)42 b(as)d(describ)s(ed)f(in)h -(Section)h(9.1)1590 680 y([Bash)d(History)g(F)-8 b(acilities],)41 -b(page)c(133.)60 b(This)36 b(option)h(is)f(on)1590 789 +(Section)h(9.1)1590 1437 y([Bash)d(History)g(F)-8 b(acilities],)41 +b(page)c(133.)60 b(This)36 b(option)h(is)f(on)1590 1546 y(b)m(y)30 b(default)h(in)f(in)m(teractiv)m(e)j(shells.)1110 -951 y Fs(ignoreeof)1590 1060 y Ft(An)d(in)m(teractiv)m(e)j(shell)e -(will)g(not)f(exit)h(up)s(on)e(reading)i(EOF.)1110 1222 +1708 y Fs(ignoreeof)1590 1817 y Ft(An)d(in)m(teractiv)m(e)j(shell)e +(will)g(not)f(exit)h(up)s(on)e(reading)i(EOF.)1110 1979 y Fs(keyword)144 b Ft(Same)30 b(as)h Fs(-k)p Ft(.)1110 -1383 y Fs(monitor)144 b Ft(Same)30 b(as)h Fs(-m)p Ft(.)1110 -1545 y Fs(noclobber)1590 1654 y Ft(Same)f(as)h Fs(-C)p -Ft(.)1110 1816 y Fs(noexec)192 b Ft(Same)30 b(as)h Fs(-n)p -Ft(.)1110 1977 y Fs(noglob)192 b Ft(Same)30 b(as)h Fs(-f)p -Ft(.)1110 2139 y Fs(nolog)240 b Ft(Curren)m(tly)30 b(ignored.)1110 -2300 y Fs(notify)192 b Ft(Same)30 b(as)h Fs(-b)p Ft(.)1110 -2462 y Fs(nounset)144 b Ft(Same)30 b(as)h Fs(-u)p Ft(.)1110 -2623 y Fs(onecmd)192 b Ft(Same)30 b(as)h Fs(-t)p Ft(.)1110 -2785 y Fs(physical)96 b Ft(Same)30 b(as)h Fs(-P)p Ft(.)1110 -2946 y Fs(pipefail)96 b Ft(If)44 b(set,)k(the)d(return)e(v)-5 +2141 y Fs(monitor)144 b Ft(Same)30 b(as)h Fs(-m)p Ft(.)1110 +2303 y Fs(noclobber)1590 2412 y Ft(Same)f(as)h Fs(-C)p +Ft(.)1110 2574 y Fs(noexec)192 b Ft(Same)30 b(as)h Fs(-n)p +Ft(.)1110 2736 y Fs(noglob)192 b Ft(Same)30 b(as)h Fs(-f)p +Ft(.)1110 2898 y Fs(nolog)240 b Ft(Curren)m(tly)30 b(ignored.)1110 +3059 y Fs(notify)192 b Ft(Same)30 b(as)h Fs(-b)p Ft(.)1110 +3221 y Fs(nounset)144 b Ft(Same)30 b(as)h Fs(-u)p Ft(.)1110 +3383 y Fs(onecmd)192 b Ft(Same)30 b(as)h Fs(-t)p Ft(.)1110 +3545 y Fs(physical)96 b Ft(Same)30 b(as)h Fs(-P)p Ft(.)1110 +3707 y Fs(pipefail)96 b Ft(If)44 b(set,)k(the)d(return)e(v)-5 b(alue)45 b(of)f(a)h(pip)s(eline)e(is)i(the)f(v)-5 b(alue)45 -b(of)1590 3056 y(the)33 b(last)h(\(righ)m(tmost\))h(command)e(to)h -(exit)g(with)f(a)g(non-zero)1590 3165 y(status,)28 b(or)f(zero)g(if)f +b(of)1590 3816 y(the)33 b(last)h(\(righ)m(tmost\))h(command)e(to)h +(exit)g(with)f(a)g(non-zero)1590 3926 y(status,)28 b(or)f(zero)g(if)f (all)i(commands)e(in)g(the)h(pip)s(eline)f(exit)i(suc-)1590 -3275 y(cessfully)-8 b(.)41 b(This)30 b(option)h(is)f(disabled)g(b)m(y)h -(default.)1110 3437 y Fs(posix)240 b Ft(Change)30 b(the)g(b)s(eha)m +4035 y(cessfully)-8 b(.)41 b(This)30 b(option)h(is)f(disabled)g(b)m(y)h +(default.)1110 4197 y Fs(posix)240 b Ft(Change)30 b(the)g(b)s(eha)m (vior)h(of)f(Bash)g(where)g(the)g(default)h(op)s(era-)1590 -3546 y(tion)25 b(di\013ers)f(from)g(the)h Fl(posix)f -Ft(standard)f(to)i(matc)m(h)h(the)f(stan-)1590 3656 y(dard)32 +4307 y(tion)25 b(di\013ers)f(from)g(the)h Fl(posix)f +Ft(standard)f(to)i(matc)m(h)h(the)f(stan-)1590 4416 y(dard)32 b(\(see)i(Section)g(6.11)h([Bash)e(POSIX)f(Mo)s(de],)j(page)e(92\).) -1590 3765 y(This)k(is)g(in)m(tended)g(to)h(mak)m(e)g(Bash)g(b)s(eha)m -(v)m(e)g(as)g(a)f(strict)h(su-)1590 3875 y(p)s(erset)30 -b(of)h(that)f(standard.)1110 4036 y Fs(privileged)1590 -4146 y Ft(Same)g(as)h Fs(-p)p Ft(.)1110 4308 y Fs(verbose)144 -b Ft(Same)30 b(as)h Fs(-v)p Ft(.)1110 4469 y Fs(vi)384 +1590 4526 y(This)k(is)g(in)m(tended)g(to)h(mak)m(e)g(Bash)g(b)s(eha)m +(v)m(e)g(as)g(a)f(strict)h(su-)1590 4635 y(p)s(erset)30 +b(of)h(that)f(standard.)1110 4797 y Fs(privileged)1590 +4907 y Ft(Same)g(as)h Fs(-p)p Ft(.)1110 5069 y Fs(verbose)144 +b Ft(Same)30 b(as)h Fs(-v)p Ft(.)1110 5230 y Fs(vi)384 b Ft(Use)36 b(a)g Fs(vi)p Ft(-st)m(yle)g(line)g(editing)g(in)m -(terface.)58 b(This)35 b(also)h(a\013ects)1590 4579 y(the)31 +(terface.)58 b(This)35 b(also)h(a\013ects)1590 5340 y(the)31 b(editing)g(in)m(terface)h(used)d(for)h Fs(read)f(-e)p -Ft(.)1110 4740 y Fs(xtrace)192 b Ft(Same)30 b(as)h Fs(-x)p -Ft(.)630 4902 y Fs(-p)384 b Ft(T)-8 b(urn)33 b(on)h(privileged)h(mo)s -(de.)51 b(In)34 b(this)g(mo)s(de,)h(the)f Fs($BASH_ENV)e -Ft(and)h Fs($ENV)1110 5011 y Ft(\014les)23 b(are)h(not)f(pro)s(cessed,) -h(shell)g(functions)e(are)i(not)f(inherited)g(from)f(the)i(en-)1110 -5121 y(vironmen)m(t,)h(and)e(the)g Fs(SHELLOPTS)p Ft(,)f -Fs(BASHOPTS)p Ft(,)h Fs(CDPATH)e Ft(and)i Fs(GLOBIGNORE)1110 -5230 y Ft(v)-5 b(ariables,)23 b(if)e(they)g(app)s(ear)f(in)g(the)h(en)m -(vironmen)m(t,)i(are)e(ignored.)38 b(If)20 b(the)h(shell)1110 -5340 y(is)37 b(started)h(with)f(the)g(e\013ectiv)m(e)j(user)d -(\(group\))g(id)g(not)g(equal)h(to)g(the)f(real)p eop -end +Ft(.)p eop end %%Page: 61 67 TeXDict begin 61 66 bop 150 -116 a Ft(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(61)1110 299 y(user)34 -b(\(group\))g(id,)i(and)e(the)g(`)p Fs(-p)p Ft(')g(option)h(is)g(not)f -(supplied,)h(these)g(actions)1110 408 y(are)d(tak)m(en)i(and)d(the)h -(e\013ectiv)m(e)j(user)c(id)h(is)g(set)h(to)f(the)h(real)f(user)g(id.) -45 b(If)32 b(the)1110 518 y(`)p Fs(-p)p Ft(')e(option)i(is)e(supplied)g +b(Shell)30 b(Builtin)h(Commands)2069 b(61)1110 299 y +Fs(xtrace)192 b Ft(Same)30 b(as)h Fs(-x)p Ft(.)630 458 +y Fs(-p)384 b Ft(T)-8 b(urn)33 b(on)h(privileged)h(mo)s(de.)51 +b(In)34 b(this)g(mo)s(de,)h(the)f Fs($BASH_ENV)e Ft(and)h +Fs($ENV)1110 568 y Ft(\014les)23 b(are)h(not)f(pro)s(cessed,)h(shell)g +(functions)e(are)i(not)f(inherited)g(from)f(the)i(en-)1110 +677 y(vironmen)m(t,)h(and)e(the)g Fs(SHELLOPTS)p Ft(,)f +Fs(BASHOPTS)p Ft(,)h Fs(CDPATH)e Ft(and)i Fs(GLOBIGNORE)1110 +787 y Ft(v)-5 b(ariables,)23 b(if)e(they)g(app)s(ear)f(in)g(the)h(en)m +(vironmen)m(t,)i(are)e(ignored.)38 b(If)20 b(the)h(shell)1110 +897 y(is)37 b(started)h(with)f(the)g(e\013ectiv)m(e)j(user)d(\(group\)) +g(id)g(not)g(equal)h(to)g(the)f(real)1110 1006 y(user)d(\(group\))g +(id,)i(and)e(the)g(`)p Fs(-p)p Ft(')g(option)h(is)g(not)f(supplied,)h +(these)g(actions)1110 1116 y(are)d(tak)m(en)i(and)d(the)h(e\013ectiv)m +(e)j(user)c(id)h(is)g(set)h(to)f(the)h(real)f(user)g(id.)45 +b(If)32 b(the)1110 1225 y(`)p Fs(-p)p Ft(')e(option)i(is)e(supplied)g (at)h(startup,)f(the)h(e\013ectiv)m(e)i(user)d(id)h(is)f(not)h(reset.) -1110 628 y(T)-8 b(urning)35 b(this)i(option)g(o\013)g(causes)g(the)g +1110 1335 y(T)-8 b(urning)35 b(this)i(option)g(o\013)g(causes)g(the)g (e\013ectiv)m(e)i(user)d(and)g(group)g(ids)g(to)1110 -737 y(b)s(e)30 b(set)h(to)g(the)f(real)h(user)f(and)g(group)g(ids.)630 -887 y Fs(-t)384 b Ft(Exit)31 b(after)g(reading)f(and)g(executing)h(one) -g(command.)630 1036 y Fs(-u)384 b Ft(T)-8 b(reat)25 b(unset)e(v)-5 -b(ariables)25 b(and)e(parameters)h(other)h(than)e(the)h(sp)s(ecial)h -(param-)1110 1146 y(eters)35 b(`)p Fs(@)p Ft(')f(or)g(`)p -Fs(*)p Ft(')h(as)f(an)g(error)g(when)f(p)s(erforming)g(parameter)i -(expansion.)1110 1255 y(An)28 b(error)h(message)g(will)g(b)s(e)f -(written)h(to)h(the)e(standard)g(error,)h(and)f(a)h(non-)1110 -1365 y(in)m(teractiv)m(e)k(shell)e(will)g(exit.)630 1514 +1445 y(b)s(e)30 b(set)h(to)g(the)f(real)h(user)f(and)g(group)g(ids.)630 +1604 y Fs(-t)384 b Ft(Exit)31 b(after)g(reading)f(and)g(executing)h +(one)g(command.)630 1763 y Fs(-u)384 b Ft(T)-8 b(reat)25 +b(unset)e(v)-5 b(ariables)25 b(and)e(parameters)h(other)h(than)e(the)h +(sp)s(ecial)h(param-)1110 1873 y(eters)35 b(`)p Fs(@)p +Ft(')f(or)g(`)p Fs(*)p Ft(')h(as)f(an)g(error)g(when)f(p)s(erforming)g +(parameter)i(expansion.)1110 1983 y(An)28 b(error)h(message)g(will)g(b) +s(e)f(written)h(to)h(the)e(standard)g(error,)h(and)f(a)h(non-)1110 +2092 y(in)m(teractiv)m(e)k(shell)e(will)g(exit.)630 2252 y Fs(-v)384 b Ft(Prin)m(t)30 b(shell)h(input)e(lines)i(as)g(they)f(are) -h(read.)630 1664 y Fs(-x)384 b Ft(Prin)m(t)21 b(a)h(trace)h(of)f +h(read.)630 2411 y Fs(-x)384 b Ft(Prin)m(t)21 b(a)h(trace)h(of)f (simple)f(commands,)i Fs(for)e Ft(commands,)i Fs(case)d -Ft(commands,)1110 1773 y Fs(select)29 b Ft(commands,)j(and)e +Ft(commands,)1110 2521 y Fs(select)29 b Ft(commands,)j(and)e (arithmetic)j Fs(for)d Ft(commands)h(and)f(their)i(argu-)1110 -1883 y(men)m(ts)h(or)f(asso)s(ciated)i(w)m(ord)e(lists)h(after)g(they)f -(are)h(expanded)f(and)f(b)s(efore)1110 1993 y(they)i(are)g(executed.)49 +2630 y(men)m(ts)h(or)f(asso)s(ciated)i(w)m(ord)e(lists)h(after)g(they)f +(are)h(expanded)f(and)f(b)s(efore)1110 2740 y(they)i(are)g(executed.)49 b(The)32 b(v)-5 b(alue)33 b(of)g(the)g Fs(PS4)f Ft(v)-5 -b(ariable)34 b(is)f(expanded)f(and)1110 2102 y(the)24 +b(ariable)34 b(is)f(expanded)f(and)1110 2849 y(the)24 b(resultan)m(t)h(v)-5 b(alue)24 b(is)g(prin)m(ted)g(b)s(efore)f(the)h -(command)g(and)f(its)i(expanded)1110 2212 y(argumen)m(ts.)630 -2361 y Fs(-B)384 b Ft(The)41 b(shell)g(will)g(p)s(erform)f(brace)h -(expansion)g(\(see)h(Section)g(3.5.1)g([Brace)1110 2471 +(command)g(and)f(its)i(expanded)1110 2959 y(argumen)m(ts.)630 +3118 y Fs(-B)384 b Ft(The)41 b(shell)g(will)g(p)s(erform)f(brace)h +(expansion)g(\(see)h(Section)g(3.5.1)g([Brace)1110 3228 y(Expansion],)30 b(page)h(21\).)42 b(This)30 b(option)h(is)f(on)g(b)m -(y)h(default.)630 2620 y Fs(-C)384 b Ft(Prev)m(en)m(t)25 +(y)h(default.)630 3387 y Fs(-C)384 b Ft(Prev)m(en)m(t)25 b(output)e(redirection)h(using)f(`)p Fs(>)p Ft(',)i(`)p Fs(>&)p Ft(',)g(and)e(`)p Fs(<>)p Ft(')g(from)h(o)m(v)m(erwriting)1110 -2730 y(existing)31 b(\014les.)630 2879 y Fs(-E)384 b +3497 y(existing)31 b(\014les.)630 3656 y Fs(-E)384 b Ft(If)39 b(set,)j(an)m(y)e(trap)f(on)g Fs(ERR)g Ft(is)g(inherited)g(b)m -(y)g(shell)h(functions,)h(command)1110 2989 y(substitutions,)35 +(y)g(shell)h(functions,)h(command)1110 3766 y(substitutions,)35 b(and)e(commands)g(executed)i(in)f(a)g(subshell)f(en)m(vironmen)m(t.) -1110 3098 y(The)d Fs(ERR)f Ft(trap)i(is)f(normally)h(not)f(inherited)g -(in)g(suc)m(h)g(cases.)630 3248 y Fs(-H)384 b Ft(Enable)38 +1110 3875 y(The)d Fs(ERR)f Ft(trap)i(is)f(normally)h(not)f(inherited)g +(in)g(suc)m(h)g(cases.)630 4035 y Fs(-H)384 b Ft(Enable)38 b(`)p Fs(!)p Ft(')h(st)m(yle)h(history)e(substitution)g(\(see)h -(Section)h(9.3)f([History)g(In-)1110 3357 y(teraction],)g(page)d +(Section)h(9.3)f([History)g(In-)1110 4144 y(teraction],)g(page)d (135\).)57 b(This)34 b(option)i(is)f(on)g(b)m(y)h(default)f(for)g(in)m -(teractiv)m(e)1110 3467 y(shells.)630 3616 y Fs(-P)384 +(teractiv)m(e)1110 4254 y(shells.)630 4413 y Fs(-P)384 b Ft(If)39 b(set,)j(do)d(not)g(resolv)m(e)i(sym)m(b)s(olic)e(links)g -(when)f(p)s(erforming)g(commands)1110 3726 y(suc)m(h)29 +(when)f(p)s(erforming)g(commands)1110 4523 y(suc)m(h)29 b(as)h Fs(cd)f Ft(whic)m(h)g(c)m(hange)h(the)g(curren)m(t)f(directory) --8 b(.)42 b(The)28 b(ph)m(ysical)j(direc-)1110 3836 y(tory)j(is)g(used) +-8 b(.)42 b(The)28 b(ph)m(ysical)j(direc-)1110 4633 y(tory)j(is)g(used) f(instead.)52 b(By)34 b(default,)h(Bash)f(follo)m(ws)h(the)f(logical)i -(c)m(hain)f(of)1110 3945 y(directories)j(when)d(p)s(erforming)h +(c)m(hain)f(of)1110 4742 y(directories)j(when)d(p)s(erforming)h (commands)g(whic)m(h)g(c)m(hange)i(the)f(curren)m(t)1110 -4055 y(directory)-8 b(.)1110 4184 y(F)g(or)31 b(example,)g(if)f(`)p +4852 y(directory)-8 b(.)1110 4986 y(F)g(or)31 b(example,)g(if)f(`)p Fs(/usr/sys)p Ft(')e(is)i(a)g(sym)m(b)s(olic)h(link)f(to)g(`)p -Fs(/usr/local/sys)p Ft(')1110 4294 y(then:)1350 4423 -y Fs($)47 b(cd)h(/usr/sys;)d(echo)i($PWD)1350 4533 y(/usr/sys)1350 -4643 y($)g(cd)h(..;)f(pwd)1350 4752 y(/usr)1110 4882 -y Ft(If)30 b Fs(set)f(-P)h Ft(is)h(on,)f(then:)1350 5011 -y Fs($)47 b(cd)h(/usr/sys;)d(echo)i($PWD)1350 5121 y(/usr/local/sys) -1350 5230 y($)g(cd)h(..;)f(pwd)1350 5340 y(/usr/local)p +Fs(/usr/local/sys)p Ft(')1110 5096 y(then:)1350 5230 +y Fs($)47 b(cd)h(/usr/sys;)d(echo)i($PWD)1350 5340 y(/usr/sys)p eop end %%Page: 62 68 TeXDict begin 62 67 bop 150 -116 a Ft(62)2572 b(Bash)31 -b(Reference)g(Man)m(ual)630 299 y Fs(-T)384 b Ft(If)34 -b(set,)j(an)m(y)e(trap)g(on)g Fs(DEBUG)e Ft(and)i Fs(RETURN)e -Ft(are)i(inherited)g(b)m(y)f(shell)i(func-)1110 408 y(tions,)k(command) -d(substitutions,)h(and)f(commands)g(executed)h(in)f(a)h(sub-)1110 -518 y(shell)33 b(en)m(vironmen)m(t.)49 b(The)32 b Fs(DEBUG)g -Ft(and)g Fs(RETURN)f Ft(traps)h(are)i(normally)f(not)1110 -628 y(inherited)d(in)g(suc)m(h)g(cases.)630 780 y Fs(--)384 -b Ft(If)31 b(no)h(argumen)m(ts)f(follo)m(w)i(this)f(option,)g(then)f -(the)h(p)s(ositional)h(parameters)1110 890 y(are)h(unset.)49 -b(Otherwise,)34 b(the)g(p)s(ositional)g(parameters)g(are)g(set)g(to)g -(the)g Fq(ar-)1110 999 y(gumen)m(ts)t Ft(,)d(ev)m(en)g(if)f(some)h(of)f -(them)h(b)s(egin)f(with)g(a)g(`)p Fs(-)p Ft('.)630 1152 -y Fs(-)432 b Ft(Signal)45 b(the)g(end)f(of)h(options,)k(cause)c(all)h -(remaining)e Fq(argumen)m(ts)49 b Ft(to)d(b)s(e)1110 -1262 y(assigned)38 b(to)h(the)f(p)s(ositional)h(parameters.)65 -b(The)37 b(`)p Fs(-x)p Ft(')h(and)g(`)p Fs(-v)p Ft(')g(options)1110 -1371 y(are)25 b(turned)e(o\013.)40 b(If)24 b(there)h(are)g(no)f +b(Reference)g(Man)m(ual)1350 299 y Fs($)47 b(cd)h(..;)f(pwd)1350 +408 y(/usr)1110 540 y Ft(If)30 b Fs(set)f(-P)h Ft(is)h(on,)f(then:)1350 +672 y Fs($)47 b(cd)h(/usr/sys;)d(echo)i($PWD)1350 782 +y(/usr/local/sys)1350 891 y($)g(cd)h(..;)f(pwd)1350 1001 +y(/usr/local)630 1155 y(-T)384 b Ft(If)34 b(set,)j(an)m(y)e(trap)g(on)g +Fs(DEBUG)e Ft(and)i Fs(RETURN)e Ft(are)i(inherited)g(b)m(y)f(shell)i +(func-)1110 1265 y(tions,)k(command)d(substitutions,)h(and)f(commands)g +(executed)h(in)f(a)h(sub-)1110 1374 y(shell)33 b(en)m(vironmen)m(t.)49 +b(The)32 b Fs(DEBUG)g Ft(and)g Fs(RETURN)f Ft(traps)h(are)i(normally)f +(not)1110 1484 y(inherited)d(in)g(suc)m(h)g(cases.)630 +1638 y Fs(--)384 b Ft(If)31 b(no)h(argumen)m(ts)f(follo)m(w)i(this)f +(option,)g(then)f(the)h(p)s(ositional)h(parameters)1110 +1748 y(are)h(unset.)49 b(Otherwise,)34 b(the)g(p)s(ositional)g +(parameters)g(are)g(set)g(to)g(the)g Fq(ar-)1110 1857 +y(gumen)m(ts)t Ft(,)d(ev)m(en)g(if)f(some)h(of)f(them)h(b)s(egin)f +(with)g(a)g(`)p Fs(-)p Ft('.)630 2012 y Fs(-)432 b Ft(Signal)45 +b(the)g(end)f(of)h(options,)k(cause)c(all)h(remaining)e +Fq(argumen)m(ts)49 b Ft(to)d(b)s(e)1110 2121 y(assigned)38 +b(to)h(the)f(p)s(ositional)h(parameters.)65 b(The)37 +b(`)p Fs(-x)p Ft(')h(and)g(`)p Fs(-v)p Ft(')g(options)1110 +2231 y(are)25 b(turned)e(o\013.)40 b(If)24 b(there)h(are)g(no)f (argumen)m(ts,)i(the)f(p)s(ositional)h(parameters)1110 -1481 y(remain)k(unc)m(hanged.)630 1633 y(Using)d(`)p +2340 y(remain)k(unc)m(hanged.)630 2495 y(Using)d(`)p Fs(+)p Ft(')h(rather)f(than)g(`)p Fs(-)p Ft(')g(causes)h(these)f (options)h(to)g(b)s(e)e(turned)g(o\013.)40 b(The)27 b(options)h(can)630 -1743 y(also)36 b(b)s(e)f(used)f(up)s(on)g(in)m(v)m(o)s(cation)j(of)e +2604 y(also)36 b(b)s(e)f(used)f(up)s(on)g(in)m(v)m(o)s(cation)j(of)e (the)g(shell.)56 b(The)34 b(curren)m(t)h(set)h(of)f(options)h(ma)m(y)g -(b)s(e)630 1852 y(found)29 b(in)h Fs($-)p Ft(.)630 1984 +(b)s(e)630 2714 y(found)29 b(in)h Fs($-)p Ft(.)630 2846 y(The)43 b(remaining)h(N)f Fq(argumen)m(ts)48 b Ft(are)c(p)s(ositional) -g(parameters)g(and)f(are)h(assigned,)j(in)630 2093 y(order,)30 +g(parameters)g(and)f(are)h(assigned,)j(in)630 2955 y(order,)30 b(to)h Fs($1)p Ft(,)f Fs($2)p Ft(,)36 b(.)22 b(.)g(.)42 b Fs($N)p Ft(.)e(The)30 b(sp)s(ecial)h(parameter)g Fs(#)f -Ft(is)g(set)h(to)g(N.)630 2224 y(The)f(return)f(status)i(is)f(alw)m(a)m +Ft(is)g(set)h(to)g(N.)630 3087 y(The)f(return)f(status)i(is)f(alw)m(a)m (ys)i(zero)f(unless)f(an)g(in)m(v)-5 b(alid)31 b(option)g(is)f -(supplied.)150 2417 y Fj(4.3.2)63 b(The)41 b(Shopt)h(Builtin)150 -2564 y Ft(This)30 b(builtin)g(allo)m(ws)h(y)m(ou)g(to)g(c)m(hange)h +(supplied.)150 3281 y Fj(4.3.2)63 b(The)41 b(Shopt)h(Builtin)150 +3428 y Ft(This)30 b(builtin)g(allo)m(ws)h(y)m(ou)g(to)g(c)m(hange)h (additional)f(shell)f(optional)i(b)s(eha)m(vior.)150 -2716 y Fs(shopt)870 2847 y(shopt)46 b([-pqsu])g([-o])h([)p -Fi(optname)56 b Fs(...)o(])630 2978 y Ft(T)-8 b(oggle)47 +3583 y Fs(shopt)870 3714 y(shopt)46 b([-pqsu])g([-o])h([)p +Fi(optname)56 b Fs(...)o(])630 3846 y Ft(T)-8 b(oggle)47 b(the)d(v)-5 b(alues)45 b(of)g(v)-5 b(ariables)45 b(con)m(trolling)i (optional)f(shell)e(b)s(eha)m(vior.)84 b(With)45 b(no)630 -3088 y(options,)32 b(or)f(with)g(the)g(`)p Fs(-p)p Ft(')g(option,)h(a)g +3956 y(options,)32 b(or)f(with)g(the)g(`)p Fs(-p)p Ft(')g(option,)h(a)g (list)f(of)h(all)g(settable)g(options)g(is)f(displa)m(y)m(ed,)h(with) -630 3198 y(an)i(indication)i(of)f(whether)f(or)g(not)h(eac)m(h)h(is)e +630 4066 y(an)i(indication)i(of)f(whether)f(or)g(not)h(eac)m(h)h(is)e (set.)54 b(The)34 b(`)p Fs(-p)p Ft(')h(option)g(causes)g(output)f(to) -630 3307 y(b)s(e)i(displa)m(y)m(ed)h(in)e(a)i(form)f(that)h(ma)m(y)g(b) +630 4175 y(b)s(e)i(displa)m(y)m(ed)h(in)e(a)i(form)f(that)h(ma)m(y)g(b) s(e)e(reused)h(as)g(input.)58 b(Other)36 b(options)g(ha)m(v)m(e)i(the) -630 3417 y(follo)m(wing)32 b(meanings:)630 3569 y Fs(-s)384 +630 4285 y(follo)m(wing)32 b(meanings:)630 4439 y Fs(-s)384 b Ft(Enable)30 b(\(set\))i(eac)m(h)f Fq(optname)5 b Ft(.)630 -3722 y Fs(-u)384 b Ft(Disable)31 b(\(unset\))g(eac)m(h)h -Fq(optname)5 b Ft(.)630 3874 y Fs(-q)384 b Ft(Suppresses)28 +4593 y Fs(-u)384 b Ft(Disable)31 b(\(unset\))g(eac)m(h)h +Fq(optname)5 b Ft(.)630 4747 y Fs(-q)384 b Ft(Suppresses)28 b(normal)h(output;)h(the)g(return)e(status)i(indicates)h(whether)e(the) -1110 3984 y Fq(optname)37 b Ft(is)31 b(set)h(or)f(unset.)43 +1110 4857 y Fq(optname)37 b Ft(is)31 b(set)h(or)f(unset.)43 b(If)31 b(m)m(ultiple)h Fq(optname)37 b Ft(argumen)m(ts)31 -b(are)h(giv)m(en)1110 4094 y(with)43 b(`)p Fs(-q)p Ft(',)j(the)d +b(are)h(giv)m(en)1110 4967 y(with)43 b(`)p Fs(-q)p Ft(',)j(the)d (return)f(status)h(is)g(zero)h(if)f(all)g Fq(optnames)k -Ft(are)d(enabled;)1110 4203 y(non-zero)31 b(otherwise.)630 -4356 y Fs(-o)384 b Ft(Restricts)28 b(the)g(v)-5 b(alues)28 +Ft(are)d(enabled;)1110 5076 y(non-zero)31 b(otherwise.)630 +5230 y Fs(-o)384 b Ft(Restricts)28 b(the)g(v)-5 b(alues)28 b(of)f Fq(optname)33 b Ft(to)c(b)s(e)d(those)i(de\014ned)f(for)g(the)g -(`)p Fs(-o)p Ft(')h(op-)1110 4465 y(tion)23 b(to)h(the)f +(`)p Fs(-o)p Ft(')h(op-)1110 5340 y(tion)23 b(to)h(the)f Fs(set)f Ft(builtin)h(\(see)g(Section)h(4.3.1)h([The)d(Set)i(Builtin],) -h(page)e(58\).)630 4618 y(If)40 b(either)g(`)p Fs(-s)p -Ft(')g(or)g(`)p Fs(-u)p Ft(')g(is)g(used)g(with)g(no)g -Fq(optname)45 b Ft(argumen)m(ts,)e Fs(shopt)c Ft(sho)m(ws)h(only)630 -4728 y(those)31 b(options)g(whic)m(h)f(are)g(set)h(or)g(unset,)f(resp)s -(ectiv)m(ely)-8 b(.)630 4859 y(Unless)30 b(otherwise)h(noted,)g(the)g -Fs(shopt)d Ft(options)j(are)g(disabled)f(\(o\013)7 b(\))32 -b(b)m(y)e(default.)630 4990 y(The)d(return)f(status)i(when)f(listing)h -(options)g(is)f(zero)i(if)e(all)i Fq(optnames)i Ft(are)d(enabled,)g -(non-)630 5099 y(zero)40 b(otherwise.)66 b(When)39 b(setting)h(or)f -(unsetting)g(options,)i(the)e(return)f(status)h(is)g(zero)630 -5209 y(unless)30 b(an)g Fq(optname)36 b Ft(is)30 b(not)h(a)g(v)-5 -b(alid)30 b(shell)h(option.)630 5340 y(The)f(list)h(of)f -Fs(shopt)f Ft(options)i(is:)p eop end +h(page)e(58\).)p eop end %%Page: 63 69 TeXDict begin 63 68 bop 150 -116 a Ft(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(63)630 299 y Fs(autocd)192 -b Ft(If)27 b(set,)h(a)g(command)f(name)g(that)h(is)f(the)g(name)g(of)h -(a)f(directory)h(is)f(executed)1110 408 y(as)j(if)f(it)h(w)m(ere)f(the) -h(argumen)m(t)g(to)g(the)f Fs(cd)g Ft(command.)40 b(This)29 -b(option)g(is)h(only)1110 518 y(used)g(b)m(y)g(in)m(teractiv)m(e)j -(shells.)630 676 y Fs(cdable_vars)1110 786 y Ft(If)h(this)h(is)g(set,)i -(an)e(argumen)m(t)g(to)h(the)f Fs(cd)f Ft(builtin)h(command)f(that)i -(is)f(not)1110 896 y(a)c(directory)g(is)g(assumed)f(to)h(b)s(e)f(the)h +b(Shell)30 b(Builtin)h(Commands)2069 b(63)630 299 y(If)40 +b(either)g(`)p Fs(-s)p Ft(')g(or)g(`)p Fs(-u)p Ft(')g(is)g(used)g(with) +g(no)g Fq(optname)45 b Ft(argumen)m(ts,)e Fs(shopt)c +Ft(sho)m(ws)h(only)630 408 y(those)31 b(options)g(whic)m(h)f(are)g(set) +h(or)g(unset,)f(resp)s(ectiv)m(ely)-8 b(.)630 553 y(Unless)30 +b(otherwise)h(noted,)g(the)g Fs(shopt)d Ft(options)j(are)g(disabled)f +(\(o\013)7 b(\))32 b(b)m(y)e(default.)630 697 y(The)d(return)f(status)i +(when)f(listing)h(options)g(is)f(zero)i(if)e(all)i Fq(optnames)i +Ft(are)d(enabled,)g(non-)630 806 y(zero)40 b(otherwise.)66 +b(When)39 b(setting)h(or)f(unsetting)g(options,)i(the)e(return)f +(status)h(is)g(zero)630 916 y(unless)30 b(an)g Fq(optname)36 +b Ft(is)30 b(not)h(a)g(v)-5 b(alid)30 b(shell)h(option.)630 +1060 y(The)f(list)h(of)f Fs(shopt)f Ft(options)i(is:)630 +1239 y Fs(autocd)192 b Ft(If)27 b(set,)h(a)g(command)f(name)g(that)h +(is)f(the)g(name)g(of)h(a)f(directory)h(is)f(executed)1110 +1349 y(as)j(if)f(it)h(w)m(ere)f(the)h(argumen)m(t)g(to)g(the)f +Fs(cd)g Ft(command.)40 b(This)29 b(option)g(is)h(only)1110 +1458 y(used)g(b)m(y)g(in)m(teractiv)m(e)j(shells.)630 +1637 y Fs(cdable_vars)1110 1747 y Ft(If)h(this)h(is)g(set,)i(an)e +(argumen)m(t)g(to)h(the)f Fs(cd)f Ft(builtin)h(command)f(that)i(is)f +(not)1110 1856 y(a)c(directory)g(is)g(assumed)f(to)h(b)s(e)f(the)h (name)f(of)h(a)g(v)-5 b(ariable)31 b(whose)g(v)-5 b(alue)31 -b(is)1110 1005 y(the)g(directory)f(to)i(c)m(hange)f(to.)630 -1163 y Fs(cdspell)144 b Ft(If)27 b(set,)h(minor)f(errors)f(in)h(the)g +b(is)1110 1966 y(the)g(directory)f(to)i(c)m(hange)f(to.)630 +2145 y Fs(cdspell)144 b Ft(If)27 b(set,)h(minor)f(errors)f(in)h(the)g (sp)s(elling)h(of)f(a)g(directory)h(comp)s(onen)m(t)f(in)g(a)h -Fs(cd)1110 1273 y Ft(command)i(will)h(b)s(e)f(corrected.)43 +Fs(cd)1110 2254 y Ft(command)i(will)h(b)s(e)f(corrected.)43 b(The)30 b(errors)g(c)m(hec)m(k)m(ed)j(for)d(are)h(transp)s(osed)1110 -1383 y(c)m(haracters,)46 b(a)c(missing)f(c)m(haracter,)47 +2364 y(c)m(haracters,)46 b(a)c(missing)f(c)m(haracter,)47 b(and)40 b(a)i(c)m(haracter)h(to)s(o)g(man)m(y)-8 b(.)74 -b(If)42 b(a)1110 1492 y(correction)25 b(is)e(found,)g(the)h(corrected)g -(path)f(is)g(prin)m(ted,)h(and)f(the)g(command)1110 1602 +b(If)42 b(a)1110 2473 y(correction)25 b(is)e(found,)g(the)h(corrected)g +(path)f(is)g(prin)m(ted,)h(and)f(the)g(command)1110 2583 y(pro)s(ceeds.)40 b(This)30 b(option)h(is)f(only)h(used)e(b)m(y)h(in)m -(teractiv)m(e)k(shells.)630 1760 y Fs(checkhash)1110 -1870 y Ft(If)29 b(this)h(is)g(set,)g(Bash)g(c)m(hec)m(ks)h(that)g(a)f -(command)f(found)g(in)g(the)h(hash)f(table)1110 1979 +(teractiv)m(e)k(shells.)630 2762 y Fs(checkhash)1110 +2871 y Ft(If)29 b(this)h(is)g(set,)g(Bash)g(c)m(hec)m(ks)h(that)g(a)f +(command)f(found)g(in)g(the)h(hash)f(table)1110 2981 y(exists)k(b)s(efore)f(trying)h(to)h(execute)g(it.)48 -b(If)32 b(a)h(hashed)e(command)i(no)f(longer)1110 2089 +b(If)32 b(a)h(hashed)e(command)i(no)f(longer)1110 3091 y(exists,)f(a)g(normal)f(path)g(searc)m(h)h(is)g(p)s(erformed.)630 -2247 y Fs(checkjobs)1110 2357 y Ft(If)d(set,)i(Bash)e(lists)h(the)g +3269 y Fs(checkjobs)1110 3379 y Ft(If)d(set,)i(Bash)e(lists)h(the)g (status)g(of)f(an)m(y)h(stopp)s(ed)f(and)g(running)e(jobs)i(b)s(efore) -1110 2466 y(exiting)42 b(an)f(in)m(teractiv)m(e)j(shell.)72 +1110 3488 y(exiting)42 b(an)f(in)m(teractiv)m(e)j(shell.)72 b(If)41 b(an)m(y)g(jobs)f(are)i(running,)g(this)f(causes)1110 -2576 y(the)30 b(exit)g(to)g(b)s(e)f(deferred)g(un)m(til)h(a)f(second)h -(exit)g(is)g(attempted)h(without)e(an)1110 2685 y(in)m(terv)m(ening)j +3598 y(the)30 b(exit)g(to)g(b)s(e)f(deferred)g(un)m(til)h(a)f(second)h +(exit)g(is)g(attempted)h(without)e(an)1110 3708 y(in)m(terv)m(ening)j (command)e(\(see)h(Chapter)f(7)h([Job)f(Con)m(trol],)i(page)f(97\).)42 -b(The)1110 2795 y(shell)31 b(alw)m(a)m(ys)g(p)s(ostp)s(ones)f(exiting)h -(if)g(an)m(y)f(jobs)g(are)h(stopp)s(ed.)630 2953 y Fs(checkwinsize)1110 -3063 y Ft(If)41 b(set,)k(Bash)c(c)m(hec)m(ks)i(the)f(windo)m(w)e(size)j -(after)f(eac)m(h)g(command)f(and,)j(if)1110 3173 y(necessary)-8 +b(The)1110 3817 y(shell)31 b(alw)m(a)m(ys)g(p)s(ostp)s(ones)f(exiting)h +(if)g(an)m(y)f(jobs)g(are)h(stopp)s(ed.)630 3996 y Fs(checkwinsize)1110 +4106 y Ft(If)41 b(set,)k(Bash)c(c)m(hec)m(ks)i(the)f(windo)m(w)e(size)j +(after)f(eac)m(h)g(command)f(and,)j(if)1110 4215 y(necessary)-8 b(,)31 b(up)s(dates)f(the)g(v)-5 b(alues)31 b(of)g Fs(LINES)e -Ft(and)g Fs(COLUMNS)p Ft(.)630 3331 y Fs(cmdhist)144 +Ft(and)g Fs(COLUMNS)p Ft(.)630 4394 y Fs(cmdhist)144 b Ft(If)33 b(set,)j(Bash)e(attempts)h(to)g(sa)m(v)m(e)g(all)g(lines)f -(of)g(a)h(m)m(ultiple-line)g(command)1110 3440 y(in)c(the)g(same)g +(of)g(a)h(m)m(ultiple-line)g(command)1110 4504 y(in)c(the)g(same)g (history)g(en)m(try)-8 b(.)42 b(This)30 b(allo)m(ws)i(easy)g -(re-editing)g(of)f(m)m(ulti-line)1110 3550 y(commands.)630 -3708 y Fs(compat31)96 b Ft(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s +(re-editing)g(of)f(m)m(ulti-line)1110 4613 y(commands.)630 +4792 y Fs(compat31)96 b Ft(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s (eha)m(vior)f(to)i(that)f(of)f(v)m(ersion)h(3.1)h(with)e(resp)s(ect) -1110 3818 y(to)39 b(quoted)f(argumen)m(ts)g(to)h(the)f(conditional)h -(command's)f(`)p Fs(=~)p Ft(')g(op)s(erator)1110 3927 +1110 4902 y(to)39 b(quoted)f(argumen)m(ts)g(to)h(the)f(conditional)h +(command's)f(`)p Fs(=~)p Ft(')g(op)s(erator)1110 5011 y(and)i(with)f(resp)s(ect)i(to)g(lo)s(cale-sp)s(eci\014c)h(string)e -(comparison)g(when)f(using)1110 4037 y(the)25 b(`)p Fs([[)p +(comparison)g(when)f(using)1110 5121 y(the)25 b(`)p Fs([[)p Ft(')f(conditional)h(command's)g(`)p Fs(<)p Ft(')f(and)g(`)p Fs(>)p Ft(')g(op)s(erators.)39 b(Bash)25 b(v)m(ersions)1110 -4147 y(prior)31 b(to)h(bash-4.1)g(use)g(ASCI)s(I)e(collation)j(and)e -(strcmp\(3\);)i(bash-4.1)g(and)1110 4256 y(later)e(use)f(the)h(curren)m -(t)f(lo)s(cale's)i(collation)h(sequence)e(and)f(strcoll\(3\).)630 -4415 y Fs(compat32)96 b Ft(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s -(eha)m(vior)f(to)i(that)f(of)f(v)m(ersion)h(3.2)h(with)e(resp)s(ect) -1110 4524 y(to)h(lo)s(cale-sp)s(eci\014c)g(string)f(comparison)g(when)f -(using)g(the)h(`)p Fs([[)p Ft(')g(conditional)1110 4634 -y(command's)j(`)p Fs(<)p Ft(')h(and)f(`)p Fs(>)p Ft(')g(op)s(erators)h -(\(see)g(previous)f(item\).)630 4792 y Fs(compat40)96 -b Ft(If)27 b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s(eha)m(vior)f(to)i -(that)f(of)f(v)m(ersion)h(4.0)h(with)e(resp)s(ect)1110 -4902 y(to)h(lo)s(cale-sp)s(eci\014c)g(string)f(comparison)g(when)f -(using)g(the)h(`)p Fs([[)p Ft(')g(conditional)1110 5011 -y(command's)h(`)p Fs(<)p Ft(')h(and)f(`)p Fs(>)p Ft(')h(op)s(erators)f -(\(see)i(description)e(of)h Fs(compat31)p Ft(\))e(and)1110 -5121 y(the)38 b(e\013ect)i(of)e(in)m(terrupting)f(a)i(command)e(list.) -64 b(Bash)38 b(v)m(ersions)h(4.0)g(and)1110 5230 y(later)24 -b(in)m(terrupt)f(the)g(list)h(as)g(if)f(the)h(shell)f(receiv)m(ed)i -(the)e(in)m(terrupt;)i(previous)1110 5340 y(v)m(ersions)31 -b(con)m(tin)m(ue)g(with)f(the)h(next)g(command)f(in)g(the)g(list.)p +5230 y(prior)31 b(to)h(bash-4.1)g(use)g(ASCI)s(I)e(collation)j(and)e +(strcmp\(3\);)i(bash-4.1)g(and)1110 5340 y(later)e(use)f(the)h(curren)m +(t)f(lo)s(cale's)i(collation)h(sequence)e(and)f(strcoll\(3\).)p eop end %%Page: 64 70 TeXDict begin 64 69 bop 150 -116 a Ft(64)2572 b(Bash)31 -b(Reference)g(Man)m(ual)630 299 y Fs(compat41)96 b Ft(If)27 -b(set,)i(Bash,)g(when)e(in)g(p)s(osix)g(mo)s(de,)h(treats)h(a)f(single) -g(quote)h(in)e(a)h(double-)1110 408 y(quoted)46 b(parameter)h -(expansion)f(as)g(a)h(sp)s(ecial)f(c)m(haracter.)90 b(The)45 -b(single)1110 518 y(quotes)34 b(m)m(ust)g(matc)m(h)h(\(an)f(ev)m(en)h -(n)m(um)m(b)s(er\))e(and)g(the)h(c)m(haracters)h(b)s(et)m(w)m(een)1110 -628 y(the)40 b(single)g(quotes)g(are)g(considered)g(quoted.)69 -b(This)38 b(is)i(the)g(b)s(eha)m(vior)g(of)1110 737 y -Fl(posix)f Ft(mo)s(de)g(through)g(v)m(ersion)h(4.1.)69 +b(Reference)g(Man)m(ual)630 299 y Fs(compat32)96 b Ft(If)27 +b(set,)i(Bash)e(c)m(hanges)i(its)f(b)s(eha)m(vior)f(to)i(that)f(of)f(v) +m(ersion)h(3.2)h(with)e(resp)s(ect)1110 408 y(to)h(lo)s(cale-sp)s +(eci\014c)g(string)f(comparison)g(when)f(using)g(the)h(`)p +Fs([[)p Ft(')g(conditional)1110 518 y(command's)j(`)p +Fs(<)p Ft(')h(and)f(`)p Fs(>)p Ft(')g(op)s(erators)h(\(see)g(previous)f +(item\).)630 669 y Fs(compat40)96 b Ft(If)27 b(set,)i(Bash)e(c)m +(hanges)i(its)f(b)s(eha)m(vior)f(to)i(that)f(of)f(v)m(ersion)h(4.0)h +(with)e(resp)s(ect)1110 778 y(to)h(lo)s(cale-sp)s(eci\014c)g(string)f +(comparison)g(when)f(using)g(the)h(`)p Fs([[)p Ft(')g(conditional)1110 +888 y(command's)h(`)p Fs(<)p Ft(')h(and)f(`)p Fs(>)p +Ft(')h(op)s(erators)f(\(see)i(description)e(of)h Fs(compat31)p +Ft(\))e(and)1110 998 y(the)38 b(e\013ect)i(of)e(in)m(terrupting)f(a)i +(command)e(list.)64 b(Bash)38 b(v)m(ersions)h(4.0)g(and)1110 +1107 y(later)24 b(in)m(terrupt)f(the)g(list)h(as)g(if)f(the)h(shell)f +(receiv)m(ed)i(the)e(in)m(terrupt;)i(previous)1110 1217 +y(v)m(ersions)31 b(con)m(tin)m(ue)g(with)f(the)h(next)g(command)f(in)g +(the)g(list.)630 1367 y Fs(compat41)96 b Ft(If)27 b(set,)i(Bash,)g +(when)e(in)g(p)s(osix)g(mo)s(de,)h(treats)h(a)f(single)g(quote)h(in)e +(a)h(double-)1110 1477 y(quoted)46 b(parameter)h(expansion)f(as)g(a)h +(sp)s(ecial)f(c)m(haracter.)90 b(The)45 b(single)1110 +1587 y(quotes)34 b(m)m(ust)g(matc)m(h)h(\(an)f(ev)m(en)h(n)m(um)m(b)s +(er\))e(and)g(the)h(c)m(haracters)h(b)s(et)m(w)m(een)1110 +1696 y(the)40 b(single)g(quotes)g(are)g(considered)g(quoted.)69 +b(This)38 b(is)i(the)g(b)s(eha)m(vior)g(of)1110 1806 +y Fl(posix)f Ft(mo)s(de)g(through)g(v)m(ersion)h(4.1.)69 b(The)39 b(default)g(Bash)h(b)s(eha)m(vior)g(re-)1110 -847 y(mains)30 b(as)h(in)f(previous)g(v)m(ersions.)630 -995 y Fs(complete_fullquote)1110 1105 y Ft(If)h(set,)g(Bash)h(quotes)f +1915 y(mains)30 b(as)h(in)f(previous)g(v)m(ersions.)630 +2066 y Fs(complete_fullquote)1110 2176 y Ft(If)h(set,)g(Bash)h(quotes)f (all)h(shell)f(metac)m(haracters)i(in)e(\014lenames)g(and)g(direc-)1110 -1214 y(tory)g(names)f(when)g(p)s(erforming)f(completion.)43 -b(If)30 b(not)h(set,)g(Bash)g(remo)m(v)m(es)1110 1324 +2285 y(tory)g(names)f(when)g(p)s(erforming)f(completion.)43 +b(If)30 b(not)h(set,)g(Bash)g(remo)m(v)m(es)1110 2395 y(metac)m(haracters)40 b(suc)m(h)d(as)h(the)g(dollar)g(sign)g(from)f -(the)h(set)g(of)f(c)m(haracters)1110 1433 y(that)f(will)g(b)s(e)f +(the)h(set)g(of)f(c)m(haracters)1110 2504 y(that)f(will)g(b)s(e)f (quoted)g(in)g(completed)i(\014lenames)e(when)f(these)i(metac)m(har-) -1110 1543 y(acters)29 b(app)s(ear)e(in)g(shell)h(v)-5 +1110 2614 y(acters)29 b(app)s(ear)e(in)g(shell)h(v)-5 b(ariable)28 b(references)g(in)f(w)m(ords)g(to)i(b)s(e)e(completed.) -1110 1653 y(This)k(means)i(that)g(dollar)f(signs)g(in)g(v)-5 +1110 2724 y(This)k(means)i(that)g(dollar)f(signs)g(in)g(v)-5 b(ariable)33 b(names)g(that)f(expand)g(to)h(di-)1110 -1762 y(rectories)28 b(will)g(not)f(b)s(e)f(quoted;)j(ho)m(w)m(ev)m(er,) -g(an)m(y)e(dollar)h(signs)f(app)s(earing)f(in)1110 1872 +2833 y(rectories)28 b(will)g(not)f(b)s(e)f(quoted;)j(ho)m(w)m(ev)m(er,) +g(an)m(y)e(dollar)h(signs)f(app)s(earing)f(in)1110 2943 y(\014lenames)j(will)h(not)f(b)s(e)g(quoted,)h(either.)41 b(This)28 b(is)i(activ)m(e)h(only)e(when)g(bash)1110 -1981 y(is)39 b(using)f(bac)m(kslashes)i(to)g(quote)g(completed)f -(\014lenames.)67 b(This)38 b(v)-5 b(ariable)1110 2091 +3052 y(is)39 b(using)f(bac)m(kslashes)i(to)g(quote)g(completed)f +(\014lenames.)67 b(This)38 b(v)-5 b(ariable)1110 3162 y(is)41 b(set)g(b)m(y)g(default,)j(whic)m(h)c(is)h(the)g(default)g -(Bash)g(b)s(eha)m(vior)g(in)g(v)m(ersions)1110 2201 y(through)30 -b(4.2.)630 2349 y Fs(direxpand)1110 2458 y Ft(If)k(set,)i(Bash)f +(Bash)g(b)s(eha)m(vior)g(in)g(v)m(ersions)1110 3271 y(through)30 +b(4.2.)630 3422 y Fs(direxpand)1110 3532 y Ft(If)k(set,)i(Bash)f (replaces)g(directory)g(names)g(with)f(the)g(results)h(of)f(w)m(ord)g -(ex-)1110 2568 y(pansion)k(when)g(p)s(erforming)f(\014lename)i -(completion.)67 b(This)38 b(c)m(hanges)i(the)1110 2678 +(ex-)1110 3641 y(pansion)k(when)g(p)s(erforming)f(\014lename)i +(completion.)67 b(This)38 b(c)m(hanges)i(the)1110 3751 y(con)m(ten)m(ts)29 b(of)e(the)g(readline)h(editing)g(bu\013er.)38 -b(If)27 b(not)g(set,)i(Bash)e(attempts)h(to)1110 2787 +b(If)27 b(not)g(set,)i(Bash)e(attempts)h(to)1110 3861 y(preserv)m(e)j(what)f(the)g(user)g(t)m(yp)s(ed.)630 -2935 y Fs(dirspell)96 b Ft(If)26 b(set,)i(Bash)f(attempts)g(sp)s +4011 y Fs(dirspell)96 b Ft(If)26 b(set,)i(Bash)f(attempts)g(sp)s (elling)g(correction)g(on)g(directory)g(names)f(during)1110 -3045 y(w)m(ord)36 b(completion)h(if)f(the)g(directory)g(name)g -(initially)h(supplied)e(do)s(es)h(not)1110 3155 y(exist.)630 -3303 y Fs(dotglob)144 b Ft(If)27 b(set,)i(Bash)f(includes)g +4121 y(w)m(ord)36 b(completion)h(if)f(the)g(directory)g(name)g +(initially)h(supplied)e(do)s(es)h(not)1110 4230 y(exist.)630 +4381 y Fs(dotglob)144 b Ft(If)27 b(set,)i(Bash)f(includes)g (\014lenames)g(b)s(eginning)f(with)g(a)h(`.')41 b(in)27 -b(the)h(results)g(of)1110 3412 y(\014lename)j(expansion.)630 -3561 y Fs(execfail)96 b Ft(If)24 b(this)h(is)f(set,)j(a)e(non-in)m +b(the)h(results)g(of)1110 4491 y(\014lename)j(expansion.)630 +4641 y Fs(execfail)96 b Ft(If)24 b(this)h(is)f(set,)j(a)e(non-in)m (teractiv)m(e)i(shell)e(will)f(not)h(exit)h(if)e(it)h(cannot)h(execute) -1110 3670 y(the)i(\014le)g(sp)s(eci\014ed)g(as)g(an)g(argumen)m(t)g(to) +1110 4751 y(the)i(\014le)g(sp)s(eci\014ed)g(as)g(an)g(argumen)m(t)g(to) h(the)f Fs(exec)f Ft(builtin)h(command.)39 b(An)1110 -3780 y(in)m(teractiv)m(e)33 b(shell)e(do)s(es)f(not)g(exit)i(if)e -Fs(exec)f Ft(fails.)630 3928 y Fs(expand_aliases)1110 -4038 y Ft(If)j(set,)h(aliases)g(are)g(expanded)e(as)h(describ)s(ed)f(b) -s(elo)m(w)h(under)f(Aliases,)i(Sec-)1110 4147 y(tion)38 +4861 y(in)m(teractiv)m(e)33 b(shell)e(do)s(es)f(not)g(exit)i(if)e +Fs(exec)f Ft(fails.)630 5011 y Fs(expand_aliases)1110 +5121 y Ft(If)j(set,)h(aliases)g(are)g(expanded)e(as)h(describ)s(ed)f(b) +s(elo)m(w)h(under)f(Aliases,)i(Sec-)1110 5230 y(tion)38 b(6.6)h([Aliases],)j(page)d(87.)64 b(This)37 b(option)h(is)g(enabled)g -(b)m(y)g(default)g(for)1110 4257 y(in)m(teractiv)m(e)33 -b(shells.)630 4405 y Fs(extdebug)96 b Ft(If)30 b(set,)h(b)s(eha)m(vior) -g(in)m(tended)f(for)g(use)g(b)m(y)g(debuggers)g(is)h(enabled:)1159 -4534 y(1.)61 b(The)32 b(`)p Fs(-F)p Ft(')g(option)h(to)g(the)g -Fs(declare)d Ft(builtin)i(\(see)i(Section)f(4.2)h([Bash)1290 -4644 y(Builtins],)29 b(page)g(48\))g(displa)m(ys)f(the)g(source)h -(\014le)f(name)g(and)f(line)h(n)m(um-)1290 4753 y(b)s(er)h(corresp)s -(onding)g(to)i(eac)m(h)g(function)f(name)g(supplied)f(as)i(an)f(argu-) -1290 4863 y(men)m(t.)1159 4992 y(2.)61 b(If)20 b(the)h(command)g(run)e -(b)m(y)i(the)f Fs(DEBUG)g Ft(trap)g(returns)g(a)h(non-zero)g(v)-5 -b(alue,)1290 5101 y(the)31 b(next)f(command)g(is)h(skipp)s(ed)e(and)g -(not)i(executed.)1159 5230 y(3.)61 b(If)37 b(the)g(command)g(run)f(b)m -(y)i(the)f Fs(DEBUG)f Ft(trap)h(returns)f(a)i(v)-5 b(alue)38 -b(of)f(2,)1290 5340 y(and)c(the)g(shell)h(is)f(executing)i(in)e(a)h -(subroutine)e(\(a)i(shell)g(function)f(or)p eop end +(b)m(y)g(default)g(for)1110 5340 y(in)m(teractiv)m(e)33 +b(shells.)p eop end %%Page: 65 71 TeXDict begin 65 70 bop 150 -116 a Ft(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(65)1290 299 y(a)34 -b(shell)h(script)f(executed)h(b)m(y)f(the)g Fs(.)g Ft(or)g -Fs(source)e Ft(builtins\),)j(a)g(call)g(to)1290 408 y -Fs(return)29 b Ft(is)h(sim)m(ulated.)1159 553 y(4.)61 -b Fs(BASH_ARGC)34 b Ft(and)i Fs(BASH_ARGV)e Ft(are)j(up)s(dated)e(as)h -(describ)s(ed)g(in)g(their)1290 662 y(descriptions)30 -b(\(see)i(Section)f(5.2)g([Bash)g(V)-8 b(ariables],)32 -b(page)f(69\).)1159 806 y(5.)61 b(F)-8 b(unction)57 b(tracing)g(is)g -(enabled:)93 b(command)56 b(substitution,)63 b(shell)1290 -916 y(functions,)30 b(and)f(subshells)g(in)m(v)m(ok)m(ed)j(with)d -Fs(\()h Fi(command)39 b Fs(\))30 b Ft(inherit)g(the)1290 -1026 y Fs(DEBUG)f Ft(and)h Fs(RETURN)e Ft(traps.)1159 -1170 y(6.)61 b(Error)41 b(tracing)i(is)f(enabled:)63 -b(command)42 b(substitution,)i(shell)f(func-)1290 1279 -y(tions,)30 b(and)f(subshells)g(in)m(v)m(ok)m(ed)i(with)e -Fs(\()h Fi(command)39 b Fs(\))29 b Ft(inherit)g(the)h -Fs(ERR)1290 1389 y Ft(trap.)630 1568 y Fs(extglob)144 -b Ft(If)26 b(set,)i(the)f(extended)f(pattern)h(matc)m(hing)g(features)g -(describ)s(ed)e(ab)s(o)m(v)m(e)j(\(see)1110 1677 y(Section)j(3.5.8.1)i -([P)m(attern)f(Matc)m(hing],)g(page)f(29\))h(are)f(enabled.)630 -1856 y Fs(extquote)96 b Ft(If)49 b(set,)54 b Fs($')p +b(Shell)30 b(Builtin)h(Commands)2069 b(65)630 299 y Fs(extdebug)96 +b Ft(If)30 b(set,)h(b)s(eha)m(vior)g(in)m(tended)f(for)g(use)g(b)m(y)g +(debuggers)g(is)h(enabled:)1159 433 y(1.)61 b(The)32 +b(`)p Fs(-F)p Ft(')g(option)h(to)g(the)g Fs(declare)d +Ft(builtin)i(\(see)i(Section)f(4.2)h([Bash)1290 542 y(Builtins],)29 +b(page)g(48\))g(displa)m(ys)f(the)g(source)h(\014le)f(name)g(and)f +(line)h(n)m(um-)1290 652 y(b)s(er)h(corresp)s(onding)g(to)i(eac)m(h)g +(function)f(name)g(supplied)f(as)i(an)f(argu-)1290 762 +y(men)m(t.)1159 896 y(2.)61 b(If)20 b(the)h(command)g(run)e(b)m(y)i +(the)f Fs(DEBUG)g Ft(trap)g(returns)g(a)h(non-zero)g(v)-5 +b(alue,)1290 1005 y(the)31 b(next)f(command)g(is)h(skipp)s(ed)e(and)g +(not)i(executed.)1159 1139 y(3.)61 b(If)37 b(the)g(command)g(run)f(b)m +(y)i(the)f Fs(DEBUG)f Ft(trap)h(returns)f(a)i(v)-5 b(alue)38 +b(of)f(2,)1290 1249 y(and)c(the)g(shell)h(is)f(executing)i(in)e(a)h +(subroutine)e(\(a)i(shell)g(function)f(or)1290 1358 y(a)h(shell)h +(script)f(executed)h(b)m(y)f(the)g Fs(.)g Ft(or)g Fs(source)e +Ft(builtins\),)j(a)g(call)g(to)1290 1468 y Fs(return)29 +b Ft(is)h(sim)m(ulated.)1159 1602 y(4.)61 b Fs(BASH_ARGC)34 +b Ft(and)i Fs(BASH_ARGV)e Ft(are)j(up)s(dated)e(as)h(describ)s(ed)g(in) +g(their)1290 1711 y(descriptions)30 b(\(see)i(Section)f(5.2)g([Bash)g +(V)-8 b(ariables],)32 b(page)f(69\).)1159 1845 y(5.)61 +b(F)-8 b(unction)57 b(tracing)g(is)g(enabled:)93 b(command)56 +b(substitution,)63 b(shell)1290 1955 y(functions,)30 +b(and)f(subshells)g(in)m(v)m(ok)m(ed)j(with)d Fs(\()h +Fi(command)39 b Fs(\))30 b Ft(inherit)g(the)1290 2064 +y Fs(DEBUG)f Ft(and)h Fs(RETURN)e Ft(traps.)1159 2198 +y(6.)61 b(Error)41 b(tracing)i(is)f(enabled:)63 b(command)42 +b(substitution,)i(shell)f(func-)1290 2308 y(tions,)30 +b(and)f(subshells)g(in)m(v)m(ok)m(ed)i(with)e Fs(\()h +Fi(command)39 b Fs(\))29 b Ft(inherit)g(the)h Fs(ERR)1290 +2418 y Ft(trap.)630 2576 y Fs(extglob)144 b Ft(If)26 +b(set,)i(the)f(extended)f(pattern)h(matc)m(hing)g(features)g(describ)s +(ed)e(ab)s(o)m(v)m(e)j(\(see)1110 2685 y(Section)j(3.5.8.1)i([P)m +(attern)f(Matc)m(hing],)g(page)f(29\))h(are)f(enabled.)630 +2844 y Fs(extquote)96 b Ft(If)49 b(set,)54 b Fs($')p Fi(string)11 b Fs(')46 b Ft(and)j Fs($")p Fi(string)11 b Fs(")46 b Ft(quoting)k(is)f(p)s(erformed)e(within)1110 -1966 y Fs(${)p Fi(parameter)11 b Fs(})30 b Ft(expansions)j(enclosed)h -(in)g(double)f(quotes.)51 b(This)32 b(option)1110 2075 -y(is)e(enabled)h(b)m(y)f(default.)630 2254 y Fs(failglob)96 +2953 y Fs(${)p Fi(parameter)11 b Fs(})30 b Ft(expansions)j(enclosed)h +(in)g(double)f(quotes.)51 b(This)32 b(option)1110 3063 +y(is)e(enabled)h(b)m(y)f(default.)630 3221 y Fs(failglob)96 b Ft(If)36 b(set,)j(patterns)d(whic)m(h)g(fail)h(to)h(matc)m(h)f -(\014lenames)f(during)g(\014lename)g(ex-)1110 2364 y(pansion)30 -b(result)g(in)g(an)g(expansion)h(error.)630 2543 y Fs(force_fignore) -1110 2652 y Ft(If)43 b(set,)k(the)d(su\016xes)f(sp)s(eci\014ed)f(b)m(y) +(\014lenames)f(during)g(\014lename)g(ex-)1110 3331 y(pansion)30 +b(result)g(in)g(an)g(expansion)h(error.)630 3489 y Fs(force_fignore) +1110 3599 y Ft(If)43 b(set,)k(the)d(su\016xes)f(sp)s(eci\014ed)f(b)m(y) i(the)f Fs(FIGNORE)f Ft(shell)h(v)-5 b(ariable)44 b(cause)1110 -2762 y(w)m(ords)31 b(to)h(b)s(e)f(ignored)h(when)f(p)s(erforming)f(w)m -(ord)h(completion)i(ev)m(en)f(if)g(the)1110 2871 y(ignored)37 +3708 y(w)m(ords)31 b(to)h(b)s(e)f(ignored)h(when)f(p)s(erforming)f(w)m +(ord)h(completion)i(ev)m(en)f(if)g(the)1110 3818 y(ignored)37 b(w)m(ords)g(are)g(the)h(only)f(p)s(ossible)g(completions.)62 -b(See)37 b(Section)h(5.2)1110 2981 y([Bash)24 b(V)-8 +b(See)37 b(Section)h(5.2)1110 3927 y([Bash)24 b(V)-8 b(ariables],)27 b(page)e(69,)h(for)d(a)h(description)g(of)g -Fs(FIGNORE)p Ft(.)37 b(This)22 b(option)1110 3091 y(is)30 -b(enabled)h(b)m(y)f(default.)630 3269 y Fs(globasciiranges)1110 -3379 y Ft(If)87 b(set,)104 b(range)88 b(expressions)f(used)g(in)h -(pattern)g(matc)m(hing)h(\(see)1110 3488 y(Section)43 +Fs(FIGNORE)p Ft(.)37 b(This)22 b(option)1110 4037 y(is)30 +b(enabled)h(b)m(y)f(default.)630 4195 y Fs(globasciiranges)1110 +4305 y Ft(If)87 b(set,)104 b(range)88 b(expressions)f(used)g(in)h +(pattern)g(matc)m(hing)h(\(see)1110 4415 y(Section)43 b(3.5.8.1)i([P)m(attern)f(Matc)m(hing],)j(page)c(29\))h(b)s(eha)m(v)m -(e)f(as)f(if)h(in)f(the)1110 3598 y(traditional)h(C)e(lo)s(cale)i(when) +(e)f(as)f(if)h(in)f(the)1110 4524 y(traditional)h(C)e(lo)s(cale)i(when) e(p)s(erforming)f(comparisons.)75 b(That)41 b(is,)k(the)1110 -3708 y(curren)m(t)31 b(lo)s(cale's)i(collating)g(sequence)e(is)g(not)h +4634 y(curren)m(t)31 b(lo)s(cale's)i(collating)g(sequence)e(is)g(not)h (tak)m(en)g(in)m(to)g(accoun)m(t,)h(so)e(`)p Fs(b)p Ft(')1110 -3817 y(will)g(not)g(collate)i(b)s(et)m(w)m(een)e(`)p +4743 y(will)g(not)g(collate)i(b)s(et)m(w)m(een)e(`)p Fs(A)p Ft(')g(and)f(`)p Fs(B)p Ft(',)h(and)f(upp)s(er-case)g(and)g(lo)m -(w)m(er-case)1110 3927 y(ASCI)s(I)f(c)m(haracters)j(will)e(collate)j -(together.)630 4106 y Fs(globstar)96 b Ft(If)38 b(set,)j(the)e(pattern) +(w)m(er-case)1110 4853 y(ASCI)s(I)f(c)m(haracters)j(will)e(collate)j +(together.)630 5011 y Fs(globstar)96 b Ft(If)38 b(set,)j(the)e(pattern) f(`)p Fs(**)p Ft(')h(used)e(in)i(a)f(\014lename)h(expansion)f(con)m -(text)j(will)1110 4215 y(matc)m(h)36 b(all)g(\014les)f(and)f(zero)i(or) +(text)j(will)1110 5121 y(matc)m(h)36 b(all)g(\014les)f(and)f(zero)i(or) f(more)g(directories)h(and)e(sub)s(directories.)54 b(If)1110 -4325 y(the)30 b(pattern)g(is)g(follo)m(w)m(ed)i(b)m(y)d(a)i(`)p +5230 y(the)30 b(pattern)g(is)g(follo)m(w)m(ed)i(b)m(y)d(a)i(`)p Fs(/)p Ft(',)f(only)g(directories)h(and)f(sub)s(directories)1110 -4434 y(matc)m(h.)630 4613 y Fs(gnu_errfmt)1110 4723 y -Ft(If)35 b(set,)j(shell)e(error)g(messages)g(are)h(written)e(in)h(the)g -(standard)f Fl(gnu)g Ft(error)1110 4832 y(message)c(format.)630 -5011 y Fs(histappend)1110 5121 y Ft(If)c(set,)j(the)e(history)g(list)g -(is)g(app)s(ended)e(to)j(the)f(\014le)g(named)f(b)m(y)h(the)g(v)-5 -b(alue)29 b(of)1110 5230 y(the)d Fs(HISTFILE)d Ft(v)-5 -b(ariable)26 b(when)e(the)h(shell)h(exits,)h(rather)e(than)h(o)m(v)m -(erwriting)1110 5340 y(the)31 b(\014le.)p eop end +5340 y(matc)m(h.)p eop end %%Page: 66 72 TeXDict begin 66 71 bop 150 -116 a Ft(66)2572 b(Bash)31 -b(Reference)g(Man)m(ual)630 299 y Fs(histreedit)1110 -408 y Ft(If)i(set,)h(and)f(Readline)h(is)f(b)s(eing)g(used,)g(a)g(user) -g(is)g(giv)m(en)h(the)g(opp)s(ortunit)m(y)1110 518 y(to)d(re-edit)g(a)g -(failed)g(history)f(substitution.)630 667 y Fs(histverify)1110 -777 y Ft(If)35 b(set,)i(and)e(Readline)h(is)f(b)s(eing)g(used,)h(the)f -(results)g(of)g(history)h(substitu-)1110 887 y(tion)h(are)g(not)g -(immediately)h(passed)e(to)h(the)g(shell)g(parser.)59 -b(Instead,)38 b(the)1110 996 y(resulting)i(line)f(is)h(loaded)g(in)m -(to)g(the)g(Readline)g(editing)g(bu\013er,)h(allo)m(wing)1110 -1106 y(further)29 b(mo)s(di\014cation.)630 1255 y Fs(hostcomplete)1110 -1365 y Ft(If)38 b(set,)j(and)c(Readline)i(is)f(b)s(eing)g(used,)h(Bash) -g(will)f(attempt)h(to)g(p)s(erform)1110 1474 y(hostname)d(completion)h -(when)e(a)h(w)m(ord)f(con)m(taining)i(a)f(`)p Fs(@)p -Ft(')g(is)g(b)s(eing)f(com-)1110 1584 y(pleted)g(\(see)h(Section)f -(8.4.6)i([Commands)d(F)-8 b(or)36 b(Completion],)g(page)g(120\).)1110 -1694 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.)630 -1843 y Fs(huponexit)1110 1953 y Ft(If)i(set,)i(Bash)f(will)h(send)d +b(Reference)g(Man)m(ual)630 299 y Fs(gnu_errfmt)1110 +408 y Ft(If)k(set,)j(shell)e(error)g(messages)g(are)h(written)e(in)h +(the)g(standard)f Fl(gnu)g Ft(error)1110 518 y(message)c(format.)630 +667 y Fs(histappend)1110 777 y Ft(If)c(set,)j(the)e(history)g(list)g +(is)g(app)s(ended)e(to)j(the)f(\014le)g(named)f(b)m(y)h(the)g(v)-5 +b(alue)29 b(of)1110 887 y(the)d Fs(HISTFILE)d Ft(v)-5 +b(ariable)26 b(when)e(the)h(shell)h(exits,)h(rather)e(than)h(o)m(v)m +(erwriting)1110 996 y(the)31 b(\014le.)630 1146 y Fs(histreedit)1110 +1255 y Ft(If)i(set,)h(and)f(Readline)h(is)f(b)s(eing)g(used,)g(a)g +(user)g(is)g(giv)m(en)h(the)g(opp)s(ortunit)m(y)1110 +1365 y(to)d(re-edit)g(a)g(failed)g(history)f(substitution.)630 +1514 y Fs(histverify)1110 1624 y Ft(If)35 b(set,)i(and)e(Readline)h(is) +f(b)s(eing)g(used,)h(the)f(results)g(of)g(history)h(substitu-)1110 +1733 y(tion)h(are)g(not)g(immediately)h(passed)e(to)h(the)g(shell)g +(parser.)59 b(Instead,)38 b(the)1110 1843 y(resulting)i(line)f(is)h +(loaded)g(in)m(to)g(the)g(Readline)g(editing)g(bu\013er,)h(allo)m(wing) +1110 1953 y(further)29 b(mo)s(di\014cation.)630 2102 +y Fs(hostcomplete)1110 2212 y Ft(If)38 b(set,)j(and)c(Readline)i(is)f +(b)s(eing)g(used,)h(Bash)g(will)f(attempt)h(to)g(p)s(erform)1110 +2321 y(hostname)d(completion)h(when)e(a)h(w)m(ord)f(con)m(taining)i(a)f +(`)p Fs(@)p Ft(')g(is)g(b)s(eing)f(com-)1110 2431 y(pleted)g(\(see)h +(Section)f(8.4.6)i([Commands)d(F)-8 b(or)36 b(Completion],)g(page)g +(120\).)1110 2540 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.) +630 2690 y Fs(huponexit)1110 2800 y Ft(If)i(set,)i(Bash)f(will)h(send)d Fs(SIGHUP)h Ft(to)h(all)h(jobs)e(when)g(an)g(in)m(teractiv)m(e)k(login) -1110 2062 y(shell)31 b(exits)g(\(see)g(Section)g(3.7.6)h([Signals],)g -(page)f(38\).)630 2212 y Fs(interactive_comments)1110 -2321 y Ft(Allo)m(w)c(a)g(w)m(ord)e(b)s(eginning)g(with)h(`)p +1110 2909 y(shell)31 b(exits)g(\(see)g(Section)g(3.7.6)h([Signals],)g +(page)f(38\).)630 3059 y Fs(interactive_comments)1110 +3168 y Ft(Allo)m(w)c(a)g(w)m(ord)e(b)s(eginning)g(with)h(`)p Fs(#)p Ft(')g(to)h(cause)f(that)h(w)m(ord)f(and)f(all)i(remain-)1110 -2431 y(ing)41 b(c)m(haracters)i(on)e(that)h(line)g(to)g(b)s(e)f +3278 y(ing)41 b(c)m(haracters)i(on)e(that)h(line)g(to)g(b)s(e)f (ignored)g(in)g(an)g(in)m(teractiv)m(e)j(shell.)1110 -2540 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.)630 -2690 y Fs(lastpipe)96 b Ft(If)24 b(set,)i(and)e(job)g(con)m(trol)i(is)f +3387 y(This)30 b(option)g(is)h(enabled)f(b)m(y)g(default.)630 +3537 y Fs(lastpipe)96 b Ft(If)24 b(set,)i(and)e(job)g(con)m(trol)i(is)f (not)f(activ)m(e,)k(the)d(shell)f(runs)f(the)i(last)g(command)1110 -2800 y(of)37 b(a)h(pip)s(eline)e(not)h(executed)h(in)f(the)g(bac)m -(kground)g(in)g(the)g(curren)m(t)g(shell)1110 2909 y(en)m(vironmen)m -(t.)630 3059 y Fs(lithist)144 b Ft(If)22 b(enabled,)i(and)d(the)h +3646 y(of)37 b(a)h(pip)s(eline)e(not)h(executed)h(in)f(the)g(bac)m +(kground)g(in)g(the)g(curren)m(t)g(shell)1110 3756 y(en)m(vironmen)m +(t.)630 3905 y Fs(lithist)144 b Ft(If)22 b(enabled,)i(and)d(the)h Fs(cmdhist)e Ft(option)j(is)f(enabled,)i(m)m(ulti-line)f(commands)1110 -3168 y(are)28 b(sa)m(v)m(ed)h(to)g(the)f(history)g(with)f(em)m(b)s -(edded)g(newlines)h(rather)g(than)f(using)1110 3278 y(semicolon)32 -b(separators)f(where)e(p)s(ossible.)630 3427 y Fs(login_shell)1110 -3537 y Ft(The)35 b(shell)h(sets)g(this)f(option)h(if)g(it)g(is)f +4015 y(are)28 b(sa)m(v)m(ed)h(to)g(the)f(history)g(with)f(em)m(b)s +(edded)g(newlines)h(rather)g(than)f(using)1110 4125 y(semicolon)32 +b(separators)f(where)e(p)s(ossible.)630 4274 y Fs(login_shell)1110 +4384 y Ft(The)35 b(shell)h(sets)g(this)f(option)h(if)g(it)g(is)f (started)h(as)g(a)g(login)g(shell)g(\(see)g(Sec-)1110 -3646 y(tion)29 b(6.1)g([In)m(v)m(oking)h(Bash],)f(page)g(79\).)41 +4493 y(tion)29 b(6.1)g([In)m(v)m(oking)h(Bash],)f(page)g(79\).)41 b(The)28 b(v)-5 b(alue)29 b(ma)m(y)g(not)f(b)s(e)g(c)m(hanged.)630 -3796 y Fs(mailwarn)96 b Ft(If)34 b(set,)i(and)e(a)h(\014le)g(that)g +4643 y Fs(mailwarn)96 b Ft(If)34 b(set,)i(and)e(a)h(\014le)g(that)g (Bash)f(is)h(c)m(hec)m(king)h(for)f(mail)g(has)f(b)s(een)g(accessed) -1110 3905 y(since)24 b(the)h(last)g(time)f(it)h(w)m(as)f(c)m(hec)m(k)m +1110 4752 y(since)24 b(the)h(last)g(time)f(it)h(w)m(as)f(c)m(hec)m(k)m (ed,)k(the)c(message)h Fs("The)k(mail)h(in)f Fi(mail-)1110 -4015 y(file)40 b Fs(has)29 b(been)g(read")g Ft(is)i(displa)m(y)m(ed.) -630 4164 y Fs(no_empty_cmd_completion)1110 4274 y Ft(If)f(set,)g(and)g +4862 y(file)40 b Fs(has)29 b(been)g(read")g Ft(is)i(displa)m(y)m(ed.) +630 5011 y Fs(no_empty_cmd_completion)1110 5121 y Ft(If)f(set,)g(and)g (Readline)g(is)h(b)s(eing)e(used,)h(Bash)g(will)g(not)g(attempt)i(to)e -(searc)m(h)1110 4384 y(the)25 b Fs(PATH)f Ft(for)h(p)s(ossible)f +(searc)m(h)1110 5230 y(the)25 b Fs(PATH)f Ft(for)h(p)s(ossible)f (completions)j(when)d(completion)i(is)f(attempted)h(on)1110 -4493 y(an)k(empt)m(y)h(line.)630 4643 y Fs(nocaseglob)1110 -4752 y Ft(If)38 b(set,)k(Bash)d(matc)m(hes)g(\014lenames)g(in)f(a)h -(case-insensitiv)m(e)j(fashion)c(when)1110 4862 y(p)s(erforming)29 -b(\014lename)i(expansion.)630 5011 y Fs(nocasematch)1110 -5121 y Ft(If)42 b(set,)k(Bash)d(matc)m(hes)g(patterns)g(in)f(a)h -(case-insensitiv)m(e)i(fashion)d(when)1110 5230 y(p)s(erforming)31 -b(matc)m(hing)i(while)f(executing)i Fs(case)d Ft(or)h -Fs([[)g Ft(conditional)h(com-)1110 5340 y(mands.)p eop -end +5340 y(an)k(empt)m(y)h(line.)p eop end %%Page: 67 73 TeXDict begin 67 72 bop 150 -116 a Ft(Chapter)30 b(4:)41 -b(Shell)30 b(Builtin)h(Commands)2069 b(67)630 299 y Fs(nullglob)96 -b Ft(If)23 b(set,)j(Bash)e(allo)m(ws)g(\014lename)g(patterns)g(whic)m -(h)f(matc)m(h)h(no)g(\014les)f(to)i(expand)1110 408 y(to)31 -b(a)g(n)m(ull)f(string,)h(rather)f(than)g(themselv)m(es.)630 -553 y Fs(progcomp)96 b Ft(If)25 b(set,)i(the)f(programmable)g -(completion)g(facilities)i(\(see)f(Section)f(8.6)h([Pro-)1110 -663 y(grammable)45 b(Completion],)k(page)c(124\))h(are)f(enabled.)82 -b(This)44 b(option)h(is)1110 772 y(enabled)30 b(b)m(y)h(default.)630 -917 y Fs(promptvars)1110 1027 y Ft(If)50 b(set,)56 b(prompt)49 -b(strings)h(undergo)g(parameter)h(expansion,)k(command)1110 -1136 y(substitution,)35 b(arithmetic)g(expansion,)g(and)e(quote)i(remo) -m(v)-5 b(al)35 b(after)f(b)s(eing)1110 1246 y(expanded)53 -b(as)h(describ)s(ed)e(b)s(elo)m(w)i(\(see)h(Section)f(6.9)h([Con)m -(trolling)g(the)1110 1356 y(Prompt],)30 b(page)h(91\).)42 -b(This)30 b(option)h(is)f(enabled)h(b)m(y)f(default.)630 -1500 y Fs(restricted_shell)1110 1610 y Ft(The)40 b(shell)h(sets)g(this) -g(option)g(if)g(it)h(is)e(started)i(in)e(restricted)i(mo)s(de)e(\(see) -1110 1720 y(Section)c(6.10)g([The)f(Restricted)g(Shell],)i(page)e -(92\).)56 b(The)34 b(v)-5 b(alue)35 b(ma)m(y)h(not)1110 -1829 y(b)s(e)c(c)m(hanged.)49 b(This)32 b(is)h(not)h(reset)f(when)f -(the)h(startup)g(\014les)f(are)i(executed,)1110 1939 -y(allo)m(wing)k(the)e(startup)f(\014les)h(to)g(disco)m(v)m(er)h -(whether)f(or)f(not)i(a)f(shell)g(is)g(re-)1110 2048 -y(stricted.)630 2193 y Fs(shift_verbose)1110 2303 y Ft(If)g(this)g(is)g -(set,)j(the)d Fs(shift)f Ft(builtin)h(prin)m(ts)f(an)h(error)g(message) -i(when)d(the)1110 2412 y(shift)30 b(coun)m(t)h(exceeds)g(the)g(n)m(um)m -(b)s(er)e(of)h(p)s(ositional)i(parameters.)630 2557 y -Fs(sourcepath)1110 2667 y Ft(If)22 b(set,)j(the)e Fs(source)e -Ft(builtin)h(uses)g(the)h(v)-5 b(alue)23 b(of)g Fs(PATH)e -Ft(to)j(\014nd)d(the)h(directory)1110 2776 y(con)m(taining)29 -b(the)e(\014le)h(supplied)e(as)h(an)g(argumen)m(t.)40 -b(This)27 b(option)h(is)f(enabled)1110 2886 y(b)m(y)j(default.)630 -3031 y Fs(xpg_echo)96 b Ft(If)31 b(set,)h(the)g Fs(echo)e +b(Shell)30 b(Builtin)h(Commands)2069 b(67)630 299 y Fs(nocaseglob)1110 +408 y Ft(If)38 b(set,)k(Bash)d(matc)m(hes)g(\014lenames)g(in)f(a)h +(case-insensitiv)m(e)j(fashion)c(when)1110 518 y(p)s(erforming)29 +b(\014lename)i(expansion.)630 676 y Fs(nocasematch)1110 +786 y Ft(If)42 b(set,)k(Bash)d(matc)m(hes)g(patterns)g(in)f(a)h +(case-insensitiv)m(e)i(fashion)d(when)1110 895 y(p)s(erforming)31 +b(matc)m(hing)i(while)f(executing)i Fs(case)d Ft(or)h +Fs([[)g Ft(conditional)h(com-)1110 1005 y(mands.)630 +1163 y Fs(nullglob)96 b Ft(If)23 b(set,)j(Bash)e(allo)m(ws)g +(\014lename)g(patterns)g(whic)m(h)f(matc)m(h)h(no)g(\014les)f(to)i +(expand)1110 1273 y(to)31 b(a)g(n)m(ull)f(string,)h(rather)f(than)g +(themselv)m(es.)630 1431 y Fs(progcomp)96 b Ft(If)25 +b(set,)i(the)f(programmable)g(completion)g(facilities)i(\(see)f +(Section)f(8.6)h([Pro-)1110 1541 y(grammable)45 b(Completion],)k(page)c +(124\))h(are)f(enabled.)82 b(This)44 b(option)h(is)1110 +1650 y(enabled)30 b(b)m(y)h(default.)630 1808 y Fs(promptvars)1110 +1918 y Ft(If)50 b(set,)56 b(prompt)49 b(strings)h(undergo)g(parameter)h +(expansion,)k(command)1110 2028 y(substitution,)35 b(arithmetic)g +(expansion,)g(and)e(quote)i(remo)m(v)-5 b(al)35 b(after)f(b)s(eing)1110 +2137 y(expanded)53 b(as)h(describ)s(ed)e(b)s(elo)m(w)i(\(see)h(Section) +f(6.9)h([Con)m(trolling)g(the)1110 2247 y(Prompt],)30 +b(page)h(91\).)42 b(This)30 b(option)h(is)f(enabled)h(b)m(y)f(default.) +630 2405 y Fs(restricted_shell)1110 2515 y Ft(The)40 +b(shell)h(sets)g(this)g(option)g(if)g(it)h(is)e(started)i(in)e +(restricted)i(mo)s(de)e(\(see)1110 2624 y(Section)c(6.10)g([The)f +(Restricted)g(Shell],)i(page)e(92\).)56 b(The)34 b(v)-5 +b(alue)35 b(ma)m(y)h(not)1110 2734 y(b)s(e)c(c)m(hanged.)49 +b(This)32 b(is)h(not)h(reset)f(when)f(the)h(startup)g(\014les)f(are)i +(executed,)1110 2843 y(allo)m(wing)k(the)e(startup)f(\014les)h(to)g +(disco)m(v)m(er)h(whether)f(or)f(not)i(a)f(shell)g(is)g(re-)1110 +2953 y(stricted.)630 3111 y Fs(shift_verbose)1110 3221 +y Ft(If)g(this)g(is)g(set,)j(the)d Fs(shift)f Ft(builtin)h(prin)m(ts)f +(an)h(error)g(message)i(when)d(the)1110 3330 y(shift)30 +b(coun)m(t)h(exceeds)g(the)g(n)m(um)m(b)s(er)e(of)h(p)s(ositional)i +(parameters.)630 3488 y Fs(sourcepath)1110 3598 y Ft(If)22 +b(set,)j(the)e Fs(source)e Ft(builtin)h(uses)g(the)h(v)-5 +b(alue)23 b(of)g Fs(PATH)e Ft(to)j(\014nd)d(the)h(directory)1110 +3708 y(con)m(taining)29 b(the)e(\014le)h(supplied)e(as)h(an)g(argumen)m +(t.)40 b(This)27 b(option)h(is)f(enabled)1110 3817 y(b)m(y)j(default.) +630 3975 y Fs(xpg_echo)96 b Ft(If)31 b(set,)h(the)g Fs(echo)e Ft(builtin)h(expands)f(bac)m(kslash-escap)s(e)j(sequences)f(b)m(y)f -(de-)1110 3140 y(fault.)630 3285 y(The)c(return)f(status)i(when)f +(de-)1110 4085 y(fault.)630 4243 y(The)c(return)f(status)i(when)f (listing)h(options)g(is)f(zero)i(if)e(all)i Fq(optnames)i -Ft(are)d(enabled,)g(non-)630 3395 y(zero)40 b(otherwise.)66 +Ft(are)d(enabled,)g(non-)630 4353 y(zero)40 b(otherwise.)66 b(When)39 b(setting)h(or)f(unsetting)g(options,)i(the)e(return)f -(status)h(is)g(zero)630 3504 y(unless)30 b(an)g Fq(optname)36 +(status)h(is)g(zero)630 4462 y(unless)30 b(an)g Fq(optname)36 b Ft(is)30 b(not)h(a)g(v)-5 b(alid)30 b(shell)h(option.)150 -3722 y Fr(4.4)68 b(Sp)t(ecial)45 b(Builtins)150 3881 +4694 y Fr(4.4)68 b(Sp)t(ecial)45 b(Builtins)150 4853 y Ft(F)-8 b(or)35 b(historical)h(reasons,)g(the)e Fl(posix)g Ft(standard)f(has)i(classi\014ed)f(sev)m(eral)i(builtin)e(commands)g -(as)h Fk(sp)-5 b(e-)150 3991 y(cial)p Ft(.)47 b(When)33 +(as)h Fk(sp)-5 b(e-)150 4963 y(cial)p Ft(.)47 b(When)33 b(Bash)f(is)h(executing)g(in)f Fl(posix)g Ft(mo)s(de,)h(the)g(sp)s (ecial)g(builtins)e(di\013er)i(from)f(other)g(builtin)150 -4101 y(commands)e(in)g(three)h(resp)s(ects:)199 4228 +5072 y(commands)e(in)g(three)h(resp)s(ects:)199 5206 y(1.)61 b(Sp)s(ecial)31 b(builtins)e(are)i(found)e(b)s(efore)h(shell)h -(functions)f(during)f(command)h(lo)s(okup.)199 4355 y(2.)61 +(functions)f(during)f(command)h(lo)s(okup.)199 5340 y(2.)61 b(If)30 b(a)h(sp)s(ecial)g(builtin)f(returns)f(an)h(error)g(status,)h -(a)g(non-in)m(teractiv)m(e)i(shell)d(exits.)199 4482 -y(3.)61 b(Assignmen)m(t)30 b(statemen)m(ts)h(preceding)f(the)f(command) -g(sta)m(y)i(in)e(e\013ect)i(in)e(the)h(shell)f(en)m(vironmen)m(t)330 -4592 y(after)i(the)f(command)h(completes.)275 4737 y(When)36 -b(Bash)g(is)h(not)f(executing)i(in)e Fl(posix)f Ft(mo)s(de,)j(these)f -(builtins)f(b)s(eha)m(v)m(e)h(no)f(di\013eren)m(tly)h(than)150 -4846 y(the)31 b(rest)f(of)h(the)f(Bash)h(builtin)e(commands.)41 -b(The)30 b(Bash)g Fl(posix)g Ft(mo)s(de)g(is)g(describ)s(ed)f(in)h -(Section)h(6.11)150 4956 y([Bash)g(POSIX)e(Mo)s(de],)i(page)g(92.)275 -5083 y(These)f(are)g(the)h Fl(posix)f Ft(sp)s(ecial)h(builtins:)390 -5210 y Fs(break)46 b(:)i(.)f(continue)f(eval)g(exec)h(exit)g(export)f -(readonly)f(return)h(set)390 5320 y(shift)g(trap)h(unset)p -eop end +(a)g(non-in)m(teractiv)m(e)i(shell)d(exits.)p eop end %%Page: 68 74 -TeXDict begin 68 73 bop eop end +TeXDict begin 68 73 bop 150 -116 a Ft(68)2572 b(Bash)31 +b(Reference)g(Man)m(ual)199 299 y(3.)61 b(Assignmen)m(t)30 +b(statemen)m(ts)h(preceding)f(the)f(command)g(sta)m(y)i(in)e(e\013ect)i +(in)e(the)h(shell)f(en)m(vironmen)m(t)330 408 y(after)i(the)f(command)h +(completes.)275 568 y(When)36 b(Bash)g(is)h(not)f(executing)i(in)e +Fl(posix)f Ft(mo)s(de,)j(these)f(builtins)f(b)s(eha)m(v)m(e)h(no)f +(di\013eren)m(tly)h(than)150 677 y(the)31 b(rest)f(of)h(the)f(Bash)h +(builtin)e(commands.)41 b(The)30 b(Bash)g Fl(posix)g +Ft(mo)s(de)g(is)g(describ)s(ed)f(in)h(Section)h(6.11)150 +787 y([Bash)g(POSIX)e(Mo)s(de],)i(page)g(92.)275 922 +y(These)f(are)g(the)h Fl(posix)f Ft(sp)s(ecial)h(builtins:)390 +1056 y Fs(break)46 b(:)i(.)f(continue)f(eval)g(exec)h(exit)g(export)f +(readonly)f(return)h(set)390 1166 y(shift)g(trap)h(unset)p +eop end %%Page: 69 75 TeXDict begin 69 74 bop 150 -116 a Ft(Chapter)30 b(5:)41 b(Shell)30 b(V)-8 b(ariables)2459 b(69)150 299 y Fo(5)80 diff --git a/doc/builtins.0 b/doc/builtins.0 index 26e11d67..f37aab9e 100644 --- a/doc/builtins.0 +++ b/doc/builtins.0 @@ -1053,21 +1053,28 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS applies to the shell environment and each subshell envi- ronment separately (see CCOOMMMMAANNDD EEXXEECCUUTTIIOONN EENNVVIIRROONNMMEENNTT above), and may cause subshells to exit before executing - all the commands in the subshell. + all the commands in the subshell. If a shell function + executes in a context where --ee is being ignored, even if + --ee is set, none of the commands executed within the + function body will be affected by the --ee setting. If a + shell function sets --ee while executing in a context + where --ee is ignored, that setting will not have any + effect until the command containing the function call + completes. --ff Disable pathname expansion. - --hh Remember the location of commands as they are looked up + --hh Remember the location of commands as they are looked up for execution. This is enabled by default. - --kk All arguments in the form of assignment statements are - placed in the environment for a command, not just those + --kk All arguments in the form of assignment statements are + placed in the environment for a command, not just those that precede the command name. - --mm Monitor mode. Job control is enabled. This option is - on by default for interactive shells on systems that - support it (see JJOOBB CCOONNTTRROOLL above). All processes run + --mm Monitor mode. Job control is enabled. This option is + on by default for interactive shells on systems that + support it (see JJOOBB CCOONNTTRROOLL above). All processes run in a separate process group. When a background job com- pletes, the shell prints a line containing its exit sta- tus. --nn Read commands but do not execute them. This may be used - to check a shell script for syntax errors. This is + to check a shell script for syntax errors. This is ignored by interactive shells. --oo _o_p_t_i_o_n_-_n_a_m_e The _o_p_t_i_o_n_-_n_a_m_e can be one of the following: @@ -1075,10 +1082,10 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS Same as --aa. bbrraacceeeexxppaanndd Same as --BB. - eemmaaccss Use an emacs-style command line editing inter- + eemmaaccss Use an emacs-style command line editing inter- face. This is enabled by default when the shell is interactive, unless the shell is started with - the ----nnooeeddiittiinngg option. This also affects the + the ----nnooeeddiittiinngg option. This also affects the editing interface used for rreeaadd --ee. eerrrreexxiitt Same as --ee. eerrrrttrraaccee @@ -1092,8 +1099,8 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS HHIISSTTOORRYY. This option is on by default in inter- active shells. iiggnnoorreeeeooff - The effect is as if the shell command - ``IGNOREEOF=10'' had been executed (see SShheellll + The effect is as if the shell command + ``IGNOREEOF=10'' had been executed (see SShheellll VVaarriiaabblleess above). kkeeyywwoorrdd Same as --kk. mmoonniittoorr Same as --mm. @@ -1108,335 +1115,335 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS pphhyyssiiccaall Same as --PP. ppiippeeffaaiill - If set, the return value of a pipeline is the - value of the last (rightmost) command to exit - with a non-zero status, or zero if all commands - in the pipeline exit successfully. This option + If set, the return value of a pipeline is the + value of the last (rightmost) command to exit + with a non-zero status, or zero if all commands + in the pipeline exit successfully. This option is disabled by default. - ppoossiixx Change the behavior of bbaasshh where the default - operation differs from the POSIX standard to + ppoossiixx Change the behavior of bbaasshh where the default + operation differs from the POSIX standard to match the standard (_p_o_s_i_x _m_o_d_e). pprriivviilleeggeedd Same as --pp. vveerrbboossee Same as --vv. - vvii Use a vi-style command line editing interface. + vvii Use a vi-style command line editing interface. This also affects the editing interface used for rreeaadd --ee. xxttrraaccee Same as --xx. If --oo is supplied with no _o_p_t_i_o_n_-_n_a_m_e, the values of the - current options are printed. If ++oo is supplied with no - _o_p_t_i_o_n_-_n_a_m_e, a series of sseett commands to recreate the - current option settings is displayed on the standard + current options are printed. If ++oo is supplied with no + _o_p_t_i_o_n_-_n_a_m_e, a series of sseett commands to recreate the + current option settings is displayed on the standard output. - --pp Turn on _p_r_i_v_i_l_e_g_e_d mode. In this mode, the $$EENNVV and - $$BBAASSHH__EENNVV files are not processed, shell functions are - not inherited from the environment, and the SSHHEELLLLOOPPTTSS, - BBAASSHHOOPPTTSS, CCDDPPAATTHH, and GGLLOOBBIIGGNNOORREE variables, if they + --pp Turn on _p_r_i_v_i_l_e_g_e_d mode. In this mode, the $$EENNVV and + $$BBAASSHH__EENNVV files are not processed, shell functions are + not inherited from the environment, and the SSHHEELLLLOOPPTTSS, + BBAASSHHOOPPTTSS, CCDDPPAATTHH, and GGLLOOBBIIGGNNOORREE variables, if they appear in the environment, are ignored. If the shell is - started with the effective user (group) id not equal to - the real user (group) id, and the --pp option is not sup- + started with the effective user (group) id not equal to + the real user (group) id, and the --pp option is not sup- plied, these actions are taken and the effective user id - is set to the real user id. If the --pp option is sup- - plied at startup, the effective user id is not reset. - Turning this option off causes the effective user and + is set to the real user id. If the --pp option is sup- + plied at startup, the effective user id is not reset. + Turning this option off causes the effective user and group ids to be set to the real user and group ids. --tt Exit after reading and executing one command. --uu Treat unset variables and parameters other than the spe- - cial parameters "@" and "*" as an error when performing - parameter expansion. If expansion is attempted on an - unset variable or parameter, the shell prints an error - message, and, if not interactive, exits with a non-zero + cial parameters "@" and "*" as an error when performing + parameter expansion. If expansion is attempted on an + unset variable or parameter, the shell prints an error + message, and, if not interactive, exits with a non-zero status. --vv Print shell input lines as they are read. - --xx After expanding each _s_i_m_p_l_e _c_o_m_m_a_n_d, ffoorr command, ccaassee + --xx After expanding each _s_i_m_p_l_e _c_o_m_m_a_n_d, ffoorr command, ccaassee command, sseelleecctt command, or arithmetic ffoorr command, dis- - play the expanded value of PPSS44, followed by the command + play the expanded value of PPSS44, followed by the command and its expanded arguments or associated word list. - --BB The shell performs brace expansion (see BBrraaccee EExxppaannssiioonn + --BB The shell performs brace expansion (see BBrraaccee EExxppaannssiioonn above). This is on by default. - --CC If set, bbaasshh does not overwrite an existing file with - the >>, >>&&, and <<>> redirection operators. This may be + --CC If set, bbaasshh does not overwrite an existing file with + the >>, >>&&, and <<>> redirection operators. This may be overridden when creating output files by using the redi- rection operator >>|| instead of >>. --EE If set, any trap on EERRRR is inherited by shell functions, - command substitutions, and commands executed in a sub- - shell environment. The EERRRR trap is normally not inher- + command substitutions, and commands executed in a sub- + shell environment. The EERRRR trap is normally not inher- ited in such cases. --HH Enable !! style history substitution. This option is on by default when the shell is interactive. - --PP If set, the shell does not resolve symbolic links when - executing commands such as ccdd that change the current + --PP If set, the shell does not resolve symbolic links when + executing commands such as ccdd that change the current working directory. It uses the physical directory structure instead. By default, bbaasshh follows the logical - chain of directories when performing commands which + chain of directories when performing commands which change the current directory. - --TT If set, any traps on DDEEBBUUGG and RREETTUURRNN are inherited by - shell functions, command substitutions, and commands - executed in a subshell environment. The DDEEBBUUGG and + --TT If set, any traps on DDEEBBUUGG and RREETTUURRNN are inherited by + shell functions, command substitutions, and commands + executed in a subshell environment. The DDEEBBUUGG and RREETTUURRNN traps are normally not inherited in such cases. - ---- If no arguments follow this option, then the positional + ---- If no arguments follow this option, then the positional parameters are unset. Otherwise, the positional parame- - ters are set to the _a_r_gs, even if some of them begin + ters are set to the _a_r_gs, even if some of them begin with a --. - -- Signal the end of options, cause all remaining _a_r_gs to + -- Signal the end of options, cause all remaining _a_r_gs to be assigned to the positional parameters. The --xx and --vv options are turned off. If there are no _a_r_gs, the posi- tional parameters remain unchanged. - The options are off by default unless otherwise noted. Using + - rather than - causes these options to be turned off. The - options can also be specified as arguments to an invocation of - the shell. The current set of options may be found in $$--. The + The options are off by default unless otherwise noted. Using + + rather than - causes these options to be turned off. The + options can also be specified as arguments to an invocation of + the shell. The current set of options may be found in $$--. The return status is always true unless an invalid option is encoun- tered. sshhiifftt [_n] - The positional parameters from _n+1 ... are renamed to $$11 ........ - Parameters represented by the numbers $$## down to $$##-_n+1 are - unset. _n must be a non-negative number less than or equal to - $$##. If _n is 0, no parameters are changed. If _n is not given, - it is assumed to be 1. If _n is greater than $$##, the positional - parameters are not changed. The return status is greater than + The positional parameters from _n+1 ... are renamed to $$11 ........ + Parameters represented by the numbers $$## down to $$##-_n+1 are + unset. _n must be a non-negative number less than or equal to + $$##. If _n is 0, no parameters are changed. If _n is not given, + it is assumed to be 1. If _n is greater than $$##, the positional + parameters are not changed. The return status is greater than zero if _n is greater than $$## or less than zero; otherwise 0. sshhoopptt [--ppqqssuu] [--oo] [_o_p_t_n_a_m_e ...] Toggle the values of 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, sshhoopptt - shows only those options which are set or unset, respectively. - Unless otherwise noted, the sshhoopptt options are disabled (unset) + If either --ss or --uu is used with no _o_p_t_n_a_m_e arguments, sshhoopptt + shows only those options which are set or unset, respectively. + Unless otherwise noted, the sshhoopptt options are disabled (unset) by default. - The return status when listing options is zero if all _o_p_t_n_a_m_e_s - are enabled, non-zero otherwise. When setting or unsetting - options, the return status is zero unless an _o_p_t_n_a_m_e is not a + The return status when listing options is zero if all _o_p_t_n_a_m_e_s + are enabled, non-zero otherwise. When setting or unsetting + options, the return status is zero unless an _o_p_t_n_a_m_e is not a valid shell option. The list of sshhoopptt options is: - aauuttooccdd If set, a command name that is the name of a directory - is executed as if it were the argument to the ccdd com- + aauuttooccdd If set, a command name that is the name of a directory + is executed as if it were the argument to the ccdd com- mand. This option is only used by interactive shells. ccddaabbllee__vvaarrss - If set, an argument to the ccdd builtin command that is - not a directory is assumed to be the name of a variable + If set, an argument to the ccdd builtin command that is + not a directory is assumed to be the name of a variable whose value is the directory to change to. ccddssppeellll If set, minor errors in the spelling of a directory com- - ponent in a ccdd command will be corrected. The errors + ponent in a ccdd command will be corrected. The errors checked for are transposed characters, a missing charac- - ter, and one character too many. If a correction is - found, the corrected filename is printed, and the com- - mand proceeds. This option is only used by interactive + ter, and one character too many. If a correction is + found, the corrected filename is printed, and the com- + mand proceeds. This option is only used by interactive shells. cchheecckkhhaasshh If set, bbaasshh checks that a command found in the hash ta- - ble exists before trying to execute it. If a hashed - command no longer exists, a normal path search is per- + ble exists before trying to execute it. If a hashed + command no longer exists, a normal path search is per- formed. cchheecckkjjoobbss If set, bbaasshh lists the status of any stopped and running - jobs before exiting an interactive shell. If any jobs + jobs before exiting an interactive shell. If any jobs are running, this causes the exit to be deferred until a - second exit is attempted without an intervening command - (see JJOOBB CCOONNTTRROOLL above). The shell always postpones + second exit is attempted without an intervening command + (see JJOOBB CCOONNTTRROOLL above). The shell always postpones exiting if any jobs are stopped. cchheecckkwwiinnssiizzee - If set, bbaasshh checks the window size after each command - and, if necessary, updates the values of LLIINNEESS and CCOOLL-- + If set, bbaasshh checks the window size after each command + and, if necessary, updates the values of LLIINNEESS and CCOOLL-- UUMMNNSS. - ccmmddhhiisstt If set, bbaasshh attempts to save all lines of a multiple- - line command in the same history entry. This allows + 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. ccoommppaatt3311 If set, bbaasshh changes its behavior to that of version 3.1 - with respect to quoted arguments to the [[[[ conditional + with respect to quoted arguments to the [[[[ conditional command's ==~~ operator and locale-specific string compar- - ison when using the [[[[ conditional command's << and >> - operators. Bash versions prior to bash-4.1 use ASCII + ison when using the [[[[ conditional command's << and >> + operators. Bash versions prior to bash-4.1 use ASCII collation and _s_t_r_c_m_p(3); bash-4.1 and later use the cur- rent locale's collation sequence and _s_t_r_c_o_l_l(3). ccoommppaatt3322 If set, bbaasshh changes its behavior to that of version 3.2 - with respect to locale-specific string comparison when - using the [[[[ conditional command's << and >> operators + with respect to locale-specific string comparison when + using the [[[[ conditional command's << and >> operators (see previous item). ccoommppaatt4400 If set, bbaasshh changes its behavior to that of version 4.0 - with respect to locale-specific string comparison when - using the [[[[ conditional command's << and >> operators - (see description of ccoommppaatt3311) and the effect of inter- - rupting a command list. Bash versions 4.0 and later - interrupt the list as if the shell received the inter- - rupt; previous versions continue with the next command + with respect to locale-specific string comparison when + using the [[[[ conditional command's << and >> operators + (see description of ccoommppaatt3311) and the effect of inter- + rupting a command list. Bash versions 4.0 and later + interrupt the list as if the shell received the inter- + rupt; previous versions continue with the next command in the list. ccoommppaatt4411 - If set, bbaasshh, when in posix mode, treats a single quote - in a double-quoted parameter expansion as a special - character. The single quotes must match (an even num- - ber) and the characters between the single quotes are - considered quoted. This is the behavior of posix mode - through version 4.1. The default bash behavior remains + If set, bbaasshh, when in posix mode, treats a single quote + in a double-quoted parameter expansion as a special + character. The single quotes must match (an even num- + ber) and the characters between the single quotes are + considered quoted. This is the behavior of posix mode + through version 4.1. The default bash behavior remains as in previous versions. ccoommpplleettee__ffuullllqquuoottee - If set, bbaasshh quotes all shell metacharacters in file- - names and directory names when performing completion. + If set, bbaasshh quotes all shell metacharacters in file- + names and directory names when performing completion. If not set, bbaasshh removes metacharacters such as the dol- - lar sign from the set of characters that will be quoted - in completed filenames when these metacharacters appear - in shell variable references in words to be completed. - This means that dollar signs in variable names that - expand to directories will not be quoted; however, any - dollar signs appearing in filenames will not be quoted, - either. This is active only when bash is using back- - slashes to quote completed filenames. This variable is - set by default, which is the default bash behavior in + lar sign from the set of characters that will be quoted + in completed filenames when these metacharacters appear + in shell variable references in words to be completed. + This means that dollar signs in variable names that + expand to directories will not be quoted; however, any + dollar signs appearing in filenames will not be quoted, + either. This is active only when bash is using back- + slashes to quote completed filenames. This variable is + set by default, which is the default bash behavior in versions through 4.2. ddiirreexxppaanndd - If set, bbaasshh replaces directory names with the results - of word expansion when performing filename completion. + If set, bbaasshh replaces directory names with the results + of word expansion when performing filename completion. This changes the contents of the readline editing - buffer. If not set, bbaasshh attempts to preserve what the + buffer. If not set, bbaasshh attempts to preserve what the user typed. ddiirrssppeellll - If set, bbaasshh attempts spelling correction on directory - names during word completion if the directory name ini- + If set, bbaasshh attempts spelling correction on directory + names during word completion if the directory name ini- tially supplied does not exist. - ddoottgglloobb If set, bbaasshh includes filenames beginning with a `.' in + 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 EERRRR trap. eexxttgglloobb If set, the extended pattern matching features described above under PPaatthhnnaammee EExxppaannssiioonn are enabled. eexxttqquuoottee - If set, $$'_s_t_r_i_n_g' and $$"_s_t_r_i_n_g" quoting is performed - within $${{_p_a_r_a_m_e_t_e_r}} expansions enclosed in double + If set, $$'_s_t_r_i_n_g' and $$"_s_t_r_i_n_g" quoting is performed + within $${{_p_a_r_a_m_e_t_e_r}} expansions enclosed in double quotes. This option is enabled by default. ffaaiillgglloobb - If set, patterns which fail to match filenames during + If set, patterns which fail to match filenames during pathname expansion result in an expansion error. ffoorrccee__ffiiggnnoorree - If set, the suffixes specified by the FFIIGGNNOORREE shell - variable cause words to be ignored when performing word + If set, the suffixes specified by the FFIIGGNNOORREE shell + variable cause words to be ignored when performing word completion even if the ignored words are the only possi- ble completions. See SSHHEELLLL VVAARRIIAABBLLEESS above for a - description of FFIIGGNNOORREE. This option is enabled by + description of FFIIGGNNOORREE. This option is enabled by default. gglloobbaasscciiiirraannggeess - If set, range expressions used in pattern matching (see - PPaatttteerrnn MMaattcchhiinngg above) behave as if in the traditional + If set, range expressions used in pattern matching (see + PPaatttteerrnn MMaattcchhiinngg above) behave as if in the traditional C locale when performing comparisons. That is, the cur- - rent locale's collating sequence is not taken into - account, so bb will not collate between AA and BB, and - upper-case and lower-case ASCII characters will collate + rent locale's collating sequence is not taken into + account, so bb will not collate between AA and BB, and + upper-case and lower-case ASCII characters will collate together. gglloobbssttaarr If set, the pattern **** used in a pathname expansion con- - text will match all files and zero or more directories - and subdirectories. If the pattern is followed by a //, + text will match all files and zero or more directories + and subdirectories. If the pattern is followed by a //, only directories and subdirectories match. ggnnuu__eerrrrffmmtt If set, shell error messages are written in the standard GNU error message format. hhiissttaappppeenndd - If set, the history list is appended to the file named - by the value of the HHIISSTTFFIILLEE variable when the shell + If set, the history list is appended to the file named + by the value of the HHIISSTTFFIILLEE variable when the shell exits, rather than overwriting the file. hhiissttrreeeeddiitt - If set, and rreeaaddlliinnee is being used, a user is given the + If set, and rreeaaddlliinnee is being used, a user is given the opportunity to re-edit a failed history substitution. hhiissttvveerriiffyy - If set, and rreeaaddlliinnee is being used, the results of his- - tory substitution are not immediately passed to the - shell parser. Instead, the resulting line is loaded + If set, and rreeaaddlliinnee is being used, the results of his- + tory substitution are not immediately passed to the + shell parser. Instead, the resulting line is loaded into the rreeaaddlliinnee editing buffer, allowing further modi- fication. hhoossttccoommpplleettee If set, and rreeaaddlliinnee is being used, bbaasshh will attempt to - perform hostname completion when a word containing a @@ - is being completed (see CCoommpplleettiinngg under RREEAADDLLIINNEE + perform hostname completion when a word containing a @@ + is being completed (see CCoommpplleettiinngg under RREEAADDLLIINNEE above). This is enabled by default. hhuuppoonneexxiitt If set, bbaasshh will send SSIIGGHHUUPP to all jobs when an inter- active login shell exits. iinntteerraaccttiivvee__ccoommmmeennttss If set, allow a word beginning with ## to cause that word - and all remaining characters on that line to be ignored - in an interactive shell (see CCOOMMMMEENNTTSS above). This + and all remaining characters on that line to be ignored + in an interactive shell (see CCOOMMMMEENNTTSS above). This option is enabled by default. llaassttppiippee - If set, and job control is not active, the shell runs + If set, and job control is not active, the shell runs the last command of a pipeline not executed in the back- ground in the current shell environment. - lliitthhiisstt If set, and the ccmmddhhiisstt option is enabled, multi-line + lliitthhiisstt If set, and the ccmmddhhiisstt option is enabled, multi-line commands are saved to the history with embedded newlines rather than using semicolon separators where possible. 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-- @@ -1444,50 +1451,50 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS enabled by default. pprroommppttvvaarrss If set, prompt strings undergo parameter expansion, com- - mand substitution, arithmetic expansion, and quote - removal after being expanded as described in PPRROOMMPPTTIINNGG + mand substitution, arithmetic expansion, and quote + removal after being expanded as described in PPRROOMMPPTTIINNGG above. This option is enabled by default. rreessttrriicctteedd__sshheellll - The shell sets this option if it is started in + The shell sets this option if it is started in restricted mode (see RREESSTTRRIICCTTEEDD SSHHEELLLL below). The value - may not be changed. This is not reset when the startup - files are executed, allowing the startup files to dis- + may not be changed. This is not reset when the startup + files are executed, allowing the startup files to dis- cover whether or not a shell is restricted. sshhiifftt__vveerrbboossee - If set, the sshhiifftt builtin prints an error message when + If set, the sshhiifftt builtin prints an error message when the shift count exceeds the number of positional parame- ters. ssoouurrcceeppaatthh If set, the ssoouurrccee (..) builtin uses the value of PPAATTHH to - find the directory containing the file supplied as an + find the directory containing the file supplied as an argument. This option is enabled by default. xxppgg__eecchhoo - If set, the eecchhoo builtin expands backslash-escape + If set, the eecchhoo builtin expands backslash-escape sequences by default. ssuussppeenndd [--ff] - Suspend the execution of this shell until it receives a SSIIGGCCOONNTT + Suspend the execution of this shell until it receives a SSIIGGCCOONNTT signal. A login shell cannot be suspended; the --ff option can be used to override this and force the suspension. The return sta- - tus is 0 unless the shell is a login shell and --ff is not sup- + tus is 0 unless the shell is a login shell and --ff is not sup- plied, or if job control is not enabled. tteesstt _e_x_p_r [[ _e_x_p_r ]] Return a status of 0 (true) or 1 (false) depending on the evalu- ation of the conditional expression _e_x_p_r. Each operator and op- - erand must be a separate argument. Expressions are composed of - the primaries described above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS. - tteesstt does not accept any options, nor does it accept and ignore + erand must be a separate argument. Expressions are composed of + the primaries described above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS. + tteesstt does not accept any options, nor does it accept and ignore an argument of ---- as signifying the end of options. - Expressions may be combined using the following operators, + Expressions may be combined using the following operators, listed in decreasing order of precedence. The evaluation - depends on the number of arguments; see below. Operator prece- + depends on the number of arguments; see below. Operator prece- dence is used when there are five or more arguments. !! _e_x_p_r True if _e_x_p_r is false. (( _e_x_p_r )) - Returns the value of _e_x_p_r. This may be used to override + Returns the value of _e_x_p_r. This may be used to override the normal precedence of operators. _e_x_p_r_1 -aa _e_x_p_r_2 True if both _e_x_p_r_1 and _e_x_p_r_2 are true. @@ -1504,63 +1511,63 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS null. 2 arguments If the first argument is !!, the expression is true if and - only if the second argument is null. If the first argu- - ment is one of the unary conditional operators listed - above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS, the expression is + only if the second argument is null. If the first argu- + ment is one of the unary conditional operators listed + above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS, the expression is true if the unary test is true. If the first argument is not a valid unary conditional operator, the expression is false. 3 arguments The following conditions are applied in the order listed. - If the second argument is one of the binary conditional + If the second argument is one of the binary conditional operators listed above under CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS, the result of the expression is the result of the binary test - using the first and third arguments as operands. The --aa - and --oo operators are considered binary operators when - there are three arguments. If the first argument is !!, - the value is the negation of the two-argument test using + using the first and third arguments as operands. The --aa + and --oo operators are considered binary operators when + there are three arguments. If the first argument is !!, + the value is the negation of the two-argument test using the second and third arguments. If the first argument is exactly (( and the third argument is exactly )), the result - is the one-argument test of the second argument. Other- + is the one-argument test of the second argument. Other- wise, the expression is false. 4 arguments If the first argument is !!, the result is the negation of - the three-argument expression composed of the remaining + the three-argument expression composed of the remaining arguments. Otherwise, the expression is parsed and eval- - uated according to precedence using the rules listed + uated according to precedence using the rules listed above. 5 or more arguments - The expression is parsed and evaluated according to + The expression is parsed and evaluated according to precedence using the rules listed above. - When used with tteesstt or [[, the << and >> operators sort lexico- + When used with tteesstt or [[, the << and >> operators sort lexico- graphically using ASCII ordering. - ttiimmeess Print the accumulated user and system times for the shell and + ttiimmeess Print the accumulated user and system times for the shell and for processes run from the shell. The return status is 0. ttrraapp [--llpp] [[_a_r_g] _s_i_g_s_p_e_c ...] - The command _a_r_g is to be read and executed when the shell - receives signal(s) _s_i_g_s_p_e_c. If _a_r_g is absent (and there is a - single _s_i_g_s_p_e_c) or --, each specified signal is reset to its - original disposition (the value it had upon entrance to the - shell). If _a_r_g is the null string the signal specified by each - _s_i_g_s_p_e_c is ignored by the shell and by the commands it invokes. - If _a_r_g is not present and --pp has been supplied, then the trap - commands associated with each _s_i_g_s_p_e_c are displayed. If no - arguments are supplied or if only --pp is given, ttrraapp prints the - list of commands associated with each signal. The --ll option - causes the shell to print a list of signal names and their cor- - responding numbers. Each _s_i_g_s_p_e_c is either a signal name - defined in <_s_i_g_n_a_l_._h>, or a signal number. Signal names are + The command _a_r_g is to be read and executed when the shell + receives signal(s) _s_i_g_s_p_e_c. If _a_r_g is absent (and there is a + single _s_i_g_s_p_e_c) or --, each specified signal is reset to its + original disposition (the value it had upon entrance to the + shell). If _a_r_g is the null string the signal specified by each + _s_i_g_s_p_e_c is ignored by the shell and by the commands it invokes. + If _a_r_g is not present and --pp has been supplied, then the trap + commands associated with each _s_i_g_s_p_e_c are displayed. If no + arguments are supplied or if only --pp is given, ttrraapp prints the + list of commands associated with each signal. The --ll option + causes the shell to print a list of signal names and their cor- + responding numbers. Each _s_i_g_s_p_e_c is either a signal name + defined in <_s_i_g_n_a_l_._h>, or a signal number. Signal names are case insensitive and the SSIIGG prefix is optional. - If a _s_i_g_s_p_e_c is EEXXIITT (0) the command _a_r_g is executed on exit - from the shell. If a _s_i_g_s_p_e_c is DDEEBBUUGG, the command _a_r_g is exe- - cuted before every _s_i_m_p_l_e _c_o_m_m_a_n_d, _f_o_r command, _c_a_s_e command, - _s_e_l_e_c_t command, every arithmetic _f_o_r command, and before the - first command executes in a shell function (see SSHHEELLLL GGRRAAMMMMAARR - above). Refer to the description of the eexxttddeebbuugg option to the + If a _s_i_g_s_p_e_c is EEXXIITT (0) the command _a_r_g is executed on exit + from the shell. If a _s_i_g_s_p_e_c is DDEEBBUUGG, the command _a_r_g is exe- + cuted before every _s_i_m_p_l_e _c_o_m_m_a_n_d, _f_o_r command, _c_a_s_e command, + _s_e_l_e_c_t command, every arithmetic _f_o_r command, and before the + first command executes in a shell function (see SSHHEELLLL GGRRAAMMMMAARR + above). Refer to the description of the eexxttddeebbuugg option to the sshhoopptt builtin for details of its effect on the DDEEBBUUGG trap. If a _s_i_g_s_p_e_c is RREETTUURRNN, the command _a_r_g is executed each time a shell function or a script executed with the .. or ssoouurrccee builtins fin- @@ -1568,53 +1575,53 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS If a _s_i_g_s_p_e_c is EERRRR, the command _a_r_g is executed whenever a sim- ple 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 - command executed in a &&&& or |||| list, or if the command's return - value is being inverted via !!. These are the same conditions + 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 + command executed in a &&&& or |||| list, or if the command's return + value is being inverted via !!. These are the same conditions obeyed by the eerrrreexxiitt option. - Signals ignored upon entry to the shell cannot be trapped or - reset. Trapped signals that are not being ignored are reset to + Signals ignored upon entry to the shell cannot be trapped or + reset. Trapped signals that are not being ignored are reset to their original values in a subshell or subshell environment when - one is created. The return status is false if any _s_i_g_s_p_e_c is + one is created. The return status is false if any _s_i_g_s_p_e_c is invalid; otherwise ttrraapp returns true. ttyyppee [--aaffttppPP] _n_a_m_e [_n_a_m_e ...] - With no options, indicate how each _n_a_m_e would be interpreted if + With no options, indicate how each _n_a_m_e would be interpreted if used as a command name. If the --tt option is used, ttyyppee prints a - string which is one of _a_l_i_a_s, _k_e_y_w_o_r_d, _f_u_n_c_t_i_o_n, _b_u_i_l_t_i_n, or - _f_i_l_e if _n_a_m_e is an alias, shell reserved word, function, - builtin, or disk file, respectively. If the _n_a_m_e is not found, - then nothing is printed, and an exit status of false is - returned. If the --pp option is used, ttyyppee either returns the + string which is one of _a_l_i_a_s, _k_e_y_w_o_r_d, _f_u_n_c_t_i_o_n, _b_u_i_l_t_i_n, or + _f_i_l_e if _n_a_m_e is an alias, shell reserved word, function, + builtin, or disk file, respectively. If the _n_a_m_e is not found, + then nothing is printed, and an exit status of false is + returned. If the --pp option is used, ttyyppee either returns the name of the disk file that would be executed if _n_a_m_e were speci- fied as a command name, or nothing if ``type -t name'' would not - return _f_i_l_e. The --PP option forces a PPAATTHH search for each _n_a_m_e, + return _f_i_l_e. The --PP option forces a PPAATTHH search for each _n_a_m_e, even if ``type -t name'' would not return _f_i_l_e. If a command is hashed, --pp and --PP print the hashed value, which is not necessar- - ily the file that appears first in PPAATTHH. If the --aa option is - used, ttyyppee prints all of the places that contain an executable + ily the file that appears first in PPAATTHH. If the --aa option is + used, ttyyppee prints all of the places that contain an executable named _n_a_m_e. This includes aliases and functions, if and only if the --pp option is not also used. The table of hashed commands is - not consulted when using --aa. The --ff option suppresses shell + not consulted when using --aa. The --ff option suppresses shell function lookup, as with the ccoommmmaanndd builtin. ttyyppee returns true if all of the arguments are found, false if any are not found. uulliimmiitt [--HHSSTTaabbccddeeffiillmmnnppqqrrssttuuvvxx [_l_i_m_i_t]] - Provides control over the resources available to the shell and - to processes started by it, on systems that allow such control. + Provides control over the resources available to the shell and + to processes started by it, on systems that allow such control. The --HH and --SS options specify that the hard or soft limit is set - for the given resource. A hard limit cannot be increased by a - non-root user once it is set; a soft limit may be increased up - to the value of the hard limit. If neither --HH nor --SS is speci- + for the given resource. A hard limit cannot be increased by a + non-root user once it is set; a soft limit may be increased up + to the value of the hard limit. If neither --HH nor --SS is speci- fied, both the soft and hard limits are set. The value of _l_i_m_i_t can be a number in the unit specified for the resource or one of the special values hhaarrdd, ssoofftt, or uunnlliimmiitteedd, which stand for the - current hard limit, the current soft limit, and no limit, - respectively. If _l_i_m_i_t is omitted, the current value of the - soft limit of the resource is printed, unless the --HH option is + current hard limit, the current soft limit, and no limit, + respectively. If _l_i_m_i_t is omitted, the current value of the + soft limit of the resource is printed, unless the --HH option is given. When more than one resource is specified, the limit name and unit are printed before the value. Other options are inter- preted as follows: @@ -1623,11 +1630,11 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS --cc The maximum size of core files created --dd The maximum size of a process's data segment --ee The maximum scheduling priority ("nice") - --ff The maximum size of files written by the shell and its + --ff The maximum size of files written by the shell and its children --ii The maximum number of pending signals --ll The maximum size that may be locked into memory - --mm The maximum resident set size (many systems do not honor + --mm The maximum resident set size (many systems do not honor this limit) --nn The maximum number of open file descriptors (most systems do not allow this value to be set) @@ -1636,64 +1643,64 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS --rr The maximum real-time scheduling priority --ss The maximum stack size --tt The maximum amount of cpu time in seconds - --uu The maximum number of processes available to a single + --uu The maximum number of processes available to a single user - --vv The maximum amount of virtual memory available to the + --vv The maximum amount of virtual memory available to the shell and, on some systems, to its children --xx The maximum number of file locks --TT The maximum number of threads - If _l_i_m_i_t is given, and the --aa option is not used, _l_i_m_i_t is the - new value of the specified resource. If no option is given, - then --ff is assumed. Values are in 1024-byte increments, except - for --tt, which is in seconds; --pp, which is in units of 512-byte - blocks; and --TT, --bb, --nn, and --uu, which are unscaled values. The - return status is 0 unless an invalid option or argument is sup- + If _l_i_m_i_t is given, and the --aa option is not used, _l_i_m_i_t is the + new value of the specified resource. If no option is given, + then --ff is assumed. Values are in 1024-byte increments, except + for --tt, which is in seconds; --pp, which is in units of 512-byte + blocks; and --TT, --bb, --nn, and --uu, which are unscaled values. The + return status is 0 unless an invalid option or argument is sup- plied, or an error occurs while setting a new limit. uummaasskk [--pp] [--SS] [_m_o_d_e] The user file-creation mask is set to _m_o_d_e. If _m_o_d_e begins with - a digit, it is interpreted as an octal number; otherwise it is - interpreted as a symbolic mode mask similar to that accepted by - _c_h_m_o_d(1). If _m_o_d_e is omitted, the current value of the mask is - printed. The --SS option causes the mask to be printed in sym- - bolic form; the default output is an octal number. If the --pp + a digit, it is interpreted as an octal number; otherwise it is + interpreted as a symbolic mode mask similar to that accepted by + _c_h_m_o_d(1). If _m_o_d_e is omitted, the current value of the mask is + printed. The --SS option causes the mask to be printed in sym- + bolic form; the default output is an octal number. If the --pp option is supplied, and _m_o_d_e is omitted, the output is in a form that may be reused as input. The return status is 0 if the mode - was successfully changed or if no _m_o_d_e argument was supplied, + was successfully changed or if no _m_o_d_e argument was supplied, and false otherwise. uunnaalliiaass [-aa] [_n_a_m_e ...] - Remove each _n_a_m_e from the list of defined aliases. If --aa is - supplied, all alias definitions are removed. The return value + Remove each _n_a_m_e from the list of defined aliases. If --aa is + supplied, all alias definitions are removed. The return value is true unless a supplied _n_a_m_e is not a defined alias. uunnsseett [-ffvv] [-nn] [_n_a_m_e ...] - For each _n_a_m_e, remove the corresponding variable or function. + For each _n_a_m_e, remove the corresponding variable or function. If the --vv option is given, each _n_a_m_e refers to a shell variable, - and that variable is removed. Read-only variables may not be - unset. If --ff is specified, each _n_a_m_e refers to a shell func- - tion, and the function definition is removed. If the --nn option - is supplied, and _n_a_m_e is a variable with the _n_a_m_e_r_e_f attribute, - _n_a_m_e will be unset rather than the variable it references. --nn - has no effect if the --ff option is supplied. If no options are - supplied, each _n_a_m_e refers to a variable; if there is no vari- - able by that name, any function with that name is unset. Each - unset variable or function is removed from the environment - passed to subsequent commands. If any of CCOOMMPP__WWOORRDDBBRREEAAKKSS, RRAANN-- + and that variable is removed. Read-only variables may not be + unset. If --ff is specified, each _n_a_m_e refers to a shell func- + tion, and the function definition is removed. If the --nn option + is supplied, and _n_a_m_e is a variable with the _n_a_m_e_r_e_f attribute, + _n_a_m_e will be unset rather than the variable it references. --nn + has no effect if the --ff option is supplied. If no options are + supplied, each _n_a_m_e refers to a variable; if there is no vari- + able by that name, any function with that name is unset. Each + unset variable or function is removed from the environment + passed to subsequent commands. If any of CCOOMMPP__WWOORRDDBBRREEAAKKSS, RRAANN-- DDOOMM, SSEECCOONNDDSS, LLIINNEENNOO, HHIISSTTCCMMDD, FFUUNNCCNNAAMMEE, GGRROOUUPPSS, or DDIIRRSSTTAACCKK are unset, they lose their special properties, even if they are sub- sequently reset. The exit status is true unless a _n_a_m_e is read- only. 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. SSEEEE AALLSSOO diff --git a/doc/builtins.ps b/doc/builtins.ps index 9325009a..c1c4e33e 100644 --- a/doc/builtins.ps +++ b/doc/builtins.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.19.2 -%%CreationDate: Thu Jul 5 20:43:03 2012 +%%CreationDate: Mon Jul 16 16:12:25 2012 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic @@ -1911,816 +1911,829 @@ F1<ad65>3.612 E F0 -.1(wa)3.612 G 3.612(sb).1 G 1.113 -.4 F F3 .618(COMMAND EXE-)3.118 F .643(CUTION ENVIR)184 424.8 R(ONMENT) -.27 E F0(abo)2.893 E -.15(ve)-.15 G .643 (\), and may cause subshells to e).15 F .643(xit before e)-.15 F -.15 -(xe)-.15 G .642(cuting all).15 F(the commands in the subshell.)184 436.8 -Q F1<ad66>144 448.8 Q F0(Disable pathname e)30.97 E(xpansion.)-.15 E F1 -<ad68>144 460.8 Q F0 2.238(Remember the location of commands as the) +(xe)-.15 G .642(cuting all).15 F .015(the commands in the subshell.)184 +436.8 R .016(If a shell function e)5.015 F -.15(xe)-.15 G .016 +(cutes in a conte).15 F .016(xt where)-.15 F F1<ad65>2.516 E F0 .016 +(is being)2.516 F .348(ignored, e)184 448.8 R -.15(ve)-.25 G 2.848(ni) +.15 G(f)-2.848 E F1<ad65>2.848 E F0 .347(is set, none of the commands e) +2.848 F -.15(xe)-.15 G .347(cuted within the function body will).15 F +1.238(be af)184 460.8 R 1.238(fected by the)-.25 F F1<ad65>3.738 E F0 +3.738(setting. If)3.738 F 3.738(as)3.738 G 1.238(hell function sets) +-3.738 F F1<ad65>3.738 E F0 1.238(while e)3.738 F -.15(xe)-.15 G 1.239 +(cuting in a conte).15 F(xt)-.15 E(where)184 472.8 Q F1<ad65>3.154 E F0 +.654(is ignored, that setting will not ha)3.154 F .953 -.15(ve a)-.2 H +.953 -.15(ny e).15 H -.25(ff).15 G .653 +(ect until the command containing).25 F(the function call completes.)184 +484.8 Q F1<ad66>144 496.8 Q F0(Disable pathname e)30.97 E(xpansion.)-.15 +E F1<ad68>144 508.8 Q F0 2.238(Remember the location of commands as the) 28.74 F 4.738(ya)-.15 G 2.239(re look)-4.738 F 2.239(ed up for e)-.1 F -.15(xe)-.15 G 4.739(cution. This).15 F(is)4.739 E(enabled by def)184 -472.8 Q(ault.)-.1 E F1<ad6b>144 484.8 Q F0 .514(All ar)28.74 F .514 +520.8 Q(ault.)-.1 E F1<ad6b>144 532.8 Q F0 .514(All ar)28.74 F .514 (guments in the form of assignment statements are placed in the en)-.18 F .513(vironment for a)-.4 F -(command, not just those that precede the command name.)184 496.8 Q F1 -<ad6d>144 508.8 Q F0 .148(Monitor mode.)25.97 F .148 +(command, not just those that precede the command name.)184 544.8 Q F1 +<ad6d>144 556.8 Q F0 .148(Monitor mode.)25.97 F .148 (Job control is enabled.)5.148 F .149(This option is on by def)5.148 F .149(ault for interacti)-.1 F .449 -.15(ve s)-.25 H(hells).15 E .651 -(on systems that support it \(see)184 520.8 R F3 .651(JOB CONTR)3.151 F +(on systems that support it \(see)184 568.8 R F3 .651(JOB CONTR)3.151 F (OL)-.27 E F0(abo)2.901 E -.15(ve)-.15 G 3.151(\). All).15 F .65 -(processes run in a separate)3.151 F .678(process group.)184 532.8 R +(processes run in a separate)3.151 F .678(process group.)184 580.8 R .679(When a background job completes, the shell prints a line containin\ -g its)5.678 F -.15(ex)184 544.8 S(it status.).15 E F1<ad6e>144 556.8 Q +g its)5.678 F -.15(ex)184 592.8 S(it status.).15 E F1<ad6e>144 604.8 Q F0 .653(Read commands b)28.74 F .653(ut do not e)-.2 F -.15(xe)-.15 G .653(cute them.).15 F .652(This may be used to check a shell script for) -5.653 F(syntax errors.)184 568.8 Q(This is ignored by interacti)5 E .3 --.15(ve s)-.25 H(hells.).15 E F1<ad6f>144 580.8 Q F2(option\255name)2.5 -E F0(The)184 592.8 Q F2(option\255name)2.5 E F0(can be one of the follo) -2.5 E(wing:)-.25 E F1(allexport)184 604.8 Q F0(Same as)224 616.8 Q F1 -<ad61>2.5 E F0(.)A F1(braceexpand)184 628.8 Q F0(Same as)224 640.8 Q F1 -<ad42>2.5 E F0(.)A F1(emacs)184 652.8 Q F0 .089 +5.653 F(syntax errors.)184 616.8 Q(This is ignored by interacti)5 E .3 +-.15(ve s)-.25 H(hells.).15 E F1<ad6f>144 628.8 Q F2(option\255name)2.5 +E F0(The)184 640.8 Q F2(option\255name)2.5 E F0(can be one of the follo) +2.5 E(wing:)-.25 E F1(allexport)184 652.8 Q F0(Same as)224 664.8 Q F1 +<ad61>2.5 E F0(.)A F1(braceexpand)184 676.8 Q F0(Same as)224 688.8 Q F1 +<ad42>2.5 E F0(.)A F1(emacs)184 700.8 Q F0 .089 (Use an emacs-style command line editing interf)13.9 F 2.589(ace. This) -.1 F .089(is enabled by def)2.589 F(ault)-.1 E .95 -(when the shell is interacti)224 664.8 R -.15(ve)-.25 G 3.45(,u).15 G +(when the shell is interacti)224 712.8 R -.15(ve)-.25 G 3.45(,u).15 G .95(nless the shell is started with the)-3.45 F F1(\255\255noediting) -3.45 E F0 2.5(option. This)224 676.8 R(also af)2.5 E +3.45 E F0 2.5(option. This)224 724.8 R(also af)2.5 E (fects the editing interf)-.25 E(ace used for)-.1 E F1 -.18(re)2.5 G -(ad \255e).18 E F0(.)A F1(err)184 688.8 Q(exit)-.18 E F0(Same as)11.31 E -F1<ad65>2.5 E F0(.)A F1(errtrace)184 700.8 Q F0(Same as)5.03 E F1<ad45> -2.5 E F0(.)A(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(14)198.725 E 0 -Cg EP +(ad \255e).18 E F0(.)A(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(14) +198.725 E 0 Cg EP %%Page: 15 15 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10 -/Times-Bold@0 SF(functrace)184 84 Q F0(Same as)224 96 Q F1<ad54>2.5 E F0 -(.)A F1(hashall)184 108 Q F0(Same as)9.43 E F1<ad68>2.5 E F0(.)A F1 -(histexpand)184 120 Q F0(Same as)224 132 Q F1<ad48>2.5 E F0(.)A F1 -(history)184 144 Q F0 .586(Enable command history)10 F 3.087(,a)-.65 G -3.087(sd)-3.087 G .587(escribed abo)-3.087 F .887 -.15(ve u)-.15 H(nder) -.15 E/F2 9/Times-Bold@0 SF(HIST)3.087 E(OR)-.162 E(Y)-.315 E/F3 9 -/Times-Roman@0 SF(.)A F0 .587(This option is)5.087 F(on by def)224 156 Q +/Times-Bold@0 SF(err)184 84 Q(exit)-.18 E F0(Same as)11.31 E F1<ad65>2.5 +E F0(.)A F1(errtrace)184 96 Q F0(Same as)5.03 E F1<ad45>2.5 E F0(.)A F1 +(functrace)184 108 Q F0(Same as)224 120 Q F1<ad54>2.5 E F0(.)A F1 +(hashall)184 132 Q F0(Same as)9.43 E F1<ad68>2.5 E F0(.)A F1(histexpand) +184 144 Q F0(Same as)224 156 Q F1<ad48>2.5 E F0(.)A F1(history)184 168 Q +F0 .586(Enable command history)10 F 3.087(,a)-.65 G 3.087(sd)-3.087 G +.587(escribed abo)-3.087 F .887 -.15(ve u)-.15 H(nder).15 E/F2 9 +/Times-Bold@0 SF(HIST)3.087 E(OR)-.162 E(Y)-.315 E/F3 9/Times-Roman@0 SF +(.)A F0 .587(This option is)5.087 F(on by def)224 180 Q (ault in interacti)-.1 E .3 -.15(ve s)-.25 H(hells.).15 E F1(ignor)184 -168 Q(eeof)-.18 E F0 1.657(The ef)224 180 R 1.657 +192 Q(eeof)-.18 E F0 1.657(The ef)224 204 R 1.657 (fect is as if the shell command)-.25 F/F4 10/Courier@0 SF(IGNOREEOF=10) 4.156 E F0 1.656(had been e)4.156 F -.15(xe)-.15 G(cuted).15 E(\(see)224 -192 Q F1(Shell V)2.5 E(ariables)-.92 E F0(abo)2.5 E -.15(ve)-.15 G(\).) -.15 E F1 -.1(ke)184 204 S(yw).1 E(ord)-.1 E F0(Same as)224 216 Q F1 -<ad6b>2.5 E F0(.)A F1(monitor)184 228 Q F0(Same as)5.56 E F1<ad6d>2.5 E -F0(.)A F1(noclob)184 240 Q(ber)-.1 E F0(Same as)224 252 Q F1<ad43>2.5 E -F0(.)A F1(noexec)184 264 Q F0(Same as)11.12 E F1<ad6e>2.5 E F0(.)A F1 -(noglob)184 276 Q F0(Same as)11.1 E F1<ad66>2.5 E F0(.)A F1(nolog)184 -288 Q F0(Currently ignored.)16.66 E F1(notify)184 300 Q F0(Same as)15 E -F1<ad62>2.5 E F0(.)A F1(nounset)184 312 Q F0(Same as)6.66 E F1<ad75>2.5 -E F0(.)A F1(onecmd)184 324 Q F0(Same as)6.67 E F1<ad74>2.5 E F0(.)A F1 -(ph)184 336 Q(ysical)-.15 E F0(Same as)5.14 E F1<ad50>2.5 E F0(.)A F1 -(pipefail)184 348 Q F0 1.029(If set, the return v)7.77 F 1.029 +216 Q F1(Shell V)2.5 E(ariables)-.92 E F0(abo)2.5 E -.15(ve)-.15 G(\).) +.15 E F1 -.1(ke)184 228 S(yw).1 E(ord)-.1 E F0(Same as)224 240 Q F1 +<ad6b>2.5 E F0(.)A F1(monitor)184 252 Q F0(Same as)5.56 E F1<ad6d>2.5 E +F0(.)A F1(noclob)184 264 Q(ber)-.1 E F0(Same as)224 276 Q F1<ad43>2.5 E +F0(.)A F1(noexec)184 288 Q F0(Same as)11.12 E F1<ad6e>2.5 E F0(.)A F1 +(noglob)184 300 Q F0(Same as)11.1 E F1<ad66>2.5 E F0(.)A F1(nolog)184 +312 Q F0(Currently ignored.)16.66 E F1(notify)184 324 Q F0(Same as)15 E +F1<ad62>2.5 E F0(.)A F1(nounset)184 336 Q F0(Same as)6.66 E F1<ad75>2.5 +E F0(.)A F1(onecmd)184 348 Q F0(Same as)6.67 E F1<ad74>2.5 E F0(.)A F1 +(ph)184 360 Q(ysical)-.15 E F0(Same as)5.14 E F1<ad50>2.5 E F0(.)A F1 +(pipefail)184 372 Q F0 1.029(If set, the return v)7.77 F 1.029 (alue of a pipeline is the v)-.25 F 1.03 -(alue of the last \(rightmost\) com-)-.25 F 1.137(mand to e)224 360 R +(alue of the last \(rightmost\) com-)-.25 F 1.137(mand to e)224 384 R 1.136 (xit with a non-zero status, or zero if all commands in the pipeline) --.15 F -.15(ex)224 372 S(it successfully).15 E 5(.T)-.65 G -(his option is disabled by def)-5 E(ault.)-.1 E F1(posix)184 384 Q F0 +-.15 F -.15(ex)224 396 S(it successfully).15 E 5(.T)-.65 G +(his option is disabled by def)-5 E(ault.)-.1 E F1(posix)184 408 Q F0 2.09(Change the beha)17.77 F 2.091(vior of)-.2 F F1(bash)4.591 E F0 2.091(where the def)4.591 F 2.091(ault operation dif)-.1 F 2.091 -(fers from the)-.25 F(POSIX standard to match the standard \()224 396 Q -/F5 10/Times-Italic@0 SF(posix mode)A F0(\).)A F1(pri)184 408 Q(vileged) --.1 E F0(Same as)224 420 Q F1<ad70>2.5 E F0(.)A F1 -.1(ve)184 432 S -(rbose).1 E F0(Same as)7.33 E F1<ad76>2.5 E F0(.)A F1(vi)184 444 Q F0 +(fers from the)-.25 F(POSIX standard to match the standard \()224 420 Q +/F5 10/Times-Italic@0 SF(posix mode)A F0(\).)A F1(pri)184 432 Q(vileged) +-.1 E F0(Same as)224 444 Q F1<ad70>2.5 E F0(.)A F1 -.1(ve)184 456 S +(rbose).1 E F0(Same as)7.33 E F1<ad76>2.5 E F0(.)A F1(vi)184 468 Q F0 1.466(Use a vi-style command line editing interf)32.22 F 3.965 (ace. This)-.1 F 1.465(also af)3.965 F 1.465(fects the editing)-.25 F -(interf)224 456 Q(ace used for)-.1 E F1 -.18(re)2.5 G(ad \255e).18 E F0 -(.)A F1(xtrace)184 468 Q F0(Same as)13.35 E F1<ad78>2.5 E F0(.)A(If)184 -486 Q F1<ad6f>3.052 E F0 .552(is supplied with no)3.052 F F5 +(interf)224 480 Q(ace used for)-.1 E F1 -.18(re)2.5 G(ad \255e).18 E F0 +(.)A F1(xtrace)184 492 Q F0(Same as)13.35 E F1<ad78>2.5 E F0(.)A(If)184 +510 Q F1<ad6f>3.052 E F0 .552(is supplied with no)3.052 F F5 (option\255name)3.053 E F0 3.053(,t)C .553(he v)-3.053 F .553 (alues of the current options are printed.)-.25 F(If)5.553 E F1(+o)184 -498 Q F0 1.072(is supplied with no)3.572 F F5(option\255name)3.572 E F0 +522 Q F0 1.072(is supplied with no)3.572 F F5(option\255name)3.572 E F0 3.572(,a)C 1.071(series of)-.001 F F1(set)3.571 E F0 1.071 (commands to recreate the current)3.571 F -(option settings is displayed on the standard output.)184 510 Q F1<ad70> -144 522 Q F0 -.45(Tu)28.74 G 1.071(rn on).45 F F5(privile)4.821 E -.1 +(option settings is displayed on the standard output.)184 534 Q F1<ad70> +144 546 Q F0 -.45(Tu)28.74 G 1.071(rn on).45 F F5(privile)4.821 E -.1 (ge)-.4 G(d).1 E F0 3.572(mode. In)4.341 F 1.072(this mode, the)3.572 F F2($ENV)3.572 E F0(and)3.322 E F2($B)3.572 E(ASH_ENV)-.27 E F0 1.072 (\214les are not pro-)3.322 F 1.501 -(cessed, shell functions are not inherited from the en)184 534 R 1.5 -(vironment, and the)-.4 F F2(SHELLOPTS)4 E F3(,)A F2 -.27(BA)184 546 S +(cessed, shell functions are not inherited from the en)184 558 R 1.5 +(vironment, and the)-.4 F F2(SHELLOPTS)4 E F3(,)A F2 -.27(BA)184 570 S (SHOPTS).27 E F3(,)A F2(CDP)2.774 E -.855(AT)-.666 G(H).855 E F3(,)A F0 (and)2.774 E F2(GLOBIGNORE)3.024 E F0 -.25(va)2.774 G .524 (riables, if the).25 F 3.025(ya)-.15 G .525(ppear in the en)-3.025 F -(vironment,)-.4 E .38(are ignored.)184 558 R .38 +(vironment,)-.4 E .38(are ignored.)184 582 R .38 (If the shell is started with the ef)5.38 F(fecti)-.25 E .679 -.15(ve u) -.25 H .379(ser \(group\) id not equal to the real).15 F .461 -(user \(group\) id, and the)184 570 R F1<ad70>2.961 E F0 .461 +(user \(group\) id, and the)184 594 R F1<ad70>2.961 E F0 .461 (option is not supplied, these actions are tak)2.961 F .462 -(en and the ef)-.1 F(fec-)-.25 E(ti)184 582 Q .695 -.15(ve u)-.25 H .395 +(en and the ef)-.1 F(fec-)-.25 E(ti)184 606 Q .695 -.15(ve u)-.25 H .395 (ser id is set to the real user id.).15 F .395(If the)5.395 F F1<ad70> 2.895 E F0 .394(option is supplied at startup, the ef)2.895 F(fecti)-.25 -E -.15(ve)-.25 G .386(user id is not reset.)184 594 R -.45(Tu)5.386 G +E -.15(ve)-.25 G .386(user id is not reset.)184 618 R -.45(Tu)5.386 G .386(rning this option of).45 F 2.886(fc)-.25 G .387(auses the ef)-2.886 F(fecti)-.25 E .687 -.15(ve u)-.25 H .387(ser and group ids to be).15 F -(set to the real user and group ids.)184 606 Q F1<ad74>144 618 Q F0 +(set to the real user and group ids.)184 630 Q F1<ad74>144 642 Q F0 (Exit after reading and e)30.97 E -.15(xe)-.15 G(cuting one command.).15 -E F1<ad75>144 630 Q F0 -.35(Tr)28.74 G .044(eat unset v).35 F .044(aria\ +E F1<ad75>144 654 Q F0 -.35(Tr)28.74 G .044(eat unset v).35 F .044(aria\ bles and parameters other than the special parameters "@" and "*" as an) --.25 F .182(error when performing parameter e)184 642 R 2.682 +-.25 F .182(error when performing parameter e)184 666 R 2.682 (xpansion. If)-.15 F -.15(ex)2.682 G .183 (pansion is attempted on an unset v).15 F(ari-)-.25 E .746 -(able or parameter)184 654 R 3.246(,t)-.4 G .746 +(able or parameter)184 678 R 3.246(,t)-.4 G .746 (he shell prints an error message, and, if not interacti)-3.246 F -.15 (ve)-.25 G 3.246(,e).15 G .746(xits with a)-3.396 F(non-zero status.)184 -666 Q F1<ad76>144 678 Q F0(Print shell input lines as the)29.3 E 2.5(ya) --.15 G(re read.)-2.5 E F1<ad78>144 690 Q F0 .315(After e)29.3 F .315 +690 Q F1<ad76>144 702 Q F0(Print shell input lines as the)29.3 E 2.5(ya) +-.15 G(re read.)-2.5 E F1<ad78>144 714 Q F0 .315(After e)29.3 F .315 (xpanding each)-.15 F F5 .315(simple command)2.815 F F0(,)A F1 -.25(fo) 2.815 G(r).25 E F0(command,)2.815 E F1(case)2.815 E F0(command,)2.815 E -F1(select)2.815 E F0(command,)2.815 E 1.236(or arithmetic)184 702 R F1 --.25(fo)3.736 G(r).25 E F0 1.236(command, display the e)3.736 F 1.236 -(xpanded v)-.15 F 1.236(alue of)-.25 F F2(PS4)3.736 E F3(,)A F0(follo) -3.486 E 1.236(wed by the com-)-.25 F(mand and its e)184 714 Q -(xpanded ar)-.15 E(guments or associated w)-.18 E(ord list.)-.1 E -(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(15)198.725 E 0 Cg EP +F1(select)2.815 E F0(command,)2.815 E 3.26(or arithmetic)184 726 R F1 +-.25(fo)5.76 G(r).25 E F0 3.26(command, display the e)5.76 F 3.26 +(xpanded v)-.15 F 3.26(alue of)-.25 F F2(PS4)5.76 E F3(,)A F0(follo) +5.509 E 3.259(wed by the)-.25 F(GNU Bash-4.2)72 768 Q(2004 Apr 20) +148.735 E(15)198.725 E 0 Cg EP %%Page: 16 16 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48 -(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10 -/Times-Bold@0 SF<ad42>144 84 Q F0 2.578(The shell performs brace e)27.63 -F 2.578(xpansion \(see)-.15 F F1 2.578(Brace Expansion)5.078 F F0(abo) -5.078 E -.15(ve)-.15 G 5.079(\). This).15 F 2.579(is on by)5.079 F(def) -184 96 Q(ault.)-.1 E F1<ad43>144 108 Q F0 .214(If set,)27.08 F F1(bash) -2.714 E F0 .214(does not o)2.714 F -.15(ve)-.15 G .214(rwrite an e).15 F -.214(xisting \214le with the)-.15 F F1(>)2.714 E F0(,)A F1(>&)2.714 E F0 -2.713(,a)C(nd)-2.713 E F1(<>)2.713 E F0 .213(redirection opera-)2.713 F -3.053(tors. This)184 120 R .553(may be o)3.053 F -.15(ve)-.15 G .553 +(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E +(command and its e)184 84 Q(xpanded ar)-.15 E(guments or associated w) +-.18 E(ord list.)-.1 E/F1 10/Times-Bold@0 SF<ad42>144 96 Q F0 2.578 +(The shell performs brace e)27.63 F 2.578(xpansion \(see)-.15 F F1 2.578 +(Brace Expansion)5.078 F F0(abo)5.078 E -.15(ve)-.15 G 5.079(\). This) +.15 F 2.579(is on by)5.079 F(def)184 108 Q(ault.)-.1 E F1<ad43>144 120 Q +F0 .214(If set,)27.08 F F1(bash)2.714 E F0 .214(does not o)2.714 F -.15 +(ve)-.15 G .214(rwrite an e).15 F .214(xisting \214le with the)-.15 F F1 +(>)2.714 E F0(,)A F1(>&)2.714 E F0 2.713(,a)C(nd)-2.713 E F1(<>)2.713 E +F0 .213(redirection opera-)2.713 F 3.053(tors. This)184 132 R .553 +(may be o)3.053 F -.15(ve)-.15 G .553 (rridden when creating output \214les by using the redirection opera-) -.15 F(tor)184 132 Q F1(>|)2.5 E F0(instead of)2.5 E F1(>)2.5 E F0(.)A F1 -<ad45>144 144 Q F0 .104(If set, an)27.63 F 2.604(yt)-.15 G .104(rap on) +.15 F(tor)184 144 Q F1(>|)2.5 E F0(instead of)2.5 E F1(>)2.5 E F0(.)A F1 +<ad45>144 156 Q F0 .104(If set, an)27.63 F 2.604(yt)-.15 G .104(rap on) -2.604 F F1(ERR)2.604 E F0 .103 (is inherited by shell functions, command substitutions, and com-)2.604 -F .838(mands e)184 156 R -.15(xe)-.15 G .838(cuted in a subshell en).15 +F .838(mands e)184 168 R -.15(xe)-.15 G .838(cuted in a subshell en).15 F 3.338(vironment. The)-.4 F F1(ERR)3.338 E F0 .839 -(trap is normally not inherited in)3.339 F(such cases.)184 168 Q F1 -<ad48>144 180 Q F0(Enable)26.52 E F1(!)3.032 E F0 .532 +(trap is normally not inherited in)3.339 F(such cases.)184 180 Q F1 +<ad48>144 192 Q F0(Enable)26.52 E F1(!)3.032 E F0 .532 (style history substitution.)5.532 F .531(This option is on by def)5.532 -F .531(ault when the shell is inter)-.1 F(-)-.2 E(acti)184 192 Q -.15 -(ve)-.25 G(.).15 E F1<ad50>144 204 Q F0 .959 +F .531(ault when the shell is inter)-.1 F(-)-.2 E(acti)184 204 Q -.15 +(ve)-.25 G(.).15 E F1<ad50>144 216 Q F0 .959 (If set, the shell does not resolv)28.19 F 3.459(es)-.15 G .959 (ymbolic links when e)-3.459 F -.15(xe)-.15 G .96 (cuting commands such as).15 F F1(cd)3.46 E F0 2.822 -(that change the current w)184 216 R 2.822(orking directory)-.1 F 7.822 +(that change the current w)184 228 R 2.822(orking directory)-.1 F 7.822 (.I)-.65 G 5.322(tu)-7.822 G 2.822(ses the ph)-5.322 F 2.821 -(ysical directory structure)-.05 F 2.685(instead. By)184 228 R(def)2.685 +(ysical directory structure)-.05 F 2.685(instead. By)184 240 R(def)2.685 E(ault,)-.1 E F1(bash)2.686 E F0(follo)2.686 E .186 (ws the logical chain of directories when performing com-)-.25 F -(mands which change the current directory)184 240 Q(.)-.65 E F1<ad54>144 -252 Q F0 .89(If set, an)27.63 F 3.39(yt)-.15 G .89(raps on)-3.39 F F1 +(mands which change the current directory)184 252 Q(.)-.65 E F1<ad54>144 +264 Q F0 .89(If set, an)27.63 F 3.39(yt)-.15 G .89(raps on)-3.39 F F1 (DEB)3.39 E(UG)-.1 E F0(and)3.39 E F1(RETURN)3.39 E F0 .89 (are inherited by shell functions, command)3.39 F 1.932 -(substitutions, and commands e)184 264 R -.15(xe)-.15 G 1.932 +(substitutions, and commands e)184 276 R -.15(xe)-.15 G 1.932 (cuted in a subshell en).15 F 4.432(vironment. The)-.4 F F1(DEB)4.432 E -(UG)-.1 E F0(and)4.432 E F1(RETURN)184 276 Q F0 -(traps are normally not inherited in such cases.)2.5 E F1<adad>144 288 Q +(UG)-.1 E F0(and)4.432 E F1(RETURN)184 288 Q F0 +(traps are normally not inherited in such cases.)2.5 E F1<adad>144 300 Q F0 .401(If no ar)28.6 F .401(guments follo)-.18 F 2.901(wt)-.25 G .401 (his option, then the positional parameters are unset.)-2.901 F -(Otherwise,)5.4 E(the positional parameters are set to the)184 300 Q/F2 +(Otherwise,)5.4 E(the positional parameters are set to the)184 312 Q/F2 10/Times-Italic@0 SF(ar)2.5 E(g)-.37 E F0(s, e)A -.15(ve)-.25 G 2.5(ni) .15 G 2.5(fs)-2.5 G(ome of them be)-2.5 E(gin with a)-.15 E F1<ad>2.5 E -F0(.)A F1<ad>144 312 Q F0 1.944 +F0(.)A F1<ad>144 324 Q F0 1.944 (Signal the end of options, cause all remaining)34.3 F F2(ar)4.444 E(g) -.37 E F0 4.444(st)C 4.444(ob)-4.444 G 4.445(ea)-4.444 G 1.945 -(ssigned to the positional)-4.445 F 3.446(parameters. The)184 324 R F1 +(ssigned to the positional)-4.445 F 3.446(parameters. The)184 336 R F1 <ad78>3.446 E F0(and)3.446 E F1<ad76>3.446 E F0 .945 (options are turned of)3.446 F 3.445(f. If)-.25 F .945(there are no) 3.445 F F2(ar)3.445 E(g)-.37 E F0 .945(s, the positional)B -(parameters remain unchanged.)184 336 Q .425(The options are of)144 -352.8 R 2.925(fb)-.25 G 2.925(yd)-2.925 G(ef)-2.925 E .425 +(parameters remain unchanged.)184 348 Q .425(The options are of)144 +364.8 R 2.925(fb)-.25 G 2.925(yd)-2.925 G(ef)-2.925 E .425 (ault unless otherwise noted.)-.1 F .425 (Using + rather than \255 causes these options)5.425 F .178 -(to be turned of)144 364.8 R 2.678(f. The)-.25 F .178 +(to be turned of)144 376.8 R 2.678(f. The)-.25 F .178 (options can also be speci\214ed as ar)2.678 F .178(guments to an in) -.18 F -.2(vo)-.4 G .177(cation of the shell.).2 F(The)5.177 E .066 -(current set of options may be found in)144 376.8 R F1<24ad>2.566 E F0 +(current set of options may be found in)144 388.8 R F1<24ad>2.566 E F0 5.066(.T)C .066(he return status is al)-5.066 F -.1(wa)-.1 G .066 (ys true unless an in).1 F -.25(va)-.4 G .067(lid option).25 F -(is encountered.)144 388.8 Q F1(shift)108 405.6 Q F0([)2.5 E F2(n)A F0 -(])A .429(The positional parameters from)144 417.6 R F2(n)2.929 E F0 +(is encountered.)144 400.8 Q F1(shift)108 417.6 Q F0([)2.5 E F2(n)A F0 +(])A .429(The positional parameters from)144 429.6 R F2(n)2.929 E F0 .429(+1 ... are renamed to)B F1 .429($1 ....)2.929 F F0 -.15(Pa)5.428 G -.428(rameters represented by the num-).15 F(bers)144 429.6 Q F1($#)2.582 +.428(rameters represented by the num-).15 F(bers)144 441.6 Q F1($#)2.582 E F0(do)2.582 E .082(wn to)-.25 F F1($#)2.582 E F0<ad>A F2(n)A F0 .082 (+1 are unset.)B F2(n)5.442 E F0 .082(must be a non-ne)2.822 F -.05(ga) -.15 G(ti).05 E .383 -.15(ve n)-.25 H .083(umber less than or equal to) .15 F F1($#)2.583 E F0 5.083(.I)C(f)-5.083 E F2(n)2.943 E F0 .06 -(is 0, no parameters are changed.)144 441.6 R(If)5.06 E F2(n)2.92 E F0 +(is 0, no parameters are changed.)144 453.6 R(If)5.06 E F2(n)2.92 E F0 .06(is not gi)2.8 F -.15(ve)-.25 G .06(n, it is assumed to be 1.).15 F (If)5.06 E F2(n)2.92 E F0 .06(is greater than)2.8 F F1($#)2.56 E F0 2.56 -(,t)C(he)-2.56 E .143(positional parameters are not changed.)144 453.6 R +(,t)C(he)-2.56 E .143(positional parameters are not changed.)144 465.6 R .144(The return status is greater than zero if)5.143 F F2(n)3.004 E F0 .144(is greater than)2.884 F F1($#)2.644 E F0 -(or less than zero; otherwise 0.)144 465.6 Q F1(shopt)108 482.4 Q F0([) +(or less than zero; otherwise 0.)144 477.6 Q F1(shopt)108 494.4 Q F0([) 2.5 E F1(\255pqsu)A F0 2.5(][)C F1<ad6f>-2.5 E F0 2.5(][)C F2(optname) --2.5 E F0(...])2.5 E -.8(To)144 494.4 S .222(ggle the v).8 F .222 +-2.5 E F0(...])2.5 E -.8(To)144 506.4 S .222(ggle the v).8 F .222 (alues of v)-.25 F .222(ariables controlling optional shell beha)-.25 F (vior)-.2 E 5.222(.W)-.55 G .222(ith no options, or with the)-5.622 F F1 <ad70>2.722 E F0 .721(option, a list of all settable options is display\ -ed, with an indication of whether or not each is set.)144 506.4 R(The) -144 518.4 Q F1<ad70>2.828 E F0 .327(option causes output to be displaye\ +ed, with an indication of whether or not each is set.)144 518.4 R(The) +144 530.4 Q F1<ad70>2.828 E F0 .327(option causes output to be displaye\ d in a form that may be reused as input.)2.828 F .327(Other options) -5.327 F(ha)144 530.4 Q .3 -.15(ve t)-.2 H(he follo).15 E(wing meanings:) --.25 E F1<ad73>144 542.4 Q F0(Enable \(set\) each)26.41 E F2(optname)2.5 -E F0(.)A F1<ad75>144 554.4 Q F0(Disable \(unset\) each)24.74 E F2 -(optname)2.5 E F0(.)A F1<ad71>144 566.4 Q F0 .003(Suppresses normal out\ +5.327 F(ha)144 542.4 Q .3 -.15(ve t)-.2 H(he follo).15 E(wing meanings:) +-.25 E F1<ad73>144 554.4 Q F0(Enable \(set\) each)26.41 E F2(optname)2.5 +E F0(.)A F1<ad75>144 566.4 Q F0(Disable \(unset\) each)24.74 E F2 +(optname)2.5 E F0(.)A F1<ad71>144 578.4 Q F0 .003(Suppresses normal out\ put \(quiet mode\); the return status indicates whether the)24.74 F F2 -(optname)2.504 E F0(is)2.504 E .256(set or unset.)180 578.4 R .256 +(optname)2.504 E F0(is)2.504 E .256(set or unset.)180 590.4 R .256 (If multiple)5.256 F F2(optname)2.756 E F0(ar)2.756 E .256 (guments are gi)-.18 F -.15(ve)-.25 G 2.756(nw).15 G(ith)-2.756 E F1 <ad71>2.756 E F0 2.755(,t)C .255(he return status is zero if)-2.755 F -(all)180 590.4 Q F2(optnames)2.5 E F0(are enabled; non-zero otherwise.) -2.5 E F1<ad6f>144 602.4 Q F0(Restricts the v)25.3 E(alues of)-.25 E F2 +(all)180 602.4 Q F2(optnames)2.5 E F0(are enabled; non-zero otherwise.) +2.5 E F1<ad6f>144 614.4 Q F0(Restricts the v)25.3 E(alues of)-.25 E F2 (optname)2.5 E F0(to be those de\214ned for the)2.5 E F1<ad6f>2.5 E F0 (option to the)2.5 E F1(set)2.5 E F0 -.2(bu)2.5 G(iltin.).2 E .624 -(If either)144 619.2 R F1<ad73>3.124 E F0(or)3.124 E F1<ad75>3.124 E F0 +(If either)144 631.2 R F1<ad73>3.124 E F0(or)3.124 E F1<ad75>3.124 E F0 .624(is used with no)3.124 F F2(optname)3.124 E F0(ar)3.124 E(guments,) -.18 E F1(shopt)3.124 E F0(sho)3.124 E .624 (ws only those options which are)-.25 F 2.234(set or unset, respecti)144 -631.2 R -.15(ve)-.25 G(ly).15 E 7.234(.U)-.65 G 2.234 +643.2 R -.15(ve)-.25 G(ly).15 E 7.234(.U)-.65 G 2.234 (nless otherwise noted, the)-7.234 F F1(shopt)4.734 E F0 2.234 -(options are disabled \(unset\) by)4.734 F(def)144 643.2 Q(ault.)-.1 E -1.544(The return status when listing options is zero if all)144 660 R F2 +(options are disabled \(unset\) by)4.734 F(def)144 655.2 Q(ault.)-.1 E +1.544(The return status when listing options is zero if all)144 672 R F2 (optnames)4.044 E F0 1.545(are enabled, non-zero otherwise.)4.045 F .696 (When setting or unsetting options, the return status is zero unless an) -144 672 R F2(optname)3.196 E F0 .696(is not a v)3.196 F .695(alid shell) --.25 F(option.)144 684 Q(The list of)144 700.8 Q F1(shopt)2.5 E F0 -(options is:)2.5 E F1(autocd)144 718.8 Q F0 .199 -(If set, a command name that is the name of a directory is e)11.11 F --.15(xe)-.15 G .2(cuted as if it were the ar).15 F(gu-)-.18 E -(ment to the)184 730.8 Q F1(cd)2.5 E F0 2.5(command. This)2.5 F -(option is only used by interacti)2.5 E .3 -.15(ve s)-.25 H(hells.).15 E -(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(16)198.725 E 0 Cg EP +144 684 R F2(optname)3.196 E F0 .696(is not a v)3.196 F .695(alid shell) +-.25 F(option.)144 696 Q(The list of)144 712.8 Q F1(shopt)2.5 E F0 +(options is:)2.5 E(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(16) +198.725 E 0 Cg EP %%Page: 17 17 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10 -/Times-Bold@0 SF(cdable_v)144 84 Q(ars)-.1 E F0 .156(If set, an ar)184 -96 R .156(gument to the)-.18 F F1(cd)2.656 E F0 -.2(bu)2.656 G .155 +/Times-Bold@0 SF(autocd)144 84 Q F0 .199 +(If set, a command name that is the name of a directory is e)11.11 F +-.15(xe)-.15 G .2(cuted as if it were the ar).15 F(gu-)-.18 E +(ment to the)184 96 Q F1(cd)2.5 E F0 2.5(command. This)2.5 F +(option is only used by interacti)2.5 E .3 -.15(ve s)-.25 H(hells.).15 E +F1(cdable_v)144 108 Q(ars)-.1 E F0 .156(If set, an ar)184 120 R .156 +(gument to the)-.18 F F1(cd)2.656 E F0 -.2(bu)2.656 G .155 (iltin command that is not a directory is assumed to be the).2 F -(name of a v)184 108 Q(ariable whose v)-.25 E -(alue is the directory to change to.)-.25 E F1(cdspell)144 120 Q F0 +(name of a v)184 132 Q(ariable whose v)-.25 E +(alue is the directory to change to.)-.25 E F1(cdspell)144 144 Q F0 1.055 (If set, minor errors in the spelling of a directory component in a) 10.55 F F1(cd)3.555 E F0 1.055(command will be)3.555 F 3.988 -(corrected. The)184 132 R 1.488(errors check)3.988 F 1.487 +(corrected. The)184 156 R 1.488(errors check)3.988 F 1.487 (ed for are transposed characters, a missing character)-.1 F 3.987(,a) --.4 G(nd)-3.987 E .77(one character too man)184 144 R 4.57 -.65(y. I) +-.4 G(nd)-3.987 E .77(one character too man)184 168 R 4.57 -.65(y. I) -.15 H 3.27(fac).65 G .77 (orrection is found, the corrected \214lename is printed, and)-3.27 F -(the command proceeds.)184 156 Q(This option is only used by interacti)5 -E .3 -.15(ve s)-.25 H(hells.).15 E F1(checkhash)144 168 Q F0 2.08 -(If set,)184 180 R F1(bash)4.58 E F0 2.079 +(the command proceeds.)184 180 Q(This option is only used by interacti)5 +E .3 -.15(ve s)-.25 H(hells.).15 E F1(checkhash)144 192 Q F0 2.08 +(If set,)184 204 R F1(bash)4.58 E F0 2.079 (checks that a command found in the hash table e)4.58 F 2.079 -(xists before trying to)-.15 F -.15(exe)184 192 S(cute it.).15 E +(xists before trying to)-.15 F -.15(exe)184 216 S(cute it.).15 E (If a hashed command no longer e)5 E -(xists, a normal path search is performed.)-.15 E F1(checkjobs)144 204 Q -F0 .448(If set,)184 216 R F1(bash)2.948 E F0 .448 +(xists, a normal path search is performed.)-.15 E F1(checkjobs)144 228 Q +F0 .448(If set,)184 240 R F1(bash)2.948 E F0 .448 (lists the status of an)2.948 F 2.949(ys)-.15 G .449 (topped and running jobs before e)-2.949 F .449(xiting an interacti)-.15 -F -.15(ve)-.25 G 3.439(shell. If)184 228 R(an)3.439 E 3.439(yj)-.15 G +F -.15(ve)-.25 G 3.439(shell. If)184 252 R(an)3.439 E 3.439(yj)-.15 G .938(obs are running, this causes the e)-3.439 F .938 (xit to be deferred until a second e)-.15 F .938(xit is)-.15 F 2.203 -(attempted without an interv)184 240 R 2.203(ening command \(see)-.15 F +(attempted without an interv)184 264 R 2.203(ening command \(see)-.15 F /F2 9/Times-Bold@0 SF 2.203(JOB CONTR)4.703 F(OL)-.27 E F0(abo)4.453 E --.15(ve)-.15 G 4.703(\). The).15 F(shell)4.704 E(al)184 252 Q -.1(wa)-.1 +-.15(ve)-.15 G 4.703(\). The).15 F(shell)4.704 E(al)184 276 Q -.1(wa)-.1 G(ys postpones e).1 E(xiting if an)-.15 E 2.5(yj)-.15 G -(obs are stopped.)-2.5 E F1(checkwinsize)144 264 Q F0 .797(If set,)184 -276 R F1(bash)3.297 E F0 .797(checks the windo)3.297 F 3.297(ws)-.25 G +(obs are stopped.)-2.5 E F1(checkwinsize)144 288 Q F0 .797(If set,)184 +300 R F1(bash)3.297 E F0 .797(checks the windo)3.297 F 3.297(ws)-.25 G .796(ize after each command and, if necessary)-3.297 F 3.296(,u)-.65 G -.796(pdates the)-3.296 F -.25(va)184 288 S(lues of).25 E F2(LINES)2.5 E +.796(pdates the)-3.296 F -.25(va)184 312 S(lues of).25 E F2(LINES)2.5 E F0(and)2.25 E F2(COLUMNS)2.5 E/F3 9/Times-Roman@0 SF(.)A F1(cmdhist)144 -300 Q F0 1.202(If set,)6.11 F F1(bash)3.702 E F0 1.202(attempts to sa) +324 Q F0 1.202(If set,)6.11 F F1(bash)3.702 E F0 1.202(attempts to sa) 3.702 F 1.502 -.15(ve a)-.2 H 1.202 (ll lines of a multiple-line command in the same history).15 F(entry)184 -312 Q 5(.T)-.65 G(his allo)-5 E -(ws easy re-editing of multi-line commands.)-.25 E F1(compat31)144 324 Q -F0 .42(If set,)184 336 R F1(bash)2.92 E F0 .42(changes its beha)2.92 F +336 Q 5(.T)-.65 G(his allo)-5 E +(ws easy re-editing of multi-line commands.)-.25 E F1(compat31)144 348 Q +F0 .42(If set,)184 360 R F1(bash)2.92 E F0 .42(changes its beha)2.92 F .419(vior to that of v)-.2 F .419(ersion 3.1 with respect to quoted ar) --.15 F(guments)-.18 E .461(to the)184 348 R F1([[)2.961 E F0 .462 +-.15 F(guments)-.18 E .461(to the)184 372 R F1([[)2.961 E F0 .462 (conditional command')2.962 F(s)-.55 E F1(=~)2.962 E F0 .462 (operator and locale-speci\214c string comparison when)2.962 F .71 -(using the)184 360 R F1([[)3.21 E F0 .71(conditional command')3.21 F(s) +(using the)184 384 R F1([[)3.21 E F0 .71(conditional command')3.21 F(s) -.55 E F1(<)3.21 E F0(and)3.21 E F1(>)3.21 E F0 3.21(operators. Bash) 3.21 F -.15(ve)3.21 G .71(rsions prior to bash-4.1).15 F .82 -(use ASCII collation and)184 372 R/F4 10/Times-Italic@0 SF(str)3.321 E +(use ASCII collation and)184 396 R/F4 10/Times-Italic@0 SF(str)3.321 E (cmp)-.37 E F0 .821(\(3\); bash-4.1 and later use the current locale') -.19 F 3.321(sc)-.55 G(ollation)-3.321 E(sequence and)184 384 Q F4(str) -2.5 E(coll)-.37 E F0(\(3\).).51 E F1(compat32)144 396 Q F0 1.41(If set,) -184 408 R F1(bash)3.91 E F0 1.41(changes its beha)3.91 F 1.409 +.19 F 3.321(sc)-.55 G(ollation)-3.321 E(sequence and)184 408 Q F4(str) +2.5 E(coll)-.37 E F0(\(3\).).51 E F1(compat32)144 420 Q F0 1.41(If set,) +184 432 R F1(bash)3.91 E F0 1.41(changes its beha)3.91 F 1.409 (vior to that of v)-.2 F 1.409 (ersion 3.2 with respect to locale-speci\214c)-.15 F .422 -(string comparison when using the)184 420 R F1([[)2.922 E F0 .422 +(string comparison when using the)184 444 R F1([[)2.922 E F0 .422 (conditional command')2.922 F(s)-.55 E F1(<)2.922 E F0(and)2.922 E F1(>) -2.923 E F0 .423(operators \(see pre-)2.923 F(vious item\).)184 432 Q F1 -(compat40)144 444 Q F0 1.41(If set,)184 456 R F1(bash)3.91 E F0 1.41 +2.923 E F0 .423(operators \(see pre-)2.923 F(vious item\).)184 456 Q F1 +(compat40)144 468 Q F0 1.41(If set,)184 480 R F1(bash)3.91 E F0 1.41 (changes its beha)3.91 F 1.409(vior to that of v)-.2 F 1.409 (ersion 4.0 with respect to locale-speci\214c)-.15 F 2.007 -(string comparison when using the)184 468 R F1([[)4.507 E F0 2.008 +(string comparison when using the)184 492 R F1([[)4.507 E F0 2.008 (conditional command')4.507 F(s)-.55 E F1(<)4.508 E F0(and)4.508 E F1(>) -4.508 E F0 2.008(operators \(see)4.508 F .77(description of)184 480 R F1 +4.508 E F0 2.008(operators \(see)4.508 F .77(description of)184 504 R F1 (compat31)3.27 E F0 3.269(\)a)C .769(nd the ef)-3.269 F .769 (fect of interrupting a command list.)-.25 F .769(Bash v)5.769 F (ersions)-.15 E .086 -(4.0 and later interrupt the list as if the shell recei)184 492 R -.15 +(4.0 and later interrupt the list as if the shell recei)184 516 R -.15 (ve)-.25 G 2.587(dt).15 G .087(he interrupt; pre)-2.587 F .087(vious v) --.25 F .087(ersions con-)-.15 F(tinue with the ne)184 504 Q -(xt command in the list.)-.15 E F1(compat41)144 516 Q F0 1.444(If set,) -184 528 R F1(bash)3.944 E F0 3.944(,w)C 1.443 +-.25 F .087(ersions con-)-.15 F(tinue with the ne)184 528 Q +(xt command in the list.)-.15 E F1(compat41)144 540 Q F0 1.444(If set,) +184 552 R F1(bash)3.944 E F0 3.944(,w)C 1.443 (hen in posix mode, treats a single quote in a double-quoted parameter) --3.944 F -.15(ex)184 540 S .958(pansion as a special character).15 F +-3.944 F -.15(ex)184 564 S .958(pansion as a special character).15 F 5.958(.T)-.55 G .959(he single quotes must match \(an e)-5.958 F -.15 (ve)-.25 G 3.459(nn).15 G .959(umber\) and)-3.459 F .59 -(the characters between the single quotes are considered quoted.)184 552 +(the characters between the single quotes are considered quoted.)184 576 R .59(This is the beha)5.59 F .59(vior of)-.2 F .589 -(posix mode through v)184 564 R .589(ersion 4.1.)-.15 F .589(The def) +(posix mode through v)184 588 R .589(ersion 4.1.)-.15 F .589(The def) 5.589 F .589(ault bash beha)-.1 F .589(vior remains as in pre)-.2 F .59 -(vious v)-.25 F(er)-.15 E(-)-.2 E(sions.)184 576 Q F1 -(complete_fullquote)144 588 Q F0 .654(If set,)184 600 R F1(bash)3.153 E +(vious v)-.25 F(er)-.15 E(-)-.2 E(sions.)184 600 Q F1 +(complete_fullquote)144 612 Q F0 .654(If set,)184 624 R F1(bash)3.153 E F0 .653(quotes all shell metacharacters in \214lenames and directory na\ -mes when per)3.153 F(-)-.2 E 1.524(forming completion.)184 612 R 1.524 +mes when per)3.153 F(-)-.2 E 1.524(forming completion.)184 636 R 1.524 (If not set,)6.524 F F1(bash)4.024 E F0(remo)4.024 E -.15(ve)-.15 G 4.024(sm).15 G 1.524(etacharacters such as the dollar sign)-4.024 F 2.667(from the set of characters that will be quoted in completed \214l\ -enames when these)184 624 R .028(metacharacters appear in shell v)184 -636 R .028(ariable references in w)-.25 F .029(ords to be completed.)-.1 -F .029(This means)5.029 F 1.073(that dollar signs in v)184 648 R 1.073 +enames when these)184 648 R .028(metacharacters appear in shell v)184 +660 R .028(ariable references in w)-.25 F .029(ords to be completed.)-.1 +F .029(This means)5.029 F 1.073(that dollar signs in v)184 672 R 1.073 (ariable names that e)-.25 F 1.073 (xpand to directories will not be quoted; ho)-.15 F(w-)-.25 E -2.15 -.25 -(ev e)184 660 T 1.922 -.4(r, a).25 H 1.422 -.15(ny d).4 H 1.123 +(ev e)184 684 T 1.922 -.4(r, a).25 H 1.422 -.15(ny d).4 H 1.123 (ollar signs appearing in \214lenames will not be quoted, either).15 F 6.123(.T)-.55 G 1.123(his is acti)-6.123 F -.15(ve)-.25 G .59 (only when bash is using backslashes to quote completed \214lenames.)184 -672 R .59(This v)5.59 F .59(ariable is set)-.25 F(by def)184 684 Q +696 R .59(This v)5.59 F .59(ariable is set)-.25 F(by def)184 708 Q (ault, which is the def)-.1 E(ault bash beha)-.1 E(vior in v)-.2 E -(ersions through 4.2.)-.15 E F1(dir)144 696 Q(expand)-.18 E F0 .486 -(If set,)184 708 R F1(bash)2.986 E F0 .486 -(replaces directory names with the results of w)2.986 F .486(ord e)-.1 F -.487(xpansion when perform-)-.15 F .18(ing \214lename completion.)184 -720 R .179(This changes the contents of the readline editing b)5.18 F -(uf)-.2 E(fer)-.25 E 5.179(.I)-.55 G 2.679(fn)-5.179 G(ot)-2.679 E -(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(17)198.725 E 0 Cg EP +(ersions through 4.2.)-.15 E(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E +(17)198.725 E 0 Cg EP %%Page: 18 18 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48 -(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E(set,)184 84 -Q/F1 10/Times-Bold@0 SF(bash)2.5 E F0(attempts to preserv)2.5 E 2.5(ew) --.15 G(hat the user typed.)-2.5 E F1(dirspell)144 96 Q F0 .858(If set,) -7.77 F F1(bash)3.358 E F0 .858 +(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10 +/Times-Bold@0 SF(dir)144 84 Q(expand)-.18 E F0 .486(If set,)184 96 R F1 +(bash)2.986 E F0 .486(replaces directory names with the results of w) +2.986 F .486(ord e)-.1 F .487(xpansion when perform-)-.15 F .18 +(ing \214lename completion.)184 108 R .179 +(This changes the contents of the readline editing b)5.18 F(uf)-.2 E +(fer)-.25 E 5.179(.I)-.55 G 2.679(fn)-5.179 G(ot)-2.679 E(set,)184 120 Q +F1(bash)2.5 E F0(attempts to preserv)2.5 E 2.5(ew)-.15 G +(hat the user typed.)-2.5 E F1(dirspell)144 132 Q F0 .858(If set,)7.77 F +F1(bash)3.358 E F0 .858 (attempts spelling correction on directory names during w)3.358 F .859 (ord completion if)-.1 F -(the directory name initially supplied does not e)184 108 Q(xist.)-.15 E -F1(dotglob)144 120 Q F0 .165(If set,)7.77 F F1(bash)2.665 E F0 .165 +(the directory name initially supplied does not e)184 144 Q(xist.)-.15 E +F1(dotglob)144 156 Q F0 .165(If set,)7.77 F F1(bash)2.665 E F0 .165 (includes \214lenames be)2.665 F .165(ginning with a `.)-.15 F 2.665('i) -.7 G 2.665(nt)-2.665 G .165(he results of pathname e)-2.665 F -(xpansion.)-.15 E F1(execfail)144 132 Q F0 1.386 +(xpansion.)-.15 E F1(execfail)144 168 Q F0 1.386 (If set, a non-interacti)7.79 F 1.686 -.15(ve s)-.25 H 1.386 (hell will not e).15 F 1.386(xit if it cannot e)-.15 F -.15(xe)-.15 G -1.387(cute the \214le speci\214ed as an).15 F(ar)184 144 Q +1.387(cute the \214le speci\214ed as an).15 F(ar)184 180 Q (gument to the)-.18 E F1(exec)2.5 E F0 -.2(bu)2.5 G(iltin command.).2 E (An interacti)5 E .3 -.15(ve s)-.25 H(hell does not e).15 E(xit if)-.15 -E F1(exec)2.5 E F0 -.1(fa)2.5 G(ils.).1 E F1(expand_aliases)144 156 Q F0 -.717(If set, aliases are e)184 168 R .717(xpanded as described abo)-.15 +E F1(exec)2.5 E F0 -.1(fa)2.5 G(ils.).1 E F1(expand_aliases)144 192 Q F0 +.717(If set, aliases are e)184 204 R .717(xpanded as described abo)-.15 F 1.017 -.15(ve u)-.15 H(nder).15 E/F2 9/Times-Bold@0 SF(ALIASES)3.217 E /F3 9/Times-Roman@0 SF(.)A F0 .716(This option is enabled)5.217 F -(by def)184 180 Q(ault for interacti)-.1 E .3 -.15(ve s)-.25 H(hells.) -.15 E F1(extdeb)144 192 Q(ug)-.2 E F0(If set, beha)184 204 Q +(by def)184 216 Q(ault for interacti)-.1 E .3 -.15(ve s)-.25 H(hells.) +.15 E F1(extdeb)144 228 Q(ug)-.2 E F0(If set, beha)184 240 Q (vior intended for use by deb)-.2 E(uggers is enabled:)-.2 E F1(1.)184 -216 Q F0(The)28.5 E F1<ad46>4.25 E F0 1.75(option to the)4.25 F F1 +252 Q F0(The)28.5 E F1<ad46>4.25 E F0 1.75(option to the)4.25 F F1 (declar)4.251 E(e)-.18 E F0 -.2(bu)4.251 G 1.751 (iltin displays the source \214le name and line).2 F -(number corresponding to each function name supplied as an ar)220 228 Q -(gument.)-.18 E F1(2.)184 240 Q F0 1.667(If the command run by the)28.5 +(number corresponding to each function name supplied as an ar)220 264 Q +(gument.)-.18 E F1(2.)184 276 Q F0 1.667(If the command run by the)28.5 F F1(DEB)4.167 E(UG)-.1 E F0 1.667(trap returns a non-zero v)4.167 F -1.667(alue, the ne)-.25 F(xt)-.15 E(command is skipped and not e)220 252 -Q -.15(xe)-.15 G(cuted.).15 E F1(3.)184 264 Q F0 .84 +1.667(alue, the ne)-.25 F(xt)-.15 E(command is skipped and not e)220 288 +Q -.15(xe)-.15 G(cuted.).15 E F1(3.)184 300 Q F0 .84 (If the command run by the)28.5 F F1(DEB)3.34 E(UG)-.1 E F0 .841 (trap returns a v)3.341 F .841(alue of 2, and the shell is)-.25 F -.15 -(exe)220 276 S .488 +(exe)220 312 S .488 (cuting in a subroutine \(a shell function or a shell script e).15 F -.15(xe)-.15 G .488(cuted by the).15 F F1(.)2.988 E F0(or)2.988 E F1 -(sour)220 288 Q(ce)-.18 E F0 -.2(bu)2.5 G(iltins\), a call to).2 E F1 --.18(re)2.5 G(tur).18 E(n)-.15 E F0(is simulated.)2.5 E F1(4.)184 300 Q +(sour)220 324 Q(ce)-.18 E F0 -.2(bu)2.5 G(iltins\), a call to).2 E F1 +-.18(re)2.5 G(tur).18 E(n)-.15 E F0(is simulated.)2.5 E F1(4.)184 336 Q F2 -.27(BA)28.5 G(SH_ARGC).27 E F0(and)3.153 E F2 -.27(BA)3.403 G (SH_ARGV).27 E F0 .904(are updated as described in their descriptions) -3.154 F(abo)220 312 Q -.15(ve)-.15 G(.).15 E F1(5.)184 324 Q F0 1.359 +3.154 F(abo)220 348 Q -.15(ve)-.15 G(.).15 E F1(5.)184 360 Q F0 1.359 (Function tracing is enabled:)28.5 F 1.359 (command substitution, shell functions, and sub-)6.359 F(shells in)220 -336 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G(ith)-2.5 E F1(\()2.5 E/F4 10 +372 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G(ith)-2.5 E F1(\()2.5 E/F4 10 /Times-Italic@0 SF(command)2.5 E F1(\))2.5 E F0(inherit the)2.5 E F1 (DEB)2.5 E(UG)-.1 E F0(and)2.5 E F1(RETURN)2.5 E F0(traps.)2.5 E F1(6.) -184 348 Q F0 .804(Error tracing is enabled:)28.5 F .805 -(command substitution, shell functions, and subshells)5.804 F(in)220 360 +184 384 Q F0 .804(Error tracing is enabled:)28.5 F .805 +(command substitution, shell functions, and subshells)5.804 F(in)220 396 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G(ith)-2.5 E F1(\()2.5 E F4 (command)2.5 E F1(\))2.5 E F0(inherit the)2.5 E F1(ERR)2.5 E F0(trap.) -2.5 E F1(extglob)144 372 Q F0 .4(If set, the e)8.89 F .4 +2.5 E F1(extglob)144 408 Q F0 .4(If set, the e)8.89 F .4 (xtended pattern matching features described abo)-.15 F .7 -.15(ve u) --.15 H(nder).15 E F1 -.1(Pa)2.9 G .4(thname Expan-).1 F(sion)184 384 Q -F0(are enabled.)2.5 E F1(extquote)144 396 Q F0 2.473(If set,)184 408 R +-.15 H(nder).15 E F1 -.1(Pa)2.9 G .4(thname Expan-).1 F(sion)184 420 Q +F0(are enabled.)2.5 E F1(extquote)144 432 Q F0 2.473(If set,)184 444 R F1($)4.973 E F0<08>A F4(string)A F0 4.973<0861>C(nd)-4.973 E F1($)4.973 E F0(")A F4(string)A F0 4.973("q)C 2.473(uoting is performed within) -4.973 F F1(${)4.973 E F4(par)A(ameter)-.15 E F1(})A F0 -.15(ex)4.973 G -(pansions).15 E(enclosed in double quotes.)184 420 Q -(This option is enabled by def)5 E(ault.)-.1 E F1(failglob)144 432 Q F0 +(pansions).15 E(enclosed in double quotes.)184 456 Q +(This option is enabled by def)5 E(ault.)-.1 E F1(failglob)144 468 Q F0 1.425(If set, patterns which f)7.77 F 1.425 (ail to match \214lenames during pathname e)-.1 F 1.424 -(xpansion result in an)-.15 F -.15(ex)184 444 S(pansion error).15 E(.) --.55 E F1 -.25(fo)144 456 S -.18(rc).25 G(e_\214gnor).18 E(e)-.18 E F0 -.936(If set, the suf)184 468 R<8c78>-.25 E .936(es speci\214ed by the) +(xpansion result in an)-.15 F -.15(ex)184 480 S(pansion error).15 E(.) +-.55 E F1 -.25(fo)144 492 S -.18(rc).25 G(e_\214gnor).18 E(e)-.18 E F0 +.936(If set, the suf)184 504 R<8c78>-.25 E .936(es speci\214ed by the) -.15 F F2(FIGNORE)3.436 E F0 .936(shell v)3.186 F .936(ariable cause w) --.25 F .937(ords to be ignored)-.1 F .32(when performing w)184 480 R .32 +-.25 F .937(ords to be ignored)-.1 F .32(when performing w)184 516 R .32 (ord completion e)-.1 F -.15(ve)-.25 G 2.82(ni).15 G 2.82(ft)-2.82 G .32 (he ignored w)-2.82 F .32(ords are the only possible com-)-.1 F 2.947 -(pletions. See)184 492 R F2 .447(SHELL V)2.947 F(ARIABLES)-1.215 E F0 +(pletions. See)184 528 R F2 .447(SHELL V)2.947 F(ARIABLES)-1.215 E F0 (abo)2.697 E .747 -.15(ve f)-.15 H .448(or a description of).15 F F2 (FIGNORE)2.948 E F3(.)A F0 .448(This option is)4.948 F(enabled by def) -184 504 Q(ault.)-.1 E F1(globasciiranges)144 516 Q F0 .806 -(If set, range e)184 528 R .806 +184 540 Q(ault.)-.1 E F1(globasciiranges)144 552 Q F0 .806 +(If set, range e)184 564 R .806 (xpressions used in pattern matching \(see)-.15 F F2 -.09(Pa)3.305 G (tter).09 E 3.055(nM)-.135 G(atching)-3.055 E F0(abo)3.055 E -.15(ve) -.15 G 3.305(\)b).15 G(eha)-3.305 E -.15(ve)-.2 G 2.089 -(as if in the traditional C locale when performing comparisons.)184 540 -R 2.09(That is, the current)7.089 F(locale')184 552 Q 2.614(sc)-.55 G +(as if in the traditional C locale when performing comparisons.)184 576 +R 2.09(That is, the current)7.089 F(locale')184 588 Q 2.614(sc)-.55 G .114(ollating sequence is not tak)-2.614 F .113(en into account, so)-.1 F F1(b)2.613 E F0 .113(will not collate between)2.613 F F1(A)2.613 E F0 -(and)2.613 E F1(B)184 564 Q F0 2.5(,a)C(nd upper)-2.5 E(-case and lo)-.2 +(and)2.613 E F1(B)184 600 Q F0 2.5(,a)C(nd upper)-2.5 E(-case and lo)-.2 E(wer)-.25 E(-case ASCII characters will collate together)-.2 E(.)-.55 E -F1(globstar)144 576 Q F0 .518(If set, the pattern)5 F F1(**)3.018 E F0 +F1(globstar)144 612 Q F0 .518(If set, the pattern)5 F F1(**)3.018 E F0 .519(used in a pathname e)3.019 F .519(xpansion conte)-.15 F .519 (xt will match all \214les and zero)-.15 F .432 -(or more directories and subdirectories.)184 588 R .431 +(or more directories and subdirectories.)184 624 R .431 (If the pattern is follo)5.432 F .431(wed by a)-.25 F F1(/)2.931 E F0 2.931(,o)C .431(nly directories)-2.931 F(and subdirectories match.)184 -600 Q F1(gnu_errfmt)144 612 Q F0(If set, shell error messages are writt\ -en in the standard GNU error message format.)184 624 Q F1(histappend)144 -636 Q F0 .676 +636 Q F1(gnu_errfmt)144 648 Q F0(If set, shell error messages are writt\ +en in the standard GNU error message format.)184 660 Q F1(histappend)144 +672 Q F0 .676 (If set, the history list is appended to the \214le named by the v)184 -648 R .676(alue of the)-.25 F F2(HISTFILE)3.177 E F0 -.25(va)2.927 G -(ri-).25 E(able when the shell e)184 660 Q(xits, rather than o)-.15 E --.15(ve)-.15 G(rwriting the \214le.).15 E F1(histr)144 672 Q(eedit)-.18 -E F0 .576(If set, and)184 684 R F1 -.18(re)3.076 G(adline).18 E F0 .575 -(is being used, a user is gi)3.076 F -.15(ve)-.25 G 3.075(nt).15 G .575 -(he opportunity to re-edit a f)-3.075 F .575(ailed his-)-.1 F -(tory substitution.)184 696 Q(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 -E(18)198.725 E 0 Cg EP +684 R .676(alue of the)-.25 F F2(HISTFILE)3.177 E F0 -.25(va)2.927 G +(ri-).25 E(able when the shell e)184 696 Q(xits, rather than o)-.15 E +-.15(ve)-.15 G(rwriting the \214le.).15 E(GNU Bash-4.2)72 768 Q +(2004 Apr 20)148.735 E(18)198.725 E 0 Cg EP %%Page: 19 19 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10 -/Times-Bold@0 SF(histv)144 84 Q(erify)-.1 E F0 .402(If set, and)184 96 R -F1 -.18(re)2.903 G(adline).18 E F0 .403 +/Times-Bold@0 SF(histr)144 84 Q(eedit)-.18 E F0 .576(If set, and)184 96 +R F1 -.18(re)3.076 G(adline).18 E F0 .575(is being used, a user is gi) +3.076 F -.15(ve)-.25 G 3.075(nt).15 G .575 +(he opportunity to re-edit a f)-3.075 F .575(ailed his-)-.1 F +(tory substitution.)184 108 Q F1(histv)144 120 Q(erify)-.1 E F0 .402 +(If set, and)184 132 R F1 -.18(re)2.903 G(adline).18 E F0 .403 (is being used, the results of history substitution are not immediately) -2.903 F .662(passed to the shell parser)184 108 R 5.662(.I)-.55 G .661 +2.903 F .662(passed to the shell parser)184 144 R 5.662(.I)-.55 G .661 (nstead, the resulting line is loaded into the)-5.662 F F1 -.18(re)3.161 -G(adline).18 E F0(editing)3.161 E -.2(bu)184 120 S -.25(ff).2 G(er).25 E +G(adline).18 E F0(editing)3.161 E -.2(bu)184 156 S -.25(ff).2 G(er).25 E 2.5(,a)-.4 G(llo)-2.5 E(wing further modi\214cation.)-.25 E F1 -(hostcomplete)144 132 Q F0 1.181(If set, and)184 144 R F1 -.18(re)3.681 +(hostcomplete)144 168 Q F0 1.181(If set, and)184 180 R F1 -.18(re)3.681 G(adline).18 E F0 1.181(is being used,)3.681 F F1(bash)3.682 E F0 1.182 (will attempt to perform hostname completion)3.682 F 1.381(when a w)184 -156 R 1.381(ord containing a)-.1 F F1(@)3.881 E F0 1.381 +192 R 1.381(ord containing a)-.1 F F1(@)3.881 E F0 1.381 (is being completed \(see)3.881 F F1(Completing)3.88 E F0(under)3.88 E -/F2 9/Times-Bold@0 SF(READLINE)3.88 E F0(abo)184 168 Q -.15(ve)-.15 G +/F2 9/Times-Bold@0 SF(READLINE)3.88 E F0(abo)184 204 Q -.15(ve)-.15 G 2.5(\). This).15 F(is enabled by def)2.5 E(ault.)-.1 E F1(huponexit)144 -180 Q F0(If set,)184 192 Q F1(bash)2.5 E F0(will send)2.5 E F2(SIGHUP) +216 Q F0(If set,)184 228 Q F1(bash)2.5 E F0(will send)2.5 E F2(SIGHUP) 2.5 E F0(to all jobs when an interacti)2.25 E .3 -.15(ve l)-.25 H -(ogin shell e).15 E(xits.)-.15 E F1(interacti)144 204 Q -.1(ve)-.1 G -(_comments).1 E F0 .33(If set, allo)184 216 R 2.83(waw)-.25 G .33 +(ogin shell e).15 E(xits.)-.15 E F1(interacti)144 240 Q -.1(ve)-.1 G +(_comments).1 E F0 .33(If set, allo)184 252 R 2.83(waw)-.25 G .33 (ord be)-2.93 F .33(ginning with)-.15 F F1(#)2.83 E F0 .33 (to cause that w)2.83 F .33(ord and all remaining characters on)-.1 F -.967(that line to be ignored in an interacti)184 228 R 1.267 -.15(ve s) +.967(that line to be ignored in an interacti)184 264 R 1.267 -.15(ve s) -.25 H .967(hell \(see).15 F F2(COMMENTS)3.467 E F0(abo)3.217 E -.15(ve) -.15 G 3.467(\). This).15 F .967(option is)3.467 F(enabled by def)184 -240 Q(ault.)-.1 E F1(lastpipe)144 252 Q F0 1.211 +276 Q(ault.)-.1 E F1(lastpipe)144 288 Q F0 1.211 (If set, and job control is not acti)6.66 F -.15(ve)-.25 G 3.712(,t).15 G 1.212(he shell runs the last command of a pipeline not)-3.712 F -.15 -(exe)184 264 S(cuted in the background in the current shell en).15 E -(vironment.)-.4 E F1(lithist)144 276 Q F0 .655(If set, and the)15.55 F +(exe)184 300 S(cuted in the background in the current shell en).15 E +(vironment.)-.4 E F1(lithist)144 312 Q F0 .655(If set, and the)15.55 F F1(cmdhist)3.155 E F0 .654 (option is enabled, multi-line commands are sa)3.154 F -.15(ve)-.2 G 3.154(dt).15 G 3.154(ot)-3.154 G .654(he history)-3.154 F -(with embedded ne)184 288 Q +(with embedded ne)184 324 Q (wlines rather than using semicolon separators where possible.)-.25 E F1 -(login_shell)144 300 Q F0 .486 +(login_shell)144 336 Q F0 .486 (The shell sets this option if it is started as a login shell \(see)184 -312 R F2(INV)2.987 E(OCA)-.405 E(TION)-.855 E F0(abo)2.737 E -.15(ve) --.15 G 2.987(\). The).15 F -.25(va)184 324 S(lue may not be changed.).25 -E F1(mailwar)144 336 Q(n)-.15 E F0 .815(If set, and a \214le that)184 -348 R F1(bash)3.315 E F0 .814 +348 R F2(INV)2.987 E(OCA)-.405 E(TION)-.855 E F0(abo)2.737 E -.15(ve) +-.15 G 2.987(\). The).15 F -.25(va)184 360 S(lue may not be changed.).25 +E F1(mailwar)144 372 Q(n)-.15 E F0 .815(If set, and a \214le that)184 +384 R F1(bash)3.315 E F0 .814 (is checking for mail has been accessed since the last time it)3.315 F --.1(wa)184 360 S 2.5(sc).1 G(heck)-2.5 E(ed, the message `)-.1 E +-.1(wa)184 396 S 2.5(sc).1 G(heck)-2.5 E(ed, the message `)-.1 E (`The mail in)-.74 E/F3 10/Times-Italic@0 SF(mail\214le)2.5 E F0 (has been read')2.5 E 2.5('i)-.74 G 2.5(sd)-2.5 G(isplayed.)-2.5 E F1 -(no_empty_cmd_completion)144 372 Q F0 .324(If set, and)184 384 R F1 -.18 +(no_empty_cmd_completion)144 408 Q F0 .324(If set, and)184 420 R F1 -.18 (re)2.824 G(adline).18 E F0 .324(is being used,)2.824 F F1(bash)2.824 E F0 .324(will not attempt to search the)2.824 F F2 -.666(PA)2.825 G(TH) -.189 E F0 .325(for possible)2.575 F -(completions when completion is attempted on an empty line.)184 396 Q F1 -(nocaseglob)144 408 Q F0 .437(If set,)184 420 R F1(bash)2.937 E F0 .436 +(completions when completion is attempted on an empty line.)184 432 Q F1 +(nocaseglob)144 444 Q F0 .437(If set,)184 456 R F1(bash)2.937 E F0 .436 (matches \214lenames in a case\255insensiti)2.937 F .736 -.15(ve f)-.25 -H .436(ashion when performing pathname).05 F -.15(ex)184 432 S +H .436(ashion when performing pathname).05 F -.15(ex)184 468 S (pansion \(see).15 E F1 -.1(Pa)2.5 G(thname Expansion).1 E F0(abo)2.5 E --.15(ve)-.15 G(\).).15 E F1(nocasematch)144 444 Q F0 1.193(If set,)184 -456 R F1(bash)3.693 E F0 1.194(matches patterns in a case\255insensiti) +-.15(ve)-.15 G(\).).15 E F1(nocasematch)144 480 Q F0 1.193(If set,)184 +492 R F1(bash)3.693 E F0 1.194(matches patterns in a case\255insensiti) 3.693 F 1.494 -.15(ve f)-.25 H 1.194(ashion when performing matching).05 -F(while e)184 468 Q -.15(xe)-.15 G(cuting).15 E F1(case)2.5 E F0(or)2.5 -E F1([[)2.5 E F0(conditional commands.)2.5 E F1(nullglob)144 480 Q F0 -.855(If set,)184 492 R F1(bash)3.355 E F0(allo)3.355 E .855 +F(while e)184 504 Q -.15(xe)-.15 G(cuting).15 E F1(case)2.5 E F0(or)2.5 +E F1([[)2.5 E F0(conditional commands.)2.5 E F1(nullglob)144 516 Q F0 +.855(If set,)184 528 R F1(bash)3.355 E F0(allo)3.355 E .855 (ws patterns which match no \214les \(see)-.25 F F1 -.1(Pa)3.354 G .854 (thname Expansion).1 F F0(abo)3.354 E -.15(ve)-.15 G 3.354(\)t).15 G(o) --3.354 E -.15(ex)184 504 S(pand to a null string, rather than themselv) -.15 E(es.)-.15 E F1(pr)144 516 Q(ogcomp)-.18 E F0 .676 -(If set, the programmable completion f)184 528 R .677(acilities \(see) +-3.354 E -.15(ex)184 540 S(pand to a null string, rather than themselv) +.15 E(es.)-.15 E F1(pr)144 552 Q(ogcomp)-.18 E F0 .676 +(If set, the programmable completion f)184 564 R .677(acilities \(see) -.1 F F1(Pr)3.177 E .677(ogrammable Completion)-.18 F F0(abo)3.177 E --.15(ve)-.15 G(\)).15 E(are enabled.)184 540 Q -(This option is enabled by def)5 E(ault.)-.1 E F1(pr)144 552 Q(omptv) --.18 E(ars)-.1 E F0 1.448(If set, prompt strings under)184 564 R 1.448 +-.15(ve)-.15 G(\)).15 E(are enabled.)184 576 Q +(This option is enabled by def)5 E(ault.)-.1 E F1(pr)144 588 Q(omptv) +-.18 E(ars)-.1 E F0 1.448(If set, prompt strings under)184 600 R 1.448 (go parameter e)-.18 F 1.447(xpansion, command substitution, arithmetic) --.15 F -.15(ex)184 576 S .17(pansion, and quote remo).15 F -.25(va)-.15 +-.15 F -.15(ex)184 612 S .17(pansion, and quote remo).15 F -.25(va)-.15 G 2.67(la).25 G .17(fter being e)-2.67 F .17(xpanded as described in) -.15 F F2(PR)2.671 E(OMPTING)-.27 E F0(abo)2.421 E -.15(ve)-.15 G(.).15 -E(This option is enabled by def)184 588 Q(ault.)-.1 E F1 -.18(re)144 600 +E(This option is enabled by def)184 624 Q(ault.)-.1 E F1 -.18(re)144 636 S(stricted_shell).18 E F0 1.069 (The shell sets this option if it is started in restricted mode \(see) -184 612 R F2 1.069(RESTRICTED SHELL)3.569 F F0(belo)184 624 Q 4.178 +184 648 R F2 1.069(RESTRICTED SHELL)3.569 F F0(belo)184 660 Q 4.178 (w\). The)-.25 F -.25(va)4.178 G 1.678(lue may not be changed.).25 F 1.678(This is not reset when the startup \214les are)6.678 F -.15(exe) -184 636 S(cuted, allo).15 E(wing the startup \214les to disco)-.25 E +184 672 S(cuted, allo).15 E(wing the startup \214les to disco)-.25 E -.15(ve)-.15 G 2.5(rw).15 G(hether or not a shell is restricted.)-2.5 E -F1(shift_v)144 648 Q(erbose)-.1 E F0 .502(If set, the)184 660 R F1 +F1(shift_v)144 684 Q(erbose)-.1 E F0 .502(If set, the)184 696 R F1 (shift)3.002 E F0 -.2(bu)3.002 G .501 (iltin prints an error message when the shift count e).2 F .501 -(xceeds the number)-.15 F(of positional parameters.)184 672 Q F1(sour) -144 684 Q(cepath)-.18 E F0 .77(If set, the)184 696 R F1(sour)3.27 E(ce) --.18 E F0(\()3.27 E F1(.)A F0 3.27(\)b)C .77(uiltin uses the v)-3.47 F -.771(alue of)-.25 F F2 -.666(PA)3.271 G(TH)-.189 E F0 .771 -(to \214nd the directory containing the)3.021 F -(\214le supplied as an ar)184 708 Q 2.5(gument. This)-.18 F -(option is enabled by def)2.5 E(ault.)-.1 E(GNU Bash-4.2)72 768 Q -(2004 Apr 20)148.735 E(19)198.725 E 0 Cg EP +(xceeds the number)-.15 F(of positional parameters.)184 708 Q +(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(19)198.725 E 0 Cg EP %%Page: 20 20 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10 -/Times-Bold@0 SF(xpg_echo)144 84 Q F0(If set, the)184 96 Q F1(echo)2.5 E -F0 -.2(bu)2.5 G(iltin e).2 E(xpands backslash-escape sequences by def) --.15 E(ault.)-.1 E F1(suspend)108 112.8 Q F0([)2.5 E F1<ad66>A F0(])A -1.002(Suspend the e)144 124.8 R -.15(xe)-.15 G 1.002 -(cution of this shell until it recei).15 F -.15(ve)-.25 G 3.501(sa).15 G -/F2 9/Times-Bold@0 SF(SIGCONT)A F0 3.501(signal. A)3.251 F 1.001 -(login shell cannot be)3.501 F .022(suspended; the)144 136.8 R F1<ad66> +/Times-Bold@0 SF(sour)144 84 Q(cepath)-.18 E F0 .77(If set, the)184 96 R +F1(sour)3.27 E(ce)-.18 E F0(\()3.27 E F1(.)A F0 3.27(\)b)C .77 +(uiltin uses the v)-3.47 F .771(alue of)-.25 F/F2 9/Times-Bold@0 SF +-.666(PA)3.271 G(TH)-.189 E F0 .771 +(to \214nd the directory containing the)3.021 F +(\214le supplied as an ar)184 108 Q 2.5(gument. This)-.18 F +(option is enabled by def)2.5 E(ault.)-.1 E F1(xpg_echo)144 120 Q F0 +(If set, the)184 132 Q F1(echo)2.5 E F0 -.2(bu)2.5 G(iltin e).2 E +(xpands backslash-escape sequences by def)-.15 E(ault.)-.1 E F1(suspend) +108 148.8 Q F0([)2.5 E F1<ad66>A F0(])A 1.002(Suspend the e)144 160.8 R +-.15(xe)-.15 G 1.002(cution of this shell until it recei).15 F -.15(ve) +-.25 G 3.501(sa).15 G F2(SIGCONT)A F0 3.501(signal. A)3.251 F 1.001 +(login shell cannot be)3.501 F .022(suspended; the)144 172.8 R F1<ad66> 2.522 E F0 .022(option can be used to o)2.522 F -.15(ve)-.15 G .022 (rride this and force the suspension.).15 F .023(The return status is) -5.023 F 2.5(0u)144 148.8 S(nless the shell is a login shell and)-2.5 E +5.023 F 2.5(0u)144 184.8 S(nless the shell is a login shell and)-2.5 E F1<ad66>2.5 E F0(is not supplied, or if job control is not enabled.)2.5 -E F1(test)108 165.6 Q/F3 10/Times-Italic@0 SF -.2(ex)2.5 G(pr).2 E F1([) -108 177.6 Q F3 -.2(ex)2.5 G(pr).2 E F1(])2.5 E F0 .878 +E F1(test)108 201.6 Q/F3 10/Times-Italic@0 SF -.2(ex)2.5 G(pr).2 E F1([) +108 213.6 Q F3 -.2(ex)2.5 G(pr).2 E F1(])2.5 E F0 .878 (Return a status of 0 \(true\) or 1 \(f)6.77 F .877 (alse\) depending on the e)-.1 F -.25(va)-.25 G .877 -(luation of the conditional e).25 F(xpression)-.15 E F3 -.2(ex)144 189.6 +(luation of the conditional e).25 F(xpression)-.15 E F3 -.2(ex)144 225.6 S(pr).2 E F0 5.53(.E).73 G .53 (ach operator and operand must be a separate ar)-5.53 F 3.03 (gument. Expressions)-.18 F .53(are composed of the)3.03 F 3.08 -(primaries described abo)144 201.6 R 3.38 -.15(ve u)-.15 H(nder).15 E F2 +(primaries described abo)144 237.6 R 3.38 -.15(ve u)-.15 H(nder).15 E F2 (CONDITION)5.58 E 3.079(AL EXPRESSIONS)-.18 F/F4 9/Times-Roman@0 SF(.)A F1(test)7.579 E F0 3.079(does not accept an)5.579 F(y)-.15 E -(options, nor does it accept and ignore an ar)144 213.6 Q(gument of)-.18 +(options, nor does it accept and ignore an ar)144 249.6 Q(gument of)-.18 E F1<adad>2.5 E F0(as signifying the end of options.)2.5 E .785 -(Expressions may be combined using the follo)144 231.6 R .786 +(Expressions may be combined using the follo)144 267.6 R .786 (wing operators, listed in decreasing order of prece-)-.25 F 3.412 -(dence. The)144 243.6 R -.25(eva)3.412 G .912 +(dence. The)144 279.6 R -.25(eva)3.412 G .912 (luation depends on the number of ar).25 F .911(guments; see belo)-.18 F 4.711 -.65(w. O)-.25 H .911(perator precedence is).65 F -(used when there are \214v)144 255.6 Q 2.5(eo)-.15 G 2.5(rm)-2.5 G -(ore ar)-2.5 E(guments.)-.18 E F1(!)144 267.6 Q F3 -.2(ex)2.5 G(pr).2 E +(used when there are \214v)144 291.6 Q 2.5(eo)-.15 G 2.5(rm)-2.5 G +(ore ar)-2.5 E(guments.)-.18 E F1(!)144 303.6 Q F3 -.2(ex)2.5 G(pr).2 E F0 -.35(Tr)12.6 G(ue if).35 E F3 -.2(ex)2.5 G(pr).2 E F0(is f)3.23 E -(alse.)-.1 E F1(\()144 279.6 Q F3 -.2(ex)2.5 G(pr).2 E F1(\))2.5 E F0 +(alse.)-.1 E F1(\()144 315.6 Q F3 -.2(ex)2.5 G(pr).2 E F1(\))2.5 E F0 .26(Returns the v)6.77 F .26(alue of)-.25 F F3 -.2(ex)2.76 G(pr).2 E F0 5.26(.T)C .26(his may be used to o)-5.26 F -.15(ve)-.15 G .26 -(rride the normal precedence of opera-).15 F(tors.)180 291.6 Q F3 -.2 -(ex)144 303.6 S(pr1).2 E F0<ad>2.5 E F1(a)A F3 -.2(ex)2.5 G(pr2).2 E F0 --.35(Tr)180 315.6 S(ue if both).35 E F3 -.2(ex)2.5 G(pr1).2 E F0(and)2.5 -E F3 -.2(ex)2.5 G(pr2).2 E F0(are true.)2.52 E F3 -.2(ex)144 327.6 S +(rride the normal precedence of opera-).15 F(tors.)180 327.6 Q F3 -.2 +(ex)144 339.6 S(pr1).2 E F0<ad>2.5 E F1(a)A F3 -.2(ex)2.5 G(pr2).2 E F0 +-.35(Tr)180 351.6 S(ue if both).35 E F3 -.2(ex)2.5 G(pr1).2 E F0(and)2.5 +E F3 -.2(ex)2.5 G(pr2).2 E F0(are true.)2.52 E F3 -.2(ex)144 363.6 S (pr1).2 E F0<ad>2.5 E F1(o)A F3 -.2(ex)2.5 G(pr2).2 E F0 -.35(Tr)180 -339.6 S(ue if either).35 E F3 -.2(ex)2.5 G(pr1).2 E F0(or)2.5 E F3 -.2 -(ex)2.5 G(pr2).2 E F0(is true.)2.52 E F1(test)144 356.4 Q F0(and)2.5 E +375.6 S(ue if either).35 E F3 -.2(ex)2.5 G(pr1).2 E F0(or)2.5 E F3 -.2 +(ex)2.5 G(pr2).2 E F0(is true.)2.52 E F1(test)144 392.4 Q F0(and)2.5 E F1([)2.5 E F0 -.25(eva)2.5 G(luate conditional e).25 E (xpressions using a set of rules based on the number of ar)-.15 E -(guments.)-.18 E 2.5(0a)144 374.4 S -.18(rg)-2.5 G(uments).18 E(The e) -180 386.4 Q(xpression is f)-.15 E(alse.)-.1 E 2.5(1a)144 398.4 S -.18 -(rg)-2.5 G(ument).18 E(The e)180 410.4 Q +(guments.)-.18 E 2.5(0a)144 410.4 S -.18(rg)-2.5 G(uments).18 E(The e) +180 422.4 Q(xpression is f)-.15 E(alse.)-.1 E 2.5(1a)144 434.4 S -.18 +(rg)-2.5 G(ument).18 E(The e)180 446.4 Q (xpression is true if and only if the ar)-.15 E(gument is not null.)-.18 -E 2.5(2a)144 422.4 S -.18(rg)-2.5 G(uments).18 E .37(If the \214rst ar) -180 434.4 R .37(gument is)-.18 F F1(!)2.87 E F0 2.87(,t)C .37(he e)-2.87 +E 2.5(2a)144 458.4 S -.18(rg)-2.5 G(uments).18 E .37(If the \214rst ar) +180 470.4 R .37(gument is)-.18 F F1(!)2.87 E F0 2.87(,t)C .37(he e)-2.87 F .37(xpression is true if and only if the second ar)-.15 F .37 -(gument is null.)-.18 F .379(If the \214rst ar)180 446.4 R .38 +(gument is null.)-.18 F .379(If the \214rst ar)180 482.4 R .38 (gument is one of the unary conditional operators listed abo)-.18 F .68 --.15(ve u)-.15 H(nder).15 E F2(CONDI-)2.88 E(TION)180 458.4 Q .553 +-.15(ve u)-.15 H(nder).15 E F2(CONDI-)2.88 E(TION)180 494.4 Q .553 (AL EXPRESSIONS)-.18 F F4(,)A F0 .552(the e)2.802 F .552 (xpression is true if the unary test is true.)-.15 F .552 -(If the \214rst ar)5.552 F(gu-)-.18 E(ment is not a v)180 470.4 Q +(If the \214rst ar)5.552 F(gu-)-.18 E(ment is not a v)180 506.4 Q (alid unary conditional operator)-.25 E 2.5(,t)-.4 G(he e)-2.5 E -(xpression is f)-.15 E(alse.)-.1 E 2.5(3a)144 482.4 S -.18(rg)-2.5 G -(uments).18 E .236(The follo)180 494.4 R .236 +(xpression is f)-.15 E(alse.)-.1 E 2.5(3a)144 518.4 S -.18(rg)-2.5 G +(uments).18 E .236(The follo)180 530.4 R .236 (wing conditions are applied in the order listed.)-.25 F .236 (If the second ar)5.236 F .236(gument is one of)-.18 F .855 -(the binary conditional operators listed abo)180 506.4 R 1.155 -.15 +(the binary conditional operators listed abo)180 542.4 R 1.155 -.15 (ve u)-.15 H(nder).15 E F2(CONDITION)3.355 E .855(AL EXPRESSIONS)-.18 F -F4(,)A F0(the)3.104 E .578(result of the e)180 518.4 R .578(xpression i\ +F4(,)A F0(the)3.104 E .578(result of the e)180 554.4 R .578(xpression i\ s the result of the binary test using the \214rst and third ar)-.15 F -(guments)-.18 E 1.333(as operands.)180 530.4 R(The)6.333 E F1<ad61>3.833 +(guments)-.18 E 1.333(as operands.)180 566.4 R(The)6.333 E F1<ad61>3.833 E F0(and)3.833 E F1<ad6f>3.832 E F0 1.332 (operators are considered binary operators when there are)3.832 F .558 -(three ar)180 542.4 R 3.058(guments. If)-.18 F .558(the \214rst ar)3.058 +(three ar)180 578.4 R 3.058(guments. If)-.18 F .558(the \214rst ar)3.058 F .558(gument is)-.18 F F1(!)3.058 E F0 3.058(,t)C .558(he v)-3.058 F .558(alue is the ne)-.25 F -.05(ga)-.15 G .558(tion of the tw).05 F (o-ar)-.1 E(gument)-.18 E .521(test using the second and third ar)180 -554.4 R 3.021(guments. If)-.18 F .521(the \214rst ar)3.021 F .52 +590.4 R 3.021(guments. If)-.18 F .521(the \214rst ar)3.021 F .52 (gument is e)-.18 F(xactly)-.15 E F1(\()3.02 E F0 .52(and the third)3.02 -F(ar)180 566.4 Q .485(gument is e)-.18 F(xactly)-.15 E F1(\))2.985 E F0 +F(ar)180 602.4 Q .485(gument is e)-.18 F(xactly)-.15 E F1(\))2.985 E F0 2.985(,t)C .485(he result is the one-ar)-2.985 F .485 (gument test of the second ar)-.18 F 2.985(gument. Other)-.18 F(-)-.2 E -(wise, the e)180 578.4 Q(xpression is f)-.15 E(alse.)-.1 E 2.5(4a)144 -590.4 S -.18(rg)-2.5 G(uments).18 E .385(If the \214rst ar)180 602.4 R +(wise, the e)180 614.4 Q(xpression is f)-.15 E(alse.)-.1 E 2.5(4a)144 +626.4 S -.18(rg)-2.5 G(uments).18 E .385(If the \214rst ar)180 638.4 R .385(gument is)-.18 F F1(!)2.885 E F0 2.885(,t)C .385 (he result is the ne)-2.885 F -.05(ga)-.15 G .384(tion of the three-ar) .05 F .384(gument e)-.18 F .384(xpression com-)-.15 F 1.647 -(posed of the remaining ar)180 614.4 R 4.147(guments. Otherwise,)-.18 F +(posed of the remaining ar)180 650.4 R 4.147(guments. Otherwise,)-.18 F 1.647(the e)4.147 F 1.648(xpression is parsed and e)-.15 F -.25(va)-.25 G(luated).25 E(according to precedence using the rules listed abo)180 -626.4 Q -.15(ve)-.15 G(.).15 E 2.5(5o)144 638.4 S 2.5(rm)-2.5 G(ore ar) --2.5 E(guments)-.18 E 1.635(The e)180 650.4 R 1.635 +662.4 Q -.15(ve)-.15 G(.).15 E 2.5(5o)144 674.4 S 2.5(rm)-2.5 G(ore ar) +-2.5 E(guments)-.18 E 1.635(The e)180 686.4 R 1.635 (xpression is parsed and e)-.15 F -.25(va)-.25 G 1.635 (luated according to precedence using the rules listed).25 F(abo)180 -662.4 Q -.15(ve)-.15 G(.).15 E(When used with)144 680.4 Q F1(test)2.5 E +698.4 Q -.15(ve)-.15 G(.).15 E(When used with)144 716.4 Q F1(test)2.5 E F0(or)2.5 E F1([)2.5 E F0 2.5(,t)C(he)-2.5 E F1(<)2.5 E F0(and)2.5 E F1 (>)2.5 E F0(operators sort le)2.5 E -(xicographically using ASCII ordering.)-.15 E F1(times)108 697.2 Q F0 -1.229(Print the accumulated user and system times for the shell and for\ - processes run from the shell.)13.23 F(The return status is 0.)144 709.2 -Q(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(20)198.725 E 0 Cg EP +(xicographically using ASCII ordering.)-.15 E(GNU Bash-4.2)72 768 Q +(2004 Apr 20)148.735 E(20)198.725 E 0 Cg EP %%Page: 21 21 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10 -/Times-Bold@0 SF(trap)108 84 Q F0([)2.5 E F1(\255lp)A F0 2.5(][)C([)-2.5 -E/F2 10/Times-Italic@0 SF(ar)A(g)-.37 E F0(])A F2(sigspec)2.5 E F0(...]) -2.5 E .703(The command)144 96 R F2(ar)3.533 E(g)-.37 E F0 .703 -(is to be read and e)3.423 F -.15(xe)-.15 G .702 +/Times-Bold@0 SF(times)108 84 Q F0 1.229(Print the accumulated user and\ + system times for the shell and for processes run from the shell.)13.23 +F(The return status is 0.)144 96 Q F1(trap)108 112.8 Q F0([)2.5 E F1 +(\255lp)A F0 2.5(][)C([)-2.5 E/F2 10/Times-Italic@0 SF(ar)A(g)-.37 E F0 +(])A F2(sigspec)2.5 E F0(...])2.5 E .703(The command)144 124.8 R F2(ar) +3.533 E(g)-.37 E F0 .703(is to be read and e)3.423 F -.15(xe)-.15 G .702 (cuted when the shell recei).15 F -.15(ve)-.25 G 3.202(ss).15 G (ignal\(s\))-3.202 E F2(sigspec)3.202 E F0 5.702(.I).31 G(f)-5.702 E F2 (ar)3.532 E(g)-.37 E F0(is)3.422 E .608(absent \(and there is a single) -144 108 R F2(sigspec)3.108 E F0 3.108(\)o)C(r)-3.108 E F1<ad>3.108 E F0 -3.108(,e)C .608 +144 136.8 R F2(sigspec)3.108 E F0 3.108(\)o)C(r)-3.108 E F1<ad>3.108 E +F0 3.108(,e)C .608 (ach speci\214ed signal is reset to its original disposition)-3.108 F -.659(\(the v)144 120 R .659(alue it had upon entrance to the shell\).) +.659(\(the v)144 148.8 R .659(alue it had upon entrance to the shell\).) -.25 F(If)5.658 E F2(ar)3.488 E(g)-.37 E F0 .658 (is the null string the signal speci\214ed by each)3.378 F F2(sigspec) -144.34 132 Q F0 .58(is ignored by the shell and by the commands it in) +144.34 160.8 Q F0 .58(is ignored by the shell and by the commands it in) 3.39 F -.2(vo)-.4 G -.1(ke).2 G 3.081(s. If).1 F F2(ar)3.411 E(g)-.37 E F0 .581(is not present and)3.301 F F1<ad70>3.081 E F0(has)3.081 E 1.215 -(been supplied, then the trap commands associated with each)144 144 R F2 -(sigspec)4.054 E F0 1.214(are displayed.)4.024 F 1.214(If no ar)6.214 F -(gu-)-.18 E .86(ments are supplied or if only)144 156 R F1<ad70>3.36 E -F0 .86(is gi)3.36 F -.15(ve)-.25 G(n,).15 E F1(trap)3.36 E F0 .86 +(been supplied, then the trap commands associated with each)144 172.8 R +F2(sigspec)4.054 E F0 1.214(are displayed.)4.024 F 1.214(If no ar)6.214 +F(gu-)-.18 E .86(ments are supplied or if only)144 184.8 R F1<ad70>3.36 +E F0 .86(is gi)3.36 F -.15(ve)-.25 G(n,).15 E F1(trap)3.36 E F0 .86 (prints the list of commands associated with each)3.36 F 2.83 -(signal. The)144 168 R F1<ad6c>2.83 E F0 .33(option causes the shell to\ - print a list of signal names and their corresponding num-)2.83 F 4.31 -(bers. Each)144 180 R F2(sigspec)4.65 E F0 1.811 +(signal. The)144 196.8 R F1<ad6c>2.83 E F0 .33(option causes the shell \ +to print a list of signal names and their corresponding num-)2.83 F 4.31 +(bers. Each)144 208.8 R F2(sigspec)4.65 E F0 1.811 (is either a signal name de\214ned in <)4.62 F F2(signal.h)A F0 1.811 (>, or a signal number)B 6.811(.S)-.55 G(ignal)-6.811 E -(names are case insensiti)144 192 Q .3 -.15(ve a)-.25 H(nd the).15 E/F3 -9/Times-Bold@0 SF(SIG)2.5 E F0(pre\214x is optional.)2.25 E 1.649(If a) -144 210 R F2(sigspec)4.489 E F0(is)4.459 E F3(EXIT)4.149 E F0 1.649 -(\(0\) the command)3.899 F F2(ar)4.479 E(g)-.37 E F0 1.649(is e)4.369 F --.15(xe)-.15 G 1.649(cuted on e).15 F 1.648(xit from the shell.)-.15 F -1.648(If a)6.648 F F2(sigspec)4.488 E F0(is)4.458 E F3(DEB)144 222 Q(UG) --.09 E/F4 9/Times-Roman@0 SF(,)A F0 1.167(the command)3.417 F F2(ar) -3.997 E(g)-.37 E F0 1.167(is e)3.887 F -.15(xe)-.15 G 1.167 +(names are case insensiti)144 220.8 Q .3 -.15(ve a)-.25 H(nd the).15 E +/F3 9/Times-Bold@0 SF(SIG)2.5 E F0(pre\214x is optional.)2.25 E 1.649 +(If a)144 238.8 R F2(sigspec)4.489 E F0(is)4.459 E F3(EXIT)4.149 E F0 +1.649(\(0\) the command)3.899 F F2(ar)4.479 E(g)-.37 E F0 1.649(is e) +4.369 F -.15(xe)-.15 G 1.649(cuted on e).15 F 1.648(xit from the shell.) +-.15 F 1.648(If a)6.648 F F2(sigspec)4.488 E F0(is)4.458 E F3(DEB)144 +250.8 Q(UG)-.09 E/F4 9/Times-Roman@0 SF(,)A F0 1.167(the command)3.417 F +F2(ar)3.997 E(g)-.37 E F0 1.167(is e)3.887 F -.15(xe)-.15 G 1.167 (cuted before e).15 F -.15(ve)-.25 G(ry).15 E F2 1.168(simple command) 3.667 F F0(,)A F2(for)3.668 E F0(command,)3.668 E F2(case)3.668 E F0 -(com-)3.668 E(mand,)144 234 Q F2(select)2.647 E F0 .147(command, e)2.647 -F -.15(ve)-.25 G .147(ry arithmetic).15 F F2(for)2.647 E F0 .146 +(com-)3.668 E(mand,)144 262.8 Q F2(select)2.647 E F0 .147(command, e) +2.647 F -.15(ve)-.25 G .147(ry arithmetic).15 F F2(for)2.647 E F0 .146 (command, and before the \214rst command e)2.647 F -.15(xe)-.15 G .146 -(cutes in a).15 F .145(shell function \(see)144 246 R F3 .145 +(cutes in a).15 F .145(shell function \(see)144 274.8 R F3 .145 (SHELL GRAMMAR)2.645 F F0(abo)2.395 E -.15(ve)-.15 G 2.646(\). Refer).15 F .146(to the description of the)2.646 F F1(extdeb)2.646 E(ug)-.2 E F0 -.146(option to)2.646 F(the)144 258 Q F1(shopt)3.201 E F0 -.2(bu)3.201 G -.7(iltin for details of its ef).2 F .7(fect on the)-.25 F F1(DEB)3.2 E +.146(option to)2.646 F(the)144 286.8 Q F1(shopt)3.201 E F0 -.2(bu)3.201 +G .7(iltin for details of its ef).2 F .7(fect on the)-.25 F F1(DEB)3.2 E (UG)-.1 E F0 3.2(trap. If)3.2 F(a)3.2 E F2(sigspec)3.54 E F0(is)3.51 E -F3(RETURN)3.2 E F4(,)A F0 .7(the com-)2.95 F(mand)144 270 Q F2(ar)3.473 -E(g)-.37 E F0 .643(is e)3.363 F -.15(xe)-.15 G .643 +F3(RETURN)3.2 E F4(,)A F0 .7(the com-)2.95 F(mand)144 298.8 Q F2(ar) +3.473 E(g)-.37 E F0 .643(is e)3.363 F -.15(xe)-.15 G .643 (cuted each time a shell function or a script e).15 F -.15(xe)-.15 G .644(cuted with the).15 F F1(.)3.144 E F0(or)3.144 E F1(sour)3.144 E(ce) --.18 E F0 -.2(bu)3.144 G(iltins).2 E(\214nishes e)144 282 Q -.15(xe)-.15 -G(cuting.).15 E .929(If a)144 300 R F2(sigspec)3.769 E F0(is)3.739 E F3 -(ERR)3.429 E F4(,)A F0 .929(the command)3.179 F F2(ar)3.759 E(g)-.37 E -F0 .929(is e)3.649 F -.15(xe)-.15 G .929(cuted whene).15 F -.15(ve)-.25 -G 3.429(ras).15 G .928(imple command has a non\255zero)-3.429 F -.15(ex) -144 312 S 1.008(it status, subject to the follo).15 F 1.009 -(wing conditions.)-.25 F(The)6.009 E F3(ERR)3.509 E F0 1.009 +-.18 E F0 -.2(bu)3.144 G(iltins).2 E(\214nishes e)144 310.8 Q -.15(xe) +-.15 G(cuting.).15 E .929(If a)144 328.8 R F2(sigspec)3.769 E F0(is) +3.739 E F3(ERR)3.429 E F4(,)A F0 .929(the command)3.179 F F2(ar)3.759 E +(g)-.37 E F0 .929(is e)3.649 F -.15(xe)-.15 G .929(cuted whene).15 F +-.15(ve)-.25 G 3.429(ras).15 G .928(imple command has a non\255zero) +-3.429 F -.15(ex)144 340.8 S 1.008(it status, subject to the follo).15 F +1.009(wing conditions.)-.25 F(The)6.009 E F3(ERR)3.509 E F0 1.009 (trap is not e)3.259 F -.15(xe)-.15 G 1.009(cuted if the f).15 F 1.009 (ailed com-)-.1 F .324 -(mand is part of the command list immediately follo)144 324 R .324 +(mand is part of the command list immediately follo)144 352.8 R .324 (wing a)-.25 F F1(while)2.824 E F0(or)2.824 E F1(until)2.824 E F0 -.1 (ke)2.824 G(yw)-.05 E .324(ord, part of the test)-.1 F .151(in an)144 -336 R F2(if)2.661 E F0 .151(statement, part of a command e)4.611 F -.15 -(xe)-.15 G .151(cuted in a).15 F F1(&&)2.651 E F0(or)2.651 E F1(||)2.651 -E F0 .151(list, or if the command')2.651 F 2.651(sr)-.55 G .151(eturn v) --2.651 F(alue)-.25 E(is being in)144 348 Q -.15(ve)-.4 G(rted via).15 E -F1(!)2.5 E F0 5(.T)C(hese are the same conditions obe)-5 E(yed by the) --.15 E F1(err)2.5 E(exit)-.18 E F0(option.)2.5 E 1.095 +364.8 R F2(if)2.661 E F0 .151(statement, part of a command e)4.611 F +-.15(xe)-.15 G .151(cuted in a).15 F F1(&&)2.651 E F0(or)2.651 E F1(||) +2.651 E F0 .151(list, or if the command')2.651 F 2.651(sr)-.55 G .151 +(eturn v)-2.651 F(alue)-.25 E(is being in)144 376.8 Q -.15(ve)-.4 G +(rted via).15 E F1(!)2.5 E F0 5(.T)C(hese are the same conditions obe)-5 +E(yed by the)-.15 E F1(err)2.5 E(exit)-.18 E F0(option.)2.5 E 1.095 (Signals ignored upon entry to the shell cannot be trapped or reset.)144 -366 R -.35(Tr)6.095 G 1.095(apped signals that are not).35 F .662 -(being ignored are reset to their original v)144 378 R .662 +394.8 R -.35(Tr)6.095 G 1.095(apped signals that are not).35 F .662 +(being ignored are reset to their original v)144 406.8 R .662 (alues in a subshell or subshell en)-.25 F .662(vironment when one is) --.4 F 2.5(created. The)144 390 R(return status is f)2.5 E(alse if an)-.1 -E(y)-.15 E F2(sigspec)2.84 E F0(is in)2.81 E -.25(va)-.4 G +-.4 F 2.5(created. The)144 418.8 R(return status is f)2.5 E(alse if an) +-.1 E(y)-.15 E F2(sigspec)2.84 E F0(is in)2.81 E -.25(va)-.4 G (lid; otherwise).25 E F1(trap)2.5 E F0(returns true.)2.5 E F1(type)108 -406.8 Q F0([)2.5 E F1(\255aftpP)A F0(])A F2(name)2.5 E F0([)2.5 E F2 -(name)A F0(...])2.5 E -.4(Wi)144 418.8 S .174 +435.6 Q F0([)2.5 E F1(\255aftpP)A F0(])A F2(name)2.5 E F0([)2.5 E F2 +(name)A F0(...])2.5 E -.4(Wi)144 447.6 S .174 (th no options, indicate ho).4 F 2.674(we)-.25 G(ach)-2.674 E F2(name) 3.034 E F0 -.1(wo)2.854 G .173 (uld be interpreted if used as a command name.).1 F .173(If the)5.173 F -F1<ad74>144 430.8 Q F0 .842(option is used,)3.342 F F1(type)3.342 E F0 +F1<ad74>144 459.6 Q F0 .842(option is used,)3.342 F F1(type)3.342 E F0 .843(prints a string which is one of)3.343 F F2(alias)3.343 E F0(,).27 E F2 -.1(ke)3.343 G(ywor)-.2 E(d)-.37 E F0(,).77 E F2(function)3.343 E F0 (,).24 E F2 -.2(bu)3.343 G(iltin).2 E F0 3.343(,o).24 G(r)-3.343 E F2 -(\214le)5.253 E F0(if)3.523 E F2(name)144.36 442.8 Q F0 .087 +(\214le)5.253 E F0(if)3.523 E F2(name)144.36 471.6 Q F0 .087 (is an alias, shell reserv)2.767 F .087(ed w)-.15 F .087 (ord, function, b)-.1 F .086(uiltin, or disk \214le, respecti)-.2 F -.15 (ve)-.25 G(ly).15 E 5.086(.I)-.65 G 2.586(ft)-5.086 G(he)-2.586 E F2 (name)2.946 E F0 .086(is not)2.766 F .118 -(found, then nothing is printed, and an e)144 454.8 R .118 +(found, then nothing is printed, and an e)144 483.6 R .118 (xit status of f)-.15 F .118(alse is returned.)-.1 F .119(If the)5.119 F F1<ad70>2.619 E F0 .119(option is used,)2.619 F F1(type)2.619 E F0 .855 -(either returns the name of the disk \214le that w)144 466.8 R .855 +(either returns the name of the disk \214le that w)144 495.6 R .855 (ould be e)-.1 F -.15(xe)-.15 G .855(cuted if).15 F F2(name)3.715 E F0 .855(were speci\214ed as a com-)3.535 F .64(mand name, or nothing if)144 -478.8 R/F5 10/Courier@0 SF .64(type -t name)3.14 F F0 -.1(wo)3.14 G .641 +507.6 R/F5 10/Courier@0 SF .64(type -t name)3.14 F F0 -.1(wo)3.14 G .641 (uld not return).1 F F2(\214le)3.141 E F0 5.641(.T).18 G(he)-5.641 E F1 <ad50>3.141 E F0 .641(option forces a)3.141 F F3 -.666(PA)3.141 G(TH) --.189 E F0 .113(search for each)144 490.8 R F2(name)2.613 E F0 2.613(,e) +-.189 E F0 .113(search for each)144 519.6 R F2(name)2.613 E F0 2.613(,e) C -.15(ve)-2.863 G 2.613(ni).15 G(f)-2.613 E F5 .113(type -t name)2.613 F F0 -.1(wo)2.613 G .113(uld not return).1 F F2(\214le)2.613 E F0 5.113 (.I).18 G 2.613(fa)-5.113 G .112(command is hashed,)-.001 F F1<ad70> -2.612 E F0(and)144 502.8 Q F1<ad50>3.23 E F0 .73(print the hashed v)3.23 +2.612 E F0(and)144 531.6 Q F1<ad50>3.23 E F0 .73(print the hashed v)3.23 F .731 (alue, which is not necessarily the \214le that appears \214rst in)-.25 F F3 -.666(PA)3.231 G(TH)-.189 E F4(.)A F0 .731(If the)5.231 F F1<ad61> -144 514.8 Q F0 1.749(option is used,)4.249 F F1(type)4.248 E F0 1.748 +144 543.6 Q F0 1.749(option is used,)4.249 F F1(type)4.248 E F0 1.748 (prints all of the places that contain an e)4.248 F -.15(xe)-.15 G 1.748 (cutable named).15 F F2(name)4.248 E F0 6.748(.T).18 G(his)-6.748 E .744 -(includes aliases and functions, if and only if the)144 526.8 R F1<ad70> +(includes aliases and functions, if and only if the)144 555.6 R F1<ad70> 3.244 E F0 .744(option is not also used.)3.244 F .744 (The table of hashed)5.744 F 1.223(commands is not consulted when using) -144 538.8 R F1<ad61>3.723 E F0 6.223(.T)C(he)-6.223 E F1<ad66>3.723 E F0 +144 567.6 R F1<ad61>3.723 E F0 6.223(.T)C(he)-6.223 E F1<ad66>3.723 E F0 1.223(option suppresses shell function lookup, as)3.723 F .325(with the) -144 550.8 R F1(command)2.825 E F0 -.2(bu)2.825 G(iltin.).2 E F1(type) +144 579.6 R F1(command)2.825 E F0 -.2(bu)2.825 G(iltin.).2 E F1(type) 5.325 E F0 .325(returns true if all of the ar)2.825 F .326 (guments are found, f)-.18 F .326(alse if an)-.1 F 2.826(ya)-.15 G .326 -(re not)-2.826 F(found.)144 562.8 Q F1(ulimit)108 579.6 Q F0([)2.5 E F1 +(re not)-2.826 F(found.)144 591.6 Q F1(ulimit)108 608.4 Q F0([)2.5 E F1 (\255HST)A(abcde\214lmnpqrstuvx)-.92 E F0([)2.5 E F2(limit)A F0(]])A -(Pro)144 591.6 Q .244(vides control o)-.15 F -.15(ve)-.15 G 2.744(rt).15 +(Pro)144 620.4 Q .244(vides control o)-.15 F -.15(ve)-.15 G 2.744(rt).15 G .244(he resources a)-2.744 F -.25(va)-.2 G .244 (ilable to the shell and to processes started by it, on systems).25 F -.943(that allo)144 603.6 R 3.443(ws)-.25 G .943(uch control.)-3.443 F +.943(that allo)144 632.4 R 3.443(ws)-.25 G .943(uch control.)-3.443 F (The)5.943 E F1<ad48>3.443 E F0(and)3.443 E F1<ad53>3.444 E F0 .944 (options specify that the hard or soft limit is set for the)3.444 F(gi) -144 615.6 Q -.15(ve)-.25 G 2.709(nr).15 G 2.709(esource. A)-2.709 F .208 +144 644.4 Q -.15(ve)-.25 G 2.709(nr).15 G 2.709(esource. A)-2.709 F .208 (hard limit cannot be increased by a non-root user once it is set; a so\ -ft limit may)2.709 F .425(be increased up to the v)144 627.6 R .425 +ft limit may)2.709 F .425(be increased up to the v)144 656.4 R .425 (alue of the hard limit.)-.25 F .426(If neither)5.425 F F1<ad48>2.926 E F0(nor)2.926 E F1<ad53>2.926 E F0 .426 (is speci\214ed, both the soft and)2.926 F .139(hard limits are set.)144 -639.6 R .139(The v)5.139 F .139(alue of)-.25 F F2(limit)2.729 E F0 .139 +668.4 R .139(The v)5.139 F .139(alue of)-.25 F F2(limit)2.729 E F0 .139 (can be a number in the unit speci\214ed for the resource or one)3.319 F -.741(of the special v)144 651.6 R(alues)-.25 E F1(hard)3.241 E F0(,)A F1 +.741(of the special v)144 680.4 R(alues)-.25 E F1(hard)3.241 E F0(,)A F1 (soft)3.241 E F0 3.241(,o)C(r)-3.241 E F1(unlimited)3.241 E F0 3.241(,w) C .741(hich stand for the current hard limit, the current)-3.241 F .78 -(soft limit, and no limit, respecti)144 663.6 R -.15(ve)-.25 G(ly).15 E +(soft limit, and no limit, respecti)144 692.4 R -.15(ve)-.25 G(ly).15 E 5.78(.I)-.65 G(f)-5.78 E F2(limit)3.37 E F0 .78 (is omitted, the current v)3.96 F .78(alue of the soft limit of the)-.25 -F .498(resource is printed, unless the)144 675.6 R F1<ad48>2.999 E F0 +F .498(resource is printed, unless the)144 704.4 R F1<ad48>2.999 E F0 .499(option is gi)2.999 F -.15(ve)-.25 G 2.999(n. When).15 F .499 (more than one resource is speci\214ed, the)2.999 F -(limit name and unit are printed before the v)144 687.6 Q 2.5 -(alue. Other)-.25 F(options are interpreted as follo)2.5 E(ws:)-.25 E F1 -<ad61>144 699.6 Q F0(All current limits are reported)25.3 E F1<ad62>144 -711.6 Q F0(The maximum sock)24.74 E(et b)-.1 E(uf)-.2 E(fer size)-.25 E +(limit name and unit are printed before the v)144 716.4 Q 2.5 +(alue. Other)-.25 F(options are interpreted as follo)2.5 E(ws:)-.25 E (GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(21)198.725 E 0 Cg EP %%Page: 22 22 %%BeginPageSetup @@ -2728,128 +2741,130 @@ BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48 (TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10 -/Times-Bold@0 SF<ad63>144 84 Q F0 -(The maximum size of core \214les created)25.86 E F1<ad64>144 96 Q F0 +/Times-Bold@0 SF<ad61>144 84 Q F0(All current limits are reported)25.3 E +F1<ad62>144 96 Q F0(The maximum sock)24.74 E(et b)-.1 E(uf)-.2 E +(fer size)-.25 E F1<ad63>144 108 Q F0 +(The maximum size of core \214les created)25.86 E F1<ad64>144 120 Q F0 (The maximum size of a process')24.74 E 2.5(sd)-.55 G(ata se)-2.5 E -(gment)-.15 E F1<ad65>144 108 Q F0 -(The maximum scheduling priority \("nice"\))25.86 E F1<ad66>144 120 Q F0 +(gment)-.15 E F1<ad65>144 132 Q F0 +(The maximum scheduling priority \("nice"\))25.86 E F1<ad66>144 144 Q F0 (The maximum size of \214les written by the shell and its children)26.97 -E F1<ad69>144 132 Q F0(The maximum number of pending signals)27.52 E F1 -<ad6c>144 144 Q F0(The maximum size that may be lock)27.52 E -(ed into memory)-.1 E F1<ad6d>144 156 Q F0 +E F1<ad69>144 156 Q F0(The maximum number of pending signals)27.52 E F1 +<ad6c>144 168 Q F0(The maximum size that may be lock)27.52 E +(ed into memory)-.1 E F1<ad6d>144 180 Q F0 (The maximum resident set size \(man)21.97 E 2.5(ys)-.15 G -(ystems do not honor this limit\))-2.5 E F1<ad6e>144 168 Q F0 .791(The \ +(ystems do not honor this limit\))-2.5 E F1<ad6e>144 192 Q F0 .791(The \ maximum number of open \214le descriptors \(most systems do not allo) 24.74 F 3.29(wt)-.25 G .79(his v)-3.29 F .79(alue to)-.25 F(be set\))180 -180 Q F1<ad70>144 192 Q F0 +204 Q F1<ad70>144 216 Q F0 (The pipe size in 512-byte blocks \(this may not be set\))24.74 E F1 -<ad71>144 204 Q F0(The maximum number of bytes in POSIX message queues) -24.74 E F1<ad72>144 216 Q F0(The maximum real-time scheduling priority) -25.86 E F1<ad73>144 228 Q F0(The maximum stack size)26.41 E F1<ad74>144 -240 Q F0(The maximum amount of cpu time in seconds)26.97 E F1<ad75>144 -252 Q F0(The maximum number of processes a)24.74 E -.25(va)-.2 G -(ilable to a single user).25 E F1<ad76>144 264 Q F0 .47 +<ad71>144 228 Q F0(The maximum number of bytes in POSIX message queues) +24.74 E F1<ad72>144 240 Q F0(The maximum real-time scheduling priority) +25.86 E F1<ad73>144 252 Q F0(The maximum stack size)26.41 E F1<ad74>144 +264 Q F0(The maximum amount of cpu time in seconds)26.97 E F1<ad75>144 +276 Q F0(The maximum number of processes a)24.74 E -.25(va)-.2 G +(ilable to a single user).25 E F1<ad76>144 288 Q F0 .47 (The maximum amount of virtual memory a)25.3 F -.25(va)-.2 G .47 -(ilable to the shell and, on some systems, to).25 F(its children)180 276 -Q F1<ad78>144 288 Q F0(The maximum number of \214le locks)25.3 E F1 -<ad54>144 300 Q F0(The maximum number of threads)23.63 E(If)144 316.8 Q +(ilable to the shell and, on some systems, to).25 F(its children)180 300 +Q F1<ad78>144 312 Q F0(The maximum number of \214le locks)25.3 E F1 +<ad54>144 324 Q F0(The maximum number of threads)23.63 E(If)144 340.8 Q /F2 10/Times-Italic@0 SF(limit)3.058 E F0 .468(is gi)3.648 F -.15(ve) -.25 G .468(n, and the).15 F F1<ad61>2.968 E F0 .468 (option is not used,)2.968 F F2(limit)2.968 E F0 .468(is the ne)2.968 F 2.968(wv)-.25 G .468(alue of the speci\214ed resource.)-3.218 F(If)5.468 -E .044(no option is gi)144 328.8 R -.15(ve)-.25 G .044(n, then).15 F F1 +E .044(no option is gi)144 352.8 R -.15(ve)-.25 G .044(n, then).15 F F1 <ad66>2.544 E F0 .045(is assumed.)2.545 F -1.11(Va)5.045 G .045 (lues are in 1024-byte increments, e)1.11 F .045(xcept for)-.15 F F1 <ad74>2.545 E F0 2.545(,w)C .045(hich is)-2.545 F .403(in seconds;)144 -340.8 R F1<ad70>2.903 E F0 2.903(,w)C .402 +364.8 R F1<ad70>2.903 E F0 2.903(,w)C .402 (hich is in units of 512-byte blocks; and)-2.903 F F1<ad54>2.902 E F0(,) A F1<ad62>2.902 E F0(,)A F1<ad6e>2.902 E F0 2.902(,a)C(nd)-2.902 E F1 <ad75>2.902 E F0 2.902(,w)C .402(hich are unscaled)-2.902 F -.25(va)144 -352.8 S 3.082(lues. The).25 F .583(return status is 0 unless an in)3.083 +376.8 S 3.082(lues. The).25 F .583(return status is 0 unless an in)3.083 F -.25(va)-.4 G .583(lid option or ar).25 F .583 (gument is supplied, or an error occurs)-.18 F(while setting a ne)144 -364.8 Q 2.5(wl)-.25 G(imit.)-2.5 E F1(umask)108 381.6 Q F0([)2.5 E F1 +388.8 Q 2.5(wl)-.25 G(imit.)-2.5 E F1(umask)108 405.6 Q F0([)2.5 E F1 <ad70>A F0 2.5(][)C F1<ad53>-2.5 E F0 2.5(][)C F2(mode)-2.5 E F0(])A .2 -(The user \214le-creation mask is set to)144 393.6 R F2(mode)2.7 E F0 +(The user \214le-creation mask is set to)144 417.6 R F2(mode)2.7 E F0 5.2(.I).18 G(f)-5.2 E F2(mode)3.08 E F0(be)2.88 E .2 (gins with a digit, it is interpreted as an octal)-.15 F .066(number; o\ therwise it is interpreted as a symbolic mode mask similar to that acce\ -pted by)144 405.6 R F2 -.15(ch)2.566 G(mod).15 E F0(\(1\).).77 E(If)144 -417.6 Q F2(mode)3.263 E F0 .382(is omitted, the current v)3.063 F .382 +pted by)144 429.6 R F2 -.15(ch)2.566 G(mod).15 E F0(\(1\).).77 E(If)144 +441.6 Q F2(mode)3.263 E F0 .382(is omitted, the current v)3.063 F .382 (alue of the mask is printed.)-.25 F(The)5.382 E F1<ad53>2.882 E F0 .382 (option causes the mask to be)2.882 F .547 -(printed in symbolic form; the def)144 429.6 R .547 +(printed in symbolic form; the def)144 453.6 R .547 (ault output is an octal number)-.1 F 5.547(.I)-.55 G 3.047(ft)-5.547 G (he)-3.047 E F1<ad70>3.047 E F0 .547(option is supplied, and)3.047 F F2 -(mode)144.38 441.6 Q F0 .552 +(mode)144.38 465.6 Q F0 .552 (is omitted, the output is in a form that may be reused as input.)3.232 -F .551(The return status is 0 if the)5.551 F(mode w)144 453.6 Q +F .551(The return status is 0 if the)5.551 F(mode w)144 477.6 Q (as successfully changed or if no)-.1 E F2(mode)2.5 E F0(ar)2.5 E (gument w)-.18 E(as supplied, and f)-.1 E(alse otherwise.)-.1 E F1 -(unalias)108 470.4 Q F0<5bad>2.5 E F1(a)A F0 2.5(][)C F2(name)-2.5 E F0 -(...])2.5 E(Remo)144 482.4 Q 1.955 -.15(ve e)-.15 H(ach).15 E F2(name) +(unalias)108 494.4 Q F0<5bad>2.5 E F1(a)A F0 2.5(][)C F2(name)-2.5 E F0 +(...])2.5 E(Remo)144 506.4 Q 1.955 -.15(ve e)-.15 H(ach).15 E F2(name) 4.155 E F0 1.655(from the list of de\214ned aliases.)4.155 F(If)6.655 E F1<ad61>4.155 E F0 1.655(is supplied, all alias de\214nitions are)4.155 -F(remo)144 494.4 Q -.15(ve)-.15 G 2.5(d. The).15 F(return v)2.5 E +F(remo)144 518.4 Q -.15(ve)-.15 G 2.5(d. The).15 F(return v)2.5 E (alue is true unless a supplied)-.25 E F2(name)2.86 E F0 -(is not a de\214ned alias.)2.68 E F1(unset)108 511.2 Q F0<5bad>2.5 E F1 +(is not a de\214ned alias.)2.68 E F1(unset)108 535.2 Q F0<5bad>2.5 E F1 (fv)A F0 2.5(][)C<ad>-2.5 E F1(n)A F0 2.5(][)C F2(name)-2.5 E F0(...]) -2.5 E -.15(Fo)144 523.2 S 3.828(re).15 G(ach)-3.828 E F2(name)3.828 E F0 +2.5 E -.15(Fo)144 547.2 S 3.828(re).15 G(ach)-3.828 E F2(name)3.828 E F0 3.828(,r).18 G(emo)-3.828 E 1.628 -.15(ve t)-.15 H 1.328 (he corresponding v).15 F 1.327(ariable or function.)-.25 F 1.327 (If the)6.327 F F1<ad76>3.827 E F0 1.327(option is gi)3.827 F -.15(ve) --.25 G 1.327(n, each).15 F F2(name)144.36 535.2 Q F0 1.55 +-.25 G 1.327(n, each).15 F F2(name)144.36 559.2 Q F0 1.55 (refers to a shell v)4.23 F 1.551(ariable, and that v)-.25 F 1.551 (ariable is remo)-.25 F -.15(ve)-.15 G 4.051(d. Read-only).15 F -.25(va) -4.051 G 1.551(riables may not be).25 F 4.642(unset. If)144 547.2 R F1 +4.051 G 1.551(riables may not be).25 F 4.642(unset. If)144 571.2 R F1 <ad66>4.642 E F0 2.142(is speci\214ed, each)4.642 F F2(name)5.001 E F0 2.141(refers to a shell function, and the function de\214nition is)4.821 -F(remo)144 559.2 Q -.15(ve)-.15 G 2.537(d. If).15 F(the)2.537 E F1<ad6e> +F(remo)144 583.2 Q -.15(ve)-.15 G 2.537(d. If).15 F(the)2.537 E F1<ad6e> 2.537 E F0 .037(option is supplied, and)2.537 F F2(name)2.537 E F0 .037 (is a v)2.537 F .037(ariable with the)-.25 F F2(namer)2.537 E(ef)-.37 E F0(attrib)2.537 E(ute,)-.2 E F2(name)2.537 E F0(will)2.538 E .492 -(be unset rather than the v)144 571.2 R .492(ariable it references.)-.25 +(be unset rather than the v)144 595.2 R .492(ariable it references.)-.25 F F1<ad6e>5.492 E F0 .492(has no ef)2.992 F .492(fect if the)-.25 F F1 <ad66>2.992 E F0 .492(option is supplied.)2.992 F .492(If no)5.492 F .22 -(options are supplied, each)144 583.2 R F2(name)2.72 E F0 .22 +(options are supplied, each)144 607.2 R F2(name)2.72 E F0 .22 (refers to a v)2.72 F .221(ariable; if there is no v)-.25 F .221 (ariable by that name, an)-.25 F 2.721(yf)-.15 G(unc-)-2.721 E 1.189 -(tion with that name is unset.)144 595.2 R 1.189(Each unset v)6.189 F +(tion with that name is unset.)144 619.2 R 1.189(Each unset v)6.189 F 1.189(ariable or function is remo)-.25 F -.15(ve)-.15 G 3.688(df).15 G 1.188(rom the en)-3.688 F(vironment)-.4 E 3.205 -(passed to subsequent commands.)144 607.2 R 3.206(If an)8.206 F 5.706 +(passed to subsequent commands.)144 631.2 R 3.206(If an)8.206 F 5.706 (yo)-.15 G(f)-5.706 E/F3 9/Times-Bold@0 SF(COMP_W)5.706 E(ORDBREAKS)-.09 E/F4 9/Times-Roman@0 SF(,)A F3(RANDOM)5.456 E F4(,)A F3(SECONDS)5.456 E -F4(,)A F3(LINENO)144 619.2 Q F4(,)A F3(HISTCMD)4.348 E F4(,)A F3(FUNCN) +F4(,)A F3(LINENO)144 643.2 Q F4(,)A F3(HISTCMD)4.348 E F4(,)A F3(FUNCN) 4.348 E(AME)-.18 E F4(,)A F3(GR)4.348 E(OUPS)-.27 E F4(,)A F0(or)4.348 E F3(DIRST)4.598 E -.495(AC)-.81 G(K).495 E F0 2.098(are unset, the)4.348 F 4.597(yl)-.15 G 2.097(ose their special)-4.597 F(properties, e)144 -631.2 Q -.15(ve)-.25 G 2.5(ni).15 G 2.5(ft)-2.5 G(he)-2.5 E 2.5(ya)-.15 +655.2 Q -.15(ve)-.25 G 2.5(ni).15 G 2.5(ft)-2.5 G(he)-2.5 E 2.5(ya)-.15 G(re subsequently reset.)-2.5 E(The e)5 E(xit status is true unless a) --.15 E F2(name)2.86 E F0(is readonly)2.68 E(.)-.65 E F1(wait)108 648 Q -F0([)2.5 E F2 2.5(n.)C(..)-2.5 E F0(])A -.8(Wa)144 660 S .288 +-.15 E F2(name)2.86 E F0(is readonly)2.68 E(.)-.65 E F1(wait)108 672 Q +F0([)2.5 E F2 2.5(n.)C(..)-2.5 E F0(])A -.8(Wa)144 684 S .288 (it for each speci\214ed process and return its termination status.).8 F (Each)5.288 E F2(n)3.148 E F0 .288(may be a process ID or a)3.028 F .722 -(job speci\214cation; if a job spec is gi)144 672 R -.15(ve)-.25 G .722 +(job speci\214cation; if a job spec is gi)144 696 R -.15(ve)-.25 G .722 (n, all processes in that job').15 F 3.222(sp)-.55 G .722(ipeline are w) -3.222 F .722(aited for)-.1 F 5.722(.I)-.55 G(f)-5.722 E F2(n)3.582 E F0 -(is)3.462 E 1.265(not gi)144 684 R -.15(ve)-.25 G 1.265 +(is)3.462 E 1.265(not gi)144 708 R -.15(ve)-.25 G 1.265 (n, all currently acti).15 F 1.565 -.15(ve c)-.25 H 1.265 (hild processes are w).15 F 1.265(aited for)-.1 F 3.765(,a)-.4 G 1.266 (nd the return status is zero.)-3.765 F(If)6.266 E F2(n)4.126 E F0 .457 -(speci\214es a non-e)144 696 R .457 +(speci\214es a non-e)144 720 R .457 (xistent process or job, the return status is 127.)-.15 F .457 -(Otherwise, the return status is the)5.457 F -.15(ex)144 708 S -(it status of the last process or job w).15 E(aited for)-.1 E(.)-.55 E -(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(22)198.725 E 0 Cg EP +(Otherwise, the return status is the)5.457 F(GNU Bash-4.2)72 768 Q +(2004 Apr 20)148.735 E(22)198.725 E 0 Cg EP %%Page: 23 23 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48 -(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10.95 -/Times-Bold@0 SF(SEE ALSO)72 84 Q F0(bash\(1\), sh\(1\))108 96 Q -(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(23)198.725 E 0 Cg EP +(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E -.15(ex)144 +84 S(it status of the last process or job w).15 E(aited for)-.1 E(.)-.55 +E/F1 10.95/Times-Bold@0 SF(SEE ALSO)72 100.8 Q F0(bash\(1\), sh\(1\))108 +112.8 Q(GNU Bash-4.2)72 768 Q(2004 Apr 20)148.735 E(23)198.725 E 0 Cg EP %%Trailer end %%EOF diff --git a/doc/rbash.ps b/doc/rbash.ps index 77d1f2b7..dc733fcf 100644 --- a/doc/rbash.ps +++ b/doc/rbash.ps @@ -1,6 +1,6 @@ %!PS-Adobe-3.0 %%Creator: groff version 1.19.2 -%%CreationDate: Thu Jul 5 20:43:03 2012 +%%CreationDate: Mon Jul 16 16:12:25 2012 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%DocumentSuppliedResources: procset grops 1.19 2 |