2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
8 config BUSYBOX_CONFIG_BASENAME
12 basename is used to strip the directory and suffix from filenames,
13 leaving just the filename itself. Enable this option if you wish
14 to enable the 'basename' utility.
15 config BUSYBOX_CONFIG_CAT
19 cat is used to concatenate files and print them to the standard
20 output. Enable this option if you wish to enable the 'cat' utility.
21 config BUSYBOX_CONFIG_DATE
25 date is used to set the system date or display the
26 current time in the given format.
28 config BUSYBOX_CONFIG_FEATURE_DATE_ISOFMT
29 bool "Enable ISO date format output (-I)"
31 depends on BUSYBOX_CONFIG_DATE
33 Enable option (-I) to output an ISO-8601 compliant
36 config BUSYBOX_CONFIG_FEATURE_DATE_NANO
37 bool "Support %[num]N nanosecond format specifier"
39 depends on BUSYBOX_CONFIG_DATE && BUSYBOX_CONFIG_PLATFORM_LINUX
41 Support %[num]N format specifier. Adds ~250 bytes of code.
43 config BUSYBOX_CONFIG_FEATURE_DATE_COMPAT
44 bool "Support weird 'date MMDDhhmm[[YY]YY][.ss]' format"
46 depends on BUSYBOX_CONFIG_DATE
48 System time can be set by 'date -s DATE' and simply 'date DATE',
49 but formats of DATE string are different. 'date DATE' accepts
50 a rather weird MMDDhhmm[[YY]YY][.ss] format with completely
51 unnatural placement of year between minutes and seconds.
52 date -s (and other commands like touch -d) use more sensible
53 formats (for one, ISO format YYYY-MM-DD hh:mm:ss.ssssss).
55 With this option off, 'date DATE' is 'date -s DATE' support
56 the same format. With it on, 'date DATE' additionally supports
57 MMDDhhmm[[YY]YY][.ss] format.
59 config BUSYBOX_CONFIG_TEST
63 test is used to check file types and compare values,
64 returning an appropriate exit code. The bash shell
65 has test built in, ash can build it in optionally.
67 config BUSYBOX_CONFIG_FEATURE_TEST_64
68 bool "Extend test to 64 bit"
70 depends on BUSYBOX_CONFIG_TEST || BUSYBOX_CONFIG_ASH_BUILTIN_TEST || BUSYBOX_CONFIG_HUSH
72 Enable 64-bit support in test.
74 config BUSYBOX_CONFIG_TR
78 tr is used to squeeze, and/or delete characters from standard
79 input, writing to standard output.
81 config BUSYBOX_CONFIG_FEATURE_TR_CLASSES
82 bool "Enable character classes (such as [:upper:])"
84 depends on BUSYBOX_CONFIG_TR
86 Enable character classes, enabling commands such as:
87 tr [:upper:] [:lower:] to convert input into lowercase.
89 config BUSYBOX_CONFIG_FEATURE_TR_EQUIV
90 bool "Enable equivalence classes"
92 depends on BUSYBOX_CONFIG_TR
94 Enable equivalence classes, which essentially add the enclosed
95 character to the current set. For instance, tr [=a=] xyz would
96 replace all instances of 'a' with 'xyz'. This option is mainly
97 useful for cases when no other way of expressing a character
99 config BUSYBOX_CONFIG_BASE64
103 Base64 encode and decode
105 config BUSYBOX_CONFIG_CAL
109 cal is used to display a monthly calender.
111 config BUSYBOX_CONFIG_CATV
115 Display nonprinting characters as escape sequences (like some
116 implementations' cat -v option).
118 config BUSYBOX_CONFIG_CHGRP
122 chgrp is used to change the group ownership of files.
124 config BUSYBOX_CONFIG_CHMOD
128 chmod is used to change the access permission of files.
130 config BUSYBOX_CONFIG_CHOWN
134 chown is used to change the user and/or group ownership
137 config BUSYBOX_CONFIG_FEATURE_CHOWN_LONG_OPTIONS
138 bool "Enable long options"
140 depends on BUSYBOX_CONFIG_CHOWN && BUSYBOX_CONFIG_LONG_OPTS
142 Enable use of long options
144 config BUSYBOX_CONFIG_CHROOT
148 chroot is used to change the root directory and run a command.
149 The default command is `/bin/sh'.
151 config BUSYBOX_CONFIG_CKSUM
155 cksum is used to calculate the CRC32 checksum of a file.
157 config BUSYBOX_CONFIG_COMM
161 comm is used to compare two files line by line and return
162 a three-column output.
164 config BUSYBOX_CONFIG_CP
168 cp is used to copy files and directories.
170 config BUSYBOX_CONFIG_FEATURE_CP_LONG_OPTIONS
171 bool "Enable long options for cp"
173 depends on BUSYBOX_CONFIG_CP && BUSYBOX_CONFIG_LONG_OPTS
175 Enable long options for cp.
176 Also add support for --parents option.
178 config BUSYBOX_CONFIG_CUT
182 cut is used to print selected parts of lines from
185 config BUSYBOX_CONFIG_DD
189 dd copies a file (from standard input to standard output,
190 by default) using specific input and output blocksizes,
191 while optionally performing conversions on it.
193 config BUSYBOX_CONFIG_FEATURE_DD_SIGNAL_HANDLING
194 bool "Enable DD signal handling for status reporting"
196 depends on BUSYBOX_CONFIG_DD
198 Sending a SIGUSR1 signal to a running `dd' process makes it
199 print to standard error the number of records read and written
200 so far, then to resume copying.
202 $ dd if=/dev/zero of=/dev/null&
203 $ pid=$! kill -USR1 $pid; sleep 1; kill $pid
204 10899206+0 records in
205 10899206+0 records out
207 config BUSYBOX_CONFIG_FEATURE_DD_THIRD_STATUS_LINE
208 bool "Enable the third status line upon signal"
210 depends on BUSYBOX_CONFIG_DD && BUSYBOX_CONFIG_FEATURE_DD_SIGNAL_HANDLING
212 Displays a coreutils-like third status line with transferred bytes,
213 elapsed time and speed.
215 config BUSYBOX_CONFIG_FEATURE_DD_IBS_OBS
216 bool "Enable ibs, obs and conv options"
218 depends on BUSYBOX_CONFIG_DD
220 Enables support for writing a certain number of bytes in and out,
221 at a time, and performing conversions on the data stream.
223 config BUSYBOX_CONFIG_DF
227 df reports the amount of disk space used and available
230 config BUSYBOX_CONFIG_FEATURE_DF_FANCY
231 bool "Enable -a, -i, -B"
233 depends on BUSYBOX_CONFIG_DF
235 This option enables -a, -i and -B.
237 -a Show all filesystems
241 config BUSYBOX_CONFIG_DIRNAME
245 dirname is used to strip a non-directory suffix from
248 config BUSYBOX_CONFIG_DOS2UNIX
249 bool "dos2unix/unix2dos"
252 dos2unix is used to convert a text file from DOS format to
253 UNIX format, and vice versa.
255 config BUSYBOX_CONFIG_UNIX2DOS
258 depends on BUSYBOX_CONFIG_DOS2UNIX
260 unix2dos is used to convert a text file from UNIX format to
261 DOS format, and vice versa.
263 config BUSYBOX_CONFIG_DU
264 bool "du (default blocksize of 512 bytes)"
267 du is used to report the amount of disk space used
270 config BUSYBOX_CONFIG_FEATURE_DU_DEFAULT_BLOCKSIZE_1K
271 bool "Use a default blocksize of 1024 bytes (1K)"
273 depends on BUSYBOX_CONFIG_DU
275 Use a blocksize of (1K) instead of the default 512b.
277 config BUSYBOX_CONFIG_ECHO
278 bool "echo (basic SuSv3 version taking no options)"
281 echo is used to print a specified string to stdout.
283 # this entry also appears in shell/Config.in, next to the echo builtin
284 config BUSYBOX_CONFIG_FEATURE_FANCY_ECHO
285 bool "Enable echo options (-n and -e)"
287 depends on BUSYBOX_CONFIG_ECHO || BUSYBOX_CONFIG_ASH_BUILTIN_ECHO || BUSYBOX_CONFIG_HUSH
289 This adds options (-n and -e) to echo.
291 config BUSYBOX_CONFIG_ENV
295 env is used to set an environment variable and run
296 a command; without options it displays the current
299 config BUSYBOX_CONFIG_FEATURE_ENV_LONG_OPTIONS
300 bool "Enable long options"
302 depends on BUSYBOX_CONFIG_ENV && BUSYBOX_CONFIG_LONG_OPTS
304 Support long options for the env applet.
306 config BUSYBOX_CONFIG_EXPAND
310 By default, convert all tabs to spaces.
312 config BUSYBOX_CONFIG_FEATURE_EXPAND_LONG_OPTIONS
313 bool "Enable long options"
315 depends on BUSYBOX_CONFIG_EXPAND && BUSYBOX_CONFIG_LONG_OPTS
317 Support long options for the expand applet.
319 config BUSYBOX_CONFIG_EXPR
323 expr is used to calculate numbers and print the result
326 config BUSYBOX_CONFIG_EXPR_MATH_SUPPORT_64
327 bool "Extend Posix numbers support to 64 bit"
329 depends on BUSYBOX_CONFIG_EXPR
331 Enable 64-bit math support in the expr applet. This will make
332 the applet slightly larger, but will allow computation with very
335 config BUSYBOX_CONFIG_FALSE
339 false returns an exit code of FALSE (1).
341 config BUSYBOX_CONFIG_FOLD
345 Wrap text to fit a specific width.
347 config BUSYBOX_CONFIG_FSYNC
351 fsync is used to flush file-related cached blocks to disk.
353 config BUSYBOX_CONFIG_HEAD
357 head is used to print the first specified number of lines
360 config BUSYBOX_CONFIG_FEATURE_FANCY_HEAD
361 bool "Enable head options (-c, -q, and -v)"
363 depends on BUSYBOX_CONFIG_HEAD
365 This enables the head options (-c, -q, and -v).
367 config BUSYBOX_CONFIG_HOSTID
371 hostid prints the numeric identifier (in hexadecimal) for
374 config BUSYBOX_CONFIG_ID
378 id displays the current user and group ID names.
380 config BUSYBOX_CONFIG_INSTALL
384 Copy files and set attributes.
386 config BUSYBOX_CONFIG_FEATURE_INSTALL_LONG_OPTIONS
387 bool "Enable long options"
389 depends on BUSYBOX_CONFIG_INSTALL && BUSYBOX_CONFIG_LONG_OPTS
391 Support long options for the install applet.
393 config BUSYBOX_CONFIG_LENGTH
397 length is used to print out the length of a specified string.
399 config BUSYBOX_CONFIG_LN
403 ln is used to create hard or soft links between files.
405 config BUSYBOX_CONFIG_LOGNAME
409 logname is used to print the current user's login name.
411 config BUSYBOX_CONFIG_LS
415 ls is used to list the contents of directories.
417 config BUSYBOX_CONFIG_FEATURE_LS_FILETYPES
418 bool "Enable filetyping options (-p and -F)"
420 depends on BUSYBOX_CONFIG_LS
422 Enable the ls options (-p and -F).
424 config BUSYBOX_CONFIG_FEATURE_LS_FOLLOWLINKS
425 bool "Enable symlinks dereferencing (-L)"
427 depends on BUSYBOX_CONFIG_LS
429 Enable the ls option (-L).
431 config BUSYBOX_CONFIG_FEATURE_LS_RECURSIVE
432 bool "Enable recursion (-R)"
434 depends on BUSYBOX_CONFIG_LS
436 Enable the ls option (-R).
438 config BUSYBOX_CONFIG_FEATURE_LS_SORTFILES
439 bool "Sort the file names"
441 depends on BUSYBOX_CONFIG_LS
443 Allow ls to sort file names alphabetically.
445 config BUSYBOX_CONFIG_FEATURE_LS_TIMESTAMPS
446 bool "Show file timestamps"
448 depends on BUSYBOX_CONFIG_LS
450 Allow ls to display timestamps for files.
452 config BUSYBOX_CONFIG_FEATURE_LS_USERNAME
453 bool "Show username/groupnames"
455 depends on BUSYBOX_CONFIG_LS
457 Allow ls to display username/groupname for files.
459 config BUSYBOX_CONFIG_FEATURE_LS_COLOR
460 bool "Allow use of color to identify file types"
462 depends on BUSYBOX_CONFIG_LS && BUSYBOX_CONFIG_LONG_OPTS
464 This enables the --color option to ls.
466 config BUSYBOX_CONFIG_FEATURE_LS_COLOR_IS_DEFAULT
467 bool "Produce colored ls output by default"
469 depends on BUSYBOX_CONFIG_FEATURE_LS_COLOR
471 Saying yes here will turn coloring on by default,
472 even if no "--color" option is given to the ls command.
473 This is not recommended, since the colors are not
474 configurable, and the output may not be legible on
477 config BUSYBOX_CONFIG_MD5SUM
481 md5sum is used to print or check MD5 checksums.
483 config BUSYBOX_CONFIG_MKDIR
487 mkdir is used to create directories with the specified names.
489 config BUSYBOX_CONFIG_FEATURE_MKDIR_LONG_OPTIONS
490 bool "Enable long options"
492 depends on BUSYBOX_CONFIG_MKDIR && BUSYBOX_CONFIG_LONG_OPTS
494 Support long options for the mkdir applet.
496 config BUSYBOX_CONFIG_MKFIFO
500 mkfifo is used to create FIFOs (named pipes).
501 The `mknod' program can also create FIFOs.
503 config BUSYBOX_CONFIG_MKNOD
507 mknod is used to create FIFOs or block/character special
508 files with the specified names.
510 config BUSYBOX_CONFIG_MV
514 mv is used to move or rename files or directories.
516 config BUSYBOX_CONFIG_FEATURE_MV_LONG_OPTIONS
517 bool "Enable long options"
519 depends on BUSYBOX_CONFIG_MV && BUSYBOX_CONFIG_LONG_OPTS
521 Support long options for the mv applet.
523 config BUSYBOX_CONFIG_NICE
527 nice runs a program with modified scheduling priority.
529 config BUSYBOX_CONFIG_NOHUP
533 run a command immune to hangups, with output to a non-tty.
535 config BUSYBOX_CONFIG_OD
539 od is used to dump binary files in octal and other formats.
541 config BUSYBOX_CONFIG_PRINTENV
545 printenv is used to print all or part of environment.
547 config BUSYBOX_CONFIG_PRINTF
551 printf is used to format and print specified strings.
552 It's similar to `echo' except it has more options.
554 config BUSYBOX_CONFIG_PWD
558 pwd is used to print the current directory.
560 config BUSYBOX_CONFIG_READLINK
564 This program reads a symbolic link and returns the name
565 of the file it points to
567 config BUSYBOX_CONFIG_FEATURE_READLINK_FOLLOW
568 bool "Enable canonicalization by following all symlinks (-f)"
570 depends on BUSYBOX_CONFIG_READLINK
572 Enable the readlink option (-f).
574 config BUSYBOX_CONFIG_REALPATH
578 Return the canonicalized absolute pathname.
579 This isn't provided by GNU shellutils, but where else does it belong.
581 config BUSYBOX_CONFIG_RM
585 rm is used to remove files or directories.
587 config BUSYBOX_CONFIG_RMDIR
591 rmdir is used to remove empty directories.
593 config BUSYBOX_CONFIG_FEATURE_RMDIR_LONG_OPTIONS
594 bool "Enable long options"
596 depends on BUSYBOX_CONFIG_RMDIR && BUSYBOX_CONFIG_LONG_OPTS
598 Support long options for the rmdir applet, including
599 --ignore-fail-on-non-empty for compatibility with GNU rmdir.
601 config BUSYBOX_CONFIG_SEQ
605 print a sequence of numbers
607 config BUSYBOX_CONFIG_SHA1SUM
611 Compute and check SHA1 message digest
613 config BUSYBOX_CONFIG_SHA256SUM
617 Compute and check SHA256 message digest
619 config BUSYBOX_CONFIG_SHA512SUM
623 Compute and check SHA512 message digest
625 config BUSYBOX_CONFIG_SLEEP
629 sleep is used to pause for a specified number of seconds.
630 It comes in 3 versions:
631 - small: takes one integer parameter
632 - fancy: takes multiple integer arguments with suffixes:
634 - fancy with fractional numbers:
635 sleep 2.3s 4.5h sleeps for 16202.3 seconds
636 Last one is "the most compatible" with coreutils sleep,
637 but it adds around 1k of code.
639 config BUSYBOX_CONFIG_FEATURE_FANCY_SLEEP
640 bool "Enable multiple arguments and s/m/h/d suffixes"
642 depends on BUSYBOX_CONFIG_SLEEP
644 Allow sleep to pause for specified minutes, hours, and days.
646 config BUSYBOX_CONFIG_FEATURE_FLOAT_SLEEP
647 bool "Enable fractional arguments"
649 depends on BUSYBOX_CONFIG_FEATURE_FANCY_SLEEP
651 Allow for fractional numeric parameters.
653 config BUSYBOX_CONFIG_SORT
657 sort is used to sort lines of text in specified files.
659 config BUSYBOX_CONFIG_FEATURE_SORT_BIG
660 bool "Full SuSv3 compliant sort (support -ktcsbdfiozgM)"
662 depends on BUSYBOX_CONFIG_SORT
664 Without this, sort only supports -r, -u, and an integer version
665 of -n. Selecting this adds sort keys, floating point support, and
666 more. This adds a little over 3k to a nonstatic build on x86.
668 The SuSv3 sort standard is available at:
669 http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
671 config BUSYBOX_CONFIG_SPLIT
675 split a file into pieces.
677 config BUSYBOX_CONFIG_FEATURE_SPLIT_FANCY
678 bool "Fancy extensions"
680 depends on BUSYBOX_CONFIG_SPLIT
682 Add support for features not required by SUSv3.
683 Supports additional suffixes 'b' for 512 bytes,
684 'g' for 1GiB for the -b option.
686 config BUSYBOX_CONFIG_STAT
689 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
691 display file or filesystem status.
693 config BUSYBOX_CONFIG_FEATURE_STAT_FORMAT
694 bool "Enable custom formats (-c)"
696 depends on BUSYBOX_CONFIG_STAT
698 Without this, stat will not support the '-c format' option where
699 users can pass a custom format string for output. This adds about
700 7k to a nonstatic build on amd64.
702 config BUSYBOX_CONFIG_STTY
706 stty is used to change and print terminal line settings.
708 config BUSYBOX_CONFIG_SUM
712 checksum and count the blocks in a file
714 config BUSYBOX_CONFIG_SYNC
718 sync is used to flush filesystem buffers.
720 config BUSYBOX_CONFIG_TAC
724 tac is used to concatenate and print files in reverse.
726 config BUSYBOX_CONFIG_TAIL
730 tail is used to print the last specified number of lines
733 config BUSYBOX_CONFIG_FEATURE_FANCY_TAIL
734 bool "Enable extra tail options (-q, -s, -v, and -F)"
736 depends on BUSYBOX_CONFIG_TAIL
738 The options (-q, -s, and -v) are provided by GNU tail, but
739 are not specific in the SUSv3 standard.
741 -q Never output headers giving file names
742 -s SEC Wait SEC seconds between reads with -f
743 -v Always output headers giving file names
745 config BUSYBOX_CONFIG_TEE
749 tee is used to read from standard input and write
750 to standard output and files.
752 config BUSYBOX_CONFIG_FEATURE_TEE_USE_BLOCK_IO
753 bool "Enable block I/O (larger/faster) instead of byte I/O"
755 depends on BUSYBOX_CONFIG_TEE
757 Enable this option for a faster tee, at expense of size.
759 config BUSYBOX_CONFIG_TOUCH
763 touch is used to create or change the access and/or
764 modification timestamp of specified files.
766 config BUSYBOX_CONFIG_TRUE
770 true returns an exit code of TRUE (0).
772 config BUSYBOX_CONFIG_TTY
776 tty is used to print the name of the current terminal to
779 config BUSYBOX_CONFIG_UNAME
783 uname is used to print system information.
785 config BUSYBOX_CONFIG_UNEXPAND
789 By default, convert only leading sequences of blanks to tabs.
791 config BUSYBOX_CONFIG_FEATURE_UNEXPAND_LONG_OPTIONS
792 bool "Enable long options"
794 depends on BUSYBOX_CONFIG_UNEXPAND && BUSYBOX_CONFIG_LONG_OPTS
796 Support long options for the unexpand applet.
798 config BUSYBOX_CONFIG_UNIQ
802 uniq is used to remove duplicate lines from a sorted file.
804 config BUSYBOX_CONFIG_USLEEP
808 usleep is used to pause for a specified number of microseconds.
810 config BUSYBOX_CONFIG_UUDECODE
814 uudecode is used to decode a uuencoded file.
816 config BUSYBOX_CONFIG_UUENCODE
820 uuencode is used to uuencode a file.
822 config BUSYBOX_CONFIG_WC
826 wc is used to print the number of bytes, words, and lines,
829 config BUSYBOX_CONFIG_FEATURE_WC_LARGE
830 bool "Support very large files in wc"
832 depends on BUSYBOX_CONFIG_WC
834 Use "unsigned long long" in wc for counter variables.
836 config BUSYBOX_CONFIG_WHO
839 depends on BUSYBOX_CONFIG_FEATURE_UTMP
841 who is used to show who is logged on.
843 config BUSYBOX_CONFIG_WHOAMI
847 whoami is used to print the username of the current
848 user id (same as id -un).
850 config BUSYBOX_CONFIG_YES
854 yes is used to repeatedly output a specific string, or
855 the default string `y'.
857 comment "Common options for cp and mv"
858 depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
860 config BUSYBOX_CONFIG_FEATURE_PRESERVE_HARDLINKS
861 bool "Preserve hard links"
863 depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
865 Allow cp and mv to preserve hard links.
867 comment "Common options for ls, more and telnet"
868 depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
870 config BUSYBOX_CONFIG_FEATURE_AUTOWIDTH
871 bool "Calculate terminal & column widths"
873 depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
875 This option allows utilities such as 'ls', 'more' and 'telnet'
876 to determine the width of the screen, which can allow them to
877 display additional text or avoid wrapping text onto the next line.
878 If you leave this disabled, your utilities will be especially
879 primitive and will be unable to determine the current screen width.
881 comment "Common options for df, du, ls"
882 depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
884 config BUSYBOX_CONFIG_FEATURE_HUMAN_READABLE
885 bool "Support for human readable output (example 13k, 23M, 235G)"
887 depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
889 Allow df, du, and ls to have human readable output.
891 comment "Common options for md5sum, sha1sum, sha256sum, sha512sum"
892 depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM || BUSYBOX_CONFIG_SHA256SUM || BUSYBOX_CONFIG_SHA512SUM
894 config BUSYBOX_CONFIG_FEATURE_MD5_SHA1_SUM_CHECK
895 bool "Enable -c, -s and -w options"
897 depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM || BUSYBOX_CONFIG_SHA256SUM || BUSYBOX_CONFIG_SHA512SUM
899 Enabling the -c options allows files to be checked
900 against pre-calculated hash values.
902 -s and -w are useful options when verifying checksums.