diff options
author | Ron Yorston <rmy@pobox.com> | 2017-07-29 09:55:08 +0100 |
---|---|---|
committer | Ron Yorston <rmy@pobox.com> | 2017-07-29 09:55:08 +0100 |
commit | 86d60bb0ceb277e500a8daabd995bc713bbdadc9 (patch) | |
tree | 3e439f92d5a3fec2546d526579cc85e98f066e40 /Config.in | |
parent | b30c60a9786a1608211a96755996bd6c02951a27 (diff) | |
parent | 69be994de69d794f038f10a3e7a67519b2006581 (diff) | |
download | busybox-w32-86d60bb0ceb277e500a8daabd995bc713bbdadc9.tar.gz busybox-w32-86d60bb0ceb277e500a8daabd995bc713bbdadc9.tar.bz2 busybox-w32-86d60bb0ceb277e500a8daabd995bc713bbdadc9.zip |
Merge branch 'busybox' into merge
Diffstat (limited to 'Config.in')
-rw-r--r-- | Config.in | 96 |
1 files changed, 46 insertions, 50 deletions
@@ -3,7 +3,7 @@ | |||
3 | # see scripts/kbuild/config-language.txt. | 3 | # see scripts/kbuild/config-language.txt. |
4 | # | 4 | # |
5 | 5 | ||
6 | mainmenu "BusyBox Configuration" | 6 | mainmenu "Configuration" |
7 | 7 | ||
8 | config HAVE_DOT_CONFIG | 8 | config HAVE_DOT_CONFIG |
9 | bool | 9 | bool |
@@ -23,7 +23,7 @@ config PLATFORM_MINGW32 | |||
23 | 23 | ||
24 | endchoice | 24 | endchoice |
25 | 25 | ||
26 | menu "Busybox Settings" | 26 | menu "Settings" |
27 | 27 | ||
28 | config DESKTOP | 28 | config DESKTOP |
29 | bool "Enable compatibility for full-blown desktop systems" | 29 | bool "Enable compatibility for full-blown desktop systems" |
@@ -71,7 +71,7 @@ config SHOW_USAGE | |||
71 | bool "Show applet usage messages" | 71 | bool "Show applet usage messages" |
72 | default y | 72 | default y |
73 | help | 73 | help |
74 | Enabling this option, BusyBox applets will show terse help messages | 74 | Enabling this option, applets will show terse help messages |
75 | when invoked with wrong arguments. | 75 | when invoked with wrong arguments. |
76 | If you do not want to show any (helpful) usage message when | 76 | If you do not want to show any (helpful) usage message when |
77 | issuing wrong command syntax, you can say 'N' here, | 77 | issuing wrong command syntax, you can say 'N' here, |
@@ -82,18 +82,16 @@ config FEATURE_VERBOSE_USAGE | |||
82 | default y | 82 | default y |
83 | depends on SHOW_USAGE | 83 | depends on SHOW_USAGE |
84 | help | 84 | help |
85 | All BusyBox applets will show verbose help messages when | 85 | All applets will show verbose help messages when invoked with --help. |
86 | busybox is invoked with --help. This will add a lot of text to the | 86 | This will add a lot of text to the binary. |
87 | busybox binary. In the default configuration, this will add about | ||
88 | 13k, but it can add much more depending on your configuration. | ||
89 | 87 | ||
90 | config FEATURE_COMPRESS_USAGE | 88 | config FEATURE_COMPRESS_USAGE |
91 | bool "Store applet usage messages in compressed form" | 89 | bool "Store applet usage messages in compressed form" |
92 | default y | 90 | default y |
93 | depends on SHOW_USAGE | 91 | depends on SHOW_USAGE |
94 | help | 92 | help |
95 | Store usage messages in .bz compressed form, uncompress them | 93 | Store usage messages in .bz2 compressed form, uncompress them |
96 | on-the-fly when <applet> --help is called. | 94 | on-the-fly when "APPLET --help" is run. |
97 | 95 | ||
98 | If you have a really tiny busybox with few applets enabled (and | 96 | If you have a really tiny busybox with few applets enabled (and |
99 | bunzip2 isn't one of them), the overhead of the decompressor might | 97 | bunzip2 isn't one of them), the overhead of the decompressor might |
@@ -105,12 +103,11 @@ config LFS | |||
105 | bool "Support files > 2 GB" | 103 | bool "Support files > 2 GB" |
106 | default y | 104 | default y |
107 | help | 105 | help |
108 | If you want to build BusyBox with large file support, then enable | 106 | If you need to work with large files, enable this option. |
109 | this option. This will have no effect if your kernel or your C | 107 | This will have no effect if your kernel or your C |
110 | library lacks large file support for large files. Some of the | 108 | library lacks large file support for large files. Some of the |
111 | programs that can benefit from large file support include dd, gzip, | 109 | programs that can benefit from large file support include dd, gzip, |
112 | cp, mount, tar, and many others. If you want to access files larger | 110 | cp, mount, tar. |
113 | than 2 Gigabytes, enable this option. | ||
114 | 111 | ||
115 | config GLOBBING | 112 | config GLOBBING |
116 | bool "Allow busybox.exe to expand wildcards" | 113 | bool "Allow busybox.exe to expand wildcards" |
@@ -138,14 +135,14 @@ config PAM | |||
138 | bool "Support PAM (Pluggable Authentication Modules)" | 135 | bool "Support PAM (Pluggable Authentication Modules)" |
139 | default n | 136 | default n |
140 | help | 137 | help |
141 | Use PAM in some busybox applets (currently login and httpd) instead | 138 | Use PAM in some applets (currently login and httpd) instead |
142 | of direct access to password database. | 139 | of direct access to password database. |
143 | 140 | ||
144 | config FEATURE_DEVPTS | 141 | config FEATURE_DEVPTS |
145 | bool "Use the devpts filesystem for Unix98 PTYs" | 142 | bool "Use the devpts filesystem for Unix98 PTYs" |
146 | default y | 143 | default y |
147 | help | 144 | help |
148 | Enable if you want BusyBox to use Unix98 PTY support. If enabled, | 145 | Enable if you want to use Unix98 PTY support. If enabled, |
149 | busybox will use /dev/ptmx for the master side of the pseudoterminal | 146 | busybox will use /dev/ptmx for the master side of the pseudoterminal |
150 | and /dev/pts/<number> for the slave side. Otherwise, BSD style | 147 | and /dev/pts/<number> for the slave side. Otherwise, BSD style |
151 | /dev/ttyp<number> will be used. To use this option, you should have | 148 | /dev/ttyp<number> will be used. To use this option, you should have |
@@ -193,9 +190,9 @@ config BUSYBOX | |||
193 | bool "Include busybox applet" | 190 | bool "Include busybox applet" |
194 | default y | 191 | default y |
195 | help | 192 | help |
196 | The busybox applet provides general help regarding busybox and | 193 | The busybox applet provides general help message and allows |
197 | allows the included applets to be listed. It's also required | 194 | the included applets to be listed. It also provides |
198 | if applet links are to be installed at runtime. If you unselect | 195 | optional --install command to create applet links. If you unselect |
199 | this option, running busybox without any arguments will give | 196 | this option, running busybox without any arguments will give |
200 | just a cryptic error message: | 197 | just a cryptic error message: |
201 | 198 | ||
@@ -217,7 +214,7 @@ config INSTALL_NO_USR | |||
217 | bool "Don't use /usr" | 214 | bool "Don't use /usr" |
218 | default n | 215 | default n |
219 | help | 216 | help |
220 | Disable use of /usr. busybox --install and "make install" | 217 | Disable use of /usr. "busybox --install" and "make install" |
221 | will install applets only to /bin and /sbin, | 218 | will install applets only to /bin and /sbin, |
222 | never to /usr/bin or /usr/sbin. | 219 | never to /usr/bin or /usr/sbin. |
223 | 220 | ||
@@ -230,11 +227,11 @@ config FEATURE_SUID | |||
230 | root-level operations even when run by ordinary users | 227 | root-level operations even when run by ordinary users |
231 | (for example, mounting of user mounts in fstab needs this). | 228 | (for example, mounting of user mounts in fstab needs this). |
232 | 229 | ||
233 | With this option enabled, Busybox drops privileges for applets | 230 | With this option enabled, busybox drops privileges for applets |
234 | that don't need root access, before entering their main() function. | 231 | that don't need root access, before entering their main() function. |
235 | 232 | ||
236 | If you are really paranoid and don't want even initial busybox code | 233 | If you are really paranoid and don't want even initial busybox code |
237 | to run under root for evey applet, build two busybox binaries with | 234 | to run under root for every applet, build two busybox binaries with |
238 | different applets in them (and the appropriate symlinks pointing | 235 | different applets in them (and the appropriate symlinks pointing |
239 | to each binary), and only set the suid bit on the one that needs it. | 236 | to each binary), and only set the suid bit on the one that needs it. |
240 | 237 | ||
@@ -320,14 +317,14 @@ config FEATURE_PREFER_APPLETS | |||
320 | (command name can be shown as 'exe' for applets started this way). | 317 | (command name can be shown as 'exe' for applets started this way). |
321 | 318 | ||
322 | config BUSYBOX_EXEC_PATH | 319 | config BUSYBOX_EXEC_PATH |
323 | string "Path to BusyBox executable" | 320 | string "Path to busybox executable" |
324 | default "/proc/self/exe" | 321 | default "/proc/self/exe" |
325 | help | 322 | help |
326 | When Busybox applets need to run other busybox applets, BusyBox | 323 | When applets need to run other applets, busybox |
327 | sometimes needs to exec() itself. When the /proc filesystem is | 324 | sometimes needs to exec() itself. When the /proc filesystem is |
328 | mounted, /proc/self/exe always points to the currently running | 325 | mounted, /proc/self/exe always points to the currently running |
329 | executable. If you haven't got /proc, set this to wherever you | 326 | executable. If you haven't got /proc, set this to wherever you |
330 | want to run BusyBox from. | 327 | want to run busybox from. |
331 | 328 | ||
332 | config SELINUX | 329 | config SELINUX |
333 | bool "Support NSA Security Enhanced Linux" | 330 | bool "Support NSA Security Enhanced Linux" |
@@ -390,21 +387,17 @@ config PLATFORM_LINUX | |||
390 | comment 'Build Options' | 387 | comment 'Build Options' |
391 | 388 | ||
392 | config STATIC | 389 | config STATIC |
393 | bool "Build BusyBox as a static binary (no shared libs)" | 390 | bool "Build static binary (no shared libs)" |
394 | default n | 391 | default n |
395 | help | 392 | help |
396 | If you want to build a static BusyBox binary, which does not | 393 | If you want to build a static binary, which does not use |
397 | use or require any shared libraries, then enable this option. | 394 | or require any shared libraries, enable this option. |
398 | This can cause BusyBox to be considerably larger, so you should | 395 | Static binaries are larger, but do not require functioning |
399 | leave this option false unless you have a good reason (i.e. | 396 | dynamic libraries to be present, which is important if used |
400 | your target platform does not support shared libraries, or | 397 | as a system rescue tool. |
401 | you are building an initrd which doesn't need anything but | ||
402 | BusyBox, etc). | ||
403 | |||
404 | Most people will leave this set to 'N'. | ||
405 | 398 | ||
406 | config PIE | 399 | config PIE |
407 | bool "Build BusyBox as a position independent executable" | 400 | bool "Build position independent executable" |
408 | default n | 401 | default n |
409 | depends on !STATIC | 402 | depends on !STATIC |
410 | help | 403 | help |
@@ -502,10 +495,10 @@ config FEATURE_SHARED_BUSYBOX | |||
502 | ### Say 'N' unless you know what you are doing. | 495 | ### Say 'N' unless you know what you are doing. |
503 | 496 | ||
504 | config CROSS_COMPILER_PREFIX | 497 | config CROSS_COMPILER_PREFIX |
505 | string "Cross Compiler prefix" | 498 | string "Cross compiler prefix" |
506 | default "" | 499 | default "" |
507 | help | 500 | help |
508 | If you want to build BusyBox with a cross compiler, then you | 501 | If you want to build busybox with a cross compiler, then you |
509 | will need to set this to the cross-compiler prefix, for example, | 502 | will need to set this to the cross-compiler prefix, for example, |
510 | "i386-uclibc-". | 503 | "i386-uclibc-". |
511 | 504 | ||
@@ -518,11 +511,11 @@ config SYSROOT | |||
518 | string "Path to sysroot" | 511 | string "Path to sysroot" |
519 | default "" | 512 | default "" |
520 | help | 513 | help |
521 | If you want to build BusyBox with a cross compiler, then you | 514 | If you want to build busybox with a cross compiler, then you |
522 | might also need to specify where /usr/include and /usr/lib | 515 | might also need to specify where /usr/include and /usr/lib |
523 | will be found. | 516 | will be found. |
524 | 517 | ||
525 | For example, BusyBox can be built against an installed | 518 | For example, busybox can be built against an installed |
526 | Android NDK, platform version 9, for ARM ABI with | 519 | Android NDK, platform version 9, for ARM ABI with |
527 | 520 | ||
528 | CONFIG_SYSROOT=/opt/android-ndk/platforms/android-9/arch-arm | 521 | CONFIG_SYSROOT=/opt/android-ndk/platforms/android-9/arch-arm |
@@ -616,21 +609,22 @@ config INSTALL_SH_APPLET_SCRIPT_WRAPPER | |||
616 | endchoice | 609 | endchoice |
617 | 610 | ||
618 | config PREFIX | 611 | config PREFIX |
619 | string "BusyBox installation prefix" | 612 | string "Destination path for 'make install'" |
620 | default "./_install" | 613 | default "./_install" |
621 | help | 614 | help |
622 | Define your directory to install BusyBox files/subdirs in. | 615 | Where "make install" should install busybox binary and links. |
623 | 616 | ||
624 | comment 'Debugging Options' | 617 | comment 'Debugging Options' |
625 | 618 | ||
626 | config DEBUG | 619 | config DEBUG |
627 | bool "Build BusyBox with extra Debugging symbols" | 620 | bool "Build with debug information" |
628 | default n | 621 | default n |
629 | help | 622 | help |
630 | Say Y here if you wish to examine BusyBox internals while applets are | 623 | Say Y here to compile with debug information. |
631 | running. This increases the size of the binary considerably, and | 624 | This increases the size of the binary considerably, and |
632 | should only be used when doing development. If you are doing | 625 | should only be used when doing development. |
633 | development and want to debug BusyBox, answer Y. | 626 | |
627 | This adds -g option to gcc command line. | ||
634 | 628 | ||
635 | Most people should answer N. | 629 | Most people should answer N. |
636 | 630 | ||
@@ -645,6 +639,8 @@ config DEBUG_PESSIMIZE | |||
645 | in a much bigger executable that more closely matches the source | 639 | in a much bigger executable that more closely matches the source |
646 | code. | 640 | code. |
647 | 641 | ||
642 | This replaces -Os/-O2 with -O0 in gcc command line. | ||
643 | |||
648 | config DEBUG_SANITIZE | 644 | config DEBUG_SANITIZE |
649 | bool "Enable runtime sanitizers (ASAN/LSAN/USAN/etc...)" | 645 | bool "Enable runtime sanitizers (ASAN/LSAN/USAN/etc...)" |
650 | default n | 646 | default n |
@@ -662,7 +658,7 @@ config UNIT_TEST | |||
662 | default n | 658 | default n |
663 | help | 659 | help |
664 | Say Y here if you want to build unit tests (both the framework and | 660 | Say Y here if you want to build unit tests (both the framework and |
665 | test cases) as a Busybox applet. This results in bigger code, so you | 661 | test cases) as an applet. This results in bigger code, so you |
666 | probably don't want this option in production builds. | 662 | probably don't want this option in production builds. |
667 | 663 | ||
668 | config WERROR | 664 | config WERROR |
@@ -677,8 +673,8 @@ choice | |||
677 | prompt "Additional debugging library" | 673 | prompt "Additional debugging library" |
678 | default NO_DEBUG_LIB | 674 | default NO_DEBUG_LIB |
679 | help | 675 | help |
680 | Using an additional debugging library will make BusyBox become | 676 | Using an additional debugging library will make busybox become |
681 | considerable larger and will cause it to run more slowly. You | 677 | considerably larger and will cause it to run more slowly. You |
682 | should always leave this option disabled for production use. | 678 | should always leave this option disabled for production use. |
683 | 679 | ||
684 | dmalloc support: | 680 | dmalloc support: |
@@ -699,7 +695,7 @@ choice | |||
699 | This enables compiling with Electric-fence support. Electric | 695 | This enables compiling with Electric-fence support. Electric |
700 | fence is another very useful malloc debugging library which uses | 696 | fence is another very useful malloc debugging library which uses |
701 | your computer's virtual memory hardware to detect illegal memory | 697 | your computer's virtual memory hardware to detect illegal memory |
702 | accesses. This support will make BusyBox be considerable larger | 698 | accesses. This support will make busybox be considerably larger |
703 | and run slower, so you should leave this option disabled unless | 699 | and run slower, so you should leave this option disabled unless |
704 | you are hunting a hard to find memory problem. | 700 | you are hunting a hard to find memory problem. |
705 | 701 | ||