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.
16 config BUSYBOX_CONFIG_CAL
20 cal is used to display a monthly calender.
22 config BUSYBOX_CONFIG_CAT
26 cat is used to concatenate files and print them to the standard
27 output. Enable this option if you wish to enable the 'cat' utility.
29 config BUSYBOX_CONFIG_CATV
33 Display nonprinting characters as escape sequences (like some
34 implementations' cat -v option).
36 config BUSYBOX_CONFIG_CHGRP
40 chgrp is used to change the group ownership of files.
42 config BUSYBOX_CONFIG_CHMOD
46 chmod is used to change the access permission of files.
48 config BUSYBOX_CONFIG_CHOWN
52 chown is used to change the user and/or group ownership
55 config BUSYBOX_CONFIG_FEATURE_CHOWN_LONG_OPTIONS
56 bool "Enable long options"
58 depends on BUSYBOX_CONFIG_CHOWN && BUSYBOX_CONFIG_LONG_OPTS
60 Enable use of long options
62 config BUSYBOX_CONFIG_CHROOT
66 chroot is used to change the root directory and run a command.
67 The default command is `/bin/sh'.
69 config BUSYBOX_CONFIG_CKSUM
73 cksum is used to calculate the CRC32 checksum of a file.
75 config BUSYBOX_CONFIG_COMM
79 comm is used to compare two files line by line and return
80 a three-column output.
82 config BUSYBOX_CONFIG_CP
86 cp is used to copy files and directories.
88 config BUSYBOX_CONFIG_FEATURE_CP_LONG_OPTIONS
89 bool "Enable long options for cp"
91 depends on BUSYBOX_CONFIG_CP && BUSYBOX_CONFIG_LONG_OPTS
93 Enable long options for cp.
94 Also add support for --parents option.
96 config BUSYBOX_CONFIG_CUT
100 cut is used to print selected parts of lines from
103 config BUSYBOX_CONFIG_DATE
107 date is used to set the system date or display the
108 current time in the given format.
110 config BUSYBOX_CONFIG_FEATURE_DATE_ISOFMT
111 bool "Enable ISO date format output (-I)"
113 depends on BUSYBOX_CONFIG_DATE
115 Enable option (-I) to output an ISO-8601 compliant
118 config BUSYBOX_CONFIG_FEATURE_DATE_COMPAT
119 bool "Support weird 'date MMDDhhmm[[YY]YY][.ss]' format"
121 depends on BUSYBOX_CONFIG_DATE
123 System time can be set by 'date -s DATE' and simply 'date DATE',
124 but formats of DATE string are different. 'date DATE' accepts
125 a rather weird MMDDhhmm[[YY]YY][.ss] format with completely
126 unnatural placement of year between minutes and seconds.
127 date -s (and other commands like touch -d) use more sensible
128 formats (for one, ISO format YYYY-MM-DD hh:mm:ss.ssssss).
130 With this option off, 'date DATE' is 'date -s DATE' support
131 the same format. With it on, 'date DATE' additionally supports
132 MMDDhhmm[[YY]YY][.ss] format.
134 config BUSYBOX_CONFIG_DD
138 dd copies a file (from standard input to standard output,
139 by default) using specific input and output blocksizes,
140 while optionally performing conversions on it.
142 config BUSYBOX_CONFIG_FEATURE_DD_SIGNAL_HANDLING
143 bool "Enable DD signal handling for status reporting"
145 depends on BUSYBOX_CONFIG_DD
147 Sending a SIGUSR1 signal to a running `dd' process makes it
148 print to standard error the number of records read and written
149 so far, then to resume copying.
151 $ dd if=/dev/zero of=/dev/null&
152 $ pid=$! kill -USR1 $pid; sleep 1; kill $pid
153 10899206+0 records in
154 10899206+0 records out
156 config BUSYBOX_CONFIG_FEATURE_DD_THIRD_STATUS_LINE
157 bool "Enable the third status line upon signal"
159 depends on BUSYBOX_CONFIG_DD && BUSYBOX_CONFIG_FEATURE_DD_SIGNAL_HANDLING
161 Displays a coreutils-like third status line with transferred bytes,
162 elapsed time and speed.
164 config BUSYBOX_CONFIG_FEATURE_DD_IBS_OBS
165 bool "Enable ibs, obs and conv options"
167 depends on BUSYBOX_CONFIG_DD
169 Enables support for writing a certain number of bytes in and out,
170 at a time, and performing conversions on the data stream.
172 config BUSYBOX_CONFIG_DF
176 df reports the amount of disk space used and available
179 config BUSYBOX_CONFIG_FEATURE_DF_FANCY
180 bool "Enable -a, -i, -B"
182 depends on BUSYBOX_CONFIG_DF
184 This option enables -a, -i and -B.
186 config BUSYBOX_CONFIG_DIRNAME
190 dirname is used to strip a non-directory suffix from
193 config BUSYBOX_CONFIG_DOS2UNIX
194 bool "dos2unix/unix2dos"
197 dos2unix is used to convert a text file from DOS format to
198 UNIX format, and vice versa.
200 config BUSYBOX_CONFIG_UNIX2DOS
203 depends on BUSYBOX_CONFIG_DOS2UNIX
205 unix2dos is used to convert a text file from UNIX format to
206 DOS format, and vice versa.
208 config BUSYBOX_CONFIG_DU
209 bool "du (default blocksize of 512 bytes)"
212 du is used to report the amount of disk space used
215 config BUSYBOX_CONFIG_FEATURE_DU_DEFAULT_BLOCKSIZE_1K
216 bool "Use a default blocksize of 1024 bytes (1K)"
218 depends on BUSYBOX_CONFIG_DU
220 Use a blocksize of (1K) instead of the default 512b.
222 config BUSYBOX_CONFIG_ECHO
223 bool "echo (basic SuSv3 version taking no options)"
226 echo is used to print a specified string to stdout.
228 # this entry also appears in shell/Config.in, next to the echo builtin
229 config BUSYBOX_CONFIG_FEATURE_FANCY_ECHO
230 bool "Enable echo options (-n and -e)"
232 depends on BUSYBOX_CONFIG_ECHO || BUSYBOX_CONFIG_ASH_BUILTIN_ECHO || BUSYBOX_CONFIG_HUSH
234 This adds options (-n and -e) to echo.
236 config BUSYBOX_CONFIG_ENV
240 env is used to set an environment variable and run
241 a command; without options it displays the current
244 config BUSYBOX_CONFIG_FEATURE_ENV_LONG_OPTIONS
245 bool "Enable long options"
247 depends on BUSYBOX_CONFIG_ENV && BUSYBOX_CONFIG_LONG_OPTS
249 Support long options for the env applet.
251 config BUSYBOX_CONFIG_EXPAND
255 By default, convert all tabs to spaces.
257 config BUSYBOX_CONFIG_FEATURE_EXPAND_LONG_OPTIONS
258 bool "Enable long options"
260 depends on BUSYBOX_CONFIG_EXPAND && BUSYBOX_CONFIG_LONG_OPTS
262 Support long options for the expand applet.
264 config BUSYBOX_CONFIG_EXPR
268 expr is used to calculate numbers and print the result
271 config BUSYBOX_CONFIG_EXPR_MATH_SUPPORT_64
272 bool "Extend Posix numbers support to 64 bit"
274 depends on BUSYBOX_CONFIG_EXPR
276 Enable 64-bit math support in the expr applet. This will make
277 the applet slightly larger, but will allow computation with very
280 config BUSYBOX_CONFIG_FALSE
284 false returns an exit code of FALSE (1).
286 config BUSYBOX_CONFIG_FOLD
290 Wrap text to fit a specific width.
292 config BUSYBOX_CONFIG_FSYNC
296 fsync is used to flush file-related cached blocks to disk.
298 config BUSYBOX_CONFIG_HEAD
302 head is used to print the first specified number of lines
305 config BUSYBOX_CONFIG_FEATURE_FANCY_HEAD
306 bool "Enable head options (-c, -q, and -v)"
308 depends on BUSYBOX_CONFIG_HEAD
310 This enables the head options (-c, -q, and -v).
312 config BUSYBOX_CONFIG_HOSTID
316 hostid prints the numeric identifier (in hexadecimal) for
319 config BUSYBOX_CONFIG_ID
323 id displays the current user and group ID names.
325 config BUSYBOX_CONFIG_INSTALL
329 Copy files and set attributes.
331 config BUSYBOX_CONFIG_FEATURE_INSTALL_LONG_OPTIONS
332 bool "Enable long options"
334 depends on BUSYBOX_CONFIG_INSTALL && BUSYBOX_CONFIG_LONG_OPTS
336 Support long options for the install applet.
338 config BUSYBOX_CONFIG_LENGTH
342 length is used to print out the length of a specified string.
344 config BUSYBOX_CONFIG_LN
348 ln is used to create hard or soft links between files.
350 config BUSYBOX_CONFIG_LOGNAME
354 logname is used to print the current user's login name.
356 config BUSYBOX_CONFIG_LS
360 ls is used to list the contents of directories.
362 config BUSYBOX_CONFIG_FEATURE_LS_FILETYPES
363 bool "Enable filetyping options (-p and -F)"
365 depends on BUSYBOX_CONFIG_LS
367 Enable the ls options (-p and -F).
369 config BUSYBOX_CONFIG_FEATURE_LS_FOLLOWLINKS
370 bool "Enable symlinks dereferencing (-L)"
372 depends on BUSYBOX_CONFIG_LS
374 Enable the ls option (-L).
376 config BUSYBOX_CONFIG_FEATURE_LS_RECURSIVE
377 bool "Enable recursion (-R)"
379 depends on BUSYBOX_CONFIG_LS
381 Enable the ls option (-R).
383 config BUSYBOX_CONFIG_FEATURE_LS_SORTFILES
384 bool "Sort the file names"
386 depends on BUSYBOX_CONFIG_LS
388 Allow ls to sort file names alphabetically.
390 config BUSYBOX_CONFIG_FEATURE_LS_TIMESTAMPS
391 bool "Show file timestamps"
393 depends on BUSYBOX_CONFIG_LS
395 Allow ls to display timestamps for files.
397 config BUSYBOX_CONFIG_FEATURE_LS_USERNAME
398 bool "Show username/groupnames"
400 depends on BUSYBOX_CONFIG_LS
402 Allow ls to display username/groupname for files.
404 config BUSYBOX_CONFIG_FEATURE_LS_COLOR
405 bool "Allow use of color to identify file types"
407 depends on BUSYBOX_CONFIG_LS && BUSYBOX_CONFIG_LONG_OPTS
409 This enables the --color option to ls.
411 config BUSYBOX_CONFIG_FEATURE_LS_COLOR_IS_DEFAULT
412 bool "Produce colored ls output by default"
414 depends on BUSYBOX_CONFIG_FEATURE_LS_COLOR
416 Saying yes here will turn coloring on by default,
417 even if no "--color" option is given to the ls command.
418 This is not recommended, since the colors are not
419 configurable, and the output may not be legible on
422 config BUSYBOX_CONFIG_MD5SUM
426 md5sum is used to print or check MD5 checksums.
428 config BUSYBOX_CONFIG_MKDIR
432 mkdir is used to create directories with the specified names.
434 config BUSYBOX_CONFIG_FEATURE_MKDIR_LONG_OPTIONS
435 bool "Enable long options"
437 depends on BUSYBOX_CONFIG_MKDIR && BUSYBOX_CONFIG_LONG_OPTS
439 Support long options for the mkdir applet.
441 config BUSYBOX_CONFIG_MKFIFO
445 mkfifo is used to create FIFOs (named pipes).
446 The `mknod' program can also create FIFOs.
448 config BUSYBOX_CONFIG_MKNOD
452 mknod is used to create FIFOs or block/character special
453 files with the specified names.
455 config BUSYBOX_CONFIG_MV
459 mv is used to move or rename files or directories.
461 config BUSYBOX_CONFIG_FEATURE_MV_LONG_OPTIONS
462 bool "Enable long options"
464 depends on BUSYBOX_CONFIG_MV && BUSYBOX_CONFIG_LONG_OPTS
466 Support long options for the mv applet.
468 config BUSYBOX_CONFIG_NICE
472 nice runs a program with modified scheduling priority.
474 config BUSYBOX_CONFIG_NOHUP
478 run a command immune to hangups, with output to a non-tty.
480 config BUSYBOX_CONFIG_OD
484 od is used to dump binary files in octal and other formats.
486 config BUSYBOX_CONFIG_PRINTENV
490 printenv is used to print all or part of environment.
492 config BUSYBOX_CONFIG_PRINTF
496 printf is used to format and print specified strings.
497 It's similar to `echo' except it has more options.
499 config BUSYBOX_CONFIG_PWD
503 pwd is used to print the current directory.
505 config BUSYBOX_CONFIG_READLINK
509 This program reads a symbolic link and returns the name
510 of the file it points to
512 config BUSYBOX_CONFIG_FEATURE_READLINK_FOLLOW
513 bool "Enable canonicalization by following all symlinks (-f)"
515 depends on BUSYBOX_CONFIG_READLINK
517 Enable the readlink option (-f).
519 config BUSYBOX_CONFIG_REALPATH
523 Return the canonicalized absolute pathname.
524 This isn't provided by GNU shellutils, but where else does it belong.
526 config BUSYBOX_CONFIG_RM
530 rm is used to remove files or directories.
532 config BUSYBOX_CONFIG_RMDIR
536 rmdir is used to remove empty directories.
538 config BUSYBOX_CONFIG_FEATURE_RMDIR_LONG_OPTIONS
539 bool "Enable long options"
541 depends on BUSYBOX_CONFIG_RMDIR && BUSYBOX_CONFIG_LONG_OPTS
543 Support long options for the rmdir applet, including
544 --ignore-fail-on-non-empty for compatibility with GNU rmdir.
546 config BUSYBOX_CONFIG_SEQ
550 print a sequence of numbers
552 config BUSYBOX_CONFIG_SHA1SUM
556 Compute and check SHA1 message digest
558 config BUSYBOX_CONFIG_SHA256SUM
562 Compute and check SHA256 message digest
564 config BUSYBOX_CONFIG_SHA512SUM
568 Compute and check SHA512 message digest
570 config BUSYBOX_CONFIG_SLEEP
574 sleep is used to pause for a specified number of seconds.
575 It comes in 3 versions:
576 - small: takes one integer parameter
577 - fancy: takes multiple integer arguments with suffixes:
579 - fancy with fractional numbers:
580 sleep 2.3s 4.5h sleeps for 16202.3 seconds
581 Last one is "the most compatible" with coreutils sleep,
582 but it adds around 1k of code.
584 config BUSYBOX_CONFIG_FEATURE_FANCY_SLEEP
585 bool "Enable multiple arguments and s/m/h/d suffixes"
587 depends on BUSYBOX_CONFIG_SLEEP
589 Allow sleep to pause for specified minutes, hours, and days.
591 config BUSYBOX_CONFIG_FEATURE_FLOAT_SLEEP
592 bool "Enable fractional arguments"
594 depends on BUSYBOX_CONFIG_FEATURE_FANCY_SLEEP
596 Allow for fractional numeric parameters.
598 config BUSYBOX_CONFIG_SORT
602 sort is used to sort lines of text in specified files.
604 config BUSYBOX_CONFIG_FEATURE_SORT_BIG
605 bool "Full SuSv3 compliant sort (support -ktcsbdfiozgM)"
607 depends on BUSYBOX_CONFIG_SORT
609 Without this, sort only supports -r, -u, and an integer version
610 of -n. Selecting this adds sort keys, floating point support, and
611 more. This adds a little over 3k to a nonstatic build on x86.
613 The SuSv3 sort standard is available at:
614 http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
616 config BUSYBOX_CONFIG_SPLIT
620 split a file into pieces.
622 config BUSYBOX_CONFIG_FEATURE_SPLIT_FANCY
623 bool "Fancy extensions"
625 depends on BUSYBOX_CONFIG_SPLIT
627 Add support for features not required by SUSv3.
628 Supports additional suffixes 'b' for 512 bytes,
629 'g' for 1GiB for the -b option.
631 config BUSYBOX_CONFIG_STAT
635 display file or filesystem status.
637 config BUSYBOX_CONFIG_FEATURE_STAT_FORMAT
638 bool "Enable custom formats (-c)"
640 depends on BUSYBOX_CONFIG_STAT
642 Without this, stat will not support the '-c format' option where
643 users can pass a custom format string for output. This adds about
644 7k to a nonstatic build on amd64.
646 config BUSYBOX_CONFIG_STTY
650 stty is used to change and print terminal line settings.
652 config BUSYBOX_CONFIG_SUM
656 checksum and count the blocks in a file
658 config BUSYBOX_CONFIG_SYNC
662 sync is used to flush filesystem buffers.
664 config BUSYBOX_CONFIG_TAC
668 tac is used to concatenate and print files in reverse.
670 config BUSYBOX_CONFIG_TAIL
674 tail is used to print the last specified number of lines
677 config BUSYBOX_CONFIG_FEATURE_FANCY_TAIL
678 bool "Enable extra tail options (-q, -s, -v, and -F)"
680 depends on BUSYBOX_CONFIG_TAIL
682 The options (-q, -s, and -v) are provided by GNU tail, but
683 are not specific in the SUSv3 standard.
685 config BUSYBOX_CONFIG_TEE
689 tee is used to read from standard input and write
690 to standard output and files.
692 config BUSYBOX_CONFIG_FEATURE_TEE_USE_BLOCK_IO
693 bool "Enable block I/O (larger/faster) instead of byte I/O"
695 depends on BUSYBOX_CONFIG_TEE
697 Enable this option for a faster tee, at expense of size.
699 config BUSYBOX_CONFIG_TEST
703 test is used to check file types and compare values,
704 returning an appropriate exit code. The bash shell
705 has test built in, ash can build it in optionally.
707 config BUSYBOX_CONFIG_FEATURE_TEST_64
708 bool "Extend test to 64 bit"
710 depends on BUSYBOX_CONFIG_TEST || BUSYBOX_CONFIG_ASH_BUILTIN_TEST || BUSYBOX_CONFIG_HUSH
712 Enable 64-bit support in test.
714 config BUSYBOX_CONFIG_TOUCH
718 touch is used to create or change the access and/or
719 modification timestamp of specified files.
721 config BUSYBOX_CONFIG_TR
725 tr is used to squeeze, and/or delete characters from standard
726 input, writing to standard output.
728 config BUSYBOX_CONFIG_FEATURE_TR_CLASSES
729 bool "Enable character classes (such as [:upper:])"
731 depends on BUSYBOX_CONFIG_TR
733 Enable character classes, enabling commands such as:
734 tr [:upper:] [:lower:] to convert input into lowercase.
736 config BUSYBOX_CONFIG_FEATURE_TR_EQUIV
737 bool "Enable equivalence classes"
739 depends on BUSYBOX_CONFIG_TR
741 Enable equivalence classes, which essentially add the enclosed
742 character to the current set. For instance, tr [=a=] xyz would
743 replace all instances of 'a' with 'xyz'. This option is mainly
744 useful for cases when no other way of expressing a character
747 config BUSYBOX_CONFIG_TRUE
751 true returns an exit code of TRUE (0).
753 config BUSYBOX_CONFIG_TTY
757 tty is used to print the name of the current terminal to
760 config BUSYBOX_CONFIG_UNAME
764 uname is used to print system information.
766 config BUSYBOX_CONFIG_UNEXPAND
770 By default, convert only leading sequences of blanks to tabs.
772 config BUSYBOX_CONFIG_FEATURE_UNEXPAND_LONG_OPTIONS
773 bool "Enable long options"
775 depends on BUSYBOX_CONFIG_UNEXPAND && BUSYBOX_CONFIG_LONG_OPTS
777 Support long options for the unexpand applet.
779 config BUSYBOX_CONFIG_UNIQ
783 uniq is used to remove duplicate lines from a sorted file.
785 config BUSYBOX_CONFIG_USLEEP
789 usleep is used to pause for a specified number of microseconds.
791 config BUSYBOX_CONFIG_UUDECODE
795 uudecode is used to decode a uuencoded file.
797 config BUSYBOX_CONFIG_UUENCODE
801 uuencode is used to uuencode a file.
803 config BUSYBOX_CONFIG_WC
807 wc is used to print the number of bytes, words, and lines,
810 config BUSYBOX_CONFIG_FEATURE_WC_LARGE
811 bool "Support very large files in wc"
813 depends on BUSYBOX_CONFIG_WC
815 Use "unsigned long long" in wc for counter variables.
817 config BUSYBOX_CONFIG_WHO
820 select BUSYBOX_CONFIG_FEATURE_UTMP
822 who is used to show who is logged on.
824 config BUSYBOX_CONFIG_WHOAMI
828 whoami is used to print the username of the current
829 user id (same as id -un).
831 config BUSYBOX_CONFIG_YES
835 yes is used to repeatedly output a specific string, or
836 the default string `y'.
838 comment "Common options for cp and mv"
839 depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
841 config BUSYBOX_CONFIG_FEATURE_PRESERVE_HARDLINKS
842 bool "Preserve hard links"
844 depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
846 Allow cp and mv to preserve hard links.
848 comment "Common options for ls, more and telnet"
849 depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
851 config BUSYBOX_CONFIG_FEATURE_AUTOWIDTH
852 bool "Calculate terminal & column widths"
854 depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
856 This option allows utilities such as 'ls', 'more' and 'telnet'
857 to determine the width of the screen, which can allow them to
858 display additional text or avoid wrapping text onto the next line.
859 If you leave this disabled, your utilities will be especially
860 primitive and will be unable to determine the current screen width.
862 comment "Common options for df, du, ls"
863 depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
865 config BUSYBOX_CONFIG_FEATURE_HUMAN_READABLE
866 bool "Support for human readable output (example 13k, 23M, 235G)"
868 depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
870 Allow df, du, and ls to have human readable output.
872 comment "Common options for md5sum, sha1sum, sha256sum, sha512sum"
873 depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM || BUSYBOX_CONFIG_SHA256SUM || BUSYBOX_CONFIG_SHA512SUM
875 config BUSYBOX_CONFIG_FEATURE_MD5_SHA1_SUM_CHECK
876 bool "Enable -c, -s and -w options"
878 depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM || BUSYBOX_CONFIG_SHA256SUM || BUSYBOX_CONFIG_SHA512SUM
880 Enabling the -c options allows files to be checked
881 against pre-calculated hash values.
883 -s and -w are useful options when verifying checksums.