Blame - shell/Config.in - codeaurora/busybox

blob: 8f2f98e681f74e686c99a9b2d5d8188885663232 [file] [log] [blame]

Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	1	#
				2	# For a description of the syntax of this configuration file,
				3	# see scripts/kbuild/config-language.txt.
				4	#
				5
Mike Frysinger	9ac178a	2005-09-24 05:49:36 +0000	[diff] [blame]	6	menu "Shells"
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	7
				8	choice
				9	prompt "Choose your default shell"
Eric Andersen	72d8e44	2003-08-05 02:18:25 +0000	[diff] [blame]	10	default CONFIG_FEATURE_SH_IS_NONE
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	11	help
Eric Andersen	e564211	2003-07-14 19:37:08 +0000	[diff] [blame]	12	Choose a shell. The ash shell is the most bash compatible
Eric Andersen	88c916b	2003-10-22 09:58:56 +0000	[diff] [blame]	13	and full featured one.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	14
				15	config CONFIG_FEATURE_SH_IS_ASH
Eric Andersen	b287e2e	2003-08-08 23:40:12 +0000	[diff] [blame]	16	select CONFIG_ASH
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	17	bool "ash"
				18
				19	config CONFIG_FEATURE_SH_IS_HUSH
Eric Andersen	b287e2e	2003-08-08 23:40:12 +0000	[diff] [blame]	20	select CONFIG_HUSH
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	21	bool "hush"
				22
				23	config CONFIG_FEATURE_SH_IS_LASH
Eric Andersen	b287e2e	2003-08-08 23:40:12 +0000	[diff] [blame]	24	select CONFIG_LASH
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	25	bool "lash"
				26
				27	config CONFIG_FEATURE_SH_IS_MSH
Eric Andersen	b287e2e	2003-08-08 23:40:12 +0000	[diff] [blame]	28	select CONFIG_MSH
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	29	bool "msh"
				30
Eric Andersen	a6b9051	2002-12-06 21:49:59 +0000	[diff] [blame]	31	config CONFIG_FEATURE_SH_IS_NONE
				32	bool "none"
				33
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	34	endchoice
				35
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	36	config CONFIG_ASH
				37	bool "ash"
Rob Landley	49576c0	2006-01-30 06:11:42 +0000	[diff] [blame]	38	default n
Bernhard Reutner-Fischer	96002bb	2006-01-19 14:42:23 +0000	[diff] [blame]	39	select CONFIG_TEST
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	40	help
Eric Andersen	b287e2e	2003-08-08 23:40:12 +0000	[diff] [blame]	41	Tha 'ash' shell adds about 60k in the default configuration and is
				42	the most complete and most pedantically correct shell included with
Eric Andersen	88c916b	2003-10-22 09:58:56 +0000	[diff] [blame]	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
Eric Andersen	c7bda1c	2004-03-15 08:29:22 +0000	[diff] [blame]	45	(written by Kenneth Almquist) from NetBSD.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	46
				47	comment "Ash Shell Options"
				48	depends on CONFIG_ASH
				49
				50	config CONFIG_ASH_JOB_CONTROL
Rob Landley	2ec922e	2006-04-13 23:22:16 +0000	[diff] [blame]	51	bool "Enable Job control"
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	52	default y
				53	depends on CONFIG_ASH
				54	help
Eric Andersen	e564211	2003-07-14 19:37:08 +0000	[diff] [blame]	55	Enable job control in the ash shell.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	56
Paul Fox	02eb934	2005-09-07 16:56:02 +0000	[diff] [blame]	57	config CONFIG_ASH_READ_NCHARS
Rob Landley	2ec922e	2006-04-13 23:22:16 +0000	[diff] [blame]	58	bool "Enable 'read -n N' and 'read -s' support"
Mike Frysinger	9ac178a	2005-09-24 05:49:36 +0000	[diff] [blame]	59	default n
				60	depends on CONFIG_ASH
				61	help
Paul Fox	02eb934	2005-09-07 16:56:02 +0000	[diff] [blame]	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.
Ned Ludd	2123b7c	2005-02-09 21:07:23 +0000	[diff] [blame]	64
Paul Fox	02eb934	2005-09-07 16:56:02 +0000	[diff] [blame]	65	config CONFIG_ASH_READ_TIMEOUT
Rob Landley	2ec922e	2006-04-13 23:22:16 +0000	[diff] [blame]	66	bool "Enable 'read -t S' support."
Mike Frysinger	9ac178a	2005-09-24 05:49:36 +0000	[diff] [blame]	67	default n
				68	depends on CONFIG_ASH
				69	help
Paul Fox	02eb934	2005-09-07 16:56:02 +0000	[diff] [blame]	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'.
Ned Ludd	2123b7c	2005-02-09 21:07:23 +0000	[diff] [blame]	73
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	74	config CONFIG_ASH_ALIAS
Rob Landley	2ec922e	2006-04-13 23:22:16 +0000	[diff] [blame]	75	bool "Enable alias support"
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	76	default y
				77	depends on CONFIG_ASH
				78	help
Eric Andersen	e564211	2003-07-14 19:37:08 +0000	[diff] [blame]	79	Enable alias support in the ash shell.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	80
				81	config CONFIG_ASH_MATH_SUPPORT
Rob Landley	2ec922e	2006-04-13 23:22:16 +0000	[diff] [blame]	82	bool "Enable Posix math support"
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	83	default y
				84	depends on CONFIG_ASH
				85	help
Eric Andersen	e564211	2003-07-14 19:37:08 +0000	[diff] [blame]	86	Enable math support in the ash shell.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	87
Eric Andersen	ed9ecf7	2004-06-22 08:29:45 +0000	[diff] [blame]	88	config CONFIG_ASH_MATH_SUPPORT_64
Rob Landley	2ec922e	2006-04-13 23:22:16 +0000	[diff] [blame]	89	bool "Extend Posix math support to 64 bit"
Eric Andersen	ed9ecf7	2004-06-22 08:29:45 +0000	[diff] [blame]	90	default n
				91	depends on CONFIG_ASH_MATH_SUPPORT
				92	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
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	97	config CONFIG_ASH_GETOPTS
Paul Fox	6ab0378	2006-06-08 21:37:26 +0000	[diff] [blame^]	98	bool "Builtin getopt to parse positional parameters"
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	99	default n
				100	depends on CONFIG_ASH
				101	help
Glenn L McGrath	53090cd	2004-09-24 09:09:44 +0000	[diff] [blame]	102	Enable getopts builtin in the ash shell.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	103
Paul Fox	6ab0378	2006-06-08 21:37:26 +0000	[diff] [blame^]	104	config CONFIG_ASH_BUILTIN_ECHO
				105	bool "Builtin version of 'echo'"
				106	default y
				107	select CONFIG_ECHO
				108	depends on CONFIG_ASH
				109	help
				110	Enable support for echo, built in to ash.
				111
				112	config CONFIG_ASH_BUILTIN_TEST
				113	bool "Builtin version of 'test'"
				114	default y
				115	select CONFIG_TEST
				116	depends on CONFIG_ASH
				117	help
				118	Enable support for test, built in to ash.
				119
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	120	config CONFIG_ASH_CMDCMD
Rob Landley	2ec922e	2006-04-13 23:22:16 +0000	[diff] [blame]	121	bool "Enable cmdcmd to override shell builtins"
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	122	default n
				123	depends on CONFIG_ASH
				124	help
Eric Andersen	3857a18	2003-07-22 10:14:32 +0000	[diff] [blame]	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.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	128
				129	config CONFIG_ASH_MAIL
Rob Landley	2ec922e	2006-04-13 23:22:16 +0000	[diff] [blame]	130	bool "Check for new mail on interactive shells"
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	131	default y
				132	depends on CONFIG_ASH
				133	help
Eric Andersen	e564211	2003-07-14 19:37:08 +0000	[diff] [blame]	134	Enable "check for new mail" in the ash shell.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	135
				136	config CONFIG_ASH_OPTIMIZE_FOR_SIZE
Rob Landley	2ec922e	2006-04-13 23:22:16 +0000	[diff] [blame]	137	bool "Optimize for size instead of speed"
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	138	default y
				139	depends on CONFIG_ASH
				140	help
Rob Landley	32251b4	2006-02-08 18:34:21 +0000	[diff] [blame]	141	Compile ash for reduced size at the price of speed.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	142
Eric Andersen	16767e2	2004-03-16 05:14:10 +0000	[diff] [blame]	143	config CONFIG_ASH_RANDOM_SUPPORT
Rob Landley	2ec922e	2006-04-13 23:22:16 +0000	[diff] [blame]	144	bool "Enable pseudorandom generator and variable $RANDOM"
Eric Andersen	16767e2	2004-03-16 05:14:10 +0000	[diff] [blame]	145	default n
				146	depends on CONFIG_ASH
				147	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
"Vladimir N. Oleynik"	bef14d7	2005-09-05 13:25:11 +0000	[diff] [blame]	154	config CONFIG_ASH_EXPAND_PRMT
Rob Landley	2ec922e	2006-04-13 23:22:16 +0000	[diff] [blame]	155	bool "Expand prompt string"
"Vladimir N. Oleynik"	bef14d7	2005-09-05 13:25:11 +0000	[diff] [blame]	156	default n
				157	depends on CONFIG_ASH
				158	help
Rob Landley	32251b4	2006-02-08 18:34:21 +0000	[diff] [blame]	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.
"Vladimir N. Oleynik"	bef14d7	2005-09-05 13:25:11 +0000	[diff] [blame]	162
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	163	config CONFIG_HUSH
				164	bool "hush"
				165	default n
Bernhard Reutner-Fischer	96002bb	2006-01-19 14:42:23 +0000	[diff] [blame]	166	select CONFIG_TRUE
				167	select CONFIG_FALSE
				168	select CONFIG_TEST
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	169	help
Eric Andersen	88c916b	2003-10-22 09:58:56 +0000	[diff] [blame]	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,
				173	etc.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	174
Eric Andersen	b287e2e	2003-08-08 23:40:12 +0000	[diff] [blame]	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.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	178
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	179
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	180	config CONFIG_LASH
				181	bool "lash"
				182	default n
Bernhard Reutner-Fischer	96002bb	2006-01-19 14:42:23 +0000	[diff] [blame]	183	select CONFIG_TRUE
				184	select CONFIG_FALSE
				185	select CONFIG_TEST
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	186	help
Eric Andersen	b287e2e	2003-08-08 23:40:12 +0000	[diff] [blame]	187	lash is the very smallest shell (adds just 10k) and it is quite
				188	usable as a command prompt, but it is not suitable for any but the
				189	most trivial scripting (such as an initrd that calls insmod a few
Eric Andersen	88c916b	2003-10-22 09:58:56 +0000	[diff] [blame]	190	times) since it does not understand any Bourne shell grammar. It
Eric Andersen	b287e2e	2003-08-08 23:40:12 +0000	[diff] [blame]	191	does handle pipes, redirects, and job control though. Adding in
				192	command editing makes it a very nice lightweight command prompt.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	193
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	194
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	195	config CONFIG_MSH
				196	bool "msh"
				197	default n
Bernhard Reutner-Fischer	96002bb	2006-01-19 14:42:23 +0000	[diff] [blame]	198	select CONFIG_TRUE
				199	select CONFIG_FALSE
				200	select CONFIG_TEST
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	201	help
Eric Andersen	b287e2e	2003-08-08 23:40:12 +0000	[diff] [blame]	202	The minix shell (adds just 30k) is quite complete and handles things
				203	like for/do/done, case/esac and all the things you expect a Bourne
				204	shell to do. It is not always pedantically correct about Bourne
Eric Andersen	88c916b	2003-10-22 09:58:56 +0000	[diff] [blame]	205	shell grammar (try running the shell testscript "tests/sh.testcases"
Eric Andersen	b287e2e	2003-08-08 23:40:12 +0000	[diff] [blame]	206	on it and compare vs bash) but for most things it works quite well.
				207	It also uses only vfork, so it can be used on uClinux systems.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	208
				209	comment "Bourne Shell Options"
				210	depends on CONFIG_MSH \|\| CONFIG_LASH \|\| CONFIG_HUSH \|\| CONFIG_ASH
				211
Glenn L McGrath	3b25185	2004-01-03 12:07:32 +0000	[diff] [blame]	212	config CONFIG_FEATURE_SH_EXTRA_QUIET
				213	bool "Hide message on interactive shell startup"
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	214	default n
				215	depends on CONFIG_MSH \|\| CONFIG_LASH \|\| CONFIG_HUSH \|\| CONFIG_ASH
				216	help
Glenn L McGrath	3b25185	2004-01-03 12:07:32 +0000	[diff] [blame]	217	Remove the busybox introduction when starting a shell.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	218
				219	config CONFIG_FEATURE_SH_STANDALONE_SHELL
				220	bool "Standalone shell"
				221	default n
				222	depends on CONFIG_MSH \|\| CONFIG_LASH \|\| CONFIG_HUSH \|\| CONFIG_ASH
				223	help
Eric Andersen	075dd81	2004-04-07 09:34:27 +0000	[diff] [blame]	224	This option causes the selected busybox shell to use busybox applets
				225	in preference to executables in the PATH whenever possible. For
				226	example, entering the command 'ifconfig' into the shell would cause
				227	busybox to use the ifconfig busybox applet. Specifying the fully
				228	qualified executable name, such as '/sbin/ifconfig' will still
				229	execute the /sbin/ifconfig executable on the filesystem. This option
Rob Landley	06ec8cf	2006-03-03 19:02:50 +0000	[diff] [blame]	230	is generally used when creating a statically linked version of busybox
Eric Andersen	075dd81	2004-04-07 09:34:27 +0000	[diff] [blame]	231	for use as a rescue shell, in the event that you screw up your system.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	232
Paul Fox	6ab0378	2006-06-08 21:37:26 +0000	[diff] [blame^]	233	Note that this will also cause applets to take precedence
				234	over shell builtins of the same name. So turning this on will
				235	eliminate any performance gained by turning on the builtin "echo"
				236	and "test" commands in ash.
				237
Eric Andersen	6f8542b	2004-09-24 01:25:39 +0000	[diff] [blame]	238	Note that when using this option, the shell will attempt to directly
				239	run '/bin/busybox'. If you do not have the busybox binary sitting in
				240	that exact location with that exact name, this option will not work at
				241	all.
				242
Glenn L McGrath	3b25185	2004-01-03 12:07:32 +0000	[diff] [blame]	243	config CONFIG_FEATURE_COMMAND_EDITING
				244	bool "command line editing"
				245	default n
				246	depends on CONFIG_MSH \|\| CONFIG_LASH \|\| CONFIG_HUSH \|\| CONFIG_ASH
				247	help
				248	Enable command editing in shell.
				249
Paul Fox	3f11b1b	2005-08-04 19:04:46 +0000	[diff] [blame]	250	config CONFIG_FEATURE_COMMAND_EDITING_VI
				251	bool "vi-style line editing commands"
				252	default n
				253	depends on CONFIG_FEATURE_COMMAND_EDITING
				254	help
				255	Enable vi-style line editing in the shell. This mode can be
				256	turned on and off with "set -o vi" and "set +o vi".
				257
Glenn L McGrath	3b25185	2004-01-03 12:07:32 +0000	[diff] [blame]	258	config CONFIG_FEATURE_COMMAND_HISTORY
				259	int "history size"
				260	default 15
				261	depends on CONFIG_FEATURE_COMMAND_EDITING
				262	help
				263	Specify command history size in shell.
				264
				265	config CONFIG_FEATURE_COMMAND_SAVEHISTORY
				266	bool "history saving"
				267	default n
				268	depends on CONFIG_ASH && CONFIG_FEATURE_COMMAND_EDITING
				269	help
				270	Enable history saving in ash shell.
				271
				272	config CONFIG_FEATURE_COMMAND_TAB_COMPLETION
				273	bool "tab completion"
				274	default n
				275	depends on CONFIG_FEATURE_COMMAND_EDITING
				276	help
				277	Enable tab completion in shell.
				278
				279	config CONFIG_FEATURE_COMMAND_USERNAME_COMPLETION
				280	bool "username completion"
				281	default n
				282	depends on CONFIG_FEATURE_COMMAND_TAB_COMPLETION
				283	help
				284	Enable username completion in shell.
				285
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	286	config CONFIG_FEATURE_SH_FANCY_PROMPT
				287	bool "Fancy shell prompts"
				288	default n
Glenn L McGrath	3b25185	2004-01-03 12:07:32 +0000	[diff] [blame]	289	depends on CONFIG_FEATURE_COMMAND_EDITING
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	290	help
Eric Andersen	9c3c38d	2003-07-22 09:59:34 +0000	[diff] [blame]	291	Setting this option allows for prompts to use things like \w and
				292	\$ and also using escape codes.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	293
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	294	endmenu