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_LONG_OPTS
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_LONG_OPTS
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_FSYNC
256 fsync is used to flush file-related cached blocks to disk.
258 config BUSYBOX_CONFIG_HEAD
262 head is used to print the first specified number of lines
265 config BUSYBOX_CONFIG_FEATURE_FANCY_HEAD
266 bool "Enable head options (-c, -q, and -v)"
268 depends on BUSYBOX_CONFIG_HEAD
270 This enables the head options (-c, -q, and -v).
272 config BUSYBOX_CONFIG_HOSTID
276 hostid prints the numeric identifier (in hexadecimal) for
279 config BUSYBOX_CONFIG_ID
283 id displays the current user and group ID names.
285 config BUSYBOX_CONFIG_INSTALL
289 Copy files and set attributes.
291 config BUSYBOX_CONFIG_FEATURE_INSTALL_LONG_OPTIONS
292 bool "Enable long options"
294 depends on BUSYBOX_CONFIG_INSTALL && BUSYBOX_CONFIG_LONG_OPTS
296 Support long options for the install applet.
298 config BUSYBOX_CONFIG_LENGTH
302 length is used to print out the length of a specified string.
304 config BUSYBOX_CONFIG_LN
308 ln is used to create hard or soft links between files.
310 config BUSYBOX_CONFIG_LOGNAME
314 logname is used to print the current user's login name.
316 config BUSYBOX_CONFIG_LS
320 ls is used to list the contents of directories.
322 config BUSYBOX_CONFIG_FEATURE_LS_FILETYPES
323 bool "Enable filetyping options (-p and -F)"
325 depends on BUSYBOX_CONFIG_LS
327 Enable the ls options (-p and -F).
329 config BUSYBOX_CONFIG_FEATURE_LS_FOLLOWLINKS
330 bool "Enable symlinks dereferencing (-L)"
332 depends on BUSYBOX_CONFIG_LS
334 Enable the ls option (-L).
336 config BUSYBOX_CONFIG_FEATURE_LS_RECURSIVE
337 bool "Enable recursion (-R)"
339 depends on BUSYBOX_CONFIG_LS
341 Enable the ls option (-R).
343 config BUSYBOX_CONFIG_FEATURE_LS_SORTFILES
344 bool "Sort the file names"
346 depends on BUSYBOX_CONFIG_LS
348 Allow ls to sort file names alphabetically.
350 config BUSYBOX_CONFIG_FEATURE_LS_TIMESTAMPS
351 bool "Show file timestamps"
353 depends on BUSYBOX_CONFIG_LS
355 Allow ls to display timestamps for files.
357 config BUSYBOX_CONFIG_FEATURE_LS_USERNAME
358 bool "Show username/groupnames"
360 depends on BUSYBOX_CONFIG_LS
362 Allow ls to display username/groupname for files.
364 config BUSYBOX_CONFIG_FEATURE_LS_COLOR
365 bool "Allow use of color to identify file types"
367 depends on BUSYBOX_CONFIG_LS && BUSYBOX_CONFIG_LONG_OPTS
369 This enables the --color option to ls.
371 config BUSYBOX_CONFIG_FEATURE_LS_COLOR_IS_DEFAULT
372 bool "Produce colored ls output by default"
374 depends on BUSYBOX_CONFIG_FEATURE_LS_COLOR
376 Saying yes here will turn coloring on by default,
377 even if no "--color" option is given to the ls command.
378 This is not recommended, since the colors are not
379 configurable, and the output may not be legible on
382 config BUSYBOX_CONFIG_MD5SUM
386 md5sum is used to print or check MD5 checksums.
388 config BUSYBOX_CONFIG_MKDIR
392 mkdir is used to create directories with the specified names.
394 config BUSYBOX_CONFIG_FEATURE_MKDIR_LONG_OPTIONS
395 bool "Enable long options"
397 depends on BUSYBOX_CONFIG_MKDIR && BUSYBOX_CONFIG_LONG_OPTS
399 Support long options for the mkdir applet.
401 config BUSYBOX_CONFIG_MKFIFO
405 mkfifo is used to create FIFOs (named pipes).
406 The `mknod' program can also create FIFOs.
408 config BUSYBOX_CONFIG_MKNOD
412 mknod is used to create FIFOs or block/character special
413 files with the specified names.
415 config BUSYBOX_CONFIG_MV
419 mv is used to move or rename files or directories.
421 config BUSYBOX_CONFIG_FEATURE_MV_LONG_OPTIONS
422 bool "Enable long options"
424 depends on BUSYBOX_CONFIG_MV && BUSYBOX_CONFIG_LONG_OPTS
426 Support long options for the mv applet.
428 config BUSYBOX_CONFIG_NICE
432 nice runs a program with modified scheduling priority.
434 config BUSYBOX_CONFIG_NOHUP
438 run a command immune to hangups, with output to a non-tty.
440 config BUSYBOX_CONFIG_OD
444 od is used to dump binary files in octal and other formats.
446 config BUSYBOX_CONFIG_PRINTENV
450 printenv is used to print all or part of environment.
452 config BUSYBOX_CONFIG_PRINTF
456 printf is used to format and print specified strings.
457 It's similar to `echo' except it has more options.
459 config BUSYBOX_CONFIG_PWD
463 pwd is used to print the current directory.
465 config BUSYBOX_CONFIG_READLINK
469 This program reads a symbolic link and returns the name
470 of the file it points to
472 config BUSYBOX_CONFIG_FEATURE_READLINK_FOLLOW
473 bool "Enable canonicalization by following all symlinks (-f)"
475 depends on BUSYBOX_CONFIG_READLINK
477 Enable the readlink option (-f).
479 config BUSYBOX_CONFIG_REALPATH
483 Return the canonicalized absolute pathname.
484 This isn't provided by GNU shellutils, but where else does it belong.
486 config BUSYBOX_CONFIG_RM
490 rm is used to remove files or directories.
492 config BUSYBOX_CONFIG_RMDIR
496 rmdir is used to remove empty directories.
498 config BUSYBOX_CONFIG_FEATURE_RMDIR_LONG_OPTIONS
499 bool "Enable long options"
501 depends on BUSYBOX_CONFIG_RMDIR && BUSYBOX_CONFIG_LONG_OPTS
503 Support long options for the rmdir applet, including
504 --ignore-fail-on-non-empty for compatibility with GNU rmdir.
506 config BUSYBOX_CONFIG_SEQ
510 print a sequence of numbers
512 config BUSYBOX_CONFIG_SHA1SUM
516 Compute and check SHA1 message digest
518 config BUSYBOX_CONFIG_SHA256SUM
522 Compute and check SHA256 message digest
524 config BUSYBOX_CONFIG_SHA512SUM
528 Compute and check SHA512 message digest
530 config BUSYBOX_CONFIG_SLEEP
534 sleep is used to pause for a specified number of seconds.
535 It comes in 3 versions:
536 - small: takes one integer parameter
537 - fancy: takes multiple integer arguments with suffixes:
539 - fancy with fractional numbers:
540 sleep 2.3s 4.5h sleeps for 16202.3 seconds
541 Last one is "the most compatible" with coreutils sleep,
542 but it adds around 1k of code.
544 config BUSYBOX_CONFIG_FEATURE_FANCY_SLEEP
545 bool "Enable multiple arguments and s/m/h/d suffixes"
547 depends on BUSYBOX_CONFIG_SLEEP
549 Allow sleep to pause for specified minutes, hours, and days.
551 config BUSYBOX_CONFIG_FEATURE_FLOAT_SLEEP
552 bool "Enable fractional arguments"
554 depends on BUSYBOX_CONFIG_FEATURE_FANCY_SLEEP
556 Allow for fractional numeric parameters.
558 config BUSYBOX_CONFIG_SORT
562 sort is used to sort lines of text in specified files.
564 config BUSYBOX_CONFIG_FEATURE_SORT_BIG
565 bool "Full SuSv3 compliant sort (support -ktcsbdfiozgM)"
567 depends on BUSYBOX_CONFIG_SORT
569 Without this, sort only supports -r, -u, and an integer version
570 of -n. Selecting this adds sort keys, floating point support, and
571 more. This adds a little over 3k to a nonstatic build on x86.
573 The SuSv3 sort standard is available at:
574 http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
576 config BUSYBOX_CONFIG_SPLIT
580 split a file into pieces.
582 config BUSYBOX_CONFIG_FEATURE_SPLIT_FANCY
583 bool "Fancy extensions"
585 depends on BUSYBOX_CONFIG_SPLIT
587 Add support for features not required by SUSv3.
588 Supports additional suffixes 'b' for 512 bytes,
589 'g' for 1GiB for the -b option.
591 config BUSYBOX_CONFIG_STAT
595 display file or filesystem status.
597 config BUSYBOX_CONFIG_FEATURE_STAT_FORMAT
598 bool "Enable custom formats (-c)"
600 depends on BUSYBOX_CONFIG_STAT
602 Without this, stat will not support the '-c format' option where
603 users can pass a custom format string for output. This adds about
604 7k to a nonstatic build on amd64.
606 config BUSYBOX_CONFIG_STTY
610 stty is used to change and print terminal line settings.
612 config BUSYBOX_CONFIG_SUM
616 checksum and count the blocks in a file
618 config BUSYBOX_CONFIG_SYNC
622 sync is used to flush filesystem buffers.
624 config BUSYBOX_CONFIG_TAC
628 tac is used to concatenate and print files in reverse.
630 config BUSYBOX_CONFIG_TAIL
634 tail is used to print the last specified number of lines
637 config BUSYBOX_CONFIG_FEATURE_FANCY_TAIL
638 bool "Enable extra tail options (-q, -s, -v, and -F)"
640 depends on BUSYBOX_CONFIG_TAIL
642 The options (-q, -s, and -v) are provided by GNU tail, but
643 are not specific in the SUSv3 standard.
645 config BUSYBOX_CONFIG_TEE
649 tee is used to read from standard input and write
650 to standard output and files.
652 config BUSYBOX_CONFIG_FEATURE_TEE_USE_BLOCK_IO
653 bool "Enable block I/O (larger/faster) instead of byte I/O"
655 depends on BUSYBOX_CONFIG_TEE
657 Enable this option for a faster tee, at expense of size.
659 config BUSYBOX_CONFIG_TEST
663 test is used to check file types and compare values,
664 returning an appropriate exit code. The bash shell
665 has test built in, ash can build it in optionally.
667 config BUSYBOX_CONFIG_FEATURE_TEST_64
668 bool "Extend test to 64 bit"
670 depends on BUSYBOX_CONFIG_TEST || BUSYBOX_CONFIG_ASH_BUILTIN_TEST || BUSYBOX_CONFIG_HUSH
672 Enable 64-bit support in test.
674 config BUSYBOX_CONFIG_TOUCH
678 touch is used to create or change the access and/or
679 modification timestamp of specified files.
681 config BUSYBOX_CONFIG_TR
685 tr is used to squeeze, and/or delete characters from standard
686 input, writing to standard output.
688 config BUSYBOX_CONFIG_FEATURE_TR_CLASSES
689 bool "Enable character classes (such as [:upper:])"
691 depends on BUSYBOX_CONFIG_TR
693 Enable character classes, enabling commands such as:
694 tr [:upper:] [:lower:] to convert input into lowercase.
696 config BUSYBOX_CONFIG_FEATURE_TR_EQUIV
697 bool "Enable equivalence classes"
699 depends on BUSYBOX_CONFIG_TR
701 Enable equivalence classes, which essentially add the enclosed
702 character to the current set. For instance, tr [=a=] xyz would
703 replace all instances of 'a' with 'xyz'. This option is mainly
704 useful for cases when no other way of expressing a character
707 config BUSYBOX_CONFIG_TRUE
711 true returns an exit code of TRUE (0).
713 config BUSYBOX_CONFIG_TTY
717 tty is used to print the name of the current terminal to
720 config BUSYBOX_CONFIG_UNAME
724 uname is used to print system information.
726 config BUSYBOX_CONFIG_UNEXPAND
730 By default, convert only leading sequences of blanks to tabs.
732 config BUSYBOX_CONFIG_FEATURE_UNEXPAND_LONG_OPTIONS
733 bool "Enable long options"
735 depends on BUSYBOX_CONFIG_UNEXPAND && BUSYBOX_CONFIG_LONG_OPTS
737 Support long options for the unexpand applet.
739 config BUSYBOX_CONFIG_UNIQ
743 uniq is used to remove duplicate lines from a sorted file.
745 config BUSYBOX_CONFIG_USLEEP
749 usleep is used to pause for a specified number of microseconds.
751 config BUSYBOX_CONFIG_UUDECODE
755 uudecode is used to decode a uuencoded file.
757 config BUSYBOX_CONFIG_UUENCODE
761 uuencode is used to uuencode a file.
763 config BUSYBOX_CONFIG_WC
767 wc is used to print the number of bytes, words, and lines,
770 config BUSYBOX_CONFIG_FEATURE_WC_LARGE
771 bool "Support very large files in wc"
773 depends on BUSYBOX_CONFIG_WC
775 Use "unsigned long long" in wc for counter variables.
777 config BUSYBOX_CONFIG_WHO
780 select BUSYBOX_CONFIG_FEATURE_UTMP
782 who is used to show who is logged on.
784 config BUSYBOX_CONFIG_WHOAMI
788 whoami is used to print the username of the current
789 user id (same as id -un).
791 config BUSYBOX_CONFIG_YES
795 yes is used to repeatedly output a specific string, or
796 the default string `y'.
798 comment "Common options for cp and mv"
799 depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
801 config BUSYBOX_CONFIG_FEATURE_PRESERVE_HARDLINKS
802 bool "Preserve hard links"
804 depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
806 Allow cp and mv to preserve hard links.
808 comment "Common options for ls, more and telnet"
809 depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
811 config BUSYBOX_CONFIG_FEATURE_AUTOWIDTH
812 bool "Calculate terminal & column widths"
814 depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
816 This option allows utilities such as 'ls', 'more' and 'telnet'
817 to determine the width of the screen, which can allow them to
818 display additional text or avoid wrapping text onto the next line.
819 If you leave this disabled, your utilities will be especially
820 primitive and will be unable to determine the current screen width.
822 comment "Common options for df, du, ls"
823 depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
825 config BUSYBOX_CONFIG_FEATURE_HUMAN_READABLE
826 bool "Support for human readable output (example 13k, 23M, 235G)"
828 depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
830 Allow df, du, and ls to have human readable output.
832 comment "Common options for md5sum, sha1sum"
833 depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM
835 config BUSYBOX_CONFIG_FEATURE_MD5_SHA1_SUM_CHECK
836 bool "Enable -c, -s and -w options"
838 depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM
840 Enabling the -c options allows files to be checked
841 against pre-calculated hash values.
843 -s and -w are useful options when verifying checksums.