Config.in 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606
  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. config BUSYBOX_FEATURE_ASSUME_UNICODE
  27. bool "Assume that 1:1 char/glyph correspondence is not true"
  28. default n
  29. help
  30. This makes various applets aware that one byte is not
  31. one character on screen.
  32. Busybox aims to eventually work correctly with Unicode displays.
  33. Any older encodings are not guaranteed to work.
  34. Probably by the time when busybox will be fully Unicode-clean,
  35. other encodings will be mainly of historic interest.
  36. choice
  37. prompt "Buffer allocation policy"
  38. default FEATURE_BUFFERS_USE_MALLOC
  39. help
  40. There are 3 ways BusyBox can handle buffer allocations:
  41. - Use malloc. This costs code size for the call to xmalloc.
  42. - Put them on stack. For some very small machines with limited stack
  43. space, this can be deadly. For most folks, this works just fine.
  44. - Put them in BSS. This works beautifully for computers with a real
  45. MMU (and OS support), but wastes runtime RAM for uCLinux. This
  46. behavior was the only one available for BusyBox versions 0.48 and
  47. earlier.
  48. config BUSYBOX_FEATURE_BUFFERS_USE_MALLOC
  49. bool "Allocate with Malloc"
  50. config BUSYBOX_FEATURE_BUFFERS_GO_ON_STACK
  51. bool "Allocate on the Stack"
  52. config BUSYBOX_FEATURE_BUFFERS_GO_IN_BSS
  53. bool "Allocate in the .bss section"
  54. endchoice
  55. config BUSYBOX_SHOW_USAGE
  56. bool "Show terse applet usage messages"
  57. default y
  58. help
  59. All BusyBox applets will show help messages when invoked with
  60. wrong arguments. You can turn off printing these terse usage
  61. messages if you say no here.
  62. This will save you up to 7k.
  63. config BUSYBOX_FEATURE_VERBOSE_USAGE
  64. bool "Show verbose applet usage messages"
  65. default y
  66. select BUSYBOX_SHOW_USAGE
  67. help
  68. All BusyBox applets will show more verbose help messages when
  69. busybox is invoked with --help. This will add a lot of text to the
  70. busybox binary. In the default configuration, this will add about
  71. 13k, but it can add much more depending on your configuration.
  72. config BUSYBOX_FEATURE_COMPRESS_USAGE
  73. bool "Store applet usage messages in compressed form"
  74. default y
  75. depends on BUSYBOX_SHOW_USAGE
  76. help
  77. Store usage messages in compressed form, uncompress them on-the-fly
  78. when <applet> --help is called.
  79. If you have a really tiny busybox with few applets enabled (and
  80. bunzip2 isn't one of them), the overhead of the decompressor might
  81. be noticeable. Also, if you run executables directly from ROM
  82. and have very little memory, this might not be a win. Otherwise,
  83. you probably want this.
  84. config BUSYBOX_FEATURE_INSTALLER
  85. bool "Support --install [-s] to install applet links at runtime"
  86. default n
  87. help
  88. Enable 'busybox --install [-s]' support. This will allow you to use
  89. busybox at runtime to create hard links or symlinks for all the
  90. applets that are compiled into busybox.
  91. config BUSYBOX_LOCALE_SUPPORT
  92. bool "Enable locale support (system needs locale for this to work)"
  93. default n
  94. help
  95. Enable this if your system has locale support and you would like
  96. busybox to support locale settings.
  97. config BUSYBOX_GETOPT_LONG
  98. bool "Support for --long-options"
  99. default y
  100. help
  101. Enable this if you want busybox applets to use the gnu --long-option
  102. style, in addition to single character -a -b -c style options.
  103. config BUSYBOX_FEATURE_DEVPTS
  104. bool "Use the devpts filesystem for Unix98 PTYs"
  105. default y
  106. help
  107. Enable if you want BusyBox to use Unix98 PTY support. If enabled,
  108. busybox will use /dev/ptmx for the master side of the pseudoterminal
  109. and /dev/pts/<number> for the slave side. Otherwise, BSD style
  110. /dev/ttyp<number> will be used. To use this option, you should have
  111. devpts mounted.
  112. config BUSYBOX_FEATURE_CLEAN_UP
  113. bool "Clean up all memory before exiting (usually not needed)"
  114. default n
  115. help
  116. As a size optimization, busybox normally exits without explicitly
  117. freeing dynamically allocated memory or closing files. This saves
  118. space since the OS will clean up for us, but it can confuse debuggers
  119. like valgrind, which report tons of memory and resource leaks.
  120. Don't enable this unless you have a really good reason to clean
  121. things up manually.
  122. config BUSYBOX_FEATURE_PIDFILE
  123. bool "Support writing pidfiles"
  124. default n
  125. help
  126. This option makes some applets (e.g. crond, syslogd, inetd) write
  127. a pidfile in /var/run. Some applications rely on them.
  128. config BUSYBOX_FEATURE_SUID
  129. bool "Support for SUID/SGID handling"
  130. default y
  131. help
  132. With this option you can install the busybox binary belonging
  133. to root with the suid bit set, and it will automatically drop
  134. priviledges for applets that don't need root access.
  135. If you are really paranoid and don't want to do this, build two
  136. busybox binaries with different applets in them (and the appropriate
  137. symlinks pointing to each binary), and only set the suid bit on the
  138. one that needs it. The applets currently marked to need the suid bit
  139. are:
  140. crontab, dnsd, findfs, ipcrm, ipcs, login, passwd, ping, su,
  141. traceroute, vlock.
  142. config BUSYBOX_FEATURE_SUID_CONFIG
  143. bool "Runtime SUID/SGID configuration via /etc/busybox.conf"
  144. default n if FEATURE_SUID
  145. depends on BUSYBOX_FEATURE_SUID
  146. help
  147. Allow the SUID / SGID state of an applet to be determined at runtime
  148. by checking /etc/busybox.conf. (This is sort of a poor man's sudo.)
  149. The format of this file is as follows:
  150. <applet> = [Ssx-][Ssx-][x-] (<username>|<uid>).(<groupname>|<gid>)
  151. An example might help:
  152. [SUID]
  153. su = ssx root.0 # applet su can be run by anyone and runs with
  154. # euid=0/egid=0
  155. su = ssx # exactly the same
  156. mount = sx- root.disk # applet mount can be run by root and members
  157. # of group disk and runs with euid=0
  158. cp = --- # disable applet cp for everyone
  159. The file has to be owned by user root, group root and has to be
  160. writeable only by root:
  161. (chown 0.0 /etc/busybox.conf; chmod 600 /etc/busybox.conf)
  162. The busybox executable has to be owned by user root, group
  163. root and has to be setuid root for this to work:
  164. (chown 0.0 /bin/busybox; chmod 4755 /bin/busybox)
  165. Robert 'sandman' Griebl has more information here:
  166. <url: http://www.softforge.de/bb/suid.html >.
  167. config BUSYBOX_FEATURE_SUID_CONFIG_QUIET
  168. bool "Suppress warning message if /etc/busybox.conf is not readable"
  169. default y
  170. depends on BUSYBOX_FEATURE_SUID_CONFIG
  171. help
  172. /etc/busybox.conf should be readable by the user needing the SUID,
  173. check this option to avoid users to be notified about missing
  174. permissions.
  175. #config BUSYBOX_SELINUX
  176. # bool "Support NSA Security Enhanced Linux"
  177. # default n
  178. # help
  179. # Enable support for SELinux in applets ls, ps, and id. Also provide
  180. # the option of compiling in SELinux applets.
  181. #
  182. # If you do not have a complete SELinux userland installed, this stuff
  183. # will not compile. Go visit
  184. # http://www.nsa.gov/selinux/index.html
  185. # to download the necessary stuff to allow busybox to compile with
  186. # this option enabled. Specifially, libselinux 1.28 or better is
  187. # directly required by busybox. If the installation is located in a
  188. # non-standard directory, provide it by invoking make as follows:
  189. # CFLAGS=-I<libselinux-include-path> \
  190. # LDFLAGS=-L<libselinux-lib-path> \
  191. # make
  192. #
  193. # Most people will leave this set to 'N'.
  194. config BUSYBOX_FEATURE_PREFER_APPLETS
  195. bool "exec prefers applets"
  196. default n
  197. help
  198. This is an experimental option which directs applets about to
  199. call 'exec' to try and find an applicable busybox applet before
  200. searching the PATH. This is typically done by exec'ing
  201. /proc/self/exe.
  202. This may affect shell, find -exec, xargs and similar applets.
  203. They will use applets even if /bin/<applet> -> busybox link
  204. is missing (or is not a link to busybox). However, this causes
  205. problems in chroot jails without mounted /proc and with ps/top
  206. (command name can be shown as 'exe' for applets started this way).
  207. config BUSYBOX_BUSYBOX_EXEC_PATH
  208. string "Path to BusyBox executable"
  209. default "/proc/self/exe"
  210. help
  211. When Busybox applets need to run other busybox applets, BusyBox
  212. sometimes needs to exec() itself. When the /proc filesystem is
  213. mounted, /proc/self/exe always points to the currently running
  214. executable. If you haven't got /proc, set this to wherever you
  215. want to run BusyBox from.
  216. # These are auto-selected by other options
  217. config BUSYBOX_FEATURE_SYSLOG
  218. bool #No description makes it a hidden option
  219. default n
  220. #help
  221. # This option is auto-selected when you select any applet which may
  222. # send its output to syslog. You do not need to select it manually.
  223. config BUSYBOX_FEATURE_HAVE_RPC
  224. bool #No description makes it a hidden option
  225. default n
  226. #help
  227. # This is automatically selected if any of enabled applets need it.
  228. # You do not need to select it manually.
  229. endmenu
  230. menu 'Build Options'
  231. #config BUSYBOX_STATIC
  232. # bool "Build BusyBox as a static binary (no shared libs)"
  233. # default n
  234. # help
  235. # If you want to build a static BusyBox binary, which does not
  236. # use or require any shared libraries, then enable this option.
  237. # This can cause BusyBox to be considerably larger, so you should
  238. # leave this option false unless you have a good reason (i.e.
  239. # your target platform does not support shared libraries, or
  240. # you are building an initrd which doesn't need anything but
  241. # BusyBox, etc).
  242. #
  243. # Most people will leave this set to 'N'.
  244. #
  245. #config BUSYBOX_PIE
  246. # bool "Build BusyBox as a position independent executable"
  247. # default n
  248. # depends on !BUSYBOX_STATIC
  249. # help
  250. # (TODO: what is it and why/when is it useful?)
  251. # Most people will leave this set to 'N'.
  252. #
  253. #config BUSYBOX_NOMMU
  254. # bool "Force NOMMU build"
  255. # default n
  256. # help
  257. # Busybox tries to detect whether architecture it is being
  258. # built against supports MMU or not. If this detection fails,
  259. # or if you want to build NOMMU version of busybox for testing,
  260. # you may force NOMMU build here.
  261. #
  262. # Most people will leave this set to 'N'.
  263. # PIE can be made to work with BUILD_LIBBUSYBOX, but currently
  264. # build system does not support that
  265. #config BUSYBOX_BUILD_LIBBUSYBOX
  266. # bool "Build shared libbusybox"
  267. # default n
  268. # depends on !BUSYBOX_FEATURE_PREFER_APPLETS && !BUSYBOX_PIE && !BUSYBOX_STATIC
  269. # help
  270. # Build a shared library libbusybox.so.N.N.N which contains all
  271. # busybox code.
  272. #
  273. # This feature allows every applet to be built as a tiny
  274. # separate executable. Enabling it for "one big busybox binary"
  275. # approach serves no purpose and increases code size.
  276. # You should almost certainly say "no" to this.
  277. ### config FEATURE_FULL_LIBBUSYBOX
  278. ### bool "Feature-complete libbusybox"
  279. ### default n if !FEATURE_SHARED_BUSYBOX
  280. ### depends on BUSYBOX_BUILD_LIBBUSYBOX
  281. ### help
  282. ### Build a libbusybox with the complete feature-set, disregarding
  283. ### the actually selected config.
  284. ###
  285. ### Normally, libbusybox will only contain the features which are
  286. ### used by busybox itself. If you plan to write a separate
  287. ### standalone application which uses libbusybox say 'Y'.
  288. ###
  289. ### Note: libbusybox is GPL, not LGPL, and exports no stable API that
  290. ### might act as a copyright barrier. We can and will modify the
  291. ### exported function set between releases (even minor version number
  292. ### changes), and happily break out-of-tree features.
  293. ###
  294. ### Say 'N' if in doubt.
  295. #config BUSYBOX_FEATURE_INDIVIDUAL
  296. # bool "Produce a binary for each applet, linked against libbusybox"
  297. # default y
  298. # depends on BUSYBOX_BUILD_LIBBUSYBOX
  299. # help
  300. # If your CPU architecture doesn't allow for sharing text/rodata
  301. # sections of running binaries, but allows for runtime dynamic
  302. # libraries, this option will allow you to reduce memory footprint
  303. # when you have many different applets running at once.
  304. #
  305. # If your CPU architecture allows for sharing text/rodata,
  306. # having single binary is more optimal.
  307. #
  308. # Each applet will be a tiny program, dynamically linked
  309. # against libbusybox.so.N.N.N.
  310. #
  311. # You need to have a working dynamic linker.
  312. #config BUSYBOX_FEATURE_SHARED_BUSYBOX
  313. # bool "Produce additional busybox binary linked against libbusybox"
  314. # default y
  315. # depends on BUSYBOX_BUILD_LIBBUSYBOX
  316. # help
  317. # Build busybox, dynamically linked against libbusybox.so.N.N.N.
  318. #
  319. # You need to have a working dynamic linker.
  320. ### config BUILD_AT_ONCE
  321. ### bool "Compile all sources at once"
  322. ### default n
  323. ### help
  324. ### Normally each source-file is compiled with one invocation of
  325. ### the compiler.
  326. ### If you set this option, all sources are compiled at once.
  327. ### This gives the compiler more opportunities to optimize which can
  328. ### result in smaller and/or faster binaries.
  329. ###
  330. ### Setting this option will consume alot of memory, e.g. if you
  331. ### enable all applets with all features, gcc uses more than 300MB
  332. ### RAM during compilation of busybox.
  333. ###
  334. ### This option is most likely only beneficial for newer compilers
  335. ### such as gcc-4.1 and above.
  336. ###
  337. ### Say 'N' unless you know what you are doing.
  338. config BUSYBOX_LFS
  339. bool "Build with Large File Support (for accessing files > 2 GB)"
  340. default y
  341. select BUSYBOX_FDISK_SUPPORT_LARGE_DISKS
  342. help
  343. If you want to build BusyBox with large file support, then enable
  344. this option. This will have no effect if your kernel or your C
  345. library lacks large file support for large files. Some of the
  346. programs that can benefit from large file support include dd, gzip,
  347. cp, mount, tar, and many others. If you want to access files larger
  348. than 2 Gigabytes, enable this option. Otherwise, leave it set to 'N'.
  349. config BUSYBOX_CROSS_COMPILER_PREFIX
  350. string "Cross Compiler prefix"
  351. default ""
  352. help
  353. If you want to build BusyBox with a cross compiler, then you
  354. will need to set this to the cross-compiler prefix, for example,
  355. "i386-uclibc-".
  356. Note that CROSS_COMPILE environment variable or
  357. "make CROSS_COMPILE=xxx ..." will override this selection.
  358. Native builds leave this empty.
  359. endmenu
  360. menu 'Debugging Options'
  361. config BUSYBOX_DEBUG
  362. bool "Build BusyBox with extra Debugging symbols"
  363. default n
  364. help
  365. Say Y here if you wish to examine BusyBox internals while applets are
  366. running. This increases the size of the binary considerably, and
  367. should only be used when doing development. If you are doing
  368. development and want to debug BusyBox, answer Y.
  369. Most people should answer N.
  370. config BUSYBOX_DEBUG_PESSIMIZE
  371. bool "Disable compiler optimizations"
  372. default n
  373. depends on BUSYBOX_DEBUG
  374. help
  375. The compiler's optimization of source code can eliminate and reorder
  376. code, resulting in an executable that's hard to understand when
  377. stepping through it with a debugger. This switches it off, resulting
  378. in a much bigger executable that more closely matches the source
  379. code.
  380. # triggers problems on cris with __attribute__((packed))
  381. #config BUSYBOX_WERROR
  382. # bool "Abort compilation on any warning"
  383. # default n
  384. # help
  385. # Selecting this will add -Werror to gcc command line.
  386. #
  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. # disable, gcc 4.4.0 problems
  513. #source package/busybox/config/runit/Config.in
  514. source package/busybox/config/selinux/Config.in
  515. source package/busybox/config/shell/Config.in
  516. source package/busybox/config/sysklogd/Config.in