Merge branch 'master' of git+ssh://vda@busybox.net/var/lib/git/busybox
[oweals/busybox.git] / shell / Config.in
index 253752bc3281505fb6a433ddc3bbd8005cec5630..57969f02cdf00f054573a2508ac64becdcb78264 100644 (file)
@@ -20,9 +20,9 @@ config FEATURE_SH_IS_HUSH
        select HUSH
        bool "hush"
 
-config FEATURE_SH_IS_LASH
-       select LASH
-       bool "lash"
+####config FEATURE_SH_IS_LASH
+####   select LASH
+####   bool "lash"
 
 config FEATURE_SH_IS_MSH
        select MSH
@@ -36,17 +36,23 @@ endchoice
 config ASH
        bool "ash"
        default n
-       select TEST
        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'
+         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 ASH
 
+config ASH_BASH_COMPAT
+       bool "bash-compatible extensions"
+       default y
+       depends on ASH
+       help
+         Enable bash-compatible extensions.
+
 config ASH_JOB_CONTROL
        bool "Job control"
        default y
@@ -63,7 +69,7 @@ config ASH_READ_NCHARS
          'read -s' will read without echoing the user's input.
 
 config ASH_READ_TIMEOUT
-       bool "'read -t S' support."
+       bool "'read -t S' support"
        default n
        depends on ASH
        help
@@ -78,22 +84,6 @@ config ASH_ALIAS
        help
          Enable alias support in the ash shell.
 
-config ASH_MATH_SUPPORT
-       bool "Posix math support"
-       default y
-       depends on ASH
-       help
-         Enable math support in the ash shell.
-
-config ASH_MATH_SUPPORT_64
-       bool "Extend Posix math support to 64 bit"
-       default n
-       depends on ASH_MATH_SUPPORT
-       help
-         Enable 64-bit math support in the ash shell.  This will make
-         the shell slightly larger, but will allow computation with very
-         large numbers.
-
 config ASH_GETOPTS
        bool "Builtin getopt to parse positional parameters"
        default n
@@ -104,15 +94,20 @@ config ASH_GETOPTS
 config ASH_BUILTIN_ECHO
        bool "Builtin version of 'echo'"
        default y
-       select ECHO
        depends on ASH
        help
          Enable support for echo, builtin to ash.
 
+config ASH_BUILTIN_PRINTF
+       bool "Builtin version of 'printf'"
+       default y
+       depends on ASH
+       help
+         Enable support for printf, builtin to ash.
+
 config ASH_BUILTIN_TEST
        bool "Builtin version of 'test'"
        default y
-       select TEST
        depends on ASH
        help
          Enable support for test, builtin to ash.
@@ -141,14 +136,14 @@ config ASH_OPTIMIZE_FOR_SIZE
          Compile ash for reduced size at the price of speed.
 
 config ASH_RANDOM_SUPPORT
-       bool "Pseudorandom generator and variable $RANDOM"
+       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" then generator will switch off and this
+         After "unset RANDOM" the generator will switch off and this
          variable will no longer have special treatment.
 
 config ASH_EXPAND_PRMT
@@ -156,25 +151,30 @@ config ASH_EXPAND_PRMT
        default n
        depends on ASH
        help
-         "PS#" may be contain volatile content, such as backquote commands.
+         "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 HUSH
        bool "hush"
        default n
-       select TRUE
-       select FALSE
-       select TEST
        help
-         hush is a very small shell (just 18k) and it has fairly complete
-         Bourne shell grammar.  It even handles all the normal flow control
-         options such as if/then/elif/else/fi, for/in/do/done, while loops,
-         etc.
+         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.
+
+         It will compile and work on no-mmu systems.
 
-         It does not handle case/esac, select, function, here documents ( <<
-         word ), arithmetic expansion, aliases, brace expansion, tilde
-         expansion, &> and >& redirection of stdout+stderr, etc.
+         It does not handle select, aliases, brace expansion,
+         tilde expansion, &>file and >&file redirection of stdout+stderr.
+
+config HUSH_HELP
+       bool "help builtin"
+       default n
+       depends on HUSH
+       help
+         Enable help builtin in hush. Code size + ~1 kbyte.
 
 config HUSH_INTERACTIVE
        bool "Interactive mode"
@@ -197,39 +197,89 @@ config HUSH_JOB
          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.
 
-config LASH
-       bool "lash"
+config HUSH_IF
+       bool "Support if/then/elif/else/fi"
        default n
-       select TRUE
-       select FALSE
-       select TEST
+       depends on HUSH
        help
-         lash is the very smallest shell (adds just 10k) and it is quite
-         usable as a command prompt, but it is not suitable for any but the
-         most trivial scripting (such as an initrd that calls insmod a few
-         times) since it does not understand any Bourne shell grammar.  It
-         does handle pipes, redirects, and job control though.  Adding in
-         command editing makes it a very nice lightweight command prompt.
+         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.
+
+config HUSH_CASE
+       bool "Support case ... esac statement"
+       default n
+       depends on HUSH
+       help
+         Enable case ... esac statement in hush. +400 bytes.
+
+config HUSH_FUNCTIONS
+       bool "Support funcname() { commands; } syntax"
+       default n
+       depends on HUSH
+       help
+         Enable support for shell functions in hush. +800 bytes.
+
+config HUSH_EXPORT_N
+       bool "Support export '-n' option"
+       default n
+       depends on HUSH
+       help
+         Enable support for export '-n' option in hush. It is a bash extension.
+
+config LASH
+       bool "lash (deprecated: aliased to hush)"
+       default n
+       select HUSH
+       help
+         lash is deprecated and will be removed, please migrate to hush.
 
 config MSH
-       bool "msh"
+       bool "msh (deprecated: please use hush)"
        default n
-       select TRUE
-       select FALSE
-       select TEST
        help
-         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 also uses only vfork, so it can be used on uClinux systems.
+         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.
+
+#        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 SH_MATH_SUPPORT
+       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.
+
 config FEATURE_SH_EXTRA_QUIET
        bool "Hide message on interactive shell startup"
        default n
@@ -243,11 +293,11 @@ config FEATURE_SH_STANDALONE
        depends on (MSH || LASH || HUSH || ASH) && FEATURE_PREFER_APPLETS
        help
          This option causes busybox shells to use busybox applets
-         in preference to executables in the PATH whenever possible.  For
+         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
+         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
+         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.
 
@@ -261,15 +311,32 @@ config FEATURE_SH_STANDALONE
          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
+#        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
+#        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 <applet>_main
+         directly, if possible. (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 may significantly speed up some shell scripts.
+
+         This feature is relatively new. Use with care.
+
 config CTTYHACK
        bool "cttyhack"
        default n