Blame - shell/Config.in - codeaurora/busybox

blob: 5ee5ebb892a347eb12a7d790f26283e9ded058df [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
				51	bool " Enable Job control"
				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
Mike Frysinger	9ac178a	2005-09-24 05:49:36 +0000	[diff] [blame]	58	bool " Enable 'read -n N' and 'read -s' support"
				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
Mike Frysinger	9ac178a	2005-09-24 05:49:36 +0000	[diff] [blame]	66	bool " Enable 'read -t S' support."
				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
				75	bool " Enable alias support"
				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
				82	bool " Enable Posix math support"
				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
				89	bool " Extend Posix math support to 64 bit"
				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
Glenn L McGrath	53090cd	2004-09-24 09:09:44 +0000	[diff] [blame]	98	bool " Enable getopts builtin 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
				104	config CONFIG_ASH_CMDCMD
				105	bool " Enable cmdcmd to override shell builtins"
				106	default n
				107	depends on CONFIG_ASH
				108	help
Eric Andersen	3857a18	2003-07-22 10:14:32 +0000	[diff] [blame]	109	Enable support for the ash 'command' builtin, which allows
				110	you to run the specified command with the specified arguments,
				111	even when there is an ash builtin command with the same name.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	112
Paul Fox	0b62158	2005-08-09 19:38:05 +0000	[diff] [blame]	113	config CONFIG_ASH_BUILTIN_ECHO
				114	bool " Enable builtin version of 'echo'"
				115	default n
				116	depends on CONFIG_ASH
				117	help
				118	Enable support for echo, built in to ash.
				119
				120	# this entry also appears in coreutils/Config.in, next to the echo applet
				121	config CONFIG_FEATURE_FANCY_ECHO
				122	bool " Enable echo options (-n and -e)"
				123	default y
				124	depends on CONFIG_ASH_BUILTIN_ECHO
				125	help
				126	This adds options (-n and -e) to echo.
				127
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	128	config CONFIG_ASH_MAIL
				129	bool " Check for new mail on interactive shells"
				130	default y
				131	depends on CONFIG_ASH
				132	help
Eric Andersen	e564211	2003-07-14 19:37:08 +0000	[diff] [blame]	133	Enable "check for new mail" in the ash shell.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	134
				135	config CONFIG_ASH_OPTIMIZE_FOR_SIZE
				136	bool " Optimize for size instead of speed"
				137	default y
				138	depends on CONFIG_ASH
				139	help
Rob Landley	32251b4	2006-02-08 18:34:21 +0000	[diff] [blame^]	140	Compile ash for reduced size at the price of speed.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	141
Eric Andersen	16767e2	2004-03-16 05:14:10 +0000	[diff] [blame]	142	config CONFIG_ASH_RANDOM_SUPPORT
				143	bool " Enable pseudorandom generator and variable $RANDOM"
				144	default n
				145	depends on CONFIG_ASH
				146	help
				147	Enable pseudorandom generator and dynamic variable "$RANDOM".
				148	Each read of "$RANDOM" will generate a new pseudorandom value.
				149	You can reset the generator by using a specified start value.
				150	After "unset RANDOM" then generator will switch off and this
				151	variable will no longer have special treatment.
				152
"Vladimir N. Oleynik"	bef14d7	2005-09-05 13:25:11 +0000	[diff] [blame]	153	config CONFIG_ASH_EXPAND_PRMT
Rob Landley	32251b4	2006-02-08 18:34:21 +0000	[diff] [blame^]	154	bool " Expand prompt string"
"Vladimir N. Oleynik"	bef14d7	2005-09-05 13:25:11 +0000	[diff] [blame]	155	default n
				156	depends on CONFIG_ASH
				157	help
Rob Landley	32251b4	2006-02-08 18:34:21 +0000	[diff] [blame^]	158	"PS#" may be contain volatile content, such as backquote commands.
				159	This option recreates the prompt string from the environment
				160	variable each time it is displayed.
"Vladimir N. Oleynik"	bef14d7	2005-09-05 13:25:11 +0000	[diff] [blame]	161
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	162	config CONFIG_HUSH
				163	bool "hush"
				164	default n
Bernhard Reutner-Fischer	96002bb	2006-01-19 14:42:23 +0000	[diff] [blame]	165	select CONFIG_TRUE
				166	select CONFIG_FALSE
				167	select CONFIG_TEST
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	168	help
Eric Andersen	88c916b	2003-10-22 09:58:56 +0000	[diff] [blame]	169	hush is a very small shell (just 18k) and it has fairly complete
				170	Bourne shell grammar. It even handles all the normal flow control
				171	options such as if/then/elif/else/fi, for/in/do/done, while loops,
				172	etc.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	173
Eric Andersen	b287e2e	2003-08-08 23:40:12 +0000	[diff] [blame]	174	It does not handle case/esac, select, function, here documents ( <<
				175	word ), arithmetic expansion, aliases, brace expansion, tilde
				176	expansion, &> and >& redirection of stdout+stderr, etc.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	177
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	config CONFIG_LASH
				180	bool "lash"
				181	default n
Bernhard Reutner-Fischer	96002bb	2006-01-19 14:42:23 +0000	[diff] [blame]	182	select CONFIG_TRUE
				183	select CONFIG_FALSE
				184	select CONFIG_TEST
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	185	help
Eric Andersen	b287e2e	2003-08-08 23:40:12 +0000	[diff] [blame]	186	lash is the very smallest shell (adds just 10k) and it is quite
				187	usable as a command prompt, but it is not suitable for any but the
				188	most trivial scripting (such as an initrd that calls insmod a few
Eric Andersen	88c916b	2003-10-22 09:58:56 +0000	[diff] [blame]	189	times) since it does not understand any Bourne shell grammar. It
Eric Andersen	b287e2e	2003-08-08 23:40:12 +0000	[diff] [blame]	190	does handle pipes, redirects, and job control though. Adding in
				191	command editing makes it a very nice lightweight command prompt.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	192
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	config CONFIG_MSH
				195	bool "msh"
				196	default n
Bernhard Reutner-Fischer	96002bb	2006-01-19 14:42:23 +0000	[diff] [blame]	197	select CONFIG_TRUE
				198	select CONFIG_FALSE
				199	select CONFIG_TEST
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	200	help
Eric Andersen	b287e2e	2003-08-08 23:40:12 +0000	[diff] [blame]	201	The minix shell (adds just 30k) is quite complete and handles things
				202	like for/do/done, case/esac and all the things you expect a Bourne
				203	shell to do. It is not always pedantically correct about Bourne
Eric Andersen	88c916b	2003-10-22 09:58:56 +0000	[diff] [blame]	204	shell grammar (try running the shell testscript "tests/sh.testcases"
Eric Andersen	b287e2e	2003-08-08 23:40:12 +0000	[diff] [blame]	205	on it and compare vs bash) but for most things it works quite well.
				206	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]	207
				208	comment "Bourne Shell Options"
				209	depends on CONFIG_MSH \|\| CONFIG_LASH \|\| CONFIG_HUSH \|\| CONFIG_ASH
				210
Glenn L McGrath	3b25185	2004-01-03 12:07:32 +0000	[diff] [blame]	211	config CONFIG_FEATURE_SH_EXTRA_QUIET
				212	bool "Hide message on interactive shell startup"
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	213	default n
				214	depends on CONFIG_MSH \|\| CONFIG_LASH \|\| CONFIG_HUSH \|\| CONFIG_ASH
				215	help
Glenn L McGrath	3b25185	2004-01-03 12:07:32 +0000	[diff] [blame]	216	Remove the busybox introduction when starting a shell.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	217
				218	config CONFIG_FEATURE_SH_STANDALONE_SHELL
				219	bool "Standalone shell"
				220	default n
				221	depends on CONFIG_MSH \|\| CONFIG_LASH \|\| CONFIG_HUSH \|\| CONFIG_ASH
				222	help
Eric Andersen	075dd81	2004-04-07 09:34:27 +0000	[diff] [blame]	223	This option causes the selected busybox shell to use busybox applets
				224	in preference to executables in the PATH whenever possible. For
				225	example, entering the command 'ifconfig' into the shell would cause
				226	busybox to use the ifconfig busybox applet. Specifying the fully
				227	qualified executable name, such as '/sbin/ifconfig' will still
				228	execute the /sbin/ifconfig executable on the filesystem. This option
				229	is generally used when creating a staticly linked version of busybox
				230	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]	231
Eric Andersen	6f8542b	2004-09-24 01:25:39 +0000	[diff] [blame]	232	Note that when using this option, the shell will attempt to directly
				233	run '/bin/busybox'. If you do not have the busybox binary sitting in
				234	that exact location with that exact name, this option will not work at
				235	all.
				236
Glenn L McGrath	3b25185	2004-01-03 12:07:32 +0000	[diff] [blame]	237	config CONFIG_FEATURE_COMMAND_EDITING
				238	bool "command line editing"
				239	default n
				240	depends on CONFIG_MSH \|\| CONFIG_LASH \|\| CONFIG_HUSH \|\| CONFIG_ASH
				241	help
				242	Enable command editing in shell.
				243
Paul Fox	3f11b1b	2005-08-04 19:04:46 +0000	[diff] [blame]	244	config CONFIG_FEATURE_COMMAND_EDITING_VI
				245	bool "vi-style line editing commands"
				246	default n
				247	depends on CONFIG_FEATURE_COMMAND_EDITING
				248	help
				249	Enable vi-style line editing in the shell. This mode can be
				250	turned on and off with "set -o vi" and "set +o vi".
				251
Glenn L McGrath	3b25185	2004-01-03 12:07:32 +0000	[diff] [blame]	252	config CONFIG_FEATURE_COMMAND_HISTORY
				253	int "history size"
				254	default 15
				255	depends on CONFIG_FEATURE_COMMAND_EDITING
				256	help
				257	Specify command history size in shell.
				258
				259	config CONFIG_FEATURE_COMMAND_SAVEHISTORY
				260	bool "history saving"
				261	default n
				262	depends on CONFIG_ASH && CONFIG_FEATURE_COMMAND_EDITING
				263	help
				264	Enable history saving in ash shell.
				265
				266	config CONFIG_FEATURE_COMMAND_TAB_COMPLETION
				267	bool "tab completion"
				268	default n
				269	depends on CONFIG_FEATURE_COMMAND_EDITING
				270	help
				271	Enable tab completion in shell.
				272
				273	config CONFIG_FEATURE_COMMAND_USERNAME_COMPLETION
				274	bool "username completion"
				275	default n
				276	depends on CONFIG_FEATURE_COMMAND_TAB_COMPLETION
				277	help
				278	Enable username completion in shell.
				279
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	280	config CONFIG_FEATURE_SH_FANCY_PROMPT
				281	bool "Fancy shell prompts"
				282	default n
Glenn L McGrath	3b25185	2004-01-03 12:07:32 +0000	[diff] [blame]	283	depends on CONFIG_FEATURE_COMMAND_EDITING
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	284	help
Eric Andersen	9c3c38d	2003-07-22 09:59:34 +0000	[diff] [blame]	285	Setting this option allows for prompts to use things like \w and
				286	\$ and also using escape codes.
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	287
Eric Andersen	c9f20d9	2002-12-05 08:41:41 +0000	[diff] [blame]	288	endmenu