package/busybox/config/shell/Config.in

   1 #
   2 # For a description of the syntax of this configuration file,
   3 # see scripts/kbuild/config-language.txt.
   4 #
   5
   6 menu "Shells"
   7
   8 choice
   9         prompt "Choose your default shell"
  10         default BUSYBOX_CONFIG_FEATURE_SH_IS_ASH
  11         help
  12           Choose a shell. The ash shell is the most bash compatible
  13           and full featured one.
  14
  15 config BUSYBOX_CONFIG_FEATURE_SH_IS_ASH
  16         select BUSYBOX_CONFIG_ASH
  17         bool "ash"
  18
  19 config BUSYBOX_CONFIG_FEATURE_SH_IS_HUSH
  20         select BUSYBOX_CONFIG_HUSH
  21         bool "hush"
  22
  23 ####config FEATURE_SH_IS_LASH
  24 ####    select LASH
  25 ####    bool "lash"
  26
  27 config BUSYBOX_CONFIG_FEATURE_SH_IS_MSH
  28         select BUSYBOX_CONFIG_MSH
  29         bool "msh"
  30
  31 config BUSYBOX_CONFIG_FEATURE_SH_IS_NONE
  32         bool "none"
  33
  34 endchoice
  35
  36 config BUSYBOX_CONFIG_ASH
  37         bool "ash"
  38         default y
  39         help
  40           Tha 'ash' shell adds about 60k in the default configuration and is
  41           the most complete and most pedantically correct shell included with
  42           busybox. This shell is actually a derivative of the Debian 'dash'
  43           shell (by Herbert Xu), which was created by porting the 'ash' shell
  44           (written by Kenneth Almquist) from NetBSD.
  45
  46 comment "Ash Shell Options"
  47         depends on BUSYBOX_CONFIG_ASH
  48
  49 config BUSYBOX_CONFIG_ASH_BASH_COMPAT
  50         bool "bash-compatible extensions"
  51         default y
  52         depends on BUSYBOX_CONFIG_ASH
  53         help
  54           Enable bash-compatible extensions.
  55
  56 config BUSYBOX_CONFIG_ASH_JOB_CONTROL
  57         bool "Job control"
  58         default y
  59         depends on BUSYBOX_CONFIG_ASH
  60         help
  61           Enable job control in the ash shell.
  62
  63 config BUSYBOX_CONFIG_ASH_READ_NCHARS
  64         bool "'read -n N' and 'read -s' support"
  65         default n
  66         depends on BUSYBOX_CONFIG_ASH
  67         help
  68           'read -n N' will return a value after N characters have been read.
  69           'read -s' will read without echoing the user's input.
  70
  71 config BUSYBOX_CONFIG_ASH_READ_TIMEOUT
  72         bool "'read -t S' support"
  73         default y
  74         depends on BUSYBOX_CONFIG_ASH
  75         help
  76           'read -t S' will return a value after S seconds have passed.
  77           This implementation will allow fractional seconds, expressed
  78           as a decimal fraction, e.g. 'read -t 2.5 foo'.
  79
  80 config BUSYBOX_CONFIG_ASH_ALIAS
  81         bool "alias support"
  82         default y
  83         depends on BUSYBOX_CONFIG_ASH
  84         help
  85           Enable alias support in the ash shell.
  86
  87 config BUSYBOX_CONFIG_ASH_GETOPTS
  88         bool "Builtin getopt to parse positional parameters"
  89         default y
  90         depends on BUSYBOX_CONFIG_ASH
  91         help
  92           Enable getopts builtin in the ash shell.
  93
  94 config BUSYBOX_CONFIG_ASH_BUILTIN_ECHO
  95         bool "Builtin version of 'echo'"
  96         default y
  97         depends on BUSYBOX_CONFIG_ASH
  98         help
  99           Enable support for echo, builtin to ash.
 100
 101 config BUSYBOX_CONFIG_ASH_BUILTIN_PRINTF
 102         bool "Builtin version of 'printf'"
 103         default y
 104         depends on BUSYBOX_CONFIG_ASH
 105         help
 106           Enable support for printf, builtin to ash.
 107
 108 config BUSYBOX_CONFIG_ASH_BUILTIN_TEST
 109         bool "Builtin version of 'test'"
 110         default y
 111         depends on BUSYBOX_CONFIG_ASH
 112         help
 113           Enable support for test, builtin to ash.
 114
 115 config BUSYBOX_CONFIG_ASH_CMDCMD
 116         bool "'command' command to override shell builtins"
 117         default y
 118         depends on BUSYBOX_CONFIG_ASH
 119         help
 120           Enable support for the ash 'command' builtin, which allows
 121           you to run the specified command with the specified arguments,
 122           even when there is an ash builtin command with the same name.
 123
 124 config BUSYBOX_CONFIG_ASH_MAIL
 125         bool "Check for new mail on interactive shells"
 126         default n
 127         depends on BUSYBOX_CONFIG_ASH
 128         help
 129           Enable "check for new mail" in the ash shell.
 130
 131 config BUSYBOX_CONFIG_ASH_OPTIMIZE_FOR_SIZE
 132         bool "Optimize for size instead of speed"
 133         default n
 134         depends on BUSYBOX_CONFIG_ASH
 135         help
 136           Compile ash for reduced size at the price of speed.
 137
 138 config BUSYBOX_CONFIG_ASH_RANDOM_SUPPORT
 139         bool "Pseudorandom generator and $RANDOM variable"
 140         default n
 141         depends on BUSYBOX_CONFIG_ASH
 142         help
 143           Enable pseudorandom generator and dynamic variable "$RANDOM".
 144           Each read of "$RANDOM" will generate a new pseudorandom value.
 145           You can reset the generator by using a specified start value.
 146           After "unset RANDOM" the generator will switch off and this
 147           variable will no longer have special treatment.
 148
 149 config BUSYBOX_CONFIG_ASH_EXPAND_PRMT
 150         bool "Expand prompt string"
 151         default y
 152         depends on BUSYBOX_CONFIG_ASH
 153         help
 154           "PS#" may contain volatile content, such as backquote commands.
 155           This option recreates the prompt string from the environment
 156           variable each time it is displayed.
 157
 158 config BUSYBOX_CONFIG_HUSH
 159         bool "hush"
 160         default n
 161         help
 162           hush is a small shell (22k). It handles the normal flow control
 163           constructs such as if/then/elif/else/fi, for/in/do/done, while loops,
 164           case/esac. Redirections, here documents, $((arithmetic))
 165           and functions are supported.
 166
 167           It will compile and work on no-mmu systems.
 168
 169           It does not handle select, aliases, brace expansion,
 170           tilde expansion, &>file and >&file redirection of stdout+stderr.
 171
 172 config BUSYBOX_CONFIG_HUSH_HELP
 173         bool "help builtin"
 174         default n
 175         depends on BUSYBOX_CONFIG_HUSH
 176         help
 177           Enable help builtin in hush. Code size + ~1 kbyte.
 178
 179 config BUSYBOX_CONFIG_HUSH_INTERACTIVE
 180         bool "Interactive mode"
 181         default n
 182         depends on BUSYBOX_CONFIG_HUSH
 183         help
 184           Enable interactive mode (prompt and command editing).
 185           Without this, hush simply reads and executes commands
 186           from stdin just like a shell script from the file.
 187           No prompt, no PS1/PS2 magic shell variables.
 188
 189 config BUSYBOX_CONFIG_HUSH_JOB
 190         bool "Job control"
 191         default n
 192         depends on BUSYBOX_CONFIG_HUSH_INTERACTIVE
 193         help
 194           Enable job control: Ctrl-Z backgrounds, Ctrl-C interrupts current
 195           command (not entire shell), fg/bg builtins work. Without this option,
 196           "cmd &" still works by simply spawning a process and immediately
 197           prompting for next command (or executing next command in a script),
 198           but no separate process group is formed.
 199
 200 config BUSYBOX_CONFIG_HUSH_TICK
 201         bool "Process substitution"
 202         default n
 203         depends on BUSYBOX_CONFIG_HUSH
 204         help
 205           Enable process substitution `command` and $(command) in hush.
 206
 207 config BUSYBOX_CONFIG_HUSH_IF
 208         bool "Support if/then/elif/else/fi"
 209         default n
 210         depends on BUSYBOX_CONFIG_HUSH
 211         help
 212           Enable if/then/elif/else/fi in hush.
 213
 214 config BUSYBOX_CONFIG_HUSH_LOOPS
 215         bool "Support for, while and until loops"
 216         default n
 217         depends on BUSYBOX_CONFIG_HUSH
 218         help
 219           Enable for, while and until loops in hush.
 220
 221 config BUSYBOX_CONFIG_HUSH_CASE
 222         bool "Support case ... esac statement"
 223         default n
 224         depends on BUSYBOX_CONFIG_HUSH
 225         help
 226           Enable case ... esac statement in hush. +400 bytes.
 227
 228 config BUSYBOX_CONFIG_HUSH_FUNCTIONS
 229         bool "Support funcname() { commands; } syntax"
 230         default n
 231         depends on BUSYBOX_CONFIG_HUSH
 232         help
 233           Enable support for shell functions in hush. +800 bytes.
 234
 235 config BUSYBOX_CONFIG_LASH
 236         bool "lash (deprecated: aliased to hush)"
 237         default n
 238         select BUSYBOX_CONFIG_HUSH
 239         help
 240           lash is deprecated and will be removed, please migrate to hush.
 241
 242 config BUSYBOX_CONFIG_MSH
 243         bool "msh (deprecated: please use hush)"
 244         default n
 245         help
 246           msh is deprecated and will be removed, please migrate to hush.
 247           If there is a feature msh has but hush does not, please let us know.
 248
 249 #         The minix shell (adds just 30k) is quite complete and handles things
 250 #         like for/do/done, case/esac and all the things you expect a Bourne
 251 #         shell to do. It is not always pedantically correct about Bourne
 252 #         shell grammar (try running the shell testscript "tests/sh.testcases"
 253 #         on it and compare vs bash) but for most things it works quite well.
 254 #         It uses only vfork, so it can be used on uClinux systems.
 255
 256
 257 comment "Bourne Shell Options"
 258         depends on BUSYBOX_CONFIG_MSH || BUSYBOX_CONFIG_LASH || BUSYBOX_CONFIG_HUSH || BUSYBOX_CONFIG_ASH
 259
 260 config BUSYBOX_CONFIG_SH_MATH_SUPPORT
 261         bool "POSIX math support"
 262         default y
 263         depends on BUSYBOX_CONFIG_ASH || BUSYBOX_CONFIG_HUSH
 264         help
 265           Enable math support in the shell via $((...)) syntax.
 266
 267 config BUSYBOX_CONFIG_SH_MATH_SUPPORT_64
 268         bool "Extend POSIX math support to 64 bit"
 269         default y
 270         depends on BUSYBOX_CONFIG_SH_MATH_SUPPORT
 271         help
 272           Enable 64-bit math support in the shell. This will make the shell
 273           slightly larger, but will allow computation with very large numbers.
 274           This is not in POSIX, so do not rely on this in portable code.
 275
 276 config BUSYBOX_CONFIG_FEATURE_SH_EXTRA_QUIET
 277         bool "Hide message on interactive shell startup"
 278         default n
 279         depends on BUSYBOX_CONFIG_MSH || BUSYBOX_CONFIG_LASH || BUSYBOX_CONFIG_HUSH || BUSYBOX_CONFIG_ASH
 280         help
 281           Remove the busybox introduction when starting a shell.
 282
 283 config BUSYBOX_CONFIG_FEATURE_SH_STANDALONE
 284         bool "Standalone shell"
 285         default n
 286         depends on (BUSYBOX_CONFIG_MSH || BUSYBOX_CONFIG_LASH || BUSYBOX_CONFIG_HUSH || BUSYBOX_CONFIG_ASH) && BUSYBOX_CONFIG_FEATURE_PREFER_APPLETS
 287         help
 288           This option causes busybox shells to use busybox applets
 289           in preference to executables in the PATH whenever possible. For
 290           example, entering the command 'ifconfig' into the shell would cause
 291           busybox to use the ifconfig busybox applet. Specifying the fully
 292           qualified executable name, such as '/sbin/ifconfig' will still
 293           execute the /sbin/ifconfig executable on the filesystem. This option
 294           is generally used when creating a statically linked version of busybox
 295           for use as a rescue shell, in the event that you screw up your system.
 296
 297           This is implemented by re-execing /proc/self/exe (typically)
 298           with right parameters. Some selected applets ("NOFORK" applets)
 299           can even be executed without creating new process.
 300           Instead, busybox will call <applet>_main() internally.
 301
 302           However, this causes problems in chroot jails without mounted /proc
 303           and with ps/top (command name can be shown as 'exe' for applets
 304           started this way).
 305 # untrue?
 306 #         Note that this will *also* cause applets to take precedence
 307 #         over shell builtins of the same name. So turning this on will
 308 #         eliminate any performance gained by turning on the builtin "echo"
 309 #         and "test" commands in ash.
 310 # untrue?
 311 #         Note that when using this option, the shell will attempt to directly
 312 #         run '/bin/busybox'. If you do not have the busybox binary sitting in
 313 #         that exact location with that exact name, this option will not work at
 314 #         all.
 315
 316 config BUSYBOX_CONFIG_FEATURE_SH_NOFORK
 317         bool "Run 'nofork' applets directly"
 318         default n
 319         depends on (BUSYBOX_CONFIG_MSH || BUSYBOX_CONFIG_LASH || BUSYBOX_CONFIG_HUSH || BUSYBOX_CONFIG_ASH) && BUSYBOX_CONFIG_FEATURE_PREFER_APPLETS
 320         help
 321           This option causes busybox shells [currently only ash]
 322           to not execute typical fork/exec/wait sequence, but call <applet>_main
 323           directly, if possible. (Sometimes it is not possible: for example,
 324           this is not possible in pipes).
 325
 326           This will be done only for some applets (those which are marked
 327           NOFORK in include/applets.h).
 328
 329           This may significantly speed up some shell scripts.
 330
 331           This feature is relatively new. Use with care.
 332
 333 config BUSYBOX_CONFIG_CTTYHACK
 334         bool "cttyhack"
 335         default n
 336         help
 337           One common problem reported on the mailing list is "can't access tty;
 338           job control turned off" error message which typically appears when
 339           one tries to use shell with stdin/stdout opened to /dev/console.
 340           This device is special - it cannot be a controlling tty.
 341
 342           Proper solution is to use correct device instead of /dev/console.
 343
 344           cttyhack provides "quick and dirty" solution to this problem.
 345           It analyzes stdin with various ioctls, trying to determine whether
 346           it is a /dev/ttyN or /dev/ttySN (virtual terminal or serial line).
 347           If it detects one, it closes stdin/out/err and reopens that device.
 348           Then it executes given program. Usage example for /etc/inittab
 349           (for busybox init):
 350
 351           ::respawn:/bin/cttyhack /bin/sh
 352
 353 endmenu