blob: 8baf565db7bcd71e1de05a45dc20c279d9f66e20 [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
6mainmenu "BusyBox Configuration"
7
Eric Andersen068b6b02002-12-13 22:53:28 +00008config HAVE_DOT_CONFIG
9 bool
10 default y
11
Rob Landley9dc69132006-03-13 02:52:23 +000012menu "Busybox Settings"
Mike Frysinger72d59db2006-03-10 23:17:17 +000013
Eric Andersen23b51462002-12-05 21:25:20 +000014menu "General Configuration"
15
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000016config DESKTOP
Bernhard Reutner-Fischer68532b32006-11-17 12:47:50 +000017 bool "Enable options for full-blown desktop systems"
Denis Vlasenko97a8dd32006-10-01 15:55:11 +000018 default n
19 help
20 Enable options and features which are not essential.
21 Select this only if you plan to use busybox on full-blown
Bernhard Reutner-Fischer68532b32006-11-17 12:47:50 +000022 desktop machine with common Linux distro, not on an embedded box.
Denis Vlasenko97a8dd32006-10-01 15:55:11 +000023
Denis Vlasenko3fd15e12008-08-09 16:15:14 +000024config EXTRA_COMPAT
25 bool "Provide compatible behavior for rare corner cases (bigger code)"
26 default n
27 help
28 This option makes grep, sed etc handle rare corner cases
29 (embedded NUL bytes and such). This makes code bigger and uses
30 some GNU extensions in libc. You probably only need this option
31 if you plan to run busybox on desktop.
32
Denys Vlasenkoa8df4c02009-10-19 18:56:26 +020033config INCLUDE_SUSv2
34 bool "Enable obsolete features removed before SUSv3"
35 default y
36 help
37 This option will enable backwards compatibility with SuSv2,
38 specifically, old-style numeric options ('command -1 <file>')
39 will be supported in head, tail, and fold. (Note: should
40 affect renice too.)
41
Denys Vlasenkoaa7da732009-09-13 14:57:24 +020042config USE_PORTABLE_CODE
43 bool "Avoid using GCC-specific code constructs"
44 default n
45 help
46 Use this option if you are trying to compile busybox with
47 compiler other than gcc.
48 If you do use gcc, this option may needlessly increase code size.
49
Eric Andersenc9f20d92002-12-05 08:41:41 +000050choice
51 prompt "Buffer allocation policy"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000052 default FEATURE_BUFFERS_USE_MALLOC
Eric Andersenc9f20d92002-12-05 08:41:41 +000053 help
Eric Andersen53601822002-12-05 21:12:42 +000054 There are 3 ways BusyBox can handle buffer allocations:
55 - Use malloc. This costs code size for the call to xmalloc.
56 - Put them on stack. For some very small machines with limited stack
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000057 space, this can be deadly. For most folks, this works just fine.
Eric Andersen53601822002-12-05 21:12:42 +000058 - Put them in BSS. This works beautifully for computers with a real
59 MMU (and OS support), but wastes runtime RAM for uCLinux. This
60 behavior was the only one available for BusyBox versions 0.48 and
61 earlier.
Eric Andersenc9f20d92002-12-05 08:41:41 +000062
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000063config FEATURE_BUFFERS_USE_MALLOC
Eric Andersenc9f20d92002-12-05 08:41:41 +000064 bool "Allocate with Malloc"
65
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000066config FEATURE_BUFFERS_GO_ON_STACK
Eric Andersenc9f20d92002-12-05 08:41:41 +000067 bool "Allocate on the Stack"
68
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000069config FEATURE_BUFFERS_GO_IN_BSS
Eric Andersenc9f20d92002-12-05 08:41:41 +000070 bool "Allocate in the .bss section"
71
72endchoice
73
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000074config SHOW_USAGE
Bernhard Reutner-Fischer81901a02006-03-31 18:43:55 +000075 bool "Show terse applet usage messages"
76 default y
77 help
78 All BusyBox applets will show help messages when invoked with
79 wrong arguments. You can turn off printing these terse usage
80 messages if you say no here.
81 This will save you up to 7k.
82
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000083config FEATURE_VERBOSE_USAGE
Eric Andersenc9f20d92002-12-05 08:41:41 +000084 bool "Show verbose applet usage messages"
85 default n
Denys Vlasenko0e5ba082010-06-05 23:11:07 +020086 depends on SHOW_USAGE
Eric Andersenc9f20d92002-12-05 08:41:41 +000087 help
Eric Andersen53601822002-12-05 21:12:42 +000088 All BusyBox applets will show more verbose help messages when
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000089 busybox is invoked with --help. This will add a lot of text to the
90 busybox binary. In the default configuration, this will add about
Eric Andersen53601822002-12-05 21:12:42 +000091 13k, but it can add much more depending on your configuration.
Eric Andersenc9f20d92002-12-05 08:41:41 +000092
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000093config FEATURE_COMPRESS_USAGE
Rob Landley7e21d5f2006-04-27 23:34:46 +000094 bool "Store applet usage messages in compressed form"
95 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000096 depends on SHOW_USAGE
Rob Landley7e21d5f2006-04-27 23:34:46 +000097 help
98 Store usage messages in compressed form, uncompress them on-the-fly
99 when <applet> --help is called.
100
Rob Landleyc7ddefc2006-06-14 01:24:33 +0000101 If you have a really tiny busybox with few applets enabled (and
102 bunzip2 isn't one of them), the overhead of the decompressor might
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000103 be noticeable. Also, if you run executables directly from ROM
104 and have very little memory, this might not be a win. Otherwise,
Rob Landleyc7ddefc2006-06-14 01:24:33 +0000105 you probably want this.
106
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000107config FEATURE_INSTALLER
Eric Andersenc9f20d92002-12-05 08:41:41 +0000108 bool "Support --install [-s] to install applet links at runtime"
109 default n
110 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000111 Enable 'busybox --install [-s]' support. This will allow you to use
Eric Andersen53601822002-12-05 21:12:42 +0000112 busybox at runtime to create hard links or symlinks for all the
Denis Vlasenkoa7825f22007-06-16 13:56:51 +0000113 applets that are compiled into busybox.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000114
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000115config LOCALE_SUPPORT
Eric Andersenc9f20d92002-12-05 08:41:41 +0000116 bool "Enable locale support (system needs locale for this to work)"
117 default n
118 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000119 Enable this if your system has locale support and you would like
Eric Andersen53601822002-12-05 21:12:42 +0000120 busybox to support locale settings.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000121
Denys Vlasenko19158a82010-03-26 14:06:56 +0100122config UNICODE_SUPPORT
Denys Vlasenko42a8fd02009-07-11 21:36:13 +0200123 bool "Support Unicode"
124 default n
125 help
126 This makes various applets aware that one byte is not
127 one character on screen.
128
129 Busybox aims to eventually work correctly with Unicode displays.
130 Any older encodings are not guaranteed to work.
131 Probably by the time when busybox will be fully Unicode-clean,
132 other encodings will be mainly of historic interest.
133
Denys Vlasenko19158a82010-03-26 14:06:56 +0100134config UNICODE_USING_LOCALE
135 bool "Use libc routines for Unicode (else uses internal ones)"
136 default n
137 depends on UNICODE_SUPPORT && LOCALE_SUPPORT
138 help
139 With this option on, Unicode support is implemented using libc
140 routines. Otherwise, internal implementation is used.
141
Denys Vlasenko42a8fd02009-07-11 21:36:13 +0200142config FEATURE_CHECK_UNICODE_IN_ENV
143 bool "Check $LANG environment variable"
144 default y
Denys Vlasenko19158a82010-03-26 14:06:56 +0100145 depends on UNICODE_SUPPORT && !UNICODE_USING_LOCALE
Denys Vlasenko42a8fd02009-07-11 21:36:13 +0200146 help
147 With this option on, Unicode support is activated
148 only if LANG variable has the value of the form "xxxx.utf8"
149
150 Otherwise, Unicode support will be always enabled and active.
151
Denys Vlasenko2edba212010-01-29 09:11:47 +0100152config SUBST_WCHAR
153 int "Character code to substitute unprintable characters with"
Denys Vlasenko19158a82010-03-26 14:06:56 +0100154 depends on UNICODE_SUPPORT
Denys Vlasenko2edba212010-01-29 09:11:47 +0100155 default 63
156 help
157 Typical values are 63 for '?' (works with any output device),
158 30 for ASCII substitute control code,
159 65533 (0xfffd) for Unicode replacement character.
160
161config LAST_SUPPORTED_WCHAR
162 int "Range of supported Unicode characters"
Denys Vlasenko19158a82010-03-26 14:06:56 +0100163 depends on UNICODE_SUPPORT
Denys Vlasenko2edba212010-01-29 09:11:47 +0100164 default 767
165 help
166 Any character with Unicode value bigger than this is assumed
167 to be non-printable on output device. Many applets replace
168 such chars with substitution character.
169
170 The idea is that many valid printable Unicode chars are
171 nevertheless are not displayed correctly. Think about
Denys Vlasenko460f8272010-01-31 18:12:57 +0100172 combining charachers, double-wide hieroglyphs, obscure
173 characters in dozens of ancient scripts...
174 Many terminals, terminal emulators, xterms etc will fail
175 to handle them correctly. Choose the smallest value
176 which suits your needs.
Denys Vlasenko2edba212010-01-29 09:11:47 +0100177
178 Typical values are:
179 126 - ASCII only
180 767 (0x2ff) - there are no combining chars in [0..767] range
181 (the range includes Latin 1, Latin Ext. A and B),
182 code is ~700 bytes smaller for this case.
183 4351 (0x10ff) - there are no double-wide chars in [0..4351] range,
184 code is ~300 bytes smaller for this case.
Denys Vlasenko460f8272010-01-31 18:12:57 +0100185 12799 (0x31ff) - nearly all non-ideographic characters are
186 available in [0..12799] range, including
187 East Asian scripts like katakana, hiragana, hangul,
188 bopomofo...
Denys Vlasenko2edba212010-01-29 09:11:47 +0100189 0 - off, any valid printable Unicode character will be printed.
190
191config UNICODE_COMBINING_WCHARS
192 bool "Allow zero-width Unicode characters on output"
193 default n
Denys Vlasenko19158a82010-03-26 14:06:56 +0100194 depends on UNICODE_SUPPORT
Denys Vlasenko2edba212010-01-29 09:11:47 +0100195 help
196 With this option off, any Unicode char with width of 0
197 is substituted on output.
198
199config UNICODE_WIDE_WCHARS
200 bool "Allow wide Unicode characters on output"
201 default n
Denys Vlasenko19158a82010-03-26 14:06:56 +0100202 depends on UNICODE_SUPPORT
Denys Vlasenko2edba212010-01-29 09:11:47 +0100203 help
204 With this option off, any Unicode char with width > 1
205 is substituted on output.
206
Tomas Heinrichc5c006c2010-03-18 18:35:37 +0100207config UNICODE_BIDI_SUPPORT
208 bool "Bidirectional character-aware line input"
Tomas Heinrichaa167552010-03-26 13:13:24 +0100209 default n
Denys Vlasenko19158a82010-03-26 14:06:56 +0100210 depends on UNICODE_SUPPORT && !UNICODE_USING_LOCALE
Tomas Heinrichc5c006c2010-03-18 18:35:37 +0100211 help
212 With this option on, right-to-left Unicode characters
213 are treated differently on input (e.g. cursor movement).
214
Tomas Heinrichaa167552010-03-26 13:13:24 +0100215config UNICODE_NEUTRAL_TABLE
216 bool "In bidi input, support non-ASCII neutral chars too"
217 default n
218 depends on UNICODE_BIDI_SUPPORT
219 help
220 In most cases it's enough to treat only ASCII non-letters
221 (i.e. punctuation, numbers and space) as characters
222 with neutral directionality.
223 With this option on, more extensive (and bigger) table
224 of neutral chars will be used.
225
Tomas Heinricha659b812010-04-29 13:43:39 +0200226config UNICODE_PRESERVE_BROKEN
227 bool "Make it possible to enter sequences of chars which are not Unicode"
228 default n
229 depends on UNICODE_SUPPORT
230 help
231 With this option on, invalid UTF-8 bytes are not substituted
232 with the selected substitution character.
233 For example, this means that entering 'l', 's', ' ', 0xff, [Enter]
234 at shell prompt will list file named 0xff (single char name
235 with char value 255), not file named '?'.
236
Denys Vlasenkof3b92d32009-06-19 12:10:38 +0200237config LONG_OPTS
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000238 bool "Support for --long-options"
Bernhard Reutner-Fischer74704192006-06-16 14:03:23 +0000239 default y
Denis Vlasenkoc61852a2006-11-29 11:09:43 +0000240 help
241 Enable this if you want busybox applets to use the gnu --long-option
242 style, in addition to single character -a -b -c style options.
Bernhard Reutner-Fischer01d23ad2006-05-26 20:19:22 +0000243
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000244config FEATURE_DEVPTS
Eric Andersenc9f20d92002-12-05 08:41:41 +0000245 bool "Use the devpts filesystem for Unix98 PTYs"
Rob Landleyc7ddefc2006-06-14 01:24:33 +0000246 default y
Eric Andersenc9f20d92002-12-05 08:41:41 +0000247 help
Eric Andersen53601822002-12-05 21:12:42 +0000248 Enable if you want BusyBox to use Unix98 PTY support. If enabled,
249 busybox will use /dev/ptmx for the master side of the pseudoterminal
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000250 and /dev/pts/<number> for the slave side. Otherwise, BSD style
Eric Andersen53601822002-12-05 21:12:42 +0000251 /dev/ttyp<number> will be used. To use this option, you should have
Rob Landleyd5b9b602006-05-31 23:23:42 +0000252 devpts mounted.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000253
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000254config FEATURE_CLEAN_UP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000255 bool "Clean up all memory before exiting (usually not needed)"
256 default n
257 help
Rob Landley1ab4c3d2006-02-08 18:50:17 +0000258 As a size optimization, busybox normally exits without explicitly
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000259 freeing dynamically allocated memory or closing files. This saves
Rob Landley1ab4c3d2006-02-08 18:50:17 +0000260 space since the OS will clean up for us, but it can confuse debuggers
261 like valgrind, which report tons of memory and resource leaks.
262
263 Don't enable this unless you have a really good reason to clean
Eric Andersene5642112003-07-14 19:37:08 +0000264 things up manually.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000265
Denys Vlasenko6dbbac52010-04-06 18:48:32 +0200266config FEATURE_UTMP
267 bool "Support utmp file"
268 default n
269 help
270 The file /var/run/utmp is used to track who is currently logged in.
271 With this option on, certain applets (getty, login, telnetd etc)
272 will create and delete entries there.
Denys Vlasenko64827a22010-04-06 18:51:29 +0200273 "who" applet requires this option.
Denys Vlasenko6dbbac52010-04-06 18:48:32 +0200274
275config FEATURE_WTMP
276 bool "Support wtmp file"
277 default n
278 select FEATURE_UTMP
279 help
280 The file /var/run/wtmp is used to track when users have logged into
281 and logged out of the system.
282 With this option on, certain applets (getty, login, telnetd etc)
283 will append new entries there.
Denys Vlasenko64827a22010-04-06 18:51:29 +0200284 "last" applet requires this option.
Denys Vlasenko6dbbac52010-04-06 18:48:32 +0200285
Denis Vlasenko10457b92007-03-27 22:01:31 +0000286config FEATURE_PIDFILE
287 bool "Support writing pidfiles"
288 default n
289 help
Denis Vlasenkobb23c062007-08-15 20:05:37 +0000290 This option makes some applets (e.g. crond, syslogd, inetd) write
Denis Vlasenkoa7825f22007-06-16 13:56:51 +0000291 a pidfile in /var/run. Some applications rely on them.
Denis Vlasenko10457b92007-03-27 22:01:31 +0000292
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000293config FEATURE_SUID
Eric Andersenc9f20d92002-12-05 08:41:41 +0000294 bool "Support for SUID/SGID handling"
295 default n
296 help
Rob Landleyd5b9b602006-05-31 23:23:42 +0000297 With this option you can install the busybox binary belonging
Bernhard Reutner-Fischeraa2a1c02008-10-24 19:48:47 +0000298 to root with the suid bit set, and it will automatically drop
Rob Landleyd5b9b602006-05-31 23:23:42 +0000299 priviledges for applets that don't need root access.
300
Bernhard Reutner-Fischeraa2a1c02008-10-24 19:48:47 +0000301 If you are really paranoid and don't want to do this, build two
Rob Landleyd5b9b602006-05-31 23:23:42 +0000302 busybox binaries with different applets in them (and the appropriate
303 symlinks pointing to each binary), and only set the suid bit on the
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000304 one that needs it. The applets currently marked to need the suid bit
Bernhard Reutner-Fischeraa2a1c02008-10-24 19:48:47 +0000305 are:
306
307 crontab, dnsd, findfs, ipcrm, ipcs, login, passwd, ping, su,
308 traceroute, vlock.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000309
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000310config FEATURE_SUID_CONFIG
Eric Andersenc9f20d92002-12-05 08:41:41 +0000311 bool "Runtime SUID/SGID configuration via /etc/busybox.conf"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000312 default n if FEATURE_SUID
313 depends on FEATURE_SUID
Eric Andersenc9f20d92002-12-05 08:41:41 +0000314 help
Rob Landleyd5b9b602006-05-31 23:23:42 +0000315 Allow the SUID / SGID state of an applet to be determined at runtime
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000316 by checking /etc/busybox.conf. (This is sort of a poor man's sudo.)
Rob Landleyd5b9b602006-05-31 23:23:42 +0000317 The format of this file is as follows:
Eric Andersene5272072003-07-22 22:15:21 +0000318
319 <applet> = [Ssx-][Ssx-][x-] (<username>|<uid>).(<groupname>|<gid>)
Eric Andersen5043ea12005-06-23 19:15:40 +0000320
Eric Andersene5272072003-07-22 22:15:21 +0000321 An example might help:
322
323 [SUID]
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000324 su = ssx root.0 # applet su can be run by anyone and runs with
325 # euid=0/egid=0
Eric Andersene5272072003-07-22 22:15:21 +0000326 su = ssx # exactly the same
327
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000328 mount = sx- root.disk # applet mount can be run by root and members
329 # of group disk and runs with euid=0
Eric Andersene5272072003-07-22 22:15:21 +0000330
331 cp = --- # disable applet cp for everyone
332
Rob Landleyfdc4c202005-04-29 19:48:29 +0000333 The file has to be owned by user root, group root and has to be
334 writeable only by root:
Denis Vlasenko6cee58e2007-11-04 15:43:26 +0000335 (chown 0.0 /etc/busybox.conf; chmod 600 /etc/busybox.conf)
Rob Landleyfdc4c202005-04-29 19:48:29 +0000336 The busybox executable has to be owned by user root, group
337 root and has to be setuid root for this to work:
Denis Vlasenko6cee58e2007-11-04 15:43:26 +0000338 (chown 0.0 /bin/busybox; chmod 4755 /bin/busybox)
Rob Landleyfdc4c202005-04-29 19:48:29 +0000339
Eric Andersene5272072003-07-22 22:15:21 +0000340 Robert 'sandman' Griebl has more information here:
341 <url: http://www.softforge.de/bb/suid.html >.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000342
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000343config FEATURE_SUID_CONFIG_QUIET
Eric Andersenc9f20d92002-12-05 08:41:41 +0000344 bool "Suppress warning message if /etc/busybox.conf is not readable"
Rob Landleyd5b9b602006-05-31 23:23:42 +0000345 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000346 depends on FEATURE_SUID_CONFIG
Eric Andersenc9f20d92002-12-05 08:41:41 +0000347 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000348 /etc/busybox.conf should be readable by the user needing the SUID,
349 check this option to avoid users to be notified about missing
350 permissions.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000351
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000352config SELINUX
Eric Andersen9e480452003-07-03 10:07:04 +0000353 bool "Support NSA Security Enhanced Linux"
354 default n
355 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000356 Enable support for SELinux in applets ls, ps, and id. Also provide
Rob Landley24b0a952006-03-29 15:35:23 +0000357 the option of compiling in SELinux applets.
Eric Andersen9e480452003-07-03 10:07:04 +0000358
Rob Landley24b0a952006-03-29 15:35:23 +0000359 If you do not have a complete SELinux userland installed, this stuff
360 will not compile. Go visit
Eric Andersen31d898f2004-02-05 00:18:26 +0000361 http://www.nsa.gov/selinux/index.html
Rob Landley24b0a952006-03-29 15:35:23 +0000362 to download the necessary stuff to allow busybox to compile with
363 this option enabled. Specifially, libselinux 1.28 or better is
364 directly required by busybox. If the installation is located in a
365 non-standard directory, provide it by invoking make as follows:
366 CFLAGS=-I<libselinux-include-path> \
367 LDFLAGS=-L<libselinux-lib-path> \
368 make
Eric Andersen31d898f2004-02-05 00:18:26 +0000369
370 Most people will leave this set to 'N'.
371
Denis Vlasenko80d14be2007-04-10 23:03:30 +0000372config FEATURE_PREFER_APPLETS
Denis Vlasenko2f0c0d02007-01-21 00:41:04 +0000373 bool "exec prefers applets"
374 default n
375 help
376 This is an experimental option which directs applets about to
377 call 'exec' to try and find an applicable busybox applet before
Denis Vlasenko92c0b822007-05-08 17:27:17 +0000378 searching the PATH. This is typically done by exec'ing
379 /proc/self/exe.
380 This may affect shell, find -exec, xargs and similar applets.
381 They will use applets even if /bin/<applet> -> busybox link
382 is missing (or is not a link to busybox). However, this causes
383 problems in chroot jails without mounted /proc and with ps/top
384 (command name can be shown as 'exe' for applets started this way).
Denis Vlasenko2f0c0d02007-01-21 00:41:04 +0000385
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000386config BUSYBOX_EXEC_PATH
Rob Landleyc7ddefc2006-06-14 01:24:33 +0000387 string "Path to BusyBox executable"
388 default "/proc/self/exe"
389 help
390 When Busybox applets need to run other busybox applets, BusyBox
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000391 sometimes needs to exec() itself. When the /proc filesystem is
Rob Landleyc7ddefc2006-06-14 01:24:33 +0000392 mounted, /proc/self/exe always points to the currently running
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000393 executable. If you haven't got /proc, set this to wherever you
Rob Landleyc7ddefc2006-06-14 01:24:33 +0000394 want to run BusyBox from.
395
Denis Vlasenkoa7825f22007-06-16 13:56:51 +0000396# These are auto-selected by other options
397
398config FEATURE_SYSLOG
Denis Vlasenko35a064b2008-11-06 00:49:59 +0000399 bool #No description makes it a hidden option
Denis Vlasenkoa7825f22007-06-16 13:56:51 +0000400 default n
Denis Vlasenko35a064b2008-11-06 00:49:59 +0000401 #help
402 # This option is auto-selected when you select any applet which may
403 # send its output to syslog. You do not need to select it manually.
Denis Vlasenkoa7825f22007-06-16 13:56:51 +0000404
405config FEATURE_HAVE_RPC
Denis Vlasenko35a064b2008-11-06 00:49:59 +0000406 bool #No description makes it a hidden option
Denis Vlasenkoa7825f22007-06-16 13:56:51 +0000407 default n
Denis Vlasenko35a064b2008-11-06 00:49:59 +0000408 #help
409 # This is automatically selected if any of enabled applets need it.
410 # You do not need to select it manually.
Denis Vlasenkoa7825f22007-06-16 13:56:51 +0000411
Eric Andersenc9f20d92002-12-05 08:41:41 +0000412endmenu
413
414menu 'Build Options'
415
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000416config STATIC
Eric Andersenc9f20d92002-12-05 08:41:41 +0000417 bool "Build BusyBox as a static binary (no shared libs)"
418 default n
419 help
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000420 If you want to build a static BusyBox binary, which does not
421 use or require any shared libraries, then enable this option.
Eric Andersen88c916b2003-10-22 09:58:56 +0000422 This can cause BusyBox to be considerably larger, so you should
Eric Andersene5272072003-07-22 22:15:21 +0000423 leave this option false unless you have a good reason (i.e.
424 your target platform does not support shared libraries, or
425 you are building an initrd which doesn't need anything but
426 BusyBox, etc).
Eric Andersenc9f20d92002-12-05 08:41:41 +0000427
Eric Andersene5272072003-07-22 22:15:21 +0000428 Most people will leave this set to 'N'.
429
Denis Vlasenko1da86d22008-06-04 11:28:24 +0000430config PIE
431 bool "Build BusyBox as a position independent executable"
432 default n
433 depends on !STATIC
434 help
435 (TODO: what is it and why/when is it useful?)
436 Most people will leave this set to 'N'.
437
Denis Vlasenkod2c450c2008-01-08 20:32:12 +0000438config NOMMU
439 bool "Force NOMMU build"
440 default n
441 help
442 Busybox tries to detect whether architecture it is being
443 built against supports MMU or not. If this detection fails,
444 or if you want to build NOMMU version of busybox for testing,
445 you may force NOMMU build here.
446
447 Most people will leave this set to 'N'.
448
Denis Vlasenkocc3f20b2008-06-23 22:31:52 +0000449# PIE can be made to work with BUILD_LIBBUSYBOX, but currently
450# build system does not support that
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000451config BUILD_LIBBUSYBOX
Bernhard Reutner-Fischer2aba3952006-01-24 16:14:14 +0000452 bool "Build shared libbusybox"
Rob Landleyc7ddefc2006-06-14 01:24:33 +0000453 default n
Denis Vlasenkofc5e8062008-07-09 21:24:18 +0000454 depends on !FEATURE_PREFER_APPLETS && !PIE && !STATIC
Bernhard Reutner-Fischer2aba3952006-01-24 16:14:14 +0000455 help
Denis Vlasenkod62fd842007-10-07 20:46:34 +0000456 Build a shared library libbusybox.so.N.N.N which contains all
457 busybox code.
Bernhard Reutner-Fischer2aba3952006-01-24 16:14:14 +0000458
Denis Vlasenkod62fd842007-10-07 20:46:34 +0000459 This feature allows every applet to be built as a tiny
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000460 separate executable. Enabling it for "one big busybox binary"
Denis Vlasenkod62fd842007-10-07 20:46:34 +0000461 approach serves no purpose and increases code size.
462 You should almost certainly say "no" to this.
Rob Landleyd6e50832006-06-15 15:04:53 +0000463
Denis Vlasenkodef88982007-10-07 17:06:01 +0000464### config FEATURE_FULL_LIBBUSYBOX
465### bool "Feature-complete libbusybox"
466### default n if !FEATURE_SHARED_BUSYBOX
467### depends on BUILD_LIBBUSYBOX
468### help
469### Build a libbusybox with the complete feature-set, disregarding
470### the actually selected config.
471###
472### Normally, libbusybox will only contain the features which are
473### used by busybox itself. If you plan to write a separate
474### standalone application which uses libbusybox say 'Y'.
475###
476### Note: libbusybox is GPL, not LGPL, and exports no stable API that
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000477### might act as a copyright barrier. We can and will modify the
Denis Vlasenkodef88982007-10-07 17:06:01 +0000478### exported function set between releases (even minor version number
479### changes), and happily break out-of-tree features.
480###
481### Say 'N' if in doubt.
Bernhard Reutner-Fischer2aba3952006-01-24 16:14:14 +0000482
Denis Vlasenkof545be02007-10-07 17:06:26 +0000483config FEATURE_INDIVIDUAL
484 bool "Produce a binary for each applet, linked against libbusybox"
485 default y
Denis Vlasenkofc5e8062008-07-09 21:24:18 +0000486 depends on BUILD_LIBBUSYBOX
Bernhard Reutner-Fischer2aba3952006-01-24 16:14:14 +0000487 help
Denis Vlasenkof545be02007-10-07 17:06:26 +0000488 If your CPU architecture doesn't allow for sharing text/rodata
489 sections of running binaries, but allows for runtime dynamic
490 libraries, this option will allow you to reduce memory footprint
491 when you have many different applets running at once.
Bernhard Reutner-Fischer2aba3952006-01-24 16:14:14 +0000492
Denis Vlasenkof545be02007-10-07 17:06:26 +0000493 If your CPU architecture allows for sharing text/rodata,
494 having single binary is more optimal.
495
496 Each applet will be a tiny program, dynamically linked
497 against libbusybox.so.N.N.N.
498
499 You need to have a working dynamic linker.
500
501config FEATURE_SHARED_BUSYBOX
502 bool "Produce additional busybox binary linked against libbusybox"
503 default y
Denis Vlasenkofc5e8062008-07-09 21:24:18 +0000504 depends on BUILD_LIBBUSYBOX
Eric Andersenc9f20d92002-12-05 08:41:41 +0000505 help
Denis Vlasenkof545be02007-10-07 17:06:26 +0000506 Build busybox, dynamically linked against libbusybox.so.N.N.N.
507
508 You need to have a working dynamic linker.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000509
Denis Vlasenkodef88982007-10-07 17:06:01 +0000510### config BUILD_AT_ONCE
511### bool "Compile all sources at once"
512### default n
513### help
514### Normally each source-file is compiled with one invocation of
515### the compiler.
516### If you set this option, all sources are compiled at once.
517### This gives the compiler more opportunities to optimize which can
518### result in smaller and/or faster binaries.
519###
520### Setting this option will consume alot of memory, e.g. if you
521### enable all applets with all features, gcc uses more than 300MB
522### RAM during compilation of busybox.
523###
524### This option is most likely only beneficial for newer compilers
525### such as gcc-4.1 and above.
526###
527### Say 'N' unless you know what you are doing.
Bernhard Reutner-Fischer2aba3952006-01-24 16:14:14 +0000528
Denis Vlasenkof545be02007-10-07 17:06:26 +0000529config LFS
530 bool "Build with Large File Support (for accessing files > 2 GB)"
531 default n
532 select FDISK_SUPPORT_LARGE_DISKS
533 help
534 If you want to build BusyBox with large file support, then enable
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000535 this option. This will have no effect if your kernel or your C
536 library lacks large file support for large files. Some of the
Denis Vlasenkof545be02007-10-07 17:06:26 +0000537 programs that can benefit from large file support include dd, gzip,
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000538 cp, mount, tar, and many others. If you want to access files larger
539 than 2 Gigabytes, enable this option. Otherwise, leave it set to 'N'.
Denis Vlasenkof545be02007-10-07 17:06:26 +0000540
Denis Vlasenkob8e653b2008-06-02 04:51:29 +0000541config CROSS_COMPILER_PREFIX
542 string "Cross Compiler prefix"
543 default ""
544 help
545 If you want to build BusyBox with a cross compiler, then you
546 will need to set this to the cross-compiler prefix, for example,
Bernhard Reutner-Fischer7d0d3e22008-08-22 08:25:26 +0000547 "i386-uclibc-".
548
549 Note that CROSS_COMPILE environment variable or
550 "make CROSS_COMPILE=xxx ..." will override this selection.
551
552 Native builds leave this empty.
Denis Vlasenkob8e653b2008-06-02 04:51:29 +0000553
Bernhard Reutner-Fischerf6107c72009-01-22 13:27:14 +0000554config EXTRA_CFLAGS
555 string "Additional CFLAGS"
556 default ""
557 help
558 Additional CFLAGS to pass to the compiler verbatim.
559
Eric Andersenc9f20d92002-12-05 08:41:41 +0000560endmenu
561
Eric Andersenc9f20d92002-12-05 08:41:41 +0000562menu 'Debugging Options'
563
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000564config DEBUG
Rob Landleyc503df52006-05-09 22:08:56 +0000565 bool "Build BusyBox with extra Debugging symbols"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000566 default n
567 help
Rob Landleyc503df52006-05-09 22:08:56 +0000568 Say Y here if you wish to examine BusyBox internals while applets are
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000569 running. This increases the size of the binary considerably, and
570 should only be used when doing development. If you are doing
Rob Landleyc503df52006-05-09 22:08:56 +0000571 development and want to debug BusyBox, answer Y.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000572
Eric Andersenf086ed82004-05-25 11:30:22 +0000573 Most people should answer N.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000574
Denis Vlasenkobd8390a2008-06-12 20:23:03 +0000575config DEBUG_PESSIMIZE
Denis Vlasenkoc185e292008-07-16 23:45:11 +0000576 bool "Disable compiler optimizations"
Denis Vlasenkobd8390a2008-06-12 20:23:03 +0000577 default n
578 depends on DEBUG
579 help
580 The compiler's optimization of source code can eliminate and reorder
581 code, resulting in an executable that's hard to understand when
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000582 stepping through it with a debugger. This switches it off, resulting
Denis Vlasenkobd8390a2008-06-12 20:23:03 +0000583 in a much bigger executable that more closely matches the source
584 code.
585
Denis Vlasenkoe0eebc12007-01-27 13:44:53 +0000586config WERROR
587 bool "Abort compilation on any warning"
Rob Landleyc503df52006-05-09 22:08:56 +0000588 default n
Rob Landleyc503df52006-05-09 22:08:56 +0000589 help
Denis Vlasenkoe0eebc12007-01-27 13:44:53 +0000590 Selecting this will add -Werror to gcc command line.
591
592 Most people should answer N.
593
Eric Andersenf086ed82004-05-25 11:30:22 +0000594choice
595 prompt "Additional debugging library"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000596 default NO_DEBUG_LIB
Eric Andersenc9f20d92002-12-05 08:41:41 +0000597 help
Eric Andersenf086ed82004-05-25 11:30:22 +0000598 Using an additional debugging library will make BusyBox become
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000599 considerable larger and will cause it to run more slowly. You
Eric Andersenf086ed82004-05-25 11:30:22 +0000600 should always leave this option disabled for production use.
601
602 dmalloc support:
603 ----------------
Eric Andersenc9f20d92002-12-05 08:41:41 +0000604 This enables compiling with dmalloc ( http://dmalloc.com/ )
605 which is an excellent public domain mem leak and malloc problem
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000606 detector. To enable dmalloc, before running busybox you will
Eric Andersenc9f20d92002-12-05 08:41:41 +0000607 want to properly set your environment, for example:
608 export DMALLOC_OPTIONS=debug=0x34f47d83,inter=100,log=logfile
609 The 'debug=' value is generated using the following command
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000610 dmalloc -p log-stats -p log-non-free -p log-bad-space \
611 -p log-elapsed-time -p check-fence -p check-heap \
612 -p check-lists -p check-blank -p check-funcs -p realloc-copy \
613 -p allow-free-null
Eric Andersenc9f20d92002-12-05 08:41:41 +0000614
Eric Andersenf086ed82004-05-25 11:30:22 +0000615 Electric-fence support:
616 -----------------------
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000617 This enables compiling with Electric-fence support. Electric
Eric Andersen88c916b2003-10-22 09:58:56 +0000618 fence is another very useful malloc debugging library which uses
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000619 your computer's virtual memory hardware to detect illegal memory
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000620 accesses. This support will make BusyBox be considerable larger
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000621 and run slower, so you should leave this option disabled unless
Eric Andersenc9f20d92002-12-05 08:41:41 +0000622 you are hunting a hard to find memory problem.
623
Eric Andersenf086ed82004-05-25 11:30:22 +0000624
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000625config NO_DEBUG_LIB
Eric Andersenf086ed82004-05-25 11:30:22 +0000626 bool "None"
627
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000628config DMALLOC
Eric Andersenf086ed82004-05-25 11:30:22 +0000629 bool "Dmalloc"
630
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000631config EFENCE
Eric Andersenf086ed82004-05-25 11:30:22 +0000632 bool "Electric-fence"
633
634endchoice
635
Denis Vlasenko2d5bd802008-10-24 10:49:49 +0000636### config PARSE
Denys Vlasenko3581c622010-01-25 13:39:24 +0100637### bool "Uniform config file parser debugging applet: parse"
Denis Vlasenko2e157dd2008-07-19 09:27:19 +0000638
Eric Andersenc9f20d92002-12-05 08:41:41 +0000639endmenu
Mike Frysinger72d59db2006-03-10 23:17:17 +0000640
641menu 'Installation Options'
642
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000643config INSTALL_NO_USR
Mike Frysinger72d59db2006-03-10 23:17:17 +0000644 bool "Don't use /usr"
645 default n
646 help
647 Disable use of /usr. Don't activate this option if you don't know
648 that you really want this behaviour.
649
650choice
Mike Frysinger71a6a4e2007-01-24 08:24:43 +0000651 prompt "Applets links"
652 default INSTALL_APPLET_SYMLINKS
653 help
654 Choose how you install applets links.
Mike Frysinger72d59db2006-03-10 23:17:17 +0000655
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000656config INSTALL_APPLET_SYMLINKS
Mike Frysinger71a6a4e2007-01-24 08:24:43 +0000657 bool "as soft-links"
658 help
659 Install applets as soft-links to the busybox binary. This needs some
660 free inodes on the filesystem, but might help with filesystem
661 generators that can't cope with hard-links.
Mike Frysinger72d59db2006-03-10 23:17:17 +0000662
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000663config INSTALL_APPLET_HARDLINKS
Mike Frysinger71a6a4e2007-01-24 08:24:43 +0000664 bool "as hard-links"
665 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000666 Install applets as hard-links to the busybox binary. This might
667 count on a filesystem with few inodes.
Mike Frysinger72d59db2006-03-10 23:17:17 +0000668
Denis Vlasenko737d1312007-08-25 18:25:24 +0000669config INSTALL_APPLET_SCRIPT_WRAPPERS
670 bool "as script wrappers"
671 help
672 Install applets as script wrappers that call the busybox binary.
673
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000674config INSTALL_APPLET_DONT
Mike Frysinger6cda8972007-01-24 09:32:42 +0000675 bool "not installed"
Denis Vlasenko80d14be2007-04-10 23:03:30 +0000676 depends on FEATURE_INSTALLER || FEATURE_SH_STANDALONE || FEATURE_PREFER_APPLETS
Mike Frysinger71a6a4e2007-01-24 08:24:43 +0000677 help
678 Do not install applet links. Useful when using the -install feature
Denis Vlasenko80d14be2007-04-10 23:03:30 +0000679 or a standalone shell for rescue purposes.
Mike Frysinger72d59db2006-03-10 23:17:17 +0000680
681endchoice
682
Denis Vlasenko737d1312007-08-25 18:25:24 +0000683choice
684 prompt "/bin/sh applet link"
685 default INSTALL_SH_APPLET_SYMLINK
686 depends on INSTALL_APPLET_SCRIPT_WRAPPERS
687 help
688 Choose how you install /bin/sh applet link.
689
690config INSTALL_SH_APPLET_SYMLINK
691 bool "as soft-link"
692 help
693 Install /bin/sh applet as soft-link to the busybox binary.
694
695config INSTALL_SH_APPLET_HARDLINK
696 bool "as hard-link"
697 help
698 Install /bin/sh applet as hard-link to the busybox binary.
699
700config INSTALL_SH_APPLET_SCRIPT_WRAPPER
701 bool "as script wrapper"
702 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000703 Install /bin/sh applet as script wrapper that call the busybox
704 binary.
Denis Vlasenko737d1312007-08-25 18:25:24 +0000705
706endchoice
707
Mike Frysinger72d59db2006-03-10 23:17:17 +0000708config PREFIX
709 string "BusyBox installation prefix"
710 default "./_install"
711 help
712 Define your directory to install BusyBox files/subdirs in.
713
714endmenu
715
716source libbb/Config.in
717
Rob Landley9dc69132006-03-13 02:52:23 +0000718endmenu
719
Mike Frysinger72d59db2006-03-10 23:17:17 +0000720comment "Applets"
721
722source archival/Config.in
723source coreutils/Config.in
724source console-tools/Config.in
725source debianutils/Config.in
726source editors/Config.in
727source findutils/Config.in
728source init/Config.in
729source loginutils/Config.in
730source e2fsprogs/Config.in
731source modutils/Config.in
732source util-linux/Config.in
733source miscutils/Config.in
734source networking/Config.in
Bernhard Reutner-Fischeraa2a1c02008-10-24 19:48:47 +0000735source printutils/Config.in
Denis Vlasenkob9d572a2008-11-06 23:41:38 +0000736source mailutils/Config.in
Mike Frysinger72d59db2006-03-10 23:17:17 +0000737source procps/Config.in
Denis Vlasenkofe544582006-10-03 15:57:40 +0000738source runit/Config.in
Denis Vlasenkod46d3c22007-02-06 19:28:50 +0000739source selinux/Config.in
Bernhard Reutner-Fischeraa2a1c02008-10-24 19:48:47 +0000740source shell/Config.in
741source sysklogd/Config.in