X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=shell%2FConfig.in;h=57969f02cdf00f054573a2508ac64becdcb78264;hb=e18255d1dadc9686daa328fa121423b47d2f6af4;hp=3f5d53222e61d99d2b0c3582e9d0bc050f78d984;hpb=c9f20d9fb93c6c316518483fd103f3afab5cf1af;p=oweals%2Fbusybox.git diff --git a/shell/Config.in b/shell/Config.in index 3f5d53222..57969f02c 100644 --- a/shell/Config.in +++ b/shell/Config.in @@ -3,206 +3,358 @@ # see scripts/kbuild/config-language.txt. # -menu "Bourne Shell" +menu "Shells" choice prompt "Choose your default shell" - default "ash" + default FEATURE_SH_IS_NONE help - Please submit a patch to add help text for this item. + Choose a shell. The ash shell is the most bash compatible + and full featured one. -config CONFIG_FEATURE_SH_IS_ASH +config FEATURE_SH_IS_ASH + select ASH bool "ash" -config CONFIG_FEATURE_SH_IS_HUSH +config FEATURE_SH_IS_HUSH + select HUSH bool "hush" -config CONFIG_FEATURE_SH_IS_LASH - bool "lash" +####config FEATURE_SH_IS_LASH +#### select LASH +#### bool "lash" -config CONFIG_FEATURE_SH_IS_MSH +config FEATURE_SH_IS_MSH + select MSH bool "msh" -endchoice +config FEATURE_SH_IS_NONE + bool "none" -if CONFIG_FEATURE_SH_IS_ASH - config CONFIG_ASH - default y +endchoice - comment "ash (forced enabled as default shell)" -endif - -if !CONFIG_FEATURE_SH_IS_ASH -config CONFIG_ASH +config ASH bool "ash" - default y + default n help - Please submit a patch to add help text for this item. -endif + 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. comment "Ash Shell Options" - depends on CONFIG_ASH + depends on ASH -config CONFIG_ASH_JOB_CONTROL - bool " Enable Job control" +config ASH_BASH_COMPAT + bool "bash-compatible extensions" default y - depends on CONFIG_ASH + depends on ASH help - Please submit a patch to add help text for this item. + Enable bash-compatible extensions. -config CONFIG_ASH_ALIAS - bool " Enable alias support" +config ASH_JOB_CONTROL + bool "Job control" default y - depends on CONFIG_ASH + depends on ASH help - Please submit a patch to add help text for this item. + Enable job control in the ash shell. -config CONFIG_ASH_MATH_SUPPORT - bool " Enable Posix math support" - default y - depends on CONFIG_ASH +config ASH_READ_NCHARS + bool "'read -n N' and 'read -s' support" + default n + depends on ASH help - Please submit a patch to add help text for this item. + 'read -n N' will return a value after N characters have been read. + 'read -s' will read without echoing the user's input. -config CONFIG_ASH_GETOPTS - bool " Enable getopt builtin to parse positional parameters" +config ASH_READ_TIMEOUT + bool "'read -t S' support" default n - depends on CONFIG_ASH + depends on ASH help - Please submit a patch to add help text for this item. + 'read -t S' will return a value after S seconds have passed. + This implementation will allow fractional seconds, expressed + as a decimal fraction, e.g. 'read -t 2.5 foo'. -config CONFIG_ASH_CMDCMD - bool " Enable cmdcmd to override shell builtins" +config ASH_ALIAS + bool "alias support" + default y + depends on ASH + help + Enable alias support in the ash shell. + +config ASH_GETOPTS + bool "Builtin getopt to parse positional parameters" default n - depends on CONFIG_ASH + depends on ASH help - Please submit a patch to add help text for this item. + Enable getopts builtin in the ash shell. -config CONFIG_ASH_MAIL - bool " Check for new mail on interactive shells" +config ASH_BUILTIN_ECHO + bool "Builtin version of 'echo'" default y - depends on CONFIG_ASH + depends on ASH help - Please submit a patch to add help text for this item. + Enable support for echo, builtin to ash. -config CONFIG_ASH_OPTIMIZE_FOR_SIZE - bool " Optimize for size instead of speed" +config ASH_BUILTIN_PRINTF + bool "Builtin version of 'printf'" default y - depends on CONFIG_ASH + depends on ASH help - Please submit a patch to add help text for this item. + Enable support for printf, builtin to ash. -config CONFIG_FEATURE_COMMAND_SAVEHISTORY - bool " history saving" +config ASH_BUILTIN_TEST + bool "Builtin version of 'test'" + default y + depends on ASH + help + Enable support for test, builtin to ash. + +config ASH_CMDCMD + bool "'command' command to override shell builtins" default n - depends on CONFIG_ASH + depends on ASH + help + Enable support for the ash 'command' builtin, which allows + you to run the specified command with the specified arguments, + even when there is an ash builtin command with the same name. + +config ASH_MAIL + bool "Check for new mail on interactive shells" + default y + depends on ASH help - Please submit a patch to add help text for this item. + Enable "check for new mail" in the ash shell. -if CONFIG_FEATURE_SH_IS_HUSH - config CONFIG_HUSH +config ASH_OPTIMIZE_FOR_SIZE + bool "Optimize for size instead of speed" default y + depends on ASH + help + Compile ash for reduced size at the price of speed. + +config ASH_RANDOM_SUPPORT + bool "Pseudorandom generator and $RANDOM variable" + default n + depends on 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. + +config ASH_EXPAND_PRMT + bool "Expand prompt string" + default n + depends on 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. - comment "hush (forced enabled as default shell)" -endif - -if !CONFIG_FEATURE_SH_IS_HUSH -config CONFIG_HUSH +config HUSH bool "hush" default n help - Please submit a patch to add help text for this item. -endif + hush is a small shell (22k). 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. -if CONFIG_FEATURE_SH_IS_LASH - config CONFIG_LASH - default y + It will compile and work on no-mmu systems. - comment "lash (forced enabled as default shell)" -endif + It does not handle select, aliases, brace expansion, + tilde expansion, &>file and >&file redirection of stdout+stderr. -if !CONFIG_FEATURE_SH_IS_LASH -config CONFIG_LASH - bool "lash" +config HUSH_HELP + bool "help builtin" default n + depends on HUSH help - Please submit a patch to add help text for this item. -endif + Enable help builtin in hush. Code size + ~1 kbyte. -if CONFIG_FEATURE_SH_IS_MSH - config CONFIG_MSH +config HUSH_INTERACTIVE + bool "Interactive mode" default y + depends on 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 the file. + No prompt, no PS1/PS2 magic shell variables. - comment "msh (forced enabled as default shell)" -endif +config HUSH_JOB + bool "Job control" + default n + depends on 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. + +config HUSH_TICK + bool "Process substitution" + default n + depends on HUSH + help + Enable process substitution `command` and $(command) in hush. -if !CONFIG_FEATURE_SH_IS_MSH -config CONFIG_MSH - bool "msh" +config HUSH_IF + bool "Support if/then/elif/else/fi" default n + depends on HUSH help - Please submit a patch to add help text for this item. -endif + Enable if/then/elif/else/fi in hush. +config HUSH_LOOPS + bool "Support for, while and until loops" + default n + depends on HUSH + help + Enable for, while and until loops in hush. -comment "Bourne Shell Options" - depends on CONFIG_MSH || CONFIG_LASH || CONFIG_HUSH || CONFIG_ASH +config HUSH_CASE + bool "Support case ... esac statement" + default n + depends on HUSH + help + Enable case ... esac statement in hush. +400 bytes. -config CONFIG_FEATURE_COMMAND_EDITING - bool "command line editing" +config HUSH_FUNCTIONS + bool "Support funcname() { commands; } syntax" default n - depends on CONFIG_MSH || CONFIG_LASH || CONFIG_HUSH || CONFIG_ASH + depends on HUSH help - Please submit a patch to add help text for this item. + Enable support for shell functions in hush. +800 bytes. -config CONFIG_FEATURE_COMMAND_TAB_COMPLETION - bool "tab completion" +config HUSH_EXPORT_N + bool "Support export '-n' option" default n - depends on CONFIG_MSH || CONFIG_LASH || CONFIG_HUSH || CONFIG_ASH + depends on HUSH help - Please submit a patch to add help text for this item. + Enable support for export '-n' option in hush. It is a bash extension. -config CONFIG_FEATURE_COMMAND_USERNAME_COMPLETION - bool "username completion" +config LASH + bool "lash (deprecated: aliased to hush)" default n - depends on CONFIG_MSH || CONFIG_LASH || CONFIG_HUSH || CONFIG_ASH + select HUSH help - Please submit a patch to add help text for this item. + lash is deprecated and will be removed, please migrate to hush. -config CONFIG_FEATURE_COMMAND_HISTORY - int "history size" - default 15 - depends on CONFIG_MSH || CONFIG_LASH || CONFIG_HUSH || CONFIG_ASH +config MSH + bool "msh (deprecated: please use hush)" + default n help - Please submit a patch to add help text for this item. + msh is deprecated and will be removed, please migrate to hush. + If there is a feature msh has but hush does not, please let us know. -config CONFIG_FEATURE_SH_STANDALONE_SHELL - bool "Standalone shell" +# The minix shell (adds just 30k) is quite complete and handles things +# like for/do/done, case/esac and all the things you expect a Bourne +# shell to do. It is not always pedantically correct about Bourne +# shell grammar (try running the shell testscript "tests/sh.testcases" +# on it and compare vs bash) but for most things it works quite well. +# It uses only vfork, so it can be used on uClinux systems. + + +comment "Bourne Shell Options" + depends on MSH || LASH || HUSH || ASH + +config SH_MATH_SUPPORT + bool "POSIX math support" + default y + depends on ASH || HUSH + help + Enable math support in the shell via $((...)) syntax. + +config SH_MATH_SUPPORT_64 + bool "Extend POSIX math support to 64 bit" default n - depends on CONFIG_MSH || CONFIG_LASH || CONFIG_HUSH || CONFIG_ASH + depends on SH_MATH_SUPPORT help - Please submit a patch to add help text for this item. + 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 CONFIG_FEATURE_SH_APPLETS_ALWAYS_WIN - bool "Standalone shell -- applets always win" +config FEATURE_SH_EXTRA_QUIET + bool "Hide message on interactive shell startup" default n - depends on CONFIG_MSH || CONFIG_LASH || CONFIG_HUSH || CONFIG_ASH + depends on MSH || LASH || HUSH || ASH help - Please submit a patch to add help text for this item. + Remove the busybox introduction when starting a shell. -config CONFIG_FEATURE_SH_FANCY_PROMPT - bool "Fancy shell prompts" +config FEATURE_SH_STANDALONE + bool "Standalone shell" default n - depends on CONFIG_MSH || CONFIG_LASH || CONFIG_HUSH || CONFIG_ASH + depends on (MSH || LASH || HUSH || ASH) && FEATURE_PREFER_APPLETS help - Please submit a patch to add help text for this item. + 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. Some selected applets ("NOFORK" applets) + can even be executed without creating new process. + Instead, busybox will call _main() internally. + + However, this causes problems in chroot jails without mounted /proc + and with ps/top (command name can be shown as 'exe' for applets + started this way). +# untrue? +# Note that this will *also* cause applets to take precedence +# over shell builtins of the same name. So turning this on will +# eliminate any performance gained by turning on the builtin "echo" +# and "test" commands in ash. +# untrue? +# Note that when using this option, the shell will attempt to directly +# run '/bin/busybox'. If you do not have the busybox binary sitting in +# that exact location with that exact name, this option will not work at +# all. + +config FEATURE_SH_NOFORK + bool "Run 'nofork' applets directly" + default n + depends on (MSH || LASH || HUSH || ASH) && FEATURE_PREFER_APPLETS + help + This option causes busybox shells [currently only ash] + to not execute typical fork/exec/wait sequence, but call _main + directly, if possible. (Sometimes it is not possible: for example, + this is not possible in pipes). -config CONFIG_FEATURE_SH_EXTRA_QUIET - bool "Hide message on interactive shell startup" + 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 feature is relatively new. Use with care. + +config CTTYHACK + bool "cttyhack" default n - depends on CONFIG_MSH || CONFIG_LASH || CONFIG_HUSH || CONFIG_ASH help - Please submit a patch to add help text for this item. + One common problem reported on the mailing list is "can't access tty; + job control turned off" error message which typically appears when + one tries to use shell with stdin/stdout opened to /dev/console. + This device is special - it cannot be a controlling tty. -endmenu + Proper solution is to use correct device instead of /dev/console. + cttyhack provides "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). + If it detects one, it closes stdin/out/err and reopens that device. + Then it executes given program. Usage example for /etc/inittab + (for busybox init): + + ::respawn:/bin/cttyhack /bin/sh + +endmenu