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