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_DIRNAME
142 dirname is used to strip a non-directory suffix from
145 config BUSYBOX_CONFIG_DOS2UNIX
146 bool "dos2unix/unix2dos"
149 dos2unix is used to convert a text file from DOS format to
150 UNIX format, and vice versa.
152 config BUSYBOX_CONFIG_UNIX2DOS
155 depends on BUSYBOX_CONFIG_DOS2UNIX
157 unix2dos is used to convert a text file from UNIX format to
158 DOS format, and vice versa.
160 config BUSYBOX_CONFIG_DU
161 bool "du (default blocksize of 512 bytes)"
164 du is used to report the amount of disk space used
167 config BUSYBOX_CONFIG_FEATURE_DU_DEFAULT_BLOCKSIZE_1K
168 bool "Use a default blocksize of 1024 bytes (1K)"
170 depends on BUSYBOX_CONFIG_DU
172 Use a blocksize of (1K) instead of the default 512b.
174 config BUSYBOX_CONFIG_ECHO
175 bool "echo (basic SuSv3 version taking no options)"
178 echo is used to print a specified string to stdout.
180 # this entry also appears in shell/Config.in, next to the echo builtin
181 config BUSYBOX_CONFIG_FEATURE_FANCY_ECHO
182 bool "Enable echo options (-n and -e)"
184 depends on BUSYBOX_CONFIG_ECHO
186 This adds options (-n and -e) to echo.
188 config BUSYBOX_CONFIG_ENV
192 env is used to set an environment variable and run
193 a command; without options it displays the current
196 config BUSYBOX_CONFIG_FEATURE_ENV_LONG_OPTIONS
197 bool "Enable long options"
199 depends on BUSYBOX_CONFIG_ENV && BUSYBOX_CONFIG_GETOPT_LONG
201 Support long options for the env applet.
203 config BUSYBOX_CONFIG_EXPAND
207 By default, convert all tabs to spaces.
209 config BUSYBOX_CONFIG_FEATURE_EXPAND_LONG_OPTIONS
210 bool "Enable long options"
212 depends on BUSYBOX_CONFIG_EXPAND && BUSYBOX_CONFIG_GETOPT_LONG
214 Support long options for the expand applet.
216 config BUSYBOX_CONFIG_EXPR
220 expr is used to calculate numbers and print the result
223 config BUSYBOX_CONFIG_EXPR_MATH_SUPPORT_64
224 bool "Extend Posix numbers support to 64 bit"
226 depends on BUSYBOX_CONFIG_EXPR
228 Enable 64-bit math support in the expr applet. This will make
229 the applet slightly larger, but will allow computation with very
232 config BUSYBOX_CONFIG_FALSE
236 false returns an exit code of FALSE (1).
238 config BUSYBOX_CONFIG_FOLD
242 Wrap text to fit a specific width.
244 config BUSYBOX_CONFIG_HEAD
248 head is used to print the first specified number of lines
251 config BUSYBOX_CONFIG_FEATURE_FANCY_HEAD
252 bool "Enable head options (-c, -q, and -v)"
254 depends on BUSYBOX_CONFIG_HEAD
256 This enables the head options (-c, -q, and -v).
258 config BUSYBOX_CONFIG_HOSTID
262 hostid prints the numeric identifier (in hexadecimal) for
265 config BUSYBOX_CONFIG_ID
269 id displays the current user and group ID names.
271 config BUSYBOX_CONFIG_INSTALL
275 Copy files and set attributes.
277 config BUSYBOX_CONFIG_FEATURE_INSTALL_LONG_OPTIONS
278 bool "Enable long options"
280 depends on BUSYBOX_CONFIG_INSTALL && BUSYBOX_CONFIG_GETOPT_LONG
282 Support long options for the install applet.
284 config BUSYBOX_CONFIG_LENGTH
288 length is used to print out the length of a specified string.
290 config BUSYBOX_CONFIG_LN
294 ln is used to create hard or soft links between files.
296 config BUSYBOX_CONFIG_LOGNAME
300 logname is used to print the current user's login name.
302 config BUSYBOX_CONFIG_LS
306 ls is used to list the contents of directories.
308 config BUSYBOX_CONFIG_FEATURE_LS_FILETYPES
309 bool "Enable filetyping options (-p and -F)"
311 depends on BUSYBOX_CONFIG_LS
313 Enable the ls options (-p and -F).
315 config BUSYBOX_CONFIG_FEATURE_LS_FOLLOWLINKS
316 bool "Enable symlinks dereferencing (-L)"
318 depends on BUSYBOX_CONFIG_LS
320 Enable the ls option (-L).
322 config BUSYBOX_CONFIG_FEATURE_LS_RECURSIVE
323 bool "Enable recursion (-R)"
325 depends on BUSYBOX_CONFIG_LS
327 Enable the ls option (-R).
329 config BUSYBOX_CONFIG_FEATURE_LS_SORTFILES
330 bool "Sort the file names"
332 depends on BUSYBOX_CONFIG_LS
334 Allow ls to sort file names alphabetically.
336 config BUSYBOX_CONFIG_FEATURE_LS_TIMESTAMPS
337 bool "Show file timestamps"
339 depends on BUSYBOX_CONFIG_LS
341 Allow ls to display timestamps for files.
343 config BUSYBOX_CONFIG_FEATURE_LS_USERNAME
344 bool "Show username/groupnames"
346 depends on BUSYBOX_CONFIG_LS
348 Allow ls to display username/groupname for files.
350 config BUSYBOX_CONFIG_FEATURE_LS_COLOR
351 bool "Allow use of color to identify file types"
353 depends on BUSYBOX_CONFIG_LS && BUSYBOX_CONFIG_GETOPT_LONG
355 This enables the --color option to ls.
357 config BUSYBOX_CONFIG_FEATURE_LS_COLOR_IS_DEFAULT
358 bool "Produce colored ls output by default"
360 depends on BUSYBOX_CONFIG_FEATURE_LS_COLOR
362 Saying yes here will turn coloring on by default,
363 even if no "--color" option is given to the ls command.
364 This is not recommended, since the colors are not
365 configurable, and the output may not be legible on
368 config BUSYBOX_CONFIG_MD5SUM
372 md5sum is used to print or check MD5 checksums.
374 config BUSYBOX_CONFIG_MKDIR
378 mkdir is used to create directories with the specified names.
380 config BUSYBOX_CONFIG_FEATURE_MKDIR_LONG_OPTIONS
381 bool "Enable long options"
383 depends on BUSYBOX_CONFIG_MKDIR && BUSYBOX_CONFIG_GETOPT_LONG
385 Support long options for the mkdir applet.
387 config BUSYBOX_CONFIG_MKFIFO
391 mkfifo is used to create FIFOs (named pipes).
392 The `mknod' program can also create FIFOs.
394 config BUSYBOX_CONFIG_MKNOD
398 mknod is used to create FIFOs or block/character special
399 files with the specified names.
401 config BUSYBOX_CONFIG_MV
405 mv is used to move or rename files or directories.
407 config BUSYBOX_CONFIG_FEATURE_MV_LONG_OPTIONS
408 bool "Enable long options"
410 depends on BUSYBOX_CONFIG_MV && BUSYBOX_CONFIG_GETOPT_LONG
412 Support long options for the mv applet.
414 config BUSYBOX_CONFIG_NICE
418 nice runs a program with modified scheduling priority.
420 config BUSYBOX_CONFIG_NOHUP
424 run a command immune to hangups, with output to a non-tty.
426 config BUSYBOX_CONFIG_OD
430 od is used to dump binary files in octal and other formats.
432 config BUSYBOX_CONFIG_PRINTENV
436 printenv is used to print all or part of environment.
438 config BUSYBOX_CONFIG_PRINTF
442 printf is used to format and print specified strings.
443 It's similar to `echo' except it has more options.
445 config BUSYBOX_CONFIG_PWD
449 pwd is used to print the current directory.
451 config BUSYBOX_CONFIG_READLINK
455 This program reads a symbolic link and returns the name
456 of the file it points to
458 config BUSYBOX_CONFIG_FEATURE_READLINK_FOLLOW
459 bool "Enable canonicalization by following all symlinks (-f)"
461 depends on BUSYBOX_CONFIG_READLINK
463 Enable the readlink option (-f).
465 config BUSYBOX_CONFIG_REALPATH
469 Return the canonicalized absolute pathname.
470 This isn't provided by GNU shellutils, but where else does it belong.
472 config BUSYBOX_CONFIG_RM
476 rm is used to remove files or directories.
478 config BUSYBOX_CONFIG_RMDIR
482 rmdir is used to remove empty directories.
484 config BUSYBOX_CONFIG_SEQ
488 print a sequence of numbers
490 config BUSYBOX_CONFIG_SHA1SUM
494 Compute and check SHA1 message digest
496 config BUSYBOX_CONFIG_SLEEP
497 bool "sleep (single integer arg with no suffix)"
500 sleep is used to pause for a specified number of seconds,
502 config BUSYBOX_CONFIG_FEATURE_FANCY_SLEEP
503 bool "Enable multiple integer args and optional time suffixes"
505 depends on BUSYBOX_CONFIG_SLEEP
507 Allow sleep to pause for specified minutes, hours, and days.
509 config BUSYBOX_CONFIG_SORT
513 sort is used to sort lines of text in specified files.
515 config BUSYBOX_CONFIG_FEATURE_SORT_BIG
516 bool "full SuSv3 compliant sort (Support -ktcsbdfiozgM)"
518 depends on BUSYBOX_CONFIG_SORT
520 Without this, sort only supports -r, -u, and an integer version
521 of -n. Selecting this adds sort keys, floating point support, and
522 more. This adds a little over 3k to a nonstatic build on x86.
524 The SuSv3 sort standard is available at:
525 http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
527 config BUSYBOX_CONFIG_SPLIT
531 split a file into pieces.
533 config BUSYBOX_CONFIG_FEATURE_SPLIT_FANCY
534 bool "fancy extensions"
536 depends on BUSYBOX_CONFIG_SPLIT
538 Add support for features not required by SUSv3.
539 Supports additional suffixes 'b' for 512 bytes,
540 'g' for 1GiB for the -b option.
542 config BUSYBOX_CONFIG_STAT
546 display file or filesystem status.
548 config BUSYBOX_CONFIG_FEATURE_STAT_FORMAT
549 bool "Enable custom formats (-c)"
551 depends on BUSYBOX_CONFIG_STAT
553 Without this, stat will not support the '-c format' option where
554 users can pass a custom format string for output. This adds about
555 7k to a nonstatic build on amd64.
557 config BUSYBOX_CONFIG_STTY
561 stty is used to change and print terminal line settings.
563 config BUSYBOX_CONFIG_SUM
567 checksum and count the blocks in a file
569 config BUSYBOX_CONFIG_SYNC
573 sync is used to flush filesystem buffers.
575 config BUSYBOX_CONFIG_TAIL
579 tail is used to print the last specified number of lines
582 config BUSYBOX_CONFIG_FEATURE_FANCY_TAIL
583 bool "Enable extra tail options (-q, -s, and -v)"
585 depends on BUSYBOX_CONFIG_TAIL
587 The options (-q, -s, and -v) are provided by GNU tail, but
588 are not specific in the SUSv3 standard.
590 config BUSYBOX_CONFIG_TEE
594 tee is used to read from standard input and write
595 to standard output and files.
597 config BUSYBOX_CONFIG_FEATURE_TEE_USE_BLOCK_IO
598 bool "Enable block i/o (larger/faster) instead of byte i/o."
600 depends on BUSYBOX_CONFIG_TEE
602 Enable this option for a faster tee, at expense of size.
604 config BUSYBOX_CONFIG_TEST
608 test is used to check file types and compare values,
609 returning an appropriate exit code. The bash shell
610 has test built in, ash can build it in optionally.
612 config BUSYBOX_CONFIG_FEATURE_TEST_64
613 bool "Extend test to 64 bit"
615 depends on BUSYBOX_CONFIG_TEST
617 Enable 64-bit support in test.
619 config BUSYBOX_CONFIG_TOUCH
623 touch is used to create or change the access and/or
624 modification timestamp of specified files.
626 config BUSYBOX_CONFIG_TR
630 tr is used to squeeze, and/or delete characters from standard
631 input, writing to standard output.
633 config BUSYBOX_CONFIG_FEATURE_TR_CLASSES
634 bool "Enable character classes (such as [:upper:])"
636 depends on BUSYBOX_CONFIG_TR
638 Enable character classes, enabling commands such as:
639 tr [:upper:] [:lower:] to convert input into lowercase.
641 config BUSYBOX_CONFIG_FEATURE_TR_EQUIV
642 bool "Enable equivalence classes"
644 depends on BUSYBOX_CONFIG_TR
646 Enable equivalence classes, which essentially add the enclosed
647 character to the current set. For instance, tr [=a=] xyz would
648 replace all instances of 'a' with 'xyz'. This option is mainly
649 useful for cases when no other way of expressing a character
652 config BUSYBOX_CONFIG_TRUE
656 true returns an exit code of TRUE (0).
658 config BUSYBOX_CONFIG_TTY
662 tty is used to print the name of the current terminal to
665 config BUSYBOX_CONFIG_UNAME
669 uname is used to print system information.
671 config BUSYBOX_CONFIG_UNEXPAND
675 By default, convert only leading sequences of blanks to tabs.
677 config BUSYBOX_CONFIG_FEATURE_UNEXPAND_LONG_OPTIONS
678 bool "Enable long options"
680 depends on BUSYBOX_CONFIG_UNEXPAND && BUSYBOX_CONFIG_GETOPT_LONG
682 Support long options for the unexpand applet.
684 config BUSYBOX_CONFIG_UNIQ
688 uniq is used to remove duplicate lines from a sorted file.
690 config BUSYBOX_CONFIG_USLEEP
694 usleep is used to pause for a specified number of microseconds.
696 config BUSYBOX_CONFIG_UUDECODE
700 uudecode is used to decode a uuencoded file.
702 config BUSYBOX_CONFIG_UUENCODE
706 uuencode is used to uuencode a file.
708 config BUSYBOX_CONFIG_WC
712 wc is used to print the number of bytes, words, and lines,
715 config BUSYBOX_CONFIG_FEATURE_WC_LARGE
716 bool "Support very large files in wc"
718 depends on BUSYBOX_CONFIG_WC
720 Use "unsigned long long" in wc for count variables
722 config BUSYBOX_CONFIG_WHO
725 select BUSYBOX_CONFIG_FEATURE_UTMP
727 who is used to show who is logged on.
729 config BUSYBOX_CONFIG_WHOAMI
733 whoami is used to print the username of the current
734 user id (same as id -un).
736 config BUSYBOX_CONFIG_YES
740 yes is used to repeatedly output a specific string, or
741 the default string `y'.
743 comment "Common options for cp and mv"
744 depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
746 config BUSYBOX_CONFIG_FEATURE_PRESERVE_HARDLINKS
747 bool "Preserve hard links"
749 depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
751 Allow cp and mv to preserve hard links.
753 comment "Common options for ls, more and telnet"
754 depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
756 config BUSYBOX_CONFIG_FEATURE_AUTOWIDTH
757 bool "Calculate terminal & column widths"
759 depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
761 This option allows utilities such as 'ls', 'more' and 'telnet'
762 to determine the width of the screen, which can allow them to
763 display additional text or avoid wrapping text onto the next line.
764 If you leave this disabled, your utilities will be especially
765 primitive and will be unable to determine the current screen width.
767 comment "Common options for df, du, ls"
768 depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
770 config BUSYBOX_CONFIG_FEATURE_HUMAN_READABLE
771 bool "Support for human readable output (example 13k, 23M, 235G)"
773 depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
775 Allow df, du, and ls to have human readable output.
777 comment "Common options for md5sum, sha1sum"
778 depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM
780 config BUSYBOX_CONFIG_FEATURE_MD5_SHA1_SUM_CHECK
781 bool "Enable -c, -s and -w options"
783 depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM
785 Enabling the -c options allows files to be checked
786 against pre-calculated hash values.
788 -s and -w are useful options when verifying checksums.