- new applet diff. Rob Sullivan writes:
[oweals/busybox.git] / coreutils / Config.in
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 config CONFIG_BASENAME
9         bool "basename"
10         default n
11         help
12           basename is used to strip the directory and suffix from filenames,
13           leaving just the filename itself.  Enable this option if you wish
14           to enable the 'basename' utility.
15
16 config CONFIG_CAL
17         bool "cal"
18         default n
19         help
20           cal is used to display a monthly calender.
21
22 config CONFIG_CAT
23         bool "cat"
24         default n
25         help
26           cat is used to concatenate files and print them to the standard
27           output.  Enable this option if you wish to enable the 'cat' utility.
28
29 config CONFIG_CHGRP
30         bool "chgrp"
31         default n
32         help
33           chgrp is used to change the group ownership of files.
34
35 config CONFIG_CHMOD
36         bool "chmod"
37         default n
38         help
39           chmod is used to change the access permission of files.
40
41 config CONFIG_CHOWN
42         bool "chown"
43         default n
44         help
45           chown is used to change the user and/or group ownership
46           of files.
47
48 config CONFIG_CHROOT
49         bool "chroot"
50         default n
51         help
52           chroot is used to change the root directory and run a command.
53           The default command is `/bin/sh'.
54
55 config CONFIG_CMP
56         bool "cmp"
57         default n
58         help
59           cmp is used to compare two files and returns the result
60           to standard output.
61
62 config CONFIG_COMM
63         bool "comm"
64         default n
65         help
66           comm is used to compare two files line by line and return
67           a three-column output.
68
69 config CONFIG_CP
70         bool "cp"
71         default n
72         help
73           cp is used to copy files and directories.
74
75 config CONFIG_CUT
76         bool "cut"
77         default n
78         help
79           cut is used to print selected parts of lines from
80           each file to stdout.
81
82 config CONFIG_DATE
83         bool "date"
84         default n
85         help
86           date is used to set the system date or display the
87           current time in the given format.
88
89 config CONFIG_FEATURE_DATE_ISOFMT
90         bool "  Enable ISO date format output (-I)"
91         default y
92         depends on CONFIG_DATE
93         help
94           Enable option (-I) to output an ISO-8601 compliant
95           date/time string.
96
97 config CONFIG_DD
98         bool "dd"
99         default n
100         help
101           dd copies a file (from standard input to standard output,
102           by default) using specific input and output blocksizes,
103           while optionally performing conversions on it.
104
105 config CONFIG_DF
106         bool "df"
107         default n
108         help
109           df reports the amount of disk space used and available
110           on filesystems.
111
112 config CONFIG_DIFF
113         bool "diff"
114         default n
115         help
116           diff compares two files or directories and outputs the
117           differences between them in a form that can be given to
118           the patch command.
119
120 config CONFIG_FEATURE_DIFF_BINARY
121         bool "  Enable checks for binary files"
122         default y
123         depends on CONFIG_DIFF
124         help
125           This option enables support for checking for binary files
126           before a comparison is carried out.
127
128 config CONFIG_FEATURE_DIFF_DIR
129         bool "  Enable directory support"
130         default y
131         depends on CONFIG_DIFF
132         help
133           This option enables support for directory and subdirectory
134           comparison.
135
136 config CONFIG_FEATURE_DIFF_MINIMAL
137         bool "  Enable -d option to find smaller sets of changes"
138         default n
139         depends on CONFIG_DIFF
140         help
141           Enabling this option allows the use of -d to make diff
142           try hard to find the smallest possible set of changes.
143
144 config CONFIG_DIRNAME
145         bool "dirname"
146         default n
147         help
148           dirname is used to strip a non-directory suffix from
149           a file name.
150
151 config CONFIG_DOS2UNIX
152         bool "dos2unix/unix2dos"
153         default n
154         help
155           dos2unix is used to convert a text file from DOS format to
156           UNIX format, and vice versa.
157
158 config CONFIG_UNIX2DOS
159         bool
160         default y
161         depends on CONFIG_DOS2UNIX
162
163 config CONFIG_DU
164         bool "du (default blocksize of 512 bytes)"
165         default n
166         help
167           du is used to report the amount of disk space used
168           for specified files.
169
170 config CONFIG_FEATURE_DU_DEFALT_BLOCKSIZE_1K
171         bool "  Use a default blocksize of 1024 bytes (1K)"
172         default y
173         depends on CONFIG_DU
174         help
175           Use a blocksize of (1K) instead of the default 512b.
176
177 config CONFIG_ECHO
178         bool "echo (basic SuSv3 version taking no options)"
179         default n
180         help
181           echo is used to print a specified string to stdout.
182
183 # this entry also appears in shell/Config.in, next to the echo builtin
184 config CONFIG_FEATURE_FANCY_ECHO
185         bool "  Enable echo options (-n and -e)"
186         default y
187         depends on CONFIG_ECHO
188         help
189           This adds options (-n and -e) to echo.
190
191 config CONFIG_ENV
192         bool "env"
193         default n
194         help
195           env is used to set an environment variable and run
196           a command; without options it displays the current
197           environment.
198
199 config CONFIG_EXPR
200         bool "expr"
201         default n
202         help
203           expr is used to calculate numbers and print the result
204           to standard output.
205
206 config CONFIG_EXPR_MATH_SUPPORT_64
207         bool "    Extend Posix numbers support to 64 bit"
208         default n
209         depends on CONFIG_EXPR
210         help
211           Enable 64-bit math support in the expr applet.  This will make
212           the applet slightly larger, but will allow computation with very
213           large numbers.
214
215 config CONFIG_FALSE
216         bool "false"
217         default n
218         help
219           false returns an exit code of FALSE (1).
220
221 config CONFIG_FOLD
222         bool "fold"
223         default n
224         help
225           Wrap text to fit a specific width.
226
227 config CONFIG_HEAD
228         bool "head"
229         default n
230         help
231           head is used to print the first specified number of lines
232           from files.
233
234 config CONFIG_FEATURE_FANCY_HEAD
235         bool "  Enable head options (-c, -q, and -v)"
236         default n
237         depends on CONFIG_HEAD
238         help
239           This enables the head options (-c, -q, and -v).
240
241 config CONFIG_HOSTID
242         bool "hostid"
243         default n
244         help
245           hostid prints the numeric identifier (in hexadecimal) for
246           the current host.
247
248 config CONFIG_ID
249         bool "id"
250         default n
251         help
252           id displays the current user and group ID names.
253
254 config CONFIG_INSTALL
255         bool "install"
256         default n
257         help
258           Copy files and set attributes.
259
260 config CONFIG_LENGTH
261         bool "length"
262         default n
263         help
264           length is used to print out the length of a specified string.
265
266 config CONFIG_LN
267         bool "ln"
268         default n
269         help
270           ln is used to create hard or soft links between files.
271
272 config CONFIG_LOGNAME
273         bool "logname"
274         default n
275         help
276           logname is used to print the current user's login name.
277
278 config CONFIG_LS
279         bool "ls"
280         default n
281         help
282           ls is used to list the contents of directories.
283
284 config CONFIG_FEATURE_LS_FILETYPES
285         bool "  Enable filetyping options (-p and -F)"
286         default y
287         depends on CONFIG_LS
288         help
289           Enable the ls options (-p and -F).
290
291 config CONFIG_FEATURE_LS_FOLLOWLINKS
292         bool "  Enable symlinks dereferencing (-L)"
293         default y
294         depends on CONFIG_LS
295         help
296           Enable the ls option (-L).
297
298 config CONFIG_FEATURE_LS_RECURSIVE
299         bool "  Enable recursion (-R)"
300         default y
301         depends on CONFIG_LS
302         help
303           Enable the ls option (-R).
304
305 config CONFIG_FEATURE_LS_SORTFILES
306         bool "  Sort the file names"
307         default y
308         depends on CONFIG_LS
309         help
310           Allow ls to sort file names alphabetically.
311
312 config CONFIG_FEATURE_LS_TIMESTAMPS
313         bool "  Show file timestamps"
314         default y
315         depends on CONFIG_LS
316         help
317           Allow ls to display timestamps for files.
318
319 config CONFIG_FEATURE_LS_USERNAME
320         bool "  Show username/groupnames"
321         default y
322         depends on CONFIG_LS
323         help
324           Allow ls to display username/groupname for files.
325
326 config CONFIG_FEATURE_LS_COLOR
327         bool "  Allow use of color to identify file types"
328         default y
329         depends on CONFIG_LS
330         help
331           This enables the --color option to ls.
332
333 config CONFIG_FEATURE_LS_COLOR_IS_DEFAULT
334         bool "  Produce colored ls output by default"
335         default n
336         depends on CONFIG_FEATURE_LS_COLOR
337         help
338           Saying yes here will turn coloring on by default,
339           even if no "--color" option is given to the ls command.
340           This is not recommended, since the colors are not
341           configurable, and the output may not be legible on
342           many output screens.
343
344 config CONFIG_MD5SUM
345         bool "md5sum"
346         default n
347         help
348           md5sum is used to print or check MD5 checksums.
349
350 config CONFIG_MKDIR
351         bool "mkdir"
352         default n
353         help
354           mkdir is used to create directories with the specified names.
355
356 config CONFIG_MKFIFO
357         bool "mkfifo"
358         default n
359         help
360           mkfifo is used to create FIFOs (named pipes).
361           The `mknod' program can also create FIFOs.
362
363 config CONFIG_MKNOD
364         bool "mknod"
365         default n
366         help
367           mknod is used to create FIFOs or block/character special
368           files with the specified names.
369
370 config CONFIG_MV
371         bool "mv"
372         default n
373         help
374           mv is used to move or rename files or directories.
375
376 config CONFIG_NICE
377         bool "nice"
378         default n
379         help
380           nice runs a program with modified scheduling priority.
381
382 config CONFIG_NOHUP
383         bool "nohup"
384         default n
385         help
386           run a command immune to hangups, with output to a non-tty.
387
388 config CONFIG_OD
389         bool "od"
390         default n
391         help
392           od is used to dump binary files in octal and other formats.
393
394 config CONFIG_PRINTENV
395         bool "printenv"
396         default n
397         help
398           printenv is used to print all or part of environment.
399
400 config CONFIG_PRINTF
401         bool "printf"
402         default n
403         help
404           printf is used to format and print specified strings.
405           It's similar to `echo' except it has more options.
406
407 config CONFIG_PWD
408         bool "pwd"
409         default n
410         help
411           pwd is used to print the current directory.
412
413 config CONFIG_REALPATH
414         bool "realpath"
415         default n
416         help
417           Return the canonicalized absolute pathname.
418           This isn't provided by GNU shellutils, but where else does it belong.
419
420 config CONFIG_RM
421         bool "rm"
422         default n
423         help
424           rm is used to remove files or directories.
425
426 config CONFIG_RMDIR
427         bool "rmdir"
428         default n
429         help
430           rmdir is used to remove empty directories.
431
432 config CONFIG_SEQ
433         bool "seq"
434         default n
435         help
436           print a sequence of numbers
437
438 config CONFIG_SHA1SUM
439         bool "sha1sum"
440         default n
441         help
442           Compute and check SHA1 message digest
443
444 config CONFIG_SLEEP
445         bool "sleep (single integer arg with no suffix)"
446         default n
447         help
448           sleep is used to pause for a specified number of seconds,
449
450 config CONFIG_FEATURE_FANCY_SLEEP
451         bool "  Enable multiple integer args and optional time suffixes"
452         default n
453         depends on CONFIG_SLEEP
454         help
455           Allow sleep to pause for specified minutes, hours, and days.
456
457 config CONFIG_SORT
458         bool "sort"
459         default n
460         help
461           sort is used to sort lines of text in specified files.
462
463 config CONFIG_FEATURE_SORT_BIG
464         bool "  full SuSv3 compliant sort (Support -ktcsbdfiozgM)"
465         default y
466         depends on CONFIG_SORT
467         help
468           Without this, sort only supports  -r, -u, and an integer version
469           of -n.  Selecting this adds sort keys, floating point support, and
470           more.  This adds a little over 3k to a nonstatic build on x86.
471
472           The SuSv3 sort standard is available at:
473           http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
474
475 config CONFIG_STAT
476         bool "stat"
477         default n
478         help
479           display file or filesystem status.
480
481 config CONFIG_FEATURE_STAT_FORMAT
482         bool "  Enable custom formats (-c)"
483         default n
484         depends on CONFIG_STAT
485         help
486           Without this, stat will not support the '-c format' option where
487           users can pass a custom format string for output.  This adds about
488           7k to a nonstatic build on amd64.
489
490 config CONFIG_STTY
491         bool "stty"
492         default n
493         help
494           stty is used to change and print terminal line settings.
495
496 config CONFIG_SUM
497         bool "sum"
498         default n
499         help
500           checksum and count the blocks in a file
501
502 config CONFIG_SYNC
503         bool "sync"
504         default n
505         help
506           sync is used to flush filesystem buffers.
507
508 config CONFIG_TAIL
509         bool "tail"
510         default n
511         help
512           tail is used to print the last specified number of lines
513           from files.
514
515 config CONFIG_FEATURE_FANCY_TAIL
516         bool "  Enable extra tail options (-q, -s, and -v)"
517         default y
518         depends on CONFIG_TAIL
519         help
520           The options (-q, -s, and -v) are provided by GNU tail, but
521           are not specific in the SUSv3 standard.
522
523 config CONFIG_TEE
524         bool "tee"
525         default n
526         help
527           tee is used to read from standard input and write
528           to standard output and files.
529
530 config CONFIG_FEATURE_TEE_USE_BLOCK_IO
531         bool "  Enable block i/o (larger/faster) instead of byte i/o."
532         default n
533         depends on CONFIG_TEE
534         help
535           Enable this option for a faster tee, at expense of size.
536
537 config CONFIG_TEST
538         bool "test"
539         default n
540         help
541           test is used to check file types and compare values,
542           returning an appropriate exit code. The shells (ash
543           and bash) have test builtin.
544
545 config CONFIG_FEATURE_TEST_64
546         bool "  Extend test to 64 bit"
547         default n
548         depends on CONFIG_TEST
549         help
550           Enable 64-bit support in test.
551
552 config CONFIG_TOUCH
553         bool "touch"
554         default n
555         help
556           touch is used to create or change the access and/or
557           modification timestamp of specified files.
558
559 config CONFIG_TR
560         bool "tr"
561         default n
562         help
563           tr is used to squeeze, and/or delete characters from standard
564           input, writing to standard output.
565
566 config CONFIG_FEATURE_TR_CLASSES
567         bool "  Enable character classes (such as [:upper:])"
568         default n
569         depends on CONFIG_TR
570         help
571           Enable character classes, enabling commands such as:
572           tr [:upper:] [:lower:] to convert input into lowercase.
573
574 config CONFIG_FEATURE_TR_EQUIV
575         bool "  Enable equivalence classes"
576         default n
577         depends on CONFIG_TR
578         help
579           Enable equivalence classes, which essentially add the enclosed
580           character to the current set. For instance, tr [=a=] xyz would
581           replace all instances of 'a' with 'xyz'. This option is mainly
582           useful for cases when no other way of expressing a character
583           is possible.
584
585 config CONFIG_TRUE
586         bool "true"
587         default n
588         help
589           true returns an exit code of TRUE (0).
590
591 config CONFIG_TTY
592         bool "tty"
593         default n
594         help
595           tty is used to print the name of the current terminal to
596           standard output.
597
598 config CONFIG_UNAME
599         bool "uname"
600         default n
601         help
602           uname is used to print system information.
603
604 config CONFIG_UNIQ
605         bool "uniq"
606         default n
607         help
608           uniq is used to remove duplicate lines from a sorted file.
609
610 config CONFIG_USLEEP
611         bool "usleep"
612         default n
613         help
614           usleep is used to pause for a specified number of microseconds.
615
616 config CONFIG_UUDECODE
617         bool "uudecode"
618         default n
619         help
620           uudecode is used to decode a uuencoded file.
621
622 config CONFIG_UUENCODE
623         bool "uuencode"
624         default n
625         help
626           uuencode is used to uuencode a file.
627
628 config CONFIG_WATCH
629         bool "watch"
630         default n
631         select CONFIG_DATE
632         help
633           watch is used to execute a program periodically, showing
634           output to the screen.
635
636 config CONFIG_WC
637         bool "wc"
638         default n
639         help
640           wc is used to print the number of bytes, words, and lines,
641           in specified files.
642
643 config CONFIG_WHO
644         bool "who"
645         default n
646         select CONFIG_FEATURE_UTMP
647         help
648           who is used to show who is logged on.
649
650 config CONFIG_WHOAMI
651         bool "whoami"
652         default n
653         help
654           whoami is used to print the username of the current
655           user id (same as id -un).
656
657 config CONFIG_YES
658         bool "yes"
659         default n
660         help
661           yes is used to repeatedly output a specific string, or
662           the default string `y'.
663
664 comment "Common options for cp and mv"
665         depends on CONFIG_CP || CONFIG_MV
666
667 config CONFIG_FEATURE_PRESERVE_HARDLINKS
668         bool "  Preserve hard links"
669         default n
670         depends on CONFIG_CP || CONFIG_MV
671         help
672           Allow cp and mv to preserve hard links.
673
674 comment "Common options for ls, more and telnet"
675         depends on CONFIG_LS || CONFIG_MORE || CONFIG_TELNET
676
677 config CONFIG_FEATURE_AUTOWIDTH
678         bool "  Calculate terminal & column widths"
679         default y
680         depends on CONFIG_LS || CONFIG_MORE || CONFIG_TELNET
681         help
682           This option allows utilities such as 'ls', 'more' and 'telnet'
683           to determine the width of the screen, which can allow them to 
684           display additional text or avoid wrapping text onto the next line.
685           If you leave this disabled, your utilities will be especially 
686           primitive and will be unable to determine the current screen width.
687
688 comment "Common options for df, du, ls"
689         depends on CONFIG_DF || CONFIG_DU || CONFIG_LS
690
691 config CONFIG_FEATURE_HUMAN_READABLE
692         bool "  Support for human readable output (example 13k, 23M, 235G)"
693         default n
694         depends on CONFIG_DF || CONFIG_DU || CONFIG_LS
695         help
696           Allow df, du, and ls to have human readable output.
697
698 comment "Common options for md5sum, sha1sum"
699         depends on CONFIG_MD5SUM || CONFIG_SHA1SUM
700
701 config CONFIG_FEATURE_MD5_SHA1_SUM_CHECK
702         bool "  Enable -c, -s and -w options"
703         default n
704         depends on CONFIG_MD5SUM || CONFIG_SHA1SUM
705         help
706           Enabling the -c options allows files to be checked
707           against pre-calculated hash values.
708
709           -s and -w are useful options when verifying checksums.
710
711 endmenu