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
55 config FEATURE_CHOWN_LONG_OPTIONS
56 bool "Enable long options"
58 depends on CHOWN && LONG_OPTS
60 Enable use of long options
66 chroot is used to change the root directory and run a command.
67 The default command is `/bin/sh'.
73 cksum is used to calculate the CRC32 checksum of a file.
79 comm is used to compare two files line by line and return
80 a three-column output.
86 cp is used to copy files and directories.
88 config FEATURE_CP_LONG_OPTIONS
89 bool "Enable long options for cp"
91 depends on CP && LONG_OPTS
93 Enable long options for cp.
94 Also add support for --parents option.
100 cut is used to print selected parts of lines from
107 date is used to set the system date or display the
108 current time in the given format.
110 config FEATURE_DATE_ISOFMT
111 bool "Enable ISO date format output (-I)"
115 Enable option (-I) to output an ISO-8601 compliant
118 config FEATURE_DATE_COMPAT
119 bool "Support weird 'date MMDDhhmm[[YY]YY][.ss]' format"
123 System time can be set by 'date -s DATE' and simply 'date DATE',
124 but formats of DATE string are different. 'date DATE' accepts
125 a rather weird MMDDhhmm[[YY]YY][.ss] format with completely
126 unnatural placement of year between minutes and seconds.
127 date -s (and other commands like touch -d) use more sensible
128 formats (for one, ISO format YYYY-MM-DD hh:mm:ss.ssssss).
130 With this option off, 'date DATE' is 'date -s DATE' support
131 the same format. With it on, 'date DATE' additionally supports
132 MMDDhhmm[[YY]YY][.ss] format.
138 dd copies a file (from standard input to standard output,
139 by default) using specific input and output blocksizes,
140 while optionally performing conversions on it.
142 config FEATURE_DD_SIGNAL_HANDLING
143 bool "Enable DD signal handling for status reporting"
147 Sending a SIGUSR1 signal to a running `dd' process makes it
148 print to standard error the number of records read and written
149 so far, then to resume copying.
151 $ dd if=/dev/zero of=/dev/null&
152 $ pid=$! kill -USR1 $pid; sleep 1; kill $pid
153 10899206+0 records in
154 10899206+0 records out
156 config FEATURE_DD_THIRD_STATUS_LINE
157 bool "Enable the third status line upon signal"
159 depends on DD && FEATURE_DD_SIGNAL_HANDLING
161 Displays a coreutils-like third status line with transferred bytes,
162 elapsed time and speed.
164 config FEATURE_DD_IBS_OBS
165 bool "Enable ibs, obs and conv options"
169 Enables support for writing a certain number of bytes in and out,
170 at a time, and performing conversions on the data stream.
176 df reports the amount of disk space used and available
179 config FEATURE_DF_FANCY
180 bool "Enable -a, -i, -B"
184 This option enables -a, -i and -B.
186 -a Show all filesystems
194 dirname is used to strip a non-directory suffix from
198 bool "dos2unix/unix2dos"
201 dos2unix is used to convert a text file from DOS format to
202 UNIX format, and vice versa.
209 unix2dos is used to convert a text file from UNIX format to
210 DOS format, and vice versa.
213 bool "du (default blocksize of 512 bytes)"
216 du is used to report the amount of disk space used
219 config FEATURE_DU_DEFAULT_BLOCKSIZE_1K
220 bool "Use a default blocksize of 1024 bytes (1K)"
224 Use a blocksize of (1K) instead of the default 512b.
227 bool "echo (basic SuSv3 version taking no options)"
230 echo is used to print a specified string to stdout.
232 # this entry also appears in shell/Config.in, next to the echo builtin
233 config FEATURE_FANCY_ECHO
234 bool "Enable echo options (-n and -e)"
236 depends on ECHO || ASH_BUILTIN_ECHO || HUSH
238 This adds options (-n and -e) to echo.
244 env is used to set an environment variable and run
245 a command; without options it displays the current
248 config FEATURE_ENV_LONG_OPTIONS
249 bool "Enable long options"
251 depends on ENV && LONG_OPTS
253 Support long options for the env applet.
259 By default, convert all tabs to spaces.
261 config FEATURE_EXPAND_LONG_OPTIONS
262 bool "Enable long options"
264 depends on EXPAND && LONG_OPTS
266 Support long options for the expand applet.
272 expr is used to calculate numbers and print the result
275 config EXPR_MATH_SUPPORT_64
276 bool "Extend Posix numbers support to 64 bit"
280 Enable 64-bit math support in the expr applet. This will make
281 the applet slightly larger, but will allow computation with very
288 false returns an exit code of FALSE (1).
294 Wrap text to fit a specific width.
300 fsync is used to flush file-related cached blocks to disk.
306 head is used to print the first specified number of lines
309 config FEATURE_FANCY_HEAD
310 bool "Enable head options (-c, -q, and -v)"
314 This enables the head options (-c, -q, and -v).
320 hostid prints the numeric identifier (in hexadecimal) for
327 id displays the current user and group ID names.
333 Copy files and set attributes.
335 config FEATURE_INSTALL_LONG_OPTIONS
336 bool "Enable long options"
338 depends on INSTALL && LONG_OPTS
340 Support long options for the install applet.
346 length is used to print out the length of a specified string.
352 ln is used to create hard or soft links between files.
358 logname is used to print the current user's login name.
364 ls is used to list the contents of directories.
366 config FEATURE_LS_FILETYPES
367 bool "Enable filetyping options (-p and -F)"
371 Enable the ls options (-p and -F).
373 config FEATURE_LS_FOLLOWLINKS
374 bool "Enable symlinks dereferencing (-L)"
378 Enable the ls option (-L).
380 config FEATURE_LS_RECURSIVE
381 bool "Enable recursion (-R)"
385 Enable the ls option (-R).
387 config FEATURE_LS_SORTFILES
388 bool "Sort the file names"
392 Allow ls to sort file names alphabetically.
394 config FEATURE_LS_TIMESTAMPS
395 bool "Show file timestamps"
399 Allow ls to display timestamps for files.
401 config FEATURE_LS_USERNAME
402 bool "Show username/groupnames"
406 Allow ls to display username/groupname for files.
408 config FEATURE_LS_COLOR
409 bool "Allow use of color to identify file types"
411 depends on LS && LONG_OPTS
413 This enables the --color option to ls.
415 config FEATURE_LS_COLOR_IS_DEFAULT
416 bool "Produce colored ls output by default"
418 depends on FEATURE_LS_COLOR
420 Saying yes here will turn coloring on by default,
421 even if no "--color" option is given to the ls command.
422 This is not recommended, since the colors are not
423 configurable, and the output may not be legible on
430 md5sum is used to print or check MD5 checksums.
436 mkdir is used to create directories with the specified names.
438 config FEATURE_MKDIR_LONG_OPTIONS
439 bool "Enable long options"
441 depends on MKDIR && LONG_OPTS
443 Support long options for the mkdir applet.
449 mkfifo is used to create FIFOs (named pipes).
450 The `mknod' program can also create FIFOs.
456 mknod is used to create FIFOs or block/character special
457 files with the specified names.
463 mv is used to move or rename files or directories.
465 config FEATURE_MV_LONG_OPTIONS
466 bool "Enable long options"
468 depends on MV && LONG_OPTS
470 Support long options for the mv applet.
476 nice runs a program with modified scheduling priority.
482 run a command immune to hangups, with output to a non-tty.
488 od is used to dump binary files in octal and other formats.
494 printenv is used to print all or part of environment.
500 printf is used to format and print specified strings.
501 It's similar to `echo' except it has more options.
507 pwd is used to print the current directory.
513 This program reads a symbolic link and returns the name
514 of the file it points to
516 config FEATURE_READLINK_FOLLOW
517 bool "Enable canonicalization by following all symlinks (-f)"
521 Enable the readlink option (-f).
527 Return the canonicalized absolute pathname.
528 This isn't provided by GNU shellutils, but where else does it belong.
534 rm is used to remove files or directories.
540 rmdir is used to remove empty directories.
542 config FEATURE_RMDIR_LONG_OPTIONS
543 bool "Enable long options"
545 depends on RMDIR && LONG_OPTS
547 Support long options for the rmdir applet, including
548 --ignore-fail-on-non-empty for compatibility with GNU rmdir.
554 print a sequence of numbers
560 Compute and check SHA1 message digest
566 Compute and check SHA256 message digest
572 Compute and check SHA512 message digest
578 sleep is used to pause for a specified number of seconds.
579 It comes in 3 versions:
580 - small: takes one integer parameter
581 - fancy: takes multiple integer arguments with suffixes:
583 - fancy with fractional numbers:
584 sleep 2.3s 4.5h sleeps for 16202.3 seconds
585 Last one is "the most compatible" with coreutils sleep,
586 but it adds around 1k of code.
588 config FEATURE_FANCY_SLEEP
589 bool "Enable multiple arguments and s/m/h/d suffixes"
593 Allow sleep to pause for specified minutes, hours, and days.
595 config FEATURE_FLOAT_SLEEP
596 bool "Enable fractional arguments"
598 depends on FEATURE_FANCY_SLEEP
600 Allow for fractional numeric parameters.
606 sort is used to sort lines of text in specified files.
608 config FEATURE_SORT_BIG
609 bool "Full SuSv3 compliant sort (support -ktcsbdfiozgM)"
613 Without this, sort only supports -r, -u, and an integer version
614 of -n. Selecting this adds sort keys, floating point support, and
615 more. This adds a little over 3k to a nonstatic build on x86.
617 The SuSv3 sort standard is available at:
618 http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
624 split a file into pieces.
626 config FEATURE_SPLIT_FANCY
627 bool "Fancy extensions"
631 Add support for features not required by SUSv3.
632 Supports additional suffixes 'b' for 512 bytes,
633 'g' for 1GiB for the -b option.
639 display file or filesystem status.
641 config FEATURE_STAT_FORMAT
642 bool "Enable custom formats (-c)"
646 Without this, stat will not support the '-c format' option where
647 users can pass a custom format string for output. This adds about
648 7k to a nonstatic build on amd64.
654 stty is used to change and print terminal line settings.
660 checksum and count the blocks in a file
666 sync is used to flush filesystem buffers.
672 tac is used to concatenate and print files in reverse.
678 tail is used to print the last specified number of lines
681 config FEATURE_FANCY_TAIL
682 bool "Enable extra tail options (-q, -s, -v, and -F)"
686 The options (-q, -s, and -v) are provided by GNU tail, but
687 are not specific in the SUSv3 standard.
689 -q Never output headers giving file names
690 -s SEC Wait SEC seconds between reads with -f
691 -v Always output headers giving file names
697 tee is used to read from standard input and write
698 to standard output and files.
700 config FEATURE_TEE_USE_BLOCK_IO
701 bool "Enable block I/O (larger/faster) instead of byte I/O"
705 Enable this option for a faster tee, at expense of size.
711 test is used to check file types and compare values,
712 returning an appropriate exit code. The bash shell
713 has test built in, ash can build it in optionally.
715 config FEATURE_TEST_64
716 bool "Extend test to 64 bit"
718 depends on TEST || ASH_BUILTIN_TEST || HUSH
720 Enable 64-bit support in test.
726 touch is used to create or change the access and/or
727 modification timestamp of specified files.
733 tr is used to squeeze, and/or delete characters from standard
734 input, writing to standard output.
736 config FEATURE_TR_CLASSES
737 bool "Enable character classes (such as [:upper:])"
741 Enable character classes, enabling commands such as:
742 tr [:upper:] [:lower:] to convert input into lowercase.
744 config FEATURE_TR_EQUIV
745 bool "Enable equivalence classes"
749 Enable equivalence classes, which essentially add the enclosed
750 character to the current set. For instance, tr [=a=] xyz would
751 replace all instances of 'a' with 'xyz'. This option is mainly
752 useful for cases when no other way of expressing a character
759 true returns an exit code of TRUE (0).
765 tty is used to print the name of the current terminal to
772 uname is used to print system information.
778 By default, convert only leading sequences of blanks to tabs.
780 config FEATURE_UNEXPAND_LONG_OPTIONS
781 bool "Enable long options"
783 depends on UNEXPAND && LONG_OPTS
785 Support long options for the unexpand applet.
791 uniq is used to remove duplicate lines from a sorted file.
797 usleep is used to pause for a specified number of microseconds.
803 uudecode is used to decode a uuencoded file.
809 uuencode is used to uuencode a file.
815 wc is used to print the number of bytes, words, and lines,
818 config FEATURE_WC_LARGE
819 bool "Support very large files in wc"
823 Use "unsigned long long" in wc for counter variables.
830 who is used to show who is logged on.
836 whoami is used to print the username of the current
837 user id (same as id -un).
843 yes is used to repeatedly output a specific string, or
844 the default string `y'.
846 comment "Common options for cp and mv"
849 config FEATURE_PRESERVE_HARDLINKS
850 bool "Preserve hard links"
854 Allow cp and mv to preserve hard links.
856 comment "Common options for ls, more and telnet"
857 depends on LS || MORE || TELNET
859 config FEATURE_AUTOWIDTH
860 bool "Calculate terminal & column widths"
862 depends on LS || MORE || TELNET
864 This option allows utilities such as 'ls', 'more' and 'telnet'
865 to determine the width of the screen, which can allow them to
866 display additional text or avoid wrapping text onto the next line.
867 If you leave this disabled, your utilities will be especially
868 primitive and will be unable to determine the current screen width.
870 comment "Common options for df, du, ls"
871 depends on DF || DU || LS
873 config FEATURE_HUMAN_READABLE
874 bool "Support for human readable output (example 13k, 23M, 235G)"
876 depends on DF || DU || LS
878 Allow df, du, and ls to have human readable output.
880 comment "Common options for md5sum, sha1sum, sha256sum, sha512sum"
881 depends on MD5SUM || SHA1SUM || SHA256SUM || SHA512SUM
883 config FEATURE_MD5_SHA1_SUM_CHECK
884 bool "Enable -c, -s and -w options"
886 depends on MD5SUM || SHA1SUM || SHA256SUM || SHA512SUM
888 Enabling the -c options allows files to be checked
889 against pre-calculated hash values.
891 -s and -w are useful options when verifying checksums.