Next: Bash Startup Files, Up: Bash Features [Contents][Index]
bash [long-opt] [-ir] [-abefhkmnptuvxdBCDHP] [-o option] [-O shopt_option] [argument …] bash [long-opt] [-abefhkmnptuvxdBCDHP] [-o option] [-O shopt_option] -c string [argument …] bash [long-opt] -s [-abefhkmnptuvxdBCDHP] [-o option] [-O shopt_option] [argument …]
All of the single-character options used with the set
builtin
(see The Set Builtin) can be used as options when the shell is invoked.
In addition, there are several multi-character
options that you can use. These options must appear on the command
line before the single-character options to be recognized.
--debugger
extdebug
option to the shopt
builtin).--dump-po-strings
$
’ is printed on the standard output in the GNU gettext
PO (portable object) file format. Equivalent to -D
except for the output format.--dump-strings
-D
.--help
--init-file filename
--rcfile filename
filename
(instead of ~/.bashrc
) in an interactive shell.--login
-l
.--noediting
--noprofile
/etc/profile
or any of the personal initialization files ~/.bash_profile
, ~/.bash_login
, or ~/.profile
when Bash is invoked as a login shell.--norc
~/.bashrc
initialization file in an interactive shell. This is on by default if the shell is invoked as sh
.--posix
--restricted
--verbose
-v
. Print shell input lines as they’re read.--version
There are several single-character options that may be supplied at
invocation which are not available with the set
builtin.
-c
command_string
, then exit. If there are arguments after the command_string
, the first argument is assigned to $0
and any remaining arguments are assigned to the positional parameters. The assignment to $0
sets the name of the shell, which is used in warning and error messages.-i
-l
exec -l bash
’. When the shell is not interactive, the login shell startup files will be executed. ‘exec bash -l
’ or ‘exec bash --login
’ will replace the current shell with a Bash login shell. See Bash Startup Files, for a description of the special behavior of a login shell.-r
-s
-D
$
’ is printed on the standard output. These are the strings that are subject to language translation when the current locale is not C
or POSIX
(see Locale Translation). This implies the -n
option; no commands will be executed.[-+]O [shopt_option]
shopt_option
is one of the shell options accepted by the shopt
builtin (see The Shopt Builtin). If shopt_option
is present, -O
sets the value of that option; +O
unsets it. If shopt_option
is not supplied, the names and values of the shell options accepted by shopt
are printed on the standard output. If the invocation option is +O
, the output is displayed in a format that may be reused as input.--
--
signals the end of options and disables further option processing. Any arguments after the --
are treated as filenames and arguments.
A login shell is one whose first character of argument zero is
‘-
’, or one invoked with the --login
option.
An interactive shell is one started without non-option arguments,
unless -s
is specified,
without specifying the -c
option, and whose input and output are both
connected to terminals (as determined by isatty(3)
), or one
started with the -i
option. See Interactive Shells, for more
information.
If arguments remain after option processing, and neither the
-c
nor the -s
option has been supplied, the first argument is assumed to
be the name of a file containing shell commands (see Shell Scripts).
When Bash is invoked in this fashion, $0
is set to the name of the file, and the positional parameters
are set to the remaining arguments.
Bash reads and executes commands from this file, then exits.
Bash’s exit status is the exit status of the last command executed
in the script. If no commands are executed, the exit status is 0.
Next: Bash Startup Files, Up: Bash Features [Contents][Index]