busybox: update to 1.23.2
[tomato.git] / release / src / router / busybox / coreutils / Config.src
blob68c71788334b833a51b9dbb17636d577341b1efd
2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
6 menu "Coreutils"
8 INSERT
10 config CAL
11         bool "cal"
12         default y
13         help
14           cal is used to display a monthly calender.
16 config CATV
17         bool "catv"
18         default y
19         help
20           Display nonprinting characters as escape sequences (like some
21           implementations' cat -v option).
23 config CHGRP
24         bool "chgrp"
25         default y
26         help
27           chgrp is used to change the group ownership of files.
29 config CHMOD
30         bool "chmod"
31         default y
32         help
33           chmod is used to change the access permission of files.
35 config CHOWN
36         bool "chown"
37         default y
38         help
39           chown is used to change the user and/or group ownership
40           of files.
42 config FEATURE_CHOWN_LONG_OPTIONS
43         bool "Enable long options"
44         default y
45         depends on CHOWN && LONG_OPTS
46         help
47           Enable use of long options
49 config CHROOT
50         bool "chroot"
51         default y
52         help
53           chroot is used to change the root directory and run a command.
54           The default command is `/bin/sh'.
56 config CKSUM
57         bool "cksum"
58         default y
59         help
60           cksum is used to calculate the CRC32 checksum of a file.
62 config COMM
63         bool "comm"
64         default y
65         help
66           comm is used to compare two files line by line and return
67           a three-column output.
69 config CP
70         bool "cp"
71         default y
72         help
73           cp is used to copy files and directories.
75 config FEATURE_CP_LONG_OPTIONS
76         bool "Enable long options for cp"
77         default y
78         depends on CP && LONG_OPTS
79         help
80           Enable long options for cp.
81           Also add support for --parents option.
83 config CUT
84         bool "cut"
85         default y
86         help
87           cut is used to print selected parts of lines from
88           each file to stdout.
90 config DD
91         bool "dd"
92         default y
93         help
94           dd copies a file (from standard input to standard output,
95           by default) using specific input and output blocksizes,
96           while optionally performing conversions on it.
98 config FEATURE_DD_SIGNAL_HANDLING
99         bool "Enable DD signal handling for status reporting"
100         default y
101         depends on DD
102         help
103           Sending a SIGUSR1 signal to a running `dd' process makes it
104           print to standard error the number of records read and written
105           so far, then to resume copying.
107           $ dd if=/dev/zero of=/dev/null&
108           $ pid=$! kill -USR1 $pid; sleep 1; kill $pid
109           10899206+0 records in
110           10899206+0 records out
112 config FEATURE_DD_THIRD_STATUS_LINE
113         bool "Enable the third status line upon signal"
114         default y
115         depends on DD && FEATURE_DD_SIGNAL_HANDLING
116         help
117           Displays a coreutils-like third status line with transferred bytes,
118           elapsed time and speed.
120 config FEATURE_DD_IBS_OBS
121         bool "Enable ibs, obs and conv options"
122         default y
123         depends on DD
124         help
125           Enables support for writing a certain number of bytes in and out,
126           at a time, and performing conversions on the data stream.
128 config DF
129         bool "df"
130         default y
131         help
132           df reports the amount of disk space used and available
133           on filesystems.
135 config FEATURE_DF_FANCY
136         bool "Enable -a, -i, -B"
137         default y
138         depends on DF
139         help
140           This option enables -a, -i and -B.
142             -a Show all filesystems
143             -i Inodes
144             -B <SIZE> Blocksize
146 config DIRNAME
147         bool "dirname"
148         default y
149         help
150           dirname is used to strip a non-directory suffix from
151           a file name.
153 config DOS2UNIX
154         bool "dos2unix/unix2dos"
155         default y
156         help
157           dos2unix is used to convert a text file from DOS format to
158           UNIX format, and vice versa.
160 config UNIX2DOS
161         bool
162         default y
163         depends on DOS2UNIX
164         help
165           unix2dos is used to convert a text file from UNIX format to
166           DOS format, and vice versa.
168 config DU
169         bool "du (default blocksize of 512 bytes)"
170         default y
171         help
172           du is used to report the amount of disk space used
173           for specified files.
175 config FEATURE_DU_DEFAULT_BLOCKSIZE_1K
176         bool "Use a default blocksize of 1024 bytes (1K)"
177         default y
178         depends on DU
179         help
180           Use a blocksize of (1K) instead of the default 512b.
182 config ECHO
183         bool "echo (basic SuSv3 version taking no options)"
184         default y
185         help
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)"
191         default y
192         depends on ECHO || ASH_BUILTIN_ECHO || HUSH
193         help
194           This adds options (-n and -e) to echo.
196 config ENV
197         bool "env"
198         default y
199         help
200           env is used to set an environment variable and run
201           a command; without options it displays the current
202           environment.
204 config FEATURE_ENV_LONG_OPTIONS
205         bool "Enable long options"
206         default y
207         depends on ENV && LONG_OPTS
208         help
209           Support long options for the env applet.
211 config EXPAND
212         bool "expand"
213         default y
214         help
215           By default, convert all tabs to spaces.
217 config FEATURE_EXPAND_LONG_OPTIONS
218         bool "Enable long options"
219         default y
220         depends on EXPAND && LONG_OPTS
221         help
222           Support long options for the expand applet.
224 config EXPR
225         bool "expr"
226         default y
227         help
228           expr is used to calculate numbers and print the result
229           to standard output.
231 config EXPR_MATH_SUPPORT_64
232         bool "Extend Posix numbers support to 64 bit"
233         default y
234         depends on EXPR
235         help
236           Enable 64-bit math support in the expr applet. This will make
237           the applet slightly larger, but will allow computation with very
238           large numbers.
240 config FALSE
241         bool "false"
242         default y
243         help
244           false returns an exit code of FALSE (1).
246 config FOLD
247         bool "fold"
248         default y
249         help
250           Wrap text to fit a specific width.
252 config FSYNC
253         bool "fsync"
254         default y
255         help
256           fsync is used to flush file-related cached blocks to disk.
258 config HEAD
259         bool "head"
260         default y
261         help
262           head is used to print the first specified number of lines
263           from files.
265 config FEATURE_FANCY_HEAD
266         bool "Enable head options (-c, -q, and -v)"
267         default y
268         depends on HEAD
269         help
270           This enables the head options (-c, -q, and -v).
272 config INSTALL
273         bool "install"
274         default y
275         help
276           Copy files and set attributes.
278 config FEATURE_INSTALL_LONG_OPTIONS
279         bool "Enable long options"
280         default y
281         depends on INSTALL && LONG_OPTS
282         help
283           Support long options for the install applet.
285 ####config LENGTH
286 ####    bool "length"
287 ####    default y
288 ####    help
289 ####      length is used to print out the length of a specified string.
291 config LN
292         bool "ln"
293         default y
294         help
295           ln is used to create hard or soft links between files.
297 config LOGNAME
298         bool "logname"
299         default y
300         help
301           logname is used to print the current user's login name.
303 config LS
304         bool "ls"
305         default y
306         help
307           ls is used to list the contents of directories.
309 config FEATURE_LS_FILETYPES
310         bool "Enable filetyping options (-p and -F)"
311         default y
312         depends on LS
313         help
314           Enable the ls options (-p and -F).
316 config FEATURE_LS_FOLLOWLINKS
317         bool "Enable symlinks dereferencing (-L)"
318         default y
319         depends on LS
320         help
321           Enable the ls option (-L).
323 config FEATURE_LS_RECURSIVE
324         bool "Enable recursion (-R)"
325         default y
326         depends on LS
327         help
328           Enable the ls option (-R).
330 config FEATURE_LS_SORTFILES
331         bool "Sort the file names"
332         default y
333         depends on LS
334         help
335           Allow ls to sort file names alphabetically.
337 config FEATURE_LS_TIMESTAMPS
338         bool "Show file timestamps"
339         default y
340         depends on LS
341         help
342           Allow ls to display timestamps for files.
344 config FEATURE_LS_USERNAME
345         bool "Show username/groupnames"
346         default y
347         depends on LS
348         help
349           Allow ls to display username/groupname for files.
351 config FEATURE_LS_COLOR
352         bool "Allow use of color to identify file types"
353         default y
354         depends on LS && LONG_OPTS
355         help
356           This enables the --color option to ls.
358 config FEATURE_LS_COLOR_IS_DEFAULT
359         bool "Produce colored ls output by default"
360         default y
361         depends on FEATURE_LS_COLOR
362         help
363           Saying yes here will turn coloring on by default,
364           even if no "--color" option is given to the ls command.
365           This is not recommended, since the colors are not
366           configurable, and the output may not be legible on
367           many output screens.
369 config MD5SUM
370         bool "md5sum"
371         default y
372         help
373           md5sum is used to print or check MD5 checksums.
375 config MKDIR
376         bool "mkdir"
377         default y
378         help
379           mkdir is used to create directories with the specified names.
381 config FEATURE_MKDIR_LONG_OPTIONS
382         bool "Enable long options"
383         default y
384         depends on MKDIR && LONG_OPTS
385         help
386           Support long options for the mkdir applet.
388 config MKFIFO
389         bool "mkfifo"
390         default y
391         help
392           mkfifo is used to create FIFOs (named pipes).
393           The `mknod' program can also create FIFOs.
395 config MKNOD
396         bool "mknod"
397         default y
398         help
399           mknod is used to create FIFOs or block/character special
400           files with the specified names.
402 config MV
403         bool "mv"
404         default y
405         help
406           mv is used to move or rename files or directories.
408 config FEATURE_MV_LONG_OPTIONS
409         bool "Enable long options"
410         default y
411         depends on MV && LONG_OPTS
412         help
413           Support long options for the mv applet.
415 config NICE
416         bool "nice"
417         default y
418         help
419           nice runs a program with modified scheduling priority.
421 config NOHUP
422         bool "nohup"
423         default y
424         help
425           run a command immune to hangups, with output to a non-tty.
427 config OD
428         bool "od"
429         default y
430         help
431           od is used to dump binary files in octal and other formats.
433 config PRINTENV
434         bool "printenv"
435         default y
436         help
437           printenv is used to print all or part of environment.
439 config PRINTF
440         bool "printf"
441         default y
442         help
443           printf is used to format and print specified strings.
444           It's similar to `echo' except it has more options.
446 config PWD
447         bool "pwd"
448         default y
449         help
450           pwd is used to print the current directory.
452 config READLINK
453         bool "readlink"
454         default y
455         help
456           This program reads a symbolic link and returns the name
457           of the file it points to
459 config FEATURE_READLINK_FOLLOW
460         bool "Enable canonicalization by following all symlinks (-f)"
461         default y
462         depends on READLINK
463         help
464           Enable the readlink option (-f).
466 config REALPATH
467         bool "realpath"
468         default y
469         help
470           Return the canonicalized absolute pathname.
471           This isn't provided by GNU shellutils, but where else does it belong.
473 config RM
474         bool "rm"
475         default y
476         help
477           rm is used to remove files or directories.
479 config RMDIR
480         bool "rmdir"
481         default y
482         help
483           rmdir is used to remove empty directories.
485 config FEATURE_RMDIR_LONG_OPTIONS
486         bool "Enable long options"
487         default y
488         depends on RMDIR && LONG_OPTS
489         help
490           Support long options for the rmdir applet, including
491           --ignore-fail-on-non-empty for compatibility with GNU rmdir.
493 config SEQ
494         bool "seq"
495         default y
496         help
497           print a sequence of numbers
499 config SHA1SUM
500         bool "sha1sum"
501         default y
502         help
503           Compute and check SHA1 message digest
505 config SHA256SUM
506         bool "sha256sum"
507         default y
508         help
509           Compute and check SHA256 message digest
511 config SHA512SUM
512         bool "sha512sum"
513         default y
514         help
515           Compute and check SHA512 message digest
517 config SHA3SUM
518         bool "sha3sum"
519         default y
520         help
521           Compute and check SHA3 (512-bit) message digest
523 config SLEEP
524         bool "sleep"
525         default y
526         help
527           sleep is used to pause for a specified number of seconds.
528           It comes in 3 versions:
529           - small: takes one integer parameter
530           - fancy: takes multiple integer arguments with suffixes:
531             sleep 1d 2h 3m 15s
532           - fancy with fractional numbers:
533             sleep 2.3s 4.5h sleeps for 16202.3 seconds
534           Last one is "the most compatible" with coreutils sleep,
535           but it adds around 1k of code.
537 config FEATURE_FANCY_SLEEP
538         bool "Enable multiple arguments and s/m/h/d suffixes"
539         default y
540         depends on SLEEP
541         help
542           Allow sleep to pause for specified minutes, hours, and days.
544 config FEATURE_FLOAT_SLEEP
545         bool "Enable fractional arguments"
546         default y
547         depends on FEATURE_FANCY_SLEEP
548         help
549           Allow for fractional numeric parameters.
551 config SORT
552         bool "sort"
553         default y
554         help
555           sort is used to sort lines of text in specified files.
557 config FEATURE_SORT_BIG
558         bool "Full SuSv3 compliant sort (support -ktcsbdfiozgM)"
559         default y
560         depends on SORT
561         help
562           Without this, sort only supports -r, -u, and an integer version
563           of -n. Selecting this adds sort keys, floating point support, and
564           more. This adds a little over 3k to a nonstatic build on x86.
566           The SuSv3 sort standard is available at:
567           http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
569 config SPLIT
570         bool "split"
571         default y
572         help
573           split a file into pieces.
575 config FEATURE_SPLIT_FANCY
576         bool "Fancy extensions"
577         default y
578         depends on SPLIT
579         help
580           Add support for features not required by SUSv3.
581           Supports additional suffixes 'b' for 512 bytes,
582           'g' for 1GiB for the -b option.
584 config STAT
585         bool "stat"
586         default y
587         select PLATFORM_LINUX # statfs()
588         help
589           display file or filesystem status.
591 config FEATURE_STAT_FORMAT
592         bool "Enable custom formats (-c)"
593         default y
594         depends on STAT
595         help
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.
600 config STTY
601         bool "stty"
602         default y
603         help
604           stty is used to change and print terminal line settings.
606 config SUM
607         bool "sum"
608         default y
609         help
610           checksum and count the blocks in a file
612 config SYNC
613         bool "sync"
614         default y
615         help
616           sync is used to flush filesystem buffers.
618 config TAC
619         bool "tac"
620         default y
621         help
622           tac is used to concatenate and print files in reverse.
624 config TAIL
625         bool "tail"
626         default y
627         help
628           tail is used to print the last specified number of lines
629           from files.
631 config FEATURE_FANCY_TAIL
632         bool "Enable extra tail options (-q, -s, -v, and -F)"
633         default y
634         depends on TAIL
635         help
636           The options (-q, -s, -v and -F) are provided by GNU tail, but
637           are not specific in the SUSv3 standard.
639             -q      Never output headers giving file names
640             -s SEC  Wait SEC seconds between reads with -f
641             -v      Always output headers giving file names
642             -F      Same as -f, but keep retrying
644 config TEE
645         bool "tee"
646         default y
647         help
648           tee is used to read from standard input and write
649           to standard output and files.
651 config FEATURE_TEE_USE_BLOCK_IO
652         bool "Enable block I/O (larger/faster) instead of byte I/O"
653         default y
654         depends on TEE
655         help
656           Enable this option for a faster tee, at expense of size.
658 config TRUE
659         bool "true"
660         default y
661         help
662           true returns an exit code of TRUE (0).
664 config TTY
665         bool "tty"
666         default y
667         help
668           tty is used to print the name of the current terminal to
669           standard output.
671 config UNAME
672         bool "uname"
673         default y
674         help
675           uname is used to print system information.
677 config UNEXPAND
678         bool "unexpand"
679         default y
680         help
681           By default, convert only leading sequences of blanks to tabs.
683 config FEATURE_UNEXPAND_LONG_OPTIONS
684         bool "Enable long options"
685         default y
686         depends on UNEXPAND && LONG_OPTS
687         help
688           Support long options for the unexpand applet.
690 config UNIQ
691         bool "uniq"
692         default y
693         help
694           uniq is used to remove duplicate lines from a sorted file.
696 config USLEEP
697         bool "usleep"
698         default y
699         help
700           usleep is used to pause for a specified number of microseconds.
702 config UUDECODE
703         bool "uudecode"
704         default y
705         help
706           uudecode is used to decode a uuencoded file.
708 config UUENCODE
709         bool "uuencode"
710         default y
711         help
712           uuencode is used to uuencode a file.
714 config WC
715         bool "wc"
716         default y
717         help
718           wc is used to print the number of bytes, words, and lines,
719           in specified files.
721 config FEATURE_WC_LARGE
722         bool "Support very large files in wc"
723         default y
724         depends on WC
725         help
726           Use "unsigned long long" in wc for counter variables.
728 config WHOAMI
729         bool "whoami"
730         default y
731         help
732           whoami is used to print the username of the current
733           user id (same as id -un).
735 config YES
736         bool "yes"
737         default y
738         help
739           yes is used to repeatedly output a specific string, or
740           the default string `y'.
742 comment "Common options"
744 config FEATURE_VERBOSE
745         bool "Support verbose options (usually -v) for various applets"
746         default y
747         help
748           Enable cp -v, rm -v and similar messages.
749           Also enables long option (--verbose) if it exists.
750           Without this option, -v is accepted but ignored.
752 comment "Common options for cp and mv"
753         depends on CP || MV
755 config FEATURE_PRESERVE_HARDLINKS
756         bool "Preserve hard links"
757         default y
758         depends on CP || MV
759         help
760           Allow cp and mv to preserve hard links.
762 comment "Common options for ls, more and telnet"
763         depends on LS || MORE || TELNET
765 config FEATURE_AUTOWIDTH
766         bool "Calculate terminal & column widths"
767         default y
768         depends on LS || MORE || TELNET
769         help
770           This option allows utilities such as 'ls', 'more' and 'telnet'
771           to determine the width of the screen, which can allow them to
772           display additional text or avoid wrapping text onto the next line.
773           If you leave this disabled, your utilities will be especially
774           primitive and will be unable to determine the current screen width.
776 comment "Common options for df, du, ls"
777         depends on DF || DU || LS
779 config FEATURE_HUMAN_READABLE
780         bool "Support for human readable output (example 13k, 23M, 235G)"
781         default y
782         depends on DF || DU || LS
783         help
784           Allow df, du, and ls to have human readable output.
786 comment "Common options for md5sum, sha1sum, sha256sum, sha512sum, sha3sum"
787         depends on MD5SUM || SHA1SUM || SHA256SUM || SHA512SUM || SHA3SUM
789 config FEATURE_MD5_SHA1_SUM_CHECK
790         bool "Enable -c, -s and -w options"
791         default y
792         depends on MD5SUM || SHA1SUM || SHA256SUM || SHA512SUM || SHA3SUM
793         help
794           Enabling the -c options allows files to be checked
795           against pre-calculated hash values.
797           -s and -w are useful options when verifying checksums.
799 endmenu