1a3ef990cfc5a138773087a8f9845624762dd751
[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_CHGRP
30         bool "chgrp"
31         default y
32         help
33           chgrp is used to change the group ownership of files.
34
35 config BUSYBOX_CONFIG_CHMOD
36         bool "chmod"
37         default y
38         help
39           chmod is used to change the access permission of files.
40
41 config BUSYBOX_CONFIG_CHOWN
42         bool "chown"
43         default y
44         help
45           chown is used to change the user and/or group ownership
46           of files.
47
48 config BUSYBOX_CONFIG_CHROOT
49         bool "chroot"
50         default y
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 BUSYBOX_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 BUSYBOX_CONFIG_CP
63         bool "cp"
64         default y
65         help
66           cp is used to copy files and directories.
67
68 config BUSYBOX_CONFIG_CUT
69         bool "cut"
70         default y
71         help
72           cut is used to print selected parts of lines from
73           each file to stdout.
74
75 if BUSYBOX_CONFIG_WATCH
76         config BUSYBOX_CONFIG_DATE
77                 default y
78         comment "date (forced enabled for use with watch)"
79 endif
80
81 if !CONFIG_WATCH
82     config BUSYBOX_CONFIG_DATE
83             bool "date"
84             default y
85             help
86               date is used to set the system date or display the
87               current time in the given format.
88 endif
89
90 config BUSYBOX_CONFIG_FEATURE_DATE_ISOFMT
91         bool "  Enable ISO date format output (-I)"
92         default y
93         depends on BUSYBOX_CONFIG_DATE
94         help
95           Enable option (-I) to output an ISO-8601 compliant
96           date/time string.
97
98 config BUSYBOX_CONFIG_DD
99         bool "dd"
100         default y
101         help
102           dd copies a file (from standard input to standard output,
103           by default) using specific input and output blocksizes,
104           while optionally performing conversions on it.
105
106 config BUSYBOX_CONFIG_DF
107         bool "df"
108         default y
109         help
110           df reports the amount of disk space used and available
111           on filesystems.
112
113 config BUSYBOX_CONFIG_DIRNAME
114         bool "dirname"
115         default n
116         help
117           dirname is used to strip a non-directory suffix from
118           a file name.
119
120 config BUSYBOX_CONFIG_DOS2UNIX
121         bool "dos2unix/unix2dos"
122         default n
123         help
124           dos2unix is used to convert a text file from DOS format to
125           UNIX format, and vice versa.
126
127 config BUSYBOX_CONFIG_UNIX2DOS
128         bool
129         default n
130         depends on BUSYBOX_CONFIG_DOS2UNIX
131
132 config BUSYBOX_CONFIG_DU
133         bool "du (default blocksize of 512 bytes)"
134         default y
135         help
136           du is used to report the amount of disk space used
137           for specified files.
138
139 config BUSYBOX_CONFIG_FEATURE_DU_DEFALT_BLOCKSIZE_1K
140         bool "  Use a default blocksize of 1024 bytes (1K)"
141         default y
142         depends on BUSYBOX_CONFIG_DU
143         help
144           Use a blocksize of (1K) instead of the default 512b.
145
146 config BUSYBOX_CONFIG_ECHO
147         bool "echo (basic SUSv3 version taking no options)"
148         default y
149         help
150           echo is used to print a specified string to stdout.
151
152 config BUSYBOX_CONFIG_FEATURE_FANCY_ECHO
153         bool "  Enable echo options (-n and -e)"
154         default y
155         depends on BUSYBOX_CONFIG_ECHO
156         help
157           This adds options (-n and -e) to echo.
158
159 config BUSYBOX_CONFIG_ENV
160         bool "env"
161         default y
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 BUSYBOX_CONFIG_EXPR
168         bool "expr"
169         default y
170         help
171           expr is used to calculate numbers and print the result
172           to standard output.
173
174 if BUSYBOX_CONFIG_HUSH || BUSYBOX_CONFIG_LASH || BUSYBOX_CONFIG_MSH
175         config BUSYBOX_CONFIG_FALSE
176                 default y
177         comment "false (forced enabled for use with shell)"
178 endif
179
180 if !CONFIG_HUSH && !CONFIG_LASH && !CONFIG_MSH
181     config BUSYBOX_CONFIG_FALSE
182             bool "false"
183             default y
184             help
185               false returns an exit code of FALSE (1).
186 endif
187
188 config BUSYBOX_CONFIG_FOLD
189         bool "fold"
190         default n
191         help
192           Wrap text to fit a specific width.
193
194 config BUSYBOX_CONFIG_HEAD
195         bool "head"
196         default y
197         help
198           head is used to print the first specified number of lines
199           from files.
200
201 config BUSYBOX_CONFIG_FEATURE_FANCY_HEAD
202         bool "  Enable head options (-c, -q, and -v)"
203         default y
204         depends on BUSYBOX_CONFIG_HEAD
205         help
206           This enables the head options (-c, -q, and -v).
207
208 config BUSYBOX_CONFIG_HOSTID
209         bool "hostid"
210         default y
211         help
212           hostid prints the numeric identifier (in hexadecimal) for
213           the current host.
214
215 config BUSYBOX_CONFIG_ID
216         bool "id"
217         default n
218         help
219           id displays the current user and group ID names.
220
221 config BUSYBOX_CONFIG_INSTALL
222         bool "install"
223         default n
224         help
225           Copy files and set attributes.
226
227 config BUSYBOX_CONFIG_LENGTH
228         bool "length"
229         default y
230         help
231           length is used to print out the length of a specified string.
232
233 config BUSYBOX_CONFIG_LN
234         bool "ln"
235         default y
236         help
237           ln is used to create hard or soft links between files.
238
239 config BUSYBOX_CONFIG_LOGNAME
240         bool "logname"
241         default n
242         help
243           logname is used to print the current user's login name.
244
245 config BUSYBOX_CONFIG_LS
246         bool "ls"
247         default y
248         help
249           ls is used to list the contents of directories.
250
251 config BUSYBOX_CONFIG_FEATURE_LS_FILETYPES
252         bool "  Enable filetyping options (-p and -F)"
253         default y
254         depends on BUSYBOX_CONFIG_LS
255         help
256           Enable the ls options (-p and -F).
257
258 config BUSYBOX_CONFIG_FEATURE_LS_FOLLOWLINKS
259         bool "  Enable symlinks dereferencing (-L)"
260         default y
261         depends on BUSYBOX_CONFIG_LS
262         help
263           Enable the ls option (-L).
264
265 config BUSYBOX_CONFIG_FEATURE_LS_RECURSIVE
266         bool "  Enable recursion (-R)"
267         default y
268         depends on BUSYBOX_CONFIG_LS
269         help
270           Enable the ls option (-R).
271
272 config BUSYBOX_CONFIG_FEATURE_LS_SORTFILES
273         bool "  Sort the file names"
274         default y
275         depends on BUSYBOX_CONFIG_LS
276         help
277           Allow ls to sort file names alphabetically.
278
279 config BUSYBOX_CONFIG_FEATURE_LS_TIMESTAMPS
280         bool "  Show file timestamps"
281         default y
282         depends on BUSYBOX_CONFIG_LS
283         help
284           Allow ls to display timestamps for files.
285
286 config BUSYBOX_CONFIG_FEATURE_LS_USERNAME
287         bool "  Show username/groupnames"
288         default y
289         depends on BUSYBOX_CONFIG_LS
290         help
291           Allow ls to display username/groupname for files.
292
293 config BUSYBOX_CONFIG_FEATURE_LS_COLOR
294         bool "  Use color to identify file types"
295         default y
296         depends on BUSYBOX_CONFIG_LS
297         help
298           Allow ls to use color when displaying files.
299
300 config BUSYBOX_CONFIG_MD5SUM
301         bool "md5sum"
302         default y
303         help
304           md5sum is used to print or check MD5 checksums.
305
306 config BUSYBOX_CONFIG_MKDIR
307         bool "mkdir"
308         default y
309         help
310           mkdir is used to create directories with the specified names.
311
312 config BUSYBOX_CONFIG_MKFIFO
313         bool "mkfifo"
314         default y
315         help
316           mkfifo is used to create FIFOs (named pipes).
317           The `mknod' program can also create FIFOs.
318
319 config BUSYBOX_CONFIG_MKNOD
320         bool "mknod"
321         default n
322         help
323           mknod is used to create FIFOs or block/character special
324           files with the specified names.
325
326 config BUSYBOX_CONFIG_MV
327         bool "mv"
328         default y
329         help
330           mv is used to move or rename files or directories.
331
332 config BUSYBOX_CONFIG_OD
333         bool "od"
334         default n
335         help
336           od is used to dump binary files in octal and other formats.
337
338 config BUSYBOX_CONFIG_PRINTF
339         bool "printf"
340         default n
341         help
342           printf is used to format and print specified strings.
343           It's similar to `echo' except it has more options.
344
345 config BUSYBOX_CONFIG_PWD
346         bool "pwd"
347         default y
348         help
349           pwd is used to print the current directory.
350
351 config BUSYBOX_CONFIG_REALPATH
352         bool "realpath"
353         default n
354         help
355           Return the canonicalized absolute pathname.
356           This isn't provided by GNU shellutils, but where else does it belong.
357
358 config BUSYBOX_CONFIG_RM
359         bool "rm"
360         default y
361         help
362           rm is used to remove files or directories.
363
364 config BUSYBOX_CONFIG_RMDIR
365         bool "rmdir"
366         default y
367         help
368           rmdir is used to remove empty directories.
369
370 config BUSYBOX_CONFIG_SEQ
371         bool "seq"
372         default n
373         help
374           print a sequence of numbers
375
376 config BUSYBOX_CONFIG_SHA1SUM
377         bool "sha1sum"
378         default n
379         help
380           Compute and check SHA1 message digest
381
382 config BUSYBOX_CONFIG_SLEEP
383         bool "sleep (single integer arg with no suffix)"
384         default y
385         help
386           sleep is used to pause for a specified number of seconds,
387
388 config BUSYBOX_CONFIG_FEATURE_FANCY_SLEEP
389         bool "  Enable multiple integer args and optional time suffixes"
390         default y
391         depends on BUSYBOX_CONFIG_SLEEP
392         help
393           Allow sleep to pause for specified minutes, hours, and days.
394
395 config BUSYBOX_CONFIG_SORT
396         bool "sort"
397         default y
398         help
399           sort is used to sort lines of text in specified files.
400
401 config BUSYBOX_CONFIG_STTY
402         bool "stty"
403         default n
404         help
405           stty is used to change and print terminal line settings.
406
407 config BUSYBOX_CONFIG_SYNC
408         bool "sync"
409         default y
410         help
411           sync is used to flush filesystem buffers.
412
413 config BUSYBOX_CONFIG_TAIL
414         bool "tail"
415         default y
416         help
417           tail is used to print the last specified number of lines
418           from files.
419
420 config BUSYBOX_CONFIG_FEATURE_FANCY_TAIL
421         bool "  Enable extra tail options (-q, -s, and -v)"
422         default y
423         depends on BUSYBOX_CONFIG_TAIL
424         help
425           The options (-q, -s, and -v) are provided by GNU tail, but
426           are not specific in the SUSv3 standard.
427
428 config BUSYBOX_CONFIG_TEE
429         bool "tee"
430         default y
431         help
432           tee is used to read from standard input and write
433           to standard output and files.
434
435 config BUSYBOX_CONFIG_FEATURE_TEE_USE_BLOCK_IO
436         bool "  Enable block i/o (larger/faster) instead of byte i/o."
437         default y
438         depends on BUSYBOX_CONFIG_TEE
439         help
440           Enable this option for a faster tee, at expense of size.
441
442 if BUSYBOX_CONFIG_ASH || BUSYBOX_CONFIG_HUSH || BUSYBOX_CONFIG_LASH || BUSYBOX_CONFIG_MSH
443         config BUSYBOX_CONFIG_TEST
444                 default y
445         comment "test (forced enabled for use with shell)"
446 endif
447
448 if !CONFIG_ASH && !CONFIG_HUSH && !CONFIG_LASH && !CONFIG_MSH
449     config BUSYBOX_CONFIG_TEST
450             bool "test"
451             default y
452             help
453               test is used to check file types and compare values,
454               returning an appropriate exit code. The shells (ash
455               and bash) have test builtin.
456 endif
457
458 config BUSYBOX_CONFIG_FEATURE_TEST_64
459         bool "  Extend test to 64 bit"
460         default n
461         depends on BUSYBOX_CONFIG_TEST
462         help
463           Enable 64-bit support in test.
464
465 config BUSYBOX_CONFIG_TOUCH
466         bool "touch"
467         default y
468         help
469           touch is used to create or change the access and/or
470           modification timestamp of specified files.
471
472 config BUSYBOX_CONFIG_TR
473         bool "tr"
474         default y
475         help
476           tr is used to squeeze, and/or delete characters from standard
477           input, writing to standard output.
478
479 if BUSYBOX_CONFIG_HUSH || BUSYBOX_CONFIG_LASH || BUSYBOX_CONFIG_MSH
480         config BUSYBOX_CONFIG_TRUE
481                 default y
482         comment "true (forced enabled for use with shell)"
483 endif
484
485 if !CONFIG_HUSH && !CONFIG_LASH && !CONFIG_MSH
486     config BUSYBOX_CONFIG_TRUE
487             bool "true"
488             default y
489             help
490               true returns an exit code of TRUE (0).
491
492 endif
493
494 config BUSYBOX_CONFIG_TTY
495         bool "tty"
496         default n
497         help
498           tty is used to print the name of the current terminal to
499           standard output.
500
501 config BUSYBOX_CONFIG_UNAME
502         bool "uname"
503         default y
504         help
505           uname is used to print system information.
506
507 config BUSYBOX_CONFIG_UNIQ
508         bool "uniq"
509         default y
510         help
511           uniq is used to remove duplicate lines from a sorted file.
512
513 config BUSYBOX_CONFIG_USLEEP
514         bool "usleep"
515         default n
516         help
517           usleep is used to pause for a specified number of microseconds.
518
519 config BUSYBOX_CONFIG_UUDECODE
520         bool "uudecode"
521         default n
522         help
523           uudecode is used to decode a uuencoded file.
524
525 config BUSYBOX_CONFIG_UUENCODE
526         bool "uuencode"
527         default n
528         help
529           uuencode is used to uuencode a file.
530
531 config BUSYBOX_CONFIG_WATCH
532         bool "watch"
533         default n
534         help
535           watch is used to execute a program periodically, showing
536           output to the screen.
537
538 config BUSYBOX_CONFIG_WC
539         bool "wc"
540         default y
541         help
542           wc is used to print the number of bytes, words, and lines,
543           in specified files.
544
545 config BUSYBOX_CONFIG_WHO
546         bool "who"
547         default n
548         select BUSYBOX_CONFIG_FEATURE_U_W_TMP
549         help
550           who is used to show who is logged on.
551
552 config BUSYBOX_CONFIG_WHOAMI
553         bool "whoami"
554         default n
555         help
556           whoami is used to print the username of the current
557           user id (same as id -un).
558
559 config BUSYBOX_CONFIG_YES
560         bool "yes"
561         default y
562         help
563           yes is used to repeatedly output a specific string, or
564           the default string `y'.
565
566 comment "Common options for cp and mv"
567     depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
568
569 config BUSYBOX_CONFIG_FEATURE_PRESERVE_HARDLINKS
570         bool "  Preserve hard links"
571         default y
572         depends on BUSYBOX_CONFIG_CP || BUSYBOX_CONFIG_MV
573         help
574           Allow cp and mv to preserve hard links.
575
576 comment "Common options for ls and more"
577         depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE
578
579 config BUSYBOX_CONFIG_FEATURE_AUTOWIDTH
580         bool "  Calculate terminal & column widths"
581         default y
582         depends on BUSYBOX_CONFIG_LS || BUSYBOX_CONFIG_MORE
583         help
584           This option allows utilities such as 'ls' and 'more' to determine the
585           width of the screen, which can allow them to display additional text
586           or avoid wrapping text onto the next line.  If you leave this
587           disabled, your utilities will be especially primitive and will be
588           unable to determine the current screen width.
589
590 comment "Common options for df, du, ls"
591     depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
592
593 config BUSYBOX_CONFIG_FEATURE_HUMAN_READABLE
594         bool "  Support for human readable output (example 13k, 23M, 235G)"
595         default y
596         depends on BUSYBOX_CONFIG_DF || BUSYBOX_CONFIG_DU || BUSYBOX_CONFIG_LS
597         help
598           Allow df, du, and ls to have human readable output.
599
600 comment "Common options for md5sum, sha1sum"
601     depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM
602
603 config BUSYBOX_CONFIG_FEATURE_MD5_SHA1_SUM_CHECK
604         bool "  Enable -c, -s and -w options"
605         default y
606         depends on BUSYBOX_CONFIG_MD5SUM || BUSYBOX_CONFIG_SHA1SUM
607         help
608           Enabling the -c options allows files to be checked
609           against pre-calculated hash values.
610
611           -s and -w are useful options when verifying checksums.
612
613 endmenu