Config.in 30 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843
  1. #
  2. # For a description of the syntax of this configuration file,
  3. # see scripts/kbuild/config-language.txt.
  4. #
  5. config BUSYBOX_CONFIG_HAVE_DOT_CONFIG
  6. bool
  7. default BUSYBOX_DEFAULT_HAVE_DOT_CONFIG
  8. menu "Busybox Settings"
  9. menu "General Configuration"
  10. config BUSYBOX_CONFIG_DESKTOP
  11. bool "Enable options for full-blown desktop systems"
  12. default BUSYBOX_DEFAULT_DESKTOP
  13. help
  14. Enable options and features which are not essential.
  15. Select this only if you plan to use busybox on full-blown
  16. desktop machine with common Linux distro, not on an embedded box.
  17. config BUSYBOX_CONFIG_EXTRA_COMPAT
  18. bool "Provide compatible behavior for rare corner cases (bigger code)"
  19. default BUSYBOX_DEFAULT_EXTRA_COMPAT
  20. help
  21. This option makes grep, sed etc handle rare corner cases
  22. (embedded NUL bytes and such). This makes code bigger and uses
  23. some GNU extensions in libc. You probably only need this option
  24. if you plan to run busybox on desktop.
  25. config BUSYBOX_CONFIG_INCLUDE_SUSv2
  26. bool "Enable obsolete features removed before SUSv3"
  27. default BUSYBOX_DEFAULT_INCLUDE_SUSv2
  28. help
  29. This option will enable backwards compatibility with SuSv2,
  30. specifically, old-style numeric options ('command -1 <file>')
  31. will be supported in head, tail, and fold. (Note: should
  32. affect renice too.)
  33. config BUSYBOX_CONFIG_USE_PORTABLE_CODE
  34. bool "Avoid using GCC-specific code constructs"
  35. default BUSYBOX_DEFAULT_USE_PORTABLE_CODE
  36. help
  37. Use this option if you are trying to compile busybox with
  38. compiler other than gcc.
  39. If you do use gcc, this option may needlessly increase code size.
  40. config BUSYBOX_CONFIG_PLATFORM_LINUX
  41. bool "Enable Linux-specific applets and features"
  42. default BUSYBOX_DEFAULT_PLATFORM_LINUX
  43. help
  44. For the most part, busybox requires only POSIX compatibility
  45. from the target system, but some applets and features use
  46. Linux-specific interfaces.
  47. Answering 'N' here will disable such applets and hide the
  48. corresponding configuration options.
  49. choice
  50. prompt "Buffer allocation policy"
  51. default BUSYBOX_CONFIG_FEATURE_BUFFERS_GO_ON_STACK
  52. help
  53. There are 3 ways BusyBox can handle buffer allocations:
  54. - Use malloc. This costs code size for the call to xmalloc.
  55. - Put them on stack. For some very small machines with limited stack
  56. space, this can be deadly. For most folks, this works just fine.
  57. - Put them in BSS. This works beautifully for computers with a real
  58. MMU (and OS support), but wastes runtime RAM for uCLinux. This
  59. behavior was the only one available for BusyBox versions 0.48 and
  60. earlier.
  61. config BUSYBOX_CONFIG_FEATURE_BUFFERS_USE_MALLOC
  62. bool "Allocate with Malloc"
  63. config BUSYBOX_CONFIG_FEATURE_BUFFERS_GO_ON_STACK
  64. bool "Allocate on the Stack"
  65. config BUSYBOX_CONFIG_FEATURE_BUFFERS_GO_IN_BSS
  66. bool "Allocate in the .bss section"
  67. endchoice
  68. config BUSYBOX_CONFIG_SHOW_USAGE
  69. bool "Show applet usage messages"
  70. default BUSYBOX_DEFAULT_SHOW_USAGE
  71. help
  72. Enabling this option, BusyBox applets will show terse help messages
  73. when invoked with wrong arguments.
  74. If you do not want to show any (helpful) usage message when
  75. issuing wrong command syntax, you can say 'N' here,
  76. saving approximately 7k.
  77. config BUSYBOX_CONFIG_FEATURE_VERBOSE_USAGE
  78. bool "Show verbose applet usage messages"
  79. default BUSYBOX_DEFAULT_FEATURE_VERBOSE_USAGE
  80. depends on BUSYBOX_CONFIG_SHOW_USAGE
  81. help
  82. All BusyBox applets will show verbose help messages when
  83. busybox is invoked with --help. This will add a lot of text to the
  84. busybox binary. In the default configuration, this will add about
  85. 13k, but it can add much more depending on your configuration.
  86. config BUSYBOX_CONFIG_FEATURE_COMPRESS_USAGE
  87. bool "Store applet usage messages in compressed form"
  88. default BUSYBOX_DEFAULT_FEATURE_COMPRESS_USAGE
  89. depends on BUSYBOX_CONFIG_SHOW_USAGE
  90. help
  91. Store usage messages in .bz compressed form, uncompress them
  92. on-the-fly when <applet> --help is called.
  93. If you have a really tiny busybox with few applets enabled (and
  94. bunzip2 isn't one of them), the overhead of the decompressor might
  95. be noticeable. Also, if you run executables directly from ROM
  96. and have very little memory, this might not be a win. Otherwise,
  97. you probably want this.
  98. config BUSYBOX_CONFIG_FEATURE_INSTALLER
  99. bool "Support --install [-s] to install applet links at runtime"
  100. default BUSYBOX_DEFAULT_FEATURE_INSTALLER
  101. help
  102. Enable 'busybox --install [-s]' support. This will allow you to use
  103. busybox at runtime to create hard links or symlinks for all the
  104. applets that are compiled into busybox.
  105. config BUSYBOX_CONFIG_INSTALL_NO_USR
  106. bool "Don't use /usr"
  107. default BUSYBOX_DEFAULT_INSTALL_NO_USR
  108. help
  109. Disable use of /usr. busybox --install and "make install"
  110. will install applets only to /bin and /sbin,
  111. never to /usr/bin or /usr/sbin.
  112. config BUSYBOX_CONFIG_LOCALE_SUPPORT
  113. bool "Enable locale support (system needs locale for this to work)"
  114. default BUSYBOX_DEFAULT_LOCALE_SUPPORT
  115. help
  116. Enable this if your system has locale support and you would like
  117. busybox to support locale settings.
  118. config BUSYBOX_CONFIG_UNICODE_SUPPORT
  119. bool "Support Unicode"
  120. default BUSYBOX_DEFAULT_UNICODE_SUPPORT
  121. help
  122. This makes various applets aware that one byte is not
  123. one character on screen.
  124. Busybox aims to eventually work correctly with Unicode displays.
  125. Any older encodings are not guaranteed to work.
  126. Probably by the time when busybox will be fully Unicode-clean,
  127. other encodings will be mainly of historic interest.
  128. config BUSYBOX_CONFIG_UNICODE_USING_LOCALE
  129. bool "Use libc routines for Unicode (else uses internal ones)"
  130. default BUSYBOX_DEFAULT_UNICODE_USING_LOCALE
  131. depends on BUSYBOX_CONFIG_UNICODE_SUPPORT && BUSYBOX_CONFIG_LOCALE_SUPPORT
  132. help
  133. With this option on, Unicode support is implemented using libc
  134. routines. Otherwise, internal implementation is used.
  135. Internal implementation is smaller.
  136. config BUSYBOX_CONFIG_FEATURE_CHECK_UNICODE_IN_ENV
  137. bool "Check $LC_ALL, $LC_CTYPE and $LANG environment variables"
  138. default BUSYBOX_DEFAULT_FEATURE_CHECK_UNICODE_IN_ENV
  139. depends on BUSYBOX_CONFIG_UNICODE_SUPPORT && !BUSYBOX_CONFIG_UNICODE_USING_LOCALE
  140. help
  141. With this option on, Unicode support is activated
  142. only if locale-related variables have the value of the form
  143. "xxxx.utf8"
  144. Otherwise, Unicode support will be always enabled and active.
  145. config BUSYBOX_CONFIG_SUBST_WCHAR
  146. int "Character code to substitute unprintable characters with"
  147. depends on BUSYBOX_CONFIG_UNICODE_SUPPORT
  148. default BUSYBOX_DEFAULT_SUBST_WCHAR
  149. help
  150. Typical values are 63 for '?' (works with any output device),
  151. 30 for ASCII substitute control code,
  152. 65533 (0xfffd) for Unicode replacement character.
  153. config BUSYBOX_CONFIG_LAST_SUPPORTED_WCHAR
  154. int "Range of supported Unicode characters"
  155. depends on BUSYBOX_CONFIG_UNICODE_SUPPORT
  156. default BUSYBOX_DEFAULT_LAST_SUPPORTED_WCHAR
  157. help
  158. Any character with Unicode value bigger than this is assumed
  159. to be non-printable on output device. Many applets replace
  160. such chars with substitution character.
  161. The idea is that many valid printable Unicode chars are
  162. nevertheless are not displayed correctly. Think about
  163. combining charachers, double-wide hieroglyphs, obscure
  164. characters in dozens of ancient scripts...
  165. Many terminals, terminal emulators, xterms etc will fail
  166. to handle them correctly. Choose the smallest value
  167. which suits your needs.
  168. Typical values are:
  169. 126 - ASCII only
  170. 767 (0x2ff) - there are no combining chars in [0..767] range
  171. (the range includes Latin 1, Latin Ext. A and B),
  172. code is ~700 bytes smaller for this case.
  173. 4351 (0x10ff) - there are no double-wide chars in [0..4351] range,
  174. code is ~300 bytes smaller for this case.
  175. 12799 (0x31ff) - nearly all non-ideographic characters are
  176. available in [0..12799] range, including
  177. East Asian scripts like katakana, hiragana, hangul,
  178. bopomofo...
  179. 0 - off, any valid printable Unicode character will be printed.
  180. config BUSYBOX_CONFIG_UNICODE_COMBINING_WCHARS
  181. bool "Allow zero-width Unicode characters on output"
  182. default BUSYBOX_DEFAULT_UNICODE_COMBINING_WCHARS
  183. depends on BUSYBOX_CONFIG_UNICODE_SUPPORT
  184. help
  185. With this option off, any Unicode char with width of 0
  186. is substituted on output.
  187. config BUSYBOX_CONFIG_UNICODE_WIDE_WCHARS
  188. bool "Allow wide Unicode characters on output"
  189. default BUSYBOX_DEFAULT_UNICODE_WIDE_WCHARS
  190. depends on BUSYBOX_CONFIG_UNICODE_SUPPORT
  191. help
  192. With this option off, any Unicode char with width > 1
  193. is substituted on output.
  194. config BUSYBOX_CONFIG_UNICODE_BIDI_SUPPORT
  195. bool "Bidirectional character-aware line input"
  196. default BUSYBOX_DEFAULT_UNICODE_BIDI_SUPPORT
  197. depends on BUSYBOX_CONFIG_UNICODE_SUPPORT && !BUSYBOX_CONFIG_UNICODE_USING_LOCALE
  198. help
  199. With this option on, right-to-left Unicode characters
  200. are treated differently on input (e.g. cursor movement).
  201. config BUSYBOX_CONFIG_UNICODE_NEUTRAL_TABLE
  202. bool "In bidi input, support non-ASCII neutral chars too"
  203. default BUSYBOX_DEFAULT_UNICODE_NEUTRAL_TABLE
  204. depends on BUSYBOX_CONFIG_UNICODE_BIDI_SUPPORT
  205. help
  206. In most cases it's enough to treat only ASCII non-letters
  207. (i.e. punctuation, numbers and space) as characters
  208. with neutral directionality.
  209. With this option on, more extensive (and bigger) table
  210. of neutral chars will be used.
  211. config BUSYBOX_CONFIG_UNICODE_PRESERVE_BROKEN
  212. bool "Make it possible to enter sequences of chars which are not Unicode"
  213. default BUSYBOX_DEFAULT_UNICODE_PRESERVE_BROKEN
  214. depends on BUSYBOX_CONFIG_UNICODE_SUPPORT
  215. help
  216. With this option on, on line-editing input (such as used by shells)
  217. invalid UTF-8 bytes are not substituted with the selected
  218. substitution character.
  219. For example, this means that entering 'l', 's', ' ', 0xff, [Enter]
  220. at shell prompt will list file named 0xff (single char name
  221. with char value 255), not file named '?'.
  222. config BUSYBOX_CONFIG_PAM
  223. bool "Support for PAM (Pluggable Authentication Modules)"
  224. default BUSYBOX_DEFAULT_PAM
  225. help
  226. Use PAM in some busybox applets (currently login and httpd) instead
  227. of direct access to password database.
  228. config BUSYBOX_CONFIG_FEATURE_USE_SENDFILE
  229. bool "Use sendfile system call"
  230. default BUSYBOX_DEFAULT_FEATURE_USE_SENDFILE
  231. select BUSYBOX_CONFIG_PLATFORM_LINUX
  232. help
  233. When enabled, busybox will use the kernel sendfile() function
  234. instead of read/write loops to copy data between file descriptors
  235. (for example, cp command does this a lot).
  236. If sendfile() doesn't work, copying code falls back to read/write
  237. loop. sendfile() was originally implemented for faster I/O
  238. from files to sockets, but since Linux 2.6.33 it was extended
  239. to work for many more file types.
  240. config BUSYBOX_CONFIG_LONG_OPTS
  241. bool "Support for --long-options"
  242. default BUSYBOX_DEFAULT_LONG_OPTS
  243. help
  244. Enable this if you want busybox applets to use the gnu --long-option
  245. style, in addition to single character -a -b -c style options.
  246. config BUSYBOX_CONFIG_FEATURE_DEVPTS
  247. bool "Use the devpts filesystem for Unix98 PTYs"
  248. default BUSYBOX_DEFAULT_FEATURE_DEVPTS
  249. help
  250. Enable if you want BusyBox to use Unix98 PTY support. If enabled,
  251. busybox will use /dev/ptmx for the master side of the pseudoterminal
  252. and /dev/pts/<number> for the slave side. Otherwise, BSD style
  253. /dev/ttyp<number> will be used. To use this option, you should have
  254. devpts mounted.
  255. config BUSYBOX_CONFIG_FEATURE_CLEAN_UP
  256. bool "Clean up all memory before exiting (usually not needed)"
  257. default BUSYBOX_DEFAULT_FEATURE_CLEAN_UP
  258. help
  259. As a size optimization, busybox normally exits without explicitly
  260. freeing dynamically allocated memory or closing files. This saves
  261. space since the OS will clean up for us, but it can confuse debuggers
  262. like valgrind, which report tons of memory and resource leaks.
  263. Don't enable this unless you have a really good reason to clean
  264. things up manually.
  265. config BUSYBOX_CONFIG_FEATURE_UTMP
  266. bool "Support utmp file"
  267. default BUSYBOX_DEFAULT_FEATURE_UTMP
  268. help
  269. The file /var/run/utmp is used to track who is currently logged in.
  270. With this option on, certain applets (getty, login, telnetd etc)
  271. will create and delete entries there.
  272. "who" applet requires this option.
  273. config BUSYBOX_CONFIG_FEATURE_WTMP
  274. bool "Support wtmp file"
  275. default BUSYBOX_DEFAULT_FEATURE_WTMP
  276. depends on BUSYBOX_CONFIG_FEATURE_UTMP
  277. help
  278. The file /var/run/wtmp is used to track when users have logged into
  279. and logged out of the system.
  280. With this option on, certain applets (getty, login, telnetd etc)
  281. will append new entries there.
  282. "last" applet requires this option.
  283. config BUSYBOX_CONFIG_FEATURE_PIDFILE
  284. bool "Support writing pidfiles"
  285. default BUSYBOX_DEFAULT_FEATURE_PIDFILE
  286. help
  287. This option makes some applets (e.g. crond, syslogd, inetd) write
  288. a pidfile at the configured PID_FILE_PATH. It has no effect
  289. on applets which require pidfiles to run.
  290. config BUSYBOX_CONFIG_PID_FILE_PATH
  291. string "Path to directory for pidfile"
  292. default BUSYBOX_DEFAULT_PID_FILE_PATH
  293. depends on BUSYBOX_CONFIG_FEATURE_PIDFILE
  294. help
  295. This is the default path where pidfiles are created. Applets which
  296. allow you to set the pidfile path on the command line will override
  297. this value. The option has no effect on applets that require you to
  298. specify a pidfile path.
  299. config BUSYBOX_CONFIG_FEATURE_SUID
  300. bool "Support for SUID/SGID handling"
  301. default BUSYBOX_DEFAULT_FEATURE_SUID
  302. help
  303. With this option you can install the busybox binary belonging
  304. to root with the suid bit set, enabling some applets to perform
  305. root-level operations even when run by ordinary users
  306. (for example, mounting of user mounts in fstab needs this).
  307. Busybox will automatically drop privileges for applets
  308. that don't need root access.
  309. If you are really paranoid and don't want to do this, build two
  310. busybox binaries with different applets in them (and the appropriate
  311. symlinks pointing to each binary), and only set the suid bit on the
  312. one that needs it.
  313. The applets which require root rights (need suid bit or
  314. to be run by root) and will refuse to execute otherwise:
  315. crontab, login, passwd, su, vlock, wall.
  316. The applets which will use root rights if they have them
  317. (via suid bit, or because run by root), but would try to work
  318. without root right nevertheless:
  319. findfs, ping[6], traceroute[6], mount.
  320. Note that if you DONT select this option, but DO make busybox
  321. suid root, ALL applets will run under root, which is a huge
  322. security hole (think "cp /some/file /etc/passwd").
  323. config BUSYBOX_CONFIG_FEATURE_SUID_CONFIG
  324. bool "Runtime SUID/SGID configuration via /etc/busybox.conf"
  325. default BUSYBOX_DEFAULT_FEATURE_SUID_CONFIG
  326. depends on BUSYBOX_CONFIG_FEATURE_SUID
  327. help
  328. Allow the SUID / SGID state of an applet to be determined at runtime
  329. by checking /etc/busybox.conf. (This is sort of a poor man's sudo.)
  330. The format of this file is as follows:
  331. APPLET = [Ssx-][Ssx-][x-] [USER.GROUP]
  332. s: USER or GROUP is allowed to execute APPLET.
  333. APPLET will run under USER or GROUP
  334. (reagardless of who's running it).
  335. S: USER or GROUP is NOT allowed to execute APPLET.
  336. APPLET will run under USER or GROUP.
  337. This option is not very sensical.
  338. x: USER/GROUP/others are allowed to execute APPLET.
  339. No UID/GID change will be done when it is run.
  340. -: USER/GROUP/others are not allowed to execute APPLET.
  341. An example might help:
  342. [SUID]
  343. su = ssx root.0 # applet su can be run by anyone and runs with
  344. # euid=0/egid=0
  345. su = ssx # exactly the same
  346. mount = sx- root.disk # applet mount can be run by root and members
  347. # of group disk (but not anyone else)
  348. # and runs with euid=0 (egid is not changed)
  349. cp = --- # disable applet cp for everyone
  350. The file has to be owned by user root, group root and has to be
  351. writeable only by root:
  352. (chown 0.0 /etc/busybox.conf; chmod 600 /etc/busybox.conf)
  353. The busybox executable has to be owned by user root, group
  354. root and has to be setuid root for this to work:
  355. (chown 0.0 /bin/busybox; chmod 4755 /bin/busybox)
  356. Robert 'sandman' Griebl has more information here:
  357. <url: http://www.softforge.de/bb/suid.html >.
  358. config BUSYBOX_CONFIG_FEATURE_SUID_CONFIG_QUIET
  359. bool "Suppress warning message if /etc/busybox.conf is not readable"
  360. default BUSYBOX_DEFAULT_FEATURE_SUID_CONFIG_QUIET
  361. depends on BUSYBOX_CONFIG_FEATURE_SUID_CONFIG
  362. help
  363. /etc/busybox.conf should be readable by the user needing the SUID,
  364. check this option to avoid users to be notified about missing
  365. permissions.
  366. config BUSYBOX_CONFIG_SELINUX
  367. bool "Support NSA Security Enhanced Linux"
  368. default BUSYBOX_DEFAULT_SELINUX
  369. select BUSYBOX_CONFIG_PLATFORM_LINUX
  370. help
  371. Enable support for SELinux in applets ls, ps, and id. Also provide
  372. the option of compiling in SELinux applets.
  373. If you do not have a complete SELinux userland installed, this stuff
  374. will not compile. Specifially, libselinux 1.28 or better is
  375. directly required by busybox. If the installation is located in a
  376. non-standard directory, provide it by invoking make as follows:
  377. CFLAGS=-I<libselinux-include-path> \
  378. LDFLAGS=-L<libselinux-lib-path> \
  379. make
  380. Most people will leave this set to 'N'.
  381. config BUSYBOX_CONFIG_FEATURE_PREFER_APPLETS
  382. bool "exec prefers applets"
  383. default BUSYBOX_DEFAULT_FEATURE_PREFER_APPLETS
  384. help
  385. This is an experimental option which directs applets about to
  386. call 'exec' to try and find an applicable busybox applet before
  387. searching the PATH. This is typically done by exec'ing
  388. /proc/self/exe.
  389. This may affect shell, find -exec, xargs and similar applets.
  390. They will use applets even if /bin/<applet> -> busybox link
  391. is missing (or is not a link to busybox). However, this causes
  392. problems in chroot jails without mounted /proc and with ps/top
  393. (command name can be shown as 'exe' for applets started this way).
  394. config BUSYBOX_CONFIG_BUSYBOX_EXEC_PATH
  395. string "Path to BusyBox executable"
  396. default BUSYBOX_DEFAULT_BUSYBOX_EXEC_PATH
  397. help
  398. When Busybox applets need to run other busybox applets, BusyBox
  399. sometimes needs to exec() itself. When the /proc filesystem is
  400. mounted, /proc/self/exe always points to the currently running
  401. executable. If you haven't got /proc, set this to wherever you
  402. want to run BusyBox from.
  403. # These are auto-selected by other options
  404. config BUSYBOX_CONFIG_FEATURE_SYSLOG
  405. bool #No description makes it a hidden option
  406. default BUSYBOX_DEFAULT_FEATURE_SYSLOG
  407. #help
  408. # This option is auto-selected when you select any applet which may
  409. # send its output to syslog. You do not need to select it manually.
  410. config BUSYBOX_CONFIG_FEATURE_HAVE_RPC
  411. bool #No description makes it a hidden option
  412. default BUSYBOX_DEFAULT_FEATURE_HAVE_RPC
  413. #help
  414. # This is automatically selected if any of enabled applets need it.
  415. # You do not need to select it manually.
  416. endmenu
  417. menu 'Build Options'
  418. config BUSYBOX_CONFIG_STATIC
  419. bool "Build BusyBox as a static binary (no shared libs)"
  420. default BUSYBOX_DEFAULT_STATIC
  421. help
  422. If you want to build a static BusyBox binary, which does not
  423. use or require any shared libraries, then enable this option.
  424. This can cause BusyBox to be considerably larger, so you should
  425. leave this option false unless you have a good reason (i.e.
  426. your target platform does not support shared libraries, or
  427. you are building an initrd which doesn't need anything but
  428. BusyBox, etc).
  429. Most people will leave this set to 'N'.
  430. config BUSYBOX_CONFIG_PIE
  431. bool "Build BusyBox as a position independent executable"
  432. default BUSYBOX_DEFAULT_PIE
  433. depends on !BUSYBOX_CONFIG_STATIC
  434. help
  435. Hardened code option. PIE binaries are loaded at a different
  436. address at each invocation. This has some overhead,
  437. particularly on x86-32 which is short on registers.
  438. Most people will leave this set to 'N'.
  439. config BUSYBOX_CONFIG_NOMMU
  440. bool "Force NOMMU build"
  441. default BUSYBOX_DEFAULT_NOMMU
  442. help
  443. Busybox tries to detect whether architecture it is being
  444. built against supports MMU or not. If this detection fails,
  445. or if you want to build NOMMU version of busybox for testing,
  446. you may force NOMMU build here.
  447. Most people will leave this set to 'N'.
  448. # PIE can be made to work with BUILD_LIBBUSYBOX, but currently
  449. # build system does not support that
  450. config BUSYBOX_CONFIG_BUILD_LIBBUSYBOX
  451. bool "Build shared libbusybox"
  452. default BUSYBOX_DEFAULT_BUILD_LIBBUSYBOX
  453. depends on !BUSYBOX_CONFIG_FEATURE_PREFER_APPLETS && !BUSYBOX_CONFIG_PIE && !BUSYBOX_CONFIG_STATIC
  454. help
  455. Build a shared library libbusybox.so.N.N.N which contains all
  456. busybox code.
  457. This feature allows every applet to be built as a tiny
  458. separate executable. Enabling it for "one big busybox binary"
  459. approach serves no purpose and increases code size.
  460. You should almost certainly say "no" to this.
  461. ### config FEATURE_FULL_LIBBUSYBOX
  462. ### bool "Feature-complete libbusybox"
  463. ### default n if !FEATURE_SHARED_BUSYBOX
  464. ### depends on BUILD_LIBBUSYBOX
  465. ### help
  466. ### Build a libbusybox with the complete feature-set, disregarding
  467. ### the actually selected config.
  468. ###
  469. ### Normally, libbusybox will only contain the features which are
  470. ### used by busybox itself. If you plan to write a separate
  471. ### standalone application which uses libbusybox say 'Y'.
  472. ###
  473. ### Note: libbusybox is GPL, not LGPL, and exports no stable API that
  474. ### might act as a copyright barrier. We can and will modify the
  475. ### exported function set between releases (even minor version number
  476. ### changes), and happily break out-of-tree features.
  477. ###
  478. ### Say 'N' if in doubt.
  479. config BUSYBOX_CONFIG_FEATURE_INDIVIDUAL
  480. bool "Produce a binary for each applet, linked against libbusybox"
  481. default BUSYBOX_DEFAULT_FEATURE_INDIVIDUAL
  482. depends on BUSYBOX_CONFIG_BUILD_LIBBUSYBOX
  483. help
  484. If your CPU architecture doesn't allow for sharing text/rodata
  485. sections of running binaries, but allows for runtime dynamic
  486. libraries, this option will allow you to reduce memory footprint
  487. when you have many different applets running at once.
  488. If your CPU architecture allows for sharing text/rodata,
  489. having single binary is more optimal.
  490. Each applet will be a tiny program, dynamically linked
  491. against libbusybox.so.N.N.N.
  492. You need to have a working dynamic linker.
  493. config BUSYBOX_CONFIG_FEATURE_SHARED_BUSYBOX
  494. bool "Produce additional busybox binary linked against libbusybox"
  495. default BUSYBOX_DEFAULT_FEATURE_SHARED_BUSYBOX
  496. depends on BUSYBOX_CONFIG_BUILD_LIBBUSYBOX
  497. help
  498. Build busybox, dynamically linked against libbusybox.so.N.N.N.
  499. You need to have a working dynamic linker.
  500. ### config BUILD_AT_ONCE
  501. ### bool "Compile all sources at once"
  502. ### default n
  503. ### help
  504. ### Normally each source-file is compiled with one invocation of
  505. ### the compiler.
  506. ### If you set this option, all sources are compiled at once.
  507. ### This gives the compiler more opportunities to optimize which can
  508. ### result in smaller and/or faster binaries.
  509. ###
  510. ### Setting this option will consume alot of memory, e.g. if you
  511. ### enable all applets with all features, gcc uses more than 300MB
  512. ### RAM during compilation of busybox.
  513. ###
  514. ### This option is most likely only beneficial for newer compilers
  515. ### such as gcc-4.1 and above.
  516. ###
  517. ### Say 'N' unless you know what you are doing.
  518. config BUSYBOX_CONFIG_LFS
  519. bool
  520. default BUSYBOX_DEFAULT_LFS
  521. help
  522. If you want to build BusyBox with large file support, then enable
  523. this option. This will have no effect if your kernel or your C
  524. library lacks large file support for large files. Some of the
  525. programs that can benefit from large file support include dd, gzip,
  526. cp, mount, tar, and many others. If you want to access files larger
  527. than 2 Gigabytes, enable this option. Otherwise, leave it set to 'N'.
  528. config BUSYBOX_CONFIG_CROSS_COMPILER_PREFIX
  529. string "Cross Compiler prefix"
  530. default BUSYBOX_DEFAULT_CROSS_COMPILER_PREFIX
  531. help
  532. If you want to build BusyBox with a cross compiler, then you
  533. will need to set this to the cross-compiler prefix, for example,
  534. "i386-uclibc-".
  535. Note that CROSS_COMPILE environment variable or
  536. "make CROSS_COMPILE=xxx ..." will override this selection.
  537. Native builds leave this empty.
  538. config BUSYBOX_CONFIG_SYSROOT
  539. string "Path to sysroot"
  540. default BUSYBOX_DEFAULT_SYSROOT
  541. help
  542. If you want to build BusyBox with a cross compiler, then you
  543. might also need to specify where /usr/include and /usr/lib
  544. will be found.
  545. For example, BusyBox can be built against an installed
  546. Android NDK, platform version 9, for ARM ABI with
  547. CONFIG_SYSROOT=/opt/android-ndk/platforms/android-9/arch-arm
  548. Native builds leave this empty.
  549. config BUSYBOX_CONFIG_EXTRA_CFLAGS
  550. string "Additional CFLAGS"
  551. default BUSYBOX_DEFAULT_EXTRA_CFLAGS
  552. help
  553. Additional CFLAGS to pass to the compiler verbatim.
  554. config BUSYBOX_CONFIG_EXTRA_LDFLAGS
  555. string "Additional LDFLAGS"
  556. default BUSYBOX_DEFAULT_EXTRA_LDFLAGS
  557. help
  558. Additional LDFLAGS to pass to the linker verbatim.
  559. config BUSYBOX_CONFIG_EXTRA_LDLIBS
  560. string "Additional LDLIBS"
  561. default BUSYBOX_DEFAULT_EXTRA_LDLIBS
  562. help
  563. Additional LDLIBS to pass to the linker with -l.
  564. endmenu
  565. menu 'Debugging Options'
  566. config BUSYBOX_CONFIG_DEBUG
  567. bool "Build BusyBox with extra Debugging symbols"
  568. default BUSYBOX_DEFAULT_DEBUG
  569. help
  570. Say Y here if you wish to examine BusyBox internals while applets are
  571. running. This increases the size of the binary considerably, and
  572. should only be used when doing development. If you are doing
  573. development and want to debug BusyBox, answer Y.
  574. Most people should answer N.
  575. config BUSYBOX_CONFIG_DEBUG_PESSIMIZE
  576. bool "Disable compiler optimizations"
  577. default BUSYBOX_DEFAULT_DEBUG_PESSIMIZE
  578. depends on BUSYBOX_CONFIG_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
  582. stepping through it with a debugger. This switches it off, resulting
  583. in a much bigger executable that more closely matches the source
  584. code.
  585. config BUSYBOX_CONFIG_UNIT_TEST
  586. bool "Build unit tests"
  587. default BUSYBOX_DEFAULT_UNIT_TEST
  588. help
  589. Say Y here if you want to build unit tests (both the framework and
  590. test cases) as a Busybox applet. This results in bigger code, so you
  591. probably don't want this option in production builds.
  592. config BUSYBOX_CONFIG_WERROR
  593. bool "Abort compilation on any warning"
  594. default BUSYBOX_DEFAULT_WERROR
  595. help
  596. Selecting this will add -Werror to gcc command line.
  597. Most people should answer N.
  598. choice
  599. prompt "Additional debugging library"
  600. default BUSYBOX_CONFIG_NO_DEBUG_LIB
  601. help
  602. Using an additional debugging library will make BusyBox become
  603. considerable larger and will cause it to run more slowly. You
  604. should always leave this option disabled for production use.
  605. dmalloc support:
  606. ----------------
  607. This enables compiling with dmalloc ( http://dmalloc.com/ )
  608. which is an excellent public domain mem leak and malloc problem
  609. detector. To enable dmalloc, before running busybox you will
  610. want to properly set your environment, for example:
  611. export DMALLOC_OPTIONS=debug=0x34f47d83,inter=100,log=logfile
  612. The 'debug=' value is generated using the following command
  613. dmalloc -p log-stats -p log-non-free -p log-bad-space \
  614. -p log-elapsed-time -p check-fence -p check-heap \
  615. -p check-lists -p check-blank -p check-funcs -p realloc-copy \
  616. -p allow-free-null
  617. Electric-fence support:
  618. -----------------------
  619. This enables compiling with Electric-fence support. Electric
  620. fence is another very useful malloc debugging library which uses
  621. your computer's virtual memory hardware to detect illegal memory
  622. accesses. This support will make BusyBox be considerable larger
  623. and run slower, so you should leave this option disabled unless
  624. you are hunting a hard to find memory problem.
  625. config BUSYBOX_CONFIG_NO_DEBUG_LIB
  626. bool "None"
  627. config BUSYBOX_CONFIG_DMALLOC
  628. bool "Dmalloc"
  629. config BUSYBOX_CONFIG_EFENCE
  630. bool "Electric-fence"
  631. endchoice
  632. endmenu
  633. menu 'Installation Options ("make install" behavior)'
  634. choice
  635. prompt "What kind of applet links to install"
  636. default BUSYBOX_CONFIG_INSTALL_APPLET_SYMLINKS
  637. help
  638. Choose what kind of links to applets are created by "make install".
  639. config BUSYBOX_CONFIG_INSTALL_APPLET_SYMLINKS
  640. bool "as soft-links"
  641. help
  642. Install applets as soft-links to the busybox binary. This needs some
  643. free inodes on the filesystem, but might help with filesystem
  644. generators that can't cope with hard-links.
  645. config BUSYBOX_CONFIG_INSTALL_APPLET_HARDLINKS
  646. bool "as hard-links"
  647. help
  648. Install applets as hard-links to the busybox binary. This might
  649. count on a filesystem with few inodes.
  650. config BUSYBOX_CONFIG_INSTALL_APPLET_SCRIPT_WRAPPERS
  651. bool "as script wrappers"
  652. help
  653. Install applets as script wrappers that call the busybox binary.
  654. config BUSYBOX_CONFIG_INSTALL_APPLET_DONT
  655. bool "not installed"
  656. help
  657. Do not install applet links. Useful when you plan to use
  658. busybox --install for installing links, or plan to use
  659. a standalone shell and thus don't need applet links.
  660. endchoice
  661. choice
  662. prompt "/bin/sh applet link"
  663. default BUSYBOX_CONFIG_INSTALL_SH_APPLET_SYMLINK
  664. depends on BUSYBOX_CONFIG_INSTALL_APPLET_SCRIPT_WRAPPERS
  665. help
  666. Choose how you install /bin/sh applet link.
  667. config BUSYBOX_CONFIG_INSTALL_SH_APPLET_SYMLINK
  668. bool "as soft-link"
  669. help
  670. Install /bin/sh applet as soft-link to the busybox binary.
  671. config BUSYBOX_CONFIG_INSTALL_SH_APPLET_HARDLINK
  672. bool "as hard-link"
  673. help
  674. Install /bin/sh applet as hard-link to the busybox binary.
  675. config BUSYBOX_CONFIG_INSTALL_SH_APPLET_SCRIPT_WRAPPER
  676. bool "as script wrapper"
  677. help
  678. Install /bin/sh applet as script wrapper that calls
  679. the busybox binary.
  680. endchoice
  681. config BUSYBOX_CONFIG_PREFIX
  682. string "BusyBox installation prefix"
  683. default BUSYBOX_DEFAULT_PREFIX
  684. help
  685. Define your directory to install BusyBox files/subdirs in.
  686. endmenu
  687. source libbb/Config.in
  688. endmenu
  689. comment "Applets"
  690. source archival/Config.in
  691. source coreutils/Config.in
  692. source console-tools/Config.in
  693. source debianutils/Config.in
  694. source editors/Config.in
  695. source findutils/Config.in
  696. source init/Config.in
  697. source loginutils/Config.in
  698. source e2fsprogs/Config.in
  699. source modutils/Config.in
  700. source util-linux/Config.in
  701. source miscutils/Config.in
  702. source networking/Config.in
  703. source printutils/Config.in
  704. source mailutils/Config.in
  705. source procps/Config.in
  706. source runit/Config.in
  707. source selinux/Config.in
  708. source shell/Config.in
  709. source sysklogd/Config.in