- wrap overlong lines (Cristian Ionescu-Idbohrn)

- s/\.  /. /g;# (me)
This commit is contained in:
Bernhard Reutner-Fischer 2008-07-22 18:27:53 +00:00
parent 08d120e6e1
commit 3e8669f359
18 changed files with 236 additions and 220 deletions

View File

@ -40,7 +40,7 @@ choice
There are 3 ways BusyBox can handle buffer allocations: There are 3 ways BusyBox can handle buffer allocations:
- Use malloc. This costs code size for the call to xmalloc. - Use malloc. This costs code size for the call to xmalloc.
- Put them on stack. For some very small machines with limited stack - Put them on stack. For some very small machines with limited stack
space, this can be deadly. For most folks, this works just fine. space, this can be deadly. For most folks, this works just fine.
- Put them in BSS. This works beautifully for computers with a real - Put them in BSS. This works beautifully for computers with a real
MMU (and OS support), but wastes runtime RAM for uCLinux. This MMU (and OS support), but wastes runtime RAM for uCLinux. This
behavior was the only one available for BusyBox versions 0.48 and behavior was the only one available for BusyBox versions 0.48 and
@ -72,8 +72,8 @@ config FEATURE_VERBOSE_USAGE
select SHOW_USAGE select SHOW_USAGE
help help
All BusyBox applets will show more verbose help messages when All BusyBox applets will show more verbose help messages when
busybox is invoked with --help. This will add a lot of text to the busybox is invoked with --help. This will add a lot of text to the
busybox binary. In the default configuration, this will add about busybox binary. In the default configuration, this will add about
13k, but it can add much more depending on your configuration. 13k, but it can add much more depending on your configuration.
config FEATURE_COMPRESS_USAGE config FEATURE_COMPRESS_USAGE
@ -86,15 +86,15 @@ config FEATURE_COMPRESS_USAGE
If you have a really tiny busybox with few applets enabled (and If you have a really tiny busybox with few applets enabled (and
bunzip2 isn't one of them), the overhead of the decompressor might bunzip2 isn't one of them), the overhead of the decompressor might
be noticeable. Also, if you run executables directly from ROM be noticeable. Also, if you run executables directly from ROM
and have very little memory, this might not be a win. Otherwise, and have very little memory, this might not be a win. Otherwise,
you probably want this. you probably want this.
config FEATURE_INSTALLER config FEATURE_INSTALLER
bool "Support --install [-s] to install applet links at runtime" bool "Support --install [-s] to install applet links at runtime"
default n default n
help help
Enable 'busybox --install [-s]' support. This will allow you to use Enable 'busybox --install [-s]' support. This will allow you to use
busybox at runtime to create hard links or symlinks for all the busybox at runtime to create hard links or symlinks for all the
applets that are compiled into busybox. applets that are compiled into busybox.
@ -118,7 +118,7 @@ config FEATURE_DEVPTS
help help
Enable if you want BusyBox to use Unix98 PTY support. If enabled, Enable if you want BusyBox to use Unix98 PTY support. If enabled,
busybox will use /dev/ptmx for the master side of the pseudoterminal busybox will use /dev/ptmx for the master side of the pseudoterminal
and /dev/pts/<number> for the slave side. Otherwise, BSD style and /dev/pts/<number> for the slave side. Otherwise, BSD style
/dev/ttyp<number> will be used. To use this option, you should have /dev/ttyp<number> will be used. To use this option, you should have
devpts mounted. devpts mounted.
@ -127,7 +127,7 @@ config FEATURE_CLEAN_UP
default n default n
help help
As a size optimization, busybox normally exits without explicitly As a size optimization, busybox normally exits without explicitly
freeing dynamically allocated memory or closing files. This saves freeing dynamically allocated memory or closing files. This saves
space since the OS will clean up for us, but it can confuse debuggers space since the OS will clean up for us, but it can confuse debuggers
like valgrind, which report tons of memory and resource leaks. like valgrind, which report tons of memory and resource leaks.
@ -152,7 +152,7 @@ config FEATURE_SUID
If you're really paranoid and don't want to do this, build two If you're really paranoid and don't want to do this, build two
busybox binaries with different applets in them (and the appropriate busybox binaries with different applets in them (and the appropriate
symlinks pointing to each binary), and only set the suid bit on the symlinks pointing to each binary), and only set the suid bit on the
one that needs it. The applets currently marked to need the suid bit one that needs it. The applets currently marked to need the suid bit
are login, passwd, su, ping, traceroute, crontab, dnsd, ipcrm, ipcs, are login, passwd, su, ping, traceroute, crontab, dnsd, ipcrm, ipcs,
and vlock. and vlock.
@ -162,7 +162,7 @@ config FEATURE_SUID_CONFIG
depends on FEATURE_SUID depends on FEATURE_SUID
help help
Allow the SUID / SGID state of an applet to be determined at runtime Allow the SUID / SGID state of an applet to be determined at runtime
by checking /etc/busybox.conf. (This is sort of a poor man's sudo.) by checking /etc/busybox.conf. (This is sort of a poor man's sudo.)
The format of this file is as follows: The format of this file is as follows:
<applet> = [Ssx-][Ssx-][x-] (<username>|<uid>).(<groupname>|<gid>) <applet> = [Ssx-][Ssx-][x-] (<username>|<uid>).(<groupname>|<gid>)
@ -170,11 +170,12 @@ config FEATURE_SUID_CONFIG
An example might help: An example might help:
[SUID] [SUID]
su = ssx root.0 # applet su can be run by anyone and runs with euid=0/egid=0 su = ssx root.0 # applet su can be run by anyone and runs with
# euid=0/egid=0
su = ssx # exactly the same su = ssx # exactly the same
mount = sx- root.disk # applet mount can be run by root and members of group disk mount = sx- root.disk # applet mount can be run by root and members
# and runs with euid=0 # of group disk and runs with euid=0
cp = --- # disable applet cp for everyone cp = --- # disable applet cp for everyone
@ -193,14 +194,15 @@ config FEATURE_SUID_CONFIG_QUIET
default y default y
depends on FEATURE_SUID_CONFIG depends on FEATURE_SUID_CONFIG
help help
/etc/busybox.conf should be readable by the user needing the SUID, check /etc/busybox.conf should be readable by the user needing the SUID,
this option to avoid users to be notified about missing permissions. check this option to avoid users to be notified about missing
permissions.
config SELINUX config SELINUX
bool "Support NSA Security Enhanced Linux" bool "Support NSA Security Enhanced Linux"
default n default n
help help
Enable support for SELinux in applets ls, ps, and id. Also provide Enable support for SELinux in applets ls, ps, and id. Also provide
the option of compiling in SELinux applets. the option of compiling in SELinux applets.
If you do not have a complete SELinux userland installed, this stuff If you do not have a complete SELinux userland installed, this stuff
@ -235,9 +237,9 @@ config BUSYBOX_EXEC_PATH
default "/proc/self/exe" default "/proc/self/exe"
help help
When Busybox applets need to run other busybox applets, BusyBox When Busybox applets need to run other busybox applets, BusyBox
sometimes needs to exec() itself. When the /proc filesystem is sometimes needs to exec() itself. When the /proc filesystem is
mounted, /proc/self/exe always points to the currently running mounted, /proc/self/exe always points to the currently running
executable. If you haven't got /proc, set this to wherever you executable. If you haven't got /proc, set this to wherever you
want to run BusyBox from. want to run BusyBox from.
# These are auto-selected by other options # These are auto-selected by other options
@ -304,7 +306,7 @@ config BUILD_LIBBUSYBOX
busybox code. busybox code.
This feature allows every applet to be built as a tiny This feature allows every applet to be built as a tiny
separate executable. Enabling it for "one big busybox binary" separate executable. Enabling it for "one big busybox binary"
approach serves no purpose and increases code size. approach serves no purpose and increases code size.
You should almost certainly say "no" to this. You should almost certainly say "no" to this.
@ -321,7 +323,7 @@ config BUILD_LIBBUSYBOX
### standalone application which uses libbusybox say 'Y'. ### standalone application which uses libbusybox say 'Y'.
### ###
### Note: libbusybox is GPL, not LGPL, and exports no stable API that ### Note: libbusybox is GPL, not LGPL, and exports no stable API that
### might act as a copyright barrier. We can and will modify the ### might act as a copyright barrier. We can and will modify the
### exported function set between releases (even minor version number ### exported function set between releases (even minor version number
### changes), and happily break out-of-tree features. ### changes), and happily break out-of-tree features.
### ###
@ -379,11 +381,11 @@ config LFS
select FDISK_SUPPORT_LARGE_DISKS select FDISK_SUPPORT_LARGE_DISKS
help help
If you want to build BusyBox with large file support, then enable If you want to build BusyBox with large file support, then enable
this option. This will have no effect if your kernel or your C this option. This will have no effect if your kernel or your C
library lacks large file support for large files. Some of the library lacks large file support for large files. Some of the
programs that can benefit from large file support include dd, gzip, programs that can benefit from large file support include dd, gzip,
cp, mount, tar, and many others. If you want to access files larger cp, mount, tar, and many others. If you want to access files larger
than 2 Gigabytes, enable this option. Otherwise, leave it set to 'N'. than 2 Gigabytes, enable this option. Otherwise, leave it set to 'N'.
config CROSS_COMPILER_PREFIX config CROSS_COMPILER_PREFIX
string "Cross Compiler prefix" string "Cross Compiler prefix"
@ -404,8 +406,8 @@ config DEBUG
default n default n
help help
Say Y here if you wish to examine BusyBox internals while applets are Say Y here if you wish to examine BusyBox internals while applets are
running. This increases the size of the binary considerably, and running. This increases the size of the binary considerably, and
should only be used when doing development. If you are doing should only be used when doing development. If you are doing
development and want to debug BusyBox, answer Y. development and want to debug BusyBox, answer Y.
Most people should answer N. Most people should answer N.
@ -417,7 +419,7 @@ config DEBUG_PESSIMIZE
help help
The compiler's optimization of source code can eliminate and reorder The compiler's optimization of source code can eliminate and reorder
code, resulting in an executable that's hard to understand when code, resulting in an executable that's hard to understand when
stepping through it with a debugger. This switches it off, resulting stepping through it with a debugger. This switches it off, resulting
in a much bigger executable that more closely matches the source in a much bigger executable that more closely matches the source
code. code.
@ -434,27 +436,28 @@ choice
default NO_DEBUG_LIB default NO_DEBUG_LIB
help help
Using an additional debugging library will make BusyBox become Using an additional debugging library will make BusyBox become
considerable larger and will cause it to run more slowly. You considerable larger and will cause it to run more slowly. You
should always leave this option disabled for production use. should always leave this option disabled for production use.
dmalloc support: dmalloc support:
---------------- ----------------
This enables compiling with dmalloc ( http://dmalloc.com/ ) This enables compiling with dmalloc ( http://dmalloc.com/ )
which is an excellent public domain mem leak and malloc problem which is an excellent public domain mem leak and malloc problem
detector. To enable dmalloc, before running busybox you will detector. To enable dmalloc, before running busybox you will
want to properly set your environment, for example: want to properly set your environment, for example:
export DMALLOC_OPTIONS=debug=0x34f47d83,inter=100,log=logfile export DMALLOC_OPTIONS=debug=0x34f47d83,inter=100,log=logfile
The 'debug=' value is generated using the following command The 'debug=' value is generated using the following command
dmalloc -p log-stats -p log-non-free -p log-bad-space -p log-elapsed-time \ dmalloc -p log-stats -p log-non-free -p log-bad-space \
-p check-fence -p check-heap -p check-lists -p check-blank \ -p log-elapsed-time -p check-fence -p check-heap \
-p check-funcs -p realloc-copy -p allow-free-null -p check-lists -p check-blank -p check-funcs -p realloc-copy \
-p allow-free-null
Electric-fence support: Electric-fence support:
----------------------- -----------------------
This enables compiling with Electric-fence support. Electric This enables compiling with Electric-fence support. Electric
fence is another very useful malloc debugging library which uses fence is another very useful malloc debugging library which uses
your computer's virtual memory hardware to detect illegal memory your computer's virtual memory hardware to detect illegal memory
accesses. This support will make BusyBox be considerable larger accesses. This support will make BusyBox be considerable larger
and run slower, so you should leave this option disabled unless and run slower, so you should leave this option disabled unless
you are hunting a hard to find memory problem. you are hunting a hard to find memory problem.
@ -476,7 +479,7 @@ config INCLUDE_SUSv2
help help
This option will enable backwards compatibility with SuSv2, This option will enable backwards compatibility with SuSv2,
specifically, old-style numeric options ('command -1 <file>') specifically, old-style numeric options ('command -1 <file>')
will be supported in head, tail, and fold. (Note: should will be supported in head, tail, and fold. (Note: should
affect renice too.) affect renice too.)
config PARSE config PARSE
@ -509,8 +512,8 @@ config INSTALL_APPLET_SYMLINKS
config INSTALL_APPLET_HARDLINKS config INSTALL_APPLET_HARDLINKS
bool "as hard-links" bool "as hard-links"
help help
Install applets as hard-links to the busybox binary. This might count Install applets as hard-links to the busybox binary. This might
on a filesystem with few inodes. count on a filesystem with few inodes.
config INSTALL_APPLET_SCRIPT_WRAPPERS config INSTALL_APPLET_SCRIPT_WRAPPERS
bool "as script wrappers" bool "as script wrappers"
@ -546,7 +549,8 @@ config INSTALL_SH_APPLET_HARDLINK
config INSTALL_SH_APPLET_SCRIPT_WRAPPER config INSTALL_SH_APPLET_SCRIPT_WRAPPER
bool "as script wrapper" bool "as script wrapper"
help help
Install /bin/sh applet as script wrapper that call the busybox binary. Install /bin/sh applet as script wrapper that call the busybox
binary.
endchoice endchoice

View File

@ -10,7 +10,7 @@ config AR
default n default n
help help
ar is an archival utility program used to create, modify, and ar is an archival utility program used to create, modify, and
extract contents from archives. An archive is a single file holding extract contents from archives. An archive is a single file holding
a collection of other files in a structure that makes it possible to a collection of other files in a structure that makes it possible to
retrieve the original individual files (called archive members). retrieve the original individual files (called archive members).
The original files' contents, mode (permissions), timestamp, owner, The original files' contents, mode (permissions), timestamp, owner,
@ -33,8 +33,8 @@ config FEATURE_AR_LONG_FILENAMES
default n default n
depends on AR depends on AR
help help
By default the ar format can only store the first 15 characters of the By default the ar format can only store the first 15 characters of
filename, this option removes that limitation. the filename, this option removes that limitation.
It supports the GNU ar long filename method which moves multiple long It supports the GNU ar long filename method which moves multiple long
filenames into a the data section of a new ar entry. filenames into a the data section of a new ar entry.
@ -43,7 +43,7 @@ config BUNZIP2
default n default n
help help
bunzip2 is a compression utility using the Burrows-Wheeler block bunzip2 is a compression utility using the Burrows-Wheeler block
sorting text compression algorithm, and Huffman coding. Compression sorting text compression algorithm, and Huffman coding. Compression
is generally considerably better than that achieved by more is generally considerably better than that achieved by more
conventional LZ77/LZ78-based compressors, and approaches the conventional LZ77/LZ78-based compressors, and approaches the
performance of the PPM family of statistical compressors. performance of the PPM family of statistical compressors.
@ -56,7 +56,7 @@ config BZIP2
default n default n
help help
bzip2 is a compression utility using the Burrows-Wheeler block bzip2 is a compression utility using the Burrows-Wheeler block
sorting text compression algorithm, and Huffman coding. Compression sorting text compression algorithm, and Huffman coding. Compression
is generally considerably better than that achieved by more is generally considerably better than that achieved by more
conventional LZ77/LZ78-based compressors, and approaches the conventional LZ77/LZ78-based compressors, and approaches the
performance of the PPM family of statistical compressors. performance of the PPM family of statistical compressors.
@ -68,15 +68,15 @@ config CPIO
bool "cpio" bool "cpio"
default n default n
help help
cpio is an archival utility program used to create, modify, and extract cpio is an archival utility program used to create, modify, and
contents from archives. extract contents from archives.
cpio has 110 bytes of overheads for every stored file. cpio has 110 bytes of overheads for every stored file.
This implementation of cpio can extract cpio archives created in the This implementation of cpio can extract cpio archives created in the
"newc" or "crc" format, it cannot create or modify them. "newc" or "crc" format, it cannot create or modify them.
Unless you have a specific application which requires cpio, you should Unless you have a specific application which requires cpio, you
probably say N here. should probably say N here.
config FEATURE_CPIO_O config FEATURE_CPIO_O
bool "Support for archive creation" bool "Support for archive creation"
@ -100,7 +100,8 @@ config DPKG_DEB
bool "dpkg_deb" bool "dpkg_deb"
default n default n
help help
dpkg-deb packs, unpacks and provides information about Debian archives. dpkg-deb packs, unpacks and provides information about Debian
archives.
This implementation of dpkg-deb cannot pack archives. This implementation of dpkg-deb cannot pack archives.
@ -112,9 +113,10 @@ config FEATURE_DPKG_DEB_EXTRACT_ONLY
default n default n
depends on DPKG_DEB depends on DPKG_DEB
help help
This reduces dpkg-deb to the equivalent of "ar -p <deb> data.tar.gz | tar -zx". This reduces dpkg-deb to the equivalent of
However it saves space as none of the extra dpkg-deb, ar or tar options are "ar -p <deb> data.tar.gz | tar -zx". However it saves space as none
needed, they are linked to internally. of the extra dpkg-deb, ar or tar options are needed, they are linked
to internally.
config GUNZIP config GUNZIP
bool "gunzip" bool "gunzip"
@ -240,8 +242,9 @@ config FEATURE_TAR_OLDSUN_COMPATIBILITY
depends on TAR depends on TAR
help help
This option is required to unpack archives created by some old This option is required to unpack archives created by some old
version of Sun's tar (it was calculating checksum using signed arithmetic). version of Sun's tar (it was calculating checksum using signed
It is said to be fixed in newer Sun tar, but "old" tarballs still exist. arithmetic). It is said to be fixed in newer Sun tar, but "old"
tarballs still exist.
config FEATURE_TAR_GNU_EXTENSIONS config FEATURE_TAR_GNU_EXTENSIONS
bool "Support for GNU tar extensions (long filenames)" bool "Support for GNU tar extensions (long filenames)"
@ -281,7 +284,7 @@ config UNLZMA
default n default n
help help
unlzma is a compression utility using the Lempel-Ziv-Markov chain unlzma is a compression utility using the Lempel-Ziv-Markov chain
compression algorithm, and range coding. Compression compression algorithm, and range coding. Compression
is generally considerably better than that achieved by the bzip2 is generally considerably better than that achieved by the bzip2
compressors. compressors.
@ -322,18 +325,19 @@ config FEATURE_DEB_TAR_GZ
help help
This is the default compression method inside the debian ar file. This is the default compression method inside the debian ar file.
If you want compatibility with standard .deb's you should say yes here. If you want compatibility with standard .deb's you should say yes
here.
config FEATURE_DEB_TAR_BZ2 config FEATURE_DEB_TAR_BZ2
bool "bzip2 debian packages" bool "bzip2 debian packages"
default n default n
depends on DPKG || DPKG_DEB depends on DPKG || DPKG_DEB
help help
This allows dpkg and dpkg-deb to extract deb's that are compressed internally This allows dpkg and dpkg-deb to extract deb's that are compressed
with bzip2 instead of gzip. internally with bzip2 instead of gzip.
You only want this if you are creating your own custom debian packages that You only want this if you are creating your own custom debian
use an internal control.tar.bz2 or data.tar.bz2. packages that use an internal control.tar.bz2 or data.tar.bz2.
config FEATURE_DEB_TAR_LZMA config FEATURE_DEB_TAR_LZMA
bool "lzma debian packages" bool "lzma debian packages"

View File

@ -10,7 +10,7 @@ config BASENAME
default n default n
help help
basename is used to strip the directory and suffix from filenames, basename is used to strip the directory and suffix from filenames,
leaving just the filename itself. Enable this option if you wish leaving just the filename itself. Enable this option if you wish
to enable the 'basename' utility. to enable the 'basename' utility.
config CAL config CAL
@ -24,7 +24,7 @@ config CAT
default n default n
help help
cat is used to concatenate files and print them to the standard cat is used to concatenate files and print them to the standard
output. Enable this option if you wish to enable the 'cat' utility. output. Enable this option if you wish to enable the 'cat' utility.
config CATV config CATV
bool "catv" bool "catv"
@ -117,7 +117,8 @@ config FEATURE_DD_SIGNAL_HANDLING
print to standard error the number of records read and written print to standard error the number of records read and written
so far, then to resume copying. so far, then to resume copying.
$ dd if=/dev/zero of=/dev/null& pid=$! $ kill -USR1 $pid; sleep 1; kill $pid $ dd if=/dev/zero of=/dev/null&
$ pid=$! kill -USR1 $pid; sleep 1; kill $pid
10899206+0 records in 10899206+0 records out 10899206+0 records in 10899206+0 records out
config FEATURE_DD_IBS_OBS config FEATURE_DD_IBS_OBS
@ -232,7 +233,7 @@ config EXPR_MATH_SUPPORT_64
default n default n
depends on EXPR depends on EXPR
help help
Enable 64-bit math support in the expr applet. This will make Enable 64-bit math support in the expr applet. This will make
the applet slightly larger, but will allow computation with very the applet slightly larger, but will allow computation with very
large numbers. large numbers.
@ -548,8 +549,8 @@ config FEATURE_SORT_BIG
depends on SORT depends on SORT
help help
Without this, sort only supports -r, -u, and an integer version Without this, sort only supports -r, -u, and an integer version
of -n. Selecting this adds sort keys, floating point support, and of -n. Selecting this adds sort keys, floating point support, and
more. This adds a little over 3k to a nonstatic build on x86. more. This adds a little over 3k to a nonstatic build on x86.
The SuSv3 sort standard is available at: The SuSv3 sort standard is available at:
http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
@ -581,7 +582,7 @@ config FEATURE_STAT_FORMAT
depends on STAT depends on STAT
help help
Without this, stat will not support the '-c format' option where Without this, stat will not support the '-c format' option where
users can pass a custom format string for output. This adds about users can pass a custom format string for output. This adds about
7k to a nonstatic build on amd64. 7k to a nonstatic build on amd64.
config STTY config STTY
@ -642,7 +643,7 @@ config TEST
default n default n
help help
test is used to check file types and compare values, test is used to check file types and compare values,
returning an appropriate exit code. The bash shell returning an appropriate exit code. The bash shell
has test built in, ash can build it in optionally. has test built in, ash can build it in optionally.
config FEATURE_TEST_64 config FEATURE_TEST_64
@ -753,7 +754,7 @@ config FEATURE_WC_LARGE
default n default n
depends on WC depends on WC
help help
Use "unsigned long long" in wc for count variables Use "unsigned long long" in wc for count variables.
config WHO config WHO
bool "who" bool "who"

View File

@ -26,8 +26,8 @@ config RUN_PARTS
It is useful to set up a directory like cron.daily, where you need to It is useful to set up a directory like cron.daily, where you need to
execute all the scripts in that directory. execute all the scripts in that directory.
In this implementation of run-parts some features (such as report mode) In this implementation of run-parts some features (such as report
are not implemented. mode) are not implemented.
Unless you know that run-parts is used in some of your scripts Unless you know that run-parts is used in some of your scripts
you can safely say N here. you can safely say N here.

View File

@ -38,7 +38,7 @@ config LSATTR
### bool "mke2fs" ### bool "mke2fs"
### default n ### default n
### help ### help
### mke2fs is used to create an ext2/ext3 filesystem. The normal compat ### mke2fs is used to create an ext2/ext3 filesystem. The normal compat
### symlinks 'mkfs.ext2' and 'mkfs.ext3' are also provided. ### symlinks 'mkfs.ext2' and 'mkfs.ext3' are also provided.
### config TUNE2FS ### config TUNE2FS

View File

@ -38,7 +38,7 @@ config MKE2FS
bool "mke2fs" bool "mke2fs"
default n default n
help help
mke2fs is used to create an ext2/ext3 filesystem. The normal compat mke2fs is used to create an ext2/ext3 filesystem. The normal compat
symlinks 'mkfs.ext2' and 'mkfs.ext3' are also provided. symlinks 'mkfs.ext2' and 'mkfs.ext3' are also provided.
config TUNE2FS config TUNE2FS

View File

@ -9,7 +9,7 @@ config AWK
bool "awk" bool "awk"
default n default n
help help
Awk is used as a pattern scanning and processing language. This is Awk is used as a pattern scanning and processing language. This is
the BusyBox implementation of that programming language. the BusyBox implementation of that programming language.
config FEATURE_AWK_MATH config FEATURE_AWK_MATH
@ -64,7 +64,7 @@ config ED
default n default n
help help
The original 1970's Unix text editor, from the days of teletypes. The original 1970's Unix text editor, from the days of teletypes.
Small, simple, evil. Part of SUSv3. If you're not already using Small, simple, evil. Part of SUSv3. If you're not already using
this, you don't need it. this, you don't need it.
config PATCH config PATCH
@ -84,9 +84,9 @@ config VI
bool "vi" bool "vi"
default n default n
help help
'vi' is a text editor. More specifically, it is the One True 'vi' is a text editor. More specifically, it is the One True
text editor <grin>. It does, however, have a rather steep text editor <grin>. It does, however, have a rather steep
learning curve. If you are not already comfortable with 'vi' learning curve. If you are not already comfortable with 'vi'
you may wish to use something else. you may wish to use something else.
config FEATURE_VI_MAX_LEN config FEATURE_VI_MAX_LEN
@ -113,7 +113,7 @@ config FEATURE_VI_COLON
default y default y
depends on VI depends on VI
help help
Enable a limited set of colon commands for vi. This does not Enable a limited set of colon commands for vi. This does not
provide an "ex" mode. provide an "ex" mode.
config FEATURE_VI_YANKMARK config FEATURE_VI_YANKMARK
@ -137,7 +137,7 @@ config FEATURE_VI_USE_SIGNALS
default y default y
depends on VI depends on VI
help help
Selecting this option will make busybox vi signal aware. This will Selecting this option will make busybox vi signal aware. This will
make busybox vi support SIGWINCH to deal with Window Changes, catch make busybox vi support SIGWINCH to deal with Window Changes, catch
Ctrl-Z and Ctrl-C and alarms. Ctrl-Z and Ctrl-C and alarms.

View File

@ -17,7 +17,7 @@ config FEATURE_FIND_PRINT0
depends on FIND depends on FIND
help help
Causes output names to be separated by a null character Causes output names to be separated by a null character
rather than a newline. This allows names that contain rather than a newline. This allows names that contain
newlines and other whitespace to be more easily newlines and other whitespace to be more easily
interpreted by other programs. interpreted by other programs.
@ -182,7 +182,7 @@ config FEATURE_GREP_EGREP_ALIAS
default y default y
depends on GREP depends on GREP
help help
Enabled support for extended regular expressions. Extended Enabled support for extended regular expressions. Extended
regular expressions allow for alternation (foo|bar), grouping, regular expressions allow for alternation (foo|bar), grouping,
and various repetition operators. and various repetition operators.

View File

@ -80,7 +80,7 @@ config FEATURE_INIT_COREDUMPS
help help
If this option is enabled and the file /.init_enable_core If this option is enabled and the file /.init_enable_core
exists, then init will call setrlimit() to allow unlimited exists, then init will call setrlimit() to allow unlimited
core file sizes. If this option is disabled, processes core file sizes. If this option is disabled, processes
will not generate any core files. will not generate any core files.
@ -90,7 +90,7 @@ config FEATURE_INITRD
default y default y
depends on INIT depends on INIT
help help
Legacy support for running init under the old-style initrd. Allows Legacy support for running init under the old-style initrd. Allows
the name linuxrc to act as init, and it doesn't assume init is PID 1. the name linuxrc to act as init, and it doesn't assume init is PID 1.
This does not apply to initramfs, which runs /init as PID 1 and This does not apply to initramfs, which runs /init as PID 1 and
@ -106,7 +106,7 @@ config MESG
bool "mesg" bool "mesg"
default n default n
help help
Mesg controls access to your terminal by others. It is typically Mesg controls access to your terminal by others. It is typically
used to allow or disallow other users to write to your terminal used to allow or disallow other users to write to your terminal
endmenu endmenu

View File

@ -62,7 +62,7 @@ config FEATURE_EDITING_VI
default n default n
depends on FEATURE_EDITING depends on FEATURE_EDITING
help help
Enable vi-style line editing. In shells, this mode can be Enable vi-style line editing. In shells, this mode can be
turned on and off with "set -o vi" and "set +o vi". turned on and off with "set -o vi" and "set +o vi".
config FEATURE_EDITING_HISTORY config FEATURE_EDITING_HISTORY

View File

@ -9,7 +9,7 @@ config FEATURE_SHADOWPASSWDS
bool "Support for shadow passwords" bool "Support for shadow passwords"
default n default n
help help
Build support for shadow password in /etc/shadow. This file is only Build support for shadow password in /etc/shadow. This file is only
readable by root and thus the encrypted passwords are no longer readable by root and thus the encrypted passwords are no longer
publicly readable. publicly readable.
@ -18,17 +18,17 @@ config USE_BB_PWD_GRP
default n default n
help help
If you leave this disabled, busybox will use the system's password If you leave this disabled, busybox will use the system's password
and group functions. And if you are using the GNU C library and group functions. And if you are using the GNU C library
(glibc), you will then need to install the /etc/nsswitch.conf (glibc), you will then need to install the /etc/nsswitch.conf
configuration file and the required /lib/libnss_* libraries in configuration file and the required /lib/libnss_* libraries in
order for the password and group functions to work. This generally order for the password and group functions to work. This generally
makes your embedded system quite a bit larger. makes your embedded system quite a bit larger.
Enabling this option will cause busybox to directly access the Enabling this option will cause busybox to directly access the
system's /etc/password, /etc/group files (and your system will be system's /etc/password, /etc/group files (and your system will be
smaller, and I will get fewer emails asking about how glibc NSS smaller, and I will get fewer emails asking about how glibc NSS
works). When this option is enabled, you will not be able to use works). When this option is enabled, you will not be able to use
PAM to access remote LDAP password servers and whatnot. And if you PAM to access remote LDAP password servers and whatnot. And if you
want hostname resolution to work with glibc, you still need the want hostname resolution to work with glibc, you still need the
/lib/libnss_* libraries. /lib/libnss_* libraries.
@ -44,16 +44,16 @@ config USE_BB_SHADOW
depends on USE_BB_PWD_GRP && FEATURE_SHADOWPASSWDS depends on USE_BB_PWD_GRP && FEATURE_SHADOWPASSWDS
help help
If you leave this disabled, busybox will use the system's shadow If you leave this disabled, busybox will use the system's shadow
password handling functions. And if you are using the GNU C library password handling functions. And if you are using the GNU C library
(glibc), you will then need to install the /etc/nsswitch.conf (glibc), you will then need to install the /etc/nsswitch.conf
configuration file and the required /lib/libnss_* libraries in configuration file and the required /lib/libnss_* libraries in
order for the shadow password functions to work. This generally order for the shadow password functions to work. This generally
makes your embedded system quite a bit larger. makes your embedded system quite a bit larger.
Enabling this option will cause busybox to directly access the Enabling this option will cause busybox to directly access the
system's /etc/shadow file when handling shadow passwords. This system's /etc/shadow file when handling shadow passwords. This
makes your system smaller (and I will get fewer emails asking about makes your system smaller (and I will get fewer emails asking about
how glibc NSS works). When this option is enabled, you will not be how glibc NSS works). When this option is enabled, you will not be
able to use PAM to access shadow passwords from remote LDAP able to use PAM to access shadow passwords from remote LDAP
password servers and whatnot. password servers and whatnot.
@ -66,7 +66,7 @@ config USE_BB_CRYPT
standard C library functions. standard C library functions.
If you leave this disabled, busybox will use the system's If you leave this disabled, busybox will use the system's
crypt functions. Most C libraries use large (~70k) crypt functions. Most C libraries use large (~70k)
static buffers there, and also combine them with more general static buffers there, and also combine them with more general
DES encryption/decryption. DES encryption/decryption.
@ -211,9 +211,9 @@ config PASSWD
select FEATURE_SUID select FEATURE_SUID
select FEATURE_SYSLOG select FEATURE_SYSLOG
help help
passwd changes passwords for user and group accounts. A normal user passwd changes passwords for user and group accounts. A normal user
may only change the password for his/her own account, the super user may only change the password for his/her own account, the super user
may change the password for any account. The administrator of a group may change the password for any account. The administrator of a group
may change the password for the group. may change the password for the group.
Note that Busybox binary must be setuid root for this applet to Note that Busybox binary must be setuid root for this applet to

View File

@ -101,7 +101,7 @@ config CROND
help help
Crond is a background daemon that parses individual crontab Crond is a background daemon that parses individual crontab
files and executes commands on behalf of the users in question. files and executes commands on behalf of the users in question.
This is a port of dcron from slackware. It uses files of the This is a port of dcron from slackware. It uses files of the
format /var/spool/cron/crontabs/<username> files, for example: format /var/spool/cron/crontabs/<username> files, for example:
$ cat /var/spool/cron/crontabs/root $ cat /var/spool/cron/crontabs/root
# Run daily cron jobs at 4:40 every day: # Run daily cron jobs at 4:40 every day:
@ -126,7 +126,7 @@ config CRONTAB
default n default n
select FEATURE_SUID select FEATURE_SUID
help help
Crontab manipulates the crontab for a particular user. Only Crontab manipulates the crontab for a particular user. Only
the superuser may specify a different user and/or crontab directory. the superuser may specify a different user and/or crontab directory.
Note that Busybox binary must be setuid root for this applet to Note that Busybox binary must be setuid root for this applet to
work properly. work properly.
@ -185,14 +185,14 @@ config FEATURE_DEVFS
This is obsolete and will be going away at the end of 2008.. This is obsolete and will be going away at the end of 2008..
This tells busybox to look for names like /dev/loop/0 instead of This tells busybox to look for names like /dev/loop/0 instead of
/dev/loop0. If your /dev directory has normal names instead of /dev/loop0. If your /dev directory has normal names instead of
devfs names, you don't want this. devfs names, you don't want this.
config EJECT config EJECT
bool "eject" bool "eject"
default n default n
help help
Used to eject cdroms. (defaults to /dev/cdrom) Used to eject cdroms. (defaults to /dev/cdrom)
config FEATURE_EJECT_SCSI config FEATURE_EJECT_SCSI
bool "SCSI support" bool "SCSI support"
@ -311,8 +311,8 @@ config HDPARM
bool "hdparm" bool "hdparm"
default n default n
help help
Get/Set hard drive parameters. Primarily intended for ATA Get/Set hard drive parameters. Primarily intended for ATA
drives. Adds about 13k (or around 30k if you enable the drives. Adds about 13k (or around 30k if you enable the
FEATURE_HDPARM_GET_IDENTITY option).... FEATURE_HDPARM_GET_IDENTITY option)....
config FEATURE_HDPARM_GET_IDENTITY config FEATURE_HDPARM_GET_IDENTITY
@ -355,7 +355,7 @@ config FEATURE_HDPARM_HDIO_TRISTATE_HWIF
depends on HDPARM depends on HDPARM
help help
Enables the 'hdparm -x' option to tristate device for hotswap, Enables the 'hdparm -x' option to tristate device for hotswap,
and the '-b' option to get/set bus state. This is dangerous and the '-b' option to get/set bus state. This is dangerous
stuff, so you should probably say N. stuff, so you should probably say N.
config FEATURE_HDPARM_HDIO_GETSET_DMA config FEATURE_HDPARM_HDIO_GETSET_DMA
@ -420,7 +420,7 @@ config MT
bool "mt" bool "mt"
default n default n
help help
mt is used to control tape devices. You can use the mt utility mt is used to control tape devices. You can use the mt utility
to advance or rewind a tape past a specified number of archive to advance or rewind a tape past a specified number of archive
files on the tape. files on the tape.
@ -441,7 +441,7 @@ config READAHEAD
This applet just calls the readahead(2) system call on each file. This applet just calls the readahead(2) system call on each file.
It is mainly useful in system startup scripts to preload files It is mainly useful in system startup scripts to preload files
or executables before they are used. When used at the right time or executables before they are used. When used at the right time
(in particular when a CPU bound process is running) it can (in particular when a CPU bound process is running) it can
significantly speed up system startup. significantly speed up system startup.
@ -514,8 +514,8 @@ config WATCHDOG
default n default n
help help
The watchdog utility is used with hardware or software watchdog The watchdog utility is used with hardware or software watchdog
device drivers. It opens the specified watchdog device special file device drivers. It opens the specified watchdog device special file
and periodically writes a magic character to the device. If the and periodically writes a magic character to the device. If the
watchdog applet ever fails to write the magic character within a watchdog applet ever fails to write the magic character within a
certain amount of time, the watchdog device assumes the system has certain amount of time, the watchdog device assumes the system has
hung, and will cause the hardware to reboot. hung, and will cause the hardware to reboot.

View File

@ -104,7 +104,7 @@ config FEATURE_INSMOD_VERSION_CHECKING
default n default n
depends on INSMOD && FEATURE_2_4_MODULES depends on INSMOD && FEATURE_2_4_MODULES
help help
Support checking of versions for modules. This is used to Support checking of versions for modules. This is used to
ensure that the kernel and module are made for each other. ensure that the kernel and module are made for each other.
config FEATURE_INSMOD_KSYMOOPS_SYMBOLS config FEATURE_INSMOD_KSYMOOPS_SYMBOLS
@ -113,9 +113,9 @@ config FEATURE_INSMOD_KSYMOOPS_SYMBOLS
depends on INSMOD && FEATURE_2_4_MODULES depends on INSMOD && FEATURE_2_4_MODULES
help help
By adding module symbols to the kernel symbol table, Oops messages By adding module symbols to the kernel symbol table, Oops messages
occuring within kernel modules can be properly debugged. By enabling occuring within kernel modules can be properly debugged. By enabling
this feature, module symbols will always be added to the kernel symbol this feature, module symbols will always be added to the kernel symbol
table for properly debugging support. If you are not interested in table for properly debugging support. If you are not interested in
Oops messages from kernel modules, say N. Oops messages from kernel modules, say N.
config FEATURE_INSMOD_LOADINKMEM config FEATURE_INSMOD_LOADINKMEM
@ -145,7 +145,7 @@ config FEATURE_INSMOD_LOAD_MAP_FULL
depends on FEATURE_INSMOD_LOAD_MAP depends on FEATURE_INSMOD_LOAD_MAP
help help
Without this option, -m will only output section Without this option, -m will only output section
load map. With this option, -m will also output load map. With this option, -m will also output
symbols load map. symbols load map.
config RMMOD config RMMOD
@ -229,7 +229,7 @@ config FEATURE_CHECK_TAINTED_MODULE
default y default y
depends on INSMOD || LSMOD depends on INSMOD || LSMOD
help help
Support checking for tainted modules. These are usually binary Support checking for tainted modules. These are usually binary
only modules that will make the linux-kernel list ignore your only modules that will make the linux-kernel list ignore your
support request. support request.
This option is required to support GPLONLY modules. This option is required to support GPLONLY modules.

View File

@ -216,7 +216,7 @@ config FEATURE_HTTPD_ENCODE_URL_STR
depends on HTTPD depends on HTTPD
help help
This option allows html encoding of arbitrary strings for display This option allows html encoding of arbitrary strings for display
by the browser. Output goes to stdout. by the browser. Output goes to stdout.
For example, httpd -e "<Hello World>" produces For example, httpd -e "<Hello World>" produces
"&#60Hello&#32World&#62". "&#60Hello&#32World&#62".
@ -264,7 +264,7 @@ config FEATURE_IFCONFIG_SLIP
default n default n
depends on IFCONFIG depends on IFCONFIG
help help
Allow "keepalive" and "outfill" support for SLIP. If you're not Allow "keepalive" and "outfill" support for SLIP. If you're not
planning on using serial lines, leave this unchecked. planning on using serial lines, leave this unchecked.
config FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ config FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
@ -281,7 +281,7 @@ config FEATURE_IFCONFIG_HW
depends on IFCONFIG depends on IFCONFIG
help help
Set the hardware address of this interface, if the device driver Set the hardware address of this interface, if the device driver
supports this operation. Currently, we only support the 'ether' supports this operation. Currently, we only support the 'ether'
class. class.
config FEATURE_IFCONFIG_BROADCAST_PLUS config FEATURE_IFCONFIG_BROADCAST_PLUS
@ -303,15 +303,15 @@ config IFUPDOWN
bool "ifupdown" bool "ifupdown"
default n default n
help help
Activate or deactivate the specified interfaces. This applet makes Activate or deactivate the specified interfaces. This applet makes
use of either "ifconfig" and "route" or the "ip" command to actually use of either "ifconfig" and "route" or the "ip" command to actually
configure network interfaces. Therefore, you will probably also want configure network interfaces. Therefore, you will probably also want
to enable either IFCONFIG and ROUTE, or enable to enable either IFCONFIG and ROUTE, or enable
FEATURE_IFUPDOWN_IP and the various IP options. Of FEATURE_IFUPDOWN_IP and the various IP options. Of
course you could use non-busybox versions of these programs, so course you could use non-busybox versions of these programs, so
against my better judgement (since this will surely result in plenty against my better judgement (since this will surely result in plenty
of support questions on the mailing list), I do not force you to of support questions on the mailing list), I do not force you to
enable these additional options. It is up to you to supply either enable these additional options. It is up to you to supply either
"ifconfig", "route" and "run-parts" or the "ip" command, either "ifconfig", "route" and "run-parts" or the "ip" command, either
via busybox or via standalone utilities. via busybox or via standalone utilities.
@ -458,7 +458,7 @@ config IP
default n default n
help help
The "ip" applet is a TCP/IP interface configuration and routing The "ip" applet is a TCP/IP interface configuration and routing
utility. You generally don't need "ip" to use busybox with utility. You generally don't need "ip" to use busybox with
TCP/IP. TCP/IP.
config FEATURE_IP_ADDRESS config FEATURE_IP_ADDRESS
@ -558,7 +558,8 @@ config FEATURE_IPCALC_FANCY
default y default y
depends on IPCALC depends on IPCALC
help help
Adds the options hostname, prefix and silent to the output of "ipcalc". Adds the options hostname, prefix and silent to the output of
"ipcalc".
config FEATURE_IPCALC_LONG_OPTIONS config FEATURE_IPCALC_LONG_OPTIONS
bool "Enable long options" bool "Enable long options"
@ -688,7 +689,8 @@ config SLATTACH
bool "slattach" bool "slattach"
default n default n
help help
slattach is a small utility to attach network interfaces to serial lines. slattach is a small utility to attach network interfaces to serial
lines.
config TELNET config TELNET
bool "telnet" bool "telnet"
@ -703,7 +705,7 @@ config FEATURE_TELNET_TTYPE
depends on TELNET depends on TELNET
help help
Setting this option will forward the TERM environment variable to the Setting this option will forward the TERM environment variable to the
remote host you are connecting to. This is useful to make sure that remote host you are connecting to. This is useful to make sure that
things like ANSI colors and other control sequences behave. things like ANSI colors and other control sequences behave.
config FEATURE_TELNET_AUTOLOGIN config FEATURE_TELNET_AUTOLOGIN
@ -722,9 +724,9 @@ config TELNETD
select FEATURE_SYSLOG select FEATURE_SYSLOG
help help
A daemon for the TELNET protocol, allowing you to log onto the host A daemon for the TELNET protocol, allowing you to log onto the host
running the daemon. Please keep in mind that the TELNET protocol running the daemon. Please keep in mind that the TELNET protocol
sends passwords in plain text. If you can't afford the space for an sends passwords in plain text. If you can't afford the space for an
SSH daemon and you trust your network, you may say 'y' here. As a SSH daemon and you trust your network, you may say 'y' here. As a
more secure alternative, you should seriously consider installing the more secure alternative, you should seriously consider installing the
very small Dropbear SSH daemon instead: very small Dropbear SSH daemon instead:
http://matt.ucc.asn.au/dropbear/dropbear.html http://matt.ucc.asn.au/dropbear/dropbear.html
@ -750,7 +752,7 @@ config TELNETD
mount -t devpts devpts /dev/pts mount -t devpts devpts /dev/pts
You need to be sure that Busybox has LOGIN and You need to be sure that Busybox has LOGIN and
FEATURE_SUID enabled. And finally, you should make FEATURE_SUID enabled. And finally, you should make
certain that Busybox has been installed setuid root: certain that Busybox has been installed setuid root:
chown root.root /bin/busybox chown root.root /bin/busybox
@ -770,7 +772,7 @@ config TFTP
bool "tftp" bool "tftp"
default n default n
help help
This enables the Trivial File Transfer Protocol client program. TFTP This enables the Trivial File Transfer Protocol client program. TFTP
is usually used for simple, small transfers such as a root image is usually used for simple, small transfers such as a root image
for a network-enabled bootloader. for a network-enabled bootloader.
@ -789,7 +791,7 @@ config FEATURE_TFTP_GET
default y default y
depends on TFTP || TFTPD depends on TFTP || TFTPD
help help
Add support for the GET command within the TFTP client. This allows Add support for the GET command within the TFTP client. This allows
a client to retrieve a file from a TFTP server. a client to retrieve a file from a TFTP server.
Also enable upload support in tftpd, if tftpd is selected. Also enable upload support in tftpd, if tftpd is selected.
@ -798,7 +800,7 @@ config FEATURE_TFTP_PUT
default y default y
depends on TFTP || TFTPD depends on TFTP || TFTPD
help help
Add support for the PUT command within the TFTP client. This allows Add support for the PUT command within the TFTP client. This allows
a client to transfer a file to a TFTP server. a client to transfer a file to a TFTP server.
Also enable download support in tftpd, if tftpd is selected. Also enable download support in tftpd, if tftpd is selected.
@ -815,7 +817,7 @@ config DEBUG_TFTP
default n default n
depends on TFTP depends on TFTP
help help
Enable debug settings for tftp. This is useful if you're running Enable debug settings for tftp. This is useful if you're running
into problems with tftp as the protocol doesn't help you much when into problems with tftp as the protocol doesn't help you much when
you run into problems. you run into problems.
@ -830,7 +832,7 @@ config FEATURE_TRACEROUTE_VERBOSE
default n default n
depends on TRACEROUTE depends on TRACEROUTE
help help
Add some verbosity to traceroute. This includes amongst other things Add some verbosity to traceroute. This includes amongst other things
hostnames and ICMP response types. hostnames and ICMP response types.
config FEATURE_TRACEROUTE_SOURCE_ROUTE config FEATURE_TRACEROUTE_SOURCE_ROUTE
@ -900,12 +902,14 @@ config TCPSVD
bool "tcpsvd" bool "tcpsvd"
default n default n
help help
tcpsvd listens on a TCP port and runs a program for each new connection tcpsvd listens on a TCP port and runs a program for each new
connection.
config UDPSVD config UDPSVD
bool "udpsvd" bool "udpsvd"
default n default n
help help
udpsvd listens on an UDP port and runs a program for each new connection udpsvd listens on an UDP port and runs a program for each new
connection.
endmenu endmenu

View File

@ -18,7 +18,7 @@ config FUSER
default n default n
help help
fuser lists all PIDs (Process IDs) that currently have a given fuser lists all PIDs (Process IDs) that currently have a given
file open. fuser can also list all PIDs that have a given network file open. fuser can also list all PIDs that have a given network
(TCP or UDP) port open. (TCP or UDP) port open.
config KILL config KILL
@ -26,7 +26,7 @@ config KILL
default n default n
help help
The command kill sends the specified signal to the specified The command kill sends the specified signal to the specified
process or process group. If no signal is specified, the TERM process or process group. If no signal is specified, the TERM
signal is sent. signal is sent.
config KILLALL config KILLALL
@ -35,7 +35,7 @@ config KILLALL
depends on KILL depends on KILL
help help
killall sends a signal to all processes running any of the killall sends a signal to all processes running any of the
specified commands. If no signal name is specified, SIGTERM is specified commands. If no signal name is specified, SIGTERM is
sent. sent.
config KILLALL5 config KILLALL5

View File

@ -39,7 +39,7 @@ config ASH
help help
Tha 'ash' shell adds about 60k in the default configuration and is Tha 'ash' shell adds about 60k in the default configuration and is
the most complete and most pedantically correct shell included with the most complete and most pedantically correct shell included with
busybox. This shell is actually a derivative of the Debian 'dash' busybox. This shell is actually a derivative of the Debian 'dash'
shell (by Herbert Xu), which was created by porting the 'ash' shell shell (by Herbert Xu), which was created by porting the 'ash' shell
(written by Kenneth Almquist) from NetBSD. (written by Kenneth Almquist) from NetBSD.
@ -96,7 +96,7 @@ config ASH_MATH_SUPPORT_64
default n default n
depends on ASH_MATH_SUPPORT depends on ASH_MATH_SUPPORT
help help
Enable 64-bit math support in the ash shell. This will make Enable 64-bit math support in the ash shell. This will make
the shell slightly larger, but will allow computation with very the shell slightly larger, but will allow computation with very
large numbers. large numbers.
@ -176,7 +176,7 @@ config HUSH
default n default n
help help
hush is a very small shell (just 18k) and it has fairly complete hush is a very small shell (just 18k) and it has fairly complete
Bourne shell grammar. It even handles all the normal flow control Bourne shell grammar. It even handles all the normal flow control
options such as if/then/elif/else/fi, for/in/do/done, while loops, options such as if/then/elif/else/fi, for/in/do/done, while loops,
etc. etc.
@ -246,7 +246,7 @@ config MSH
help help
The minix shell (adds just 30k) is quite complete and handles things The minix shell (adds just 30k) is quite complete and handles things
like for/do/done, case/esac and all the things you expect a Bourne like for/do/done, case/esac and all the things you expect a Bourne
shell to do. It is not always pedantically correct about Bourne shell to do. It is not always pedantically correct about Bourne
shell grammar (try running the shell testscript "tests/sh.testcases" shell grammar (try running the shell testscript "tests/sh.testcases"
on it and compare vs bash) but for most things it works quite well. on it and compare vs bash) but for most things it works quite well.
It also uses only vfork, so it can be used on uClinux systems. It also uses only vfork, so it can be used on uClinux systems.
@ -267,11 +267,11 @@ config FEATURE_SH_STANDALONE
depends on (MSH || LASH || HUSH || ASH) && FEATURE_PREFER_APPLETS depends on (MSH || LASH || HUSH || ASH) && FEATURE_PREFER_APPLETS
help help
This option causes busybox shells to use busybox applets This option causes busybox shells to use busybox applets
in preference to executables in the PATH whenever possible. For in preference to executables in the PATH whenever possible. For
example, entering the command 'ifconfig' into the shell would cause example, entering the command 'ifconfig' into the shell would cause
busybox to use the ifconfig busybox applet. Specifying the fully busybox to use the ifconfig busybox applet. Specifying the fully
qualified executable name, such as '/sbin/ifconfig' will still qualified executable name, such as '/sbin/ifconfig' will still
execute the /sbin/ifconfig executable on the filesystem. This option execute the /sbin/ifconfig executable on the filesystem. This option
is generally used when creating a statically linked version of busybox is generally used when creating a statically linked version of busybox
for use as a rescue shell, in the event that you screw up your system. for use as a rescue shell, in the event that you screw up your system.
@ -285,12 +285,12 @@ config FEATURE_SH_STANDALONE
started this way). started this way).
# untrue? # untrue?
# Note that this will *also* cause applets to take precedence # Note that this will *also* cause applets to take precedence
# over shell builtins of the same name. So turning this on will # over shell builtins of the same name. So turning this on will
# eliminate any performance gained by turning on the builtin "echo" # eliminate any performance gained by turning on the builtin "echo"
# and "test" commands in ash. # and "test" commands in ash.
# untrue? # untrue?
# Note that when using this option, the shell will attempt to directly # Note that when using this option, the shell will attempt to directly
# run '/bin/busybox'. If you do not have the busybox binary sitting in # run '/bin/busybox'. If you do not have the busybox binary sitting in
# that exact location with that exact name, this option will not work at # that exact location with that exact name, this option will not work at
# all. # all.

View File

@ -10,14 +10,14 @@ config SYSLOGD
default n default n
help help
The syslogd utility is used to record logs of all the The syslogd utility is used to record logs of all the
significant events that occur on a system. Every significant events that occur on a system. Every
message that is logged records the date and time of the message that is logged records the date and time of the
event, and will generally also record the name of the event, and will generally also record the name of the
application that generated the message. When used in application that generated the message. When used in
conjunction with klogd, messages from the Linux kernel conjunction with klogd, messages from the Linux kernel
can also be recorded. This is terribly useful, can also be recorded. This is terribly useful,
especially for finding what happened when something goes especially for finding what happened when something goes
wrong. And something almost always will go wrong if wrong. And something almost always will go wrong if
you wait long enough.... you wait long enough....
config FEATURE_ROTATE_LOGFILE config FEATURE_ROTATE_LOGFILE
@ -35,10 +35,10 @@ config FEATURE_REMOTE_LOG
help help
When you enable this feature, the syslogd utility can When you enable this feature, the syslogd utility can
be used to send system log messages to another system be used to send system log messages to another system
connected via a network. This allows the remote connected via a network. This allows the remote
machine to log all the system messages, which can be machine to log all the system messages, which can be
terribly useful for reducing the number of serial terribly useful for reducing the number of serial
cables you use. It can also be a very good security cables you use. It can also be a very good security
measure to prevent system logs from being tampered with measure to prevent system logs from being tampered with
by an intruder. by an intruder.
@ -58,7 +58,7 @@ config FEATURE_IPC_SYSLOG
When you enable this feature, the syslogd utility will When you enable this feature, the syslogd utility will
use a circular buffer to record system log messages. use a circular buffer to record system log messages.
When the buffer is filled it will continue to overwrite When the buffer is filled it will continue to overwrite
the oldest messages. This can be very useful for the oldest messages. This can be very useful for
systems with little or no permanent storage, since systems with little or no permanent storage, since
otherwise system logs can eventually fill up your otherwise system logs can eventually fill up your
entire filesystem, which may cause your system to entire filesystem, which may cause your system to
@ -79,7 +79,7 @@ config LOGREAD
depends on FEATURE_IPC_SYSLOG depends on FEATURE_IPC_SYSLOG
help help
If you enabled Circular Buffer support, you almost If you enabled Circular Buffer support, you almost
certainly want to enable this feature as well. This certainly want to enable this feature as well. This
utility will allow you to read the messages that are utility will allow you to read the messages that are
stored in the syslogd circular buffer. stored in the syslogd circular buffer.
@ -100,7 +100,7 @@ config KLOGD
help help
klogd is a utility which intercepts and logs all klogd is a utility which intercepts and logs all
messages from the Linux kernel and sends the messages messages from the Linux kernel and sends the messages
out to the 'syslogd' utility so they can be logged. If out to the 'syslogd' utility so they can be logged. If
you wish to record the messages produced by the kernel, you wish to record the messages produced by the kernel,
you should enable this option. you should enable this option.
@ -111,7 +111,7 @@ config LOGGER
help help
The logger utility allows you to send arbitrary text The logger utility allows you to send arbitrary text
messages to the system log (i.e. the 'syslogd' utility) so messages to the system log (i.e. the 'syslogd' utility) so
they can be logged. This is generally used to help locate they can be logged. This is generally used to help locate
problems that occur within programs and scripts. problems that occur within programs and scripts.
endmenu endmenu

View File

@ -9,12 +9,12 @@ config DMESG
bool "dmesg" bool "dmesg"
default n default n
help help
dmesg is used to examine or control the kernel ring buffer. When the dmesg is used to examine or control the kernel ring buffer. When the
Linux kernel prints messages to the system log, they are stored in Linux kernel prints messages to the system log, they are stored in
the kernel ring buffer. You can use dmesg to print the kernel's ring the kernel ring buffer. You can use dmesg to print the kernel's ring
buffer, clear the kernel ring buffer, change the size of the kernel buffer, clear the kernel ring buffer, change the size of the kernel
ring buffer, and change the priority level at which kernel messages ring buffer, and change the priority level at which kernel messages
are also logged to the system console. Enable this option if you are also logged to the system console. Enable this option if you
wish to enable the 'dmesg' utility. wish to enable the 'dmesg' utility.
config FEATURE_DMESG_PRETTY config FEATURE_DMESG_PRETTY
@ -23,7 +23,8 @@ config FEATURE_DMESG_PRETTY
depends on DMESG depends on DMESG
help help
If you wish to scrub the syslog level from the output, say 'Y' here. If you wish to scrub the syslog level from the output, say 'Y' here.
The syslog level is a string prefixed to every line with the form "<#>". The syslog level is a string prefixed to every line with the form
"<#>".
With this option you will see: With this option you will see:
# dmesg # dmesg
@ -42,8 +43,8 @@ config FBSET
default n default n
help help
fbset is used to show or change the settings of a Linux frame buffer fbset is used to show or change the settings of a Linux frame buffer
device. The frame buffer device provides a simple and unique device. The frame buffer device provides a simple and unique
interface to access a graphics display. Enable this option interface to access a graphics display. Enable this option
if you wish to enable the 'fbset' utility. if you wish to enable the 'fbset' utility.
config FEATURE_FBSET_FANCY config FEATURE_FBSET_FANCY
@ -52,8 +53,8 @@ config FEATURE_FBSET_FANCY
depends on FBSET depends on FBSET
help help
This option enables extended fbset options, allowing one to set the This option enables extended fbset options, allowing one to set the
framebuffer size, color depth, etc. interface to access a graphics framebuffer size, color depth, etc. interface to access a graphics
display. Enable this option if you wish to enable extended fbset display. Enable this option if you wish to enable extended fbset
options. options.
config FEATURE_FBSET_READMODE config FEATURE_FBSET_READMODE
@ -70,11 +71,11 @@ config FDFLUSH
default n default n
help help
fdflush is only needed when changing media on slightly-broken fdflush is only needed when changing media on slightly-broken
removable media drives. It is used to make Linux believe that a removable media drives. It is used to make Linux believe that a
hardware disk-change switch has been actuated, which causes Linux to hardware disk-change switch has been actuated, which causes Linux to
forget anything it has cached from the previous media. If you have forget anything it has cached from the previous media. If you have
such a slightly-broken drive, you will need to run fdflush every time such a slightly-broken drive, you will need to run fdflush every time
you change a disk. Most people have working hardware and can safely you change a disk. Most people have working hardware and can safely
leave this disabled. leave this disabled.
config FDFORMAT config FDFORMAT
@ -88,7 +89,7 @@ config FDISK
default n default n
help help
The fdisk utility is used to divide hard disks into one or more The fdisk utility is used to divide hard disks into one or more
logical disks, which are generally called partitions. This utility logical disks, which are generally called partitions. This utility
can be used to list and edit the set of partitions or BSD style can be used to list and edit the set of partitions or BSD style
'disk slices' that are defined on a hard drive. 'disk slices' that are defined on a hard drive.
@ -105,7 +106,7 @@ config FEATURE_FDISK_WRITABLE
depends on FDISK depends on FDISK
help help
Enabling this option allows you to create or change a partition table Enabling this option allows you to create or change a partition table
and write those changes out to disk. If you leave this option and write those changes out to disk. If you leave this option
disabled, you will only be able to view the partition table. disabled, you will only be able to view the partition table.
config FEATURE_AIX_LABEL config FEATURE_AIX_LABEL
@ -147,7 +148,7 @@ config FEATURE_FDISK_ADVANCED
help help
Enabling this option allows you to do terribly unsafe things like Enabling this option allows you to do terribly unsafe things like
define arbitrary drive geometry, move the beginning of data in a define arbitrary drive geometry, move the beginning of data in a
partition, and similarly evil things. Unless you have a very good partition, and similarly evil things. Unless you have a very good
reason you would be wise to leave this disabled. reason you would be wise to leave this disabled.
config FINDFS config FINDFS
@ -156,7 +157,7 @@ config FINDFS
select VOLUMEID select VOLUMEID
help help
This is similar to the findfs program that is part of the e2fsprogs This is similar to the findfs program that is part of the e2fsprogs
package. However, the e2fsprogs version only support ext2/3. This package. However, the e2fsprogs version only support ext2/3. This
version supports those in addition to FAT, swap, and ReiserFS. version supports those in addition to FAT, swap, and ReiserFS.
WARNING: WARNING:
With all submodules selected, it will add ~8k to busybox. With all submodules selected, it will add ~8k to busybox.
@ -165,11 +166,11 @@ config FREERAMDISK
bool "freeramdisk" bool "freeramdisk"
default n default n
help help
Linux allows you to create ramdisks. This utility allows you to Linux allows you to create ramdisks. This utility allows you to
delete them and completely free all memory that was used for the delete them and completely free all memory that was used for the
ramdisk. For example, if you boot Linux into a ramdisk and later ramdisk. For example, if you boot Linux into a ramdisk and later
pivot_root, you may want to free the memory that is allocated to the pivot_root, you may want to free the memory that is allocated to the
ramdisk. If you have no use for freeing memory from a ramdisk, leave ramdisk. If you have no use for freeing memory from a ramdisk, leave
this disabled. this disabled.
config FSCK_MINIX config FSCK_MINIX
@ -177,9 +178,9 @@ config FSCK_MINIX
default n default n
help help
The minix filesystem is a nice, small, compact, read-write filesystem The minix filesystem is a nice, small, compact, read-write filesystem
with little overhead. It is not a journaling filesystem however and with little overhead. It is not a journaling filesystem however and
can experience corruption if it is not properly unmounted or if the can experience corruption if it is not properly unmounted or if the
power goes off in the middle of a write. This utility allows you to power goes off in the middle of a write. This utility allows you to
check for and attempt to repair any corruption that occurs to a minix check for and attempt to repair any corruption that occurs to a minix
filesystem. filesystem.
@ -188,8 +189,8 @@ config MKFS_MINIX
default n default n
help help
The minix filesystem is a nice, small, compact, read-write filesystem The minix filesystem is a nice, small, compact, read-write filesystem
with little overhead. If you wish to be able to create minix filesystems with little overhead. If you wish to be able to create minix
this utility will do the job for you. filesystems this utility will do the job for you.
comment "Minix filesystem support" comment "Minix filesystem support"
depends on FSCK_MINIX || MKFS_MINIX depends on FSCK_MINIX || MKFS_MINIX
@ -199,9 +200,9 @@ config FEATURE_MINIX2
default y default y
depends on FSCK_MINIX || MKFS_MINIX depends on FSCK_MINIX || MKFS_MINIX
help help
If you wish to be able to create version 2 minix filesystems, enable this. If you wish to be able to create version 2 minix filesystems, enable
If you enabled 'mkfs_minix' then you almost certainly want to be using the this. If you enabled 'mkfs_minix' then you almost certainly want to
version 2 filesystem support. be using the version 2 filesystem support.
config GETOPT config GETOPT
bool "getopt" bool "getopt"
@ -209,9 +210,9 @@ config GETOPT
help help
The getopt utility is used to break up (parse) options in command The getopt utility is used to break up (parse) options in command
lines to make it easy to write complex shell scripts that also check lines to make it easy to write complex shell scripts that also check
for legal (and illegal) options. If you want to write horribly for legal (and illegal) options. If you want to write horribly
complex shell scripts, or use some horribly complex shell script complex shell scripts, or use some horribly complex shell script
written by others, this utility may be for you. Most people will written by others, this utility may be for you. Most people will
wisely leave this disabled. wisely leave this disabled.
config HEXDUMP config HEXDUMP
@ -243,7 +244,7 @@ config HWCLOCK
default n default n
help help
The hwclock utility is used to read and set the hardware clock The hwclock utility is used to read and set the hardware clock
on a system. This is primarily used to set the current time on on a system. This is primarily used to set the current time on
shutdown in the hardware clock, so the hardware will keep the shutdown in the hardware clock, so the hardware will keep the
correct time when Linux is _not_ running. correct time when Linux is _not_ running.
@ -252,7 +253,7 @@ config FEATURE_HWCLOCK_LONG_OPTIONS
default n default n
depends on HWCLOCK && GETOPT_LONG depends on HWCLOCK && GETOPT_LONG
help help
By default, the hwclock utility only uses short options. If you By default, the hwclock utility only uses short options. If you
are overly fond of its long options, such as --hctosys, --utc, etc) are overly fond of its long options, such as --hctosys, --utc, etc)
then enable this option. then enable this option.
@ -262,7 +263,7 @@ config FEATURE_HWCLOCK_ADJTIME_FHS
depends on HWCLOCK depends on HWCLOCK
help help
Starting with FHS 2.3, the adjtime state file is supposed to exist Starting with FHS 2.3, the adjtime state file is supposed to exist
at /var/lib/hwclock/adjtime instead of /etc/adjtime. If you wish at /var/lib/hwclock/adjtime instead of /etc/adjtime. If you wish
to use the FHS behavior, answer Y here, otherwise answer N for the to use the FHS behavior, answer Y here, otherwise answer N for the
classic /etc/adjtime path. classic /etc/adjtime path.
@ -290,7 +291,7 @@ config LOSETUP
default n default n
help help
losetup is used to associate or detach a loop device with a regular losetup is used to associate or detach a loop device with a regular
file or block device, and to query the status of a loop device. This file or block device, and to query the status of a loop device. This
version does not currently support enabling data encryption. version does not currently support enabling data encryption.
config MDEV config MDEV
@ -326,7 +327,8 @@ config FEATURE_MDEV_RENAME_REGEXP
default n default n
depends on FEATURE_MDEV_RENAME depends on FEATURE_MDEV_RENAME
help help
Add support for regular expressions substitutions when renaming device. Add support for regular expressions substitutions when renaming
device.
config FEATURE_MDEV_EXEC config FEATURE_MDEV_EXEC
bool "Support command execution at device addition/removal" bool "Support command execution at device addition/removal"
@ -354,9 +356,9 @@ config MKSWAP
default n default n
help help
The mkswap utility is used to configure a file or disk partition as The mkswap utility is used to configure a file or disk partition as
Linux swap space. This allows Linux to use the entire file or Linux swap space. This allows Linux to use the entire file or
partition as if it were additional RAM, which can greatly increase partition as if it were additional RAM, which can greatly increase
the capability of low-memory machines. This additional memory is the capability of low-memory machines. This additional memory is
much slower than real RAM, but can be very helpful at preventing your much slower than real RAM, but can be very helpful at preventing your
applications being killed by the Linux out of memory (OOM) killer. applications being killed by the Linux out of memory (OOM) killer.
Once you have created swap space using 'mkswap' you need to enable Once you have created swap space using 'mkswap' you need to enable
@ -377,9 +379,9 @@ config MORE
default n default n
help help
more is a simple utility which allows you to read text one screen more is a simple utility which allows you to read text one screen
sized page at a time. If you want to read text that is larger than sized page at a time. If you want to read text that is larger than
the screen, and you are using anything faster than a 300 baud modem, the screen, and you are using anything faster than a 300 baud modem,
you will probably find this utility very helpful. If you don't have you will probably find this utility very helpful. If you don't have
any need to reading text files, you can leave this disabled. any need to reading text files, you can leave this disabled.
config FEATURE_USE_TERMIOS config FEATURE_USE_TERMIOS
@ -388,7 +390,7 @@ config FEATURE_USE_TERMIOS
depends on MORE || TOP depends on MORE || TOP
help help
This option allows utilities such as 'more' and 'top' to determine This option allows utilities such as 'more' and 'top' to determine
the size of the screen. If you leave this disabled, your utilities the size of the screen. If you leave this disabled, your utilities
that display things on the screen will be especially primitive and that display things on the screen will be especially primitive and
will be unable to determine the current screen size, and will be will be unable to determine the current screen size, and will be
unable to move the cursor. unable to move the cursor.
@ -608,10 +610,10 @@ config MOUNT
default n default n
help help
All files and filesystems in Unix are arranged into one big directory All files and filesystems in Unix are arranged into one big directory
tree. The 'mount' utility is used to graft a filesystem onto a tree. The 'mount' utility is used to graft a filesystem onto a
particular part of the tree. A filesystem can either live on a block particular part of the tree. A filesystem can either live on a block
device, or it can be accessible over the network, as is the case with device, or it can be accessible over the network, as is the case with
NFS filesystems. Most people using BusyBox will also want to enable NFS filesystems. Most people using BusyBox will also want to enable
the 'mount' utility. the 'mount' utility.
config FEATURE_MOUNT_FAKE config FEATURE_MOUNT_FAKE
@ -649,7 +651,7 @@ config FEATURE_MOUNT_LABEL
select VOLUMEID select VOLUMEID
help help
This allows for specifying a device by label or uuid, rather than by This allows for specifying a device by label or uuid, rather than by
name. This feature utilizes the same functionality as findfs. name. This feature utilizes the same functionality as findfs.
config FEATURE_MOUNT_NFS config FEATURE_MOUNT_NFS
bool "Support mounting NFS file systems" bool "Support mounting NFS file systems"
@ -672,7 +674,7 @@ config FEATURE_MOUNT_FLAGS
bool "Support lots of -o flags in mount" bool "Support lots of -o flags in mount"
default y default y
help help
Without this, mount only supports ro/rw/remount. With this, it Without this, mount only supports ro/rw/remount. With this, it
supports nosuid, suid, dev, nodev, exec, noexec, sync, async, atime, supports nosuid, suid, dev, nodev, exec, noexec, sync, async, atime,
noatime, diratime, nodiratime, loud, bind, move, shared, slave, noatime, diratime, nodiratime, loud, bind, move, shared, slave,
private, unbindable, rshared, rslave, rprivate, and runbindable. private, unbindable, rshared, rslave, rprivate, and runbindable.
@ -689,11 +691,11 @@ config PIVOT_ROOT
default n default n
help help
The pivot_root utility swaps the mount points for the root filesystem The pivot_root utility swaps the mount points for the root filesystem
with some other mounted filesystem. This allows you to do all sorts with some other mounted filesystem. This allows you to do all sorts
of wild and crazy things with your Linux system and is far more of wild and crazy things with your Linux system and is far more
powerful than 'chroot'. powerful than 'chroot'.
Note: This is for initrd in linux 2.4. Under initramfs (introduced Note: This is for initrd in linux 2.4. Under initramfs (introduced
in linux 2.6) use switch_root instead. in linux 2.6) use switch_root instead.
config RDATE config RDATE
@ -728,7 +730,7 @@ config SETARCH
default n default n
help help
The linux32 utility is used to create a 32bit environment for the The linux32 utility is used to create a 32bit environment for the
specified program (usually a shell). It only makes sense to have specified program (usually a shell). It only makes sense to have
this util on a system that supports both 64bit and 32bit userland this util on a system that supports both 64bit and 32bit userland
(like amd64/x86, ppc64/ppc, sparc64/sparc, etc...). (like amd64/x86, ppc64/ppc, sparc64/sparc, etc...).
@ -738,9 +740,9 @@ config SWAPONOFF
help help
This option enables both the 'swapon' and the 'swapoff' utilities. This option enables both the 'swapon' and the 'swapoff' utilities.
Once you have created some swap space using 'mkswap', you also need Once you have created some swap space using 'mkswap', you also need
to enable your swap space with the 'swapon' utility. The 'swapoff' to enable your swap space with the 'swapon' utility. The 'swapoff'
utility is used, typically at system shutdown, to disable any swap utility is used, typically at system shutdown, to disable any swap
space. If you are not using any swap space, you can leave this space. If you are not using any swap space, you can leave this
option disabled. option disabled.
config FEATURE_SWAPON_PRI config FEATURE_SWAPON_PRI
@ -755,28 +757,28 @@ config SWITCH_ROOT
default n default n
help help
The switch_root utility is used from initramfs to select a new The switch_root utility is used from initramfs to select a new
root device. Under initramfs, you have to use this instead of root device. Under initramfs, you have to use this instead of
pivot_root. (Stop reading here if you don't care why.) pivot_root. (Stop reading here if you don't care why.)
Booting with initramfs extracts a gzipped cpio archive into rootfs Booting with initramfs extracts a gzipped cpio archive into rootfs
(which is a variant of ramfs/tmpfs). Because rootfs can't be moved (which is a variant of ramfs/tmpfs). Because rootfs can't be moved
or unmounted*, pivot_root will not work from initramfs. Instead, or unmounted*, pivot_root will not work from initramfs. Instead,
switch_root deletes everything out of rootfs (including itself), switch_root deletes everything out of rootfs (including itself),
does a mount --move that overmounts rootfs with the new root, and does a mount --move that overmounts rootfs with the new root, and
then execs the specified init program. then execs the specified init program.
* Because the Linux kernel uses rootfs internally as the starting * Because the Linux kernel uses rootfs internally as the starting
and ending point for searching through the kernel's doubly linked and ending point for searching through the kernel's doubly linked
list of active mount points. That's why. list of active mount points. That's why.
config UMOUNT config UMOUNT
bool "umount" bool "umount"
default n default n
help help
When you want to remove a mounted filesystem from its current mount point, When you want to remove a mounted filesystem from its current mount
for example when you are shutting down the system, the 'umount' utility is point, for example when you are shutting down the system, the
the tool to use. If you enabled the 'mount' utility, you almost certainly 'umount' utility is the tool to use. If you enabled the 'mount'
also want to enable 'umount'. utility, you almost certainly also want to enable 'umount'.
config FEATURE_UMOUNT_ALL config FEATURE_UMOUNT_ALL
bool "Support option -a" bool "Support option -a"
@ -794,10 +796,11 @@ config FEATURE_MOUNT_LOOP
depends on MOUNT || UMOUNT depends on MOUNT || UMOUNT
help help
Enabling this feature allows automatic mounting of files (containing Enabling this feature allows automatic mounting of files (containing
filesystem images) via the linux kernel's loopback devices. The mount filesystem images) via the linux kernel's loopback devices.
command will detect you are trying to mount a file instead of a block The mount command will detect you are trying to mount a file instead
device, and transparently associate the file with a loopback device. of a block device, and transparently associate the file with a
The umount command will also free that loopback device. loopback device. The umount command will also free that loopback
device.
You can still use the 'losetup' utility (to manually associate files You can still use the 'losetup' utility (to manually associate files
with loop devices) if you need to do something advanced, such as with loop devices) if you need to do something advanced, such as
@ -811,9 +814,9 @@ config FEATURE_MTAB_SUPPORT
select FEATURE_MOUNT_FAKE select FEATURE_MOUNT_FAKE
help help
Historically, Unix systems kept track of the currently mounted Historically, Unix systems kept track of the currently mounted
partitions in the file "/etc/mtab". These days, the kernel exports partitions in the file "/etc/mtab". These days, the kernel exports
the list of currently mounted partitions in "/proc/mounts", rendering the list of currently mounted partitions in "/proc/mounts", rendering
the old mtab file obsolete. (In modern systems, /etc/mtab should be the old mtab file obsolete. (In modern systems, /etc/mtab should be
a symlink to /proc/mounts.) a symlink to /proc/mounts.)
The only reason to have mount maintain an /etc/mtab file itself is if The only reason to have mount maintain an /etc/mtab file itself is if
@ -823,7 +826,7 @@ config FEATURE_MTAB_SUPPORT
features like separate per-process filesystem namespaces, requires features like separate per-process filesystem namespaces, requires
that your /etc directory be writeable, tends to get easily confused that your /etc directory be writeable, tends to get easily confused
by --bind or --move mounts, won't update if you rename a directory by --bind or --move mounts, won't update if you rename a directory
that contains a mount point, and so on. (In brief: avoid.) that contains a mount point, and so on. (In brief: avoid.)
About the only reason to use this is if you've removed /proc from About the only reason to use this is if you've removed /proc from
your kernel. your kernel.