2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
6 menu "Miscellaneous Utilities"
14 Adjtimex reads and optionally sets adjustment parameters for
15 the Linux clock adjustment algorithm.
21 The bbconfig applet will print the config file with which
28 The beep applets beeps in a given freq/Hz.
30 config FEATURE_BEEP_FREQ
31 int "default frequency"
36 Frequency for default beep.
38 config FEATURE_BEEP_LENGTH_MS
44 Length in ms for default beep.
52 config FEATURE_CHAT_NOFAIL
53 bool "Enable NOFAIL expect strings"
57 When enabled expect strings which are started with a dash trigger
58 no-fail mode. That is when expectation is not met within timeout
59 the script is not terminated but sends next SEND string and waits
60 for next EXPECT string. This allows to compose far more flexible
63 config FEATURE_CHAT_TTY_HIFI
64 bool "Force STDIN to be a TTY"
68 Original chat always treats STDIN as a TTY device and sets for it
69 so-called raw mode. This option turns on such behaviour.
71 config FEATURE_CHAT_IMPLICIT_CR
72 bool "Enable implicit Carriage Return"
76 When enabled make chat to terminate all SEND strings with a "\r"
77 unless "\c" is met anywhere in the string.
79 config FEATURE_CHAT_SWALLOW_OPTS
80 bool "Swallow options"
84 Busybox chat require no options. To make it not fail when used
85 in place of original chat (which has a bunch of options) turn
88 config FEATURE_CHAT_SEND_ESCAPES
89 bool "Support weird SEND escapes"
93 Original chat uses some escape sequences in SEND arguments which
94 are not sent to device but rather performs special actions.
95 E.g. "\K" means to send a break sequence to device.
96 "\d" delays execution for a second, "\p" -- for a 1/100 of second.
97 Before turning this option on think twice: do you really need them?
99 config FEATURE_CHAT_VAR_ABORT_LEN
100 bool "Support variable-length ABORT conditions"
104 Original chat uses fixed 50-bytes length ABORT conditions. Say N here.
106 config FEATURE_CHAT_CLR_ABORT
107 bool "Support revoking of ABORT conditions"
111 Support CLR_ABORT directive.
117 manipulate real-time attributes of a process.
118 This requires sched_{g,s}etparam support in your libc.
124 select FEATURE_SYSLOG
126 Crond is a background daemon that parses individual crontab
127 files and executes commands on behalf of the users in question.
128 This is a port of dcron from slackware. It uses files of the
129 format /var/spool/cron/crontabs/<username> files, for example:
130 $ cat /var/spool/cron/crontabs/root
131 # Run daily cron jobs at 4:40 every day:
132 40 4 * * * /etc/cron/daily > /dev/null 2>&1
134 config FEATURE_CROND_D
135 bool "Support option -d to redirect output to stderr"
139 -d sets loglevel to 0 (most verbose) and directs all output to stderr.
141 config FEATURE_CROND_CALL_SENDMAIL
142 bool "Report command output via email (using sendmail)"
146 Command output will be sent to corresponding user via email.
148 config FEATURE_CROND_DIR
149 string "crond spool directory"
150 default "/var/spool/cron"
151 depends on CROND || CRONTAB
153 Location of crond spool.
160 Crontab manipulates the crontab for a particular user. Only
161 the superuser may specify a different user and/or crontab directory.
162 Note that Busybox binary must be setuid root for this applet to
169 Dc is a reverse-polish desk calculator which supports unlimited
170 precision arithmetic.
172 config FEATURE_DC_LIBM
173 bool "Enable power and exp functions (requires libm)"
177 Enable power and exp functions.
178 NOTE: This will require libm to be present for linking.
181 bool "devfsd (obsolete)"
183 select FEATURE_SYSLOG
185 This is deprecated and should NOT be used anymore.
186 Use linux >= 2.6 (optionally with hotplug) and mdev instead!
187 See docs/mdev.txt for detailed instructions on how to use mdev
190 Provides compatibility with old device names on a devfs systems.
191 You should set it to true if you have devfs enabled.
192 The following keywords in devsfd.conf are supported:
193 "CLEAR_CONFIG", "INCLUDE", "OPTIONAL_INCLUDE", "RESTORE",
194 "PERMISSIONS", "EXECUTE", "COPY", "IGNORE",
195 "MKOLDCOMPAT", "MKNEWCOMPAT","RMOLDCOMPAT", "RMNEWCOMPAT".
197 But only if they are written UPPERCASE!!!!!!!!
199 config DEVFSD_MODLOAD
200 bool "Adds support for MODLOAD keyword in devsfd.conf"
204 This actually doesn't work with busybox modutils but needs
205 the external modutils.
208 bool "Enables the -fg and -np options"
212 -fg Run the daemon in the foreground.
213 -np Exit after parsing the configuration file.
214 Do not poll for events.
216 config DEVFSD_VERBOSE
217 bool "Increases logging (and size)"
221 Increases logging to stderr or syslog.
224 bool "Use devfs names for all devices (obsolete)"
227 This is obsolete and should NOT be used anymore.
228 Use linux >= 2.6 (optionally with hotplug) and mdev instead!
230 For legacy systems -- if there is no way around devfsd -- this
231 tells busybox to look for names like /dev/loop/0 instead of
232 /dev/loop0. If your /dev directory has normal names instead of
233 devfs names, you don't want this.
239 devmem is a small program that reads and writes from physical
240 memory using /dev/mem.
246 Used to eject cdroms. (defaults to /dev/cdrom)
248 config FEATURE_EJECT_SCSI
253 Add the -s option to eject, this allows to eject SCSI-Devices and
260 Shows splash image and progress bar on framebuffer device.
261 Can be used during boot phase of an embedded device. ~2kb.
263 - use kernel option 'vga=xxx' or otherwise enable fb device.
264 - put somewhere fbsplash.cfg file and an image in .ppm format.
265 - $ setsid fbsplash [params] &
267 -d /dev/fbN: framebuffer device (if not /dev/fb0)
268 -s path_to_image_file (can be "-" for stdin)
269 -i path_to_cfg_file (can be "-" for stdin)
270 -f path_to_fifo (can be "-" for stdin)
271 - if you want to run it only in presence of kernel parameter:
272 grep -q "fbsplash=on" </proc/cmdline && setsid fbsplash [params] &
274 "NN" (ASCII decimal number) - percentage to show on progress bar
275 "exit" - well you guessed it
281 The flashcp binary, inspired by mtd-utils as of git head 5eceb74f7.
282 This utility is used to copy images into a MTD device.
288 The flash_lock binary from mtd-utils as of git head 5ec0c10d0. This
289 utility locks part or all of the flash device.
295 The flash_unlock binary from mtd-utils as of git head 5ec0c10d0. This
296 utility unlocks part or all of the flash device.
298 config FLASH_ERASEALL
299 bool "flash_eraseall"
302 The flash_eraseall binary from mtd-utils as of git head c4c6a59eb.
303 This utility is used to erase the whole MTD device.
309 Set/set program io scheduling class and priority
310 Requires kernel >= 2.6.13
316 Simple inotify daemon. Reports filesystem changes. Requires
322 depends on FEATURE_WTMP
324 'last' displays a list of the last users that logged into the system.
327 prompt "Choose last implementation"
329 default FEATURE_LAST_FANCY
331 config FEATURE_LAST_SMALL
334 This is a small version of last with just the basic set of
337 config FEATURE_LAST_FANCY
340 'last' displays detailed information about the last users that
341 logged into the system (mimics sysvinit last). +900 bytes.
348 'less' is a pager, meaning that it displays text files. It possesses
349 a wide array of features, and is an improvement over 'more'.
351 config FEATURE_LESS_MAXLINES
352 int "Max number of input lines less will try to eat"
356 config FEATURE_LESS_BRACKETS
357 bool "Enable bracket searching"
361 This option adds the capability to search for matching left and right
362 brackets, facilitating programming.
364 config FEATURE_LESS_FLAGS
365 bool "Enable extra flags"
369 The extra flags provided do the following:
371 The -M flag enables a more sophisticated status line.
372 The -m flag enables a simpler status line with a percentage.
374 config FEATURE_LESS_MARKS
379 Marks enable positions in a file to be stored for easy reference.
381 config FEATURE_LESS_REGEXP
382 bool "Enable regular expressions"
386 Enable regular expressions, allowing complex file searches.
388 config FEATURE_LESS_WINCH
389 bool "Enable automatic resizing on window size changes"
393 Makes less track window size changes.
395 config FEATURE_LESS_DASHCMD
396 bool "Enable flag changes ('-' command)"
400 This enables the ability to change command-line flags within
401 less itself ('-' keyboard command).
403 config FEATURE_LESS_LINENUMS
404 bool "Enable dynamic switching of line numbers"
406 depends on FEATURE_LESS_DASHCMD
414 Get/Set hard drive parameters. Primarily intended for ATA
415 drives. Adds about 13k (or around 30k if you enable the
416 FEATURE_HDPARM_GET_IDENTITY option)....
418 config FEATURE_HDPARM_GET_IDENTITY
419 bool "Support obtaining detailed information directly from drives"
423 Enables the -I and -i options to obtain detailed information
424 directly from drives about their capabilities and supported ATA
425 feature set. If no device name is specified, hdparm will read
426 identify data from stdin. Enabling this option will add about 16k...
428 config FEATURE_HDPARM_HDIO_SCAN_HWIF
429 bool "Register an IDE interface (DANGEROUS)"
433 Enables the 'hdparm -R' option to register an IDE interface.
434 This is dangerous stuff, so you should probably say N.
436 config FEATURE_HDPARM_HDIO_UNREGISTER_HWIF
437 bool "Un-register an IDE interface (DANGEROUS)"
441 Enables the 'hdparm -U' option to un-register an IDE interface.
442 This is dangerous stuff, so you should probably say N.
444 config FEATURE_HDPARM_HDIO_DRIVE_RESET
445 bool "Perform device reset (DANGEROUS)"
449 Enables the 'hdparm -w' option to perform a device reset.
450 This is dangerous stuff, so you should probably say N.
452 config FEATURE_HDPARM_HDIO_TRISTATE_HWIF
453 bool "Tristate device for hotswap (DANGEROUS)"
457 Enables the 'hdparm -x' option to tristate device for hotswap,
458 and the '-b' option to get/set bus state. This is dangerous
459 stuff, so you should probably say N.
461 config FEATURE_HDPARM_HDIO_GETSET_DMA
462 bool "Get/set using_dma flag"
466 Enables the 'hdparm -d' option to get/set using_dma flag.
472 'makedevs' is a utility used to create a batch of devices with
475 There are two choices for command line behaviour, the interface
476 as used by LEAF/Linux Router Project, or a device table file.
478 'leaf' is traditionally what busybox follows, it allows multiple
479 devices of a particluar type to be created per command.
481 Device properties are passed as command line arguments.
483 'table' reads device properties from a file or stdin, allowing
484 a batch of unrelated devices to be made with one command.
485 User/group names are allowed as an alternative to uid/gid.
488 prompt "Choose makedevs behaviour"
490 default FEATURE_MAKEDEVS_TABLE
492 config FEATURE_MAKEDEVS_LEAF
495 config FEATURE_MAKEDEVS_TABLE
504 Format and display manual pages.
510 The poor man's minicom utility for chatting with serial port devices.
516 mountpoint checks if the directory is a mountpoint.
522 mt is used to control tape devices. You can use the mt utility
523 to advance or rewind a tape past a specified number of archive
530 raidautorun tells the kernel md driver to
531 search and start RAID arrays.
538 Preload the files listed on the command line into RAM cache so that
539 subsequent reads on these files will not block on disk I/O.
541 This applet just calls the readahead(2) system call on each file.
542 It is mainly useful in system startup scripts to preload files
543 or executables before they are used. When used at the right time
544 (in particular when a CPU bound process is running) it can
545 significantly speed up system startup.
547 As readahead(2) blocks until each file has been read, it is best to
548 run this applet as a background job.
554 Enable/disable wireless devices.
556 rfkill list : list all wireless devices
557 rfkill list bluetooth : list all bluetooth devices
558 rfkill list 1 : list device corresponding to the given index
559 rfkill block|unblock wlan : block/unblock all wlan(wifi) devices
565 find the current and previous system runlevel.
567 This applet uses utmp but does not rely on busybox supporing
568 utmp on purpose. It is used by e.g. emdebian via /etc/init.d/rc.
574 Receive files using the Xmodem protocol.
580 setsid runs a program in a new session
586 strings prints the printable character sequences for each file
593 Retrieve or set a processes's CPU affinity.
594 This requires sched_{g,s}etaffinity support in your libc.
596 config FEATURE_TASKSET_FANCY
601 Add code for fancy output. This merely silences a compiler-warning
602 and adds about 135 Bytes. May be needed for machines with alot
609 The time command runs the specified program with the given arguments.
610 When the command finishes, time writes a message to standard output
611 giving timing statistics about this program run.
617 Runs a program and watches it. If it does not terminate in
618 specified number of seconds, it is sent a signal.
624 A replacement for "stty size". Unlike stty, can report only width,
625 only height, or both, in any order. It also does not complain on
626 error, but returns default 80x24.
627 Usage in shell scripts: width=`ttysize w`.
633 Prints a CD-ROM volume name.
639 Write a message to all users that are logged in.
645 The watchdog utility is used with hardware or software watchdog
646 device drivers. It opens the specified watchdog device special file
647 and periodically writes a magic character to the device. If the
648 watchdog applet ever fails to write the magic character within a
649 certain amount of time, the watchdog device assumes the system has
650 hung, and will cause the hardware to reboot.