Initial public busybox maemo commit, 3:1.10.2.legal-1osso12
[busybox4maemo] / 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 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 CAL
17         bool "cal"
18         default n
19         help
20           cal is used to display a monthly calender.
21
22 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 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 CHGRP
37         bool "chgrp"
38         default n
39         help
40           chgrp is used to change the group ownership of files.
41
42 config CHMOD
43         bool "chmod"
44         default n
45         help
46           chmod is used to change the access permission of files.
47
48 config CHOWN
49         bool "chown"
50         default n
51         help
52           chown is used to change the user and/or group ownership
53           of files.
54
55 config CHROOT
56         bool "chroot"
57         default n
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 CKSUM
63         bool "cksum"
64         default n
65         help
66           cksum is used to calculate the CRC32 checksum of a file.
67
68 config COMM
69         bool "comm"
70         default n
71         help
72           comm is used to compare two files line by line and return
73           a three-column output.
74
75 config CP
76         bool "cp"
77         default n
78         help
79           cp is used to copy files and directories.
80
81 config CUT
82         bool "cut"
83         default n
84         help
85           cut is used to print selected parts of lines from
86           each file to stdout.
87
88 config DATE
89         bool "date"
90         default n
91         help
92           date is used to set the system date or display the
93           current time in the given format.
94
95 config FEATURE_DATE_ISOFMT
96         bool "Enable ISO date format output (-I)"
97         default y
98         depends on DATE
99         help
100           Enable option (-I) to output an ISO-8601 compliant
101           date/time string.
102
103 config DD
104         bool "dd"
105         default n
106         help
107           dd copies a file (from standard input to standard output,
108           by default) using specific input and output blocksizes,
109           while optionally performing conversions on it.
110
111 config FEATURE_DD_SIGNAL_HANDLING
112         bool "Enable DD signal handling for status reporting"
113         default y
114         depends on DD
115         help
116           sending a SIGUSR1 signal to a running `dd' process makes it
117           print to standard error the number of records read and written
118           so far, then to resume copying.
119
120           $ dd if=/dev/zero of=/dev/null& pid=$! $ kill -USR1 $pid; sleep 1; kill $pid
121           10899206+0 records in 10899206+0 records out
122
123 config FEATURE_DD_IBS_OBS
124         bool "Enable ibs, obs and conv options"
125         default n
126         depends on DD
127         help
128           Enables support for writing a certain number of bytes in and out,
129           at a time, and performing conversions on the data stream.
130
131 config DF
132         bool "df"
133         default n
134         help
135           df reports the amount of disk space used and available
136           on filesystems.
137
138 config FEATURE_DF_INODE
139         bool "Enable -i (inode information)"
140         default n
141         depends on DF
142         help
143           This option enables support for df -i.
144
145 config DIRNAME
146         bool "dirname"
147         default n
148         help
149           dirname is used to strip a non-directory suffix from
150           a file name.
151
152 config DOS2UNIX
153         bool "dos2unix/unix2dos"
154         default n
155         help
156           dos2unix is used to convert a text file from DOS format to
157           UNIX format, and vice versa.
158
159 config UNIX2DOS
160         bool
161         default y
162         depends on DOS2UNIX
163         help
164           unix2dos is used to convert a text file from UNIX format to
165           DOS format, and vice versa.
166
167 config DU
168         bool "du (default blocksize of 512 bytes)"
169         default n
170         help
171           du is used to report the amount of disk space used
172           for specified files.
173
174 config FEATURE_DU_DEFAULT_BLOCKSIZE_1K
175         bool "Use a default blocksize of 1024 bytes (1K)"
176         default y
177         depends on DU
178         help
179           Use a blocksize of (1K) instead of the default 512b.
180
181 config ECHO
182         bool "echo (basic SuSv3 version taking no options)"
183         default n
184         help
185           echo is used to print a specified string to stdout.
186
187 # this entry also appears in shell/Config.in, next to the echo builtin
188 config FEATURE_FANCY_ECHO
189         bool "Enable echo options (-n and -e)"
190         default y
191         depends on ECHO
192         help
193           This adds options (-n and -e) to echo.
194
195 config ENV
196         bool "env"
197         default n
198         help
199           env is used to set an environment variable and run
200           a command; without options it displays the current
201           environment.
202
203 config FEATURE_ENV_LONG_OPTIONS
204         bool "Enable long options"
205         default n
206         depends on ENV && GETOPT_LONG
207         help
208           Support long options for the env applet.
209
210 config EXPAND
211         bool "expand"
212         default n
213         help
214           By default, convert all tabs to spaces.
215
216 config FEATURE_EXPAND_LONG_OPTIONS
217         bool "Enable long options"
218         default n
219         depends on EXPAND && GETOPT_LONG
220         help
221           Support long options for the expand applet.
222
223 config EXPR
224         bool "expr"
225         default n
226         help
227           expr is used to calculate numbers and print the result
228           to standard output.
229
230 config EXPR_MATH_SUPPORT_64
231         bool "Extend Posix numbers support to 64 bit"
232         default n
233         depends on EXPR
234         help
235           Enable 64-bit math support in the expr applet.  This will make
236           the applet slightly larger, but will allow computation with very
237           large numbers.
238
239 config FALSE
240         bool "false"
241         default n
242         help
243           false returns an exit code of FALSE (1).
244
245 config FOLD
246         bool "fold"
247         default n
248         help
249           Wrap text to fit a specific width.
250
251 config HEAD
252         bool "head"
253         default n
254         help
255           head is used to print the first specified number of lines
256           from files.
257
258 config FEATURE_FANCY_HEAD
259         bool "Enable head options (-c, -q, and -v)"
260         default n
261         depends on HEAD
262         help
263           This enables the head options (-c, -q, and -v).
264
265 config HOSTID
266         bool "hostid"
267         default n
268         help
269           hostid prints the numeric identifier (in hexadecimal) for
270           the current host.
271
272 config ID
273         bool "id"
274         default n
275         help
276           id displays the current user and group ID names.
277
278 config INSTALL
279         bool "install"
280         default n
281         help
282           Copy files and set attributes.
283
284 config FEATURE_INSTALL_LONG_OPTIONS
285         bool "Enable long options"
286         default n
287         depends on INSTALL && GETOPT_LONG
288         help
289           Support long options for the install applet.
290
291 config LENGTH
292         bool "length"
293         default n
294         help
295           length is used to print out the length of a specified string.
296
297 config LN
298         bool "ln"
299         default n
300         help
301           ln is used to create hard or soft links between files.
302
303 config LOGNAME
304         bool "logname"
305         default n
306         help
307           logname is used to print the current user's login name.
308
309 config LS
310         bool "ls"
311         default n
312         help
313           ls is used to list the contents of directories.
314
315 config FEATURE_LS_FILETYPES
316         bool "Enable filetyping options (-p and -F)"
317         default y
318         depends on LS
319         help
320           Enable the ls options (-p and -F).
321
322 config FEATURE_LS_FOLLOWLINKS
323         bool "Enable symlinks dereferencing (-L)"
324         default y
325         depends on LS
326         help
327           Enable the ls option (-L).
328
329 config FEATURE_LS_RECURSIVE
330         bool "Enable recursion (-R)"
331         default y
332         depends on LS
333         help
334           Enable the ls option (-R).
335
336 config FEATURE_LS_SORTFILES
337         bool "Sort the file names"
338         default y
339         depends on LS
340         help
341           Allow ls to sort file names alphabetically.
342
343 config FEATURE_LS_TIMESTAMPS
344         bool "Show file timestamps"
345         default y
346         depends on LS
347         help
348           Allow ls to display timestamps for files.
349
350 config FEATURE_LS_USERNAME
351         bool "Show username/groupnames"
352         default y
353         depends on LS
354         help
355           Allow ls to display username/groupname for files.
356
357 config FEATURE_LS_COLOR
358         bool "Allow use of color to identify file types"
359         default y
360         depends on LS && GETOPT_LONG
361         help
362           This enables the --color option to ls.
363
364 config FEATURE_LS_COLOR_IS_DEFAULT
365         bool "Produce colored ls output by default"
366         default n
367         depends on FEATURE_LS_COLOR
368         help
369           Saying yes here will turn coloring on by default,
370           even if no "--color" option is given to the ls command.
371           This is not recommended, since the colors are not
372           configurable, and the output may not be legible on
373           many output screens.
374
375 config MD5SUM
376         bool "md5sum"
377         default n
378         help
379           md5sum is used to print or check MD5 checksums.
380
381 config MKDIR
382         bool "mkdir"
383         default n
384         help
385           mkdir is used to create directories with the specified names.
386
387 config FEATURE_MKDIR_LONG_OPTIONS
388         bool "Enable long options"
389         default n
390         depends on MKDIR && GETOPT_LONG
391         help
392           Support long options for the mkdir applet.
393
394 config MKFIFO
395         bool "mkfifo"
396         default n
397         help
398           mkfifo is used to create FIFOs (named pipes).
399           The `mknod' program can also create FIFOs.
400
401 config MKNOD
402         bool "mknod"
403         default n
404         help
405           mknod is used to create FIFOs or block/character special
406           files with the specified names.
407
408 config MV
409         bool "mv"
410         default n
411         help
412           mv is used to move or rename files or directories.
413
414 config FEATURE_MV_LONG_OPTIONS
415         bool "Enable long options"
416         default n
417         depends on MV && GETOPT_LONG
418         help
419           Support long options for the mv applet.
420
421 config NICE
422         bool "nice"
423         default n
424         help
425           nice runs a program with modified scheduling priority.
426
427 config NOHUP
428         bool "nohup"
429         default n
430         help
431           run a command immune to hangups, with output to a non-tty.
432
433 config OD
434         bool "od"
435         default n
436         help
437           od is used to dump binary files in octal and other formats.
438
439 config PRINTENV
440         bool "printenv"
441         default n
442         help
443           printenv is used to print all or part of environment.
444
445 config PRINTF
446         bool "printf"
447         default n
448         help
449           printf is used to format and print specified strings.
450           It's similar to `echo' except it has more options.
451
452 config PWD
453         bool "pwd"
454         default n
455         help
456           pwd is used to print the current directory.
457
458 config READLINK
459         bool "readlink"
460         default n
461         help
462           This program reads a symbolic link and returns the name
463           of the file it points to
464
465 config FEATURE_READLINK_FOLLOW
466         bool "Enable canonicalization by following all symlinks (-f)"
467         default n
468         depends on READLINK
469         help
470           Enable the readlink option (-f).
471
472 config REALPATH
473         bool "realpath"
474         default n
475         help
476           Return the canonicalized absolute pathname.
477           This isn't provided by GNU shellutils, but where else does it belong.
478
479 config RM
480         bool "rm"
481         default n
482         help
483           rm is used to remove files or directories.
484
485 config RMDIR
486         bool "rmdir"
487         default n
488         help
489           rmdir is used to remove empty directories.
490
491 config FEATURE_RMDIR_LONG_OPTIONS
492         bool "Enable long options"
493         default n
494         depends on RMDIR && GETOPT_LONG
495         help
496           Support long options for the rmdir applet, including
497           --ignore-fail-on-non-empty for compatibility with GNU rmdir.
498
499 config SEQ
500         bool "seq"
501         default n
502         help
503           print a sequence of numbers
504
505 config SHA1SUM
506         bool "sha1sum"
507         default n
508         help
509           Compute and check SHA1 message digest
510
511 config SLEEP
512         bool "sleep (single integer arg with no suffix)"
513         default n
514         help
515           sleep is used to pause for a specified number of seconds,
516
517 config FEATURE_FANCY_SLEEP
518         bool "Enable multiple integer args and optional time suffixes"
519         default n
520         depends on SLEEP
521         help
522           Allow sleep to pause for specified minutes, hours, and days.
523
524 config SORT
525         bool "sort"
526         default n
527         help
528           sort is used to sort lines of text in specified files.
529
530 config FEATURE_SORT_BIG
531         bool "Full SuSv3 compliant sort (support -ktcsbdfiozgM)"
532         default y
533         depends on SORT
534         help
535           Without this, sort only supports  -r, -u, and an integer version
536           of -n.  Selecting this adds sort keys, floating point support, and
537           more.  This adds a little over 3k to a nonstatic build on x86.
538
539           The SuSv3 sort standard is available at:
540           http://www.opengroup.org/onlinepubs/007904975/utilities/sort.html
541
542 config SPLIT
543         bool "split"
544         default n
545         help
546           split a file into pieces.
547
548 config FEATURE_SPLIT_FANCY
549         bool "Fancy extensions"
550         default n
551         depends on SPLIT
552         help
553           Add support for features not required by SUSv3.
554           Supports additional suffixes 'b' for 512 bytes,
555           'g' for 1GiB for the -b option.
556
557 config STAT
558         bool "stat"
559         default n
560         help
561           display file or filesystem status.
562
563 config FEATURE_STAT_FORMAT
564         bool "Enable custom formats (-c)"
565         default n
566         depends on STAT
567         help
568           Without this, stat will not support the '-c format' option where
569           users can pass a custom format string for output.  This adds about
570           7k to a nonstatic build on amd64.
571
572 config STTY
573         bool "stty"
574         default n
575         help
576           stty is used to change and print terminal line settings.
577
578 config SUM
579         bool "sum"
580         default n
581         help
582           checksum and count the blocks in a file
583
584 config SYNC
585         bool "sync"
586         default n
587         help
588           sync is used to flush filesystem buffers.
589
590 config TAC
591         bool "tac"
592         default n
593         help
594           tac is used to concatenate and print files in reverse.
595
596 config TAIL
597         bool "tail"
598         default n
599         help
600           tail is used to print the last specified number of lines
601           from files.
602
603 config FEATURE_FANCY_TAIL
604         bool "Enable extra tail options (-q, -s, and -v)"
605         default y
606         depends on TAIL
607         help
608           The options (-q, -s, and -v) are provided by GNU tail, but
609           are not specific in the SUSv3 standard.
610
611 config TEE
612         bool "tee"
613         default n
614         help
615           tee is used to read from standard input and write
616           to standard output and files.
617
618 config FEATURE_TEE_USE_BLOCK_IO
619         bool "Enable block I/O (larger/faster) instead of byte I/O"
620         default n
621         depends on TEE
622         help
623           Enable this option for a faster tee, at expense of size.
624
625 config TEST
626         bool "test"
627         default n
628         help
629           test is used to check file types and compare values,
630           returning an appropriate exit code.  The bash shell
631           has test built in, ash can build it in optionally.
632
633 config FEATURE_TEST_64
634         bool "Extend test to 64 bit"
635         default n
636         depends on TEST
637         help
638           Enable 64-bit support in test.
639
640 config TOUCH
641         bool "touch"
642         default n
643         help
644           touch is used to create or change the access and/or
645           modification timestamp of specified files.
646
647 config TR
648         bool "tr"
649         default n
650         help
651           tr is used to squeeze, and/or delete characters from standard
652           input, writing to standard output.
653
654 config FEATURE_TR_CLASSES
655         bool "Enable character classes (such as [:upper:])"
656         default n
657         depends on TR
658         help
659           Enable character classes, enabling commands such as:
660           tr [:upper:] [:lower:] to convert input into lowercase.
661
662 config FEATURE_TR_EQUIV
663         bool "Enable equivalence classes"
664         default n
665         depends on TR
666         help
667           Enable equivalence classes, which essentially add the enclosed
668           character to the current set. For instance, tr [=a=] xyz would
669           replace all instances of 'a' with 'xyz'. This option is mainly
670           useful for cases when no other way of expressing a character
671           is possible.
672
673 config TRUE
674         bool "true"
675         default n
676         help
677           true returns an exit code of TRUE (0).
678
679 config TTY
680         bool "tty"
681         default n
682         help
683           tty is used to print the name of the current terminal to
684           standard output.
685
686 config UNAME
687         bool "uname"
688         default n
689         help
690           uname is used to print system information.
691
692 config UNEXPAND
693         bool "unexpand"
694         default n
695         help
696           By default, convert only leading sequences of blanks to tabs.
697
698 config FEATURE_UNEXPAND_LONG_OPTIONS
699         bool "Enable long options"
700         default n
701         depends on UNEXPAND && GETOPT_LONG
702         help
703           Support long options for the unexpand applet.
704
705 config UNIQ
706         bool "uniq"
707         default n
708         help
709           uniq is used to remove duplicate lines from a sorted file.
710
711 config USLEEP
712         bool "usleep"
713         default n
714         help
715           usleep is used to pause for a specified number of microseconds.
716
717 config UUDECODE
718         bool "uudecode"
719         default n
720         help
721           uudecode is used to decode a uuencoded file.
722
723 config UUENCODE
724         bool "uuencode"
725         default n
726         help
727           uuencode is used to uuencode a file.
728
729 config WC
730         bool "wc"
731         default n
732         help
733           wc is used to print the number of bytes, words, and lines,
734           in specified files.
735
736 config FEATURE_WC_LARGE
737         bool "Support very large files in wc"
738         default n
739         depends on WC
740         help
741           Use "unsigned long long" in wc for count variables
742
743 config WHO
744         bool "who"
745         default n
746         select FEATURE_UTMP
747         help
748           who is used to show who is logged on.
749
750 config WHOAMI
751         bool "whoami"
752         default n
753         help
754           whoami is used to print the username of the current
755           user id (same as id -un).
756
757 config YES
758         bool "yes"
759         default n
760         help
761           yes is used to repeatedly output a specific string, or
762           the default string `y'.
763
764 comment "Common options for cp and mv"
765         depends on CP || MV
766
767 config FEATURE_PRESERVE_HARDLINKS
768         bool "Preserve hard links"
769         default n
770         depends on CP || MV
771         help
772           Allow cp and mv to preserve hard links.
773
774 comment "Common options for ls, more and telnet"
775         depends on LS || MORE || TELNET
776
777 config FEATURE_AUTOWIDTH
778         bool "Calculate terminal & column widths"
779         default y
780         depends on LS || MORE || TELNET
781         help
782           This option allows utilities such as 'ls', 'more' and 'telnet'
783           to determine the width of the screen, which can allow them to
784           display additional text or avoid wrapping text onto the next line.
785           If you leave this disabled, your utilities will be especially
786           primitive and will be unable to determine the current screen width.
787
788 comment "Common options for df, du, ls"
789         depends on DF || DU || LS
790
791 config FEATURE_HUMAN_READABLE
792         bool "Support for human readable output (example 13k, 23M, 235G)"
793         default n
794         depends on DF || DU || LS
795         help
796           Allow df, du, and ls to have human readable output.
797
798 comment "Common options for md5sum, sha1sum"
799         depends on MD5SUM || SHA1SUM
800
801 config FEATURE_MD5_SHA1_SUM_CHECK
802         bool "Enable -c, -s and -w options"
803         default n
804         depends on MD5SUM || SHA1SUM
805         help
806           Enabling the -c options allows files to be checked
807           against pre-calculated hash values.
808
809           -s and -w are useful options when verifying checksums.
810
811 endmenu