finally move buildroot-ng to trunk
[openwrt.git] / package / busybox / config / 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 BUSYBOX_CONFIG_BASENAME
9         bool "basename"
10         default y
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 BUSYBOX_CONFIG_CAL
17         bool "cal"
18         default n
19         help
20           cal is used to display a monthly calender.
21
22 config BUSYBOX_CONFIG_CAT
23         bool "cat"
24         default y
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 BUSYBOX_CONFIG_CATV
30         bool "catv"
31         default n
32         help
33           Display nonprinting characters as escape sequences (like some
34           implementations' cat -v option).
35
36 config BUSYBOX_CONFIG_CHGRP
37         bool "chgrp"
38         default y
39         help
40           chgrp is used to change the group ownership of files.
41
42 config BUSYBOX_CONFIG_CHMOD
43         bool "chmod"
44         default y
45         help
46           chmod is used to change the access permission of files.
47
48 config BUSYBOX_CONFIG_CHOWN
49         bool "chown"
50         default y
51         help
52           chown is used to change the user and/or group ownership
53           of files.
54
55 config BUSYBOX_CONFIG_CHROOT
56         bool "chroot"
57         default y
58         help
59           chroot is used to change the root directory and run a command.
60           The default command is `/bin/sh'.
61
62 config BUSYBOX_CONFIG_CKSUM
63         bool "cksum"
64         default n
65         help
66           cksum is used to calculate the CRC32 checksum of a file.
67
68 config BUSYBOX_CONFIG_CMP
69         bool "cmp"
70         default n
71         help
72           cmp is used to compare two files and returns the result
73           to standard output.
74
75 config BUSYBOX_CONFIG_COMM
76         bool "comm"
77         default n
78         help
79           comm is used to compare two files line by line and return
80           a three-column output.
81
82 config BUSYBOX_CONFIG_CP
83         bool "cp"
84         default y
85         help
86           cp is used to copy files and directories.
87
88 config BUSYBOX_CONFIG_CUT
89         bool "cut"
90         default y
91         help
92           cut is used to print selected parts of lines from
93           each file to stdout.
94
95 config BUSYBOX_CONFIG_DATE
96         bool "date"
97         default y
98         help
99           date is used to set the system date or display the
100           current time in the given format.
101
102 config BUSYBOX_CONFIG_FEATURE_DATE_ISOFMT
103         bool "Enable ISO date format output (-I)"
104         default y
105         depends on BUSYBOX_CONFIG_DATE
106         help
107           Enable option (-I) to output an ISO-8601 compliant
108           date/time string.
109
110 config BUSYBOX_CONFIG_DD
111         bool "dd"
112         default y
113         help
114           dd copies a file (from standard input to standard output,
115           by default) using specific input and output blocksizes,
116           while optionally performing conversions on it.
117
118 config BUSYBOX_CONFIG_FEATURE_DD_SIGNAL_HANDLING
119         bool "Enable DD signal handling for status reporting"
120         default y
121         depends on BUSYBOX_CONFIG_DD
122         help
123           sending a SIGUSR1 signal to a running `dd' process makes it 
124           print to standard error the number of records read and written 
125           so far, then to resume copying.
126
127           $ dd if=/dev/zero of=/dev/null& pid=$! $ kill -USR1 $pid; sleep 1; kill $pid 
128           10899206+0 records in 10899206+0 records out
129
130 config BUSYBOX_CONFIG_FEATURE_DD_IBS_OBS
131         bool "Enable ibs, obs and conv options"
132         default n
133         depends on BUSYBOX_CONFIG_DD
134         help
135           Enables support for writing a certain number of bytes in and out,
136           at a time, and performing conversions on the data stream.
137
138 config BUSYBOX_CONFIG_DF
139         bool "df"
140         default y
141         help
142           df reports the amount of disk space used and available
143           on filesystems.
144
145 config BUSYBOX_CONFIG_DIFF
146         bool "diff"
147         default n
148         help
149           diff compares two files or directories and outputs the
150           differences between them in a form that can be given to
151           the patch command.
152
153 config BUSYBOX_CONFIG_FEATURE_DIFF_BINARY
154         bool "Enable checks for binary files"
155         default n
156         depends on BUSYBOX_CONFIG_DIFF
157         help
158           This option enables support for checking for binary files
159           before a comparison is carried out.
160
161 config BUSYBOX_CONFIG_FEATURE_DIFF_DIR
162         bool "Enable directory support"
163         default n
164         depends on BUSYBOX_CONFIG_DIFF
165         help
166           This option enables support for directory and subdirectory
167           comparison.
168
169 config BUSYBOX_CONFIG_FEATURE_DIFF_MINIMAL
170         bool "Enable -d option to find smaller sets of changes"
171         default n
172         depends on BUSYBOX_CONFIG_DIFF
173         help
174           Enabling this option allows the use of -d to make diff
175           try hard to find the smallest possible set of changes.
176
177 config BUSYBOX_CONFIG_DIRNAME
178         bool "dirname"
179         default y
180         help
181           dirname is used to strip a non-directory suffix from
182           a file name.
183
184 config BUSYBOX_CONFIG_DOS2UNIX
185         bool "dos2unix/unix2dos"
186         default n
187         help
188           dos2unix is used to convert a text file from DOS format to
189           UNIX format, and vice versa.
190
191 config BUSYBOX_CONFIG_UNIX2DOS
192         bool
193         default n
194         depends on BUSYBOX_CONFIG_DOS2UNIX
195         help
196           unix2dos is used to convert a text file from UNIX format to
197           DOS format, and vice versa.
198
199 config BUSYBOX_CONFIG_DU
200         bool "du (default blocksize of 512 bytes)"
201         default y
202         help
203           du is used to report the amount of disk space used
204           for specified files.
205
206 config BUSYBOX_CONFIG_FEATURE_DU_DEFAULT_BLOCKSIZE_1K
207         bool "Use a default blocksize of 1024 bytes (1K)"
208         default y
209         depends on BUSYBOX_CONFIG_DU
210         help
211           Use a blocksize of (1K) instead of the default 512b.
212
213 config BUSYBOX_CONFIG_ECHO
214         bool "echo (basic SuSv3 version taking no options)"
215         default y
216         help
217           echo is used to print a specified string to stdout.
218
219 # this entry also appears in shell/Config.in, next to the echo builtin
220 config BUSYBOX_CONFIG_FEATURE_FANCY_ECHO
221         bool "Enable echo options (-n and -e)"
222         default y
223         depends on BUSYBOX_CONFIG_ECHO
224         help
225           This adds options (-n and -e) to echo.
226
227 config BUSYBOX_CONFIG_ENV
228         bool "env"
229         default y
230         help
231           env is used to set an environment variable and run
232           a command; without options it displays the current
233           environment.
234
235 config BUSYBOX_CONFIG_FEATURE_ENV_LONG_OPTIONS
236         bool "Enable long options"
237         default n
238         depends on BUSYBOX_CONFIG_ENV && BUSYBOX_CONFIG_GETOPT_LONG
239         help
240           Support long options for the env applet.
241
242 config BUSYBOX_CONFIG_EXPR
243         bool "expr"
244         default y
245         help
246           expr is used to calculate numbers and print the result
247           to standard output.
248
249 config BUSYBOX_CONFIG_EXPR_MATH_SUPPORT_64
250         bool "Extend Posix numbers support to 64 bit"
251         default n
252         depends on BUSYBOX_CONFIG_EXPR
253         help
254           Enable 64-bit math support in the expr applet.  This will make
255           the applet slightly larger, but will allow computation with very
256           large numbers.
257
258 config BUSYBOX_CONFIG_FALSE
259         bool "false"
260         default y
261         help
262           false returns an exit code of FALSE (1).
263
264 config BUSYBOX_CONFIG_FOLD
265         bool "fold"
266         default n
267         help
268           Wrap text to fit a specific width.
269
270 config BUSYBOX_CONFIG_HEAD
271         bool "head"
272         default y
273         help
274           head is used to print the first specified number of lines
275           from files.
276
277 config BUSYBOX_CONFIG_FEATURE_FANCY_HEAD
278         bool "Enable head options (-c, -q, and -v)"
279         default y
280         depends on BUSYBOX_CONFIG_HEAD
281         help
282           This enables the head options (-c, -q, and -v).
283
284 config BUSYBOX_CONFIG_HOSTID
285         bool "hostid"
286         default y
287         help
288           hostid prints the numeric identifier (in hexadecimal) for
289           the current host.
290
291 config BUSYBOX_CONFIG_ID
292         bool "id"
293         default y
294         help
295           id displays the current user and group ID names.
296
297 config BUSYBOX_CONFIG_INSTALL
298         bool "install"
299         default n
300         help
301           Copy files and set attributes.
302
303 config BUSYBOX_CONFIG_FEATURE_INSTALL_LONG_OPTIONS
304         bool "Enable long options"
305         default n
306         depends on BUSYBOX_CONFIG_INSTALL && BUSYBOX_CONFIG_GETOPT_LONG
307         help
308           Support long options for the install applet.
309
310 config BUSYBOX_CONFIG_LENGTH
311         bool "length"
312         default y
313         help
314           length is used to print out the length of a specified string.
315
316 config BUSYBOX_CONFIG_LN
317         bool "ln"
318         default y
319         help
320           ln is used to create hard or soft links between files.
321
322 config BUSYBOX_CONFIG_LOGNAME
323         bool "logname"
324         default n
325         help
326           logname is used to print the current user's login name.
327
328 config BUSYBOX_CONFIG_LS
329         bool "ls"
330         default y
331         help
332           ls is used to list the contents of directories.
333
334 config BUSYBOX_CONFIG_FEATURE_LS_FILETYPES
335         bool "Enable filetyping options (-p and -F)"
336         default y
337         depends on BUSYBOX_CONFIG_LS
338         help
339           Enable the ls options (-p and -F).
340
341 config BUSYBOX_CONFIG_FEATURE_LS_FOLLOWLINKS
342         bool "Enable symlinks dereferencing (-L)"
343         default y
344         depends on BUSYBOX_CONFIG_LS
345         help
346           Enable the ls option (-L).
347
348 config BUSYBOX_CONFIG_FEATURE_LS_RECURSIVE
349         bool "Enable recursion (-R)"
350         default y
351         depends on BUSYBOX_CONFIG_LS
352         help
353           Enable the ls option (-R).
354
355 config BUSYBOX_CONFIG_FEATURE_LS_SORTFILES
356         bool "Sort the file names"
357         default y
358         depends on BUSYBOX_CONFIG_LS
359         help
360           Allow ls to sort file names alphabetically.
361
362 config BUSYBOX_CONFIG_FEATURE_LS_TIMESTAMPS
363         bool "Show file timestamps"
364         default y
365         depends on BUSYBOX_CONFIG_LS
366         help
367           Allow ls to display timestamps for files.
368
369 config BUSYBOX_CONFIG_FEATURE_LS_USERNAME
370         bool "Show username/groupnames"
371         default y
372         depends on BUSYBOX_CONFIG_LS
373         help
374           Allow ls to display username/groupname for files.
375
376 config BUSYBOX_CONFIG_FEATURE_LS_COLOR
377         bool "Allow use of color to identify file types"
378         default y
379         depends on BUSYBOX_CONFIG_LS && BUSYBOX_CONFIG_GETOPT_LONG
380         help
381           This enables the --color option to ls.
382
383 config BUSYBOX_CONFIG_FEATURE_LS_COLOR_IS_DEFAULT
384         bool "Produce colored ls output by default"
385         default y
386         depends on BUSYBOX_CONFIG_FEATURE_LS_COLOR
387         help
388           Saying yes here will turn coloring on by default,
389           even if no "--color" option is given to the ls command.
390           This is not recommended, since the colors are not
391           configurable, and the output may not be legible on
392           many output screens.
393
394 config BUSYBOX_CONFIG_MD5SUM
395         bool "md5sum"
396         default y
397         help
398           md5sum is used to print or check MD5 checksums.
399
400 config BUSYBOX_CONFIG_MKDIR
401         bool "mkdir"
402         default y
403         help
404           mkdir is used to create directories with the specified names.
405
406 config BUSYBOX_CONFIG_FEATURE_MKDIR_LONG_OPTIONS
407         bool "Enable long options"
408         default n
409         depends on BUSYBOX_CONFIG_MKDIR && BUSYBOX_CONFIG_GETOPT_LONG
410         help
411           Support long options for the mkdir applet.
412
413 config BUSYBOX_CONFIG_MKFIFO
414         bool "mkfifo"
415         default y
416         help
417           mkfifo is used to create FIFOs (named pipes).
418           The `mknod' program can also create FIFOs.
419
420 config BUSYBOX_CONFIG_MKNOD
421         bool "mknod"
422         default y
423         help
424           mknod is used to create FIFOs or block/character special
425           files with the specified names.
426
427 config BUSYBOX_CONFIG_MV
428         bool "mv"
429         default y
430         help
431           mv is used to move or rename files or directories.
432
433 config BUSYBOX_CONFIG_FEATURE_MV_LONG_OPTIONS
434         bool "Enable long options"
435         default n
436         depends on BUSYBOX_CONFIG_MV && BUSYBOX_CONFIG_GETOPT_LONG
437         help
438           Support long options for the mv applet.
439
440 config BUSYBOX_CONFIG_NICE
441         bool "nice"
442         default n
443         help
444           nice runs a program with modified scheduling priority.
445
446 config BUSYBOX_CONFIG_NOHUP
447         bool "nohup"
448         default n
449         help
450           run a command immune to hangups, with output to a non-tty.
451
452 config BUSYBOX_CONFIG_OD
453         bool "od"
454         default n
455         help
456           od is used to dump binary files in octal and other formats.
457
458 config BUSYBOX_CONFIG_PRINTENV
459         bool "printenv"
460         default n
461         help
462           printenv is used to print all or part of environment.
463
464 config BUSYBOX_CONFIG_PRINTF
465         bool "printf"
466         default y
467         help
468           printf is used to format and print specified strings.
469           It's similar to `echo' except it has more options.
470
471 config BUSYBOX_CONFIG_PWD
472         bool "pwd"
473         default y
474         help
475           pwd is used to print the current directory.
476
477 config BUSYBOX_CONFIG_REALPATH
478         bool "realpath"
479         default n
480         help
481           Return the canonicalized absolute pathname.
482           This isn't provided by GNU shellutils, but where else does it belong.
483
484 config BUSYBOX_CONFIG_RM
485         bool "rm"
486         default y
487         help
488           rm is used to remove files or directories.
489
490 config BUSYBOX_CONFIG_RMDIR
491         bool "rmdir"
492         default y
493         help
494           rmdir is used to remove empty directories.
495
496 config BUSYBOX_CONFIG_SEQ
497         bool "seq"
498         default y
499         help
500           print a sequence of numbers
501
502 config BUSYBOX_CONFIG_SHA1SUM
503         bool "sha1sum"
504         default n
505         help
506           Compute and check SHA1 message digest
507
508 config BUSYBOX_CONFIG_SLEEP
509         bool "sleep (single integer arg with no suffix)"
510         default y
511         help
512           sleep is used to pause for a specified number of seconds,
513
514 config BUSYBOX_CONFIG_FEATURE_FANCY_SLEEP
515         bool "Enable multiple integer args and optional time suffixes"
516         default y
517         depends on BUSYBOX_CONFIG_SLEEP
518         help
519           Allow sleep to pause for specified minutes, hours, and days.
520
521 config BUSYBOX_CONFIG_SORT
522         bool "sort"
523         default y
524         help
525           sort is used to sort lines of text in specified files.
526
527 config BUSYBOX_CONFIG_FEATURE_SORT_BIG
528         bool "full SuSv3 compliant sort (Support -ktcsbdfiozgM)"
529         default n
530         depends on BUSYBOX_CONFIG_SORT
531         help
532           Without this, sort only supports  -r, -u, and an integer version
533           of -n.  Selecting this adds sort keys, floating point support, and
534           more.  This adds a little over 3k to a nonstatic build on x86.
535
536           The SuSv3 sort standard is available at:
537           http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
538
539 config BUSYBOX_CONFIG_STAT
540         bool "stat"
541         default n
542         help
543           display file or filesystem status.
544
545 config BUSYBOX_CONFIG_FEATURE_STAT_FORMAT
546         bool "Enable custom formats (-c)"
547         default n
548         depends on BUSYBOX_CONFIG_STAT
549         help
550           Without this, stat will not support the '-c format' option where
551           users can pass a custom format string for output.  This adds about
552           7k to a nonstatic build on amd64.
553
554 config BUSYBOX_CONFIG_STTY
555         bool "stty"
556         default n
557         help
558           stty is used to change and print terminal line settings.
559
560 config BUSYBOX_CONFIG_SUM
561         bool "sum"
562         default n
563         help
564           checksum and count the blocks in a file
565
566 config BUSYBOX_CONFIG_SYNC
567         bool "sync"
568         default y
569         help
570           sync is used to flush filesystem buffers.
571
572 config BUSYBOX_CONFIG_TAIL
573         bool "tail"
574         default y
575         help
576           tail is used to print the last specified number of lines
577           from files.
578
579 config BUSYBOX_CONFIG_FEATURE_FANCY_TAIL
580         bool "Enable extra tail options (-q, -s, and -v)"
581         default y
582         depends on BUSYBOX_CONFIG_TAIL
583         help
584           The options (-q, -s, and -v) are provided by GNU tail, but
585           are not specific in the SUSv3 standard.
586
587 config BUSYBOX_CONFIG_TEE
588         bool "tee"
589         default y
590         help
591           tee is used to read from standard input and write
592           to standard output and files.
593
594 config BUSYBOX_CONFIG_FEATURE_TEE_USE_BLOCK_IO
595         bool "Enable block i/o (larger/faster) instead of byte i/o."
596         default y
597         depends on BUSYBOX_CONFIG_TEE
598         help
599           Enable this option for a faster tee, at expense of size.
600
601 config BUSYBOX_CONFIG_TEST
602         bool "test"
603         default y
604         help
605           test is used to check file types and compare values,
606           returning an appropriate exit code.  The bash shell
607           has test built in, ash can build it in optionally.
608
609 config BUSYBOX_CONFIG_FEATURE_TEST_64
610         bool "Extend test to 64 bit"
611         default n
612         depends on BUSYBOX_CONFIG_TEST
613         help
614           Enable 64-bit support in test.
615
616 config BUSYBOX_CONFIG_TOUCH
617         bool "touch"
618         default y
619         help
620           touch is used to create or change the access and/or
621           modification timestamp of specified files.
622
623 config BUSYBOX_CONFIG_TR
624         bool "tr"
625         default y
626         help
627           tr is used to squeeze, and/or delete characters from standard
628           input, writing to standard output.
629
630 config BUSYBOX_CONFIG_FEATURE_TR_CLASSES
631         bool "Enable character classes (such as [:upper:])"
632         default n
633         depends on BUSYBOX_CONFIG_TR
634         help
635           Enable character classes, enabling commands such as:
636           tr [:upper:] [:lower:] to convert input into lowercase.
637
638 config BUSYBOX_CONFIG_FEATURE_TR_EQUIV
639         bool "Enable equivalence classes"
640         default n
641         depends on BUSYBOX_CONFIG_TR
642         help
643           Enable equivalence classes, which essentially add the enclosed
644           character to the current set. For instance, tr [=a=] xyz would
645           replace all instances of 'a' with 'xyz'. This option is mainly
646           useful for cases when no other way of expressing a character
647           is possible.
648
649 config BUSYBOX_CONFIG_TRUE
650         bool "true"
651         default y
652         help
653           true returns an exit code of TRUE (0).
654
655 config BUSYBOX_CONFIG_TTY
656         bool "tty"
657         default n
658         help
659           tty is used to print the name of the current terminal to
660           standard output.
661
662 config BUSYBOX_CONFIG_UNAME
663         bool "uname"
664         default y
665         help
666           uname is used to print system information.
667
668 config BUSYBOX_CONFIG_UNIQ
669         bool "uniq"
670         default y
671         help
672           uniq is used to remove duplicate lines from a sorted file.
673
674 config BUSYBOX_CONFIG_USLEEP
675         bool "usleep"
676         default n
677         help
678           usleep is used to pause for a specified number of microseconds.
679
680 config BUSYBOX_CONFIG_UUDECODE
681         bool "uudecode"
682         default n
683         help
684           uudecode is used to decode a uuencoded file.
685
686 config BUSYBOX_CONFIG_UUENCODE
687         bool "uuencode"
688         default n
689         help
690           uuencode is used to uuencode a file.
691
692 config BUSYBOX_CONFIG_WATCH
693         bool "watch"
694         default n
695         select BUSYBOX_CONFIG_DATE
696         help
697           watch is used to execute a program periodically, showing
698           output to the screen.
699
700 config BUSYBOX_CONFIG_WC
701         bool "wc"
702         default y
703         help
704           wc is used to print the number of bytes, words, and lines,
705           in specified files.
706
707 config BUSYBOX_CONFIG_WHO
708         bool "who"
709         default n
710         select BUSYBOX_CONFIG_FEATURE_UTMP
711         help
712           who is used to show who is logged on.
713
714 config BUSYBOX_CONFIG_WHOAMI
715         bool "whoami"
716         default n
717         help
718           whoami is used to print the username of the current
719           user id (same as id -un).
720
721 config BUSYBOX_CONFIG_YES
722         bool "yes"
723         default y
724         help
725           yes is used to repeatedly output a specific string, or
726           the default string `y'.
727
728 comment "Common options for cp and mv"
729         depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
730
731 config BUSYBOX_CONFIG_FEATURE_PRESERVE_HARDLINKS
732         bool "Preserve hard links"
733         default y
734         depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
735         help
736           Allow cp and mv to preserve hard links.
737
738 comment "Common options for ls, more and telnet"
739         depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
740
741 config BUSYBOX_CONFIG_FEATURE_AUTOWIDTH
742         bool "Calculate terminal & column widths"
743         default y
744         depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE || BUSYBOX_CONFIG_TELNET
745         help
746           This option allows utilities such as 'ls', 'more' and 'telnet'
747           to determine the width of the screen, which can allow them to 
748           display additional text or avoid wrapping text onto the next line.
749           If you leave this disabled, your utilities will be especially 
750           primitive and will be unable to determine the current screen width.
751
752 comment "Common options for df, du, ls"
753         depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
754
755 config BUSYBOX_CONFIG_FEATURE_HUMAN_READABLE
756         bool "Support for human readable output (example 13k, 23M, 235G)"
757         default y
758         depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
759         help
760           Allow df, du, and ls to have human readable output.
761
762 comment "Common options for md5sum, sha1sum"
763         depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM
764
765 config BUSYBOX_CONFIG_FEATURE_MD5_SHA1_SUM_CHECK
766         bool "Enable -c, -s and -w options"
767         default y
768         depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM
769         help
770           Enabling the -c options allows files to be checked
771           against pre-calculated hash values.
772
773           -s and -w are useful options when verifying checksums.
774
775 endmenu