2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
9 prompt "Choose your default shell"
10 default BUSYBOX_CONFIG_FEATURE_SH_IS_ASH
12 Choose a shell. The ash shell is the most bash compatible
13 and full featured one.
15 config BUSYBOX_CONFIG_FEATURE_SH_IS_ASH
16 select BUSYBOX_CONFIG_ASH
19 config BUSYBOX_CONFIG_FEATURE_SH_IS_HUSH
20 select BUSYBOX_CONFIG_HUSH
23 config BUSYBOX_CONFIG_FEATURE_SH_IS_LASH
24 select BUSYBOX_CONFIG_LASH
27 config BUSYBOX_CONFIG_FEATURE_SH_IS_MSH
28 select BUSYBOX_CONFIG_MSH
31 config BUSYBOX_CONFIG_FEATURE_SH_IS_NONE
36 config BUSYBOX_CONFIG_ASH
39 select BUSYBOX_CONFIG_TEST
41 Tha 'ash' shell adds about 60k in the default configuration and is
42 the most complete and most pedantically correct shell included with
43 busybox. This shell is actually a derivative of the Debian 'dash'
44 shell (by Herbert Xu), which was created by porting the 'ash' shell
45 (written by Kenneth Almquist) from NetBSD.
47 comment "Ash Shell Options"
48 depends on BUSYBOX_CONFIG_ASH
50 config BUSYBOX_CONFIG_ASH_JOB_CONTROL
51 bool " Enable Job control"
53 depends on BUSYBOX_CONFIG_ASH
55 Enable job control in the ash shell.
57 config BUSYBOX_CONFIG_ASH_READ_NCHARS
58 bool " Enable 'read -n N' and 'read -s' support"
60 depends on BUSYBOX_CONFIG_ASH
62 'read -n N' will return a value after N characters have been read.
63 'read -s' will read without echoing the user's input.
65 config BUSYBOX_CONFIG_ASH_READ_TIMEOUT
66 bool " Enable 'read -t S' support."
68 depends on BUSYBOX_CONFIG_ASH
70 'read -t S' will return a value after S seconds have passed.
71 This implementation will allow fractional seconds, expressed
72 as a decimal fraction, e.g. 'read -t 2.5 foo'.
74 config BUSYBOX_CONFIG_ASH_ALIAS
75 bool " Enable alias support"
77 depends on BUSYBOX_CONFIG_ASH
79 Enable alias support in the ash shell.
81 config BUSYBOX_CONFIG_ASH_MATH_SUPPORT
82 bool " Enable Posix math support"
84 depends on BUSYBOX_CONFIG_ASH
86 Enable math support in the ash shell.
88 config BUSYBOX_CONFIG_ASH_MATH_SUPPORT_64
89 bool " Extend Posix math support to 64 bit"
91 depends on BUSYBOX_CONFIG_ASH_MATH_SUPPORT
93 Enable 64-bit math support in the ash shell. This will make
94 the shell slightly larger, but will allow computation with very
97 config BUSYBOX_CONFIG_ASH_GETOPTS
98 bool " Enable getopts builtin to parse positional parameters"
100 depends on BUSYBOX_CONFIG_ASH
102 Enable getopts builtin in the ash shell.
104 config BUSYBOX_CONFIG_ASH_CMDCMD
105 bool " Enable cmdcmd to override shell builtins"
107 depends on BUSYBOX_CONFIG_ASH
109 Enable support for the ash 'command' builtin, which allows
110 you to run the specified command with the specified arguments,
111 even when there is an ash builtin command with the same name.
113 config BUSYBOX_CONFIG_ASH_BUILTIN_ECHO
114 bool " Enable builtin version of 'echo'"
116 depends on BUSYBOX_CONFIG_ASH
118 Enable support for echo, built in to ash.
120 # this entry also appears in coreutils/Config.in, next to the echo applet
121 config BUSYBOX_CONFIG_FEATURE_FANCY_ECHO
122 bool " Enable echo options (-n and -e)"
124 depends on BUSYBOX_CONFIG_ASH_BUILTIN_ECHO
126 This adds options (-n and -e) to echo.
128 config BUSYBOX_CONFIG_ASH_MAIL
129 bool " Check for new mail on interactive shells"
131 depends on BUSYBOX_CONFIG_ASH
133 Enable "check for new mail" in the ash shell.
135 config BUSYBOX_CONFIG_ASH_OPTIMIZE_FOR_SIZE
136 bool " Optimize for size instead of speed"
138 depends on BUSYBOX_CONFIG_ASH
140 Compile ash for reduced size at the price of speed.
142 config BUSYBOX_CONFIG_ASH_RANDOM_SUPPORT
143 bool " Enable pseudorandom generator and variable $RANDOM"
145 depends on BUSYBOX_CONFIG_ASH
147 Enable pseudorandom generator and dynamic variable "$RANDOM".
148 Each read of "$RANDOM" will generate a new pseudorandom value.
149 You can reset the generator by using a specified start value.
150 After "unset RANDOM" then generator will switch off and this
151 variable will no longer have special treatment.
153 config BUSYBOX_CONFIG_ASH_EXPAND_PRMT
154 bool " Expand prompt string"
156 depends on BUSYBOX_CONFIG_ASH
158 "PS#" may be contain volatile content, such as backquote commands.
159 This option recreates the prompt string from the environment
160 variable each time it is displayed.
162 config BUSYBOX_CONFIG_HUSH
165 select BUSYBOX_CONFIG_TRUE
166 select BUSYBOX_CONFIG_FALSE
167 select BUSYBOX_CONFIG_TEST
169 hush is a very small shell (just 18k) and it has fairly complete
170 Bourne shell grammar. It even handles all the normal flow control
171 options such as if/then/elif/else/fi, for/in/do/done, while loops,
174 It does not handle case/esac, select, function, here documents ( <<
175 word ), arithmetic expansion, aliases, brace expansion, tilde
176 expansion, &> and >& redirection of stdout+stderr, etc.
179 config BUSYBOX_CONFIG_LASH
182 select BUSYBOX_CONFIG_TRUE
183 select BUSYBOX_CONFIG_FALSE
184 select BUSYBOX_CONFIG_TEST
186 lash is the very smallest shell (adds just 10k) and it is quite
187 usable as a command prompt, but it is not suitable for any but the
188 most trivial scripting (such as an initrd that calls insmod a few
189 times) since it does not understand any Bourne shell grammar. It
190 does handle pipes, redirects, and job control though. Adding in
191 command editing makes it a very nice lightweight command prompt.
194 config BUSYBOX_CONFIG_MSH
197 select BUSYBOX_CONFIG_TRUE
198 select BUSYBOX_CONFIG_FALSE
199 select BUSYBOX_CONFIG_TEST
201 The minix shell (adds just 30k) is quite complete and handles things
202 like for/do/done, case/esac and all the things you expect a Bourne
203 shell to do. It is not always pedantically correct about Bourne
204 shell grammar (try running the shell testscript "tests/sh.testcases"
205 on it and compare vs bash) but for most things it works quite well.
206 It also uses only vfork, so it can be used on uClinux systems.
208 comment "Bourne Shell Options"
209 depends on BUSYBOX_CONFIG_MSH || BUSYBOX_CONFIG_LASH || BUSYBOX_CONFIG_HUSH || BUSYBOX_CONFIG_ASH
211 config BUSYBOX_CONFIG_FEATURE_SH_EXTRA_QUIET
212 bool "Hide message on interactive shell startup"
214 depends on BUSYBOX_CONFIG_MSH || BUSYBOX_CONFIG_LASH || BUSYBOX_CONFIG_HUSH || BUSYBOX_CONFIG_ASH
216 Remove the busybox introduction when starting a shell.
218 config BUSYBOX_CONFIG_FEATURE_SH_STANDALONE_SHELL
219 bool "Standalone shell"
221 depends on BUSYBOX_CONFIG_MSH || BUSYBOX_CONFIG_LASH || BUSYBOX_CONFIG_HUSH || BUSYBOX_CONFIG_ASH
223 This option causes the selected busybox shell to use busybox applets
224 in preference to executables in the PATH whenever possible. For
225 example, entering the command 'ifconfig' into the shell would cause
226 busybox to use the ifconfig busybox applet. Specifying the fully
227 qualified executable name, such as '/sbin/ifconfig' will still
228 execute the /sbin/ifconfig executable on the filesystem. This option
229 is generally used when creating a statically linked version of busybox
230 for use as a rescue shell, in the event that you screw up your system.
232 Note that when using this option, the shell will attempt to directly
233 run '/bin/busybox'. If you do not have the busybox binary sitting in
234 that exact location with that exact name, this option will not work at
237 config BUSYBOX_CONFIG_FEATURE_COMMAND_EDITING
238 bool "command line editing"
240 depends on BUSYBOX_CONFIG_MSH || BUSYBOX_CONFIG_LASH || BUSYBOX_CONFIG_HUSH || BUSYBOX_CONFIG_ASH
242 Enable command editing in shell.
244 config BUSYBOX_CONFIG_FEATURE_COMMAND_EDITING_VI
245 bool "vi-style line editing commands"
247 depends on BUSYBOX_CONFIG_FEATURE_COMMAND_EDITING
249 Enable vi-style line editing in the shell. This mode can be
250 turned on and off with "set -o vi" and "set +o vi".
252 config BUSYBOX_CONFIG_FEATURE_COMMAND_HISTORY
255 depends on BUSYBOX_CONFIG_FEATURE_COMMAND_EDITING
257 Specify command history size in shell.
259 config BUSYBOX_CONFIG_FEATURE_COMMAND_SAVEHISTORY
260 bool "history saving"
262 depends on BUSYBOX_CONFIG_ASH && BUSYBOX_CONFIG_FEATURE_COMMAND_EDITING
264 Enable history saving in ash shell.
266 config BUSYBOX_CONFIG_FEATURE_COMMAND_TAB_COMPLETION
267 bool "tab completion"
269 depends on BUSYBOX_CONFIG_FEATURE_COMMAND_EDITING
271 Enable tab completion in shell.
273 config BUSYBOX_CONFIG_FEATURE_COMMAND_USERNAME_COMPLETION
274 bool "username completion"
276 depends on BUSYBOX_CONFIG_FEATURE_COMMAND_TAB_COMPLETION
278 Enable username completion in shell.
280 config BUSYBOX_CONFIG_FEATURE_SH_FANCY_PROMPT
281 bool "Fancy shell prompts"
283 depends on BUSYBOX_CONFIG_FEATURE_COMMAND_EDITING
285 Setting this option allows for prompts to use things like \w and
286 \$ and also using escape codes.