Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 1 | # |
| 2 | # For a description of the syntax of this configuration file, |
| 3 | # see scripts/kbuild/config-language.txt. |
| 4 | # |
| 5 | |
Mike Frysinger | 9ac178a | 2005-09-24 05:49:36 +0000 | [diff] [blame] | 6 | menu "Shells" |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 7 | |
Denys Vlasenko | c8aae0b | 2010-06-06 22:14:58 +0200 | [diff] [blame] | 8 | |
| 9 | choice |
| 10 | prompt "Choose which shell is aliased to 'sh' name" |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 11 | default SH_IS_ASH |
Denys Vlasenko | c8aae0b | 2010-06-06 22:14:58 +0200 | [diff] [blame] | 12 | help |
| 13 | Choose which shell you want to be executed by 'sh' alias. |
| 14 | The ash shell is the most bash compatible and full featured one. |
| 15 | |
Denys Vlasenko | 121fb95 | 2010-06-07 13:34:34 +0200 | [diff] [blame] | 16 | # note: cannot use "select ASH" here, it breaks "make allnoconfig" |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 17 | config SH_IS_ASH |
Denys Vlasenko | c8aae0b | 2010-06-06 22:14:58 +0200 | [diff] [blame] | 18 | depends on !NOMMU |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 19 | bool "ash" |
Kang-Che Sung | 9529115 | 2017-01-04 12:29:04 +0100 | [diff] [blame^] | 20 | help |
| 21 | Choose ash to be the shell executed by 'sh' name. |
| 22 | The ash code will be built into busybox. If you don't select |
| 23 | "ash" choice (CONFIG_ASH), this shell may only be invoked by |
| 24 | the name 'sh' (and not 'ash'). |
Denys Vlasenko | c8aae0b | 2010-06-06 22:14:58 +0200 | [diff] [blame] | 25 | |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 26 | config SH_IS_HUSH |
Denys Vlasenko | c8aae0b | 2010-06-06 22:14:58 +0200 | [diff] [blame] | 27 | bool "hush" |
Kang-Che Sung | 9529115 | 2017-01-04 12:29:04 +0100 | [diff] [blame^] | 28 | help |
| 29 | Choose hush to be the shell executed by 'sh' name. |
| 30 | The hush code will be built into busybox. If you don't select |
| 31 | "hush" choice (CONFIG_HUSH), this shell may only be invoked by |
| 32 | the name 'sh' (and not 'hush'). |
Denys Vlasenko | c8aae0b | 2010-06-06 22:14:58 +0200 | [diff] [blame] | 33 | |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 34 | config SH_IS_NONE |
Denys Vlasenko | c8aae0b | 2010-06-06 22:14:58 +0200 | [diff] [blame] | 35 | bool "none" |
| 36 | |
| 37 | endchoice |
| 38 | |
| 39 | choice |
| 40 | prompt "Choose which shell is aliased to 'bash' name" |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 41 | default BASH_IS_NONE |
Denys Vlasenko | c8aae0b | 2010-06-06 22:14:58 +0200 | [diff] [blame] | 42 | help |
| 43 | Choose which shell you want to be executed by 'bash' alias. |
Kang-Che Sung | 9529115 | 2017-01-04 12:29:04 +0100 | [diff] [blame^] | 44 | The ash shell is the most bash compatible and full featured one, |
| 45 | although compatibility is far from being complete. |
Denys Vlasenko | c8aae0b | 2010-06-06 22:14:58 +0200 | [diff] [blame] | 46 | |
| 47 | Note that selecting this option does not switch on any bash |
| 48 | compatibility code. It merely makes it possible to install |
| 49 | /bin/bash (sym)link and run scripts which start with |
| 50 | #!/bin/bash line. |
| 51 | |
| 52 | Many systems use it in scripts which use bash-specific features, |
| 53 | even simple ones like $RANDOM. Without this option, busybox |
| 54 | can't be used for running them because it won't recongnize |
| 55 | "bash" as a supported applet name. |
| 56 | |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 57 | config BASH_IS_ASH |
Denys Vlasenko | c8aae0b | 2010-06-06 22:14:58 +0200 | [diff] [blame] | 58 | depends on !NOMMU |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 59 | bool "ash" |
Kang-Che Sung | 9529115 | 2017-01-04 12:29:04 +0100 | [diff] [blame^] | 60 | help |
| 61 | Choose ash to be the shell executed by 'bash' name. |
| 62 | The ash code will be built into busybox. If you don't select |
| 63 | "ash" choice (CONFIG_ASH), this shell may only be invoked by |
| 64 | the name 'bash' (and not 'ash'). |
Denys Vlasenko | c8aae0b | 2010-06-06 22:14:58 +0200 | [diff] [blame] | 65 | |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 66 | config BASH_IS_HUSH |
Denys Vlasenko | c8aae0b | 2010-06-06 22:14:58 +0200 | [diff] [blame] | 67 | bool "hush" |
Kang-Che Sung | 9529115 | 2017-01-04 12:29:04 +0100 | [diff] [blame^] | 68 | help |
| 69 | Choose hush to be the shell executed by 'bash' name. |
| 70 | The hush code will be built into busybox. If you don't select |
| 71 | "hush" choice (CONFIG_HUSH), this shell may only be invoked by |
| 72 | the name 'bash' (and not 'hush'). |
Denys Vlasenko | c8aae0b | 2010-06-06 22:14:58 +0200 | [diff] [blame] | 73 | |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 74 | config BASH_IS_NONE |
Denys Vlasenko | c8aae0b | 2010-06-06 22:14:58 +0200 | [diff] [blame] | 75 | bool "none" |
| 76 | |
| 77 | endchoice |
| 78 | |
| 79 | |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 80 | INSERT |
| 81 | |
| 82 | |
| 83 | config FEATURE_SH_MATH |
Mike Frysinger | 98c5264 | 2009-04-02 10:02:37 +0000 | [diff] [blame] | 84 | bool "POSIX math support" |
| 85 | default y |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 86 | depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH |
Mike Frysinger | 98c5264 | 2009-04-02 10:02:37 +0000 | [diff] [blame] | 87 | help |
| 88 | Enable math support in the shell via $((...)) syntax. |
| 89 | |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 90 | config FEATURE_SH_MATH_64 |
Mike Frysinger | 98c5264 | 2009-04-02 10:02:37 +0000 | [diff] [blame] | 91 | bool "Extend POSIX math support to 64 bit" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 92 | default y |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 93 | depends on FEATURE_SH_MATH |
Mike Frysinger | 98c5264 | 2009-04-02 10:02:37 +0000 | [diff] [blame] | 94 | help |
| 95 | Enable 64-bit math support in the shell. This will make the shell |
| 96 | slightly larger, but will allow computation with very large numbers. |
| 97 | This is not in POSIX, so do not rely on this in portable code. |
| 98 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 99 | config FEATURE_SH_EXTRA_QUIET |
Glenn L McGrath | 3b25185 | 2004-01-03 12:07:32 +0000 | [diff] [blame] | 100 | bool "Hide message on interactive shell startup" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 101 | default y |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 102 | depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 103 | help |
Glenn L McGrath | 3b25185 | 2004-01-03 12:07:32 +0000 | [diff] [blame] | 104 | Remove the busybox introduction when starting a shell. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 105 | |
Denis Vlasenko | 80d14be | 2007-04-10 23:03:30 +0000 | [diff] [blame] | 106 | config FEATURE_SH_STANDALONE |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 107 | bool "Standalone shell" |
| 108 | default n |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 109 | depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 110 | help |
Denis Vlasenko | 92c0b82 | 2007-05-08 17:27:17 +0000 | [diff] [blame] | 111 | This option causes busybox shells to use busybox applets |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 112 | in preference to executables in the PATH whenever possible. For |
Eric Andersen | 075dd81 | 2004-04-07 09:34:27 +0000 | [diff] [blame] | 113 | example, entering the command 'ifconfig' into the shell would cause |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 114 | busybox to use the ifconfig busybox applet. Specifying the fully |
Eric Andersen | 075dd81 | 2004-04-07 09:34:27 +0000 | [diff] [blame] | 115 | qualified executable name, such as '/sbin/ifconfig' will still |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 116 | execute the /sbin/ifconfig executable on the filesystem. This option |
Rob Landley | 06ec8cf | 2006-03-03 19:02:50 +0000 | [diff] [blame] | 117 | is generally used when creating a statically linked version of busybox |
Eric Andersen | 075dd81 | 2004-04-07 09:34:27 +0000 | [diff] [blame] | 118 | for use as a rescue shell, in the event that you screw up your system. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 119 | |
Denis Vlasenko | 92c0b82 | 2007-05-08 17:27:17 +0000 | [diff] [blame] | 120 | This is implemented by re-execing /proc/self/exe (typically) |
| 121 | with right parameters. Some selected applets ("NOFORK" applets) |
| 122 | can even be executed without creating new process. |
| 123 | Instead, busybox will call <applet>_main() internally. |
Paul Fox | 6ab0378 | 2006-06-08 21:37:26 +0000 | [diff] [blame] | 124 | |
Denis Vlasenko | 92c0b82 | 2007-05-08 17:27:17 +0000 | [diff] [blame] | 125 | However, this causes problems in chroot jails without mounted /proc |
| 126 | and with ps/top (command name can be shown as 'exe' for applets |
| 127 | started this way). |
| 128 | # untrue? |
| 129 | # Note that this will *also* cause applets to take precedence |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 130 | # over shell builtins of the same name. So turning this on will |
Denis Vlasenko | 92c0b82 | 2007-05-08 17:27:17 +0000 | [diff] [blame] | 131 | # eliminate any performance gained by turning on the builtin "echo" |
| 132 | # and "test" commands in ash. |
| 133 | # untrue? |
| 134 | # Note that when using this option, the shell will attempt to directly |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 135 | # run '/bin/busybox'. If you do not have the busybox binary sitting in |
Denis Vlasenko | 92c0b82 | 2007-05-08 17:27:17 +0000 | [diff] [blame] | 136 | # that exact location with that exact name, this option will not work at |
| 137 | # all. |
Eric Andersen | 6f8542b | 2004-09-24 01:25:39 +0000 | [diff] [blame] | 138 | |
Denis Vlasenko | 9bc80d7 | 2008-04-12 20:07:53 +0000 | [diff] [blame] | 139 | config FEATURE_SH_NOFORK |
| 140 | bool "Run 'nofork' applets directly" |
| 141 | default n |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 142 | depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH |
Denis Vlasenko | 9bc80d7 | 2008-04-12 20:07:53 +0000 | [diff] [blame] | 143 | help |
Denys Vlasenko | b72baeb | 2011-02-02 18:38:57 +0100 | [diff] [blame] | 144 | This option causes busybox shells to not execute typical |
| 145 | fork/exec/wait sequence, but call <applet>_main directly, |
| 146 | if possible. (Sometimes it is not possible: for example, |
Denis Vlasenko | 9bc80d7 | 2008-04-12 20:07:53 +0000 | [diff] [blame] | 147 | this is not possible in pipes). |
| 148 | |
| 149 | This will be done only for some applets (those which are marked |
| 150 | NOFORK in include/applets.h). |
| 151 | |
| 152 | This may significantly speed up some shell scripts. |
| 153 | |
Denys Vlasenko | b72baeb | 2011-02-02 18:38:57 +0100 | [diff] [blame] | 154 | This feature is relatively new. Use with care. Report bugs |
| 155 | to project mailing list. |
Denis Vlasenko | 9bc80d7 | 2008-04-12 20:07:53 +0000 | [diff] [blame] | 156 | |
Denys Vlasenko | 2c4de5b | 2011-03-31 13:16:52 +0200 | [diff] [blame] | 157 | config FEATURE_SH_HISTFILESIZE |
| 158 | bool "Use $HISTFILESIZE" |
| 159 | default y |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 160 | depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH |
Denys Vlasenko | 2c4de5b | 2011-03-31 13:16:52 +0200 | [diff] [blame] | 161 | help |
| 162 | This option makes busybox shells to use $HISTFILESIZE variable |
| 163 | to set shell history size. Note that its max value is capped |
| 164 | by "History size" setting in library tuning section. |
| 165 | |
| 166 | |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 167 | endmenu |