mark Linux-specific configuration options
[platform/upstream/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 calender.
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 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.
97
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.
106
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
111
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.
119
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.
127
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.
134
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.
141
142             -a Show all filesystems
143             -i Inodes
144             -B <SIZE> Blocksize
145
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.
152
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.
159
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.
167
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.
174
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.
181
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.
187
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.
195
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.
203
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.
210
211 config EXPAND
212         bool "expand"
213         default y
214         help
215           By default, convert all tabs to spaces.
216
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.
223
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.
230
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.
239
240 config FALSE
241         bool "false"
242         default y
243         help
244           false returns an exit code of FALSE (1).
245
246 config FOLD
247         bool "fold"
248         default y
249         help
250           Wrap text to fit a specific width.
251
252 config FSYNC
253         bool "fsync"
254         default y
255         help
256           fsync is used to flush file-related cached blocks to disk.
257
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.
264
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).
271
272 config HOSTID
273         bool "hostid"
274         default y
275         help
276           hostid prints the numeric identifier (in hexadecimal) for
277           the current host.
278
279 config ID
280         bool "id"
281         default y
282         help
283           id displays the current user and group ID names.
284
285 config INSTALL
286         bool "install"
287         default y
288         help
289           Copy files and set attributes.
290
291 config FEATURE_INSTALL_LONG_OPTIONS
292         bool "Enable long options"
293         default y
294         depends on INSTALL && LONG_OPTS
295         help
296           Support long options for the install applet.
297
298 config LENGTH
299         bool "length"
300         default y
301         help
302           length is used to print out the length of a specified string.
303
304 config LN
305         bool "ln"
306         default y
307         help
308           ln is used to create hard or soft links between files.
309
310 config LOGNAME
311         bool "logname"
312         default y
313         help
314           logname is used to print the current user's login name.
315
316 config LS
317         bool "ls"
318         default y
319         help
320           ls is used to list the contents of directories.
321
322 config FEATURE_LS_FILETYPES
323         bool "Enable filetyping options (-p and -F)"
324         default y
325         depends on LS
326         help
327           Enable the ls options (-p and -F).
328
329 config FEATURE_LS_FOLLOWLINKS
330         bool "Enable symlinks dereferencing (-L)"
331         default y
332         depends on LS
333         help
334           Enable the ls option (-L).
335
336 config FEATURE_LS_RECURSIVE
337         bool "Enable recursion (-R)"
338         default y
339         depends on LS
340         help
341           Enable the ls option (-R).
342
343 config FEATURE_LS_SORTFILES
344         bool "Sort the file names"
345         default y
346         depends on LS
347         help
348           Allow ls to sort file names alphabetically.
349
350 config FEATURE_LS_TIMESTAMPS
351         bool "Show file timestamps"
352         default y
353         depends on LS
354         help
355           Allow ls to display timestamps for files.
356
357 config FEATURE_LS_USERNAME
358         bool "Show username/groupnames"
359         default y
360         depends on LS
361         help
362           Allow ls to display username/groupname for files.
363
364 config FEATURE_LS_COLOR
365         bool "Allow use of color to identify file types"
366         default y
367         depends on LS && LONG_OPTS
368         help
369           This enables the --color option to ls.
370
371 config FEATURE_LS_COLOR_IS_DEFAULT
372         bool "Produce colored ls output by default"
373         default y
374         depends on FEATURE_LS_COLOR
375         help
376           Saying yes here will turn coloring on by default,
377           even if no "--color" option is given to the ls command.
378           This is not recommended, since the colors are not
379           configurable, and the output may not be legible on
380           many output screens.
381
382 config MD5SUM
383         bool "md5sum"
384         default y
385         help
386           md5sum is used to print or check MD5 checksums.
387
388 config MKDIR
389         bool "mkdir"
390         default y
391         help
392           mkdir is used to create directories with the specified names.
393
394 config FEATURE_MKDIR_LONG_OPTIONS
395         bool "Enable long options"
396         default y
397         depends on MKDIR && LONG_OPTS
398         help
399           Support long options for the mkdir applet.
400
401 config MKFIFO
402         bool "mkfifo"
403         default y
404         help
405           mkfifo is used to create FIFOs (named pipes).
406           The `mknod' program can also create FIFOs.
407
408 config MKNOD
409         bool "mknod"
410         default y
411         help
412           mknod is used to create FIFOs or block/character special
413           files with the specified names.
414
415 config MV
416         bool "mv"
417         default y
418         help
419           mv is used to move or rename files or directories.
420
421 config FEATURE_MV_LONG_OPTIONS
422         bool "Enable long options"
423         default y
424         depends on MV && LONG_OPTS
425         help
426           Support long options for the mv applet.
427
428 config NICE
429         bool "nice"
430         default y
431         help
432           nice runs a program with modified scheduling priority.
433
434 config NOHUP
435         bool "nohup"
436         default y
437         help
438           run a command immune to hangups, with output to a non-tty.
439
440 config OD
441         bool "od"
442         default y
443         help
444           od is used to dump binary files in octal and other formats.
445
446 config PRINTENV
447         bool "printenv"
448         default y
449         help
450           printenv is used to print all or part of environment.
451
452 config PRINTF
453         bool "printf"
454         default y
455         help
456           printf is used to format and print specified strings.
457           It's similar to `echo' except it has more options.
458
459 config PWD
460         bool "pwd"
461         default y
462         help
463           pwd is used to print the current directory.
464
465 config READLINK
466         bool "readlink"
467         default y
468         help
469           This program reads a symbolic link and returns the name
470           of the file it points to
471
472 config FEATURE_READLINK_FOLLOW
473         bool "Enable canonicalization by following all symlinks (-f)"
474         default y
475         depends on READLINK
476         help
477           Enable the readlink option (-f).
478
479 config REALPATH
480         bool "realpath"
481         default y
482         help
483           Return the canonicalized absolute pathname.
484           This isn't provided by GNU shellutils, but where else does it belong.
485
486 config RM
487         bool "rm"
488         default y
489         help
490           rm is used to remove files or directories.
491
492 config RMDIR
493         bool "rmdir"
494         default y
495         help
496           rmdir is used to remove empty directories.
497
498 config FEATURE_RMDIR_LONG_OPTIONS
499         bool "Enable long options"
500         default y
501         depends on RMDIR && LONG_OPTS
502         help
503           Support long options for the rmdir applet, including
504           --ignore-fail-on-non-empty for compatibility with GNU rmdir.
505
506 config SEQ
507         bool "seq"
508         default y
509         help
510           print a sequence of numbers
511
512 config SHA1SUM
513         bool "sha1sum"
514         default y
515         help
516           Compute and check SHA1 message digest
517
518 config SHA256SUM
519         bool "sha256sum"
520         default y
521         help
522           Compute and check SHA256 message digest
523
524 config SHA512SUM
525         bool "sha512sum"
526         default y
527         help
528           Compute and check SHA512 message digest
529
530 config SLEEP
531         bool "sleep"
532         default y
533         help
534           sleep is used to pause for a specified number of seconds.
535           It comes in 3 versions:
536           - small: takes one integer parameter
537           - fancy: takes multiple integer arguments with suffixes:
538             sleep 1d 2h 3m 15s
539           - fancy with fractional numbers:
540             sleep 2.3s 4.5h sleeps for 16202.3 seconds
541           Last one is "the most compatible" with coreutils sleep,
542           but it adds around 1k of code.
543
544 config FEATURE_FANCY_SLEEP
545         bool "Enable multiple arguments and s/m/h/d suffixes"
546         default y
547         depends on SLEEP
548         help
549           Allow sleep to pause for specified minutes, hours, and days.
550
551 config FEATURE_FLOAT_SLEEP
552         bool "Enable fractional arguments"
553         default y
554         depends on FEATURE_FANCY_SLEEP
555         help
556           Allow for fractional numeric parameters.
557
558 config SORT
559         bool "sort"
560         default y
561         help
562           sort is used to sort lines of text in specified files.
563
564 config FEATURE_SORT_BIG
565         bool "Full SuSv3 compliant sort (support -ktcsbdfiozgM)"
566         default y
567         depends on SORT
568         help
569           Without this, sort only supports -r, -u, and an integer version
570           of -n. Selecting this adds sort keys, floating point support, and
571           more. This adds a little over 3k to a nonstatic build on x86.
572
573           The SuSv3 sort standard is available at:
574           http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
575
576 config SPLIT
577         bool "split"
578         default y
579         help
580           split a file into pieces.
581
582 config FEATURE_SPLIT_FANCY
583         bool "Fancy extensions"
584         default y
585         depends on SPLIT
586         help
587           Add support for features not required by SUSv3.
588           Supports additional suffixes 'b' for 512 bytes,
589           'g' for 1GiB for the -b option.
590
591 config STAT
592         bool "stat"
593         default y
594         depends on PLATFORM_LINUX # statfs()
595         help
596           display file or filesystem status.
597
598 config FEATURE_STAT_FORMAT
599         bool "Enable custom formats (-c)"
600         default y
601         depends on STAT
602         help
603           Without this, stat will not support the '-c format' option where
604           users can pass a custom format string for output. This adds about
605           7k to a nonstatic build on amd64.
606
607 config STTY
608         bool "stty"
609         default y
610         depends on PLATFORM_LINUX
611         help
612           stty is used to change and print terminal line settings.
613
614 config SUM
615         bool "sum"
616         default y
617         help
618           checksum and count the blocks in a file
619
620 config SYNC
621         bool "sync"
622         default y
623         help
624           sync is used to flush filesystem buffers.
625
626 config TAC
627         bool "tac"
628         default y
629         help
630           tac is used to concatenate and print files in reverse.
631
632 config TAIL
633         bool "tail"
634         default y
635         help
636           tail is used to print the last specified number of lines
637           from files.
638
639 config FEATURE_FANCY_TAIL
640         bool "Enable extra tail options (-q, -s, -v, and -F)"
641         default y
642         depends on TAIL
643         help
644           The options (-q, -s, and -v) are provided by GNU tail, but
645           are not specific in the SUSv3 standard.
646
647             -q      Never output headers giving file names
648             -s SEC  Wait SEC seconds between reads with -f
649             -v      Always output headers giving file names
650
651 config TEE
652         bool "tee"
653         default y
654         help
655           tee is used to read from standard input and write
656           to standard output and files.
657
658 config FEATURE_TEE_USE_BLOCK_IO
659         bool "Enable block I/O (larger/faster) instead of byte I/O"
660         default y
661         depends on TEE
662         help
663           Enable this option for a faster tee, at expense of size.
664
665 config TOUCH
666         bool "touch"
667         default y
668         help
669           touch is used to create or change the access and/or
670           modification timestamp of specified files.
671
672 config TRUE
673         bool "true"
674         default y
675         help
676           true returns an exit code of TRUE (0).
677
678 config TTY
679         bool "tty"
680         default y
681         help
682           tty is used to print the name of the current terminal to
683           standard output.
684
685 config UNAME
686         bool "uname"
687         default y
688         help
689           uname is used to print system information.
690
691 config UNEXPAND
692         bool "unexpand"
693         default y
694         help
695           By default, convert only leading sequences of blanks to tabs.
696
697 config FEATURE_UNEXPAND_LONG_OPTIONS
698         bool "Enable long options"
699         default y
700         depends on UNEXPAND && LONG_OPTS
701         help
702           Support long options for the unexpand applet.
703
704 config UNIQ
705         bool "uniq"
706         default y
707         help
708           uniq is used to remove duplicate lines from a sorted file.
709
710 config USLEEP
711         bool "usleep"
712         default y
713         help
714           usleep is used to pause for a specified number of microseconds.
715
716 config UUDECODE
717         bool "uudecode"
718         default y
719         help
720           uudecode is used to decode a uuencoded file.
721
722 config UUENCODE
723         bool "uuencode"
724         default y
725         help
726           uuencode is used to uuencode a file.
727
728 config WC
729         bool "wc"
730         default y
731         help
732           wc is used to print the number of bytes, words, and lines,
733           in specified files.
734
735 config FEATURE_WC_LARGE
736         bool "Support very large files in wc"
737         default y
738         depends on WC
739         help
740           Use "unsigned long long" in wc for counter variables.
741
742 config WHO
743         bool "who"
744         default y
745         depends on FEATURE_UTMP
746         help
747           who is used to show who is logged on.
748
749 config WHOAMI
750         bool "whoami"
751         default y
752         help
753           whoami is used to print the username of the current
754           user id (same as id -un).
755
756 config YES
757         bool "yes"
758         default y
759         help
760           yes is used to repeatedly output a specific string, or
761           the default string `y'.
762
763 comment "Common options for cp and mv"
764         depends on CP || MV
765
766 config FEATURE_PRESERVE_HARDLINKS
767         bool "Preserve hard links"
768         default y
769         depends on CP || MV
770         help
771           Allow cp and mv to preserve hard links.
772
773 comment "Common options for ls, more and telnet"
774         depends on LS || MORE || TELNET
775
776 config FEATURE_AUTOWIDTH
777         bool "Calculate terminal & column widths"
778         default y
779         depends on LS || MORE || TELNET
780         help
781           This option allows utilities such as 'ls', 'more' and 'telnet'
782           to determine the width of the screen, which can allow them to
783           display additional text or avoid wrapping text onto the next line.
784           If you leave this disabled, your utilities will be especially
785           primitive and will be unable to determine the current screen width.
786
787 comment "Common options for df, du, ls"
788         depends on DF || DU || LS
789
790 config FEATURE_HUMAN_READABLE
791         bool "Support for human readable output (example 13k, 23M, 235G)"
792         default y
793         depends on DF || DU || LS
794         help
795           Allow df, du, and ls to have human readable output.
796
797 comment "Common options for md5sum, sha1sum, sha256sum, sha512sum"
798         depends on MD5SUM || SHA1SUM || SHA256SUM || SHA512SUM
799
800 config FEATURE_MD5_SHA1_SUM_CHECK
801         bool "Enable -c, -s and -w options"
802         default y
803         depends on MD5SUM || SHA1SUM || SHA256SUM || SHA512SUM
804         help
805           Enabling the -c options allows files to be checked
806           against pre-calculated hash values.
807
808           -s and -w are useful options when verifying checksums.
809
810 endmenu