aboutsummaryrefslogtreecommitdiff
path: root/Config.in
diff options
context:
space:
mode:
authorBernhard Reutner-Fischer <rep.dot.nop@gmail.com>2008-07-22 18:27:53 +0000
committerBernhard Reutner-Fischer <rep.dot.nop@gmail.com>2008-07-22 18:27:53 +0000
commit3e8669f3599c05797b907faac2d2a5fc8827902c (patch)
tree8a799cfbb3963a1da83b635df90638143b5bd078 /Config.in
parent08d120e6e1242498b8e5ca92870a362bb1c64c85 (diff)
downloadbusybox-w32-3e8669f3599c05797b907faac2d2a5fc8827902c.tar.gz
busybox-w32-3e8669f3599c05797b907faac2d2a5fc8827902c.tar.bz2
busybox-w32-3e8669f3599c05797b907faac2d2a5fc8827902c.zip
- wrap overlong lines (Cristian Ionescu-Idbohrn)
- s/\. /. /g;# (me)
Diffstat (limited to 'Config.in')
-rw-r--r--Config.in80
1 files changed, 42 insertions, 38 deletions
diff --git a/Config.in b/Config.in
index 8e55edb57..5ad35ce20 100644
--- a/Config.in
+++ b/Config.in
@@ -40,7 +40,7 @@ choice
40 There are 3 ways BusyBox can handle buffer allocations: 40 There are 3 ways BusyBox can handle buffer allocations:
41 - Use malloc. This costs code size for the call to xmalloc. 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 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. 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 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 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 46 behavior was the only one available for BusyBox versions 0.48 and
@@ -72,8 +72,8 @@ config FEATURE_VERBOSE_USAGE
72 select SHOW_USAGE 72 select SHOW_USAGE
73 help 73 help
74 All BusyBox applets will show more verbose help messages when 74 All BusyBox applets will show more verbose help messages when
75 busybox is invoked with --help. This will add a lot of text to the 75 busybox is invoked with --help. This will add a lot of text to the
76 busybox binary. In the default configuration, this will add about 76 busybox binary. In the default configuration, this will add about
77 13k, but it can add much more depending on your configuration. 77 13k, but it can add much more depending on your configuration.
78 78
79config FEATURE_COMPRESS_USAGE 79config FEATURE_COMPRESS_USAGE
@@ -86,15 +86,15 @@ config FEATURE_COMPRESS_USAGE
86 86
87 If you have a really tiny busybox with few applets enabled (and 87 If you have a really tiny busybox with few applets enabled (and
88 bunzip2 isn't one of them), the overhead of the decompressor might 88 bunzip2 isn't one of them), the overhead of the decompressor might
89 be noticeable. Also, if you run executables directly from ROM 89 be noticeable. Also, if you run executables directly from ROM
90 and have very little memory, this might not be a win. Otherwise, 90 and have very little memory, this might not be a win. Otherwise,
91 you probably want this. 91 you probably want this.
92 92
93config FEATURE_INSTALLER 93config FEATURE_INSTALLER
94 bool "Support --install [-s] to install applet links at runtime" 94 bool "Support --install [-s] to install applet links at runtime"
95 default n 95 default n
96 help 96 help
97 Enable 'busybox --install [-s]' support. This will allow you to use 97 Enable 'busybox --install [-s]' support. This will allow you to use
98 busybox at runtime to create hard links or symlinks for all the 98 busybox at runtime to create hard links or symlinks for all the
99 applets that are compiled into busybox. 99 applets that are compiled into busybox.
100 100
@@ -118,7 +118,7 @@ config FEATURE_DEVPTS
118 help 118 help
119 Enable if you want BusyBox to use Unix98 PTY support. If enabled, 119 Enable if you want BusyBox to use Unix98 PTY support. If enabled,
120 busybox will use /dev/ptmx for the master side of the pseudoterminal 120 busybox will use /dev/ptmx for the master side of the pseudoterminal
121 and /dev/pts/<number> for the slave side. Otherwise, BSD style 121 and /dev/pts/<number> for the slave side. Otherwise, BSD style
122 /dev/ttyp<number> will be used. To use this option, you should have 122 /dev/ttyp<number> will be used. To use this option, you should have
123 devpts mounted. 123 devpts mounted.
124 124
@@ -127,7 +127,7 @@ config FEATURE_CLEAN_UP
127 default n 127 default n
128 help 128 help
129 As a size optimization, busybox normally exits without explicitly 129 As a size optimization, busybox normally exits without explicitly
130 freeing dynamically allocated memory or closing files. This saves 130 freeing dynamically allocated memory or closing files. This saves
131 space since the OS will clean up for us, but it can confuse debuggers 131 space since the OS will clean up for us, but it can confuse debuggers
132 like valgrind, which report tons of memory and resource leaks. 132 like valgrind, which report tons of memory and resource leaks.
133 133
@@ -152,7 +152,7 @@ config FEATURE_SUID
152 If you're really paranoid and don't want to do this, build two 152 If you're really paranoid and don't want to do this, build two
153 busybox binaries with different applets in them (and the appropriate 153 busybox binaries with different applets in them (and the appropriate
154 symlinks pointing to each binary), and only set the suid bit on the 154 symlinks pointing to each binary), and only set the suid bit on the
155 one that needs it. The applets currently marked to need the suid bit 155 one that needs it. The applets currently marked to need the suid bit
156 are login, passwd, su, ping, traceroute, crontab, dnsd, ipcrm, ipcs, 156 are login, passwd, su, ping, traceroute, crontab, dnsd, ipcrm, ipcs,
157 and vlock. 157 and vlock.
158 158
@@ -162,7 +162,7 @@ config FEATURE_SUID_CONFIG
162 depends on FEATURE_SUID 162 depends on FEATURE_SUID
163 help 163 help
164 Allow the SUID / SGID state of an applet to be determined at runtime 164 Allow the SUID / SGID state of an applet to be determined at runtime
165 by checking /etc/busybox.conf. (This is sort of a poor man's sudo.) 165 by checking /etc/busybox.conf. (This is sort of a poor man's sudo.)
166 The format of this file is as follows: 166 The format of this file is as follows:
167 167
168 <applet> = [Ssx-][Ssx-][x-] (<username>|<uid>).(<groupname>|<gid>) 168 <applet> = [Ssx-][Ssx-][x-] (<username>|<uid>).(<groupname>|<gid>)
@@ -170,11 +170,12 @@ config FEATURE_SUID_CONFIG
170 An example might help: 170 An example might help:
171 171
172 [SUID] 172 [SUID]
173 su = ssx root.0 # applet su can be run by anyone and runs with euid=0/egid=0 173 su = ssx root.0 # applet su can be run by anyone and runs with
174 # euid=0/egid=0
174 su = ssx # exactly the same 175 su = ssx # exactly the same
175 176
176 mount = sx- root.disk # applet mount can be run by root and members of group disk 177 mount = sx- root.disk # applet mount can be run by root and members
177 # and runs with euid=0 178 # of group disk and runs with euid=0
178 179
179 cp = --- # disable applet cp for everyone 180 cp = --- # disable applet cp for everyone
180 181
@@ -193,14 +194,15 @@ config FEATURE_SUID_CONFIG_QUIET
193 default y 194 default y
194 depends on FEATURE_SUID_CONFIG 195 depends on FEATURE_SUID_CONFIG
195 help 196 help
196 /etc/busybox.conf should be readable by the user needing the SUID, check 197 /etc/busybox.conf should be readable by the user needing the SUID,
197 this option to avoid users to be notified about missing permissions. 198 check this option to avoid users to be notified about missing
199 permissions.
198 200
199config SELINUX 201config SELINUX
200 bool "Support NSA Security Enhanced Linux" 202 bool "Support NSA Security Enhanced Linux"
201 default n 203 default n
202 help 204 help
203 Enable support for SELinux in applets ls, ps, and id. Also provide 205 Enable support for SELinux in applets ls, ps, and id. Also provide
204 the option of compiling in SELinux applets. 206 the option of compiling in SELinux applets.
205 207
206 If you do not have a complete SELinux userland installed, this stuff 208 If you do not have a complete SELinux userland installed, this stuff
@@ -235,9 +237,9 @@ config BUSYBOX_EXEC_PATH
235 default "/proc/self/exe" 237 default "/proc/self/exe"
236 help 238 help
237 When Busybox applets need to run other busybox applets, BusyBox 239 When Busybox applets need to run other busybox applets, BusyBox
238 sometimes needs to exec() itself. When the /proc filesystem is 240 sometimes needs to exec() itself. When the /proc filesystem is
239 mounted, /proc/self/exe always points to the currently running 241 mounted, /proc/self/exe always points to the currently running
240 executable. If you haven't got /proc, set this to wherever you 242 executable. If you haven't got /proc, set this to wherever you
241 want to run BusyBox from. 243 want to run BusyBox from.
242 244
243# These are auto-selected by other options 245# These are auto-selected by other options
@@ -304,7 +306,7 @@ config BUILD_LIBBUSYBOX
304 busybox code. 306 busybox code.
305 307
306 This feature allows every applet to be built as a tiny 308 This feature allows every applet to be built as a tiny
307 separate executable. Enabling it for "one big busybox binary" 309 separate executable. Enabling it for "one big busybox binary"
308 approach serves no purpose and increases code size. 310 approach serves no purpose and increases code size.
309 You should almost certainly say "no" to this. 311 You should almost certainly say "no" to this.
310 312
@@ -321,7 +323,7 @@ config BUILD_LIBBUSYBOX
321### standalone application which uses libbusybox say 'Y'. 323### standalone application which uses libbusybox say 'Y'.
322### 324###
323### Note: libbusybox is GPL, not LGPL, and exports no stable API that 325### Note: libbusybox is GPL, not LGPL, and exports no stable API that
324### might act as a copyright barrier. We can and will modify the 326### might act as a copyright barrier. We can and will modify the
325### exported function set between releases (even minor version number 327### exported function set between releases (even minor version number
326### changes), and happily break out-of-tree features. 328### changes), and happily break out-of-tree features.
327### 329###
@@ -379,11 +381,11 @@ config LFS
379 select FDISK_SUPPORT_LARGE_DISKS 381 select FDISK_SUPPORT_LARGE_DISKS
380 help 382 help
381 If you want to build BusyBox with large file support, then enable 383 If you want to build BusyBox with large file support, then enable
382 this option. This will have no effect if your kernel or your C 384 this option. This will have no effect if your kernel or your C
383 library lacks large file support for large files. Some of the 385 library lacks large file support for large files. Some of the
384 programs that can benefit from large file support include dd, gzip, 386 programs that can benefit from large file support include dd, gzip,
385 cp, mount, tar, and many others. If you want to access files larger 387 cp, mount, tar, and many others. If you want to access files larger
386 than 2 Gigabytes, enable this option. Otherwise, leave it set to 'N'. 388 than 2 Gigabytes, enable this option. Otherwise, leave it set to 'N'.
387 389
388config CROSS_COMPILER_PREFIX 390config CROSS_COMPILER_PREFIX
389 string "Cross Compiler prefix" 391 string "Cross Compiler prefix"
@@ -404,8 +406,8 @@ config DEBUG
404 default n 406 default n
405 help 407 help
406 Say Y here if you wish to examine BusyBox internals while applets are 408 Say Y here if you wish to examine BusyBox internals while applets are
407 running. This increases the size of the binary considerably, and 409 running. This increases the size of the binary considerably, and
408 should only be used when doing development. If you are doing 410 should only be used when doing development. If you are doing
409 development and want to debug BusyBox, answer Y. 411 development and want to debug BusyBox, answer Y.
410 412
411 Most people should answer N. 413 Most people should answer N.
@@ -417,7 +419,7 @@ config DEBUG_PESSIMIZE
417 help 419 help
418 The compiler's optimization of source code can eliminate and reorder 420 The compiler's optimization of source code can eliminate and reorder
419 code, resulting in an executable that's hard to understand when 421 code, resulting in an executable that's hard to understand when
420 stepping through it with a debugger. This switches it off, resulting 422 stepping through it with a debugger. This switches it off, resulting
421 in a much bigger executable that more closely matches the source 423 in a much bigger executable that more closely matches the source
422 code. 424 code.
423 425
@@ -434,27 +436,28 @@ choice
434 default NO_DEBUG_LIB 436 default NO_DEBUG_LIB
435 help 437 help
436 Using an additional debugging library will make BusyBox become 438 Using an additional debugging library will make BusyBox become
437 considerable larger and will cause it to run more slowly. You 439 considerable larger and will cause it to run more slowly. You
438 should always leave this option disabled for production use. 440 should always leave this option disabled for production use.
439 441
440 dmalloc support: 442 dmalloc support:
441 ---------------- 443 ----------------
442 This enables compiling with dmalloc ( http://dmalloc.com/ ) 444 This enables compiling with dmalloc ( http://dmalloc.com/ )
443 which is an excellent public domain mem leak and malloc problem 445 which is an excellent public domain mem leak and malloc problem
444 detector. To enable dmalloc, before running busybox you will 446 detector. To enable dmalloc, before running busybox you will
445 want to properly set your environment, for example: 447 want to properly set your environment, for example:
446 export DMALLOC_OPTIONS=debug=0x34f47d83,inter=100,log=logfile 448 export DMALLOC_OPTIONS=debug=0x34f47d83,inter=100,log=logfile
447 The 'debug=' value is generated using the following command 449 The 'debug=' value is generated using the following command
448 dmalloc -p log-stats -p log-non-free -p log-bad-space -p log-elapsed-time \ 450 dmalloc -p log-stats -p log-non-free -p log-bad-space \
449 -p check-fence -p check-heap -p check-lists -p check-blank \ 451 -p log-elapsed-time -p check-fence -p check-heap \
450 -p check-funcs -p realloc-copy -p allow-free-null 452 -p check-lists -p check-blank -p check-funcs -p realloc-copy \
453 -p allow-free-null
451 454
452 Electric-fence support: 455 Electric-fence support:
453 ----------------------- 456 -----------------------
454 This enables compiling with Electric-fence support. Electric 457 This enables compiling with Electric-fence support. Electric
455 fence is another very useful malloc debugging library which uses 458 fence is another very useful malloc debugging library which uses
456 your computer's virtual memory hardware to detect illegal memory 459 your computer's virtual memory hardware to detect illegal memory
457 accesses. This support will make BusyBox be considerable larger 460 accesses. This support will make BusyBox be considerable larger
458 and run slower, so you should leave this option disabled unless 461 and run slower, so you should leave this option disabled unless
459 you are hunting a hard to find memory problem. 462 you are hunting a hard to find memory problem.
460 463
@@ -476,7 +479,7 @@ config INCLUDE_SUSv2
476 help 479 help
477 This option will enable backwards compatibility with SuSv2, 480 This option will enable backwards compatibility with SuSv2,
478 specifically, old-style numeric options ('command -1 <file>') 481 specifically, old-style numeric options ('command -1 <file>')
479 will be supported in head, tail, and fold. (Note: should 482 will be supported in head, tail, and fold. (Note: should
480 affect renice too.) 483 affect renice too.)
481 484
482config PARSE 485config PARSE
@@ -509,8 +512,8 @@ config INSTALL_APPLET_SYMLINKS
509config INSTALL_APPLET_HARDLINKS 512config INSTALL_APPLET_HARDLINKS
510 bool "as hard-links" 513 bool "as hard-links"
511 help 514 help
512 Install applets as hard-links to the busybox binary. This might count 515 Install applets as hard-links to the busybox binary. This might
513 on a filesystem with few inodes. 516 count on a filesystem with few inodes.
514 517
515config INSTALL_APPLET_SCRIPT_WRAPPERS 518config INSTALL_APPLET_SCRIPT_WRAPPERS
516 bool "as script wrappers" 519 bool "as script wrappers"
@@ -546,7 +549,8 @@ config INSTALL_SH_APPLET_HARDLINK
546config INSTALL_SH_APPLET_SCRIPT_WRAPPER 549config INSTALL_SH_APPLET_SCRIPT_WRAPPER
547 bool "as script wrapper" 550 bool "as script wrapper"
548 help 551 help
549 Install /bin/sh applet as script wrapper that call the busybox binary. 552 Install /bin/sh applet as script wrapper that call the busybox
553 binary.
550 554
551endchoice 555endchoice
552 556