Busybox 1.20.2 update
[tomato.git] / release / src / router / busybox / coreutils / Config.src
bloba28449b11d39aa8a3d646546c7cc3eecacaad4fd
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 SLEEP
518         bool "sleep"
519         default y
520         help
521           sleep is used to pause for a specified number of seconds.
522           It comes in 3 versions:
523           - small: takes one integer parameter
524           - fancy: takes multiple integer arguments with suffixes:
525             sleep 1d 2h 3m 15s
526           - fancy with fractional numbers:
527             sleep 2.3s 4.5h sleeps for 16202.3 seconds
528           Last one is "the most compatible" with coreutils sleep,
529           but it adds around 1k of code.
531 config FEATURE_FANCY_SLEEP
532         bool "Enable multiple arguments and s/m/h/d suffixes"
533         default y
534         depends on SLEEP
535         help
536           Allow sleep to pause for specified minutes, hours, and days.
538 config FEATURE_FLOAT_SLEEP
539         bool "Enable fractional arguments"
540         default y
541         depends on FEATURE_FANCY_SLEEP
542         help
543           Allow for fractional numeric parameters.
545 config SORT
546         bool "sort"
547         default y
548         help
549           sort is used to sort lines of text in specified files.
551 config FEATURE_SORT_BIG
552         bool "Full SuSv3 compliant sort (support -ktcsbdfiozgM)"
553         default y
554         depends on SORT
555         help
556           Without this, sort only supports -r, -u, and an integer version
557           of -n. Selecting this adds sort keys, floating point support, and
558           more. This adds a little over 3k to a nonstatic build on x86.
560           The SuSv3 sort standard is available at:
561           http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
563 config SPLIT
564         bool "split"
565         default y
566         help
567           split a file into pieces.
569 config FEATURE_SPLIT_FANCY
570         bool "Fancy extensions"
571         default y
572         depends on SPLIT
573         help
574           Add support for features not required by SUSv3.
575           Supports additional suffixes 'b' for 512 bytes,
576           'g' for 1GiB for the -b option.
578 config STAT
579         bool "stat"
580         default y
581         select PLATFORM_LINUX # statfs()
582         help
583           display file or filesystem status.
585 config FEATURE_STAT_FORMAT
586         bool "Enable custom formats (-c)"
587         default y
588         depends on STAT
589         help
590           Without this, stat will not support the '-c format' option where
591           users can pass a custom format string for output. This adds about
592           7k to a nonstatic build on amd64.
594 config STTY
595         bool "stty"
596         default y
597         help
598           stty is used to change and print terminal line settings.
600 config SUM
601         bool "sum"
602         default y
603         help
604           checksum and count the blocks in a file
606 config SYNC
607         bool "sync"
608         default y
609         help
610           sync is used to flush filesystem buffers.
612 config TAC
613         bool "tac"
614         default y
615         help
616           tac is used to concatenate and print files in reverse.
618 config TAIL
619         bool "tail"
620         default y
621         help
622           tail is used to print the last specified number of lines
623           from files.
625 config FEATURE_FANCY_TAIL
626         bool "Enable extra tail options (-q, -s, -v, and -F)"
627         default y
628         depends on TAIL
629         help
630           The options (-q, -s, and -v) are provided by GNU tail, but
631           are not specific in the SUSv3 standard.
633             -q      Never output headers giving file names
634             -s SEC  Wait SEC seconds between reads with -f
635             -v      Always output headers giving file names
637 config TEE
638         bool "tee"
639         default y
640         help
641           tee is used to read from standard input and write
642           to standard output and files.
644 config FEATURE_TEE_USE_BLOCK_IO
645         bool "Enable block I/O (larger/faster) instead of byte I/O"
646         default y
647         depends on TEE
648         help
649           Enable this option for a faster tee, at expense of size.
651 config TRUE
652         bool "true"
653         default y
654         help
655           true returns an exit code of TRUE (0).
657 config TTY
658         bool "tty"
659         default y
660         help
661           tty is used to print the name of the current terminal to
662           standard output.
664 config UNAME
665         bool "uname"
666         default y
667         help
668           uname is used to print system information.
670 config UNEXPAND
671         bool "unexpand"
672         default y
673         help
674           By default, convert only leading sequences of blanks to tabs.
676 config FEATURE_UNEXPAND_LONG_OPTIONS
677         bool "Enable long options"
678         default y
679         depends on UNEXPAND && LONG_OPTS
680         help
681           Support long options for the unexpand applet.
683 config UNIQ
684         bool "uniq"
685         default y
686         help
687           uniq is used to remove duplicate lines from a sorted file.
689 config USLEEP
690         bool "usleep"
691         default y
692         help
693           usleep is used to pause for a specified number of microseconds.
695 config UUDECODE
696         bool "uudecode"
697         default y
698         help
699           uudecode is used to decode a uuencoded file.
701 config UUENCODE
702         bool "uuencode"
703         default y
704         help
705           uuencode is used to uuencode a file.
707 config WC
708         bool "wc"
709         default y
710         help
711           wc is used to print the number of bytes, words, and lines,
712           in specified files.
714 config FEATURE_WC_LARGE
715         bool "Support very large files in wc"
716         default y
717         depends on WC
718         help
719           Use "unsigned long long" in wc for counter variables.
721 config WHOAMI
722         bool "whoami"
723         default y
724         help
725           whoami is used to print the username of the current
726           user id (same as id -un).
728 config YES
729         bool "yes"
730         default y
731         help
732           yes is used to repeatedly output a specific string, or
733           the default string `y'.
735 comment "Common options for cp and mv"
736         depends on CP || MV
738 config FEATURE_PRESERVE_HARDLINKS
739         bool "Preserve hard links"
740         default y
741         depends on CP || MV
742         help
743           Allow cp and mv to preserve hard links.
745 comment "Common options for ls, more and telnet"
746         depends on LS || MORE || TELNET
748 config FEATURE_AUTOWIDTH
749         bool "Calculate terminal & column widths"
750         default y
751         depends on LS || MORE || TELNET
752         help
753           This option allows utilities such as 'ls', 'more' and 'telnet'
754           to determine the width of the screen, which can allow them to
755           display additional text or avoid wrapping text onto the next line.
756           If you leave this disabled, your utilities will be especially
757           primitive and will be unable to determine the current screen width.
759 comment "Common options for df, du, ls"
760         depends on DF || DU || LS
762 config FEATURE_HUMAN_READABLE
763         bool "Support for human readable output (example 13k, 23M, 235G)"
764         default y
765         depends on DF || DU || LS
766         help
767           Allow df, du, and ls to have human readable output.
769 comment "Common options for md5sum, sha1sum, sha256sum, sha512sum"
770         depends on MD5SUM || SHA1SUM || SHA256SUM || SHA512SUM
772 config FEATURE_MD5_SHA1_SUM_CHECK
773         bool "Enable -c, -s and -w options"
774         default y
775         depends on MD5SUM || SHA1SUM || SHA256SUM || SHA512SUM
776         help
777           Enabling the -c options allows files to be checked
778           against pre-calculated hash values.
780           -s and -w are useful options when verifying checksums.
782 endmenu