blob: e96c21620e557bb7ed85ff9a722ae1326a551fc8 [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
Denys Vlasenkod70e0e92010-06-08 12:15:11 +02008INSERT
9
Denys Vlasenkoc8aae0b2010-06-06 22:14:58 +020010
11choice
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
Denys Vlasenko121fb952010-06-07 13:34:34 +020018# note: cannot use "select ASH" here, it breaks "make allnoconfig"
Denys Vlasenkoc8aae0b2010-06-06 22:14:58 +020019config FEATURE_SH_IS_ASH
20 depends on ASH
21 bool "ash"
22 depends on !NOMMU
23
24config FEATURE_SH_IS_HUSH
25 depends on HUSH
26 bool "hush"
27
28config FEATURE_SH_IS_NONE
29 bool "none"
30
31endchoice
32
33choice
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
50config FEATURE_BASH_IS_ASH
51 depends on ASH
52 bool "ash"
53 depends on !NOMMU
54
55config FEATURE_BASH_IS_HUSH
56 depends on HUSH
57 bool "hush"
58
59config FEATURE_BASH_IS_NONE
60 bool "none"
61
62endchoice
63
64
Mike Frysinger98c52642009-04-02 10:02:37 +000065config 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
72config SH_MATH_SUPPORT_64
73 bool "Extend POSIX math support to 64 bit"
Denys Vlasenko2f32bf82010-06-06 04:14:28 +020074 default y
Mike Frysinger98c52642009-04-02 10:02:37 +000075 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
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000081config FEATURE_SH_EXTRA_QUIET
Glenn L McGrath3b251852004-01-03 12:07:32 +000082 bool "Hide message on interactive shell startup"
Denys Vlasenko2f32bf82010-06-06 04:14:28 +020083 default y
84 depends on HUSH || ASH
Eric Andersenc9f20d92002-12-05 08:41:41 +000085 help
Glenn L McGrath3b251852004-01-03 12:07:32 +000086 Remove the busybox introduction when starting a shell.
Eric Andersenc9f20d92002-12-05 08:41:41 +000087
Denis Vlasenko80d14be2007-04-10 23:03:30 +000088config FEATURE_SH_STANDALONE
Eric Andersenc9f20d92002-12-05 08:41:41 +000089 bool "Standalone shell"
90 default n
Denys Vlasenko2f32bf82010-06-06 04:14:28 +020091 depends on (HUSH || ASH) && FEATURE_PREFER_APPLETS
Eric Andersenc9f20d92002-12-05 08:41:41 +000092 help
Denis Vlasenko92c0b822007-05-08 17:27:17 +000093 This option causes busybox shells to use busybox applets
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000094 in preference to executables in the PATH whenever possible. For
Eric Andersen075dd812004-04-07 09:34:27 +000095 example, entering the command 'ifconfig' into the shell would cause
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000096 busybox to use the ifconfig busybox applet. Specifying the fully
Eric Andersen075dd812004-04-07 09:34:27 +000097 qualified executable name, such as '/sbin/ifconfig' will still
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000098 execute the /sbin/ifconfig executable on the filesystem. This option
Rob Landley06ec8cf2006-03-03 19:02:50 +000099 is generally used when creating a statically linked version of busybox
Eric Andersen075dd812004-04-07 09:34:27 +0000100 for use as a rescue shell, in the event that you screw up your system.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000101
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000102 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.
Paul Fox6ab03782006-06-08 21:37:26 +0000106
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000107 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
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000112# over shell builtins of the same name. So turning this on will
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000113# 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
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000117# run '/bin/busybox'. If you do not have the busybox binary sitting in
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000118# that exact location with that exact name, this option will not work at
119# all.
Eric Andersen6f8542b2004-09-24 01:25:39 +0000120
Denis Vlasenko9bc80d72008-04-12 20:07:53 +0000121config FEATURE_SH_NOFORK
122 bool "Run 'nofork' applets directly"
123 default n
Denys Vlasenko2f32bf82010-06-06 04:14:28 +0200124 depends on (HUSH || ASH) && FEATURE_PREFER_APPLETS
Denis Vlasenko9bc80d72008-04-12 20:07:53 +0000125 help
Denys Vlasenkob72baeb2011-02-02 18:38:57 +0100126 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,
Denis Vlasenko9bc80d72008-04-12 20:07:53 +0000129 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
Denys Vlasenkob72baeb2011-02-02 18:38:57 +0100136 This feature is relatively new. Use with care. Report bugs
137 to project mailing list.
Denis Vlasenko9bc80d72008-04-12 20:07:53 +0000138
Eric Andersenc9f20d92002-12-05 08:41:41 +0000139endmenu