619c2efe83fea4656121534e61f48d6b99373b23
[oweals/busybox.git] / coreutils / Config.src
1 #
2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
4 #
5
6 menu "Coreutils"
7
8 INSERT
9
10 config CAL
11         bool "cal"
12         default y
13         help
14           cal is used to display a monthly calendar.
15
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).
22
23 config CHGRP
24         bool "chgrp"
25         default y
26         help
27           chgrp is used to change the group ownership of files.
28
29 config CHMOD
30         bool "chmod"
31         default y
32         help
33           chmod is used to change the access permission of files.
34
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.
41
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
48
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'.
55
56 config CKSUM
57         bool "cksum"
58         default y
59         help
60           cksum is used to calculate the CRC32 checksum of a file.
61
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.
68
69 config CP
70         bool "cp"
71         default y
72         help
73           cp is used to copy files and directories.
74
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.
82
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.
89
90 config DF
91         bool "df"
92         default y
93         help
94           df reports the amount of disk space used and available
95           on filesystems.
96
97 config FEATURE_DF_FANCY
98         bool "Enable -a, -i, -B"
99         default y
100         depends on DF
101         help
102           This option enables -a, -i and -B.
103
104             -a Show all filesystems
105             -i Inodes
106             -B <SIZE> Blocksize
107
108 config DIRNAME
109         bool "dirname"
110         default y
111         help
112           dirname is used to strip a non-directory suffix from
113           a file name.
114
115 config DOS2UNIX
116         bool "dos2unix/unix2dos"
117         default y
118         help
119           dos2unix is used to convert a text file from DOS format to
120           UNIX format, and vice versa.
121
122 config UNIX2DOS
123         bool
124         default y
125         depends on DOS2UNIX
126         help
127           unix2dos is used to convert a text file from UNIX format to
128           DOS format, and vice versa.
129
130 config DU
131         bool "du (default blocksize of 512 bytes)"
132         default y
133         help
134           du is used to report the amount of disk space used
135           for specified files.
136
137 config FEATURE_DU_DEFAULT_BLOCKSIZE_1K
138         bool "Use a default blocksize of 1024 bytes (1K)"
139         default y
140         depends on DU
141         help
142           Use a blocksize of (1K) instead of the default 512b.
143
144 config ECHO
145         bool "echo (basic SuSv3 version taking no options)"
146         default y
147         help
148           echo is used to print a specified string to stdout.
149
150 # this entry also appears in shell/Config.in, next to the echo builtin
151 config FEATURE_FANCY_ECHO
152         bool "Enable echo options (-n and -e)"
153         default y
154         depends on ECHO || ASH_BUILTIN_ECHO || HUSH
155         help
156           This adds options (-n and -e) to echo.
157
158 config ENV
159         bool "env"
160         default y
161         help
162           env is used to set an environment variable and run
163           a command; without options it displays the current
164           environment.
165
166 config FEATURE_ENV_LONG_OPTIONS
167         bool "Enable long options"
168         default y
169         depends on ENV && LONG_OPTS
170         help
171           Support long options for the env applet.
172
173 config EXPAND
174         bool "expand"
175         default y
176         help
177           By default, convert all tabs to spaces.
178
179 config FEATURE_EXPAND_LONG_OPTIONS
180         bool "Enable long options"
181         default y
182         depends on EXPAND && LONG_OPTS
183         help
184           Support long options for the expand applet.
185
186 config EXPR
187         bool "expr"
188         default y
189         help
190           expr is used to calculate numbers and print the result
191           to standard output.
192
193 config EXPR_MATH_SUPPORT_64
194         bool "Extend Posix numbers support to 64 bit"
195         default y
196         depends on EXPR
197         help
198           Enable 64-bit math support in the expr applet. This will make
199           the applet slightly larger, but will allow computation with very
200           large numbers.
201
202 config FALSE
203         bool "false"
204         default y
205         help
206           false returns an exit code of FALSE (1).
207
208 config FOLD
209         bool "fold"
210         default y
211         help
212           Wrap text to fit a specific width.
213
214 config FSYNC
215         bool "fsync"
216         default y
217         help
218           fsync is used to flush file-related cached blocks to disk.
219
220 config HEAD
221         bool "head"
222         default y
223         help
224           head is used to print the first specified number of lines
225           from files.
226
227 config FEATURE_FANCY_HEAD
228         bool "Enable head options (-c, -q, and -v)"
229         default y
230         depends on HEAD
231         help
232           This enables the head options (-c, -q, and -v).
233
234 config INSTALL
235         bool "install"
236         default y
237         help
238           Copy files and set attributes.
239
240 config FEATURE_INSTALL_LONG_OPTIONS
241         bool "Enable long options"
242         default y
243         depends on INSTALL && LONG_OPTS
244         help
245           Support long options for the install applet.
246
247 ####config LENGTH
248 ####    bool "length"
249 ####    default y
250 ####    help
251 ####      length is used to print out the length of a specified string.
252
253 config LN
254         bool "ln"
255         default y
256         help
257           ln is used to create hard or soft links between files.
258
259 config LOGNAME
260         bool "logname"
261         default y
262         help
263           logname is used to print the current user's login name.
264
265 config LS
266         bool "ls"
267         default y
268         help
269           ls is used to list the contents of directories.
270
271 config FEATURE_LS_FILETYPES
272         bool "Enable filetyping options (-p and -F)"
273         default y
274         depends on LS
275         help
276           Enable the ls options (-p and -F).
277
278 config FEATURE_LS_FOLLOWLINKS
279         bool "Enable symlinks dereferencing (-L)"
280         default y
281         depends on LS
282         help
283           Enable the ls option (-L).
284
285 config FEATURE_LS_RECURSIVE
286         bool "Enable recursion (-R)"
287         default y
288         depends on LS
289         help
290           Enable the ls option (-R).
291
292 config FEATURE_LS_SORTFILES
293         bool "Sort the file names"
294         default y
295         depends on LS
296         help
297           Allow ls to sort file names alphabetically.
298
299 config FEATURE_LS_TIMESTAMPS
300         bool "Show file timestamps"
301         default y
302         depends on LS
303         help
304           Allow ls to display timestamps for files.
305
306 config FEATURE_LS_USERNAME
307         bool "Show username/groupnames"
308         default y
309         depends on LS
310         help
311           Allow ls to display username/groupname for files.
312
313 config FEATURE_LS_COLOR
314         bool "Allow use of color to identify file types"
315         default y
316         depends on LS && LONG_OPTS
317         help
318           This enables the --color option to ls.
319
320 config FEATURE_LS_COLOR_IS_DEFAULT
321         bool "Produce colored ls output by default"
322         default y
323         depends on FEATURE_LS_COLOR
324         help
325           Saying yes here will turn coloring on by default,
326           even if no "--color" option is given to the ls command.
327           This is not recommended, since the colors are not
328           configurable, and the output may not be legible on
329           many output screens.
330
331 config MD5SUM
332         bool "md5sum"
333         default y
334         help
335           md5sum is used to print or check MD5 checksums.
336
337 config MKDIR
338         bool "mkdir"
339         default y
340         help
341           mkdir is used to create directories with the specified names.
342
343 config FEATURE_MKDIR_LONG_OPTIONS
344         bool "Enable long options"
345         default y
346         depends on MKDIR && LONG_OPTS
347         help
348           Support long options for the mkdir applet.
349
350 config MKFIFO
351         bool "mkfifo"
352         default y
353         help
354           mkfifo is used to create FIFOs (named pipes).
355           The `mknod' program can also create FIFOs.
356
357 config MKNOD
358         bool "mknod"
359         default y
360         help
361           mknod is used to create FIFOs or block/character special
362           files with the specified names.
363
364 config MV
365         bool "mv"
366         default y
367         help
368           mv is used to move or rename files or directories.
369
370 config FEATURE_MV_LONG_OPTIONS
371         bool "Enable long options"
372         default y
373         depends on MV && LONG_OPTS
374         help
375           Support long options for the mv applet.
376
377 config NICE
378         bool "nice"
379         default y
380         help
381           nice runs a program with modified scheduling priority.
382
383 config NOHUP
384         bool "nohup"
385         default y
386         help
387           run a command immune to hangups, with output to a non-tty.
388
389 config OD
390         bool "od"
391         default y
392         help
393           od is used to dump binary files in octal and other formats.
394
395 config PRINTENV
396         bool "printenv"
397         default y
398         help
399           printenv is used to print all or part of environment.
400
401 config PRINTF
402         bool "printf"
403         default y
404         help
405           printf is used to format and print specified strings.
406           It's similar to `echo' except it has more options.
407
408 config PWD
409         bool "pwd"
410         default y
411         help
412           pwd is used to print the current directory.
413
414 config READLINK
415         bool "readlink"
416         default y
417         help
418           This program reads a symbolic link and returns the name
419           of the file it points to
420
421 config FEATURE_READLINK_FOLLOW
422         bool "Enable canonicalization by following all symlinks (-f)"
423         default y
424         depends on READLINK
425         help
426           Enable the readlink option (-f).
427
428 config REALPATH
429         bool "realpath"
430         default y
431         help
432           Return the canonicalized absolute pathname.
433           This isn't provided by GNU shellutils, but where else does it belong.
434
435 config RM
436         bool "rm"
437         default y
438         help
439           rm is used to remove files or directories.
440
441 config RMDIR
442         bool "rmdir"
443         default y
444         help
445           rmdir is used to remove empty directories.
446
447 config FEATURE_RMDIR_LONG_OPTIONS
448         bool "Enable long options"
449         default y
450         depends on RMDIR && LONG_OPTS
451         help
452           Support long options for the rmdir applet, including
453           --ignore-fail-on-non-empty for compatibility with GNU rmdir.
454
455 config SEQ
456         bool "seq"
457         default y
458         help
459           print a sequence of numbers
460
461 config SHA1SUM
462         bool "sha1sum"
463         default y
464         help
465           Compute and check SHA1 message digest
466
467 config SHA256SUM
468         bool "sha256sum"
469         default y
470         help
471           Compute and check SHA256 message digest
472
473 config SHA512SUM
474         bool "sha512sum"
475         default y
476         help
477           Compute and check SHA512 message digest
478
479 config SHA3SUM
480         bool "sha3sum"
481         default y
482         help
483           Compute and check SHA3 (512-bit) message digest
484
485 config SLEEP
486         bool "sleep"
487         default y
488         help
489           sleep is used to pause for a specified number of seconds.
490           It comes in 3 versions:
491           - small: takes one integer parameter
492           - fancy: takes multiple integer arguments with suffixes:
493             sleep 1d 2h 3m 15s
494           - fancy with fractional numbers:
495             sleep 2.3s 4.5h sleeps for 16202.3 seconds
496           Last one is "the most compatible" with coreutils sleep,
497           but it adds around 1k of code.
498
499 config FEATURE_FANCY_SLEEP
500         bool "Enable multiple arguments and s/m/h/d suffixes"
501         default y
502         depends on SLEEP
503         help
504           Allow sleep to pause for specified minutes, hours, and days.
505
506 config FEATURE_FLOAT_SLEEP
507         bool "Enable fractional arguments"
508         default y
509         depends on FEATURE_FANCY_SLEEP
510         help
511           Allow for fractional numeric parameters.
512
513 config SORT
514         bool "sort"
515         default y
516         help
517           sort is used to sort lines of text in specified files.
518
519 config FEATURE_SORT_BIG
520         bool "Full SuSv3 compliant sort (support -ktcsbdfiozgM)"
521         default y
522         depends on SORT
523         help
524           Without this, sort only supports -r, -u, and an integer version
525           of -n. Selecting this adds sort keys, floating point support, and
526           more. This adds a little over 3k to a nonstatic build on x86.
527
528           The SuSv3 sort standard is available at:
529           http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
530
531 config SPLIT
532         bool "split"
533         default y
534         help
535           split a file into pieces.
536
537 config FEATURE_SPLIT_FANCY
538         bool "Fancy extensions"
539         default y
540         depends on SPLIT
541         help
542           Add support for features not required by SUSv3.
543           Supports additional suffixes 'b' for 512 bytes,
544           'g' for 1GiB for the -b option.
545
546 config STTY
547         bool "stty"
548         default y
549         help
550           stty is used to change and print terminal line settings.
551
552 config SUM
553         bool "sum"
554         default y
555         help
556           checksum and count the blocks in a file
557
558 config TAC
559         bool "tac"
560         default y
561         help
562           tac is used to concatenate and print files in reverse.
563
564 config TAIL
565         bool "tail"
566         default y
567         help
568           tail is used to print the last specified number of lines
569           from files.
570
571 config FEATURE_FANCY_TAIL
572         bool "Enable extra tail options (-q, -s, -v, and -F)"
573         default y
574         depends on TAIL
575         help
576           The options (-q, -s, -v and -F) are provided by GNU tail, but
577           are not specific in the SUSv3 standard.
578
579             -q      Never output headers giving file names
580             -s SEC  Wait SEC seconds between reads with -f
581             -v      Always output headers giving file names
582             -F      Same as -f, but keep retrying
583
584 config TEE
585         bool "tee"
586         default y
587         help
588           tee is used to read from standard input and write
589           to standard output and files.
590
591 config FEATURE_TEE_USE_BLOCK_IO
592         bool "Enable block I/O (larger/faster) instead of byte I/O"
593         default y
594         depends on TEE
595         help
596           Enable this option for a faster tee, at expense of size.
597
598 config TRUE
599         bool "true"
600         default y
601         help
602           true returns an exit code of TRUE (0).
603
604 config TTY
605         bool "tty"
606         default y
607         help
608           tty is used to print the name of the current terminal to
609           standard output.
610
611 config UNAME
612         bool "uname"
613         default y
614         help
615           uname is used to print system information.
616
617 config UNAME_OSNAME
618         string "Operating system name"
619         default "GNU/Linux"
620         depends on UNAME
621         help
622           Sets the operating system name reported by uname -o.  The
623           default is "GNU/Linux".
624
625 config UNEXPAND
626         bool "unexpand"
627         default y
628         help
629           By default, convert only leading sequences of blanks to tabs.
630
631 config FEATURE_UNEXPAND_LONG_OPTIONS
632         bool "Enable long options"
633         default y
634         depends on UNEXPAND && LONG_OPTS
635         help
636           Support long options for the unexpand applet.
637
638 config UNIQ
639         bool "uniq"
640         default y
641         help
642           uniq is used to remove duplicate lines from a sorted file.
643
644 config USLEEP
645         bool "usleep"
646         default y
647         help
648           usleep is used to pause for a specified number of microseconds.
649
650 config UUDECODE
651         bool "uudecode"
652         default y
653         help
654           uudecode is used to decode a uuencoded file.
655
656 config UUENCODE
657         bool "uuencode"
658         default y
659         help
660           uuencode is used to uuencode a file.
661
662 config WC
663         bool "wc"
664         default y
665         help
666           wc is used to print the number of bytes, words, and lines,
667           in specified files.
668
669 config FEATURE_WC_LARGE
670         bool "Support very large files in wc"
671         default y
672         depends on WC
673         help
674           Use "unsigned long long" in wc for counter variables.
675
676 config WHOAMI
677         bool "whoami"
678         default y
679         help
680           whoami is used to print the username of the current
681           user id (same as id -un).
682
683 config YES
684         bool "yes"
685         default y
686         help
687           yes is used to repeatedly output a specific string, or
688           the default string `y'.
689
690 comment "Common options"
691
692 config FEATURE_VERBOSE
693         bool "Support verbose options (usually -v) for various applets"
694         default y
695         help
696           Enable cp -v, rm -v and similar messages.
697           Also enables long option (--verbose) if it exists.
698           Without this option, -v is accepted but ignored.
699
700 comment "Common options for cp and mv"
701         depends on CP || MV
702
703 config FEATURE_PRESERVE_HARDLINKS
704         bool "Preserve hard links"
705         default y
706         depends on CP || MV
707         help
708           Allow cp and mv to preserve hard links.
709
710 comment "Common options for ls, more and telnet"
711         depends on LS || MORE || TELNET
712
713 config FEATURE_AUTOWIDTH
714         bool "Calculate terminal & column widths"
715         default y
716         depends on LS || MORE || TELNET
717         help
718           This option allows utilities such as 'ls', 'more' and 'telnet'
719           to determine the width of the screen, which can allow them to
720           display additional text or avoid wrapping text onto the next line.
721           If you leave this disabled, your utilities will be especially
722           primitive and will be unable to determine the current screen width.
723
724 comment "Common options for df, du, ls"
725         depends on DF || DU || LS
726
727 config FEATURE_HUMAN_READABLE
728         bool "Support for human readable output (example 13k, 23M, 235G)"
729         default y
730         depends on DF || DU || LS
731         help
732           Allow df, du, and ls to have human readable output.
733
734 comment "Common options for md5sum, sha1sum, sha256sum, sha512sum, sha3sum"
735         depends on MD5SUM || SHA1SUM || SHA256SUM || SHA512SUM || SHA3SUM
736
737 config FEATURE_MD5_SHA1_SUM_CHECK
738         bool "Enable -c, -s and -w options"
739         default y
740         depends on MD5SUM || SHA1SUM || SHA256SUM || SHA512SUM || SHA3SUM
741         help
742           Enabling the -c options allows files to be checked
743           against pre-calculated hash values.
744
745           -s and -w are useful options when verifying checksums.
746
747 endmenu