diff options
Diffstat (limited to 'busybox.kconfig')
-rw-r--r-- | busybox.kconfig | 141 |
1 files changed, 82 insertions, 59 deletions
diff --git a/busybox.kconfig b/busybox.kconfig index 3317df2..b3df6d4 100644 --- a/busybox.kconfig +++ b/busybox.kconfig @@ -43,14 +43,13 @@ config KEMBTK_BUSYB_INCLUDE_SUSv2 config KEMBTK_BUSYB_USE_PORTABLE_CODE bool "Avoid using GCC-specific code constructs" - depends on EMBTK_BB_VERSION_1_16_X || EMBTK_BB_VERSION_1_17_X || EMBTK_BB_VERSION_1_18_X 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 KEMBTK_BUSYB_PLATFORM_LINUX - bool + bool "Enable Linux-specific applets and features" default y help For the most part, busybox requires only POSIX compatibility @@ -84,20 +83,21 @@ config KEMBTK_BUSYB_FEATURE_BUFFERS_GO_IN_BSS endchoice config KEMBTK_BUSYB_SHOW_USAGE - bool "Show terse applet usage messages" + bool "Show applet usage messages" default y help - All BusyBox applets will show help messages when invoked with - wrong arguments. You can turn off printing these terse usage - messages if you say no here. - This will save you up to 7k. + 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 KEMBTK_BUSYB_FEATURE_VERBOSE_USAGE bool "Show verbose applet usage messages" default y depends on KEMBTK_BUSYB_SHOW_USAGE help - All BusyBox applets will show more verbose help messages when + 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. @@ -107,8 +107,8 @@ config KEMBTK_BUSYB_FEATURE_COMPRESS_USAGE default y depends on KEMBTK_BUSYB_SHOW_USAGE help - Store usage messages in compressed form, uncompress them on-the-fly - when <applet> --help is called. + 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 @@ -137,14 +137,8 @@ config KEMBTK_BUSYB_LOCALE_SUPPORT Enable this if your system has locale support and you would like busybox to support locale settings. -config KEMBTK_BUSYB_FEATURE_ASSUME_UNICODE - bool - help - backward compatibility for busybox-1.{13,14,15,16}.x - config KEMBTK_BUSYB_UNICODE_SUPPORT bool "Support Unicode" - select KEMBTK_BUSYB_FEATURE_ASSUME_UNICODE default y help This makes various applets aware that one byte is not @@ -158,7 +152,6 @@ config KEMBTK_BUSYB_UNICODE_SUPPORT config KEMBTK_BUSYB_UNICODE_USING_LOCALE bool "Use libc routines for Unicode (else uses internal ones)" depends on KEMBTK_BUSYB_UNICODE_SUPPORT && KEMBTK_BUSYB_LOCALE_SUPPORT - depends on EMBTK_BB_VERSION_1_17_X || EMBTK_BB_VERSION_1_18_X help With this option on, Unicode support is implemented using libc routines. Otherwise, internal implementation is used. @@ -166,24 +159,16 @@ config KEMBTK_BUSYB_UNICODE_USING_LOCALE config KEMBTK_BUSYB_FEATURE_CHECK_UNICODE_IN_ENV bool "Check $LANG environment variable" - depends on KEMBTK_BUSYB_UNICODE_SUPPORT && !(KEMBTK_BUSYB_UNICODE_USING_LOCALE || KEMBTK_BUSYB_UNICODE_USING_LOCALE) - depends on EMBTK_BB_VERSION_1_15_X || EMBTK_BB_VERSION_1_16_X || EMBTK_BB_VERSION_1_17_X || EMBTK_BB_VERSION_1_18_X + depends on KEMBTK_BUSYB_UNICODE_SUPPORT && !KEMBTK_BUSYB_UNICODE_USING_LOCALE help With this option on, Unicode support is activated only if LANG variable has the value of the form "xxxx.utf8" Otherwise, Unicode support will be always enabled and active. -config KEMBTK_BUSYB_GETOPT_LONG - bool - default n - help - backward compatibility for busybox-1.{13,14}.x - config KEMBTK_BUSYB_SUBST_WCHAR int "Character code to substitute unprintable characters with" depends on KEMBTK_BUSYB_UNICODE_SUPPORT - depends on EMBTK_BB_VERSION_1_17_X || EMBTK_BB_VERSION_1_18_X default 63 help Typical values are 63 for '?' (works with any output device), @@ -193,7 +178,6 @@ config KEMBTK_BUSYB_SUBST_WCHAR config KEMBTK_BUSYB_LAST_SUPPORTED_WCHAR int "Range of supported Unicode characters" depends on KEMBTK_BUSYB_UNICODE_SUPPORT - depends on EMBTK_BB_VERSION_1_17_X || EMBTK_BB_VERSION_1_18_X default 767 help Any character with Unicode value bigger than this is assumed @@ -224,7 +208,6 @@ config KEMBTK_BUSYB_LAST_SUPPORTED_WCHAR config KEMBTK_BUSYB_UNICODE_COMBINING_WCHARS bool "Allow zero-width Unicode characters on output" depends on KEMBTK_BUSYB_UNICODE_SUPPORT - depends on EMBTK_BB_VERSION_1_17_X || EMBTK_BB_VERSION_1_18_X help With this option off, any Unicode char with width of 0 is substituted on output. @@ -232,7 +215,6 @@ config KEMBTK_BUSYB_UNICODE_COMBINING_WCHARS config KEMBTK_BUSYB_UNICODE_WIDE_WCHARS bool "Allow wide Unicode characters on output" depends on KEMBTK_BUSYB_UNICODE_SUPPORT - depends on EMBTK_BB_VERSION_1_17_X || EMBTK_BB_VERSION_1_18_X help With this option off, any Unicode char with width > 1 is substituted on output. @@ -240,7 +222,6 @@ config KEMBTK_BUSYB_UNICODE_WIDE_WCHARS config KEMBTK_BUSYB_UNICODE_BIDI_SUPPORT bool "Bidirectional character-aware line input" depends on KEMBTK_BUSYB_UNICODE_SUPPORT && !KEMBTK_BUSYB_UNICODE_USING_LOCALE - depends on EMBTK_BB_VERSION_1_17_X || EMBTK_BB_VERSION_1_18_X help With this option on, right-to-left Unicode characters are treated differently on input (e.g. cursor movement). @@ -248,7 +229,6 @@ config KEMBTK_BUSYB_UNICODE_BIDI_SUPPORT config KEMBTK_BUSYB_UNICODE_NEUTRAL_TABLE bool "In bidi input, support non-ASCII neutral chars too" depends on KEMBTK_BUSYB_UNICODE_BIDI_SUPPORT - depends on EMBTK_BB_VERSION_1_17_X || EMBTK_BB_VERSION_1_18_X help In most cases it's enough to treat only ASCII non-letters (i.e. punctuation, numbers and space) as characters @@ -259,10 +239,10 @@ config KEMBTK_BUSYB_UNICODE_NEUTRAL_TABLE config KEMBTK_BUSYB_UNICODE_PRESERVE_BROKEN bool "Make it possible to enter sequences of chars which are not Unicode" depends on KEMBTK_BUSYB_UNICODE_SUPPORT - depends on EMBTK_BB_VERSION_1_17_X || EMBTK_BB_VERSION_1_18_X help - With this option on, invalid UTF-8 bytes are not substituted - with the selected substitution character. + 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 '?'. @@ -295,10 +275,19 @@ config KEMBTK_BUSYB_FEATURE_CLEAN_UP Don't enable this unless you have a really good reason to clean things up manually. +config KEMBTK_BUSYB_FEATURE_UTMP + bool "Support utmp file" + default y + 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 KEMBTK_BUSYB_FEATURE_WTMP bool "Support wtmp file" default y - select KEMBTK_BUSYB_FEATURE_UTMP + depends on KEMBTK_BUSYB_FEATURE_UTMP help The file /var/run/wtmp is used to track when users have logged into and logged out of the system. @@ -306,15 +295,6 @@ config KEMBTK_BUSYB_FEATURE_WTMP will append new entries there. "last" applet requires this option. -config KEMBTK_BUSYB_FEATURE_UTMP - bool "Support utmp file" - default y - 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 KEMBTK_BUSYB_FEATURE_PIDFILE bool "Support writing pidfiles" default y @@ -339,21 +319,39 @@ config KEMBTK_BUSYB_FEATURE_SUID 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 are: + 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. - crontab, dnsd, findfs, ipcrm, ipcs, login, passwd, ping, su, - traceroute, vlock. + 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 KEMBTK_BUSYB_FEATURE_SUID_CONFIG bool "Runtime KEMBTK_BUSYB_SUID/SGID configuration via /etc/busybox.conf" - default y if KEMBTK_BUSYB_FEATURE_SUID + default y depends on KEMBTK_BUSYB_FEATURE_SUID help Allow the KEMBTK_BUSYB_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-] (<username>|<uid>).(<groupname>|<gid>) + 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: @@ -363,7 +361,8 @@ config KEMBTK_BUSYB_FEATURE_SUID_CONFIG su = ssx # exactly the same mount = sx- root.disk # applet mount can be run by root and members - # of group disk and runs with euid=0 + # of group disk (but not anyone else) + # and runs with euid=0 (egid is not changed) cp = --- # disable applet cp for everyone @@ -388,7 +387,7 @@ config KEMBTK_BUSYB_FEATURE_SUID_CONFIG_QUIET config KEMBTK_BUSYB_SELINUX bool "Support NSA Security Enhanced Linux" - depends on KEMBTK_BUSYB_PLATFORM_LINUX + select KEMBTK_BUSYB_PLATFORM_LINUX help Enable support for SELinux in applets ls, ps, and id. Also provide the option of compiling in SELinux applets. @@ -465,7 +464,10 @@ config KEMBTK_BUSYB_PIE bool "Build BusyBox as a position independent executable" depends on !KEMBTK_BUSYB_STATIC help - (TODO: what is it and why/when is it useful?) + Hardened code option. KEMBTK_BUSYB_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 KEMBTK_BUSYB_NOMMU @@ -558,7 +560,6 @@ config KEMBTK_BUSYB_FEATURE_SHARED_BUSYBOX config KEMBTK_BUSYB_LFS bool "Build with Large File Support (for accessing files > 2 GB)" default y - select KEMBTK_BUSYB_FDISK_SUPPORT_LARGE_DISKS 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 @@ -568,7 +569,7 @@ config KEMBTK_BUSYB_LFS than 2 Gigabytes, enable this option. Otherwise, leave it set to 'N'. config KEMBTK_BUSYB_CROSS_COMPILER_PREFIX - string + string "Cross Compiler prefix" default "" help If you want to build BusyBox with a cross compiler, then you @@ -580,13 +581,39 @@ config KEMBTK_BUSYB_CROSS_COMPILER_PREFIX Native builds leave this empty. +config KEMBTK_BUSYB_SYSROOT + string + default "" + 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 KEMBTK_BUSYB_ARM ABI with + + CONFIG_SYSROOT=/opt/android-ndk/platforms/android-9/arch-arm + + Native builds leave this empty. + config KEMBTK_BUSYB_EXTRA_CFLAGS string - depends on EMBTK_BB_VERSION_1_14_X || EMBTK_BB_VERSION_1_15_X || EMBTK_BB_VERSION_1_16_X || EMBTK_BB_VERSION_1_17_X || EMBTK_BB_VERSION_1_18_X default "" help Additional CFLAGS to pass to the compiler verbatim. +config KEMBTK_BUSYB_EXTRA_LDFLAGS + string + default "" + help + Additional LDFLAGS to pass to the linker verbatim. + +config KEMBTK_BUSYB_EXTRA_LDLIBS + string + default "" + help + Additional LDLIBS to pass to the linker with -l. + comment "-------------------------------------------------" comment 'Debugging Options' @@ -660,9 +687,6 @@ config KEMBTK_BUSYB_EFENCE endchoice -### config PARSE -### bool "Uniform config file parser debugging applet: parse" - comment "-------------------------------------------------" comment 'Installation Options ("make install" behavior)' @@ -693,7 +717,6 @@ config KEMBTK_BUSYB_INSTALL_APPLET_SCRIPT_WRAPPERS config KEMBTK_BUSYB_INSTALL_APPLET_DONT bool "not installed" - depends on KEMBTK_BUSYB_FEATURE_INSTALLER || KEMBTK_BUSYB_FEATURE_SH_STANDALONE || KEMBTK_BUSYB_FEATURE_PREFER_APPLETS help Do not install applet links. Useful when you plan to use busybox --install for installing links, or plan to use |