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& pid=$! $ kill -USR1 $pid; sleep 1; kill $pid
121 10899206+0 records in 10899206+0 records out
123 config BUSYBOX_CONFIG_FEATURE_DD_IBS_OBS
124 bool "Enable ibs, obs and conv options"
126 depends on BUSYBOX_CONFIG_DD
128 Enables support for writing a certain number of bytes in and out,
129 at a time, and performing conversions on the data stream.
131 config BUSYBOX_CONFIG_DF
135 df reports the amount of disk space used and available
138 config BUSYBOX_CONFIG_FEATURE_DF_INODE
139 bool "Enable -i (inode information)"
141 depends on BUSYBOX_CONFIG_DF
143 This option enables support for df -i.
145 config BUSYBOX_CONFIG_DIRNAME
149 dirname is used to strip a non-directory suffix from
152 config BUSYBOX_CONFIG_DOS2UNIX
153 bool "dos2unix/unix2dos"
156 dos2unix is used to convert a text file from DOS format to
157 UNIX format, and vice versa.
159 config BUSYBOX_CONFIG_UNIX2DOS
162 depends on BUSYBOX_CONFIG_DOS2UNIX
164 unix2dos is used to convert a text file from UNIX format to
165 DOS format, and vice versa.
167 config BUSYBOX_CONFIG_DU
168 bool "du (default blocksize of 512 bytes)"
171 du is used to report the amount of disk space used
174 config BUSYBOX_CONFIG_FEATURE_DU_DEFAULT_BLOCKSIZE_1K
175 bool "Use a default blocksize of 1024 bytes (1K)"
177 depends on BUSYBOX_CONFIG_DU
179 Use a blocksize of (1K) instead of the default 512b.
181 config BUSYBOX_CONFIG_ECHO
182 bool "echo (basic SuSv3 version taking no options)"
185 echo is used to print a specified string to stdout.
187 # this entry also appears in shell/Config.in, next to the echo builtin
188 config BUSYBOX_CONFIG_FEATURE_FANCY_ECHO
189 bool "Enable echo options (-n and -e)"
191 depends on BUSYBOX_CONFIG_ECHO
193 This adds options (-n and -e) to echo.
195 config BUSYBOX_CONFIG_ENV
199 env is used to set an environment variable and run
200 a command; without options it displays the current
203 config BUSYBOX_CONFIG_FEATURE_ENV_LONG_OPTIONS
204 bool "Enable long options"
206 depends on BUSYBOX_CONFIG_ENV && BUSYBOX_CONFIG_GETOPT_LONG
208 Support long options for the env applet.
210 config BUSYBOX_CONFIG_EXPAND
214 By default, convert all tabs to spaces.
216 config BUSYBOX_CONFIG_FEATURE_EXPAND_LONG_OPTIONS
217 bool "Enable long options"
219 depends on BUSYBOX_CONFIG_EXPAND && BUSYBOX_CONFIG_GETOPT_LONG
221 Support long options for the expand applet.
223 config BUSYBOX_CONFIG_EXPR
227 expr is used to calculate numbers and print the result
230 config BUSYBOX_CONFIG_EXPR_MATH_SUPPORT_64
231 bool "Extend Posix numbers support to 64 bit"
233 depends on BUSYBOX_CONFIG_EXPR
235 Enable 64-bit math support in the expr applet. This will make
236 the applet slightly larger, but will allow computation with very
239 config BUSYBOX_CONFIG_FALSE
243 false returns an exit code of FALSE (1).
245 config BUSYBOX_CONFIG_FOLD
249 Wrap text to fit a specific width.
251 config BUSYBOX_CONFIG_HEAD
255 head is used to print the first specified number of lines
258 config BUSYBOX_CONFIG_FEATURE_FANCY_HEAD
259 bool "Enable head options (-c, -q, and -v)"
261 depends on BUSYBOX_CONFIG_HEAD
263 This enables the head options (-c, -q, and -v).
265 config BUSYBOX_CONFIG_HOSTID
269 hostid prints the numeric identifier (in hexadecimal) for
272 config BUSYBOX_CONFIG_ID
276 id displays the current user and group ID names.
278 config BUSYBOX_CONFIG_INSTALL
282 Copy files and set attributes.
284 config BUSYBOX_CONFIG_FEATURE_INSTALL_LONG_OPTIONS
285 bool "Enable long options"
287 depends on BUSYBOX_CONFIG_INSTALL && BUSYBOX_CONFIG_GETOPT_LONG
289 Support long options for the install applet.
291 config BUSYBOX_CONFIG_LENGTH
295 length is used to print out the length of a specified string.
297 config BUSYBOX_CONFIG_LN
301 ln is used to create hard or soft links between files.
303 config BUSYBOX_CONFIG_LOGNAME
307 logname is used to print the current user's login name.
309 config BUSYBOX_CONFIG_LS
313 ls is used to list the contents of directories.
315 config BUSYBOX_CONFIG_FEATURE_LS_FILETYPES
316 bool "Enable filetyping options (-p and -F)"
318 depends on BUSYBOX_CONFIG_LS
320 Enable the ls options (-p and -F).
322 config BUSYBOX_CONFIG_FEATURE_LS_FOLLOWLINKS
323 bool "Enable symlinks dereferencing (-L)"
325 depends on BUSYBOX_CONFIG_LS
327 Enable the ls option (-L).
329 config BUSYBOX_CONFIG_FEATURE_LS_RECURSIVE
330 bool "Enable recursion (-R)"
332 depends on BUSYBOX_CONFIG_LS
334 Enable the ls option (-R).
336 config BUSYBOX_CONFIG_FEATURE_LS_SORTFILES
337 bool "Sort the file names"
339 depends on BUSYBOX_CONFIG_LS
341 Allow ls to sort file names alphabetically.
343 config BUSYBOX_CONFIG_FEATURE_LS_TIMESTAMPS
344 bool "Show file timestamps"
346 depends on BUSYBOX_CONFIG_LS
348 Allow ls to display timestamps for files.
350 config BUSYBOX_CONFIG_FEATURE_LS_USERNAME
351 bool "Show username/groupnames"
353 depends on BUSYBOX_CONFIG_LS
355 Allow ls to display username/groupname for files.
357 config BUSYBOX_CONFIG_FEATURE_LS_COLOR
358 bool "Allow use of color to identify file types"
360 depends on BUSYBOX_CONFIG_LS && BUSYBOX_CONFIG_GETOPT_LONG
362 This enables the --color option to ls.
364 config BUSYBOX_CONFIG_FEATURE_LS_COLOR_IS_DEFAULT
365 bool "Produce colored ls output by default"
367 depends on BUSYBOX_CONFIG_FEATURE_LS_COLOR
369 Saying yes here will turn coloring on by default,
370 even if no "--color" option is given to the ls command.
371 This is not recommended, since the colors are not
372 configurable, and the output may not be legible on
375 config BUSYBOX_CONFIG_MD5SUM
379 md5sum is used to print or check MD5 checksums.
381 config BUSYBOX_CONFIG_MKDIR
385 mkdir is used to create directories with the specified names.
387 config BUSYBOX_CONFIG_FEATURE_MKDIR_LONG_OPTIONS
388 bool "Enable long options"
390 depends on BUSYBOX_CONFIG_MKDIR && BUSYBOX_CONFIG_GETOPT_LONG
392 Support long options for the mkdir applet.
394 config BUSYBOX_CONFIG_MKFIFO
398 mkfifo is used to create FIFOs (named pipes).
399 The `mknod' program can also create FIFOs.
401 config BUSYBOX_CONFIG_MKNOD
405 mknod is used to create FIFOs or block/character special
406 files with the specified names.
408 config BUSYBOX_CONFIG_MV
412 mv is used to move or rename files or directories.
414 config BUSYBOX_CONFIG_FEATURE_MV_LONG_OPTIONS
415 bool "Enable long options"
417 depends on BUSYBOX_CONFIG_MV && BUSYBOX_CONFIG_GETOPT_LONG
419 Support long options for the mv applet.
421 config BUSYBOX_CONFIG_NICE
425 nice runs a program with modified scheduling priority.
427 config BUSYBOX_CONFIG_NOHUP
431 run a command immune to hangups, with output to a non-tty.
433 config BUSYBOX_CONFIG_OD
437 od is used to dump binary files in octal and other formats.
439 config BUSYBOX_CONFIG_PRINTENV
443 printenv is used to print all or part of environment.
445 config BUSYBOX_CONFIG_PRINTF
449 printf is used to format and print specified strings.
450 It's similar to `echo' except it has more options.
452 config BUSYBOX_CONFIG_PWD
456 pwd is used to print the current directory.
458 config BUSYBOX_CONFIG_READLINK
462 This program reads a symbolic link and returns the name
463 of the file it points to
465 config BUSYBOX_CONFIG_FEATURE_READLINK_FOLLOW
466 bool "Enable canonicalization by following all symlinks (-f)"
468 depends on BUSYBOX_CONFIG_READLINK
470 Enable the readlink option (-f).
472 config BUSYBOX_CONFIG_REALPATH
476 Return the canonicalized absolute pathname.
477 This isn't provided by GNU shellutils, but where else does it belong.
479 config BUSYBOX_CONFIG_RM
483 rm is used to remove files or directories.
485 config BUSYBOX_CONFIG_RMDIR
489 rmdir is used to remove empty directories.
491 config BUSYBOX_CONFIG_FEATURE_RMDIR_LONG_OPTIONS
492 bool "Enable long options"
494 depends on BUSYBOX_CONFIG_RMDIR && BUSYBOX_CONFIG_GETOPT_LONG
496 Support long options for the rmdir applet, including
497 --ignore-fail-on-non-empty for compatibility with GNU rmdir.
499 config BUSYBOX_CONFIG_SEQ
503 print a sequence of numbers
505 config BUSYBOX_CONFIG_SHA1SUM
509 Compute and check SHA1 message digest
511 config BUSYBOX_CONFIG_SLEEP
512 bool "sleep (single integer arg with no suffix)"
515 sleep is used to pause for a specified number of seconds,
517 config BUSYBOX_CONFIG_FEATURE_FANCY_SLEEP
518 bool "Enable multiple integer args and optional time suffixes"
520 depends on BUSYBOX_CONFIG_SLEEP
522 Allow sleep to pause for specified minutes, hours, and days.
524 config BUSYBOX_CONFIG_SORT
528 sort is used to sort lines of text in specified files.
530 config BUSYBOX_CONFIG_FEATURE_SORT_BIG
531 bool "Full SuSv3 compliant sort (support -ktcsbdfiozgM)"
533 depends on BUSYBOX_CONFIG_SORT
535 Without this, sort only supports -r, -u, and an integer version
536 of -n. Selecting this adds sort keys, floating point support, and
537 more. This adds a little over 3k to a nonstatic build on x86.
539 The SuSv3 sort standard is available at:
540 http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
542 config BUSYBOX_CONFIG_SPLIT
546 split a file into pieces.
548 config BUSYBOX_CONFIG_FEATURE_SPLIT_FANCY
549 bool "Fancy extensions"
551 depends on BUSYBOX_CONFIG_SPLIT
553 Add support for features not required by SUSv3.
554 Supports additional suffixes 'b' for 512 bytes,
555 'g' for 1GiB for the -b option.
557 config BUSYBOX_CONFIG_STAT
561 display file or filesystem status.
563 config BUSYBOX_CONFIG_FEATURE_STAT_FORMAT
564 bool "Enable custom formats (-c)"
566 depends on BUSYBOX_CONFIG_STAT
568 Without this, stat will not support the '-c format' option where
569 users can pass a custom format string for output. This adds about
570 7k to a nonstatic build on amd64.
572 config BUSYBOX_CONFIG_STTY
576 stty is used to change and print terminal line settings.
578 config BUSYBOX_CONFIG_SUM
582 checksum and count the blocks in a file
584 config BUSYBOX_CONFIG_SYNC
588 sync is used to flush filesystem buffers.
590 config BUSYBOX_CONFIG_TAC
594 tac is used to concatenate and print files in reverse.
596 config BUSYBOX_CONFIG_TAIL
600 tail is used to print the last specified number of lines
603 config BUSYBOX_CONFIG_FEATURE_FANCY_TAIL
604 bool "Enable extra tail options (-q, -s, and -v)"
606 depends on BUSYBOX_CONFIG_TAIL
608 The options (-q, -s, and -v) are provided by GNU tail, but
609 are not specific in the SUSv3 standard.
611 config BUSYBOX_CONFIG_TEE
615 tee is used to read from standard input and write
616 to standard output and files.
618 config BUSYBOX_CONFIG_FEATURE_TEE_USE_BLOCK_IO
619 bool "Enable block I/O (larger/faster) instead of byte I/O"
621 depends on BUSYBOX_CONFIG_TEE
623 Enable this option for a faster tee, at expense of size.
625 config BUSYBOX_CONFIG_TEST
629 test is used to check file types and compare values,
630 returning an appropriate exit code. The bash shell
631 has test built in, ash can build it in optionally.
633 config BUSYBOX_CONFIG_FEATURE_TEST_64
634 bool "Extend test to 64 bit"
636 depends on BUSYBOX_CONFIG_TEST
638 Enable 64-bit support in test.
640 config BUSYBOX_CONFIG_TOUCH
644 touch is used to create or change the access and/or
645 modification timestamp of specified files.
647 config BUSYBOX_CONFIG_TR
651 tr is used to squeeze, and/or delete characters from standard
652 input, writing to standard output.
654 config BUSYBOX_CONFIG_FEATURE_TR_CLASSES
655 bool "Enable character classes (such as [:upper:])"
657 depends on BUSYBOX_CONFIG_TR
659 Enable character classes, enabling commands such as:
660 tr [:upper:] [:lower:] to convert input into lowercase.
662 config BUSYBOX_CONFIG_FEATURE_TR_EQUIV
663 bool "Enable equivalence classes"
665 depends on BUSYBOX_CONFIG_TR
667 Enable equivalence classes, which essentially add the enclosed
668 character to the current set. For instance, tr [=a=] xyz would
669 replace all instances of 'a' with 'xyz'. This option is mainly
670 useful for cases when no other way of expressing a character
673 config BUSYBOX_CONFIG_TRUE
677 true returns an exit code of TRUE (0).
679 config BUSYBOX_CONFIG_TTY
683 tty is used to print the name of the current terminal to
686 config BUSYBOX_CONFIG_UNAME
690 uname is used to print system information.
692 config BUSYBOX_CONFIG_UNEXPAND
696 By default, convert only leading sequences of blanks to tabs.
698 config BUSYBOX_CONFIG_FEATURE_UNEXPAND_LONG_OPTIONS
699 bool "Enable long options"
701 depends on BUSYBOX_CONFIG_UNEXPAND && BUSYBOX_CONFIG_GETOPT_LONG
703 Support long options for the unexpand applet.
705 config BUSYBOX_CONFIG_UNIQ
709 uniq is used to remove duplicate lines from a sorted file.
711 config BUSYBOX_CONFIG_USLEEP
715 usleep is used to pause for a specified number of microseconds.
717 config BUSYBOX_CONFIG_UUDECODE
721 uudecode is used to decode a uuencoded file.
723 config BUSYBOX_CONFIG_UUENCODE
727 uuencode is used to uuencode a file.
729 config BUSYBOX_CONFIG_WC
733 wc is used to print the number of bytes, words, and lines,
736 config BUSYBOX_CONFIG_FEATURE_WC_LARGE
737 bool "Support very large files in wc"
739 depends on BUSYBOX_CONFIG_WC
741 Use "unsigned long long" in wc for count variables
743 config BUSYBOX_CONFIG_WHO
746 select BUSYBOX_CONFIG_FEATURE_UTMP
748 who is used to show who is logged on.
750 config BUSYBOX_CONFIG_WHOAMI
754 whoami is used to print the username of the current
755 user id (same as id -un).
757 config BUSYBOX_CONFIG_YES
761 yes is used to repeatedly output a specific string, or
762 the default string `y'.
764 comment "Common options for cp and mv"
765 depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
767 config BUSYBOX_CONFIG_FEATURE_PRESERVE_HARDLINKS
768 bool "Preserve hard links"
770 depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
772 Allow cp and mv to preserve hard links.
774 comment "Common options for ls, more and telnet"
775 depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
777 config BUSYBOX_CONFIG_FEATURE_AUTOWIDTH
778 bool "Calculate terminal & column widths"
780 depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
782 This option allows utilities such as 'ls', 'more' and 'telnet'
783 to determine the width of the screen, which can allow them to
784 display additional text or avoid wrapping text onto the next line.
785 If you leave this disabled, your utilities will be especially
786 primitive and will be unable to determine the current screen width.
788 comment "Common options for df, du, ls"
789 depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
791 config BUSYBOX_CONFIG_FEATURE_HUMAN_READABLE
792 bool "Support for human readable output (example 13k, 23M, 235G)"
794 depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
796 Allow df, du, and ls to have human readable output.
798 comment "Common options for md5sum, sha1sum"
799 depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM
801 config BUSYBOX_CONFIG_FEATURE_MD5_SHA1_SUM_CHECK
802 bool "Enable -c, -s and -w options"
804 depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM
806 Enabling the -c options allows files to be checked
807 against pre-calculated hash values.
809 -s and -w are useful options when verifying checksums.