diff options
Diffstat (limited to 'config/busybox/shell/Config.in')
| -rw-r--r-- | config/busybox/shell/Config.in | 312 |
1 files changed, 164 insertions, 148 deletions
diff --git a/config/busybox/shell/Config.in b/config/busybox/shell/Config.in index 201dcfeec..f89db4299 100644 --- a/config/busybox/shell/Config.in +++ b/config/busybox/shell/Config.in @@ -11,26 +11,26 @@ choice prompt "Choose which shell is aliased to 'sh' name" default BUSYBOX_SH_IS_ASH help - Choose which shell you want to be executed by 'sh' alias. - The ash shell is the most bash compatible and full featured one. + Choose which shell you want to be executed by 'sh' alias. + The ash shell is the most bash compatible and full featured one. # note: cannot use "select ASH" here, it breaks "make allnoconfig" config BUSYBOX_SH_IS_ASH depends on !BUSYBOX_NOMMU bool "ash" help - Choose ash to be the shell executed by 'sh' name. - The ash code will be built into busybox. If you don't select - "ash" choice (CONFIG_ASH), this shell may only be invoked by - the name 'sh' (and not 'ash'). + Choose ash to be the shell executed by 'sh' name. + The ash code will be built into busybox. If you don't select + "ash" choice (CONFIG_ASH), this shell may only be invoked by + the name 'sh' (and not 'ash'). config BUSYBOX_SH_IS_HUSH bool "hush" help - Choose hush to be the shell executed by 'sh' name. - The hush code will be built into busybox. If you don't select - "hush" choice (CONFIG_HUSH), this shell may only be invoked by - the name 'sh' (and not 'hush'). + Choose hush to be the shell executed by 'sh' name. + The hush code will be built into busybox. If you don't select + "hush" choice (CONFIG_HUSH), this shell may only be invoked by + the name 'sh' (and not 'hush'). config BUSYBOX_SH_IS_NONE bool "none" @@ -41,36 +41,36 @@ choice prompt "Choose which shell is aliased to 'bash' name" default BUSYBOX_BASH_IS_NONE help - Choose which shell you want to be executed by 'bash' alias. - The ash shell is the most bash compatible and full featured one, - although compatibility is far from being complete. + Choose which shell you want to be executed by 'bash' alias. + The ash shell is the most bash compatible and full featured one, + although compatibility is far from being complete. - Note that selecting this option does not switch on any bash - compatibility code. It merely makes it possible to install - /bin/bash (sym)link and run scripts which start with - #!/bin/bash line. + Note that selecting this option does not switch on any bash + compatibility code. It merely makes it possible to install + /bin/bash (sym)link and run scripts which start with + #!/bin/bash line. - Many systems use it in scripts which use bash-specific features, - even simple ones like $RANDOM. Without this option, busybox - can't be used for running them because it won't recongnize - "bash" as a supported applet name. + Many systems use it in scripts which use bash-specific features, + even simple ones like $RANDOM. Without this option, busybox + can't be used for running them because it won't recongnize + "bash" as a supported applet name. config BUSYBOX_BASH_IS_ASH depends on !BUSYBOX_NOMMU bool "ash" help - Choose ash to be the shell executed by 'bash' name. - The ash code will be built into busybox. If you don't select - "ash" choice (CONFIG_ASH), this shell may only be invoked by - the name 'bash' (and not 'ash'). + Choose ash to be the shell executed by 'bash' name. + The ash code will be built into busybox. If you don't select + "ash" choice (CONFIG_ASH), this shell may only be invoked by + the name 'bash' (and not 'ash'). config BUSYBOX_BASH_IS_HUSH bool "hush" help - Choose hush to be the shell executed by 'bash' name. - The hush code will be built into busybox. If you don't select - "hush" choice (CONFIG_HUSH), this shell may only be invoked by - the name 'bash' (and not 'hush'). + Choose hush to be the shell executed by 'bash' name. + The hush code will be built into busybox. If you don't select + "hush" choice (CONFIG_HUSH), this shell may only be invoked by + the name 'bash' (and not 'hush'). config BUSYBOX_BASH_IS_NONE bool "none" @@ -79,15 +79,14 @@ endchoice config BUSYBOX_ASH - bool "ash" + bool "ash (77 kb)" default y depends on !BUSYBOX_NOMMU help - Tha 'ash' shell adds about 60k in the default configuration and is - the most complete and most pedantically correct shell included with - busybox. This shell is actually a derivative of the Debian 'dash' - shell (by Herbert Xu), which was created by porting the 'ash' shell - (written by Kenneth Almquist) from NetBSD. + The most complete and most pedantically correct shell included with + busybox. This shell is actually a derivative of the Debian 'dash' + shell (by Herbert Xu), which was created by porting the 'ash' shell + (written by Kenneth Almquist) from NetBSD. # ash options # note: Don't remove !NOMMU part in the next line; it would break @@ -104,11 +103,11 @@ config BUSYBOX_ASH_INTERNAL_GLOB default y # Y is bigger, but because of uclibc glob() bug, let Y be default for now depends on BUSYBOX_ASH || BUSYBOX_SH_IS_ASH || BUSYBOX_BASH_IS_ASH help - Do not use glob() function from libc, use internal implementation. - Use this if you are getting "glob.h: No such file or directory" - or similar build errors. - Note that as of now (2017-01), uclibc and musl glob() both have bugs - which would break ash if you select N here. + Do not use glob() function from libc, use internal implementation. + Use this if you are getting "glob.h: No such file or directory" + or similar build errors. + Note that as of now (2017-01), uclibc and musl glob() both have bugs + which would break ash if you select N here. config BUSYBOX_ASH_BASH_COMPAT bool "bash-compatible extensions" @@ -130,37 +129,37 @@ config BUSYBOX_ASH_RANDOM_SUPPORT default y depends on BUSYBOX_ASH || BUSYBOX_SH_IS_ASH || BUSYBOX_BASH_IS_ASH help - Enable pseudorandom generator and dynamic variable "$RANDOM". - Each read of "$RANDOM" will generate a new pseudorandom value. - You can reset the generator by using a specified start value. - After "unset RANDOM" the generator will switch off and this - variable will no longer have special treatment. + Enable pseudorandom generator and dynamic variable "$RANDOM". + Each read of "$RANDOM" will generate a new pseudorandom value. + You can reset the generator by using a specified start value. + After "unset RANDOM" the generator will switch off and this + variable will no longer have special treatment. config BUSYBOX_ASH_EXPAND_PRMT bool "Expand prompt string" default y depends on BUSYBOX_ASH || BUSYBOX_SH_IS_ASH || BUSYBOX_BASH_IS_ASH help - $PS# may contain volatile content, such as backquote commands. - This option recreates the prompt string from the environment - variable each time it is displayed. + $PS# may contain volatile content, such as backquote commands. + This option recreates the prompt string from the environment + variable each time it is displayed. config BUSYBOX_ASH_IDLE_TIMEOUT bool "Idle timeout variable $TMOUT" default y depends on BUSYBOX_ASH || BUSYBOX_SH_IS_ASH || BUSYBOX_BASH_IS_ASH help - Enable bash-like auto-logout after $TMOUT seconds of idle time. + Enable bash-like auto-logout after $TMOUT seconds of idle time. config BUSYBOX_ASH_MAIL bool "Check for new mail in interactive shell" default y depends on BUSYBOX_ASH || BUSYBOX_SH_IS_ASH || BUSYBOX_BASH_IS_ASH help - Enable "check for new mail" function: - if set, $BUSYBOX_MAIL file and $BUSYBOX_MAILPATH list of files - are checked for mtime changes, and "you have mail" - message is printed if change is detected. + Enable "check for new mail" function: + if set, $BUSYBOX_MAIL file and $BUSYBOX_MAILPATH list of files + are checked for mtime changes, and "you have mail" + message is printed if change is detected. config BUSYBOX_ASH_ECHO bool "echo builtin" @@ -192,67 +191,67 @@ config BUSYBOX_ASH_CMDCMD default y depends on BUSYBOX_ASH || BUSYBOX_SH_IS_ASH || BUSYBOX_BASH_IS_ASH help - Enable support for the 'command' builtin, which allows - you to run the specified command or builtin, - even when there is a function with the same name. + Enable support for the 'command' builtin, which allows + you to run the specified command or builtin, + even when there is a function with the same name. endif # ash options config BUSYBOX_CTTYHACK - bool "cttyhack" + bool "cttyhack (2.5 kb)" default y help - One common problem reported on the mailing list is the "can't - access tty; job control turned off" error message, which typically - appears when one tries to use a shell with stdin/stdout on - /dev/console. - This device is special - it cannot be a controlling tty. + One common problem reported on the mailing list is the "can't + access tty; job control turned off" error message, which typically + appears when one tries to use a shell with stdin/stdout on + /dev/console. + This device is special - it cannot be a controlling tty. - The proper solution is to use the correct device instead of - /dev/console. + The proper solution is to use the correct device instead of + /dev/console. - cttyhack provides a "quick and dirty" solution to this problem. - It analyzes stdin with various ioctls, trying to determine whether - it is a /dev/ttyN or /dev/ttySN (virtual terminal or serial line). - On Linux it also checks sysfs for a pointer to the active console. - If cttyhack is able to find the real console device, it closes - stdin/out/err and reopens that device. - Then it executes the given program. Opening the device will make - that device a controlling tty. This may require cttyhack - to be a session leader. + cttyhack provides a "quick and dirty" solution to this problem. + It analyzes stdin with various ioctls, trying to determine whether + it is a /dev/ttyN or /dev/ttySN (virtual terminal or serial line). + On Linux it also checks sysfs for a pointer to the active console. + If cttyhack is able to find the real console device, it closes + stdin/out/err and reopens that device. + Then it executes the given program. Opening the device will make + that device a controlling tty. This may require cttyhack + to be a session leader. - Example for /etc/inittab (for busybox init): + Example for /etc/inittab (for busybox init): - ::respawn:/bin/cttyhack /bin/sh + ::respawn:/bin/cttyhack /bin/sh - Starting an interactive shell from boot shell script: + Starting an interactive shell from boot shell script: - setsid cttyhack sh + setsid cttyhack sh - Giving controlling tty to shell running with PID 1: + Giving controlling tty to shell running with PID 1: - # exec cttyhack sh + # exec cttyhack sh - Without cttyhack, you need to know exact tty name, - and do something like this: + Without cttyhack, you need to know exact tty name, + and do something like this: - # exec setsid sh -c 'exec sh </dev/tty1 >/dev/tty1 2>&1' + # exec setsid sh -c 'exec sh </dev/tty1 >/dev/tty1 2>&1' - Starting getty on a controlling tty from a shell script: + Starting getty on a controlling tty from a shell script: - # getty 115200 $(cttyhack) + # getty 115200 $(cttyhack) config BUSYBOX_HUSH - bool "hush" + bool "hush (64 kb)" default y help - hush is a small shell (25k). It handles the normal flow control - constructs such as if/then/elif/else/fi, for/in/do/done, while loops, - case/esac. Redirections, here documents, $((arithmetic)) - and functions are supported. + hush is a small shell. It handles the normal flow control + constructs such as if/then/elif/else/fi, for/in/do/done, while loops, + case/esac. Redirections, here documents, $((arithmetic)) + and functions are supported. - It will compile and work on no-mmu systems. + It will compile and work on no-mmu systems. - It does not handle select, aliases, tilde expansion, - &>file and >&file redirection of stdout+stderr. + It does not handle select, aliases, tilde expansion, + &>file and >&file redirection of stdout+stderr. config BUSYBOX_HUSH_BASH_COMPAT bool "bash-compatible extensions" @@ -264,17 +263,17 @@ config BUSYBOX_HUSH_BRACE_EXPANSION default y depends on BUSYBOX_HUSH_BASH_COMPAT help - Enable {abc,def} extension. + Enable {abc,def} extension. config BUSYBOX_HUSH_INTERACTIVE bool "Interactive mode" default y depends on BUSYBOX_HUSH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH help - Enable interactive mode (prompt and command editing). - Without this, hush simply reads and executes commands - from stdin just like a shell script from a file. - No prompt, no PS1/PS2 magic shell variables. + Enable interactive mode (prompt and command editing). + Without this, hush simply reads and executes commands + from stdin just like a shell script from a file. + No prompt, no PS1/PS2 magic shell variables. config BUSYBOX_HUSH_SAVEHISTORY bool "Save command history to .hush_history" @@ -286,18 +285,18 @@ config BUSYBOX_HUSH_JOB default y depends on BUSYBOX_HUSH_INTERACTIVE help - Enable job control: Ctrl-Z backgrounds, Ctrl-C interrupts current - command (not entire shell), fg/bg builtins work. Without this option, - "cmd &" still works by simply spawning a process and immediately - prompting for next command (or executing next command in a script), - but no separate process group is formed. + Enable job control: Ctrl-Z backgrounds, Ctrl-C interrupts current + command (not entire shell), fg/bg builtins work. Without this option, + "cmd &" still works by simply spawning a process and immediately + prompting for next command (or executing next command in a script), + but no separate process group is formed. config BUSYBOX_HUSH_TICK bool "Support process substitution" default y depends on BUSYBOX_HUSH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH help - Enable `command` and $(command). + Enable `command` and $(command). config BUSYBOX_HUSH_IF bool "Support if/then/elif/else/fi" @@ -314,37 +313,37 @@ config BUSYBOX_HUSH_CASE default y depends on BUSYBOX_HUSH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH help - Enable case ... esac statement. +400 bytes. + Enable case ... esac statement. +400 bytes. config BUSYBOX_HUSH_FUNCTIONS bool "Support funcname() { commands; } syntax" default y depends on BUSYBOX_HUSH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH help - Enable support for shell functions. +800 bytes. + Enable support for shell functions. +800 bytes. config BUSYBOX_HUSH_LOCAL bool "local builtin" default y depends on BUSYBOX_HUSH_FUNCTIONS help - Enable support for local variables in functions. + Enable support for local variables in functions. config BUSYBOX_HUSH_RANDOM_SUPPORT bool "Pseudorandom generator and $RANDOM variable" default y depends on BUSYBOX_HUSH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH help - Enable pseudorandom generator and dynamic variable "$RANDOM". - Each read of "$RANDOM" will generate a new pseudorandom value. + Enable pseudorandom generator and dynamic variable "$RANDOM". + Each read of "$RANDOM" will generate a new pseudorandom value. config BUSYBOX_HUSH_MODE_X bool "Support 'hush -x' option and 'set -x' command" default y depends on BUSYBOX_HUSH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH help - This instructs hush to print commands before execution. - Adds ~300 bytes. + This instructs hush to print commands before execution. + Adds ~300 bytes. config BUSYBOX_HUSH_ECHO bool "echo builtin" @@ -376,7 +375,14 @@ config BUSYBOX_HUSH_EXPORT_N default y depends on BUSYBOX_HUSH_EXPORT help - export -n unexports variables. It is a bash extension. + export -n unexports variables. It is a bash extension. + +config BUSYBOX_HUSH_READONLY + bool "readonly builtin" + default y + depends on BUSYBOX_HUSH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH + help + Enable support for read-only variables. config BUSYBOX_HUSH_KILL bool "kill builtin (supports kill %jobspec)" @@ -398,6 +404,11 @@ config BUSYBOX_HUSH_TYPE default y depends on BUSYBOX_HUSH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH +config BUSYBOX_HUSH_TIMES + bool "times builtin" + default y + depends on BUSYBOX_HUSH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH + config BUSYBOX_HUSH_READ bool "read builtin" default y @@ -423,18 +434,16 @@ config BUSYBOX_HUSH_UMASK default y depends on BUSYBOX_HUSH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH +config BUSYBOX_HUSH_GETOPTS + bool "getopts builtin" + default y + depends on BUSYBOX_HUSH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH + config BUSYBOX_HUSH_MEMLEAK bool "memleak builtin (debugging)" default n depends on BUSYBOX_HUSH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH -config BUSYBOX_MSH - bool "msh (deprecated: aliased to hush)" - default n - select BUSYBOX_HUSH - help - msh is deprecated and will be removed, please migrate to hush. - comment "Options common to all shells" if BUSYBOX_ASH || BUSYBOX_HUSH || BUSYBOX_SH_IS_ASH || BUSYBOX_BASH_IS_ASH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH @@ -444,71 +453,78 @@ config BUSYBOX_FEATURE_SH_MATH default y depends on BUSYBOX_ASH || BUSYBOX_HUSH || BUSYBOX_SH_IS_ASH || BUSYBOX_BASH_IS_ASH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH help - Enable math support in the shell via $((...)) syntax. + Enable math support in the shell via $((...)) syntax. config BUSYBOX_FEATURE_SH_MATH_64 bool "Extend POSIX math support to 64 bit" default y depends on BUSYBOX_FEATURE_SH_MATH help - Enable 64-bit math support in the shell. This will make the shell - slightly larger, but will allow computation with very large numbers. - This is not in POSIX, so do not rely on this in portable code. + Enable 64-bit math support in the shell. This will make the shell + slightly larger, but will allow computation with very large numbers. + This is not in POSIX, so do not rely on this in portable code. config BUSYBOX_FEATURE_SH_EXTRA_QUIET bool "Hide message on interactive shell startup" default y depends on BUSYBOX_ASH || BUSYBOX_HUSH || BUSYBOX_SH_IS_ASH || BUSYBOX_BASH_IS_ASH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH help - Remove the busybox introduction when starting a shell. + Remove the busybox introduction when starting a shell. config BUSYBOX_FEATURE_SH_STANDALONE bool "Standalone shell" default n depends on BUSYBOX_ASH || BUSYBOX_HUSH || BUSYBOX_SH_IS_ASH || BUSYBOX_BASH_IS_ASH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH help - This option causes busybox shells to use busybox applets - in preference to executables in the PATH whenever possible. For - example, entering the command 'ifconfig' into the shell would cause - busybox to use the ifconfig busybox applet. Specifying the fully - qualified executable name, such as '/sbin/ifconfig' will still - execute the /sbin/ifconfig executable on the filesystem. This option - is generally used when creating a statically linked version of busybox - for use as a rescue shell, in the event that you screw up your system. + This option causes busybox shells to use busybox applets + in preference to executables in the PATH whenever possible. For + example, entering the command 'ifconfig' into the shell would cause + busybox to use the ifconfig busybox applet. Specifying the fully + qualified executable name, such as '/sbin/ifconfig' will still + execute the /sbin/ifconfig executable on the filesystem. This option + is generally used when creating a statically linked version of busybox + for use as a rescue shell, in the event that you screw up your system. - This is implemented by re-execing /proc/self/exe (typically) - with right parameters. + This is implemented by re-execing /proc/self/exe (typically) + with right parameters. - However, there are drawbacks: it is problematic in chroot jails - without mounted /proc, and ps/top may show command name as 'exe' - for applets started this way. + However, there are drawbacks: it is problematic in chroot jails + without mounted /proc, and ps/top may show command name as 'exe' + for applets started this way. config BUSYBOX_FEATURE_SH_NOFORK bool "Run 'nofork' applets directly" default n depends on BUSYBOX_ASH || BUSYBOX_HUSH || BUSYBOX_SH_IS_ASH || BUSYBOX_BASH_IS_ASH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH help - This option causes busybox shells to not execute typical - fork/exec/wait sequence, but call <applet>_main directly, - if possible. (BUSYBOX_Sometimes it is not possible: for example, - this is not possible in pipes). + This option causes busybox shells to not execute typical + fork/exec/wait sequence, but call <applet>_main directly, + if possible. (BUSYBOX_Sometimes it is not possible: for example, + this is not possible in pipes). + + This will be done only for some applets (those which are marked + NOFORK in include/applets.h). - This will be done only for some applets (those which are marked - NOFORK in include/applets.h). + This may significantly speed up some shell scripts. - This may significantly speed up some shell scripts. + This feature is relatively new. Use with care. Report bugs + to project mailing list. - This feature is relatively new. Use with care. Report bugs - to project mailing list. +config BUSYBOX_FEATURE_SH_READ_FRAC + bool "read -t N.NNN support (+110 bytes)" + default y + depends on BUSYBOX_ASH || BUSYBOX_HUSH || BUSYBOX_SH_IS_ASH || BUSYBOX_BASH_IS_ASH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH + help + Enable support for fractional second timeout in read builtin. config BUSYBOX_FEATURE_SH_HISTFILESIZE bool "Use $HISTFILESIZE" default y depends on BUSYBOX_ASH || BUSYBOX_HUSH || BUSYBOX_SH_IS_ASH || BUSYBOX_BASH_IS_ASH || BUSYBOX_SH_IS_HUSH || BUSYBOX_BASH_IS_HUSH help - This option makes busybox shells to use $HISTFILESIZE variable - to set shell history size. Note that its max value is capped - by "History size" setting in library tuning section. + This option makes busybox shells to use $HISTFILESIZE variable + to set shell history size. Note that its max value is capped + by "History size" setting in library tuning section. endif # Options common to all shells |