blob: 9bd493fed5677f267c96b3322e831c7882b069f7 [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 Vlasenkoc8aae0b2010-06-06 22:14:58 +02008
9choice
10 prompt "Choose which shell is aliased to 'sh' name"
Denys Vlasenko0b883582016-12-23 16:49:07 +010011 default SH_IS_ASH
Denys Vlasenkoc8aae0b2010-06-06 22:14:58 +020012 help
13 Choose which shell you want to be executed by 'sh' alias.
14 The ash shell is the most bash compatible and full featured one.
15
Denys Vlasenko121fb952010-06-07 13:34:34 +020016# note: cannot use "select ASH" here, it breaks "make allnoconfig"
Denys Vlasenko0b883582016-12-23 16:49:07 +010017config SH_IS_ASH
Denys Vlasenkoc8aae0b2010-06-06 22:14:58 +020018 depends on !NOMMU
Denys Vlasenko0b883582016-12-23 16:49:07 +010019 bool "ash"
Kang-Che Sung95291152017-01-04 12:29:04 +010020 help
21 Choose ash to be the shell executed by 'sh' name.
22 The ash code will be built into busybox. If you don't select
23 "ash" choice (CONFIG_ASH), this shell may only be invoked by
24 the name 'sh' (and not 'ash').
Denys Vlasenkoc8aae0b2010-06-06 22:14:58 +020025
Denys Vlasenko0b883582016-12-23 16:49:07 +010026config SH_IS_HUSH
Denys Vlasenkoc8aae0b2010-06-06 22:14:58 +020027 bool "hush"
Kang-Che Sung95291152017-01-04 12:29:04 +010028 help
29 Choose hush to be the shell executed by 'sh' name.
30 The hush code will be built into busybox. If you don't select
31 "hush" choice (CONFIG_HUSH), this shell may only be invoked by
32 the name 'sh' (and not 'hush').
Denys Vlasenkoc8aae0b2010-06-06 22:14:58 +020033
Denys Vlasenko0b883582016-12-23 16:49:07 +010034config SH_IS_NONE
Denys Vlasenkoc8aae0b2010-06-06 22:14:58 +020035 bool "none"
36
37endchoice
38
39choice
40 prompt "Choose which shell is aliased to 'bash' name"
Denys Vlasenko0b883582016-12-23 16:49:07 +010041 default BASH_IS_NONE
Denys Vlasenkoc8aae0b2010-06-06 22:14:58 +020042 help
43 Choose which shell you want to be executed by 'bash' alias.
Kang-Che Sung95291152017-01-04 12:29:04 +010044 The ash shell is the most bash compatible and full featured one,
45 although compatibility is far from being complete.
Denys Vlasenkoc8aae0b2010-06-06 22:14:58 +020046
47 Note that selecting this option does not switch on any bash
48 compatibility code. It merely makes it possible to install
49 /bin/bash (sym)link and run scripts which start with
50 #!/bin/bash line.
51
52 Many systems use it in scripts which use bash-specific features,
53 even simple ones like $RANDOM. Without this option, busybox
54 can't be used for running them because it won't recongnize
55 "bash" as a supported applet name.
56
Denys Vlasenko0b883582016-12-23 16:49:07 +010057config BASH_IS_ASH
Denys Vlasenkoc8aae0b2010-06-06 22:14:58 +020058 depends on !NOMMU
Denys Vlasenko0b883582016-12-23 16:49:07 +010059 bool "ash"
Kang-Che Sung95291152017-01-04 12:29:04 +010060 help
61 Choose ash to be the shell executed by 'bash' name.
62 The ash code will be built into busybox. If you don't select
63 "ash" choice (CONFIG_ASH), this shell may only be invoked by
64 the name 'bash' (and not 'ash').
Denys Vlasenkoc8aae0b2010-06-06 22:14:58 +020065
Denys Vlasenko0b883582016-12-23 16:49:07 +010066config BASH_IS_HUSH
Denys Vlasenkoc8aae0b2010-06-06 22:14:58 +020067 bool "hush"
Kang-Che Sung95291152017-01-04 12:29:04 +010068 help
69 Choose hush to be the shell executed by 'bash' name.
70 The hush code will be built into busybox. If you don't select
71 "hush" choice (CONFIG_HUSH), this shell may only be invoked by
72 the name 'bash' (and not 'hush').
Denys Vlasenkoc8aae0b2010-06-06 22:14:58 +020073
Denys Vlasenko0b883582016-12-23 16:49:07 +010074config BASH_IS_NONE
Denys Vlasenkoc8aae0b2010-06-06 22:14:58 +020075 bool "none"
76
77endchoice
78
79
Denys Vlasenko0b883582016-12-23 16:49:07 +010080INSERT
81
82
83config FEATURE_SH_MATH
Mike Frysinger98c52642009-04-02 10:02:37 +000084 bool "POSIX math support"
85 default y
Denys Vlasenko0b883582016-12-23 16:49:07 +010086 depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH
Mike Frysinger98c52642009-04-02 10:02:37 +000087 help
88 Enable math support in the shell via $((...)) syntax.
89
Denys Vlasenko0b883582016-12-23 16:49:07 +010090config FEATURE_SH_MATH_64
Mike Frysinger98c52642009-04-02 10:02:37 +000091 bool "Extend POSIX math support to 64 bit"
Denys Vlasenko2f32bf82010-06-06 04:14:28 +020092 default y
Denys Vlasenko0b883582016-12-23 16:49:07 +010093 depends on FEATURE_SH_MATH
Mike Frysinger98c52642009-04-02 10:02:37 +000094 help
95 Enable 64-bit math support in the shell. This will make the shell
96 slightly larger, but will allow computation with very large numbers.
97 This is not in POSIX, so do not rely on this in portable code.
98
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000099config FEATURE_SH_EXTRA_QUIET
Glenn L McGrath3b251852004-01-03 12:07:32 +0000100 bool "Hide message on interactive shell startup"
Denys Vlasenko2f32bf82010-06-06 04:14:28 +0200101 default y
Denys Vlasenko0b883582016-12-23 16:49:07 +0100102 depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000103 help
Glenn L McGrath3b251852004-01-03 12:07:32 +0000104 Remove the busybox introduction when starting a shell.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000105
Denis Vlasenko80d14be2007-04-10 23:03:30 +0000106config FEATURE_SH_STANDALONE
Eric Andersenc9f20d92002-12-05 08:41:41 +0000107 bool "Standalone shell"
108 default n
Denys Vlasenko0b883582016-12-23 16:49:07 +0100109 depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000110 help
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000111 This option causes busybox shells to use busybox applets
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000112 in preference to executables in the PATH whenever possible. For
Eric Andersen075dd812004-04-07 09:34:27 +0000113 example, entering the command 'ifconfig' into the shell would cause
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000114 busybox to use the ifconfig busybox applet. Specifying the fully
Eric Andersen075dd812004-04-07 09:34:27 +0000115 qualified executable name, such as '/sbin/ifconfig' will still
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000116 execute the /sbin/ifconfig executable on the filesystem. This option
Rob Landley06ec8cf2006-03-03 19:02:50 +0000117 is generally used when creating a statically linked version of busybox
Eric Andersen075dd812004-04-07 09:34:27 +0000118 for use as a rescue shell, in the event that you screw up your system.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000119
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000120 This is implemented by re-execing /proc/self/exe (typically)
121 with right parameters. Some selected applets ("NOFORK" applets)
122 can even be executed without creating new process.
123 Instead, busybox will call <applet>_main() internally.
Paul Fox6ab03782006-06-08 21:37:26 +0000124
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000125 However, this causes problems in chroot jails without mounted /proc
126 and with ps/top (command name can be shown as 'exe' for applets
127 started this way).
128# untrue?
129# Note that this will *also* cause applets to take precedence
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000130# over shell builtins of the same name. So turning this on will
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000131# eliminate any performance gained by turning on the builtin "echo"
132# and "test" commands in ash.
133# untrue?
134# Note that when using this option, the shell will attempt to directly
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000135# run '/bin/busybox'. If you do not have the busybox binary sitting in
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000136# that exact location with that exact name, this option will not work at
137# all.
Eric Andersen6f8542b2004-09-24 01:25:39 +0000138
Denis Vlasenko9bc80d72008-04-12 20:07:53 +0000139config FEATURE_SH_NOFORK
140 bool "Run 'nofork' applets directly"
141 default n
Denys Vlasenko0b883582016-12-23 16:49:07 +0100142 depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH
Denis Vlasenko9bc80d72008-04-12 20:07:53 +0000143 help
Denys Vlasenkob72baeb2011-02-02 18:38:57 +0100144 This option causes busybox shells to not execute typical
145 fork/exec/wait sequence, but call <applet>_main directly,
146 if possible. (Sometimes it is not possible: for example,
Denis Vlasenko9bc80d72008-04-12 20:07:53 +0000147 this is not possible in pipes).
148
149 This will be done only for some applets (those which are marked
150 NOFORK in include/applets.h).
151
152 This may significantly speed up some shell scripts.
153
Denys Vlasenkob72baeb2011-02-02 18:38:57 +0100154 This feature is relatively new. Use with care. Report bugs
155 to project mailing list.
Denis Vlasenko9bc80d72008-04-12 20:07:53 +0000156
Denys Vlasenko2c4de5b2011-03-31 13:16:52 +0200157config FEATURE_SH_HISTFILESIZE
158 bool "Use $HISTFILESIZE"
159 default y
Denys Vlasenko0b883582016-12-23 16:49:07 +0100160 depends on ASH || HUSH || SH_IS_ASH || BASH_IS_ASH || SH_IS_HUSH || BASH_IS_HUSH
Denys Vlasenko2c4de5b2011-03-31 13:16:52 +0200161 help
162 This option makes busybox shells to use $HISTFILESIZE variable
163 to set shell history size. Note that its max value is capped
164 by "History size" setting in library tuning section.
165
166
Eric Andersenc9f20d92002-12-05 08:41:41 +0000167endmenu