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_ADJTIMEX
12 Adjtimex reads and optionally sets adjustment parameters for
13 the Linux clock adjustment algorithm.
15 config BUSYBOX_CONFIG_BBCONFIG
19 The bbconfig applet will print the config file with which
22 config BUSYBOX_CONFIG_BEEP
26 The beep applets beeps in a given freq/Hz.
28 config BUSYBOX_CONFIG_FEATURE_BEEP_FREQ
29 int "default frequency"
32 depends on BUSYBOX_CONFIG_BEEP
34 Frequency for default beep.
36 config BUSYBOX_CONFIG_FEATURE_BEEP_LENGTH_MS
40 depends on BUSYBOX_CONFIG_BEEP
42 Length in ms for default beep.
44 config BUSYBOX_CONFIG_CHAT
50 config BUSYBOX_CONFIG_FEATURE_CHAT_NOFAIL
51 bool "Enable NOFAIL expect strings"
52 depends on BUSYBOX_CONFIG_CHAT
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
61 config BUSYBOX_CONFIG_FEATURE_CHAT_TTY_HIFI
62 bool "Force STDIN to be a TTY"
63 depends on BUSYBOX_CONFIG_CHAT
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.
69 config BUSYBOX_CONFIG_FEATURE_CHAT_IMPLICIT_CR
70 bool "Enable implicit Carriage Return"
71 depends on BUSYBOX_CONFIG_CHAT
74 When enabled make chat to terminate all SEND strings with a "\r"
75 unless "\c" is met anywhere in the string.
77 config BUSYBOX_CONFIG_FEATURE_CHAT_SWALLOW_OPTS
78 bool "Swallow options"
79 depends on BUSYBOX_CONFIG_CHAT
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
86 config BUSYBOX_CONFIG_FEATURE_CHAT_SEND_ESCAPES
87 bool "Support weird SEND escapes"
88 depends on BUSYBOX_CONFIG_CHAT
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?
97 config BUSYBOX_CONFIG_FEATURE_CHAT_VAR_ABORT_LEN
98 bool "Support variable-length ABORT conditions"
99 depends on BUSYBOX_CONFIG_CHAT
102 Original chat uses fixed 50-bytes length ABORT conditions. Say N here.
104 config BUSYBOX_CONFIG_FEATURE_CHAT_CLR_ABORT
105 bool "Support revoking of ABORT conditions"
106 depends on BUSYBOX_CONFIG_CHAT
109 Support CLR_ABORT directive.
111 config BUSYBOX_CONFIG_CHRT
115 manipulate real-time attributes of a process.
116 This requires sched_{g,s}etparam support in your libc.
118 config BUSYBOX_CONFIG_CROND
121 select BUSYBOX_CONFIG_FEATURE_SUID
122 select BUSYBOX_CONFIG_FEATURE_SYSLOG
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
132 config BUSYBOX_CONFIG_FEATURE_CROND_D
133 bool "Support option -d to redirect output to stderr"
134 depends on BUSYBOX_CONFIG_CROND
137 -d sets loglevel to 0 (most verbose) and directs all output to stderr.
139 config BUSYBOX_CONFIG_FEATURE_CROND_CALL_SENDMAIL
140 bool "Using /usr/sbin/sendmail?"
142 depends on BUSYBOX_CONFIG_CROND
144 Support calling /usr/sbin/sendmail for send cmd outputs.
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
151 Location of crond spool.
153 config BUSYBOX_CONFIG_CRONTAB
156 select BUSYBOX_CONFIG_FEATURE_SUID
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
163 config BUSYBOX_CONFIG_DC
167 Dc is a reverse-polish desk calculator which supports unlimited
168 precision arithmetic.
170 config BUSYBOX_CONFIG_FEATURE_DC_LIBM
171 bool "Enable power and exp functions (requires libm)"
173 depends on BUSYBOX_CONFIG_DC
175 Enable power and exp functions.
176 NOTE: This will require libm to be present for linking.
178 config BUSYBOX_CONFIG_DEVFSD
179 bool "devfsd (obsolete)"
181 select BUSYBOX_CONFIG_FEATURE_SYSLOG
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
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".
195 But only if they are written UPPERCASE!!!!!!!!
197 config BUSYBOX_CONFIG_DEVFSD_MODLOAD
198 bool "Adds support for MODLOAD keyword in devsfd.conf"
200 depends on BUSYBOX_CONFIG_DEVFSD
202 This actually doesn't work with busybox modutils but needs
203 the external modutils.
205 config BUSYBOX_CONFIG_DEVFSD_FG_NP
206 bool "Enables the -fg and -np options"
208 depends on BUSYBOX_CONFIG_DEVFSD
210 -fg Run the daemon in the foreground.
211 -np Exit after parsing the configuration file.
212 Do not poll for events.
214 config BUSYBOX_CONFIG_DEVFSD_VERBOSE
215 bool "Increases logging (and size)"
217 depends on BUSYBOX_CONFIG_DEVFSD
219 Increases logging to stderr or syslog.
221 config BUSYBOX_CONFIG_FEATURE_DEVFS
222 bool "Use devfs names for all devices (obsolete)"
225 This is obsolete and should NOT be used anymore.
226 Use linux >= 2.6 (optionally with hotplug) and mdev instead!
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.
233 config BUSYBOX_CONFIG_DEVMEM
237 devmem is a small program that reads and writes from physical
238 memory using /dev/mem.
240 config BUSYBOX_CONFIG_EJECT
244 Used to eject cdroms. (defaults to /dev/cdrom)
246 config BUSYBOX_CONFIG_FEATURE_EJECT_SCSI
249 depends on BUSYBOX_CONFIG_EJECT
251 Add the -s option to eject, this allows to eject SCSI-Devices and
254 config BUSYBOX_CONFIG_FBSPLASH
258 Shows splash image and progress bar on framebuffer device.
259 Can be used during boot phase of an embedded device. ~2kb.
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] &
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] &
272 "NN" (ASCII decimal number) - percentage to show on progress bar
273 "exit" - well you guessed it
275 config BUSYBOX_CONFIG_FLASH_LOCK
279 The flash_lock binary from mtd-utils as of git head 5ec0c10d0. This
280 utility locks part or all of the flash device.
282 config BUSYBOX_CONFIG_FLASH_UNLOCK
286 The flash_unlock binary from mtd-utils as of git head 5ec0c10d0. This
287 utility unlocks part or all of the flash device.
289 config BUSYBOX_CONFIG_FLASH_ERASEALL
290 bool "flash_eraseall"
293 The flash_eraseall binary from mtd-utils as of git head c4c6a59eb.
294 This utility is used to erase the whole MTD device.
296 config BUSYBOX_CONFIG_IONICE
300 Set/set program io scheduling class and priority
301 Requires kernel >= 2.6.13
303 config BUSYBOX_CONFIG_INOTIFYD
307 Simple inotify daemon. Reports filesystem changes. Requires
310 config BUSYBOX_CONFIG_LAST
313 select BUSYBOX_CONFIG_FEATURE_WTMP
315 'last' displays a list of the last users that logged into the system.
318 prompt "Choose last implementation"
319 depends on BUSYBOX_CONFIG_LAST
320 default BUSYBOX_CONFIG_FEATURE_LAST_SMALL
322 config BUSYBOX_CONFIG_FEATURE_LAST_SMALL
325 This is a small version of last with just the basic set of
328 config BUSYBOX_CONFIG_FEATURE_LAST_FANCY
331 'last' displays detailed information about the last users that
332 logged into the system (mimics sysvinit last). +900 bytes.
335 config BUSYBOX_CONFIG_LESS
339 'less' is a pager, meaning that it displays text files. It possesses
340 a wide array of features, and is an improvement over 'more'.
342 config BUSYBOX_CONFIG_FEATURE_LESS_MAXLINES
343 int "Max number of input lines less will try to eat"
345 depends on BUSYBOX_CONFIG_LESS
347 config BUSYBOX_CONFIG_FEATURE_LESS_BRACKETS
348 bool "Enable bracket searching"
350 depends on BUSYBOX_CONFIG_LESS
352 This option adds the capability to search for matching left and right
353 brackets, facilitating programming.
355 config BUSYBOX_CONFIG_FEATURE_LESS_FLAGS
356 bool "Enable extra flags"
358 depends on BUSYBOX_CONFIG_LESS
360 The extra flags provided do the following:
362 The -M flag enables a more sophisticated status line.
363 The -m flag enables a simpler status line with a percentage.
365 config BUSYBOX_CONFIG_FEATURE_LESS_MARKS
368 depends on BUSYBOX_CONFIG_LESS
370 Marks enable positions in a file to be stored for easy reference.
372 config BUSYBOX_CONFIG_FEATURE_LESS_REGEXP
373 bool "Enable regular expressions"
375 depends on BUSYBOX_CONFIG_LESS
377 Enable regular expressions, allowing complex file searches.
379 config BUSYBOX_CONFIG_FEATURE_LESS_WINCH
380 bool "Enable automatic resizing on window size changes"
382 depends on BUSYBOX_CONFIG_LESS
384 Makes less track window size changes.
386 config BUSYBOX_CONFIG_FEATURE_LESS_DASHCMD
387 bool "Enable flag changes ('-' command)"
389 depends on BUSYBOX_CONFIG_LESS
391 This enables the ability to change command-line flags within
392 less itself ('-' keyboard command).
394 config BUSYBOX_CONFIG_FEATURE_LESS_LINENUMS
395 bool "Enable dynamic switching of line numbers"
397 depends on BUSYBOX_CONFIG_FEATURE_LESS_DASHCMD
401 config BUSYBOX_CONFIG_HDPARM
405 Get/Set hard drive parameters. Primarily intended for ATA
406 drives. Adds about 13k (or around 30k if you enable the
407 FEATURE_HDPARM_GET_IDENTITY option)....
409 config BUSYBOX_CONFIG_FEATURE_HDPARM_GET_IDENTITY
410 bool "Support obtaining detailed information directly from drives"
412 depends on BUSYBOX_CONFIG_HDPARM
414 Enables the -I and -i options to obtain detailed information
415 directly from drives about their capabilities and supported ATA
416 feature set. If no device name is specified, hdparm will read
417 identify data from stdin. Enabling this option will add about 16k...
419 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_SCAN_HWIF
420 bool "Register an IDE interface (DANGEROUS)"
422 depends on BUSYBOX_CONFIG_HDPARM
424 Enables the 'hdparm -R' option to register an IDE interface.
425 This is dangerous stuff, so you should probably say N.
427 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_UNREGISTER_HWIF
428 bool "Un-register an IDE interface (DANGEROUS)"
430 depends on BUSYBOX_CONFIG_HDPARM
432 Enables the 'hdparm -U' option to un-register an IDE interface.
433 This is dangerous stuff, so you should probably say N.
435 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_DRIVE_RESET
436 bool "Perform device reset (DANGEROUS)"
438 depends on BUSYBOX_CONFIG_HDPARM
440 Enables the 'hdparm -w' option to perform a device reset.
441 This is dangerous stuff, so you should probably say N.
443 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_TRISTATE_HWIF
444 bool "Tristate device for hotswap (DANGEROUS)"
446 depends on BUSYBOX_CONFIG_HDPARM
448 Enables the 'hdparm -x' option to tristate device for hotswap,
449 and the '-b' option to get/set bus state. This is dangerous
450 stuff, so you should probably say N.
452 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_GETSET_DMA
453 bool "Get/set using_dma flag"
455 depends on BUSYBOX_CONFIG_HDPARM
457 Enables the 'hdparm -d' option to get/set using_dma flag.
459 config BUSYBOX_CONFIG_LOCK
463 Small utility for using locks in scripts
465 config BUSYBOX_CONFIG_MAKEDEVS
469 'makedevs' is a utility used to create a batch of devices with
472 There are two choices for command line behaviour, the interface
473 as used by LEAF/Linux Router Project, or a device table file.
475 'leaf' is traditionally what busybox follows, it allows multiple
476 devices of a particluar type to be created per command.
478 Device properties are passed as command line arguments.
480 'table' reads device properties from a file or stdin, allowing
481 a batch of unrelated devices to be made with one command.
482 User/group names are allowed as an alternative to uid/gid.
485 prompt "Choose makedevs behaviour"
486 depends on BUSYBOX_CONFIG_MAKEDEVS
487 default BUSYBOX_CONFIG_FEATURE_MAKEDEVS_TABLE
489 config BUSYBOX_CONFIG_FEATURE_MAKEDEVS_LEAF
492 config BUSYBOX_CONFIG_FEATURE_MAKEDEVS_TABLE
497 config BUSYBOX_CONFIG_MAN
501 Format and display manual pages.
503 config BUSYBOX_CONFIG_MICROCOM
507 The poor man's minicom utility for chatting with serial port devices.
509 config BUSYBOX_CONFIG_MOUNTPOINT
513 mountpoint checks if the directory is a mountpoint.
515 config BUSYBOX_CONFIG_MT
519 mt is used to control tape devices. You can use the mt utility
520 to advance or rewind a tape past a specified number of archive
523 config BUSYBOX_CONFIG_RAIDAUTORUN
527 raidautorun tells the kernel md driver to
528 search and start RAID arrays.
530 config BUSYBOX_CONFIG_READAHEAD
533 depends on BUSYBOX_CONFIG_LFS
535 Preload the files listed on the command line into RAM cache so that
536 subsequent reads on these files will not block on disk I/O.
538 This applet just calls the readahead(2) system call on each file.
539 It is mainly useful in system startup scripts to preload files
540 or executables before they are used. When used at the right time
541 (in particular when a CPU bound process is running) it can
542 significantly speed up system startup.
544 As readahead(2) blocks until each file has been read, it is best to
545 run this applet as a background job.
547 config BUSYBOX_CONFIG_RUNLEVEL
551 find the current and previous system runlevel.
553 This applet uses utmp but does not rely on busybox supporing
554 utmp on purpose. It is used by e.g. emdebian via /etc/init.d/rc.
556 config BUSYBOX_CONFIG_RX
560 Receive files using the Xmodem protocol.
562 config BUSYBOX_CONFIG_SETSID
566 setsid runs a program in a new session
568 config BUSYBOX_CONFIG_STRINGS
572 strings prints the printable character sequences for each file
575 config BUSYBOX_CONFIG_TASKSET
579 Retrieve or set a processes's CPU affinity.
580 This requires sched_{g,s}etaffinity support in your libc.
582 config BUSYBOX_CONFIG_FEATURE_TASKSET_FANCY
585 depends on BUSYBOX_CONFIG_TASKSET
587 Add code for fancy output. This merely silences a compiler-warning
588 and adds about 135 Bytes. May be needed for machines with alot
591 config BUSYBOX_CONFIG_TIME
595 The time command runs the specified program with the given arguments.
596 When the command finishes, time writes a message to standard output
597 giving timing statistics about this program run.
599 config BUSYBOX_CONFIG_TIMEOUT
603 Runs a program and watches it. If it does not terminate in
604 specified number of seconds, it is sent a signal.
606 config BUSYBOX_CONFIG_TTYSIZE
610 A replacement for "stty size". Unlike stty, can report only width,
611 only height, or both, in any order. It also does not complain on
612 error, but returns default 80x24.
613 Usage in shell scripts: width=`ttysize w`.
615 config BUSYBOX_CONFIG_VOLNAME
619 Prints a CD-ROM volume name.
621 config BUSYBOX_CONFIG_WATCHDOG
625 The watchdog utility is used with hardware or software watchdog
626 device drivers. It opens the specified watchdog device special file
627 and periodically writes a magic character to the device. If the
628 watchdog applet ever fails to write the magic character within a
629 certain amount of time, the watchdog device assumes the system has
630 hung, and will cause the hardware to reboot.