aboutsummaryrefslogtreecommitdiff
path: root/Config.in
diff options
context:
space:
mode:
authorRon Yorston <rmy@pobox.com>2017-07-29 09:55:08 +0100
committerRon Yorston <rmy@pobox.com>2017-07-29 09:55:08 +0100
commit86d60bb0ceb277e500a8daabd995bc713bbdadc9 (patch)
tree3e439f92d5a3fec2546d526579cc85e98f066e40 /Config.in
parentb30c60a9786a1608211a96755996bd6c02951a27 (diff)
parent69be994de69d794f038f10a3e7a67519b2006581 (diff)
downloadbusybox-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.in96
1 files changed, 46 insertions, 50 deletions
diff --git a/Config.in b/Config.in
index 2342d8467..e131dafaf 100644
--- a/Config.in
+++ b/Config.in
@@ -3,7 +3,7 @@
3# see scripts/kbuild/config-language.txt. 3# see scripts/kbuild/config-language.txt.
4# 4#
5 5
6mainmenu "BusyBox Configuration" 6mainmenu "Configuration"
7 7
8config HAVE_DOT_CONFIG 8config HAVE_DOT_CONFIG
9 bool 9 bool
@@ -23,7 +23,7 @@ config PLATFORM_MINGW32
23 23
24endchoice 24endchoice
25 25
26menu "Busybox Settings" 26menu "Settings"
27 27
28config DESKTOP 28config 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
90config FEATURE_COMPRESS_USAGE 88config 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
115config GLOBBING 112config 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
144config FEATURE_DEVPTS 141config 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
322config BUSYBOX_EXEC_PATH 319config 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
332config SELINUX 329config SELINUX
333 bool "Support NSA Security Enhanced Linux" 330 bool "Support NSA Security Enhanced Linux"
@@ -390,21 +387,17 @@ config PLATFORM_LINUX
390comment 'Build Options' 387comment 'Build Options'
391 388
392config STATIC 389config 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
406config PIE 399config 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
504config CROSS_COMPILER_PREFIX 497config 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
616endchoice 609endchoice
617 610
618config PREFIX 611config 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
624comment 'Debugging Options' 617comment 'Debugging Options'
625 618
626config DEBUG 619config 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
648config DEBUG_SANITIZE 644config 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
668config WERROR 664config 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