2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
6 menu "Miscellaneous Utilities"
8 config BUSYBOX_CONFIG_CONSPY
12 A text-mode VNC like program for Linux virtual terminals.
13 example: conspy NUM shared access to console num
14 or conspy -nd NUM screenshot of console num
15 or conspy -cs NUM poor man's GNU screen like
17 config BUSYBOX_CONFIG_UBIATTACH
21 Attach MTD device to an UBI device.
23 config BUSYBOX_CONFIG_UBIDETACH
27 Detach MTD device from an UBI device.
29 config BUSYBOX_CONFIG_ADJTIMEX
33 Adjtimex reads and optionally sets adjustment parameters for
34 the Linux clock adjustment algorithm.
36 config BUSYBOX_CONFIG_BBCONFIG
40 The bbconfig applet will print the config file with which
43 config BUSYBOX_CONFIG_BEEP
47 The beep applets beeps in a given freq/Hz.
49 config BUSYBOX_CONFIG_FEATURE_BEEP_FREQ
50 int "default frequency"
53 depends on BUSYBOX_CONFIG_BEEP
55 Frequency for default beep.
57 config BUSYBOX_CONFIG_FEATURE_BEEP_LENGTH_MS
61 depends on BUSYBOX_CONFIG_BEEP
63 Length in ms for default beep.
65 config BUSYBOX_CONFIG_CHAT
71 config BUSYBOX_CONFIG_FEATURE_CHAT_NOFAIL
72 bool "Enable NOFAIL expect strings"
73 depends on BUSYBOX_CONFIG_CHAT
76 When enabled expect strings which are started with a dash trigger
77 no-fail mode. That is when expectation is not met within timeout
78 the script is not terminated but sends next SEND string and waits
79 for next EXPECT string. This allows to compose far more flexible
82 config BUSYBOX_CONFIG_FEATURE_CHAT_TTY_HIFI
83 bool "Force STDIN to be a TTY"
84 depends on BUSYBOX_CONFIG_CHAT
87 Original chat always treats STDIN as a TTY device and sets for it
88 so-called raw mode. This option turns on such behaviour.
90 config BUSYBOX_CONFIG_FEATURE_CHAT_IMPLICIT_CR
91 bool "Enable implicit Carriage Return"
92 depends on BUSYBOX_CONFIG_CHAT
95 When enabled make chat to terminate all SEND strings with a "\r"
96 unless "\c" is met anywhere in the string.
98 config BUSYBOX_CONFIG_FEATURE_CHAT_SWALLOW_OPTS
99 bool "Swallow options"
100 depends on BUSYBOX_CONFIG_CHAT
103 Busybox chat require no options. To make it not fail when used
104 in place of original chat (which has a bunch of options) turn
107 config BUSYBOX_CONFIG_FEATURE_CHAT_SEND_ESCAPES
108 bool "Support weird SEND escapes"
109 depends on BUSYBOX_CONFIG_CHAT
112 Original chat uses some escape sequences in SEND arguments which
113 are not sent to device but rather performs special actions.
114 E.g. "\K" means to send a break sequence to device.
115 "\d" delays execution for a second, "\p" -- for a 1/100 of second.
116 Before turning this option on think twice: do you really need them?
118 config BUSYBOX_CONFIG_FEATURE_CHAT_VAR_ABORT_LEN
119 bool "Support variable-length ABORT conditions"
120 depends on BUSYBOX_CONFIG_CHAT
123 Original chat uses fixed 50-bytes length ABORT conditions. Say N here.
125 config BUSYBOX_CONFIG_FEATURE_CHAT_CLR_ABORT
126 bool "Support revoking of ABORT conditions"
127 depends on BUSYBOX_CONFIG_CHAT
130 Support CLR_ABORT directive.
132 config BUSYBOX_CONFIG_CHRT
136 manipulate real-time attributes of a process.
137 This requires sched_{g,s}etparam support in your libc.
139 config BUSYBOX_CONFIG_CROND
142 select BUSYBOX_CONFIG_FEATURE_SUID
143 select BUSYBOX_CONFIG_FEATURE_SYSLOG
145 Crond is a background daemon that parses individual crontab
146 files and executes commands on behalf of the users in question.
147 This is a port of dcron from slackware. It uses files of the
148 format /var/spool/cron/crontabs/<username> files, for example:
149 $ cat /var/spool/cron/crontabs/root
150 # Run daily cron jobs at 4:40 every day:
151 40 4 * * * /etc/cron/daily > /dev/null 2>&1
153 config BUSYBOX_CONFIG_FEATURE_CROND_D
154 bool "Support option -d to redirect output to stderr"
155 depends on BUSYBOX_CONFIG_CROND
158 -d sets loglevel to 0 (most verbose) and directs all output to stderr.
160 config BUSYBOX_CONFIG_FEATURE_CROND_CALL_SENDMAIL
161 bool "Report command output via email (using sendmail)"
163 depends on BUSYBOX_CONFIG_CROND
165 Command output will be sent to corresponding user via email.
167 config BUSYBOX_CONFIG_FEATURE_CROND_DIR
168 string "crond spool directory"
169 default "/var/spool/cron"
170 depends on BUSYBOX_CONFIG_CROND || BUSYBOX_CONFIG_CRONTAB
172 Location of crond spool.
174 config BUSYBOX_CONFIG_CRONTAB
177 select BUSYBOX_CONFIG_FEATURE_SUID
179 Crontab manipulates the crontab for a particular user. Only
180 the superuser may specify a different user and/or crontab directory.
181 Note that Busybox binary must be setuid root for this applet to
184 config BUSYBOX_CONFIG_DC
188 Dc is a reverse-polish desk calculator which supports unlimited
189 precision arithmetic.
191 config BUSYBOX_CONFIG_FEATURE_DC_LIBM
192 bool "Enable power and exp functions (requires libm)"
194 depends on BUSYBOX_CONFIG_DC
196 Enable power and exp functions.
197 NOTE: This will require libm to be present for linking.
199 config BUSYBOX_CONFIG_DEVFSD
200 bool "devfsd (obsolete)"
202 select BUSYBOX_CONFIG_FEATURE_SYSLOG
204 This is deprecated and should NOT be used anymore.
205 Use linux >= 2.6 (optionally with hotplug) and mdev instead!
206 See docs/mdev.txt for detailed instructions on how to use mdev
209 Provides compatibility with old device names on a devfs systems.
210 You should set it to true if you have devfs enabled.
211 The following keywords in devsfd.conf are supported:
212 "CLEAR_CONFIG", "INCLUDE", "OPTIONAL_INCLUDE", "RESTORE",
213 "PERMISSIONS", "EXECUTE", "COPY", "IGNORE",
214 "MKOLDCOMPAT", "MKNEWCOMPAT","RMOLDCOMPAT", "RMNEWCOMPAT".
216 But only if they are written UPPERCASE!!!!!!!!
218 config BUSYBOX_CONFIG_DEVFSD_MODLOAD
219 bool "Adds support for MODLOAD keyword in devsfd.conf"
221 depends on BUSYBOX_CONFIG_DEVFSD
223 This actually doesn't work with busybox modutils but needs
224 the external modutils.
226 config BUSYBOX_CONFIG_DEVFSD_FG_NP
227 bool "Enables the -fg and -np options"
229 depends on BUSYBOX_CONFIG_DEVFSD
231 -fg Run the daemon in the foreground.
232 -np Exit after parsing the configuration file.
233 Do not poll for events.
235 config BUSYBOX_CONFIG_DEVFSD_VERBOSE
236 bool "Increases logging (and size)"
238 depends on BUSYBOX_CONFIG_DEVFSD
240 Increases logging to stderr or syslog.
242 config BUSYBOX_CONFIG_FEATURE_DEVFS
243 bool "Use devfs names for all devices (obsolete)"
246 This is obsolete and should NOT be used anymore.
247 Use linux >= 2.6 (optionally with hotplug) and mdev instead!
249 For legacy systems -- if there is no way around devfsd -- this
250 tells busybox to look for names like /dev/loop/0 instead of
251 /dev/loop0. If your /dev directory has normal names instead of
252 devfs names, you don't want this.
254 config BUSYBOX_CONFIG_DEVMEM
258 devmem is a small program that reads and writes from physical
259 memory using /dev/mem.
261 config BUSYBOX_CONFIG_EJECT
265 Used to eject cdroms. (defaults to /dev/cdrom)
267 config BUSYBOX_CONFIG_FEATURE_EJECT_SCSI
270 depends on BUSYBOX_CONFIG_EJECT
272 Add the -s option to eject, this allows to eject SCSI-Devices and
275 config BUSYBOX_CONFIG_FBSPLASH
279 Shows splash image and progress bar on framebuffer device.
280 Can be used during boot phase of an embedded device. ~2kb.
282 - use kernel option 'vga=xxx' or otherwise enable fb device.
283 - put somewhere fbsplash.cfg file and an image in .ppm format.
284 - $ setsid fbsplash [params] &
286 -d /dev/fbN: framebuffer device (if not /dev/fb0)
287 -s path_to_image_file (can be "-" for stdin)
288 -i path_to_cfg_file (can be "-" for stdin)
289 -f path_to_fifo (can be "-" for stdin)
290 - if you want to run it only in presence of kernel parameter:
291 grep -q "fbsplash=on" </proc/cmdline && setsid fbsplash [params] &
293 "NN" (ASCII decimal number) - percentage to show on progress bar
294 "exit" - well you guessed it
296 config BUSYBOX_CONFIG_FLASHCP
300 The flashcp binary, inspired by mtd-utils as of git head 5eceb74f7.
301 This utility is used to copy images into a MTD device.
303 config BUSYBOX_CONFIG_FLASH_LOCK
307 The flash_lock binary from mtd-utils as of git head 5ec0c10d0. This
308 utility locks part or all of the flash device.
310 config BUSYBOX_CONFIG_FLASH_UNLOCK
314 The flash_unlock binary from mtd-utils as of git head 5ec0c10d0. This
315 utility unlocks part or all of the flash device.
317 config BUSYBOX_CONFIG_FLASH_ERASEALL
318 bool "flash_eraseall"
321 The flash_eraseall binary from mtd-utils as of git head c4c6a59eb.
322 This utility is used to erase the whole MTD device.
324 config BUSYBOX_CONFIG_IONICE
328 Set/set program io scheduling class and priority
329 Requires kernel >= 2.6.13
331 config BUSYBOX_CONFIG_INOTIFYD
335 Simple inotify daemon. Reports filesystem changes. Requires
338 config BUSYBOX_CONFIG_LAST
341 depends on BUSYBOX_CONFIG_FEATURE_WTMP
343 'last' displays a list of the last users that logged into the system.
346 prompt "Choose last implementation"
347 depends on BUSYBOX_CONFIG_LAST
348 default BUSYBOX_CONFIG_FEATURE_LAST_FANCY
350 config BUSYBOX_CONFIG_FEATURE_LAST_SMALL
353 This is a small version of last with just the basic set of
356 config BUSYBOX_CONFIG_FEATURE_LAST_FANCY
359 'last' displays detailed information about the last users that
360 logged into the system (mimics sysvinit last). +900 bytes.
363 config BUSYBOX_CONFIG_LESS
367 'less' is a pager, meaning that it displays text files. It possesses
368 a wide array of features, and is an improvement over 'more'.
370 config BUSYBOX_CONFIG_FEATURE_LESS_MAXLINES
371 int "Max number of input lines less will try to eat"
373 depends on BUSYBOX_CONFIG_LESS
375 config BUSYBOX_CONFIG_FEATURE_LESS_BRACKETS
376 bool "Enable bracket searching"
378 depends on BUSYBOX_CONFIG_LESS
380 This option adds the capability to search for matching left and right
381 brackets, facilitating programming.
383 config BUSYBOX_CONFIG_FEATURE_LESS_FLAGS
384 bool "Enable extra flags"
386 depends on BUSYBOX_CONFIG_LESS
388 The extra flags provided do the following:
390 The -M flag enables a more sophisticated status line.
391 The -m flag enables a simpler status line with a percentage.
393 config BUSYBOX_CONFIG_FEATURE_LESS_MARKS
396 depends on BUSYBOX_CONFIG_LESS
398 Marks enable positions in a file to be stored for easy reference.
400 config BUSYBOX_CONFIG_FEATURE_LESS_REGEXP
401 bool "Enable regular expressions"
403 depends on BUSYBOX_CONFIG_LESS
405 Enable regular expressions, allowing complex file searches.
407 config BUSYBOX_CONFIG_FEATURE_LESS_WINCH
408 bool "Enable automatic resizing on window size changes"
410 depends on BUSYBOX_CONFIG_LESS
412 Makes less track window size changes.
414 config BUSYBOX_CONFIG_FEATURE_LESS_DASHCMD
415 bool "Enable flag changes ('-' command)"
417 depends on BUSYBOX_CONFIG_LESS
419 This enables the ability to change command-line flags within
420 less itself ('-' keyboard command).
422 config BUSYBOX_CONFIG_FEATURE_LESS_LINENUMS
423 bool "Enable dynamic switching of line numbers"
425 depends on BUSYBOX_CONFIG_FEATURE_LESS_DASHCMD
429 config BUSYBOX_CONFIG_HDPARM
433 Get/Set hard drive parameters. Primarily intended for ATA
434 drives. Adds about 13k (or around 30k if you enable the
435 FEATURE_HDPARM_GET_IDENTITY option)....
437 config BUSYBOX_CONFIG_FEATURE_HDPARM_GET_IDENTITY
438 bool "Support obtaining detailed information directly from drives"
440 depends on BUSYBOX_CONFIG_HDPARM
442 Enables the -I and -i options to obtain detailed information
443 directly from drives about their capabilities and supported ATA
444 feature set. If no device name is specified, hdparm will read
445 identify data from stdin. Enabling this option will add about 16k...
447 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_SCAN_HWIF
448 bool "Register an IDE interface (DANGEROUS)"
450 depends on BUSYBOX_CONFIG_HDPARM
452 Enables the 'hdparm -R' option to register an IDE interface.
453 This is dangerous stuff, so you should probably say N.
455 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_UNREGISTER_HWIF
456 bool "Un-register an IDE interface (DANGEROUS)"
458 depends on BUSYBOX_CONFIG_HDPARM
460 Enables the 'hdparm -U' option to un-register an IDE interface.
461 This is dangerous stuff, so you should probably say N.
463 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_DRIVE_RESET
464 bool "Perform device reset (DANGEROUS)"
466 depends on BUSYBOX_CONFIG_HDPARM
468 Enables the 'hdparm -w' option to perform a device reset.
469 This is dangerous stuff, so you should probably say N.
471 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_TRISTATE_HWIF
472 bool "Tristate device for hotswap (DANGEROUS)"
474 depends on BUSYBOX_CONFIG_HDPARM
476 Enables the 'hdparm -x' option to tristate device for hotswap,
477 and the '-b' option to get/set bus state. This is dangerous
478 stuff, so you should probably say N.
480 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_GETSET_DMA
481 bool "Get/set using_dma flag"
483 depends on BUSYBOX_CONFIG_HDPARM
485 Enables the 'hdparm -d' option to get/set using_dma flag.
487 config BUSYBOX_CONFIG_LOCK
491 Small utility for using locks in scripts
493 config BUSYBOX_CONFIG_MAKEDEVS
497 'makedevs' is a utility used to create a batch of devices with
500 There are two choices for command line behaviour, the interface
501 as used by LEAF/Linux Router Project, or a device table file.
503 'leaf' is traditionally what busybox follows, it allows multiple
504 devices of a particluar type to be created per command.
506 Device properties are passed as command line arguments.
508 'table' reads device properties from a file or stdin, allowing
509 a batch of unrelated devices to be made with one command.
510 User/group names are allowed as an alternative to uid/gid.
513 prompt "Choose makedevs behaviour"
514 depends on BUSYBOX_CONFIG_MAKEDEVS
515 default BUSYBOX_CONFIG_FEATURE_MAKEDEVS_TABLE
517 config BUSYBOX_CONFIG_FEATURE_MAKEDEVS_LEAF
520 config BUSYBOX_CONFIG_FEATURE_MAKEDEVS_TABLE
525 config BUSYBOX_CONFIG_MAN
529 Format and display manual pages.
531 config BUSYBOX_CONFIG_MICROCOM
535 The poor man's minicom utility for chatting with serial port devices.
537 config BUSYBOX_CONFIG_MOUNTPOINT
541 mountpoint checks if the directory is a mountpoint.
543 config BUSYBOX_CONFIG_MT
547 mt is used to control tape devices. You can use the mt utility
548 to advance or rewind a tape past a specified number of archive
551 config BUSYBOX_CONFIG_RAIDAUTORUN
555 raidautorun tells the kernel md driver to
556 search and start RAID arrays.
558 config BUSYBOX_CONFIG_READAHEAD
561 depends on BUSYBOX_CONFIG_LFS
563 Preload the files listed on the command line into RAM cache so that
564 subsequent reads on these files will not block on disk I/O.
566 This applet just calls the readahead(2) system call on each file.
567 It is mainly useful in system startup scripts to preload files
568 or executables before they are used. When used at the right time
569 (in particular when a CPU bound process is running) it can
570 significantly speed up system startup.
572 As readahead(2) blocks until each file has been read, it is best to
573 run this applet as a background job.
575 config BUSYBOX_CONFIG_RFKILL
579 Enable/disable wireless devices.
581 rfkill list : list all wireless devices
582 rfkill list bluetooth : list all bluetooth devices
583 rfkill list 1 : list device corresponding to the given index
584 rfkill block|unblock wlan : block/unblock all wlan(wifi) devices
586 config BUSYBOX_CONFIG_RUNLEVEL
590 find the current and previous system runlevel.
592 This applet uses utmp but does not rely on busybox supporing
593 utmp on purpose. It is used by e.g. emdebian via /etc/init.d/rc.
595 config BUSYBOX_CONFIG_RX
599 Receive files using the Xmodem protocol.
601 config BUSYBOX_CONFIG_SETSID
605 setsid runs a program in a new session
607 config BUSYBOX_CONFIG_STRINGS
611 strings prints the printable character sequences for each file
614 config BUSYBOX_CONFIG_TASKSET
618 Retrieve or set a processes's CPU affinity.
619 This requires sched_{g,s}etaffinity support in your libc.
621 config BUSYBOX_CONFIG_FEATURE_TASKSET_FANCY
624 depends on BUSYBOX_CONFIG_TASKSET
626 Add code for fancy output. This merely silences a compiler-warning
627 and adds about 135 Bytes. May be needed for machines with alot
630 config BUSYBOX_CONFIG_TIME
634 The time command runs the specified program with the given arguments.
635 When the command finishes, time writes a message to standard output
636 giving timing statistics about this program run.
638 config BUSYBOX_CONFIG_TIMEOUT
642 Runs a program and watches it. If it does not terminate in
643 specified number of seconds, it is sent a signal.
645 config BUSYBOX_CONFIG_TTYSIZE
649 A replacement for "stty size". Unlike stty, can report only width,
650 only height, or both, in any order. It also does not complain on
651 error, but returns default 80x24.
652 Usage in shell scripts: width=`ttysize w`.
654 config BUSYBOX_CONFIG_VOLNAME
658 Prints a CD-ROM volume name.
660 config BUSYBOX_CONFIG_WALL
664 Write a message to all users that are logged in.
666 config BUSYBOX_CONFIG_WATCHDOG
670 The watchdog utility is used with hardware or software watchdog
671 device drivers. It opens the specified watchdog device special file
672 and periodically writes a magic character to the device. If the
673 watchdog applet ever fails to write the magic character within a
674 certain amount of time, the watchdog device assumes the system has
675 hung, and will cause the hardware to reboot.