123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843 |
- #
- # For a description of the syntax of this configuration file,
- # see scripts/kbuild/config-language.txt.
- #
- config BUSYBOX_CONFIG_HAVE_DOT_CONFIG
- bool
- default BUSYBOX_DEFAULT_HAVE_DOT_CONFIG
- menu "Busybox Settings"
- menu "General Configuration"
- config BUSYBOX_CONFIG_DESKTOP
- bool "Enable options for full-blown desktop systems"
- default BUSYBOX_DEFAULT_DESKTOP
- help
- Enable options and features which are not essential.
- Select this only if you plan to use busybox on full-blown
- desktop machine with common Linux distro, not on an embedded box.
- config BUSYBOX_CONFIG_EXTRA_COMPAT
- bool "Provide compatible behavior for rare corner cases (bigger code)"
- default BUSYBOX_DEFAULT_EXTRA_COMPAT
- help
- This option makes grep, sed etc handle rare corner cases
- (embedded NUL bytes and such). This makes code bigger and uses
- some GNU extensions in libc. You probably only need this option
- if you plan to run busybox on desktop.
- config BUSYBOX_CONFIG_INCLUDE_SUSv2
- bool "Enable obsolete features removed before SUSv3"
- default BUSYBOX_DEFAULT_INCLUDE_SUSv2
- help
- This option will enable backwards compatibility with SuSv2,
- specifically, old-style numeric options ('command -1 <file>')
- will be supported in head, tail, and fold. (Note: should
- affect renice too.)
- config BUSYBOX_CONFIG_USE_PORTABLE_CODE
- bool "Avoid using GCC-specific code constructs"
- default BUSYBOX_DEFAULT_USE_PORTABLE_CODE
- help
- Use this option if you are trying to compile busybox with
- compiler other than gcc.
- If you do use gcc, this option may needlessly increase code size.
- config BUSYBOX_CONFIG_PLATFORM_LINUX
- bool "Enable Linux-specific applets and features"
- default BUSYBOX_DEFAULT_PLATFORM_LINUX
- help
- For the most part, busybox requires only POSIX compatibility
- from the target system, but some applets and features use
- Linux-specific interfaces.
- Answering 'N' here will disable such applets and hide the
- corresponding configuration options.
- choice
- prompt "Buffer allocation policy"
- default BUSYBOX_CONFIG_FEATURE_BUFFERS_GO_ON_STACK
- help
- There are 3 ways BusyBox can handle buffer allocations:
- - Use malloc. This costs code size for the call to xmalloc.
- - Put them on stack. For some very small machines with limited stack
- space, this can be deadly. For most folks, this works just fine.
- - Put them in BSS. This works beautifully for computers with a real
- MMU (and OS support), but wastes runtime RAM for uCLinux. This
- behavior was the only one available for BusyBox versions 0.48 and
- earlier.
- config BUSYBOX_CONFIG_FEATURE_BUFFERS_USE_MALLOC
- bool "Allocate with Malloc"
- config BUSYBOX_CONFIG_FEATURE_BUFFERS_GO_ON_STACK
- bool "Allocate on the Stack"
- config BUSYBOX_CONFIG_FEATURE_BUFFERS_GO_IN_BSS
- bool "Allocate in the .bss section"
- endchoice
- config BUSYBOX_CONFIG_SHOW_USAGE
- bool "Show applet usage messages"
- default BUSYBOX_DEFAULT_SHOW_USAGE
- help
- Enabling this option, BusyBox applets will show terse help messages
- when invoked with wrong arguments.
- If you do not want to show any (helpful) usage message when
- issuing wrong command syntax, you can say 'N' here,
- saving approximately 7k.
- config BUSYBOX_CONFIG_FEATURE_VERBOSE_USAGE
- bool "Show verbose applet usage messages"
- default BUSYBOX_DEFAULT_FEATURE_VERBOSE_USAGE
- depends on BUSYBOX_CONFIG_SHOW_USAGE
- help
- All BusyBox applets will show verbose help messages when
- busybox is invoked with --help. This will add a lot of text to the
- busybox binary. In the default configuration, this will add about
- 13k, but it can add much more depending on your configuration.
- config BUSYBOX_CONFIG_FEATURE_COMPRESS_USAGE
- bool "Store applet usage messages in compressed form"
- default BUSYBOX_DEFAULT_FEATURE_COMPRESS_USAGE
- depends on BUSYBOX_CONFIG_SHOW_USAGE
- help
- Store usage messages in .bz compressed form, uncompress them
- on-the-fly when <applet> --help is called.
- If you have a really tiny busybox with few applets enabled (and
- bunzip2 isn't one of them), the overhead of the decompressor might
- be noticeable. Also, if you run executables directly from ROM
- and have very little memory, this might not be a win. Otherwise,
- you probably want this.
- config BUSYBOX_CONFIG_FEATURE_INSTALLER
- bool "Support --install [-s] to install applet links at runtime"
- default BUSYBOX_DEFAULT_FEATURE_INSTALLER
- help
- Enable 'busybox --install [-s]' support. This will allow you to use
- busybox at runtime to create hard links or symlinks for all the
- applets that are compiled into busybox.
- config BUSYBOX_CONFIG_INSTALL_NO_USR
- bool "Don't use /usr"
- default BUSYBOX_DEFAULT_INSTALL_NO_USR
- help
- Disable use of /usr. busybox --install and "make install"
- will install applets only to /bin and /sbin,
- never to /usr/bin or /usr/sbin.
- config BUSYBOX_CONFIG_LOCALE_SUPPORT
- bool "Enable locale support (system needs locale for this to work)"
- default BUSYBOX_DEFAULT_LOCALE_SUPPORT
- help
- Enable this if your system has locale support and you would like
- busybox to support locale settings.
- config BUSYBOX_CONFIG_UNICODE_SUPPORT
- bool "Support Unicode"
- default BUSYBOX_DEFAULT_UNICODE_SUPPORT
- help
- This makes various applets aware that one byte is not
- one character on screen.
- Busybox aims to eventually work correctly with Unicode displays.
- Any older encodings are not guaranteed to work.
- Probably by the time when busybox will be fully Unicode-clean,
- other encodings will be mainly of historic interest.
- config BUSYBOX_CONFIG_UNICODE_USING_LOCALE
- bool "Use libc routines for Unicode (else uses internal ones)"
- default BUSYBOX_DEFAULT_UNICODE_USING_LOCALE
- depends on BUSYBOX_CONFIG_UNICODE_SUPPORT && BUSYBOX_CONFIG_LOCALE_SUPPORT
- help
- With this option on, Unicode support is implemented using libc
- routines. Otherwise, internal implementation is used.
- Internal implementation is smaller.
- config BUSYBOX_CONFIG_FEATURE_CHECK_UNICODE_IN_ENV
- bool "Check $LC_ALL, $LC_CTYPE and $LANG environment variables"
- default BUSYBOX_DEFAULT_FEATURE_CHECK_UNICODE_IN_ENV
- depends on BUSYBOX_CONFIG_UNICODE_SUPPORT && !BUSYBOX_CONFIG_UNICODE_USING_LOCALE
- help
- With this option on, Unicode support is activated
- only if locale-related variables have the value of the form
- "xxxx.utf8"
- Otherwise, Unicode support will be always enabled and active.
- config BUSYBOX_CONFIG_SUBST_WCHAR
- int "Character code to substitute unprintable characters with"
- depends on BUSYBOX_CONFIG_UNICODE_SUPPORT
- default BUSYBOX_DEFAULT_SUBST_WCHAR
- help
- Typical values are 63 for '?' (works with any output device),
- 30 for ASCII substitute control code,
- 65533 (0xfffd) for Unicode replacement character.
- config BUSYBOX_CONFIG_LAST_SUPPORTED_WCHAR
- int "Range of supported Unicode characters"
- depends on BUSYBOX_CONFIG_UNICODE_SUPPORT
- default BUSYBOX_DEFAULT_LAST_SUPPORTED_WCHAR
- help
- Any character with Unicode value bigger than this is assumed
- to be non-printable on output device. Many applets replace
- such chars with substitution character.
- The idea is that many valid printable Unicode chars are
- nevertheless are not displayed correctly. Think about
- combining charachers, double-wide hieroglyphs, obscure
- characters in dozens of ancient scripts...
- Many terminals, terminal emulators, xterms etc will fail
- to handle them correctly. Choose the smallest value
- which suits your needs.
- Typical values are:
- 126 - ASCII only
- 767 (0x2ff) - there are no combining chars in [0..767] range
- (the range includes Latin 1, Latin Ext. A and B),
- code is ~700 bytes smaller for this case.
- 4351 (0x10ff) - there are no double-wide chars in [0..4351] range,
- code is ~300 bytes smaller for this case.
- 12799 (0x31ff) - nearly all non-ideographic characters are
- available in [0..12799] range, including
- East Asian scripts like katakana, hiragana, hangul,
- bopomofo...
- 0 - off, any valid printable Unicode character will be printed.
- config BUSYBOX_CONFIG_UNICODE_COMBINING_WCHARS
- bool "Allow zero-width Unicode characters on output"
- default BUSYBOX_DEFAULT_UNICODE_COMBINING_WCHARS
- depends on BUSYBOX_CONFIG_UNICODE_SUPPORT
- help
- With this option off, any Unicode char with width of 0
- is substituted on output.
- config BUSYBOX_CONFIG_UNICODE_WIDE_WCHARS
- bool "Allow wide Unicode characters on output"
- default BUSYBOX_DEFAULT_UNICODE_WIDE_WCHARS
- depends on BUSYBOX_CONFIG_UNICODE_SUPPORT
- help
- With this option off, any Unicode char with width > 1
- is substituted on output.
- config BUSYBOX_CONFIG_UNICODE_BIDI_SUPPORT
- bool "Bidirectional character-aware line input"
- default BUSYBOX_DEFAULT_UNICODE_BIDI_SUPPORT
- depends on BUSYBOX_CONFIG_UNICODE_SUPPORT && !BUSYBOX_CONFIG_UNICODE_USING_LOCALE
- help
- With this option on, right-to-left Unicode characters
- are treated differently on input (e.g. cursor movement).
- config BUSYBOX_CONFIG_UNICODE_NEUTRAL_TABLE
- bool "In bidi input, support non-ASCII neutral chars too"
- default BUSYBOX_DEFAULT_UNICODE_NEUTRAL_TABLE
- depends on BUSYBOX_CONFIG_UNICODE_BIDI_SUPPORT
- help
- In most cases it's enough to treat only ASCII non-letters
- (i.e. punctuation, numbers and space) as characters
- with neutral directionality.
- With this option on, more extensive (and bigger) table
- of neutral chars will be used.
- config BUSYBOX_CONFIG_UNICODE_PRESERVE_BROKEN
- bool "Make it possible to enter sequences of chars which are not Unicode"
- default BUSYBOX_DEFAULT_UNICODE_PRESERVE_BROKEN
- depends on BUSYBOX_CONFIG_UNICODE_SUPPORT
- help
- With this option on, on line-editing input (such as used by shells)
- invalid UTF-8 bytes are not substituted with the selected
- substitution character.
- For example, this means that entering 'l', 's', ' ', 0xff, [Enter]
- at shell prompt will list file named 0xff (single char name
- with char value 255), not file named '?'.
- config BUSYBOX_CONFIG_PAM
- bool "Support for PAM (Pluggable Authentication Modules)"
- default BUSYBOX_DEFAULT_PAM
- help
- Use PAM in some busybox applets (currently login and httpd) instead
- of direct access to password database.
- config BUSYBOX_CONFIG_FEATURE_USE_SENDFILE
- bool "Use sendfile system call"
- default BUSYBOX_DEFAULT_FEATURE_USE_SENDFILE
- select BUSYBOX_CONFIG_PLATFORM_LINUX
- help
- When enabled, busybox will use the kernel sendfile() function
- instead of read/write loops to copy data between file descriptors
- (for example, cp command does this a lot).
- If sendfile() doesn't work, copying code falls back to read/write
- loop. sendfile() was originally implemented for faster I/O
- from files to sockets, but since Linux 2.6.33 it was extended
- to work for many more file types.
- config BUSYBOX_CONFIG_LONG_OPTS
- bool "Support for --long-options"
- default BUSYBOX_DEFAULT_LONG_OPTS
- help
- Enable this if you want busybox applets to use the gnu --long-option
- style, in addition to single character -a -b -c style options.
- config BUSYBOX_CONFIG_FEATURE_DEVPTS
- bool "Use the devpts filesystem for Unix98 PTYs"
- default BUSYBOX_DEFAULT_FEATURE_DEVPTS
- help
- Enable if you want BusyBox to use Unix98 PTY support. If enabled,
- busybox will use /dev/ptmx for the master side of the pseudoterminal
- and /dev/pts/<number> for the slave side. Otherwise, BSD style
- /dev/ttyp<number> will be used. To use this option, you should have
- devpts mounted.
- config BUSYBOX_CONFIG_FEATURE_CLEAN_UP
- bool "Clean up all memory before exiting (usually not needed)"
- default BUSYBOX_DEFAULT_FEATURE_CLEAN_UP
- help
- As a size optimization, busybox normally exits without explicitly
- freeing dynamically allocated memory or closing files. This saves
- space since the OS will clean up for us, but it can confuse debuggers
- like valgrind, which report tons of memory and resource leaks.
- Don't enable this unless you have a really good reason to clean
- things up manually.
- config BUSYBOX_CONFIG_FEATURE_UTMP
- bool "Support utmp file"
- default BUSYBOX_DEFAULT_FEATURE_UTMP
- help
- The file /var/run/utmp is used to track who is currently logged in.
- With this option on, certain applets (getty, login, telnetd etc)
- will create and delete entries there.
- "who" applet requires this option.
- config BUSYBOX_CONFIG_FEATURE_WTMP
- bool "Support wtmp file"
- default BUSYBOX_DEFAULT_FEATURE_WTMP
- depends on BUSYBOX_CONFIG_FEATURE_UTMP
- help
- The file /var/run/wtmp is used to track when users have logged into
- and logged out of the system.
- With this option on, certain applets (getty, login, telnetd etc)
- will append new entries there.
- "last" applet requires this option.
- config BUSYBOX_CONFIG_FEATURE_PIDFILE
- bool "Support writing pidfiles"
- default BUSYBOX_DEFAULT_FEATURE_PIDFILE
- help
- This option makes some applets (e.g. crond, syslogd, inetd) write
- a pidfile at the configured PID_FILE_PATH. It has no effect
- on applets which require pidfiles to run.
- config BUSYBOX_CONFIG_PID_FILE_PATH
- string "Path to directory for pidfile"
- default BUSYBOX_DEFAULT_PID_FILE_PATH
- depends on BUSYBOX_CONFIG_FEATURE_PIDFILE
- help
- This is the default path where pidfiles are created. Applets which
- allow you to set the pidfile path on the command line will override
- this value. The option has no effect on applets that require you to
- specify a pidfile path.
- config BUSYBOX_CONFIG_FEATURE_SUID
- bool "Support for SUID/SGID handling"
- default BUSYBOX_DEFAULT_FEATURE_SUID
- help
- With this option you can install the busybox binary belonging
- to root with the suid bit set, enabling some applets to perform
- root-level operations even when run by ordinary users
- (for example, mounting of user mounts in fstab needs this).
- Busybox will automatically drop privileges for applets
- that don't need root access.
- If you are really paranoid and don't want to do this, build two
- busybox binaries with different applets in them (and the appropriate
- symlinks pointing to each binary), and only set the suid bit on the
- one that needs it.
- The applets which require root rights (need suid bit or
- to be run by root) and will refuse to execute otherwise:
- crontab, login, passwd, su, vlock, wall.
- The applets which will use root rights if they have them
- (via suid bit, or because run by root), but would try to work
- without root right nevertheless:
- findfs, ping[6], traceroute[6], mount.
- Note that if you DONT select this option, but DO make busybox
- suid root, ALL applets will run under root, which is a huge
- security hole (think "cp /some/file /etc/passwd").
- config BUSYBOX_CONFIG_FEATURE_SUID_CONFIG
- bool "Runtime SUID/SGID configuration via /etc/busybox.conf"
- default BUSYBOX_DEFAULT_FEATURE_SUID_CONFIG
- depends on BUSYBOX_CONFIG_FEATURE_SUID
- help
- 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.)
- The format of this file is as follows:
- APPLET = [Ssx-][Ssx-][x-] [USER.GROUP]
- s: USER or GROUP is allowed to execute APPLET.
- APPLET will run under USER or GROUP
- (reagardless of who's running it).
- S: USER or GROUP is NOT allowed to execute APPLET.
- APPLET will run under USER or GROUP.
- This option is not very sensical.
- x: USER/GROUP/others are allowed to execute APPLET.
- No UID/GID change will be done when it is run.
- -: USER/GROUP/others are not allowed to execute APPLET.
- An example might help:
- [SUID]
- su = ssx root.0 # applet su can be run by anyone and runs with
- # euid=0/egid=0
- su = ssx # exactly the same
- mount = sx- root.disk # applet mount can be run by root and members
- # of group disk (but not anyone else)
- # and runs with euid=0 (egid is not changed)
- cp = --- # disable applet cp for everyone
- The file has to be owned by user root, group root and has to be
- writeable only by root:
- (chown 0.0 /etc/busybox.conf; chmod 600 /etc/busybox.conf)
- The busybox executable has to be owned by user root, group
- root and has to be setuid root for this to work:
- (chown 0.0 /bin/busybox; chmod 4755 /bin/busybox)
- Robert 'sandman' Griebl has more information here:
- <url: http://www.softforge.de/bb/suid.html >.
- config BUSYBOX_CONFIG_FEATURE_SUID_CONFIG_QUIET
- bool "Suppress warning message if /etc/busybox.conf is not readable"
- default BUSYBOX_DEFAULT_FEATURE_SUID_CONFIG_QUIET
- depends on BUSYBOX_CONFIG_FEATURE_SUID_CONFIG
- help
- /etc/busybox.conf should be readable by the user needing the SUID,
- check this option to avoid users to be notified about missing
- permissions.
- config BUSYBOX_CONFIG_SELINUX
- bool "Support NSA Security Enhanced Linux"
- default BUSYBOX_DEFAULT_SELINUX
- select BUSYBOX_CONFIG_PLATFORM_LINUX
- help
- Enable support for SELinux in applets ls, ps, and id. Also provide
- the option of compiling in SELinux applets.
- If you do not have a complete SELinux userland installed, this stuff
- will not compile. Specifially, libselinux 1.28 or better is
- directly required by busybox. If the installation is located in a
- non-standard directory, provide it by invoking make as follows:
- CFLAGS=-I<libselinux-include-path> \
- LDFLAGS=-L<libselinux-lib-path> \
- make
- Most people will leave this set to 'N'.
- config BUSYBOX_CONFIG_FEATURE_PREFER_APPLETS
- bool "exec prefers applets"
- default BUSYBOX_DEFAULT_FEATURE_PREFER_APPLETS
- help
- This is an experimental option which directs applets about to
- call 'exec' to try and find an applicable busybox applet before
- searching the PATH. This is typically done by exec'ing
- /proc/self/exe.
- This may affect shell, find -exec, xargs and similar applets.
- They will use applets even if /bin/<applet> -> busybox link
- is missing (or is not a link to busybox). However, this causes
- problems in chroot jails without mounted /proc and with ps/top
- (command name can be shown as 'exe' for applets started this way).
- config BUSYBOX_CONFIG_BUSYBOX_EXEC_PATH
- string "Path to BusyBox executable"
- default BUSYBOX_DEFAULT_BUSYBOX_EXEC_PATH
- help
- When Busybox applets need to run other busybox applets, BusyBox
- sometimes needs to exec() itself. When the /proc filesystem is
- mounted, /proc/self/exe always points to the currently running
- executable. If you haven't got /proc, set this to wherever you
- want to run BusyBox from.
- # These are auto-selected by other options
- config BUSYBOX_CONFIG_FEATURE_SYSLOG
- bool #No description makes it a hidden option
- default BUSYBOX_DEFAULT_FEATURE_SYSLOG
- #help
- # This option is auto-selected when you select any applet which may
- # send its output to syslog. You do not need to select it manually.
- config BUSYBOX_CONFIG_FEATURE_HAVE_RPC
- bool #No description makes it a hidden option
- default BUSYBOX_DEFAULT_FEATURE_HAVE_RPC
- #help
- # This is automatically selected if any of enabled applets need it.
- # You do not need to select it manually.
- endmenu
- menu 'Build Options'
- config BUSYBOX_CONFIG_STATIC
- bool "Build BusyBox as a static binary (no shared libs)"
- default BUSYBOX_DEFAULT_STATIC
- help
- If you want to build a static BusyBox binary, which does not
- use or require any shared libraries, then enable this option.
- This can cause BusyBox to be considerably larger, so you should
- leave this option false unless you have a good reason (i.e.
- your target platform does not support shared libraries, or
- you are building an initrd which doesn't need anything but
- BusyBox, etc).
- Most people will leave this set to 'N'.
- config BUSYBOX_CONFIG_PIE
- bool "Build BusyBox as a position independent executable"
- default BUSYBOX_DEFAULT_PIE
- depends on !BUSYBOX_CONFIG_STATIC
- help
- Hardened code option. PIE binaries are loaded at a different
- address at each invocation. This has some overhead,
- particularly on x86-32 which is short on registers.
- Most people will leave this set to 'N'.
- config BUSYBOX_CONFIG_NOMMU
- bool "Force NOMMU build"
- default BUSYBOX_DEFAULT_NOMMU
- help
- Busybox tries to detect whether architecture it is being
- built against supports MMU or not. If this detection fails,
- or if you want to build NOMMU version of busybox for testing,
- you may force NOMMU build here.
- Most people will leave this set to 'N'.
- # PIE can be made to work with BUILD_LIBBUSYBOX, but currently
- # build system does not support that
- config BUSYBOX_CONFIG_BUILD_LIBBUSYBOX
- bool "Build shared libbusybox"
- default BUSYBOX_DEFAULT_BUILD_LIBBUSYBOX
- depends on !BUSYBOX_CONFIG_FEATURE_PREFER_APPLETS && !BUSYBOX_CONFIG_PIE && !BUSYBOX_CONFIG_STATIC
- help
- Build a shared library libbusybox.so.N.N.N which contains all
- busybox code.
- This feature allows every applet to be built as a tiny
- separate executable. Enabling it for "one big busybox binary"
- approach serves no purpose and increases code size.
- You should almost certainly say "no" to this.
- ### config FEATURE_FULL_LIBBUSYBOX
- ### bool "Feature-complete libbusybox"
- ### default n if !FEATURE_SHARED_BUSYBOX
- ### depends on BUILD_LIBBUSYBOX
- ### help
- ### Build a libbusybox with the complete feature-set, disregarding
- ### the actually selected config.
- ###
- ### Normally, libbusybox will only contain the features which are
- ### used by busybox itself. If you plan to write a separate
- ### standalone application which uses libbusybox say 'Y'.
- ###
- ### Note: libbusybox is GPL, not LGPL, and exports no stable API that
- ### might act as a copyright barrier. We can and will modify the
- ### exported function set between releases (even minor version number
- ### changes), and happily break out-of-tree features.
- ###
- ### Say 'N' if in doubt.
- config BUSYBOX_CONFIG_FEATURE_INDIVIDUAL
- bool "Produce a binary for each applet, linked against libbusybox"
- default BUSYBOX_DEFAULT_FEATURE_INDIVIDUAL
- depends on BUSYBOX_CONFIG_BUILD_LIBBUSYBOX
- help
- If your CPU architecture doesn't allow for sharing text/rodata
- sections of running binaries, but allows for runtime dynamic
- libraries, this option will allow you to reduce memory footprint
- when you have many different applets running at once.
- If your CPU architecture allows for sharing text/rodata,
- having single binary is more optimal.
- Each applet will be a tiny program, dynamically linked
- against libbusybox.so.N.N.N.
- You need to have a working dynamic linker.
- config BUSYBOX_CONFIG_FEATURE_SHARED_BUSYBOX
- bool "Produce additional busybox binary linked against libbusybox"
- default BUSYBOX_DEFAULT_FEATURE_SHARED_BUSYBOX
- depends on BUSYBOX_CONFIG_BUILD_LIBBUSYBOX
- help
- Build busybox, dynamically linked against libbusybox.so.N.N.N.
- You need to have a working dynamic linker.
- ### config BUILD_AT_ONCE
- ### bool "Compile all sources at once"
- ### default n
- ### help
- ### Normally each source-file is compiled with one invocation of
- ### the compiler.
- ### If you set this option, all sources are compiled at once.
- ### This gives the compiler more opportunities to optimize which can
- ### result in smaller and/or faster binaries.
- ###
- ### Setting this option will consume alot of memory, e.g. if you
- ### enable all applets with all features, gcc uses more than 300MB
- ### RAM during compilation of busybox.
- ###
- ### This option is most likely only beneficial for newer compilers
- ### such as gcc-4.1 and above.
- ###
- ### Say 'N' unless you know what you are doing.
- config BUSYBOX_CONFIG_LFS
- bool
- default BUSYBOX_DEFAULT_LFS
- help
- 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
- library lacks large file support for large files. Some of the
- programs that can benefit from large file support include dd, gzip,
- 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'.
- config BUSYBOX_CONFIG_CROSS_COMPILER_PREFIX
- string "Cross Compiler prefix"
- default BUSYBOX_DEFAULT_CROSS_COMPILER_PREFIX
- help
- If you want to build BusyBox with a cross compiler, then you
- will need to set this to the cross-compiler prefix, for example,
- "i386-uclibc-".
- Note that CROSS_COMPILE environment variable or
- "make CROSS_COMPILE=xxx ..." will override this selection.
- Native builds leave this empty.
- config BUSYBOX_CONFIG_SYSROOT
- string "Path to sysroot"
- default BUSYBOX_DEFAULT_SYSROOT
- help
- If you want to build BusyBox with a cross compiler, then you
- might also need to specify where /usr/include and /usr/lib
- will be found.
- For example, BusyBox can be built against an installed
- Android NDK, platform version 9, for ARM ABI with
- CONFIG_SYSROOT=/opt/android-ndk/platforms/android-9/arch-arm
- Native builds leave this empty.
- config BUSYBOX_CONFIG_EXTRA_CFLAGS
- string "Additional CFLAGS"
- default BUSYBOX_DEFAULT_EXTRA_CFLAGS
- help
- Additional CFLAGS to pass to the compiler verbatim.
- config BUSYBOX_CONFIG_EXTRA_LDFLAGS
- string "Additional LDFLAGS"
- default BUSYBOX_DEFAULT_EXTRA_LDFLAGS
- help
- Additional LDFLAGS to pass to the linker verbatim.
- config BUSYBOX_CONFIG_EXTRA_LDLIBS
- string "Additional LDLIBS"
- default BUSYBOX_DEFAULT_EXTRA_LDLIBS
- help
- Additional LDLIBS to pass to the linker with -l.
- endmenu
- menu 'Debugging Options'
- config BUSYBOX_CONFIG_DEBUG
- bool "Build BusyBox with extra Debugging symbols"
- default BUSYBOX_DEFAULT_DEBUG
- help
- Say Y here if you wish to examine BusyBox internals while applets are
- running. This increases the size of the binary considerably, and
- should only be used when doing development. If you are doing
- development and want to debug BusyBox, answer Y.
- Most people should answer N.
- config BUSYBOX_CONFIG_DEBUG_PESSIMIZE
- bool "Disable compiler optimizations"
- default BUSYBOX_DEFAULT_DEBUG_PESSIMIZE
- depends on BUSYBOX_CONFIG_DEBUG
- help
- The compiler's optimization of source code can eliminate and reorder
- code, resulting in an executable that's hard to understand when
- stepping through it with a debugger. This switches it off, resulting
- in a much bigger executable that more closely matches the source
- code.
- config BUSYBOX_CONFIG_UNIT_TEST
- bool "Build unit tests"
- default BUSYBOX_DEFAULT_UNIT_TEST
- help
- Say Y here if you want to build unit tests (both the framework and
- test cases) as a Busybox applet. This results in bigger code, so you
- probably don't want this option in production builds.
- config BUSYBOX_CONFIG_WERROR
- bool "Abort compilation on any warning"
- default BUSYBOX_DEFAULT_WERROR
- help
- Selecting this will add -Werror to gcc command line.
- Most people should answer N.
- choice
- prompt "Additional debugging library"
- default BUSYBOX_CONFIG_NO_DEBUG_LIB
- help
- Using an additional debugging library will make BusyBox become
- considerable larger and will cause it to run more slowly. You
- should always leave this option disabled for production use.
- dmalloc support:
- ----------------
- This enables compiling with dmalloc ( http://dmalloc.com/ )
- which is an excellent public domain mem leak and malloc problem
- detector. To enable dmalloc, before running busybox you will
- want to properly set your environment, for example:
- export DMALLOC_OPTIONS=debug=0x34f47d83,inter=100,log=logfile
- 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 -p check-fence -p check-heap \
- -p check-lists -p check-blank -p check-funcs -p realloc-copy \
- -p allow-free-null
- Electric-fence support:
- -----------------------
- This enables compiling with Electric-fence support. Electric
- fence is another very useful malloc debugging library which uses
- your computer's virtual memory hardware to detect illegal memory
- accesses. This support will make BusyBox be considerable larger
- and run slower, so you should leave this option disabled unless
- you are hunting a hard to find memory problem.
- config BUSYBOX_CONFIG_NO_DEBUG_LIB
- bool "None"
- config BUSYBOX_CONFIG_DMALLOC
- bool "Dmalloc"
- config BUSYBOX_CONFIG_EFENCE
- bool "Electric-fence"
- endchoice
- endmenu
- menu 'Installation Options ("make install" behavior)'
- choice
- prompt "What kind of applet links to install"
- default BUSYBOX_CONFIG_INSTALL_APPLET_SYMLINKS
- help
- Choose what kind of links to applets are created by "make install".
- config BUSYBOX_CONFIG_INSTALL_APPLET_SYMLINKS
- bool "as soft-links"
- help
- Install applets as soft-links to the busybox binary. This needs some
- free inodes on the filesystem, but might help with filesystem
- generators that can't cope with hard-links.
- config BUSYBOX_CONFIG_INSTALL_APPLET_HARDLINKS
- bool "as hard-links"
- help
- Install applets as hard-links to the busybox binary. This might
- count on a filesystem with few inodes.
- config BUSYBOX_CONFIG_INSTALL_APPLET_SCRIPT_WRAPPERS
- bool "as script wrappers"
- help
- Install applets as script wrappers that call the busybox binary.
- config BUSYBOX_CONFIG_INSTALL_APPLET_DONT
- bool "not installed"
- help
- Do not install applet links. Useful when you plan to use
- busybox --install for installing links, or plan to use
- a standalone shell and thus don't need applet links.
- endchoice
- choice
- prompt "/bin/sh applet link"
- default BUSYBOX_CONFIG_INSTALL_SH_APPLET_SYMLINK
- depends on BUSYBOX_CONFIG_INSTALL_APPLET_SCRIPT_WRAPPERS
- help
- Choose how you install /bin/sh applet link.
- config BUSYBOX_CONFIG_INSTALL_SH_APPLET_SYMLINK
- bool "as soft-link"
- help
- Install /bin/sh applet as soft-link to the busybox binary.
- config BUSYBOX_CONFIG_INSTALL_SH_APPLET_HARDLINK
- bool "as hard-link"
- help
- Install /bin/sh applet as hard-link to the busybox binary.
- config BUSYBOX_CONFIG_INSTALL_SH_APPLET_SCRIPT_WRAPPER
- bool "as script wrapper"
- help
- Install /bin/sh applet as script wrapper that calls
- the busybox binary.
- endchoice
- config BUSYBOX_CONFIG_PREFIX
- string "BusyBox installation prefix"
- default BUSYBOX_DEFAULT_PREFIX
- help
- Define your directory to install BusyBox files/subdirs in.
- endmenu
- source libbb/Config.in
- endmenu
- comment "Applets"
- source archival/Config.in
- source coreutils/Config.in
- source console-tools/Config.in
- source debianutils/Config.in
- source editors/Config.in
- source findutils/Config.in
- source init/Config.in
- source loginutils/Config.in
- source e2fsprogs/Config.in
- source modutils/Config.in
- source util-linux/Config.in
- source miscutils/Config.in
- source networking/Config.in
- source printutils/Config.in
- source mailutils/Config.in
- source procps/Config.in
- source runit/Config.in
- source selinux/Config.in
- source shell/Config.in
- source sysklogd/Config.in
|