Config.in 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620
  1. #
  2. # For a description of the syntax of this configuration file,
  3. # see scripts/kbuild/config-language.txt.
  4. #
  5. # mainmenu "BusyBox Configuration"
  6. config BUSYBOX_HAVE_DOT_CONFIG
  7. bool
  8. default y
  9. menu "Busybox Settings"
  10. menu "General Configuration"
  11. config BUSYBOX_DESKTOP
  12. bool "Enable options for full-blown desktop systems"
  13. default n
  14. help
  15. Enable options and features which are not essential.
  16. Select this only if you plan to use busybox on full-blown
  17. desktop machine with common Linux distro, not on an embedded box.
  18. config BUSYBOX_EXTRA_COMPAT
  19. bool "Provide compatible behavior for rare corner cases (bigger code)"
  20. default n
  21. help
  22. This option makes grep, sed etc handle rare corner cases
  23. (embedded NUL bytes and such). This makes code bigger and uses
  24. some GNU extensions in libc. You probably only need this option
  25. if you plan to run busybox on desktop.
  26. choice
  27. prompt "Buffer allocation policy"
  28. default FEATURE_BUFFERS_USE_MALLOC
  29. help
  30. There are 3 ways BusyBox can handle buffer allocations:
  31. - Use malloc. This costs code size for the call to xmalloc.
  32. - Put them on stack. For some very small machines with limited stack
  33. space, this can be deadly. For most folks, this works just fine.
  34. - Put them in BSS. This works beautifully for computers with a real
  35. MMU (and OS support), but wastes runtime RAM for uCLinux. This
  36. behavior was the only one available for BusyBox versions 0.48 and
  37. earlier.
  38. config BUSYBOX_FEATURE_BUFFERS_USE_MALLOC
  39. bool "Allocate with Malloc"
  40. config BUSYBOX_FEATURE_BUFFERS_GO_ON_STACK
  41. bool "Allocate on the Stack"
  42. config BUSYBOX_FEATURE_BUFFERS_GO_IN_BSS
  43. bool "Allocate in the .bss section"
  44. endchoice
  45. config BUSYBOX_SHOW_USAGE
  46. bool "Show terse applet usage messages"
  47. default y
  48. help
  49. All BusyBox applets will show help messages when invoked with
  50. wrong arguments. You can turn off printing these terse usage
  51. messages if you say no here.
  52. This will save you up to 7k.
  53. config BUSYBOX_FEATURE_VERBOSE_USAGE
  54. bool "Show verbose applet usage messages"
  55. default y
  56. select BUSYBOX_SHOW_USAGE
  57. help
  58. All BusyBox applets will show more verbose help messages when
  59. busybox is invoked with --help. This will add a lot of text to the
  60. busybox binary. In the default configuration, this will add about
  61. 13k, but it can add much more depending on your configuration.
  62. config BUSYBOX_FEATURE_COMPRESS_USAGE
  63. bool "Store applet usage messages in compressed form"
  64. default y
  65. depends on BUSYBOX_SHOW_USAGE
  66. help
  67. Store usage messages in compressed form, uncompress them on-the-fly
  68. when <applet> --help is called.
  69. If you have a really tiny busybox with few applets enabled (and
  70. bunzip2 isn't one of them), the overhead of the decompressor might
  71. be noticeable. Also, if you run executables directly from ROM
  72. and have very little memory, this might not be a win. Otherwise,
  73. you probably want this.
  74. config BUSYBOX_FEATURE_INSTALLER
  75. bool "Support --install [-s] to install applet links at runtime"
  76. default n
  77. help
  78. Enable 'busybox --install [-s]' support. This will allow you to use
  79. busybox at runtime to create hard links or symlinks for all the
  80. applets that are compiled into busybox.
  81. config BUSYBOX_LOCALE_SUPPORT
  82. bool "Enable locale support (system needs locale for this to work)"
  83. default n
  84. help
  85. Enable this if your system has locale support and you would like
  86. busybox to support locale settings.
  87. config BUSYBOX_FEATURE_ASSUME_UNICODE
  88. bool "Support Unicode"
  89. default n
  90. help
  91. This makes various applets aware that one byte is not
  92. one character on screen.
  93. Busybox aims to eventually work correctly with Unicode displays.
  94. Any older encodings are not guaranteed to work.
  95. Probably by the time when busybox will be fully Unicode-clean,
  96. other encodings will be mainly of historic interest.
  97. config BUSYBOX_FEATURE_CHECK_UNICODE_IN_ENV
  98. bool "Check $LANG environment variable"
  99. default y
  100. depends on BUSYBOX_FEATURE_ASSUME_UNICODE && !BUSYBOX_LOCALE_SUPPORT
  101. help
  102. With this option on, Unicode support is activated
  103. only if LANG variable has the value of the form "xxxx.utf8"
  104. Otherwise, Unicode support will be always enabled and active.
  105. config BUSYBOX_LONG_OPTS
  106. bool "Support for --long-options"
  107. default y
  108. help
  109. Enable this if you want busybox applets to use the gnu --long-option
  110. style, in addition to single character -a -b -c style options.
  111. config BUSYBOX_FEATURE_DEVPTS
  112. bool "Use the devpts filesystem for Unix98 PTYs"
  113. default y
  114. help
  115. Enable if you want BusyBox to use Unix98 PTY support. If enabled,
  116. busybox will use /dev/ptmx for the master side of the pseudoterminal
  117. and /dev/pts/<number> for the slave side. Otherwise, BSD style
  118. /dev/ttyp<number> will be used. To use this option, you should have
  119. devpts mounted.
  120. config BUSYBOX_FEATURE_CLEAN_UP
  121. bool "Clean up all memory before exiting (usually not needed)"
  122. default n
  123. help
  124. As a size optimization, busybox normally exits without explicitly
  125. freeing dynamically allocated memory or closing files. This saves
  126. space since the OS will clean up for us, but it can confuse debuggers
  127. like valgrind, which report tons of memory and resource leaks.
  128. Don't enable this unless you have a really good reason to clean
  129. things up manually.
  130. config BUSYBOX_FEATURE_PIDFILE
  131. bool "Support writing pidfiles"
  132. default y
  133. help
  134. This option makes some applets (e.g. crond, syslogd, inetd) write
  135. a pidfile in /var/run. Some applications rely on them.
  136. config BUSYBOX_FEATURE_SUID
  137. bool "Support for SUID/SGID handling"
  138. default n
  139. help
  140. With this option you can install the busybox binary belonging
  141. to root with the suid bit set, and it will automatically drop
  142. priviledges for applets that don't need root access.
  143. If you are really paranoid and don't want to do this, build two
  144. busybox binaries with different applets in them (and the appropriate
  145. symlinks pointing to each binary), and only set the suid bit on the
  146. one that needs it. The applets currently marked to need the suid bit
  147. are:
  148. crontab, dnsd, findfs, ipcrm, ipcs, login, passwd, ping, su,
  149. traceroute, vlock.
  150. config BUSYBOX_FEATURE_SUID_CONFIG
  151. bool "Runtime SUID/SGID configuration via /etc/busybox.conf"
  152. default n if FEATURE_SUID
  153. depends on BUSYBOX_FEATURE_SUID
  154. help
  155. Allow the SUID / SGID state of an applet to be determined at runtime
  156. by checking /etc/busybox.conf. (This is sort of a poor man's sudo.)
  157. The format of this file is as follows:
  158. <applet> = [Ssx-][Ssx-][x-] (<username>|<uid>).(<groupname>|<gid>)
  159. An example might help:
  160. [SUID]
  161. su = ssx root.0 # applet su can be run by anyone and runs with
  162. # euid=0/egid=0
  163. su = ssx # exactly the same
  164. mount = sx- root.disk # applet mount can be run by root and members
  165. # of group disk and runs with euid=0
  166. cp = --- # disable applet cp for everyone
  167. The file has to be owned by user root, group root and has to be
  168. writeable only by root:
  169. (chown 0.0 /etc/busybox.conf; chmod 600 /etc/busybox.conf)
  170. The busybox executable has to be owned by user root, group
  171. root and has to be setuid root for this to work:
  172. (chown 0.0 /bin/busybox; chmod 4755 /bin/busybox)
  173. Robert 'sandman' Griebl has more information here:
  174. <url: http://www.softforge.de/bb/suid.html >.
  175. config BUSYBOX_FEATURE_SUID_CONFIG_QUIET
  176. bool "Suppress warning message if /etc/busybox.conf is not readable"
  177. default y
  178. depends on BUSYBOX_FEATURE_SUID_CONFIG
  179. help
  180. /etc/busybox.conf should be readable by the user needing the SUID,
  181. check this option to avoid users to be notified about missing
  182. permissions.
  183. config BUSYBOX_SELINUX
  184. bool "Support NSA Security Enhanced Linux"
  185. default n
  186. help
  187. Enable support for SELinux in applets ls, ps, and id. Also provide
  188. the option of compiling in SELinux applets.
  189. If you do not have a complete SELinux userland installed, this stuff
  190. will not compile. Go visit
  191. http://www.nsa.gov/selinux/index.html
  192. to download the necessary stuff to allow busybox to compile with
  193. this option enabled. Specifially, libselinux 1.28 or better is
  194. directly required by busybox. If the installation is located in a
  195. non-standard directory, provide it by invoking make as follows:
  196. CFLAGS=-I<libselinux-include-path> \
  197. LDFLAGS=-L<libselinux-lib-path> \
  198. make
  199. Most people will leave this set to 'N'.
  200. config BUSYBOX_FEATURE_PREFER_APPLETS
  201. bool "exec prefers applets"
  202. default n
  203. help
  204. This is an experimental option which directs applets about to
  205. call 'exec' to try and find an applicable busybox applet before
  206. searching the PATH. This is typically done by exec'ing
  207. /proc/self/exe.
  208. This may affect shell, find -exec, xargs and similar applets.
  209. They will use applets even if /bin/<applet> -> busybox link
  210. is missing (or is not a link to busybox). However, this causes
  211. problems in chroot jails without mounted /proc and with ps/top
  212. (command name can be shown as 'exe' for applets started this way).
  213. config BUSYBOX_BUSYBOX_EXEC_PATH
  214. string "Path to BusyBox executable"
  215. default "/proc/self/exe"
  216. help
  217. When Busybox applets need to run other busybox applets, BusyBox
  218. sometimes needs to exec() itself. When the /proc filesystem is
  219. mounted, /proc/self/exe always points to the currently running
  220. executable. If you haven't got /proc, set this to wherever you
  221. want to run BusyBox from.
  222. # These are auto-selected by other options
  223. config BUSYBOX_FEATURE_SYSLOG
  224. bool #No description makes it a hidden option
  225. default n
  226. #help
  227. # This option is auto-selected when you select any applet which may
  228. # send its output to syslog. You do not need to select it manually.
  229. config BUSYBOX_FEATURE_HAVE_RPC
  230. bool #No description makes it a hidden option
  231. default n
  232. #help
  233. # This is automatically selected if any of enabled applets need it.
  234. # You do not need to select it manually.
  235. endmenu
  236. menu 'Build Options'
  237. config BUSYBOX_STATIC
  238. bool "Build BusyBox as a static binary (no shared libs)"
  239. default n
  240. help
  241. If you want to build a static BusyBox binary, which does not
  242. use or require any shared libraries, then enable this option.
  243. This can cause BusyBox to be considerably larger, so you should
  244. leave this option false unless you have a good reason (i.e.
  245. your target platform does not support shared libraries, or
  246. you are building an initrd which doesn't need anything but
  247. BusyBox, etc).
  248. Most people will leave this set to 'N'.
  249. config BUSYBOX_PIE
  250. bool "Build BusyBox as a position independent executable"
  251. default n
  252. depends on !BUSYBOX_STATIC
  253. help
  254. (TODO: what is it and why/when is it useful?)
  255. Most people will leave this set to 'N'.
  256. config BUSYBOX_NOMMU
  257. bool "Force NOMMU build"
  258. default n
  259. help
  260. Busybox tries to detect whether architecture it is being
  261. built against supports MMU or not. If this detection fails,
  262. or if you want to build NOMMU version of busybox for testing,
  263. you may force NOMMU build here.
  264. Most people will leave this set to 'N'.
  265. # PIE can be made to work with BUILD_LIBBUSYBOX, but currently
  266. # build system does not support that
  267. config BUSYBOX_BUILD_LIBBUSYBOX
  268. bool "Build shared libbusybox"
  269. default n
  270. depends on !BUSYBOX_FEATURE_PREFER_APPLETS && !BUSYBOX_PIE && !BUSYBOX_STATIC
  271. help
  272. Build a shared library libbusybox.so.N.N.N which contains all
  273. busybox code.
  274. This feature allows every applet to be built as a tiny
  275. separate executable. Enabling it for "one big busybox binary"
  276. approach serves no purpose and increases code size.
  277. You should almost certainly say "no" to this.
  278. ### config FEATURE_FULL_LIBBUSYBOX
  279. ### bool "Feature-complete libbusybox"
  280. ### default n if !FEATURE_SHARED_BUSYBOX
  281. ### depends on BUSYBOX_BUILD_LIBBUSYBOX
  282. ### help
  283. ### Build a libbusybox with the complete feature-set, disregarding
  284. ### the actually selected config.
  285. ###
  286. ### Normally, libbusybox will only contain the features which are
  287. ### used by busybox itself. If you plan to write a separate
  288. ### standalone application which uses libbusybox say 'Y'.
  289. ###
  290. ### Note: libbusybox is GPL, not LGPL, and exports no stable API that
  291. ### might act as a copyright barrier. We can and will modify the
  292. ### exported function set between releases (even minor version number
  293. ### changes), and happily break out-of-tree features.
  294. ###
  295. ### Say 'N' if in doubt.
  296. config BUSYBOX_FEATURE_INDIVIDUAL
  297. bool "Produce a binary for each applet, linked against libbusybox"
  298. default y
  299. depends on BUSYBOX_BUILD_LIBBUSYBOX
  300. help
  301. If your CPU architecture doesn't allow for sharing text/rodata
  302. sections of running binaries, but allows for runtime dynamic
  303. libraries, this option will allow you to reduce memory footprint
  304. when you have many different applets running at once.
  305. If your CPU architecture allows for sharing text/rodata,
  306. having single binary is more optimal.
  307. Each applet will be a tiny program, dynamically linked
  308. against libbusybox.so.N.N.N.
  309. You need to have a working dynamic linker.
  310. config BUSYBOX_FEATURE_SHARED_BUSYBOX
  311. bool "Produce additional busybox binary linked against libbusybox"
  312. default y
  313. depends on BUSYBOX_BUILD_LIBBUSYBOX
  314. help
  315. Build busybox, dynamically linked against libbusybox.so.N.N.N.
  316. You need to have a working dynamic linker.
  317. ### config BUILD_AT_ONCE
  318. ### bool "Compile all sources at once"
  319. ### default n
  320. ### help
  321. ### Normally each source-file is compiled with one invocation of
  322. ### the compiler.
  323. ### If you set this option, all sources are compiled at once.
  324. ### This gives the compiler more opportunities to optimize which can
  325. ### result in smaller and/or faster binaries.
  326. ###
  327. ### Setting this option will consume alot of memory, e.g. if you
  328. ### enable all applets with all features, gcc uses more than 300MB
  329. ### RAM during compilation of busybox.
  330. ###
  331. ### This option is most likely only beneficial for newer compilers
  332. ### such as gcc-4.1 and above.
  333. ###
  334. ### Say 'N' unless you know what you are doing.
  335. config BUSYBOX_LFS
  336. bool "Build with Large File Support (for accessing files > 2 GB)"
  337. default y
  338. select BUSYBOX_FDISK_SUPPORT_LARGE_DISKS
  339. help
  340. If you want to build BusyBox with large file support, then enable
  341. this option. This will have no effect if your kernel or your C
  342. library lacks large file support for large files. Some of the
  343. programs that can benefit from large file support include dd, gzip,
  344. cp, mount, tar, and many others. If you want to access files larger
  345. than 2 Gigabytes, enable this option. Otherwise, leave it set to 'N'.
  346. config BUSYBOX_CROSS_COMPILER_PREFIX
  347. string "Cross Compiler prefix"
  348. default ""
  349. help
  350. If you want to build BusyBox with a cross compiler, then you
  351. will need to set this to the cross-compiler prefix, for example,
  352. "i386-uclibc-".
  353. Note that CROSS_COMPILE environment variable or
  354. "make CROSS_COMPILE=xxx ..." will override this selection.
  355. Native builds leave this empty.
  356. config BUSYBOX_EXTRA_CFLAGS
  357. string "Additional CFLAGS"
  358. default ""
  359. help
  360. Additional CFLAGS to pass to the compiler verbatim.
  361. endmenu
  362. menu 'Debugging Options'
  363. config BUSYBOX_DEBUG
  364. bool "Build BusyBox with extra Debugging symbols"
  365. default n
  366. help
  367. Say Y here if you wish to examine BusyBox internals while applets are
  368. running. This increases the size of the binary considerably, and
  369. should only be used when doing development. If you are doing
  370. development and want to debug BusyBox, answer Y.
  371. Most people should answer N.
  372. config BUSYBOX_DEBUG_PESSIMIZE
  373. bool "Disable compiler optimizations"
  374. default n
  375. depends on BUSYBOX_DEBUG
  376. help
  377. The compiler's optimization of source code can eliminate and reorder
  378. code, resulting in an executable that's hard to understand when
  379. stepping through it with a debugger. This switches it off, resulting
  380. in a much bigger executable that more closely matches the source
  381. code.
  382. config BUSYBOX_WERROR
  383. bool "Abort compilation on any warning"
  384. default n
  385. help
  386. Selecting this will add -Werror to gcc command line.
  387. Most people should answer N.
  388. choice
  389. prompt "Additional debugging library"
  390. default NO_DEBUG_LIB
  391. help
  392. Using an additional debugging library will make BusyBox become
  393. considerable larger and will cause it to run more slowly. You
  394. should always leave this option disabled for production use.
  395. dmalloc support:
  396. ----------------
  397. This enables compiling with dmalloc ( http://dmalloc.com/ )
  398. which is an excellent public domain mem leak and malloc problem
  399. detector. To enable dmalloc, before running busybox you will
  400. want to properly set your environment, for example:
  401. export DMALLOC_OPTIONS=debug=0x34f47d83,inter=100,log=logfile
  402. The 'debug=' value is generated using the following command
  403. dmalloc -p log-stats -p log-non-free -p log-bad-space \
  404. -p log-elapsed-time -p check-fence -p check-heap \
  405. -p check-lists -p check-blank -p check-funcs -p realloc-copy \
  406. -p allow-free-null
  407. Electric-fence support:
  408. -----------------------
  409. This enables compiling with Electric-fence support. Electric
  410. fence is another very useful malloc debugging library which uses
  411. your computer's virtual memory hardware to detect illegal memory
  412. accesses. This support will make BusyBox be considerable larger
  413. and run slower, so you should leave this option disabled unless
  414. you are hunting a hard to find memory problem.
  415. config BUSYBOX_NO_DEBUG_LIB
  416. bool "None"
  417. config BUSYBOX_DMALLOC
  418. bool "Dmalloc"
  419. config BUSYBOX_EFENCE
  420. bool "Electric-fence"
  421. endchoice
  422. config BUSYBOX_INCLUDE_SUSv2
  423. bool "Enable obsolete features removed before SUSv3?"
  424. default y
  425. help
  426. This option will enable backwards compatibility with SuSv2,
  427. specifically, old-style numeric options ('command -1 <file>')
  428. will be supported in head, tail, and fold. (Note: should
  429. affect renice too.)
  430. ### config PARSE
  431. ### bool "Uniform config file parser debugging applet: parse"
  432. endmenu
  433. menu 'Installation Options'
  434. config BUSYBOX_INSTALL_NO_USR
  435. bool "Don't use /usr"
  436. default n
  437. help
  438. Disable use of /usr. Don't activate this option if you don't know
  439. that you really want this behaviour.
  440. choice
  441. prompt "Applets links"
  442. default INSTALL_APPLET_SYMLINKS
  443. help
  444. Choose how you install applets links.
  445. config BUSYBOX_INSTALL_APPLET_SYMLINKS
  446. bool "as soft-links"
  447. help
  448. Install applets as soft-links to the busybox binary. This needs some
  449. free inodes on the filesystem, but might help with filesystem
  450. generators that can't cope with hard-links.
  451. config BUSYBOX_INSTALL_APPLET_HARDLINKS
  452. bool "as hard-links"
  453. help
  454. Install applets as hard-links to the busybox binary. This might
  455. count on a filesystem with few inodes.
  456. config BUSYBOX_INSTALL_APPLET_SCRIPT_WRAPPERS
  457. bool "as script wrappers"
  458. help
  459. Install applets as script wrappers that call the busybox binary.
  460. config BUSYBOX_INSTALL_APPLET_DONT
  461. bool "not installed"
  462. depends on BUSYBOX_FEATURE_INSTALLER || BUSYBOX_FEATURE_SH_STANDALONE || BUSYBOX_FEATURE_PREFER_APPLETS
  463. help
  464. Do not install applet links. Useful when using the -install feature
  465. or a standalone shell for rescue purposes.
  466. endchoice
  467. choice
  468. prompt "/bin/sh applet link"
  469. default INSTALL_SH_APPLET_SYMLINK
  470. depends on BUSYBOX_INSTALL_APPLET_SCRIPT_WRAPPERS
  471. help
  472. Choose how you install /bin/sh applet link.
  473. config BUSYBOX_INSTALL_SH_APPLET_SYMLINK
  474. bool "as soft-link"
  475. help
  476. Install /bin/sh applet as soft-link to the busybox binary.
  477. config BUSYBOX_INSTALL_SH_APPLET_HARDLINK
  478. bool "as hard-link"
  479. help
  480. Install /bin/sh applet as hard-link to the busybox binary.
  481. config BUSYBOX_INSTALL_SH_APPLET_SCRIPT_WRAPPER
  482. bool "as script wrapper"
  483. help
  484. Install /bin/sh applet as script wrapper that call the busybox
  485. binary.
  486. endchoice
  487. config BUSYBOX_PREFIX
  488. string "BusyBox installation prefix"
  489. default "@IDIR@"
  490. help
  491. Define your directory to install BusyBox files/subdirs in.
  492. endmenu
  493. source package/busybox/config/libbb/Config.in
  494. endmenu
  495. comment "Applets"
  496. source package/busybox/config/archival/Config.in
  497. source package/busybox/config/coreutils/Config.in
  498. source package/busybox/config/console-tools/Config.in
  499. source package/busybox/config/debianutils/Config.in
  500. source package/busybox/config/editors/Config.in
  501. source package/busybox/config/findutils/Config.in
  502. source package/busybox/config/init/Config.in
  503. source package/busybox/config/loginutils/Config.in
  504. source package/busybox/config/e2fsprogs/Config.in
  505. source package/busybox/config/modutils/Config.in
  506. source package/busybox/config/util-linux/Config.in
  507. source package/busybox/config/miscutils/Config.in
  508. source package/busybox/config/networking/Config.in
  509. source package/busybox/config/printutils/Config.in
  510. source package/busybox/config/mailutils/Config.in
  511. source package/busybox/config/procps/Config.in
  512. source package/busybox/config/runit/Config.in
  513. source package/busybox/config/selinux/Config.in
  514. source package/busybox/config/shell/Config.in
  515. source package/busybox/config/sysklogd/Config.in