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