blob: 90479013eb32ff6044109ded967d55ce0624c9ef [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 Vlasenko7d219aa2006-10-05 10:17:08 +000023config FEATURE_SH_IS_LASH
24 select LASH
Eric Andersenc9f20d92002-12-05 08:41:41 +000025 bool "lash"
26
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
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000039 select TEST
Eric Andersenc9f20d92002-12-05 08:41:41 +000040 help
Eric Andersenb287e2e2003-08-08 23:40:12 +000041 Tha 'ash' shell adds about 60k in the default configuration and is
42 the most complete and most pedantically correct shell included with
Eric Andersen88c916b2003-10-22 09:58:56 +000043 busybox. This shell is actually a derivative of the Debian 'dash'
44 shell (by Herbert Xu), which was created by porting the 'ash' shell
Eric Andersenc7bda1c2004-03-15 08:29:22 +000045 (written by Kenneth Almquist) from NetBSD.
Eric Andersenc9f20d92002-12-05 08:41:41 +000046
47comment "Ash Shell Options"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000048 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +000049
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000050config ASH_JOB_CONTROL
Paul Fox7ba12c62006-06-08 21:48:47 +000051 bool "Job control"
Eric Andersenc9f20d92002-12-05 08:41:41 +000052 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000053 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +000054 help
Eric Andersene5642112003-07-14 19:37:08 +000055 Enable job control in the ash shell.
Eric Andersenc9f20d92002-12-05 08:41:41 +000056
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000057config ASH_READ_NCHARS
Paul Fox7ba12c62006-06-08 21:48:47 +000058 bool "'read -n N' and 'read -s' support"
Mike Frysinger9ac178a2005-09-24 05:49:36 +000059 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000060 depends on ASH
Mike Frysinger9ac178a2005-09-24 05:49:36 +000061 help
Paul Fox02eb9342005-09-07 16:56:02 +000062 'read -n N' will return a value after N characters have been read.
63 'read -s' will read without echoing the user's input.
Ned Ludd2123b7c2005-02-09 21:07:23 +000064
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000065config ASH_READ_TIMEOUT
Paul Fox7ba12c62006-06-08 21:48:47 +000066 bool "'read -t S' support."
Mike Frysinger9ac178a2005-09-24 05:49:36 +000067 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000068 depends on ASH
Mike Frysinger9ac178a2005-09-24 05:49:36 +000069 help
Paul Fox02eb9342005-09-07 16:56:02 +000070 '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'.
Ned Ludd2123b7c2005-02-09 21:07:23 +000073
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000074config ASH_ALIAS
Paul Fox7ba12c62006-06-08 21:48:47 +000075 bool "alias support"
Eric Andersenc9f20d92002-12-05 08:41:41 +000076 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000077 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +000078 help
Eric Andersene5642112003-07-14 19:37:08 +000079 Enable alias support in the ash shell.
Eric Andersenc9f20d92002-12-05 08:41:41 +000080
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000081config ASH_MATH_SUPPORT
Paul Fox7ba12c62006-06-08 21:48:47 +000082 bool "Posix math support"
Eric Andersenc9f20d92002-12-05 08:41:41 +000083 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000084 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +000085 help
Eric Andersene5642112003-07-14 19:37:08 +000086 Enable math support in the ash shell.
Eric Andersenc9f20d92002-12-05 08:41:41 +000087
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000088config ASH_MATH_SUPPORT_64
Rob Landley2ec922e2006-04-13 23:22:16 +000089 bool "Extend Posix math support to 64 bit"
Eric Andersened9ecf72004-06-22 08:29:45 +000090 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000091 depends on ASH_MATH_SUPPORT
Eric Andersened9ecf72004-06-22 08:29:45 +000092 help
93 Enable 64-bit math support in the ash shell. This will make
94 the shell slightly larger, but will allow computation with very
95 large numbers.
96
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000097config ASH_GETOPTS
Paul Fox6ab03782006-06-08 21:37:26 +000098 bool "Builtin getopt to parse positional parameters"
Eric Andersenc9f20d92002-12-05 08:41:41 +000099 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000100 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000101 help
Glenn L McGrath53090cd2004-09-24 09:09:44 +0000102 Enable getopts builtin in the ash shell.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000103
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000104config ASH_BUILTIN_ECHO
Paul Fox6ab03782006-06-08 21:37:26 +0000105 bool "Builtin version of 'echo'"
106 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000107 select ECHO
108 depends on ASH
Paul Fox6ab03782006-06-08 21:37:26 +0000109 help
Bernhard Reutner-Fischereb10e172007-01-29 23:56:13 +0000110 Enable support for echo, builtin to ash.
Paul Fox6ab03782006-06-08 21:37:26 +0000111
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000112config ASH_BUILTIN_TEST
Paul Fox6ab03782006-06-08 21:37:26 +0000113 bool "Builtin version of 'test'"
114 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000115 select TEST
116 depends on ASH
Paul Fox6ab03782006-06-08 21:37:26 +0000117 help
Bernhard Reutner-Fischereb10e172007-01-29 23:56:13 +0000118 Enable support for test, builtin to ash.
Paul Fox6ab03782006-06-08 21:37:26 +0000119
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000120config ASH_CMDCMD
Paul Fox7ba12c62006-06-08 21:48:47 +0000121 bool "'command' command to override shell builtins"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000122 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000123 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000124 help
Eric Andersen3857a182003-07-22 10:14:32 +0000125 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.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000128
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000129config ASH_MAIL
Rob Landley2ec922e2006-04-13 23:22:16 +0000130 bool "Check for new mail on interactive shells"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000131 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000132 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000133 help
Eric Andersene5642112003-07-14 19:37:08 +0000134 Enable "check for new mail" in the ash shell.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000135
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000136config ASH_OPTIMIZE_FOR_SIZE
Rob Landley2ec922e2006-04-13 23:22:16 +0000137 bool "Optimize for size instead of speed"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000138 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000139 depends on ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000140 help
Rob Landley32251b42006-02-08 18:34:21 +0000141 Compile ash for reduced size at the price of speed.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000142
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000143config ASH_RANDOM_SUPPORT
Paul Fox7ba12c62006-06-08 21:48:47 +0000144 bool "Pseudorandom generator and variable $RANDOM"
Eric Andersen16767e22004-03-16 05:14:10 +0000145 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000146 depends on ASH
Eric Andersen16767e22004-03-16 05:14:10 +0000147 help
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.
153
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000154config ASH_EXPAND_PRMT
Rob Landley2ec922e2006-04-13 23:22:16 +0000155 bool "Expand prompt string"
"Vladimir N. Oleynik"bef14d72005-09-05 13:25:11 +0000156 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000157 depends on ASH
"Vladimir N. Oleynik"bef14d72005-09-05 13:25:11 +0000158 help
Rob Landley32251b42006-02-08 18:34:21 +0000159 "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.
"Vladimir N. Oleynik"bef14d72005-09-05 13:25:11 +0000162
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000163config HUSH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000164 bool "hush"
165 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000166 select TRUE
167 select FALSE
168 select TEST
Eric Andersenc9f20d92002-12-05 08:41:41 +0000169 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000170 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,
173 etc.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000174
Eric Andersenb287e2e2003-08-08 23:40:12 +0000175 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.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000178
Denis Vlasenko06810332007-05-21 23:30:54 +0000179config HUSH_HELP
180 bool "help builtin"
181 default n
182 help
183 Enable help builtin in hush. Code size + ~1 kbyte.
184
Denis Vlasenkob81b3df2007-04-28 16:48:04 +0000185config HUSH_INTERACTIVE
186 bool "Interactive mode"
187 default y
188 depends on HUSH
189 help
Denis Vlasenkoe3f2f892007-04-28 16:48:27 +0000190 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.
194
195config HUSH_JOB
196 bool "Job control"
197 default n
198 depends on HUSH_INTERACTIVE
199 help
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.
Denis Vlasenkob81b3df2007-04-28 16:48:04 +0000205
Denis Vlasenko14b5dd92007-05-20 21:51:38 +0000206config HUSH_TICK
207 bool "Process substitution"
208 default n
209 help
210 Enable process substitution `command` and $(command) in hush.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000211
Denis Vlasenko06810332007-05-21 23:30:54 +0000212config HUSH_IF
213 bool "Support if/then/elif/else/fi"
214 default n
215 help
216 Enable if/then/elif/else/fi in hush.
217
218config HUSH_LOOPS
219 bool "Support for, while and until loops"
220 default n
221 help
222 Enable for, while and until loops in hush.
223
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000224config LASH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000225 bool "lash"
226 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000227 select TRUE
228 select FALSE
229 select TEST
Eric Andersenc9f20d92002-12-05 08:41:41 +0000230 help
Eric Andersenb287e2e2003-08-08 23:40:12 +0000231 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
Eric Andersen88c916b2003-10-22 09:58:56 +0000234 times) since it does not understand any Bourne shell grammar. It
Eric Andersenb287e2e2003-08-08 23:40:12 +0000235 does handle pipes, redirects, and job control though. Adding in
236 command editing makes it a very nice lightweight command prompt.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000237
Eric Andersenc9f20d92002-12-05 08:41:41 +0000238
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000239config MSH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000240 bool "msh"
241 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000242 select TRUE
243 select FALSE
244 select TEST
Eric Andersenc9f20d92002-12-05 08:41:41 +0000245 help
Eric Andersenb287e2e2003-08-08 23:40:12 +0000246 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
Eric Andersen88c916b2003-10-22 09:58:56 +0000249 shell grammar (try running the shell testscript "tests/sh.testcases"
Eric Andersenb287e2e2003-08-08 23:40:12 +0000250 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.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000252
253comment "Bourne Shell Options"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000254 depends on MSH || LASH || HUSH || ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000255
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000256config FEATURE_SH_EXTRA_QUIET
Glenn L McGrath3b251852004-01-03 12:07:32 +0000257 bool "Hide message on interactive shell startup"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000258 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000259 depends on MSH || LASH || HUSH || ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000260 help
Glenn L McGrath3b251852004-01-03 12:07:32 +0000261 Remove the busybox introduction when starting a shell.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000262
Denis Vlasenko80d14be2007-04-10 23:03:30 +0000263config FEATURE_SH_STANDALONE
Eric Andersenc9f20d92002-12-05 08:41:41 +0000264 bool "Standalone shell"
265 default n
Denis Vlasenko80d14be2007-04-10 23:03:30 +0000266 depends on (MSH || LASH || HUSH || ASH) && FEATURE_PREFER_APPLETS
Eric Andersenc9f20d92002-12-05 08:41:41 +0000267 help
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000268 This option causes busybox shells to use busybox applets
Eric Andersen075dd812004-04-07 09:34:27 +0000269 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
Rob Landley06ec8cf2006-03-03 19:02:50 +0000274 is generally used when creating a statically linked version of busybox
Eric Andersen075dd812004-04-07 09:34:27 +0000275 for use as a rescue shell, in the event that you screw up your system.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000276
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000277 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.
Paul Fox6ab03782006-06-08 21:37:26 +0000281
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000282 However, this causes problems in chroot jails without mounted /proc
283 and with ps/top (command name can be shown as 'exe' for applets
284 started this way).
285# untrue?
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.
290# untrue?
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
294# all.
Eric Andersen6f8542b2004-09-24 01:25:39 +0000295
Denis Vlasenko6d709972007-05-18 09:45:36 +0000296config CTTYHACK
297 bool "cttyhack"
298 default n
299 help
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.
304
305 Proper solution is to use correct device instead of /dev/console.
306
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
312 (for busybox init):
313
314 ::respawn:/bin/cttyhack /bin/sh
315
Eric Andersenc9f20d92002-12-05 08:41:41 +0000316endmenu