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_CHROOT
59 chroot is used to change the root directory and run a command.
60 The default command is `/bin/sh'.
62 config BUSYBOX_CONFIG_CKSUM
66 cksum is used to calculate the CRC32 checksum of a file.
68 config BUSYBOX_CONFIG_COMM
72 comm is used to compare two files line by line and return
73 a three-column output.
75 config BUSYBOX_CONFIG_CP
79 cp is used to copy files and directories.
81 config BUSYBOX_CONFIG_CUT
85 cut is used to print selected parts of lines from
88 config BUSYBOX_CONFIG_DATE
92 date is used to set the system date or display the
93 current time in the given format.
95 config BUSYBOX_CONFIG_FEATURE_DATE_ISOFMT
96 bool "Enable ISO date format output (-I)"
98 depends on BUSYBOX_CONFIG_DATE
100 Enable option (-I) to output an ISO-8601 compliant
103 config BUSYBOX_CONFIG_DD
107 dd copies a file (from standard input to standard output,
108 by default) using specific input and output blocksizes,
109 while optionally performing conversions on it.
111 config BUSYBOX_CONFIG_FEATURE_DD_SIGNAL_HANDLING
112 bool "Enable DD signal handling for status reporting"
114 depends on BUSYBOX_CONFIG_DD
116 sending a SIGUSR1 signal to a running `dd' process makes it
117 print to standard error the number of records read and written
118 so far, then to resume copying.
120 $ dd if=/dev/zero of=/dev/null&
121 $ pid=$! kill -USR1 $pid; sleep 1; kill $pid
122 10899206+0 records in 10899206+0 records out
124 config BUSYBOX_CONFIG_FEATURE_DD_IBS_OBS
125 bool "Enable ibs, obs and conv options"
127 depends on BUSYBOX_CONFIG_DD
129 Enables support for writing a certain number of bytes in and out,
130 at a time, and performing conversions on the data stream.
132 config BUSYBOX_CONFIG_DF
136 df reports the amount of disk space used and available
139 config BUSYBOX_CONFIG_FEATURE_DF_FANCY
140 bool "Enable -a, -i, -B"
142 depends on BUSYBOX_CONFIG_DF
144 This option enables -a, -i and -B.
146 config BUSYBOX_CONFIG_DIRNAME
150 dirname is used to strip a non-directory suffix from
153 config BUSYBOX_CONFIG_DOS2UNIX
154 bool "dos2unix/unix2dos"
157 dos2unix is used to convert a text file from DOS format to
158 UNIX format, and vice versa.
160 config BUSYBOX_CONFIG_UNIX2DOS
163 depends on BUSYBOX_CONFIG_DOS2UNIX
165 unix2dos is used to convert a text file from UNIX format to
166 DOS format, and vice versa.
168 config BUSYBOX_CONFIG_DU
169 bool "du (default blocksize of 512 bytes)"
172 du is used to report the amount of disk space used
175 config BUSYBOX_CONFIG_FEATURE_DU_DEFAULT_BLOCKSIZE_1K
176 bool "Use a default blocksize of 1024 bytes (1K)"
178 depends on BUSYBOX_CONFIG_DU
180 Use a blocksize of (1K) instead of the default 512b.
182 config BUSYBOX_CONFIG_ECHO
183 bool "echo (basic SuSv3 version taking no options)"
186 echo is used to print a specified string to stdout.
188 # this entry also appears in shell/Config.in, next to the echo builtin
189 config BUSYBOX_CONFIG_FEATURE_FANCY_ECHO
190 bool "Enable echo options (-n and -e)"
192 depends on BUSYBOX_CONFIG_ECHO || BUSYBOX_CONFIG_ASH_BUILTIN_ECHO || BUSYBOX_CONFIG_HUSH
194 This adds options (-n and -e) to echo.
196 config BUSYBOX_CONFIG_ENV
200 env is used to set an environment variable and run
201 a command; without options it displays the current
204 config BUSYBOX_CONFIG_FEATURE_ENV_LONG_OPTIONS
205 bool "Enable long options"
207 depends on BUSYBOX_CONFIG_ENV && BUSYBOX_CONFIG_GETOPT_LONG
209 Support long options for the env applet.
211 config BUSYBOX_CONFIG_EXPAND
215 By default, convert all tabs to spaces.
217 config BUSYBOX_CONFIG_FEATURE_EXPAND_LONG_OPTIONS
218 bool "Enable long options"
220 depends on BUSYBOX_CONFIG_EXPAND && BUSYBOX_CONFIG_GETOPT_LONG
222 Support long options for the expand applet.
224 config BUSYBOX_CONFIG_EXPR
228 expr is used to calculate numbers and print the result
231 config BUSYBOX_CONFIG_EXPR_MATH_SUPPORT_64
232 bool "Extend Posix numbers support to 64 bit"
234 depends on BUSYBOX_CONFIG_EXPR
236 Enable 64-bit math support in the expr applet. This will make
237 the applet slightly larger, but will allow computation with very
240 config BUSYBOX_CONFIG_FALSE
244 false returns an exit code of FALSE (1).
246 config BUSYBOX_CONFIG_FOLD
250 Wrap text to fit a specific width.
252 config BUSYBOX_CONFIG_HEAD
256 head is used to print the first specified number of lines
259 config BUSYBOX_CONFIG_FEATURE_FANCY_HEAD
260 bool "Enable head options (-c, -q, and -v)"
262 depends on BUSYBOX_CONFIG_HEAD
264 This enables the head options (-c, -q, and -v).
266 config BUSYBOX_CONFIG_HOSTID
270 hostid prints the numeric identifier (in hexadecimal) for
273 config BUSYBOX_CONFIG_ID
277 id displays the current user and group ID names.
279 config BUSYBOX_CONFIG_INSTALL
283 Copy files and set attributes.
285 config BUSYBOX_CONFIG_FEATURE_INSTALL_LONG_OPTIONS
286 bool "Enable long options"
288 depends on BUSYBOX_CONFIG_INSTALL && BUSYBOX_CONFIG_GETOPT_LONG
290 Support long options for the install applet.
292 config BUSYBOX_CONFIG_LENGTH
296 length is used to print out the length of a specified string.
298 config BUSYBOX_CONFIG_LN
302 ln is used to create hard or soft links between files.
304 config BUSYBOX_CONFIG_LOGNAME
308 logname is used to print the current user's login name.
310 config BUSYBOX_CONFIG_LS
314 ls is used to list the contents of directories.
316 config BUSYBOX_CONFIG_FEATURE_LS_FILETYPES
317 bool "Enable filetyping options (-p and -F)"
319 depends on BUSYBOX_CONFIG_LS
321 Enable the ls options (-p and -F).
323 config BUSYBOX_CONFIG_FEATURE_LS_FOLLOWLINKS
324 bool "Enable symlinks dereferencing (-L)"
326 depends on BUSYBOX_CONFIG_LS
328 Enable the ls option (-L).
330 config BUSYBOX_CONFIG_FEATURE_LS_RECURSIVE
331 bool "Enable recursion (-R)"
333 depends on BUSYBOX_CONFIG_LS
335 Enable the ls option (-R).
337 config BUSYBOX_CONFIG_FEATURE_LS_SORTFILES
338 bool "Sort the file names"
340 depends on BUSYBOX_CONFIG_LS
342 Allow ls to sort file names alphabetically.
344 config BUSYBOX_CONFIG_FEATURE_LS_TIMESTAMPS
345 bool "Show file timestamps"
347 depends on BUSYBOX_CONFIG_LS
349 Allow ls to display timestamps for files.
351 config BUSYBOX_CONFIG_FEATURE_LS_USERNAME
352 bool "Show username/groupnames"
354 depends on BUSYBOX_CONFIG_LS
356 Allow ls to display username/groupname for files.
358 config BUSYBOX_CONFIG_FEATURE_LS_COLOR
359 bool "Allow use of color to identify file types"
361 depends on BUSYBOX_CONFIG_LS && BUSYBOX_CONFIG_GETOPT_LONG
363 This enables the --color option to ls.
365 config BUSYBOX_CONFIG_FEATURE_LS_COLOR_IS_DEFAULT
366 bool "Produce colored ls output by default"
368 depends on BUSYBOX_CONFIG_FEATURE_LS_COLOR
370 Saying yes here will turn coloring on by default,
371 even if no "--color" option is given to the ls command.
372 This is not recommended, since the colors are not
373 configurable, and the output may not be legible on
376 config BUSYBOX_CONFIG_MD5SUM
380 md5sum is used to print or check MD5 checksums.
382 config BUSYBOX_CONFIG_MKDIR
386 mkdir is used to create directories with the specified names.
388 config BUSYBOX_CONFIG_FEATURE_MKDIR_LONG_OPTIONS
389 bool "Enable long options"
391 depends on BUSYBOX_CONFIG_MKDIR && BUSYBOX_CONFIG_GETOPT_LONG
393 Support long options for the mkdir applet.
395 config BUSYBOX_CONFIG_MKFIFO
399 mkfifo is used to create FIFOs (named pipes).
400 The `mknod' program can also create FIFOs.
402 config BUSYBOX_CONFIG_MKNOD
406 mknod is used to create FIFOs or block/character special
407 files with the specified names.
409 config BUSYBOX_CONFIG_MV
413 mv is used to move or rename files or directories.
415 config BUSYBOX_CONFIG_FEATURE_MV_LONG_OPTIONS
416 bool "Enable long options"
418 depends on BUSYBOX_CONFIG_MV && BUSYBOX_CONFIG_GETOPT_LONG
420 Support long options for the mv applet.
422 config BUSYBOX_CONFIG_NICE
426 nice runs a program with modified scheduling priority.
428 config BUSYBOX_CONFIG_NOHUP
432 run a command immune to hangups, with output to a non-tty.
434 config BUSYBOX_CONFIG_OD
438 od is used to dump binary files in octal and other formats.
440 config BUSYBOX_CONFIG_PRINTENV
444 printenv is used to print all or part of environment.
446 config BUSYBOX_CONFIG_PRINTF
450 printf is used to format and print specified strings.
451 It's similar to `echo' except it has more options.
453 config BUSYBOX_CONFIG_PWD
457 pwd is used to print the current directory.
459 config BUSYBOX_CONFIG_READLINK
463 This program reads a symbolic link and returns the name
464 of the file it points to
466 config BUSYBOX_CONFIG_FEATURE_READLINK_FOLLOW
467 bool "Enable canonicalization by following all symlinks (-f)"
469 depends on BUSYBOX_CONFIG_READLINK
471 Enable the readlink option (-f).
473 config BUSYBOX_CONFIG_REALPATH
477 Return the canonicalized absolute pathname.
478 This isn't provided by GNU shellutils, but where else does it belong.
480 config BUSYBOX_CONFIG_RM
484 rm is used to remove files or directories.
486 config BUSYBOX_CONFIG_RMDIR
490 rmdir is used to remove empty directories.
492 config BUSYBOX_CONFIG_FEATURE_RMDIR_LONG_OPTIONS
493 bool "Enable long options"
495 depends on BUSYBOX_CONFIG_RMDIR && BUSYBOX_CONFIG_GETOPT_LONG
497 Support long options for the rmdir applet, including
498 --ignore-fail-on-non-empty for compatibility with GNU rmdir.
500 config BUSYBOX_CONFIG_SEQ
504 print a sequence of numbers
506 config BUSYBOX_CONFIG_SHA1SUM
510 Compute and check SHA1 message digest
512 config BUSYBOX_CONFIG_SHA256SUM
516 Compute and check SHA256 message digest
518 config BUSYBOX_CONFIG_SHA512SUM
522 Compute and check SHA512 message digest
524 config BUSYBOX_CONFIG_SLEEP
528 sleep is used to pause for a specified number of seconds.
529 It comes in 3 versions:
530 - small: takes one integer parameter
531 - fancy: takes multiple integer arguments with suffixes:
533 - fancy with fractional numbers:
534 sleep 2.3s 4.5h sleeps for 16202.3 seconds
535 Last one is "the most compatible" with coreutils sleep,
536 but it adds around 1k of code.
538 config BUSYBOX_CONFIG_FEATURE_FANCY_SLEEP
539 bool "Enable multiple arguments and s/m/h/d suffixes"
541 depends on BUSYBOX_CONFIG_SLEEP
543 Allow sleep to pause for specified minutes, hours, and days.
545 config BUSYBOX_CONFIG_FEATURE_FLOAT_SLEEP
546 bool "Enable fractional arguments"
548 depends on BUSYBOX_CONFIG_FEATURE_FANCY_SLEEP
550 Allow for fractional numeric parameters.
552 config BUSYBOX_CONFIG_SORT
556 sort is used to sort lines of text in specified files.
558 config BUSYBOX_CONFIG_FEATURE_SORT_BIG
559 bool "Full SuSv3 compliant sort (support -ktcsbdfiozgM)"
561 depends on BUSYBOX_CONFIG_SORT
563 Without this, sort only supports -r, -u, and an integer version
564 of -n. Selecting this adds sort keys, floating point support, and
565 more. This adds a little over 3k to a nonstatic build on x86.
567 The SuSv3 sort standard is available at:
568 http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
570 config BUSYBOX_CONFIG_SPLIT
574 split a file into pieces.
576 config BUSYBOX_CONFIG_FEATURE_SPLIT_FANCY
577 bool "Fancy extensions"
579 depends on BUSYBOX_CONFIG_SPLIT
581 Add support for features not required by SUSv3.
582 Supports additional suffixes 'b' for 512 bytes,
583 'g' for 1GiB for the -b option.
585 config BUSYBOX_CONFIG_STAT
589 display file or filesystem status.
591 config BUSYBOX_CONFIG_FEATURE_STAT_FORMAT
592 bool "Enable custom formats (-c)"
594 depends on BUSYBOX_CONFIG_STAT
596 Without this, stat will not support the '-c format' option where
597 users can pass a custom format string for output. This adds about
598 7k to a nonstatic build on amd64.
600 config BUSYBOX_CONFIG_STTY
604 stty is used to change and print terminal line settings.
606 config BUSYBOX_CONFIG_SUM
610 checksum and count the blocks in a file
612 config BUSYBOX_CONFIG_SYNC
616 sync is used to flush filesystem buffers.
618 config BUSYBOX_CONFIG_TAC
622 tac is used to concatenate and print files in reverse.
624 config BUSYBOX_CONFIG_TAIL
628 tail is used to print the last specified number of lines
631 config BUSYBOX_CONFIG_FEATURE_FANCY_TAIL
632 bool "Enable extra tail options (-q, -s, and -v)"
634 depends on BUSYBOX_CONFIG_TAIL
636 The options (-q, -s, and -v) are provided by GNU tail, but
637 are not specific in the SUSv3 standard.
639 config BUSYBOX_CONFIG_TEE
643 tee is used to read from standard input and write
644 to standard output and files.
646 config BUSYBOX_CONFIG_FEATURE_TEE_USE_BLOCK_IO
647 bool "Enable block I/O (larger/faster) instead of byte I/O"
649 depends on BUSYBOX_CONFIG_TEE
651 Enable this option for a faster tee, at expense of size.
653 config BUSYBOX_CONFIG_TEST
657 test is used to check file types and compare values,
658 returning an appropriate exit code. The bash shell
659 has test built in, ash can build it in optionally.
661 config BUSYBOX_CONFIG_FEATURE_TEST_64
662 bool "Extend test to 64 bit"
664 depends on BUSYBOX_CONFIG_TEST || BUSYBOX_CONFIG_ASH_BUILTIN_TEST
666 Enable 64-bit support in test.
668 config BUSYBOX_CONFIG_TOUCH
672 touch is used to create or change the access and/or
673 modification timestamp of specified files.
675 config BUSYBOX_CONFIG_TR
679 tr is used to squeeze, and/or delete characters from standard
680 input, writing to standard output.
682 config BUSYBOX_CONFIG_FEATURE_TR_CLASSES
683 bool "Enable character classes (such as [:upper:])"
685 depends on BUSYBOX_CONFIG_TR
687 Enable character classes, enabling commands such as:
688 tr [:upper:] [:lower:] to convert input into lowercase.
690 config BUSYBOX_CONFIG_FEATURE_TR_EQUIV
691 bool "Enable equivalence classes"
693 depends on BUSYBOX_CONFIG_TR
695 Enable equivalence classes, which essentially add the enclosed
696 character to the current set. For instance, tr [=a=] xyz would
697 replace all instances of 'a' with 'xyz'. This option is mainly
698 useful for cases when no other way of expressing a character
701 config BUSYBOX_CONFIG_TRUE
705 true returns an exit code of TRUE (0).
707 config BUSYBOX_CONFIG_TTY
711 tty is used to print the name of the current terminal to
714 config BUSYBOX_CONFIG_UNAME
718 uname is used to print system information.
720 config BUSYBOX_CONFIG_UNEXPAND
724 By default, convert only leading sequences of blanks to tabs.
726 config BUSYBOX_CONFIG_FEATURE_UNEXPAND_LONG_OPTIONS
727 bool "Enable long options"
729 depends on BUSYBOX_CONFIG_UNEXPAND && BUSYBOX_CONFIG_GETOPT_LONG
731 Support long options for the unexpand applet.
733 config BUSYBOX_CONFIG_UNIQ
737 uniq is used to remove duplicate lines from a sorted file.
739 config BUSYBOX_CONFIG_USLEEP
743 usleep is used to pause for a specified number of microseconds.
745 config BUSYBOX_CONFIG_UUDECODE
749 uudecode is used to decode a uuencoded file.
751 config BUSYBOX_CONFIG_UUENCODE
755 uuencode is used to uuencode a file.
757 config BUSYBOX_CONFIG_WC
761 wc is used to print the number of bytes, words, and lines,
764 config BUSYBOX_CONFIG_FEATURE_WC_LARGE
765 bool "Support very large files in wc"
767 depends on BUSYBOX_CONFIG_WC
769 Use "unsigned long long" in wc for counter variables.
771 config BUSYBOX_CONFIG_WHO
774 select BUSYBOX_CONFIG_FEATURE_UTMP
776 who is used to show who is logged on.
778 config BUSYBOX_CONFIG_WHOAMI
782 whoami is used to print the username of the current
783 user id (same as id -un).
785 config BUSYBOX_CONFIG_YES
789 yes is used to repeatedly output a specific string, or
790 the default string `y'.
792 comment "Common options for cp and mv"
793 depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
795 config BUSYBOX_CONFIG_FEATURE_PRESERVE_HARDLINKS
796 bool "Preserve hard links"
798 depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
800 Allow cp and mv to preserve hard links.
802 comment "Common options for ls, more and telnet"
803 depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
805 config BUSYBOX_CONFIG_FEATURE_AUTOWIDTH
806 bool "Calculate terminal & column widths"
808 depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
810 This option allows utilities such as 'ls', 'more' and 'telnet'
811 to determine the width of the screen, which can allow them to
812 display additional text or avoid wrapping text onto the next line.
813 If you leave this disabled, your utilities will be especially
814 primitive and will be unable to determine the current screen width.
816 comment "Common options for df, du, ls"
817 depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
819 config BUSYBOX_CONFIG_FEATURE_HUMAN_READABLE
820 bool "Support for human readable output (example 13k, 23M, 235G)"
822 depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
824 Allow df, du, and ls to have human readable output.
826 comment "Common options for md5sum, sha1sum"
827 depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM
829 config BUSYBOX_CONFIG_FEATURE_MD5_SHA1_SUM_CHECK
830 bool "Enable -c, -s and -w options"
832 depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM
834 Enabling the -c options allows files to be checked
835 against pre-calculated hash values.
837 -s and -w are useful options when verifying checksums.