diff options
author | Bernhard Reutner-Fischer <rep.dot.nop@gmail.com> | 2008-07-22 18:27:53 +0000 |
---|---|---|
committer | Bernhard Reutner-Fischer <rep.dot.nop@gmail.com> | 2008-07-22 18:27:53 +0000 |
commit | 3e8669f3599c05797b907faac2d2a5fc8827902c (patch) | |
tree | 8a799cfbb3963a1da83b635df90638143b5bd078 /Config.in | |
parent | 08d120e6e1242498b8e5ca92870a362bb1c64c85 (diff) | |
download | busybox-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.in | 80 |
1 files changed, 42 insertions, 38 deletions
@@ -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 | ||
79 | config FEATURE_COMPRESS_USAGE | 79 | config 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 | ||
93 | config FEATURE_INSTALLER | 93 | config 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 | ||
199 | config SELINUX | 201 | config 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 | ||
388 | config CROSS_COMPILER_PREFIX | 390 | config 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 | ||
482 | config PARSE | 485 | config PARSE |
@@ -509,8 +512,8 @@ config INSTALL_APPLET_SYMLINKS | |||
509 | config INSTALL_APPLET_HARDLINKS | 512 | config 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 | ||
515 | config INSTALL_APPLET_SCRIPT_WRAPPERS | 518 | config INSTALL_APPLET_SCRIPT_WRAPPERS |
516 | bool "as script wrappers" | 519 | bool "as script wrappers" |
@@ -546,7 +549,8 @@ config INSTALL_SH_APPLET_HARDLINK | |||
546 | config INSTALL_SH_APPLET_SCRIPT_WRAPPER | 549 | config 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 | ||
551 | endchoice | 555 | endchoice |
552 | 556 | ||