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
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
100 config BUSYBOX_CONFIG_CAL
104 cal is used to display a monthly calender.
106 config BUSYBOX_CONFIG_CATV
110 Display nonprinting characters as escape sequences (like some
111 implementations' cat -v option).
113 config BUSYBOX_CONFIG_CHGRP
117 chgrp is used to change the group ownership of files.
119 config BUSYBOX_CONFIG_CHMOD
123 chmod is used to change the access permission of files.
125 config BUSYBOX_CONFIG_CHOWN
129 chown is used to change the user and/or group ownership
132 config BUSYBOX_CONFIG_FEATURE_CHOWN_LONG_OPTIONS
133 bool "Enable long options"
135 depends on BUSYBOX_CONFIG_CHOWN && BUSYBOX_CONFIG_LONG_OPTS
137 Enable use of long options
139 config BUSYBOX_CONFIG_CHROOT
143 chroot is used to change the root directory and run a command.
144 The default command is `/bin/sh'.
146 config BUSYBOX_CONFIG_CKSUM
150 cksum is used to calculate the CRC32 checksum of a file.
152 config BUSYBOX_CONFIG_COMM
156 comm is used to compare two files line by line and return
157 a three-column output.
159 config BUSYBOX_CONFIG_CP
163 cp is used to copy files and directories.
165 config BUSYBOX_CONFIG_FEATURE_CP_LONG_OPTIONS
166 bool "Enable long options for cp"
168 depends on BUSYBOX_CONFIG_CP && BUSYBOX_CONFIG_LONG_OPTS
170 Enable long options for cp.
171 Also add support for --parents option.
173 config BUSYBOX_CONFIG_CUT
177 cut is used to print selected parts of lines from
180 config BUSYBOX_CONFIG_DD
184 dd copies a file (from standard input to standard output,
185 by default) using specific input and output blocksizes,
186 while optionally performing conversions on it.
188 config BUSYBOX_CONFIG_FEATURE_DD_SIGNAL_HANDLING
189 bool "Enable DD signal handling for status reporting"
191 depends on BUSYBOX_CONFIG_DD
193 Sending a SIGUSR1 signal to a running `dd' process makes it
194 print to standard error the number of records read and written
195 so far, then to resume copying.
197 $ dd if=/dev/zero of=/dev/null&
198 $ pid=$! kill -USR1 $pid; sleep 1; kill $pid
199 10899206+0 records in
200 10899206+0 records out
202 config BUSYBOX_CONFIG_FEATURE_DD_THIRD_STATUS_LINE
203 bool "Enable the third status line upon signal"
205 depends on BUSYBOX_CONFIG_DD && BUSYBOX_CONFIG_FEATURE_DD_SIGNAL_HANDLING
207 Displays a coreutils-like third status line with transferred bytes,
208 elapsed time and speed.
210 config BUSYBOX_CONFIG_FEATURE_DD_IBS_OBS
211 bool "Enable ibs, obs and conv options"
213 depends on BUSYBOX_CONFIG_DD
215 Enables support for writing a certain number of bytes in and out,
216 at a time, and performing conversions on the data stream.
218 config BUSYBOX_CONFIG_DF
222 df reports the amount of disk space used and available
225 config BUSYBOX_CONFIG_FEATURE_DF_FANCY
226 bool "Enable -a, -i, -B"
228 depends on BUSYBOX_CONFIG_DF
230 This option enables -a, -i and -B.
232 -a Show all filesystems
236 config BUSYBOX_CONFIG_DIRNAME
240 dirname is used to strip a non-directory suffix from
243 config BUSYBOX_CONFIG_DOS2UNIX
244 bool "dos2unix/unix2dos"
247 dos2unix is used to convert a text file from DOS format to
248 UNIX format, and vice versa.
250 config BUSYBOX_CONFIG_UNIX2DOS
253 depends on BUSYBOX_CONFIG_DOS2UNIX
255 unix2dos is used to convert a text file from UNIX format to
256 DOS format, and vice versa.
258 config BUSYBOX_CONFIG_DU
259 bool "du (default blocksize of 512 bytes)"
262 du is used to report the amount of disk space used
265 config BUSYBOX_CONFIG_FEATURE_DU_DEFAULT_BLOCKSIZE_1K
266 bool "Use a default blocksize of 1024 bytes (1K)"
268 depends on BUSYBOX_CONFIG_DU
270 Use a blocksize of (1K) instead of the default 512b.
272 config BUSYBOX_CONFIG_ECHO
273 bool "echo (basic SuSv3 version taking no options)"
276 echo is used to print a specified string to stdout.
278 # this entry also appears in shell/Config.in, next to the echo builtin
279 config BUSYBOX_CONFIG_FEATURE_FANCY_ECHO
280 bool "Enable echo options (-n and -e)"
282 depends on BUSYBOX_CONFIG_ECHO || BUSYBOX_CONFIG_ASH_BUILTIN_ECHO || BUSYBOX_CONFIG_HUSH
284 This adds options (-n and -e) to echo.
286 config BUSYBOX_CONFIG_ENV
290 env is used to set an environment variable and run
291 a command; without options it displays the current
294 config BUSYBOX_CONFIG_FEATURE_ENV_LONG_OPTIONS
295 bool "Enable long options"
297 depends on BUSYBOX_CONFIG_ENV && BUSYBOX_CONFIG_LONG_OPTS
299 Support long options for the env applet.
301 config BUSYBOX_CONFIG_EXPAND
305 By default, convert all tabs to spaces.
307 config BUSYBOX_CONFIG_FEATURE_EXPAND_LONG_OPTIONS
308 bool "Enable long options"
310 depends on BUSYBOX_CONFIG_EXPAND && BUSYBOX_CONFIG_LONG_OPTS
312 Support long options for the expand applet.
314 config BUSYBOX_CONFIG_EXPR
318 expr is used to calculate numbers and print the result
321 config BUSYBOX_CONFIG_EXPR_MATH_SUPPORT_64
322 bool "Extend Posix numbers support to 64 bit"
324 depends on BUSYBOX_CONFIG_EXPR
326 Enable 64-bit math support in the expr applet. This will make
327 the applet slightly larger, but will allow computation with very
330 config BUSYBOX_CONFIG_FALSE
334 false returns an exit code of FALSE (1).
336 config BUSYBOX_CONFIG_FOLD
340 Wrap text to fit a specific width.
342 config BUSYBOX_CONFIG_FSYNC
346 fsync is used to flush file-related cached blocks to disk.
348 config BUSYBOX_CONFIG_HEAD
352 head is used to print the first specified number of lines
355 config BUSYBOX_CONFIG_FEATURE_FANCY_HEAD
356 bool "Enable head options (-c, -q, and -v)"
358 depends on BUSYBOX_CONFIG_HEAD
360 This enables the head options (-c, -q, and -v).
362 config BUSYBOX_CONFIG_HOSTID
366 hostid prints the numeric identifier (in hexadecimal) for
369 config BUSYBOX_CONFIG_ID
373 id displays the current user and group ID names.
375 config BUSYBOX_CONFIG_INSTALL
379 Copy files and set attributes.
381 config BUSYBOX_CONFIG_FEATURE_INSTALL_LONG_OPTIONS
382 bool "Enable long options"
384 depends on BUSYBOX_CONFIG_INSTALL && BUSYBOX_CONFIG_LONG_OPTS
386 Support long options for the install applet.
388 config BUSYBOX_CONFIG_LENGTH
392 length is used to print out the length of a specified string.
394 config BUSYBOX_CONFIG_LN
398 ln is used to create hard or soft links between files.
400 config BUSYBOX_CONFIG_LOGNAME
404 logname is used to print the current user's login name.
406 config BUSYBOX_CONFIG_LS
410 ls is used to list the contents of directories.
412 config BUSYBOX_CONFIG_FEATURE_LS_FILETYPES
413 bool "Enable filetyping options (-p and -F)"
415 depends on BUSYBOX_CONFIG_LS
417 Enable the ls options (-p and -F).
419 config BUSYBOX_CONFIG_FEATURE_LS_FOLLOWLINKS
420 bool "Enable symlinks dereferencing (-L)"
422 depends on BUSYBOX_CONFIG_LS
424 Enable the ls option (-L).
426 config BUSYBOX_CONFIG_FEATURE_LS_RECURSIVE
427 bool "Enable recursion (-R)"
429 depends on BUSYBOX_CONFIG_LS
431 Enable the ls option (-R).
433 config BUSYBOX_CONFIG_FEATURE_LS_SORTFILES
434 bool "Sort the file names"
436 depends on BUSYBOX_CONFIG_LS
438 Allow ls to sort file names alphabetically.
440 config BUSYBOX_CONFIG_FEATURE_LS_TIMESTAMPS
441 bool "Show file timestamps"
443 depends on BUSYBOX_CONFIG_LS
445 Allow ls to display timestamps for files.
447 config BUSYBOX_CONFIG_FEATURE_LS_USERNAME
448 bool "Show username/groupnames"
450 depends on BUSYBOX_CONFIG_LS
452 Allow ls to display username/groupname for files.
454 config BUSYBOX_CONFIG_FEATURE_LS_COLOR
455 bool "Allow use of color to identify file types"
457 depends on BUSYBOX_CONFIG_LS && BUSYBOX_CONFIG_LONG_OPTS
459 This enables the --color option to ls.
461 config BUSYBOX_CONFIG_FEATURE_LS_COLOR_IS_DEFAULT
462 bool "Produce colored ls output by default"
464 depends on BUSYBOX_CONFIG_FEATURE_LS_COLOR
466 Saying yes here will turn coloring on by default,
467 even if no "--color" option is given to the ls command.
468 This is not recommended, since the colors are not
469 configurable, and the output may not be legible on
472 config BUSYBOX_CONFIG_MD5SUM
476 md5sum is used to print or check MD5 checksums.
478 config BUSYBOX_CONFIG_MKDIR
482 mkdir is used to create directories with the specified names.
484 config BUSYBOX_CONFIG_FEATURE_MKDIR_LONG_OPTIONS
485 bool "Enable long options"
487 depends on BUSYBOX_CONFIG_MKDIR && BUSYBOX_CONFIG_LONG_OPTS
489 Support long options for the mkdir applet.
491 config BUSYBOX_CONFIG_MKFIFO
495 mkfifo is used to create FIFOs (named pipes).
496 The `mknod' program can also create FIFOs.
498 config BUSYBOX_CONFIG_MKNOD
502 mknod is used to create FIFOs or block/character special
503 files with the specified names.
505 config BUSYBOX_CONFIG_MV
509 mv is used to move or rename files or directories.
511 config BUSYBOX_CONFIG_FEATURE_MV_LONG_OPTIONS
512 bool "Enable long options"
514 depends on BUSYBOX_CONFIG_MV && BUSYBOX_CONFIG_LONG_OPTS
516 Support long options for the mv applet.
518 config BUSYBOX_CONFIG_NICE
522 nice runs a program with modified scheduling priority.
524 config BUSYBOX_CONFIG_NOHUP
528 run a command immune to hangups, with output to a non-tty.
530 config BUSYBOX_CONFIG_OD
534 od is used to dump binary files in octal and other formats.
536 config BUSYBOX_CONFIG_PRINTENV
540 printenv is used to print all or part of environment.
542 config BUSYBOX_CONFIG_PRINTF
546 printf is used to format and print specified strings.
547 It's similar to `echo' except it has more options.
549 config BUSYBOX_CONFIG_PWD
553 pwd is used to print the current directory.
555 config BUSYBOX_CONFIG_READLINK
559 This program reads a symbolic link and returns the name
560 of the file it points to
562 config BUSYBOX_CONFIG_FEATURE_READLINK_FOLLOW
563 bool "Enable canonicalization by following all symlinks (-f)"
565 depends on BUSYBOX_CONFIG_READLINK
567 Enable the readlink option (-f).
569 config BUSYBOX_CONFIG_REALPATH
573 Return the canonicalized absolute pathname.
574 This isn't provided by GNU shellutils, but where else does it belong.
576 config BUSYBOX_CONFIG_RM
580 rm is used to remove files or directories.
582 config BUSYBOX_CONFIG_RMDIR
586 rmdir is used to remove empty directories.
588 config BUSYBOX_CONFIG_FEATURE_RMDIR_LONG_OPTIONS
589 bool "Enable long options"
591 depends on BUSYBOX_CONFIG_RMDIR && BUSYBOX_CONFIG_LONG_OPTS
593 Support long options for the rmdir applet, including
594 --ignore-fail-on-non-empty for compatibility with GNU rmdir.
596 config BUSYBOX_CONFIG_SEQ
600 print a sequence of numbers
602 config BUSYBOX_CONFIG_SHA1SUM
606 Compute and check SHA1 message digest
608 config BUSYBOX_CONFIG_SHA256SUM
612 Compute and check SHA256 message digest
614 config BUSYBOX_CONFIG_SHA512SUM
618 Compute and check SHA512 message digest
620 config BUSYBOX_CONFIG_SLEEP
624 sleep is used to pause for a specified number of seconds.
625 It comes in 3 versions:
626 - small: takes one integer parameter
627 - fancy: takes multiple integer arguments with suffixes:
629 - fancy with fractional numbers:
630 sleep 2.3s 4.5h sleeps for 16202.3 seconds
631 Last one is "the most compatible" with coreutils sleep,
632 but it adds around 1k of code.
634 config BUSYBOX_CONFIG_FEATURE_FANCY_SLEEP
635 bool "Enable multiple arguments and s/m/h/d suffixes"
637 depends on BUSYBOX_CONFIG_SLEEP
639 Allow sleep to pause for specified minutes, hours, and days.
641 config BUSYBOX_CONFIG_FEATURE_FLOAT_SLEEP
642 bool "Enable fractional arguments"
644 depends on BUSYBOX_CONFIG_FEATURE_FANCY_SLEEP
646 Allow for fractional numeric parameters.
648 config BUSYBOX_CONFIG_SORT
652 sort is used to sort lines of text in specified files.
654 config BUSYBOX_CONFIG_FEATURE_SORT_BIG
655 bool "Full SuSv3 compliant sort (support -ktcsbdfiozgM)"
657 depends on BUSYBOX_CONFIG_SORT
659 Without this, sort only supports -r, -u, and an integer version
660 of -n. Selecting this adds sort keys, floating point support, and
661 more. This adds a little over 3k to a nonstatic build on x86.
663 The SuSv3 sort standard is available at:
664 http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
666 config BUSYBOX_CONFIG_SPLIT
670 split a file into pieces.
672 config BUSYBOX_CONFIG_FEATURE_SPLIT_FANCY
673 bool "Fancy extensions"
675 depends on BUSYBOX_CONFIG_SPLIT
677 Add support for features not required by SUSv3.
678 Supports additional suffixes 'b' for 512 bytes,
679 'g' for 1GiB for the -b option.
681 config BUSYBOX_CONFIG_STAT
685 display file or filesystem status.
687 config BUSYBOX_CONFIG_FEATURE_STAT_FORMAT
688 bool "Enable custom formats (-c)"
690 depends on BUSYBOX_CONFIG_STAT
692 Without this, stat will not support the '-c format' option where
693 users can pass a custom format string for output. This adds about
694 7k to a nonstatic build on amd64.
696 config BUSYBOX_CONFIG_STTY
700 stty is used to change and print terminal line settings.
702 config BUSYBOX_CONFIG_SUM
706 checksum and count the blocks in a file
708 config BUSYBOX_CONFIG_SYNC
712 sync is used to flush filesystem buffers.
714 config BUSYBOX_CONFIG_TAC
718 tac is used to concatenate and print files in reverse.
720 config BUSYBOX_CONFIG_TAIL
724 tail is used to print the last specified number of lines
727 config BUSYBOX_CONFIG_FEATURE_FANCY_TAIL
728 bool "Enable extra tail options (-q, -s, -v, and -F)"
730 depends on BUSYBOX_CONFIG_TAIL
732 The options (-q, -s, and -v) are provided by GNU tail, but
733 are not specific in the SUSv3 standard.
735 -q Never output headers giving file names
736 -s SEC Wait SEC seconds between reads with -f
737 -v Always output headers giving file names
739 config BUSYBOX_CONFIG_TEE
743 tee is used to read from standard input and write
744 to standard output and files.
746 config BUSYBOX_CONFIG_FEATURE_TEE_USE_BLOCK_IO
747 bool "Enable block I/O (larger/faster) instead of byte I/O"
749 depends on BUSYBOX_CONFIG_TEE
751 Enable this option for a faster tee, at expense of size.
753 config BUSYBOX_CONFIG_TOUCH
757 touch is used to create or change the access and/or
758 modification timestamp of specified files.
760 config BUSYBOX_CONFIG_TRUE
764 true returns an exit code of TRUE (0).
766 config BUSYBOX_CONFIG_TTY
770 tty is used to print the name of the current terminal to
773 config BUSYBOX_CONFIG_UNAME
777 uname is used to print system information.
779 config BUSYBOX_CONFIG_UNEXPAND
783 By default, convert only leading sequences of blanks to tabs.
785 config BUSYBOX_CONFIG_FEATURE_UNEXPAND_LONG_OPTIONS
786 bool "Enable long options"
788 depends on BUSYBOX_CONFIG_UNEXPAND && BUSYBOX_CONFIG_LONG_OPTS
790 Support long options for the unexpand applet.
792 config BUSYBOX_CONFIG_UNIQ
796 uniq is used to remove duplicate lines from a sorted file.
798 config BUSYBOX_CONFIG_USLEEP
802 usleep is used to pause for a specified number of microseconds.
804 config BUSYBOX_CONFIG_UUDECODE
808 uudecode is used to decode a uuencoded file.
810 config BUSYBOX_CONFIG_UUENCODE
814 uuencode is used to uuencode a file.
816 config BUSYBOX_CONFIG_WC
820 wc is used to print the number of bytes, words, and lines,
823 config BUSYBOX_CONFIG_FEATURE_WC_LARGE
824 bool "Support very large files in wc"
826 depends on BUSYBOX_CONFIG_WC
828 Use "unsigned long long" in wc for counter variables.
830 config BUSYBOX_CONFIG_WHO
833 depends on BUSYBOX_CONFIG_FEATURE_UTMP
835 who is used to show who is logged on.
837 config BUSYBOX_CONFIG_WHOAMI
841 whoami is used to print the username of the current
842 user id (same as id -un).
844 config BUSYBOX_CONFIG_YES
848 yes is used to repeatedly output a specific string, or
849 the default string `y'.
851 comment "Common options for cp and mv"
852 depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
854 config BUSYBOX_CONFIG_FEATURE_PRESERVE_HARDLINKS
855 bool "Preserve hard links"
857 depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
859 Allow cp and mv to preserve hard links.
861 comment "Common options for ls, more and telnet"
862 depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
864 config BUSYBOX_CONFIG_FEATURE_AUTOWIDTH
865 bool "Calculate terminal & column widths"
867 depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
869 This option allows utilities such as 'ls', 'more' and 'telnet'
870 to determine the width of the screen, which can allow them to
871 display additional text or avoid wrapping text onto the next line.
872 If you leave this disabled, your utilities will be especially
873 primitive and will be unable to determine the current screen width.
875 comment "Common options for df, du, ls"
876 depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
878 config BUSYBOX_CONFIG_FEATURE_HUMAN_READABLE
879 bool "Support for human readable output (example 13k, 23M, 235G)"
881 depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
883 Allow df, du, and ls to have human readable output.
885 comment "Common options for md5sum, sha1sum, sha256sum, sha512sum"
886 depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM || BUSYBOX_CONFIG_SHA256SUM || BUSYBOX_CONFIG_SHA512SUM
888 config BUSYBOX_CONFIG_FEATURE_MD5_SHA1_SUM_CHECK
889 bool "Enable -c, -s and -w options"
891 depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM || BUSYBOX_CONFIG_SHA256SUM || BUSYBOX_CONFIG_SHA512SUM
893 Enabling the -c options allows files to be checked
894 against pre-calculated hash values.
896 -s and -w are useful options when verifying checksums.