| lh | 9ed821d | 2023-04-07 01:36:19 -0700 | [diff] [blame] | 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 |