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
11 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
13 A text-mode VNC like program for Linux virtual terminals.
14 example: conspy NUM shared access to console num
15 or conspy -nd NUM screenshot of console num
16 or conspy -cs NUM poor man's GNU screen like
17 config BUSYBOX_CONFIG_NANDWRITE
20 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
22 Write to the specified MTD device, with bad blocks awareness
24 config BUSYBOX_CONFIG_NANDDUMP
27 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
29 Dump the content of raw NAND chip
30 config BUSYBOX_CONFIG_UBIATTACH
33 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
35 Attach MTD device to an UBI device.
37 config BUSYBOX_CONFIG_UBIDETACH
40 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
42 Detach MTD device from an UBI device.
44 config BUSYBOX_CONFIG_ADJTIMEX
47 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
49 Adjtimex reads and optionally sets adjustment parameters for
50 the Linux clock adjustment algorithm.
52 config BUSYBOX_CONFIG_BBCONFIG
56 The bbconfig applet will print the config file with which
59 config BUSYBOX_CONFIG_FEATURE_COMPRESS_BBCONFIG
60 bool "Compress bbconfig data"
62 depends on BUSYBOX_CONFIG_BBCONFIG
64 Store bbconfig data in compressed form, uncompress them on-the-fly
67 If you have a really tiny busybox with few applets enabled (and
68 bunzip2 isn't one of them), the overhead of the decompressor might
69 be noticeable. Also, if you run executables directly from ROM
70 and have very little memory, this might not be a win. Otherwise,
71 you probably want this.
73 config BUSYBOX_CONFIG_BEEP
76 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
78 The beep applets beeps in a given freq/Hz.
80 config BUSYBOX_CONFIG_FEATURE_BEEP_FREQ
81 int "default frequency"
84 depends on BUSYBOX_CONFIG_BEEP
86 Frequency for default beep.
88 config BUSYBOX_CONFIG_FEATURE_BEEP_LENGTH_MS
92 depends on BUSYBOX_CONFIG_BEEP
94 Length in ms for default beep.
96 config BUSYBOX_CONFIG_CHAT
102 config BUSYBOX_CONFIG_FEATURE_CHAT_NOFAIL
103 bool "Enable NOFAIL expect strings"
104 depends on BUSYBOX_CONFIG_CHAT
107 When enabled expect strings which are started with a dash trigger
108 no-fail mode. That is when expectation is not met within timeout
109 the script is not terminated but sends next SEND string and waits
110 for next EXPECT string. This allows to compose far more flexible
113 config BUSYBOX_CONFIG_FEATURE_CHAT_TTY_HIFI
114 bool "Force STDIN to be a TTY"
115 depends on BUSYBOX_CONFIG_CHAT
118 Original chat always treats STDIN as a TTY device and sets for it
119 so-called raw mode. This option turns on such behaviour.
121 config BUSYBOX_CONFIG_FEATURE_CHAT_IMPLICIT_CR
122 bool "Enable implicit Carriage Return"
123 depends on BUSYBOX_CONFIG_CHAT
126 When enabled make chat to terminate all SEND strings with a "\r"
127 unless "\c" is met anywhere in the string.
129 config BUSYBOX_CONFIG_FEATURE_CHAT_SWALLOW_OPTS
130 bool "Swallow options"
131 depends on BUSYBOX_CONFIG_CHAT
134 Busybox chat require no options. To make it not fail when used
135 in place of original chat (which has a bunch of options) turn
138 config BUSYBOX_CONFIG_FEATURE_CHAT_SEND_ESCAPES
139 bool "Support weird SEND escapes"
140 depends on BUSYBOX_CONFIG_CHAT
143 Original chat uses some escape sequences in SEND arguments which
144 are not sent to device but rather performs special actions.
145 E.g. "\K" means to send a break sequence to device.
146 "\d" delays execution for a second, "\p" -- for a 1/100 of second.
147 Before turning this option on think twice: do you really need them?
149 config BUSYBOX_CONFIG_FEATURE_CHAT_VAR_ABORT_LEN
150 bool "Support variable-length ABORT conditions"
151 depends on BUSYBOX_CONFIG_CHAT
154 Original chat uses fixed 50-bytes length ABORT conditions. Say N here.
156 config BUSYBOX_CONFIG_FEATURE_CHAT_CLR_ABORT
157 bool "Support revoking of ABORT conditions"
158 depends on BUSYBOX_CONFIG_CHAT
161 Support CLR_ABORT directive.
163 config BUSYBOX_CONFIG_CHRT
167 manipulate real-time attributes of a process.
168 This requires sched_{g,s}etparam support in your libc.
170 config BUSYBOX_CONFIG_CROND
173 select BUSYBOX_CONFIG_FEATURE_SYSLOG
175 Crond is a background daemon that parses individual crontab
176 files and executes commands on behalf of the users in question.
177 This is a port of dcron from slackware. It uses files of the
178 format /var/spool/cron/crontabs/<username> files, for example:
179 $ cat /var/spool/cron/crontabs/root
180 # Run daily cron jobs at 4:40 every day:
181 40 4 * * * /etc/cron/daily > /dev/null 2>&1
183 config BUSYBOX_CONFIG_FEATURE_CROND_D
184 bool "Support option -d to redirect output to stderr"
185 depends on BUSYBOX_CONFIG_CROND
188 -d sets loglevel to 0 (most verbose) and directs all output to stderr.
190 config BUSYBOX_CONFIG_FEATURE_CROND_CALL_SENDMAIL
191 bool "Report command output via email (using sendmail)"
193 depends on BUSYBOX_CONFIG_CROND
195 Command output will be sent to corresponding user via email.
197 config BUSYBOX_CONFIG_FEATURE_CROND_DIR
198 string "crond spool directory"
199 default "/var/spool/cron"
200 depends on BUSYBOX_CONFIG_CROND || BUSYBOX_CONFIG_CRONTAB
202 Location of crond spool.
204 config BUSYBOX_CONFIG_CRONTAB
208 Crontab manipulates the crontab for a particular user. Only
209 the superuser may specify a different user and/or crontab directory.
210 Note that Busybox binary must be setuid root for this applet to
213 config BUSYBOX_CONFIG_DC
217 Dc is a reverse-polish desk calculator which supports unlimited
218 precision arithmetic.
220 config BUSYBOX_CONFIG_FEATURE_DC_LIBM
221 bool "Enable power and exp functions (requires libm)"
223 depends on BUSYBOX_CONFIG_DC
225 Enable power and exp functions.
226 NOTE: This will require libm to be present for linking.
228 config BUSYBOX_CONFIG_DEVFSD
229 bool "devfsd (obsolete)"
231 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
232 select BUSYBOX_CONFIG_FEATURE_SYSLOG
234 This is deprecated and should NOT be used anymore.
235 Use linux >= 2.6 (optionally with hotplug) and mdev instead!
236 See docs/mdev.txt for detailed instructions on how to use mdev
239 Provides compatibility with old device names on a devfs systems.
240 You should set it to true if you have devfs enabled.
241 The following keywords in devsfd.conf are supported:
242 "CLEAR_CONFIG", "INCLUDE", "OPTIONAL_INCLUDE", "RESTORE",
243 "PERMISSIONS", "EXECUTE", "COPY", "IGNORE",
244 "MKOLDCOMPAT", "MKNEWCOMPAT","RMOLDCOMPAT", "RMNEWCOMPAT".
246 But only if they are written UPPERCASE!!!!!!!!
248 config BUSYBOX_CONFIG_DEVFSD_MODLOAD
249 bool "Adds support for MODLOAD keyword in devsfd.conf"
251 depends on BUSYBOX_CONFIG_DEVFSD
253 This actually doesn't work with busybox modutils but needs
254 the external modutils.
256 config BUSYBOX_CONFIG_DEVFSD_FG_NP
257 bool "Enables the -fg and -np options"
259 depends on BUSYBOX_CONFIG_DEVFSD
261 -fg Run the daemon in the foreground.
262 -np Exit after parsing the configuration file.
263 Do not poll for events.
265 config BUSYBOX_CONFIG_DEVFSD_VERBOSE
266 bool "Increases logging (and size)"
268 depends on BUSYBOX_CONFIG_DEVFSD
270 Increases logging to stderr or syslog.
272 config BUSYBOX_CONFIG_FEATURE_DEVFS
273 bool "Use devfs names for all devices (obsolete)"
275 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
277 This is obsolete and should NOT be used anymore.
278 Use linux >= 2.6 (optionally with hotplug) and mdev instead!
280 For legacy systems -- if there is no way around devfsd -- this
281 tells busybox to look for names like /dev/loop/0 instead of
282 /dev/loop0. If your /dev directory has normal names instead of
283 devfs names, you don't want this.
285 config BUSYBOX_CONFIG_DEVMEM
289 devmem is a small program that reads and writes from physical
290 memory using /dev/mem.
292 config BUSYBOX_CONFIG_EJECT
295 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
297 Used to eject cdroms. (defaults to /dev/cdrom)
299 config BUSYBOX_CONFIG_FEATURE_EJECT_SCSI
302 depends on BUSYBOX_CONFIG_EJECT
304 Add the -s option to eject, this allows to eject SCSI-Devices and
307 config BUSYBOX_CONFIG_FBSPLASH
310 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
312 Shows splash image and progress bar on framebuffer device.
313 Can be used during boot phase of an embedded device. ~2kb.
315 - use kernel option 'vga=xxx' or otherwise enable fb device.
316 - put somewhere fbsplash.cfg file and an image in .ppm format.
317 - $ setsid fbsplash [params] &
319 -d /dev/fbN: framebuffer device (if not /dev/fb0)
320 -s path_to_image_file (can be "-" for stdin)
321 -i path_to_cfg_file (can be "-" for stdin)
322 -f path_to_fifo (can be "-" for stdin)
323 - if you want to run it only in presence of kernel parameter:
324 grep -q "fbsplash=on" </proc/cmdline && setsid fbsplash [params] &
326 "NN" (ASCII decimal number) - percentage to show on progress bar
327 "exit" - well you guessed it
329 config BUSYBOX_CONFIG_FLASHCP
333 The flashcp binary, inspired by mtd-utils as of git head 5eceb74f7.
334 This utility is used to copy images into a MTD device.
336 config BUSYBOX_CONFIG_FLASH_LOCK
340 The flash_lock binary from mtd-utils as of git head 5ec0c10d0. This
341 utility locks part or all of the flash device.
343 config BUSYBOX_CONFIG_FLASH_UNLOCK
347 The flash_unlock binary from mtd-utils as of git head 5ec0c10d0. This
348 utility unlocks part or all of the flash device.
350 config BUSYBOX_CONFIG_FLASH_ERASEALL
351 bool "flash_eraseall"
354 The flash_eraseall binary from mtd-utils as of git head c4c6a59eb.
355 This utility is used to erase the whole MTD device.
357 config BUSYBOX_CONFIG_IONICE
360 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
362 Set/set program io scheduling class and priority
363 Requires kernel >= 2.6.13
365 config BUSYBOX_CONFIG_INOTIFYD
369 Simple inotify daemon. Reports filesystem changes. Requires
372 config BUSYBOX_CONFIG_LAST
375 depends on BUSYBOX_CONFIG_FEATURE_WTMP
377 'last' displays a list of the last users that logged into the system.
380 prompt "Choose last implementation"
381 depends on BUSYBOX_CONFIG_LAST
382 default BUSYBOX_CONFIG_FEATURE_LAST_FANCY
384 config BUSYBOX_CONFIG_FEATURE_LAST_SMALL
387 This is a small version of last with just the basic set of
390 config BUSYBOX_CONFIG_FEATURE_LAST_FANCY
393 'last' displays detailed information about the last users that
394 logged into the system (mimics sysvinit last). +900 bytes.
397 config BUSYBOX_CONFIG_LESS
401 'less' is a pager, meaning that it displays text files. It possesses
402 a wide array of features, and is an improvement over 'more'.
404 config BUSYBOX_CONFIG_FEATURE_LESS_MAXLINES
405 int "Max number of input lines less will try to eat"
407 depends on BUSYBOX_CONFIG_LESS
409 config BUSYBOX_CONFIG_FEATURE_LESS_BRACKETS
410 bool "Enable bracket searching"
412 depends on BUSYBOX_CONFIG_LESS
414 This option adds the capability to search for matching left and right
415 brackets, facilitating programming.
417 config BUSYBOX_CONFIG_FEATURE_LESS_FLAGS
418 bool "Enable extra flags"
420 depends on BUSYBOX_CONFIG_LESS
422 The extra flags provided do the following:
424 The -M flag enables a more sophisticated status line.
425 The -m flag enables a simpler status line with a percentage.
427 config BUSYBOX_CONFIG_FEATURE_LESS_MARKS
430 depends on BUSYBOX_CONFIG_LESS
432 Marks enable positions in a file to be stored for easy reference.
434 config BUSYBOX_CONFIG_FEATURE_LESS_REGEXP
435 bool "Enable regular expressions"
437 depends on BUSYBOX_CONFIG_LESS
439 Enable regular expressions, allowing complex file searches.
441 config BUSYBOX_CONFIG_FEATURE_LESS_WINCH
442 bool "Enable automatic resizing on window size changes"
444 depends on BUSYBOX_CONFIG_LESS
446 Makes less track window size changes.
448 config BUSYBOX_CONFIG_FEATURE_LESS_DASHCMD
449 bool "Enable flag changes ('-' command)"
451 depends on BUSYBOX_CONFIG_LESS
453 This enables the ability to change command-line flags within
454 less itself ('-' keyboard command).
456 config BUSYBOX_CONFIG_FEATURE_LESS_LINENUMS
457 bool "Enable dynamic switching of line numbers"
459 depends on BUSYBOX_CONFIG_FEATURE_LESS_DASHCMD
461 Enables "-N" command.
463 config BUSYBOX_CONFIG_HDPARM
466 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
468 Get/Set hard drive parameters. Primarily intended for ATA
469 drives. Adds about 13k (or around 30k if you enable the
470 FEATURE_HDPARM_GET_IDENTITY option)....
472 config BUSYBOX_CONFIG_FEATURE_HDPARM_GET_IDENTITY
473 bool "Support obtaining detailed information directly from drives"
475 depends on BUSYBOX_CONFIG_HDPARM
477 Enables the -I and -i options to obtain detailed information
478 directly from drives about their capabilities and supported ATA
479 feature set. If no device name is specified, hdparm will read
480 identify data from stdin. Enabling this option will add about 16k...
482 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_SCAN_HWIF
483 bool "Register an IDE interface (DANGEROUS)"
485 depends on BUSYBOX_CONFIG_HDPARM
487 Enables the 'hdparm -R' option to register an IDE interface.
488 This is dangerous stuff, so you should probably say N.
490 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_UNREGISTER_HWIF
491 bool "Un-register an IDE interface (DANGEROUS)"
493 depends on BUSYBOX_CONFIG_HDPARM
495 Enables the 'hdparm -U' option to un-register an IDE interface.
496 This is dangerous stuff, so you should probably say N.
498 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_DRIVE_RESET
499 bool "Perform device reset (DANGEROUS)"
501 depends on BUSYBOX_CONFIG_HDPARM
503 Enables the 'hdparm -w' option to perform a device reset.
504 This is dangerous stuff, so you should probably say N.
506 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_TRISTATE_HWIF
507 bool "Tristate device for hotswap (DANGEROUS)"
509 depends on BUSYBOX_CONFIG_HDPARM
511 Enables the 'hdparm -x' option to tristate device for hotswap,
512 and the '-b' option to get/set bus state. This is dangerous
513 stuff, so you should probably say N.
515 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_GETSET_DMA
516 bool "Get/set using_dma flag"
518 depends on BUSYBOX_CONFIG_HDPARM
520 Enables the 'hdparm -d' option to get/set using_dma flag.
522 config BUSYBOX_CONFIG_LOCK
526 Small utility for using locks in scripts
528 config BUSYBOX_CONFIG_MAKEDEVS
532 'makedevs' is a utility used to create a batch of devices with
535 There are two choices for command line behaviour, the interface
536 as used by LEAF/Linux Router Project, or a device table file.
538 'leaf' is traditionally what busybox follows, it allows multiple
539 devices of a particluar type to be created per command.
541 Device properties are passed as command line arguments.
543 'table' reads device properties from a file or stdin, allowing
544 a batch of unrelated devices to be made with one command.
545 User/group names are allowed as an alternative to uid/gid.
548 prompt "Choose makedevs behaviour"
549 depends on BUSYBOX_CONFIG_MAKEDEVS
550 default BUSYBOX_CONFIG_FEATURE_MAKEDEVS_TABLE
552 config BUSYBOX_CONFIG_FEATURE_MAKEDEVS_LEAF
555 config BUSYBOX_CONFIG_FEATURE_MAKEDEVS_TABLE
560 config BUSYBOX_CONFIG_MAN
564 Format and display manual pages.
566 config BUSYBOX_CONFIG_MICROCOM
570 The poor man's minicom utility for chatting with serial port devices.
572 config BUSYBOX_CONFIG_MOUNTPOINT
576 mountpoint checks if the directory is a mountpoint.
578 config BUSYBOX_CONFIG_MT
582 mt is used to control tape devices. You can use the mt utility
583 to advance or rewind a tape past a specified number of archive
586 config BUSYBOX_CONFIG_RAIDAUTORUN
589 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
591 raidautorun tells the kernel md driver to
592 search and start RAID arrays.
594 config BUSYBOX_CONFIG_READAHEAD
597 depends on BUSYBOX_CONFIG_LFS && BUSYBOX_CONFIG_PLATFORM_LINUX
599 Preload the files listed on the command line into RAM cache so that
600 subsequent reads on these files will not block on disk I/O.
602 This applet just calls the readahead(2) system call on each file.
603 It is mainly useful in system startup scripts to preload files
604 or executables before they are used. When used at the right time
605 (in particular when a CPU bound process is running) it can
606 significantly speed up system startup.
608 As readahead(2) blocks until each file has been read, it is best to
609 run this applet as a background job.
611 config BUSYBOX_CONFIG_RFKILL
614 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
616 Enable/disable wireless devices.
618 rfkill list : list all wireless devices
619 rfkill list bluetooth : list all bluetooth devices
620 rfkill list 1 : list device corresponding to the given index
621 rfkill block|unblock wlan : block/unblock all wlan(wifi) devices
623 config BUSYBOX_CONFIG_RUNLEVEL
627 find the current and previous system runlevel.
629 This applet uses utmp but does not rely on busybox supporing
630 utmp on purpose. It is used by e.g. emdebian via /etc/init.d/rc.
632 config BUSYBOX_CONFIG_RX
635 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
637 Receive files using the Xmodem protocol.
639 config BUSYBOX_CONFIG_SETSID
643 setsid runs a program in a new session
645 config BUSYBOX_CONFIG_STRINGS
649 strings prints the printable character sequences for each file
652 config BUSYBOX_CONFIG_TASKSET
656 Retrieve or set a processes's CPU affinity.
657 This requires sched_{g,s}etaffinity support in your libc.
659 config BUSYBOX_CONFIG_FEATURE_TASKSET_FANCY
662 depends on BUSYBOX_CONFIG_TASKSET
664 Add code for fancy output. This merely silences a compiler-warning
665 and adds about 135 Bytes. May be needed for machines with alot
668 config BUSYBOX_CONFIG_TIME
672 The time command runs the specified program with the given arguments.
673 When the command finishes, time writes a message to standard output
674 giving timing statistics about this program run.
676 config BUSYBOX_CONFIG_TIMEOUT
680 Runs a program and watches it. If it does not terminate in
681 specified number of seconds, it is sent a signal.
683 config BUSYBOX_CONFIG_TTYSIZE
687 A replacement for "stty size". Unlike stty, can report only width,
688 only height, or both, in any order. It also does not complain on
689 error, but returns default 80x24.
690 Usage in shell scripts: width=`ttysize w`.
692 config BUSYBOX_CONFIG_VOLNAME
696 Prints a CD-ROM volume name.
698 config BUSYBOX_CONFIG_WALL
702 Write a message to all users that are logged in.
704 config BUSYBOX_CONFIG_WATCHDOG
707 depends on BUSYBOX_CONFIG_PLATFORM_LINUX
709 The watchdog utility is used with hardware or software watchdog
710 device drivers. It opens the specified watchdog device special file
711 and periodically writes a magic character to the device. If the
712 watchdog applet ever fails to write the magic character within a
713 certain amount of time, the watchdog device assumes the system has
714 hung, and will cause the hardware to reboot.