9d4a3700a1a11183efaf9ca2bf4e8eab4fcb782c
[openwrt/staging/yousong.git] / package / busybox / config / miscutils / 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 "Miscellaneous Utilities"
7
8 config BUSYBOX_CONFIG_ADJTIMEX
9 bool "adjtimex"
10 default n
11 help
12 Adjtimex reads and optionally sets adjustment parameters for
13 the Linux clock adjustment algorithm.
14
15 config BUSYBOX_CONFIG_BBCONFIG
16 bool "bbconfig"
17 default n
18 help
19 The bbconfig applet will print the config file with which
20 busybox was built.
21
22 config BUSYBOX_CONFIG_BEEP
23 bool "beep"
24 default n
25 help
26 The beep applets beeps in a given freq/Hz.
27
28 config BUSYBOX_CONFIG_FEATURE_BEEP_FREQ
29 int "default frequency"
30 range 0 2147483647
31 default 4000
32 depends on BUSYBOX_CONFIG_BEEP
33 help
34 Frequency for default beep.
35
36 config BUSYBOX_CONFIG_FEATURE_BEEP_LENGTH_MS
37 int "default length"
38 range 0 2147483647
39 default 30
40 depends on BUSYBOX_CONFIG_BEEP
41 help
42 Length in ms for default beep.
43
44 config BUSYBOX_CONFIG_CHAT
45 bool "chat"
46 default n
47 help
48 Simple chat utility.
49
50 config BUSYBOX_CONFIG_FEATURE_CHAT_NOFAIL
51 bool "Enable NOFAIL expect strings"
52 depends on BUSYBOX_CONFIG_CHAT
53 default n
54 help
55 When enabled expect strings which are started with a dash trigger
56 no-fail mode. That is when expectation is not met within timeout
57 the script is not terminated but sends next SEND string and waits
58 for next EXPECT string. This allows to compose far more flexible
59 scripts.
60
61 config BUSYBOX_CONFIG_FEATURE_CHAT_TTY_HIFI
62 bool "Force STDIN to be a TTY"
63 depends on BUSYBOX_CONFIG_CHAT
64 default n
65 help
66 Original chat always treats STDIN as a TTY device and sets for it
67 so-called raw mode. This option turns on such behaviour.
68
69 config BUSYBOX_CONFIG_FEATURE_CHAT_IMPLICIT_CR
70 bool "Enable implicit Carriage Return"
71 depends on BUSYBOX_CONFIG_CHAT
72 default n
73 help
74 When enabled make chat to terminate all SEND strings with a "\r"
75 unless "\c" is met anywhere in the string.
76
77 config BUSYBOX_CONFIG_FEATURE_CHAT_SWALLOW_OPTS
78 bool "Swallow options"
79 depends on BUSYBOX_CONFIG_CHAT
80 default n
81 help
82 Busybox chat require no options. To make it not fail when used
83 in place of original chat (which has a bunch of options) turn
84 this on.
85
86 config BUSYBOX_CONFIG_FEATURE_CHAT_SEND_ESCAPES
87 bool "Support weird SEND escapes"
88 depends on BUSYBOX_CONFIG_CHAT
89 default n
90 help
91 Original chat uses some escape sequences in SEND arguments which
92 are not sent to device but rather performs special actions.
93 E.g. "\K" means to send a break sequence to device.
94 "\d" delays execution for a second, "\p" -- for a 1/100 of second.
95 Before turning this option on think twice: do you really need them?
96
97 config BUSYBOX_CONFIG_FEATURE_CHAT_VAR_ABORT_LEN
98 bool "Support variable-length ABORT conditions"
99 depends on BUSYBOX_CONFIG_CHAT
100 default n
101 help
102 Original chat uses fixed 50-bytes length ABORT conditions. Say N here.
103
104 config BUSYBOX_CONFIG_FEATURE_CHAT_CLR_ABORT
105 bool "Support revoking of ABORT conditions"
106 depends on BUSYBOX_CONFIG_CHAT
107 default n
108 help
109 Support CLR_ABORT directive.
110
111 config BUSYBOX_CONFIG_CHRT
112 bool "chrt"
113 default n
114 help
115 manipulate real-time attributes of a process.
116 This requires sched_{g,s}etparam support in your libc.
117
118 config BUSYBOX_CONFIG_CROND
119 bool "crond"
120 default y
121 select BUSYBOX_CONFIG_FEATURE_SUID
122 select BUSYBOX_CONFIG_FEATURE_SYSLOG
123 help
124 Crond is a background daemon that parses individual crontab
125 files and executes commands on behalf of the users in question.
126 This is a port of dcron from slackware. It uses files of the
127 format /var/spool/cron/crontabs/<username> files, for example:
128 $ cat /var/spool/cron/crontabs/root
129 # Run daily cron jobs at 4:40 every day:
130 40 4 * * * /etc/cron/daily > /dev/null 2>&1
131
132 config BUSYBOX_CONFIG_FEATURE_CROND_D
133 bool "Support option -d to redirect output to stderr"
134 depends on BUSYBOX_CONFIG_CROND
135 default n
136 help
137 -d sets loglevel to 0 (most verbose) and directs all output to stderr.
138
139 config BUSYBOX_CONFIG_FEATURE_CROND_CALL_SENDMAIL
140 bool "Report command output via email (using sendmail)"
141 default n
142 depends on BUSYBOX_CONFIG_CROND
143 help
144 Command output will be sent to corresponding user via email.
145
146 config BUSYBOX_CONFIG_FEATURE_CROND_DIR
147 string "crond spool directory"
148 default "/var/spool/cron"
149 depends on BUSYBOX_CONFIG_CROND || BUSYBOX_CONFIG_CRONTAB
150 help
151 Location of crond spool.
152
153 config BUSYBOX_CONFIG_CRONTAB
154 bool "crontab"
155 default y
156 select BUSYBOX_CONFIG_FEATURE_SUID
157 help
158 Crontab manipulates the crontab for a particular user. Only
159 the superuser may specify a different user and/or crontab directory.
160 Note that Busybox binary must be setuid root for this applet to
161 work properly.
162
163 config BUSYBOX_CONFIG_DC
164 bool "dc"
165 default n
166 help
167 Dc is a reverse-polish desk calculator which supports unlimited
168 precision arithmetic.
169
170 config BUSYBOX_CONFIG_FEATURE_DC_LIBM
171 bool "Enable power and exp functions (requires libm)"
172 default n
173 depends on BUSYBOX_CONFIG_DC
174 help
175 Enable power and exp functions.
176 NOTE: This will require libm to be present for linking.
177
178 config BUSYBOX_CONFIG_DEVFSD
179 bool "devfsd (obsolete)"
180 default n
181 select BUSYBOX_CONFIG_FEATURE_SYSLOG
182 help
183 This is deprecated and should NOT be used anymore.
184 Use linux >= 2.6 (optionally with hotplug) and mdev instead!
185 See docs/mdev.txt for detailed instructions on how to use mdev
186 instead.
187
188 Provides compatibility with old device names on a devfs systems.
189 You should set it to true if you have devfs enabled.
190 The following keywords in devsfd.conf are supported:
191 "CLEAR_CONFIG", "INCLUDE", "OPTIONAL_INCLUDE", "RESTORE",
192 "PERMISSIONS", "EXECUTE", "COPY", "IGNORE",
193 "MKOLDCOMPAT", "MKNEWCOMPAT","RMOLDCOMPAT", "RMNEWCOMPAT".
194
195 But only if they are written UPPERCASE!!!!!!!!
196
197 config BUSYBOX_CONFIG_DEVFSD_MODLOAD
198 bool "Adds support for MODLOAD keyword in devsfd.conf"
199 default n
200 depends on BUSYBOX_CONFIG_DEVFSD
201 help
202 This actually doesn't work with busybox modutils but needs
203 the external modutils.
204
205 config BUSYBOX_CONFIG_DEVFSD_FG_NP
206 bool "Enables the -fg and -np options"
207 default n
208 depends on BUSYBOX_CONFIG_DEVFSD
209 help
210 -fg Run the daemon in the foreground.
211 -np Exit after parsing the configuration file.
212 Do not poll for events.
213
214 config BUSYBOX_CONFIG_DEVFSD_VERBOSE
215 bool "Increases logging (and size)"
216 default n
217 depends on BUSYBOX_CONFIG_DEVFSD
218 help
219 Increases logging to stderr or syslog.
220
221 config BUSYBOX_CONFIG_FEATURE_DEVFS
222 bool "Use devfs names for all devices (obsolete)"
223 default n
224 help
225 This is obsolete and should NOT be used anymore.
226 Use linux >= 2.6 (optionally with hotplug) and mdev instead!
227
228 For legacy systems -- if there is no way around devfsd -- this
229 tells busybox to look for names like /dev/loop/0 instead of
230 /dev/loop0. If your /dev directory has normal names instead of
231 devfs names, you don't want this.
232
233 config BUSYBOX_CONFIG_DEVMEM
234 bool "devmem"
235 default n
236 help
237 devmem is a small program that reads and writes from physical
238 memory using /dev/mem.
239
240 config BUSYBOX_CONFIG_EJECT
241 bool "eject"
242 default n
243 help
244 Used to eject cdroms. (defaults to /dev/cdrom)
245
246 config BUSYBOX_CONFIG_FEATURE_EJECT_SCSI
247 bool "SCSI support"
248 default n
249 depends on BUSYBOX_CONFIG_EJECT
250 help
251 Add the -s option to eject, this allows to eject SCSI-Devices and
252 usb-storage devices.
253
254 config BUSYBOX_CONFIG_FBSPLASH
255 bool "fbsplash"
256 default n
257 help
258 Shows splash image and progress bar on framebuffer device.
259 Can be used during boot phase of an embedded device. ~2kb.
260 Usage:
261 - use kernel option 'vga=xxx' or otherwise enable fb device.
262 - put somewhere fbsplash.cfg file and an image in .ppm format.
263 - $ setsid fbsplash [params] &
264 -c: hide cursor
265 -d /dev/fbN: framebuffer device (if not /dev/fb0)
266 -s path_to_image_file (can be "-" for stdin)
267 -i path_to_cfg_file (can be "-" for stdin)
268 -f path_to_fifo (can be "-" for stdin)
269 - if you want to run it only in presence of kernel parameter:
270 grep -q "fbsplash=on" </proc/cmdline && setsid fbsplash [params] &
271 - commands for fifo:
272 "NN" (ASCII decimal number) - percentage to show on progress bar
273 "exit" - well you guessed it
274
275 config BUSYBOX_CONFIG_FLASHCP
276 bool "flashcp"
277 default n
278 help
279 The flashcp binary, inspired by mtd-utils as of git head 5eceb74f7.
280 This utility is used to copy images into a MTD device.
281
282 config BUSYBOX_CONFIG_FLASH_LOCK
283 bool "flash_lock"
284 default n
285 help
286 The flash_lock binary from mtd-utils as of git head 5ec0c10d0. This
287 utility locks part or all of the flash device.
288
289 config BUSYBOX_CONFIG_FLASH_UNLOCK
290 bool "flash_unlock"
291 default n
292 help
293 The flash_unlock binary from mtd-utils as of git head 5ec0c10d0. This
294 utility unlocks part or all of the flash device.
295
296 config BUSYBOX_CONFIG_FLASH_ERASEALL
297 bool "flash_eraseall"
298 default n
299 help
300 The flash_eraseall binary from mtd-utils as of git head c4c6a59eb.
301 This utility is used to erase the whole MTD device.
302
303 config BUSYBOX_CONFIG_IONICE
304 bool "ionice"
305 default n
306 help
307 Set/set program io scheduling class and priority
308 Requires kernel >= 2.6.13
309
310 config BUSYBOX_CONFIG_INOTIFYD
311 bool "inotifyd"
312 default n
313 help
314 Simple inotify daemon. Reports filesystem changes. Requires
315 kernel >= 2.6.13
316
317 config BUSYBOX_CONFIG_LAST
318 bool "last"
319 default n
320 select BUSYBOX_CONFIG_FEATURE_WTMP
321 help
322 'last' displays a list of the last users that logged into the system.
323
324 choice
325 prompt "Choose last implementation"
326 depends on BUSYBOX_CONFIG_LAST
327 default BUSYBOX_CONFIG_FEATURE_LAST_SMALL
328
329 config BUSYBOX_CONFIG_FEATURE_LAST_SMALL
330 bool "small"
331 help
332 This is a small version of last with just the basic set of
333 features.
334
335 config BUSYBOX_CONFIG_FEATURE_LAST_FANCY
336 bool "huge"
337 help
338 'last' displays detailed information about the last users that
339 logged into the system (mimics sysvinit last). +900 bytes.
340 endchoice
341
342 config BUSYBOX_CONFIG_LESS
343 bool "less"
344 default y
345 help
346 'less' is a pager, meaning that it displays text files. It possesses
347 a wide array of features, and is an improvement over 'more'.
348
349 config BUSYBOX_CONFIG_FEATURE_LESS_MAXLINES
350 int "Max number of input lines less will try to eat"
351 default 9999999
352 depends on BUSYBOX_CONFIG_LESS
353
354 config BUSYBOX_CONFIG_FEATURE_LESS_BRACKETS
355 bool "Enable bracket searching"
356 default n
357 depends on BUSYBOX_CONFIG_LESS
358 help
359 This option adds the capability to search for matching left and right
360 brackets, facilitating programming.
361
362 config BUSYBOX_CONFIG_FEATURE_LESS_FLAGS
363 bool "Enable extra flags"
364 default n
365 depends on BUSYBOX_CONFIG_LESS
366 help
367 The extra flags provided do the following:
368
369 The -M flag enables a more sophisticated status line.
370 The -m flag enables a simpler status line with a percentage.
371
372 config BUSYBOX_CONFIG_FEATURE_LESS_MARKS
373 bool "Enable marks"
374 default n
375 depends on BUSYBOX_CONFIG_LESS
376 help
377 Marks enable positions in a file to be stored for easy reference.
378
379 config BUSYBOX_CONFIG_FEATURE_LESS_REGEXP
380 bool "Enable regular expressions"
381 default n
382 depends on BUSYBOX_CONFIG_LESS
383 help
384 Enable regular expressions, allowing complex file searches.
385
386 config BUSYBOX_CONFIG_FEATURE_LESS_WINCH
387 bool "Enable automatic resizing on window size changes"
388 default n
389 depends on BUSYBOX_CONFIG_LESS
390 help
391 Makes less track window size changes.
392
393 config BUSYBOX_CONFIG_FEATURE_LESS_DASHCMD
394 bool "Enable flag changes ('-' command)"
395 default n
396 depends on BUSYBOX_CONFIG_LESS
397 help
398 This enables the ability to change command-line flags within
399 less itself ('-' keyboard command).
400
401 config BUSYBOX_CONFIG_FEATURE_LESS_LINENUMS
402 bool "Enable dynamic switching of line numbers"
403 default n
404 depends on BUSYBOX_CONFIG_FEATURE_LESS_DASHCMD
405 help
406 Enable "-N" command.
407
408 config BUSYBOX_CONFIG_HDPARM
409 bool "hdparm"
410 default n
411 help
412 Get/Set hard drive parameters. Primarily intended for ATA
413 drives. Adds about 13k (or around 30k if you enable the
414 FEATURE_HDPARM_GET_IDENTITY option)....
415
416 config BUSYBOX_CONFIG_FEATURE_HDPARM_GET_IDENTITY
417 bool "Support obtaining detailed information directly from drives"
418 default n
419 depends on BUSYBOX_CONFIG_HDPARM
420 help
421 Enables the -I and -i options to obtain detailed information
422 directly from drives about their capabilities and supported ATA
423 feature set. If no device name is specified, hdparm will read
424 identify data from stdin. Enabling this option will add about 16k...
425
426 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_SCAN_HWIF
427 bool "Register an IDE interface (DANGEROUS)"
428 default n
429 depends on BUSYBOX_CONFIG_HDPARM
430 help
431 Enables the 'hdparm -R' option to register an IDE interface.
432 This is dangerous stuff, so you should probably say N.
433
434 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_UNREGISTER_HWIF
435 bool "Un-register an IDE interface (DANGEROUS)"
436 default n
437 depends on BUSYBOX_CONFIG_HDPARM
438 help
439 Enables the 'hdparm -U' option to un-register an IDE interface.
440 This is dangerous stuff, so you should probably say N.
441
442 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_DRIVE_RESET
443 bool "Perform device reset (DANGEROUS)"
444 default n
445 depends on BUSYBOX_CONFIG_HDPARM
446 help
447 Enables the 'hdparm -w' option to perform a device reset.
448 This is dangerous stuff, so you should probably say N.
449
450 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_TRISTATE_HWIF
451 bool "Tristate device for hotswap (DANGEROUS)"
452 default n
453 depends on BUSYBOX_CONFIG_HDPARM
454 help
455 Enables the 'hdparm -x' option to tristate device for hotswap,
456 and the '-b' option to get/set bus state. This is dangerous
457 stuff, so you should probably say N.
458
459 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_GETSET_DMA
460 bool "Get/set using_dma flag"
461 default n
462 depends on BUSYBOX_CONFIG_HDPARM
463 help
464 Enables the 'hdparm -d' option to get/set using_dma flag.
465
466 config BUSYBOX_CONFIG_LOCK
467 bool "lock"
468 default y
469 help
470 Small utility for using locks in scripts
471
472 config BUSYBOX_CONFIG_MAKEDEVS
473 bool "makedevs"
474 default n
475 help
476 'makedevs' is a utility used to create a batch of devices with
477 one command.
478 .
479 There are two choices for command line behaviour, the interface
480 as used by LEAF/Linux Router Project, or a device table file.
481 .
482 'leaf' is traditionally what busybox follows, it allows multiple
483 devices of a particluar type to be created per command.
484 e.g. /dev/hda[0-9]
485 Device properties are passed as command line arguments.
486 .
487 'table' reads device properties from a file or stdin, allowing
488 a batch of unrelated devices to be made with one command.
489 User/group names are allowed as an alternative to uid/gid.
490
491 choice
492 prompt "Choose makedevs behaviour"
493 depends on BUSYBOX_CONFIG_MAKEDEVS
494 default BUSYBOX_CONFIG_FEATURE_MAKEDEVS_TABLE
495
496 config BUSYBOX_CONFIG_FEATURE_MAKEDEVS_LEAF
497 bool "leaf"
498
499 config BUSYBOX_CONFIG_FEATURE_MAKEDEVS_TABLE
500 bool "table"
501
502 endchoice
503
504 config BUSYBOX_CONFIG_MAN
505 bool "man"
506 default n
507 help
508 Format and display manual pages.
509
510 config BUSYBOX_CONFIG_MICROCOM
511 bool "microcom"
512 default n
513 help
514 The poor man's minicom utility for chatting with serial port devices.
515
516 config BUSYBOX_CONFIG_MOUNTPOINT
517 bool "mountpoint"
518 default n
519 help
520 mountpoint checks if the directory is a mountpoint.
521
522 config BUSYBOX_CONFIG_MT
523 bool "mt"
524 default n
525 help
526 mt is used to control tape devices. You can use the mt utility
527 to advance or rewind a tape past a specified number of archive
528 files on the tape.
529
530 config BUSYBOX_CONFIG_RAIDAUTORUN
531 bool "raidautorun"
532 default n
533 help
534 raidautorun tells the kernel md driver to
535 search and start RAID arrays.
536
537 config BUSYBOX_CONFIG_READAHEAD
538 bool "readahead"
539 default n
540 depends on BUSYBOX_CONFIG_LFS
541 help
542 Preload the files listed on the command line into RAM cache so that
543 subsequent reads on these files will not block on disk I/O.
544
545 This applet just calls the readahead(2) system call on each file.
546 It is mainly useful in system startup scripts to preload files
547 or executables before they are used. When used at the right time
548 (in particular when a CPU bound process is running) it can
549 significantly speed up system startup.
550
551 As readahead(2) blocks until each file has been read, it is best to
552 run this applet as a background job.
553
554 config BUSYBOX_CONFIG_RUNLEVEL
555 bool "runlevel"
556 default n
557 help
558 find the current and previous system runlevel.
559
560 This applet uses utmp but does not rely on busybox supporing
561 utmp on purpose. It is used by e.g. emdebian via /etc/init.d/rc.
562
563 config BUSYBOX_CONFIG_RX
564 bool "rx"
565 default n
566 help
567 Receive files using the Xmodem protocol.
568
569 config BUSYBOX_CONFIG_SETSID
570 bool "setsid"
571 default n
572 help
573 setsid runs a program in a new session
574
575 config BUSYBOX_CONFIG_STRINGS
576 bool "strings"
577 default y
578 help
579 strings prints the printable character sequences for each file
580 specified.
581
582 config BUSYBOX_CONFIG_TASKSET
583 bool "taskset"
584 default n
585 help
586 Retrieve or set a processes's CPU affinity.
587 This requires sched_{g,s}etaffinity support in your libc.
588
589 config BUSYBOX_CONFIG_FEATURE_TASKSET_FANCY
590 bool "Fancy output"
591 default n
592 depends on BUSYBOX_CONFIG_TASKSET
593 help
594 Add code for fancy output. This merely silences a compiler-warning
595 and adds about 135 Bytes. May be needed for machines with alot
596 of CPUs.
597
598 config BUSYBOX_CONFIG_TIME
599 bool "time"
600 default y
601 help
602 The time command runs the specified program with the given arguments.
603 When the command finishes, time writes a message to standard output
604 giving timing statistics about this program run.
605
606 config BUSYBOX_CONFIG_TIMEOUT
607 bool "timeout"
608 default n
609 help
610 Runs a program and watches it. If it does not terminate in
611 specified number of seconds, it is sent a signal.
612
613 config BUSYBOX_CONFIG_TTYSIZE
614 bool "ttysize"
615 default n
616 help
617 A replacement for "stty size". Unlike stty, can report only width,
618 only height, or both, in any order. It also does not complain on
619 error, but returns default 80x24.
620 Usage in shell scripts: width=`ttysize w`.
621
622 config BUSYBOX_CONFIG_VOLNAME
623 bool "volname"
624 default n
625 help
626 Prints a CD-ROM volume name.
627
628 config BUSYBOX_CONFIG_WALL
629 bool "wall"
630 default n
631 help
632 Write a message to all users that are logged in.
633
634 config BUSYBOX_CONFIG_WATCHDOG
635 bool "watchdog"
636 default y
637 help
638 The watchdog utility is used with hardware or software watchdog
639 device drivers. It opens the specified watchdog device special file
640 and periodically writes a magic character to the device. If the
641 watchdog applet ever fails to write the magic character within a
642 certain amount of time, the watchdog device assumes the system has
643 hung, and will cause the hardware to reboot.
644
645 endmenu