2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
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.
20 cal is used to display a monthly calender.
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.
33 Display nonprinting characters as escape sequences (like some
34 implementations' cat -v option).
40 chgrp is used to change the group ownership of files.
46 chmod is used to change the access permission of files.
52 chown is used to change the user and/or group ownership
59 chroot is used to change the root directory and run a command.
60 The default command is `/bin/sh'.
66 cksum is used to calculate the CRC32 checksum of a file.
72 comm is used to compare two files line by line and return
73 a three-column output.
79 cp is used to copy files and directories.
85 cut is used to print selected parts of lines from
92 date is used to set the system date or display the
93 current time in the given format.
95 config FEATURE_DATE_ISOFMT
96 bool "Enable ISO date format output (-I)"
100 Enable option (-I) to output an ISO-8601 compliant
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 FEATURE_DD_SIGNAL_HANDLING
112 bool "Enable DD signal handling for status reporting"
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 FEATURE_DD_IBS_OBS
125 bool "Enable ibs, obs and conv options"
129 Enables support for writing a certain number of bytes in and out,
130 at a time, and performing conversions on the data stream.
136 df reports the amount of disk space used and available
139 config FEATURE_DF_FANCY
140 bool "Enable -a, -i, -B"
144 This option enables -a, -i and -B.
150 dirname is used to strip a non-directory suffix from
154 bool "dos2unix/unix2dos"
157 dos2unix is used to convert a text file from DOS format to
158 UNIX format, and vice versa.
165 unix2dos is used to convert a text file from UNIX format to
166 DOS format, and vice versa.
169 bool "du (default blocksize of 512 bytes)"
172 du is used to report the amount of disk space used
175 config FEATURE_DU_DEFAULT_BLOCKSIZE_1K
176 bool "Use a default blocksize of 1024 bytes (1K)"
180 Use a blocksize of (1K) instead of the default 512b.
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 FEATURE_FANCY_ECHO
190 bool "Enable echo options (-n and -e)"
192 depends on ECHO || ASH_BUILTIN_ECHO
194 This adds options (-n and -e) to echo.
200 env is used to set an environment variable and run
201 a command; without options it displays the current
204 config FEATURE_ENV_LONG_OPTIONS
205 bool "Enable long options"
207 depends on ENV && GETOPT_LONG
209 Support long options for the env applet.
215 By default, convert all tabs to spaces.
217 config FEATURE_EXPAND_LONG_OPTIONS
218 bool "Enable long options"
220 depends on EXPAND && GETOPT_LONG
222 Support long options for the expand applet.
228 expr is used to calculate numbers and print the result
231 config EXPR_MATH_SUPPORT_64
232 bool "Extend Posix numbers support to 64 bit"
236 Enable 64-bit math support in the expr applet. This will make
237 the applet slightly larger, but will allow computation with very
244 false returns an exit code of FALSE (1).
250 Wrap text to fit a specific width.
256 head is used to print the first specified number of lines
259 config FEATURE_FANCY_HEAD
260 bool "Enable head options (-c, -q, and -v)"
264 This enables the head options (-c, -q, and -v).
270 hostid prints the numeric identifier (in hexadecimal) for
277 id displays the current user and group ID names.
283 Copy files and set attributes.
285 config FEATURE_INSTALL_LONG_OPTIONS
286 bool "Enable long options"
288 depends on INSTALL && GETOPT_LONG
290 Support long options for the install applet.
296 length is used to print out the length of a specified string.
302 ln is used to create hard or soft links between files.
308 logname is used to print the current user's login name.
314 ls is used to list the contents of directories.
316 config FEATURE_LS_FILETYPES
317 bool "Enable filetyping options (-p and -F)"
321 Enable the ls options (-p and -F).
323 config FEATURE_LS_FOLLOWLINKS
324 bool "Enable symlinks dereferencing (-L)"
328 Enable the ls option (-L).
330 config FEATURE_LS_RECURSIVE
331 bool "Enable recursion (-R)"
335 Enable the ls option (-R).
337 config FEATURE_LS_SORTFILES
338 bool "Sort the file names"
342 Allow ls to sort file names alphabetically.
344 config FEATURE_LS_TIMESTAMPS
345 bool "Show file timestamps"
349 Allow ls to display timestamps for files.
351 config FEATURE_LS_USERNAME
352 bool "Show username/groupnames"
356 Allow ls to display username/groupname for files.
358 config FEATURE_LS_COLOR
359 bool "Allow use of color to identify file types"
361 depends on LS && GETOPT_LONG
363 This enables the --color option to ls.
365 config FEATURE_LS_COLOR_IS_DEFAULT
366 bool "Produce colored ls output by default"
368 depends on 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
380 md5sum is used to print or check MD5 checksums.
386 mkdir is used to create directories with the specified names.
388 config FEATURE_MKDIR_LONG_OPTIONS
389 bool "Enable long options"
391 depends on MKDIR && GETOPT_LONG
393 Support long options for the mkdir applet.
399 mkfifo is used to create FIFOs (named pipes).
400 The `mknod' program can also create FIFOs.
406 mknod is used to create FIFOs or block/character special
407 files with the specified names.
413 mv is used to move or rename files or directories.
415 config FEATURE_MV_LONG_OPTIONS
416 bool "Enable long options"
418 depends on MV && GETOPT_LONG
420 Support long options for the mv applet.
426 nice runs a program with modified scheduling priority.
432 run a command immune to hangups, with output to a non-tty.
438 od is used to dump binary files in octal and other formats.
444 printenv is used to print all or part of environment.
450 printf is used to format and print specified strings.
451 It's similar to `echo' except it has more options.
457 pwd is used to print the current directory.
463 This program reads a symbolic link and returns the name
464 of the file it points to
466 config FEATURE_READLINK_FOLLOW
467 bool "Enable canonicalization by following all symlinks (-f)"
471 Enable the readlink option (-f).
477 Return the canonicalized absolute pathname.
478 This isn't provided by GNU shellutils, but where else does it belong.
484 rm is used to remove files or directories.
490 rmdir is used to remove empty directories.
492 config FEATURE_RMDIR_LONG_OPTIONS
493 bool "Enable long options"
495 depends on RMDIR && GETOPT_LONG
497 Support long options for the rmdir applet, including
498 --ignore-fail-on-non-empty for compatibility with GNU rmdir.
504 print a sequence of numbers
510 Compute and check SHA1 message digest
516 Compute and check SHA256 message digest
522 Compute and check SHA512 message digest
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 FEATURE_FANCY_SLEEP
539 bool "Enable multiple arguments and s/m/h/d suffixes"
543 Allow sleep to pause for specified minutes, hours, and days.
545 config FEATURE_FLOAT_SLEEP
546 bool "Enable fractional arguments"
548 depends on FEATURE_FANCY_SLEEP
550 Allow for fractional numeric parameters.
556 sort is used to sort lines of text in specified files.
558 config FEATURE_SORT_BIG
559 bool "Full SuSv3 compliant sort (support -ktcsbdfiozgM)"
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
574 split a file into pieces.
576 config FEATURE_SPLIT_FANCY
577 bool "Fancy extensions"
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.
589 display file or filesystem status.
591 config FEATURE_STAT_FORMAT
592 bool "Enable custom formats (-c)"
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.
604 stty is used to change and print terminal line settings.
610 checksum and count the blocks in a file
616 sync is used to flush filesystem buffers.
622 tac is used to concatenate and print files in reverse.
628 tail is used to print the last specified number of lines
631 config FEATURE_FANCY_TAIL
632 bool "Enable extra tail options (-q, -s, and -v)"
636 The options (-q, -s, and -v) are provided by GNU tail, but
637 are not specific in the SUSv3 standard.
643 tee is used to read from standard input and write
644 to standard output and files.
646 config FEATURE_TEE_USE_BLOCK_IO
647 bool "Enable block I/O (larger/faster) instead of byte I/O"
651 Enable this option for a faster tee, at expense of size.
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 FEATURE_TEST_64
662 bool "Extend test to 64 bit"
664 depends on TEST || ASH_BUILTIN_TEST
666 Enable 64-bit support in test.
672 touch is used to create or change the access and/or
673 modification timestamp of specified files.
679 tr is used to squeeze, and/or delete characters from standard
680 input, writing to standard output.
682 config FEATURE_TR_CLASSES
683 bool "Enable character classes (such as [:upper:])"
687 Enable character classes, enabling commands such as:
688 tr [:upper:] [:lower:] to convert input into lowercase.
690 config FEATURE_TR_EQUIV
691 bool "Enable equivalence classes"
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
705 true returns an exit code of TRUE (0).
711 tty is used to print the name of the current terminal to
718 uname is used to print system information.
724 By default, convert only leading sequences of blanks to tabs.
726 config FEATURE_UNEXPAND_LONG_OPTIONS
727 bool "Enable long options"
729 depends on UNEXPAND && GETOPT_LONG
731 Support long options for the unexpand applet.
737 uniq is used to remove duplicate lines from a sorted file.
743 usleep is used to pause for a specified number of microseconds.
749 uudecode is used to decode a uuencoded file.
755 uuencode is used to uuencode a file.
761 wc is used to print the number of bytes, words, and lines,
764 config FEATURE_WC_LARGE
765 bool "Support very large files in wc"
769 Use "unsigned long long" in wc for count variables.
776 who is used to show who is logged on.
782 whoami is used to print the username of the current
783 user id (same as id -un).
789 yes is used to repeatedly output a specific string, or
790 the default string `y'.
792 comment "Common options for cp and mv"
795 config FEATURE_PRESERVE_HARDLINKS
796 bool "Preserve hard links"
800 Allow cp and mv to preserve hard links.
802 comment "Common options for ls, more and telnet"
803 depends on LS || MORE || TELNET
805 config FEATURE_AUTOWIDTH
806 bool "Calculate terminal & column widths"
808 depends on LS || MORE || 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 DF || DU || LS
819 config FEATURE_HUMAN_READABLE
820 bool "Support for human readable output (example 13k, 23M, 235G)"
822 depends on DF || DU || LS
824 Allow df, du, and ls to have human readable output.
826 comment "Common options for md5sum, sha1sum"
827 depends on MD5SUM || SHA1SUM
829 config FEATURE_MD5_SHA1_SUM_CHECK
830 bool "Enable -c, -s and -w options"
832 depends on MD5SUM || 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.