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 FEATURE_SH_IS_NONE
12 Choose a shell. The ash shell is the most bash compatible
13 and full featured one.
15 config FEATURE_SH_IS_ASH
19 config FEATURE_SH_IS_HUSH
23 config FEATURE_SH_IS_LASH
27 config FEATURE_SH_IS_MSH
31 config FEATURE_SH_IS_NONE
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"
50 config ASH_JOB_CONTROL
55 Enable job control in the ash shell.
57 config ASH_READ_NCHARS
58 bool "'read -n N' and 'read -s' support"
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 ASH_READ_TIMEOUT
66 bool "'read -t S' support."
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'.
79 Enable alias support in the ash shell.
81 config ASH_MATH_SUPPORT
82 bool "Posix math support"
86 Enable math support in the ash shell.
88 config ASH_MATH_SUPPORT_64
89 bool "Extend Posix math support to 64 bit"
91 depends on 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
98 bool "Builtin getopt to parse positional parameters"
102 Enable getopts builtin in the ash shell.
104 config ASH_BUILTIN_ECHO
105 bool "Builtin version of 'echo'"
110 Enable support for echo, builtin to ash.
112 config ASH_BUILTIN_TEST
113 bool "Builtin version of 'test'"
118 Enable support for test, builtin to ash.
121 bool "'command' command to override shell builtins"
125 Enable support for the ash 'command' builtin, which allows
126 you to run the specified command with the specified arguments,
127 even when there is an ash builtin command with the same name.
130 bool "Check for new mail on interactive shells"
134 Enable "check for new mail" in the ash shell.
136 config ASH_OPTIMIZE_FOR_SIZE
137 bool "Optimize for size instead of speed"
141 Compile ash for reduced size at the price of speed.
143 config ASH_RANDOM_SUPPORT
144 bool "Pseudorandom generator and variable $RANDOM"
148 Enable pseudorandom generator and dynamic variable "$RANDOM".
149 Each read of "$RANDOM" will generate a new pseudorandom value.
150 You can reset the generator by using a specified start value.
151 After "unset RANDOM" then generator will switch off and this
152 variable will no longer have special treatment.
154 config ASH_EXPAND_PRMT
155 bool "Expand prompt string"
159 "PS#" may be contain volatile content, such as backquote commands.
160 This option recreates the prompt string from the environment
161 variable each time it is displayed.
170 hush is a very small shell (just 18k) and it has fairly complete
171 Bourne shell grammar. It even handles all the normal flow control
172 options such as if/then/elif/else/fi, for/in/do/done, while loops,
175 It does not handle case/esac, select, function, here documents ( <<
176 word ), arithmetic expansion, aliases, brace expansion, tilde
177 expansion, &> and >& redirection of stdout+stderr, etc.
183 Enable help builtin in hush. Code size + ~1 kbyte.
185 config HUSH_INTERACTIVE
186 bool "Interactive mode"
190 Enable interactive mode (prompt and command editing).
191 Without this, hush simply reads and executes commands
192 from stdin just like a shell script from the file.
193 No prompt, no PS1/PS2 magic shell variables.
198 depends on HUSH_INTERACTIVE
200 Enable job control: Ctrl-Z backgrounds, Ctrl-C interrupts current
201 command (not entire shell), fg/bg builtins work. Without this option,
202 "cmd &" still works by simply spawning a process and immediately
203 prompting for next command (or executing next command in a script),
204 but no separate process group is formed.
207 bool "Process substitution"
210 Enable process substitution `command` and $(command) in hush.
213 bool "Support if/then/elif/else/fi"
216 Enable if/then/elif/else/fi in hush.
219 bool "Support for, while and until loops"
222 Enable for, while and until loops in hush.
231 lash is the very smallest shell (adds just 10k) and it is quite
232 usable as a command prompt, but it is not suitable for any but the
233 most trivial scripting (such as an initrd that calls insmod a few
234 times) since it does not understand any Bourne shell grammar. It
235 does handle pipes, redirects, and job control though. Adding in
236 command editing makes it a very nice lightweight command prompt.
246 The minix shell (adds just 30k) is quite complete and handles things
247 like for/do/done, case/esac and all the things you expect a Bourne
248 shell to do. It is not always pedantically correct about Bourne
249 shell grammar (try running the shell testscript "tests/sh.testcases"
250 on it and compare vs bash) but for most things it works quite well.
251 It also uses only vfork, so it can be used on uClinux systems.
253 comment "Bourne Shell Options"
254 depends on MSH || LASH || HUSH || ASH
256 config FEATURE_SH_EXTRA_QUIET
257 bool "Hide message on interactive shell startup"
259 depends on MSH || LASH || HUSH || ASH
261 Remove the busybox introduction when starting a shell.
263 config FEATURE_SH_STANDALONE
264 bool "Standalone shell"
266 depends on (MSH || LASH || HUSH || ASH) && FEATURE_PREFER_APPLETS
268 This option causes busybox shells to use busybox applets
269 in preference to executables in the PATH whenever possible. For
270 example, entering the command 'ifconfig' into the shell would cause
271 busybox to use the ifconfig busybox applet. Specifying the fully
272 qualified executable name, such as '/sbin/ifconfig' will still
273 execute the /sbin/ifconfig executable on the filesystem. This option
274 is generally used when creating a statically linked version of busybox
275 for use as a rescue shell, in the event that you screw up your system.
277 This is implemented by re-execing /proc/self/exe (typically)
278 with right parameters. Some selected applets ("NOFORK" applets)
279 can even be executed without creating new process.
280 Instead, busybox will call <applet>_main() internally.
282 However, this causes problems in chroot jails without mounted /proc
283 and with ps/top (command name can be shown as 'exe' for applets
286 # Note that this will *also* cause applets to take precedence
287 # over shell builtins of the same name. So turning this on will
288 # eliminate any performance gained by turning on the builtin "echo"
289 # and "test" commands in ash.
291 # Note that when using this option, the shell will attempt to directly
292 # run '/bin/busybox'. If you do not have the busybox binary sitting in
293 # that exact location with that exact name, this option will not work at
300 One common problem reported on the mailing list is "can't access tty;
301 job control turned off" error message which typically appears when
302 one tries to use shell with stdin/stdout opened to /dev/console.
303 This device is special - it cannot be a controlling tty.
305 Proper solution is to use correct device instead of /dev/console.
307 cttyhack provides "quick and dirty" solution to this problem.
308 It analyzes stdin with various ioctls, trying to determine whether
309 it is a /dev/ttyN or /dev/ttySN (virtual terminal or serial line).
310 If it detects one, it closes stdin/out/err and reopens that device.
311 Then it executes given program. Usage example for /etc/inittab
314 ::respawn:/bin/cttyhack /bin/sh