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)"
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 sleep is used to pause for a specified number of seconds.
517 It comes in 3 versions:
518 - small: takes one integer parameter
519 - fancy: takes multiple integer arguments with suffixes:
521 - fancy with fractional numbers:
522 sleep 2.3s 4.5h sleeps for 16202.3 seconds
523 Last one is "the most compatible" with coreutils sleep,
524 but it adds around 1k of code.
526 config FEATURE_FANCY_SLEEP
527 bool "Enable multiple arguments and s/m/h/d suffixes"
531 Allow sleep to pause for specified minutes, hours, and days.
533 config FEATURE_FLOAT_SLEEP
534 bool "Enable fractional arguments"
536 depends on FEATURE_FANCY_SLEEP
538 Allow for fractional numeric parameters.
544 sort is used to sort lines of text in specified files.
546 config FEATURE_SORT_BIG
547 bool "Full SuSv3 compliant sort (support -ktcsbdfiozgM)"
551 Without this, sort only supports -r, -u, and an integer version
552 of -n. Selecting this adds sort keys, floating point support, and
553 more. This adds a little over 3k to a nonstatic build on x86.
555 The SuSv3 sort standard is available at:
556 http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
562 split a file into pieces.
564 config FEATURE_SPLIT_FANCY
565 bool "Fancy extensions"
569 Add support for features not required by SUSv3.
570 Supports additional suffixes 'b' for 512 bytes,
571 'g' for 1GiB for the -b option.
577 display file or filesystem status.
579 config FEATURE_STAT_FORMAT
580 bool "Enable custom formats (-c)"
584 Without this, stat will not support the '-c format' option where
585 users can pass a custom format string for output. This adds about
586 7k to a nonstatic build on amd64.
592 stty is used to change and print terminal line settings.
598 checksum and count the blocks in a file
604 sync is used to flush filesystem buffers.
610 tac is used to concatenate and print files in reverse.
616 tail is used to print the last specified number of lines
619 config FEATURE_FANCY_TAIL
620 bool "Enable extra tail options (-q, -s, and -v)"
624 The options (-q, -s, and -v) are provided by GNU tail, but
625 are not specific in the SUSv3 standard.
631 tee is used to read from standard input and write
632 to standard output and files.
634 config FEATURE_TEE_USE_BLOCK_IO
635 bool "Enable block I/O (larger/faster) instead of byte I/O"
639 Enable this option for a faster tee, at expense of size.
645 test is used to check file types and compare values,
646 returning an appropriate exit code. The bash shell
647 has test built in, ash can build it in optionally.
649 config FEATURE_TEST_64
650 bool "Extend test to 64 bit"
654 Enable 64-bit support in test.
660 touch is used to create or change the access and/or
661 modification timestamp of specified files.
667 tr is used to squeeze, and/or delete characters from standard
668 input, writing to standard output.
670 config FEATURE_TR_CLASSES
671 bool "Enable character classes (such as [:upper:])"
675 Enable character classes, enabling commands such as:
676 tr [:upper:] [:lower:] to convert input into lowercase.
678 config FEATURE_TR_EQUIV
679 bool "Enable equivalence classes"
683 Enable equivalence classes, which essentially add the enclosed
684 character to the current set. For instance, tr [=a=] xyz would
685 replace all instances of 'a' with 'xyz'. This option is mainly
686 useful for cases when no other way of expressing a character
693 true returns an exit code of TRUE (0).
699 tty is used to print the name of the current terminal to
706 uname is used to print system information.
712 By default, convert only leading sequences of blanks to tabs.
714 config FEATURE_UNEXPAND_LONG_OPTIONS
715 bool "Enable long options"
717 depends on UNEXPAND && GETOPT_LONG
719 Support long options for the unexpand applet.
725 uniq is used to remove duplicate lines from a sorted file.
731 usleep is used to pause for a specified number of microseconds.
737 uudecode is used to decode a uuencoded file.
743 uuencode is used to uuencode a file.
749 wc is used to print the number of bytes, words, and lines,
752 config FEATURE_WC_LARGE
753 bool "Support very large files in wc"
757 Use "unsigned long long" in wc for count variables.
764 who is used to show who is logged on.
770 whoami is used to print the username of the current
771 user id (same as id -un).
777 yes is used to repeatedly output a specific string, or
778 the default string `y'.
780 comment "Common options for cp and mv"
783 config FEATURE_PRESERVE_HARDLINKS
784 bool "Preserve hard links"
788 Allow cp and mv to preserve hard links.
790 comment "Common options for ls, more and telnet"
791 depends on LS || MORE || TELNET
793 config FEATURE_AUTOWIDTH
794 bool "Calculate terminal & column widths"
796 depends on LS || MORE || TELNET
798 This option allows utilities such as 'ls', 'more' and 'telnet'
799 to determine the width of the screen, which can allow them to
800 display additional text or avoid wrapping text onto the next line.
801 If you leave this disabled, your utilities will be especially
802 primitive and will be unable to determine the current screen width.
804 comment "Common options for df, du, ls"
805 depends on DF || DU || LS
807 config FEATURE_HUMAN_READABLE
808 bool "Support for human readable output (example 13k, 23M, 235G)"
810 depends on DF || DU || LS
812 Allow df, du, and ls to have human readable output.
814 comment "Common options for md5sum, sha1sum"
815 depends on MD5SUM || SHA1SUM
817 config FEATURE_MD5_SHA1_SUM_CHECK
818 bool "Enable -c, -s and -w options"
820 depends on MD5SUM || SHA1SUM
822 Enabling the -c options allows files to be checked
823 against pre-calculated hash values.
825 -s and -w are useful options when verifying checksums.