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 | |
Kang-Che Sung | 6cd0294 | 2017-01-06 17:02:03 +0100 | [diff] [blame] | 83 | comment "Options common to all shells" |
| 84 | if ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH |
| 85 | |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 86 | config FEATURE_SH_MATH |
Mike Frysinger | 98c5264 | 2009-04-02 10:02:37 +0000 | [diff] [blame] | 87 | bool "POSIX math support" |
| 88 | default y |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 89 | 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] | 90 | help |
| 91 | Enable math support in the shell via $((...)) syntax. |
| 92 | |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 93 | config FEATURE_SH_MATH_64 |
Mike Frysinger | 98c5264 | 2009-04-02 10:02:37 +0000 | [diff] [blame] | 94 | bool "Extend POSIX math support to 64 bit" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 95 | default y |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 96 | depends on FEATURE_SH_MATH |
Mike Frysinger | 98c5264 | 2009-04-02 10:02:37 +0000 | [diff] [blame] | 97 | help |
| 98 | Enable 64-bit math support in the shell. This will make the shell |
| 99 | slightly larger, but will allow computation with very large numbers. |
| 100 | This is not in POSIX, so do not rely on this in portable code. |
| 101 | |
Denis Vlasenko | 7d219aa | 2006-10-05 10:17:08 +0000 | [diff] [blame] | 102 | config FEATURE_SH_EXTRA_QUIET |
Glenn L McGrath | 3b25185 | 2004-01-03 12:07:32 +0000 | [diff] [blame] | 103 | bool "Hide message on interactive shell startup" |
Denys Vlasenko | 2f32bf8 | 2010-06-06 04:14:28 +0200 | [diff] [blame] | 104 | default y |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 105 | 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] | 106 | help |
Glenn L McGrath | 3b25185 | 2004-01-03 12:07:32 +0000 | [diff] [blame] | 107 | Remove the busybox introduction when starting a shell. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 108 | |
Denis Vlasenko | 80d14be | 2007-04-10 23:03:30 +0000 | [diff] [blame] | 109 | config FEATURE_SH_STANDALONE |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 110 | bool "Standalone shell" |
| 111 | default n |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 112 | 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] | 113 | help |
Denis Vlasenko | 92c0b82 | 2007-05-08 17:27:17 +0000 | [diff] [blame] | 114 | This option causes busybox shells to use busybox applets |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 115 | in preference to executables in the PATH whenever possible. For |
Eric Andersen | 075dd81 | 2004-04-07 09:34:27 +0000 | [diff] [blame] | 116 | example, entering the command 'ifconfig' into the shell would cause |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 117 | busybox to use the ifconfig busybox applet. Specifying the fully |
Eric Andersen | 075dd81 | 2004-04-07 09:34:27 +0000 | [diff] [blame] | 118 | qualified executable name, such as '/sbin/ifconfig' will still |
Bernhard Reutner-Fischer | 3e8669f | 2008-07-22 18:27:53 +0000 | [diff] [blame] | 119 | execute the /sbin/ifconfig executable on the filesystem. This option |
Rob Landley | 06ec8cf | 2006-03-03 19:02:50 +0000 | [diff] [blame] | 120 | is generally used when creating a statically linked version of busybox |
Eric Andersen | 075dd81 | 2004-04-07 09:34:27 +0000 | [diff] [blame] | 121 | 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] | 122 | |
Denis Vlasenko | 92c0b82 | 2007-05-08 17:27:17 +0000 | [diff] [blame] | 123 | This is implemented by re-execing /proc/self/exe (typically) |
Denys Vlasenko | 786c9dc | 2017-01-26 18:31:51 +0100 | [diff] [blame] | 124 | with right parameters. |
Paul Fox | 6ab0378 | 2006-06-08 21:37:26 +0000 | [diff] [blame] | 125 | |
Denys Vlasenko | 67f6db6 | 2017-01-30 16:27:37 +0100 | [diff] [blame] | 126 | However, there are drawbacks: it is problematic in chroot jails |
| 127 | without mounted /proc, and ps/top may show command name as 'exe' |
| 128 | for applets started this way. |
Eric Andersen | 6f8542b | 2004-09-24 01:25:39 +0000 | [diff] [blame] | 129 | |
Denis Vlasenko | 9bc80d7 | 2008-04-12 20:07:53 +0000 | [diff] [blame] | 130 | config FEATURE_SH_NOFORK |
| 131 | bool "Run 'nofork' applets directly" |
| 132 | default n |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 133 | 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] | 134 | help |
Denys Vlasenko | b72baeb | 2011-02-02 18:38:57 +0100 | [diff] [blame] | 135 | This option causes busybox shells to not execute typical |
| 136 | fork/exec/wait sequence, but call <applet>_main directly, |
| 137 | if possible. (Sometimes it is not possible: for example, |
Denis Vlasenko | 9bc80d7 | 2008-04-12 20:07:53 +0000 | [diff] [blame] | 138 | this is not possible in pipes). |
| 139 | |
| 140 | This will be done only for some applets (those which are marked |
| 141 | NOFORK in include/applets.h). |
| 142 | |
| 143 | This may significantly speed up some shell scripts. |
| 144 | |
Denys Vlasenko | b72baeb | 2011-02-02 18:38:57 +0100 | [diff] [blame] | 145 | This feature is relatively new. Use with care. Report bugs |
| 146 | to project mailing list. |
Denis Vlasenko | 9bc80d7 | 2008-04-12 20:07:53 +0000 | [diff] [blame] | 147 | |
Denys Vlasenko | 2c4de5b | 2011-03-31 13:16:52 +0200 | [diff] [blame] | 148 | config FEATURE_SH_HISTFILESIZE |
| 149 | bool "Use $HISTFILESIZE" |
| 150 | default y |
Denys Vlasenko | 0b88358 | 2016-12-23 16:49:07 +0100 | [diff] [blame] | 151 | 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] | 152 | help |
| 153 | This option makes busybox shells to use $HISTFILESIZE variable |
| 154 | to set shell history size. Note that its max value is capped |
| 155 | by "History size" setting in library tuning section. |
| 156 | |
Kang-Che Sung | 6cd0294 | 2017-01-06 17:02:03 +0100 | [diff] [blame] | 157 | endif # Options common to all shells |
Denys Vlasenko | 2c4de5b | 2011-03-31 13:16:52 +0200 | [diff] [blame] | 158 | |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 159 | endmenu |