1. Invocation Options


1.1. -c CommandString

-c [options] -- CommandString [ARG0 [ARG...]]

  • commands are read from the first non-option argument (required)
  • $0 is set as the second non-option argument defaulting to "bash"

  • all remaining non-option arguments are assigned to the positional parameters starting at $1

  • [[ $- =~ c ]] will return true

1.2. -i

-i [options]

  • force the shell into Interactive Mode

  • [[ $- =~ i ]] will return true

  • [[ ${PS1+set} = 'set' ]] will return true

Include: Nothing found for "^----$"!

1.3. -l

pragma section-numbers 1

1.4. Invocation Option l


-l | --login

  • act as a Login Shell

  • --login must appear on the command line before the single-character options to be recognized.

1.5. -r

-r

1.6. -s

-s [options] -- [ARG0 [ARG...]]

1.7. -D

-D | --dump-strings

  • A list of all double-quoted strings preceded by $ 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. This implies the -n option; no commands will be executed.

1.8. -O ShoptOption | +O ShoptOption

-O ShoptOption | +O ShoptOption

  • shopt_option is one of the shell options accepted by the shopt builtin (see SHELL BUILTIN COMMANDS below).
  • 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.

1.9. --debugger

--debugger

  • Arrange for the debugger profile to be executed before the shell starts.
  • Turns on extended debugging mode (see the description of the extdebug option to the shopt builtin below).
  • These options must appear on the command line before the single-character options to be recognized.

1.10. --dump-po-strings

--dump-po-strings

  • Equivalent to -D, but the output is in the GNU gettext po (portable object) file format.
  • These options must appear on the command line before the single-character options to be recognized.

1.11. --dump-strings

-D | --dump-strings

  • A list of all double-quoted strings preceded by $ 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. This implies the -n option; no commands will be executed.

1.12. --help

--help

  • Display a usage message on standard output and exit successfully.
  • These options must appear on the command line before the single-character options to be recognized.

Include: Nothing found for "^----$"!

1.13. --init-file

1.14. Invocation Option --rcfile


--rcfile FILE | --init-file FILE

  • Execute commands from file instead of the standard personal initialization file ~/.bashrc if the shell is interactive (see INVOCATION below).
  • An argument of --init-file is equivalent to --rcfile.
  • These options must appear on the command line before the single-character options to be recognized.

1.15. --rcfile

--rcfile FILE | --init-file FILE

  • Execute commands from file instead of the standard personal initialization file ~/.bashrc if the shell is interactive (see INVOCATION below).
  • An argument of --init-file is equivalent to --rcfile.
  • These options must appear on the command line before the single-character options to be recognized.

1.16. --login

-l | --login

  • act as a Login Shell

  • --login must appear on the command line before the single-character options to be recognized.

1.17. --noediting

--noediting

  • Do not use the GNU readline library to read command lines when the shell is interactive.
  • These options must appear on the command line before the single-character options to be recognized.

1.18. --noprofile

--noprofile

  • Do not read either the system-wide startup file /etc/profile or any of the personal initialization files ~/.bash_profile, ~/.bash_login, or ~/.profile.
  • By default, bash reads these files when it is invoked as a login shell (see INVOCATION below).
  • These options must appear on the command line before the single-character options to be recognized.

1.19. --norc

--norc

  • Do not read and execute the personal initialization file ~/.bashrc if the shell is interactive.
  • This option is on by default if the shell is invoked as sh.
  • These options must appear on the command line before the single-character options to be recognized.

1.20. --posix

--posix

  • Change the behavior of bash where the default operation differs from the POSIX standard to match the standard (posix mode).
  • See SEE ALSO below for a reference to a document that details how posix mode affects bash's behavior.
  • These options must appear on the command line before the single-character options to be recognized.

1.21. --restricted

bash/invocation/option (last edited 2017-10-21 20:06:57 by Robert Robertson)