blob: a6701622c8004967fadceca067654045c8f2e168 [file] [log] [blame]
Eric Andersenc9f20d92002-12-05 08:41:41 +00001#
2# For a description of the syntax of this configuration file,
3# see scripts/kbuild/config-language.txt.
4#
5
Mike Frysinger9ac178a2005-09-24 05:49:36 +00006menu "Shells"
Eric Andersenc9f20d92002-12-05 08:41:41 +00007
8choice
9 prompt "Choose your default shell"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000010 default FEATURE_SH_IS_NONE
Eric Andersenc9f20d92002-12-05 08:41:41 +000011 help
Eric Andersene5642112003-07-14 19:37:08 +000012 Choose a shell. The ash shell is the most bash compatible
Eric Andersen88c916b2003-10-22 09:58:56 +000013 and full featured one.
Eric Andersenc9f20d92002-12-05 08:41:41 +000014
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000015config FEATURE_SH_IS_ASH
16 select ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +000017 bool "ash"
18
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000019config FEATURE_SH_IS_HUSH
20 select HUSH
Eric Andersenc9f20d92002-12-05 08:41:41 +000021 bool "hush"
22
Denis Vlasenko96702ca2007-11-23 23:28:55 +000023####config FEATURE_SH_IS_LASH
24#### select LASH
25#### bool "lash"
Eric Andersenc9f20d92002-12-05 08:41:41 +000026
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000027config FEATURE_SH_IS_MSH
28 select MSH
Eric Andersenc9f20d92002-12-05 08:41:41 +000029 bool "msh"
30
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000031config FEATURE_SH_IS_NONE
Eric Andersena6b90512002-12-06 21:49:59 +000032 bool "none"
33
Eric Andersenc9f20d92002-12-05 08:41:41 +000034endchoice
35
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000036config ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +000037 bool "ash"
Rob Landley49576c02006-01-30 06:11:42 +000038 default n
Eric Andersenc9f20d92002-12-05 08:41:41 +000039 help
Eric Andersenb287e2e2003-08-08 23:40:12 +000040 Tha 'ash' shell adds about 60k in the default configuration and is
41 the most complete and most pedantically correct shell included with
Eric Andersen88c916b2003-10-22 09:58:56 +000042 busybox. This shell is actually a derivative of the Debian 'dash'
43 shell (by Herbert Xu), which was created by porting the 'ash' shell
Eric Andersenc7bda1c2004-03-15 08:29:22 +000044 (written by Kenneth Almquist) from NetBSD.
Eric Andersenc9f20d92002-12-05 08:41:41 +000045
46comment "Ash Shell Options"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000047 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +000048
Denis Vlasenko92e13c22008-03-25 01:17:40 +000049config ASH_BASH_COMPAT
50 bool "bash-compatible extensions"
51 default y
52 depends on ASH
53 help
54 Enable bash-conpatible extensions.
55
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000056config ASH_JOB_CONTROL
Paul Fox7ba12c62006-06-08 21:48:47 +000057 bool "Job control"
Eric Andersenc9f20d92002-12-05 08:41:41 +000058 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000059 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +000060 help
Eric Andersene5642112003-07-14 19:37:08 +000061 Enable job control in the ash shell.
Eric Andersenc9f20d92002-12-05 08:41:41 +000062
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000063config ASH_READ_NCHARS
Paul Fox7ba12c62006-06-08 21:48:47 +000064 bool "'read -n N' and 'read -s' support"
Mike Frysinger9ac178a2005-09-24 05:49:36 +000065 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000066 depends on ASH
Mike Frysinger9ac178a2005-09-24 05:49:36 +000067 help
Paul Fox02eb9342005-09-07 16:56:02 +000068 'read -n N' will return a value after N characters have been read.
69 'read -s' will read without echoing the user's input.
Ned Ludd2123b7c2005-02-09 21:07:23 +000070
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000071config ASH_READ_TIMEOUT
Paul Fox7ba12c62006-06-08 21:48:47 +000072 bool "'read -t S' support."
Mike Frysinger9ac178a2005-09-24 05:49:36 +000073 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000074 depends on ASH
Mike Frysinger9ac178a2005-09-24 05:49:36 +000075 help
Paul Fox02eb9342005-09-07 16:56:02 +000076 'read -t S' will return a value after S seconds have passed.
77 This implementation will allow fractional seconds, expressed
78 as a decimal fraction, e.g. 'read -t 2.5 foo'.
Ned Ludd2123b7c2005-02-09 21:07:23 +000079
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000080config ASH_ALIAS
Paul Fox7ba12c62006-06-08 21:48:47 +000081 bool "alias support"
Eric Andersenc9f20d92002-12-05 08:41:41 +000082 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000083 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +000084 help
Eric Andersene5642112003-07-14 19:37:08 +000085 Enable alias support in the ash shell.
Eric Andersenc9f20d92002-12-05 08:41:41 +000086
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000087config ASH_MATH_SUPPORT
Paul Fox7ba12c62006-06-08 21:48:47 +000088 bool "Posix math support"
Eric Andersenc9f20d92002-12-05 08:41:41 +000089 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000090 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +000091 help
Eric Andersene5642112003-07-14 19:37:08 +000092 Enable math support in the ash shell.
Eric Andersenc9f20d92002-12-05 08:41:41 +000093
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000094config ASH_MATH_SUPPORT_64
Rob Landley2ec922e2006-04-13 23:22:16 +000095 bool "Extend Posix math support to 64 bit"
Eric Andersened9ecf72004-06-22 08:29:45 +000096 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000097 depends on ASH_MATH_SUPPORT
Eric Andersened9ecf72004-06-22 08:29:45 +000098 help
99 Enable 64-bit math support in the ash shell. This will make
100 the shell slightly larger, but will allow computation with very
101 large numbers.
102
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000103config ASH_GETOPTS
Paul Fox6ab03782006-06-08 21:37:26 +0000104 bool "Builtin getopt to parse positional parameters"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000105 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000106 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000107 help
Glenn L McGrath53090cd2004-09-24 09:09:44 +0000108 Enable getopts builtin in the ash shell.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000109
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000110config ASH_BUILTIN_ECHO
Paul Fox6ab03782006-06-08 21:37:26 +0000111 bool "Builtin version of 'echo'"
112 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000113 depends on ASH
Paul Fox6ab03782006-06-08 21:37:26 +0000114 help
Bernhard Reutner-Fischereb10e172007-01-29 23:56:13 +0000115 Enable support for echo, builtin to ash.
Paul Fox6ab03782006-06-08 21:37:26 +0000116
Denis Vlasenkocd2663f2008-06-01 22:36:39 +0000117config ASH_BUILTIN_PRINTF
118 bool "Builtin version of 'printf'"
119 default y
120 depends on ASH
121 help
122 Enable support for printf, builtin to ash.
123
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000124config ASH_BUILTIN_TEST
Paul Fox6ab03782006-06-08 21:37:26 +0000125 bool "Builtin version of 'test'"
126 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000127 depends on ASH
Paul Fox6ab03782006-06-08 21:37:26 +0000128 help
Bernhard Reutner-Fischereb10e172007-01-29 23:56:13 +0000129 Enable support for test, builtin to ash.
Paul Fox6ab03782006-06-08 21:37:26 +0000130
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000131config ASH_CMDCMD
Paul Fox7ba12c62006-06-08 21:48:47 +0000132 bool "'command' command to override shell builtins"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000133 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000134 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000135 help
Eric Andersen3857a182003-07-22 10:14:32 +0000136 Enable support for the ash 'command' builtin, which allows
137 you to run the specified command with the specified arguments,
138 even when there is an ash builtin command with the same name.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000139
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000140config ASH_MAIL
Rob Landley2ec922e2006-04-13 23:22:16 +0000141 bool "Check for new mail on interactive shells"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000142 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000143 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000144 help
Eric Andersene5642112003-07-14 19:37:08 +0000145 Enable "check for new mail" in the ash shell.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000146
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000147config ASH_OPTIMIZE_FOR_SIZE
Rob Landley2ec922e2006-04-13 23:22:16 +0000148 bool "Optimize for size instead of speed"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000149 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000150 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000151 help
Rob Landley32251b42006-02-08 18:34:21 +0000152 Compile ash for reduced size at the price of speed.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000153
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000154config ASH_RANDOM_SUPPORT
Paul Fox7ba12c62006-06-08 21:48:47 +0000155 bool "Pseudorandom generator and variable $RANDOM"
Eric Andersen16767e22004-03-16 05:14:10 +0000156 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000157 depends on ASH
Eric Andersen16767e22004-03-16 05:14:10 +0000158 help
159 Enable pseudorandom generator and dynamic variable "$RANDOM".
160 Each read of "$RANDOM" will generate a new pseudorandom value.
161 You can reset the generator by using a specified start value.
162 After "unset RANDOM" then generator will switch off and this
163 variable will no longer have special treatment.
164
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000165config ASH_EXPAND_PRMT
Rob Landley2ec922e2006-04-13 23:22:16 +0000166 bool "Expand prompt string"
"Vladimir N. Oleynik"bef14d72005-09-05 13:25:11 +0000167 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000168 depends on ASH
"Vladimir N. Oleynik"bef14d72005-09-05 13:25:11 +0000169 help
Rob Landley32251b42006-02-08 18:34:21 +0000170 "PS#" may be contain volatile content, such as backquote commands.
171 This option recreates the prompt string from the environment
172 variable each time it is displayed.
"Vladimir N. Oleynik"bef14d72005-09-05 13:25:11 +0000173
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000174config HUSH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000175 bool "hush"
176 default n
177 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000178 hush is a very small shell (just 18k) and it has fairly complete
179 Bourne shell grammar. It even handles all the normal flow control
180 options such as if/then/elif/else/fi, for/in/do/done, while loops,
181 etc.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000182
Eric Andersenb287e2e2003-08-08 23:40:12 +0000183 It does not handle case/esac, select, function, here documents ( <<
184 word ), arithmetic expansion, aliases, brace expansion, tilde
185 expansion, &> and >& redirection of stdout+stderr, etc.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000186
Denis Vlasenko06810332007-05-21 23:30:54 +0000187config HUSH_HELP
188 bool "help builtin"
189 default n
Denis Vlasenko42bffbf2007-06-08 08:02:53 +0000190 depends on HUSH
Denis Vlasenko06810332007-05-21 23:30:54 +0000191 help
192 Enable help builtin in hush. Code size + ~1 kbyte.
193
Denis Vlasenkob81b3df2007-04-28 16:48:04 +0000194config HUSH_INTERACTIVE
195 bool "Interactive mode"
196 default y
197 depends on HUSH
198 help
Denis Vlasenkoe3f2f892007-04-28 16:48:27 +0000199 Enable interactive mode (prompt and command editing).
200 Without this, hush simply reads and executes commands
201 from stdin just like a shell script from the file.
202 No prompt, no PS1/PS2 magic shell variables.
203
204config HUSH_JOB
205 bool "Job control"
206 default n
207 depends on HUSH_INTERACTIVE
208 help
209 Enable job control: Ctrl-Z backgrounds, Ctrl-C interrupts current
210 command (not entire shell), fg/bg builtins work. Without this option,
211 "cmd &" still works by simply spawning a process and immediately
212 prompting for next command (or executing next command in a script),
213 but no separate process group is formed.
Denis Vlasenkob81b3df2007-04-28 16:48:04 +0000214
Denis Vlasenko14b5dd92007-05-20 21:51:38 +0000215config HUSH_TICK
216 bool "Process substitution"
217 default n
Denis Vlasenko42bffbf2007-06-08 08:02:53 +0000218 depends on HUSH
Denis Vlasenko14b5dd92007-05-20 21:51:38 +0000219 help
220 Enable process substitution `command` and $(command) in hush.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000221
Denis Vlasenko06810332007-05-21 23:30:54 +0000222config HUSH_IF
223 bool "Support if/then/elif/else/fi"
224 default n
Denis Vlasenko42bffbf2007-06-08 08:02:53 +0000225 depends on HUSH
Denis Vlasenko06810332007-05-21 23:30:54 +0000226 help
227 Enable if/then/elif/else/fi in hush.
228
229config HUSH_LOOPS
230 bool "Support for, while and until loops"
231 default n
Denis Vlasenko42bffbf2007-06-08 08:02:53 +0000232 depends on HUSH
Denis Vlasenko06810332007-05-21 23:30:54 +0000233 help
234 Enable for, while and until loops in hush.
235
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000236config LASH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000237 bool "lash"
238 default n
Denis Vlasenko96702ca2007-11-23 23:28:55 +0000239 select HUSH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000240 help
Denis Vlasenko96702ca2007-11-23 23:28:55 +0000241 lash is deprecated and will be removed, please migrate to hush.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000242
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000243config MSH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000244 bool "msh"
245 default n
246 help
Eric Andersenb287e2e2003-08-08 23:40:12 +0000247 The minix shell (adds just 30k) is quite complete and handles things
248 like for/do/done, case/esac and all the things you expect a Bourne
249 shell to do. It is not always pedantically correct about Bourne
Eric Andersen88c916b2003-10-22 09:58:56 +0000250 shell grammar (try running the shell testscript "tests/sh.testcases"
Eric Andersenb287e2e2003-08-08 23:40:12 +0000251 on it and compare vs bash) but for most things it works quite well.
252 It also uses only vfork, so it can be used on uClinux systems.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000253
254comment "Bourne Shell Options"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000255 depends on MSH || LASH || HUSH || ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000256
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000257config FEATURE_SH_EXTRA_QUIET
Glenn L McGrath3b251852004-01-03 12:07:32 +0000258 bool "Hide message on interactive shell startup"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000259 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000260 depends on MSH || LASH || HUSH || ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000261 help
Glenn L McGrath3b251852004-01-03 12:07:32 +0000262 Remove the busybox introduction when starting a shell.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000263
Denis Vlasenko80d14be2007-04-10 23:03:30 +0000264config FEATURE_SH_STANDALONE
Eric Andersenc9f20d92002-12-05 08:41:41 +0000265 bool "Standalone shell"
266 default n
Denis Vlasenko80d14be2007-04-10 23:03:30 +0000267 depends on (MSH || LASH || HUSH || ASH) && FEATURE_PREFER_APPLETS
Eric Andersenc9f20d92002-12-05 08:41:41 +0000268 help
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000269 This option causes busybox shells to use busybox applets
Eric Andersen075dd812004-04-07 09:34:27 +0000270 in preference to executables in the PATH whenever possible. For
271 example, entering the command 'ifconfig' into the shell would cause
272 busybox to use the ifconfig busybox applet. Specifying the fully
273 qualified executable name, such as '/sbin/ifconfig' will still
274 execute the /sbin/ifconfig executable on the filesystem. This option
Rob Landley06ec8cf2006-03-03 19:02:50 +0000275 is generally used when creating a statically linked version of busybox
Eric Andersen075dd812004-04-07 09:34:27 +0000276 for use as a rescue shell, in the event that you screw up your system.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000277
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000278 This is implemented by re-execing /proc/self/exe (typically)
279 with right parameters. Some selected applets ("NOFORK" applets)
280 can even be executed without creating new process.
281 Instead, busybox will call <applet>_main() internally.
Paul Fox6ab03782006-06-08 21:37:26 +0000282
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000283 However, this causes problems in chroot jails without mounted /proc
284 and with ps/top (command name can be shown as 'exe' for applets
285 started this way).
286# untrue?
287# Note that this will *also* cause applets to take precedence
288# over shell builtins of the same name. So turning this on will
289# eliminate any performance gained by turning on the builtin "echo"
290# and "test" commands in ash.
291# untrue?
292# Note that when using this option, the shell will attempt to directly
293# run '/bin/busybox'. If you do not have the busybox binary sitting in
294# that exact location with that exact name, this option will not work at
295# all.
Eric Andersen6f8542b2004-09-24 01:25:39 +0000296
Denis Vlasenko9bc80d72008-04-12 20:07:53 +0000297config FEATURE_SH_NOFORK
298 bool "Run 'nofork' applets directly"
299 default n
300 depends on (MSH || LASH || HUSH || ASH) && FEATURE_PREFER_APPLETS
301 help
302 This option causes busybox shells [currently only ash]
303 to not execute typical fork/exec/wait sequence, but call <applet>_main
304 directly, if possible. (Sometimes it is not possible: for example,
305 this is not possible in pipes).
306
307 This will be done only for some applets (those which are marked
308 NOFORK in include/applets.h).
309
310 This may significantly speed up some shell scripts.
311
312 This feature is relatively new. Use with care.
313
Denis Vlasenko6d709972007-05-18 09:45:36 +0000314config CTTYHACK
315 bool "cttyhack"
316 default n
317 help
318 One common problem reported on the mailing list is "can't access tty;
319 job control turned off" error message which typically appears when
320 one tries to use shell with stdin/stdout opened to /dev/console.
321 This device is special - it cannot be a controlling tty.
322
323 Proper solution is to use correct device instead of /dev/console.
324
325 cttyhack provides "quick and dirty" solution to this problem.
326 It analyzes stdin with various ioctls, trying to determine whether
327 it is a /dev/ttyN or /dev/ttySN (virtual terminal or serial line).
328 If it detects one, it closes stdin/out/err and reopens that device.
329 Then it executes given program. Usage example for /etc/inittab
330 (for busybox init):
331
332 ::respawn:/bin/cttyhack /bin/sh
333
Eric Andersenc9f20d92002-12-05 08:41:41 +0000334endmenu