release/src/router/busybox/shell/Config.src

   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 INSERT
   9
  10
  11 choice
  12         prompt "Choose which shell is aliased to 'sh' name"
  13         default FEATURE_SH_IS_ASH
  14         help
  15           Choose which shell you want to be executed by 'sh' alias.
  16           The ash shell is the most bash compatible and full featured one.
  17
  18 # note: cannot use "select ASH" here, it breaks "make allnoconfig"
  19 config FEATURE_SH_IS_ASH
  20         depends on ASH
  21         bool "ash"
  22         depends on !NOMMU
  23
  24 config FEATURE_SH_IS_HUSH
  25         depends on HUSH
  26         bool "hush"
  27
  28 config FEATURE_SH_IS_NONE
  29         bool "none"
  30
  31 endchoice
  32
  33 choice
  34         prompt "Choose which shell is aliased to 'bash' name"
  35         default FEATURE_BASH_IS_NONE
  36         help
  37           Choose which shell you want to be executed by 'bash' alias.
  38           The ash shell is the most bash compatible and full featured one.
  39
  40           Note that selecting this option does not switch on any bash
  41           compatibility code. It merely makes it possible to install
  42           /bin/bash (sym)link and run scripts which start with
  43           #!/bin/bash line.
  44
  45           Many systems use it in scripts which use bash-specific features,
  46           even simple ones like $RANDOM. Without this option, busybox
  47           can't be used for running them because it won't recongnize
  48           "bash" as a supported applet name.
  49
  50 config FEATURE_BASH_IS_ASH
  51         depends on ASH
  52         bool "ash"
  53         depends on !NOMMU
  54
  55 config FEATURE_BASH_IS_HUSH
  56         depends on HUSH
  57         bool "hush"
  58
  59 config FEATURE_BASH_IS_NONE
  60         bool "none"
  61
  62 endchoice
  63
  64
  65 config SH_MATH_SUPPORT
  66         bool "POSIX math support"
  67         default y
  68         depends on ASH || HUSH
  69         help
  70           Enable math support in the shell via $((...)) syntax.
  71
  72 config SH_MATH_SUPPORT_64
  73         bool "Extend POSIX math support to 64 bit"
  74         default y
  75         depends on SH_MATH_SUPPORT
  76         help
  77           Enable 64-bit math support in the shell. This will make the shell
  78           slightly larger, but will allow computation with very large numbers.
  79           This is not in POSIX, so do not rely on this in portable code.
  80
  81 config FEATURE_SH_EXTRA_QUIET
  82         bool "Hide message on interactive shell startup"
  83         default y
  84         depends on HUSH || ASH
  85         help
  86           Remove the busybox introduction when starting a shell.
  87
  88 config FEATURE_SH_STANDALONE
  89         bool "Standalone shell"
  90         default n
  91         depends on (HUSH || ASH) && FEATURE_PREFER_APPLETS
  92         help
  93           This option causes busybox shells to use busybox applets
  94           in preference to executables in the PATH whenever possible. For
  95           example, entering the command 'ifconfig' into the shell would cause
  96           busybox to use the ifconfig busybox applet. Specifying the fully
  97           qualified executable name, such as '/sbin/ifconfig' will still
  98           execute the /sbin/ifconfig executable on the filesystem. This option
  99           is generally used when creating a statically linked version of busybox
 100           for use as a rescue shell, in the event that you screw up your system.
 101
 102           This is implemented by re-execing /proc/self/exe (typically)
 103           with right parameters. Some selected applets ("NOFORK" applets)
 104           can even be executed without creating new process.
 105           Instead, busybox will call <applet>_main() internally.
 106
 107           However, this causes problems in chroot jails without mounted /proc
 108           and with ps/top (command name can be shown as 'exe' for applets
 109           started this way).
 110 # untrue?
 111 #         Note that this will *also* cause applets to take precedence
 112 #         over shell builtins of the same name. So turning this on will
 113 #         eliminate any performance gained by turning on the builtin "echo"
 114 #         and "test" commands in ash.
 115 # untrue?
 116 #         Note that when using this option, the shell will attempt to directly
 117 #         run '/bin/busybox'. If you do not have the busybox binary sitting in
 118 #         that exact location with that exact name, this option will not work at
 119 #         all.
 120
 121 config FEATURE_SH_NOFORK
 122         bool "Run 'nofork' applets directly"
 123         default n
 124         depends on (HUSH || ASH) && FEATURE_PREFER_APPLETS
 125         help
 126           This option causes busybox shells to not execute typical
 127           fork/exec/wait sequence, but call <applet>_main directly,
 128           if possible. (Sometimes it is not possible: for example,
 129           this is not possible in pipes).
 130
 131           This will be done only for some applets (those which are marked
 132           NOFORK in include/applets.h).
 133
 134           This may significantly speed up some shell scripts.
 135
 136           This feature is relatively new. Use with care. Report bugs
 137           to project mailing list.
 138
 139 config FEATURE_SH_HISTFILESIZE
 140         bool "Use $HISTFILESIZE"
 141         default y
 142         depends on HUSH || ASH
 143         help
 144           This option makes busybox shells to use $HISTFILESIZE variable
 145           to set shell history size. Note that its max value is capped
 146           by "History size" setting in library tuning section.
 147
 148
 149 endmenu