2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
6 menu "Miscellaneous Utilities"
13 depends on PLATFORM_LINUX
15 Adjtimex reads and optionally sets adjustment parameters for
16 the Linux clock adjustment algorithm.
22 The bbconfig applet will print the config file with which
28 depends on PLATFORM_LINUX
30 The beep applets beeps in a given freq/Hz.
32 config FEATURE_BEEP_FREQ
33 int "default frequency"
38 Frequency for default beep.
40 config FEATURE_BEEP_LENGTH_MS
46 Length in ms for default beep.
54 config FEATURE_CHAT_NOFAIL
55 bool "Enable NOFAIL expect strings"
59 When enabled expect strings which are started with a dash trigger
60 no-fail mode. That is when expectation is not met within timeout
61 the script is not terminated but sends next SEND string and waits
62 for next EXPECT string. This allows to compose far more flexible
65 config FEATURE_CHAT_TTY_HIFI
66 bool "Force STDIN to be a TTY"
70 Original chat always treats STDIN as a TTY device and sets for it
71 so-called raw mode. This option turns on such behaviour.
73 config FEATURE_CHAT_IMPLICIT_CR
74 bool "Enable implicit Carriage Return"
78 When enabled make chat to terminate all SEND strings with a "\r"
79 unless "\c" is met anywhere in the string.
81 config FEATURE_CHAT_SWALLOW_OPTS
82 bool "Swallow options"
86 Busybox chat require no options. To make it not fail when used
87 in place of original chat (which has a bunch of options) turn
90 config FEATURE_CHAT_SEND_ESCAPES
91 bool "Support weird SEND escapes"
95 Original chat uses some escape sequences in SEND arguments which
96 are not sent to device but rather performs special actions.
97 E.g. "\K" means to send a break sequence to device.
98 "\d" delays execution for a second, "\p" -- for a 1/100 of second.
99 Before turning this option on think twice: do you really need them?
101 config FEATURE_CHAT_VAR_ABORT_LEN
102 bool "Support variable-length ABORT conditions"
106 Original chat uses fixed 50-bytes length ABORT conditions. Say N here.
108 config FEATURE_CHAT_CLR_ABORT
109 bool "Support revoking of ABORT conditions"
113 Support CLR_ABORT directive.
119 manipulate real-time attributes of a process.
120 This requires sched_{g,s}etparam support in your libc.
126 select FEATURE_SYSLOG
128 Crond is a background daemon that parses individual crontab
129 files and executes commands on behalf of the users in question.
130 This is a port of dcron from slackware. It uses files of the
131 format /var/spool/cron/crontabs/<username> files, for example:
132 $ cat /var/spool/cron/crontabs/root
133 # Run daily cron jobs at 4:40 every day:
134 40 4 * * * /etc/cron/daily > /dev/null 2>&1
136 config FEATURE_CROND_D
137 bool "Support option -d to redirect output to stderr"
141 -d sets loglevel to 0 (most verbose) and directs all output to stderr.
143 config FEATURE_CROND_CALL_SENDMAIL
144 bool "Report command output via email (using sendmail)"
148 Command output will be sent to corresponding user via email.
150 config FEATURE_CROND_DIR
151 string "crond spool directory"
152 default "/var/spool/cron"
153 depends on CROND || CRONTAB
155 Location of crond spool.
162 Crontab manipulates the crontab for a particular user. Only
163 the superuser may specify a different user and/or crontab directory.
164 Note that Busybox binary must be setuid root for this applet to
171 Dc is a reverse-polish desk calculator which supports unlimited
172 precision arithmetic.
174 config FEATURE_DC_LIBM
175 bool "Enable power and exp functions (requires libm)"
179 Enable power and exp functions.
180 NOTE: This will require libm to be present for linking.
183 bool "devfsd (obsolete)"
185 depends on PLATFORM_LINUX
186 select FEATURE_SYSLOG
188 This is deprecated and should NOT be used anymore.
189 Use linux >= 2.6 (optionally with hotplug) and mdev instead!
190 See docs/mdev.txt for detailed instructions on how to use mdev
193 Provides compatibility with old device names on a devfs systems.
194 You should set it to true if you have devfs enabled.
195 The following keywords in devsfd.conf are supported:
196 "CLEAR_CONFIG", "INCLUDE", "OPTIONAL_INCLUDE", "RESTORE",
197 "PERMISSIONS", "EXECUTE", "COPY", "IGNORE",
198 "MKOLDCOMPAT", "MKNEWCOMPAT","RMOLDCOMPAT", "RMNEWCOMPAT".
200 But only if they are written UPPERCASE!!!!!!!!
202 config DEVFSD_MODLOAD
203 bool "Adds support for MODLOAD keyword in devsfd.conf"
207 This actually doesn't work with busybox modutils but needs
208 the external modutils.
211 bool "Enables the -fg and -np options"
215 -fg Run the daemon in the foreground.
216 -np Exit after parsing the configuration file.
217 Do not poll for events.
219 config DEVFSD_VERBOSE
220 bool "Increases logging (and size)"
224 Increases logging to stderr or syslog.
227 bool "Use devfs names for all devices (obsolete)"
229 depends on PLATFORM_LINUX
231 This is obsolete and should NOT be used anymore.
232 Use linux >= 2.6 (optionally with hotplug) and mdev instead!
234 For legacy systems -- if there is no way around devfsd -- this
235 tells busybox to look for names like /dev/loop/0 instead of
236 /dev/loop0. If your /dev directory has normal names instead of
237 devfs names, you don't want this.
243 devmem is a small program that reads and writes from physical
244 memory using /dev/mem.
249 depends on PLATFORM_LINUX
251 Used to eject cdroms. (defaults to /dev/cdrom)
253 config FEATURE_EJECT_SCSI
258 Add the -s option to eject, this allows to eject SCSI-Devices and
264 depends on PLATFORM_LINUX
266 Shows splash image and progress bar on framebuffer device.
267 Can be used during boot phase of an embedded device. ~2kb.
269 - use kernel option 'vga=xxx' or otherwise enable fb device.
270 - put somewhere fbsplash.cfg file and an image in .ppm format.
271 - $ setsid fbsplash [params] &
273 -d /dev/fbN: framebuffer device (if not /dev/fb0)
274 -s path_to_image_file (can be "-" for stdin)
275 -i path_to_cfg_file (can be "-" for stdin)
276 -f path_to_fifo (can be "-" for stdin)
277 - if you want to run it only in presence of kernel parameter:
278 grep -q "fbsplash=on" </proc/cmdline && setsid fbsplash [params] &
280 "NN" (ASCII decimal number) - percentage to show on progress bar
281 "exit" - well you guessed it
285 default n # doesn't build on Ubuntu 8.04
287 The flashcp binary, inspired by mtd-utils as of git head 5eceb74f7.
288 This utility is used to copy images into a MTD device.
292 default n # doesn't build on Ubuntu 8.04
294 The flash_lock binary from mtd-utils as of git head 5ec0c10d0. This
295 utility locks part or all of the flash device.
299 default n # doesn't build on Ubuntu 8.04
301 The flash_unlock binary from mtd-utils as of git head 5ec0c10d0. This
302 utility unlocks part or all of the flash device.
304 config FLASH_ERASEALL
305 bool "flash_eraseall"
306 default n # doesn't build on Ubuntu 8.04
308 The flash_eraseall binary from mtd-utils as of git head c4c6a59eb.
309 This utility is used to erase the whole MTD device.
314 depends on PLATFORM_LINUX
316 Set/set program io scheduling class and priority
317 Requires kernel >= 2.6.13
321 default n # doesn't build on Knoppix 5
323 Simple inotify daemon. Reports filesystem changes. Requires
329 depends on FEATURE_WTMP
331 'last' displays a list of the last users that logged into the system.
334 prompt "Choose last implementation"
336 default FEATURE_LAST_FANCY
338 config FEATURE_LAST_SMALL
341 This is a small version of last with just the basic set of
344 config FEATURE_LAST_FANCY
347 'last' displays detailed information about the last users that
348 logged into the system (mimics sysvinit last). +900 bytes.
354 depends on PLATFORM_LINUX
355 depends on PLATFORM_LINUX
356 depends on PLATFORM_LINUX
357 depends on PLATFORM_LINUX
358 depends on PLATFORM_LINUX
360 'less' is a pager, meaning that it displays text files. It possesses
361 a wide array of features, and is an improvement over 'more'.
363 config FEATURE_LESS_MAXLINES
364 int "Max number of input lines less will try to eat"
368 config FEATURE_LESS_BRACKETS
369 bool "Enable bracket searching"
373 This option adds the capability to search for matching left and right
374 brackets, facilitating programming.
376 config FEATURE_LESS_FLAGS
377 bool "Enable extra flags"
381 The extra flags provided do the following:
383 The -M flag enables a more sophisticated status line.
384 The -m flag enables a simpler status line with a percentage.
386 config FEATURE_LESS_MARKS
391 Marks enable positions in a file to be stored for easy reference.
393 config FEATURE_LESS_REGEXP
394 bool "Enable regular expressions"
398 Enable regular expressions, allowing complex file searches.
400 config FEATURE_LESS_WINCH
401 bool "Enable automatic resizing on window size changes"
405 Makes less track window size changes.
407 config FEATURE_LESS_DASHCMD
408 bool "Enable flag changes ('-' command)"
412 This enables the ability to change command-line flags within
413 less itself ('-' keyboard command).
415 config FEATURE_LESS_LINENUMS
416 bool "Enable dynamic switching of line numbers"
418 depends on FEATURE_LESS_DASHCMD
425 depends on PLATFORM_LINUX
427 Get/Set hard drive parameters. Primarily intended for ATA
428 drives. Adds about 13k (or around 30k if you enable the
429 FEATURE_HDPARM_GET_IDENTITY option)....
431 config FEATURE_HDPARM_GET_IDENTITY
432 bool "Support obtaining detailed information directly from drives"
436 Enables the -I and -i options to obtain detailed information
437 directly from drives about their capabilities and supported ATA
438 feature set. If no device name is specified, hdparm will read
439 identify data from stdin. Enabling this option will add about 16k...
441 config FEATURE_HDPARM_HDIO_SCAN_HWIF
442 bool "Register an IDE interface (DANGEROUS)"
446 Enables the 'hdparm -R' option to register an IDE interface.
447 This is dangerous stuff, so you should probably say N.
449 config FEATURE_HDPARM_HDIO_UNREGISTER_HWIF
450 bool "Un-register an IDE interface (DANGEROUS)"
454 Enables the 'hdparm -U' option to un-register an IDE interface.
455 This is dangerous stuff, so you should probably say N.
457 config FEATURE_HDPARM_HDIO_DRIVE_RESET
458 bool "Perform device reset (DANGEROUS)"
462 Enables the 'hdparm -w' option to perform a device reset.
463 This is dangerous stuff, so you should probably say N.
465 config FEATURE_HDPARM_HDIO_TRISTATE_HWIF
466 bool "Tristate device for hotswap (DANGEROUS)"
470 Enables the 'hdparm -x' option to tristate device for hotswap,
471 and the '-b' option to get/set bus state. This is dangerous
472 stuff, so you should probably say N.
474 config FEATURE_HDPARM_HDIO_GETSET_DMA
475 bool "Get/set using_dma flag"
479 Enables the 'hdparm -d' option to get/set using_dma flag.
485 'makedevs' is a utility used to create a batch of devices with
488 There are two choices for command line behaviour, the interface
489 as used by LEAF/Linux Router Project, or a device table file.
491 'leaf' is traditionally what busybox follows, it allows multiple
492 devices of a particluar type to be created per command.
494 Device properties are passed as command line arguments.
496 'table' reads device properties from a file or stdin, allowing
497 a batch of unrelated devices to be made with one command.
498 User/group names are allowed as an alternative to uid/gid.
501 prompt "Choose makedevs behaviour"
503 default FEATURE_MAKEDEVS_TABLE
505 config FEATURE_MAKEDEVS_LEAF
508 config FEATURE_MAKEDEVS_TABLE
517 Format and display manual pages.
523 The poor man's minicom utility for chatting with serial port devices.
529 mountpoint checks if the directory is a mountpoint.
535 mt is used to control tape devices. You can use the mt utility
536 to advance or rewind a tape past a specified number of archive
542 depends on PLATFORM_LINUX
544 raidautorun tells the kernel md driver to
545 search and start RAID arrays.
550 depends on LFS && PLATFORM_LINUX
552 Preload the files listed on the command line into RAM cache so that
553 subsequent reads on these files will not block on disk I/O.
555 This applet just calls the readahead(2) system call on each file.
556 It is mainly useful in system startup scripts to preload files
557 or executables before they are used. When used at the right time
558 (in particular when a CPU bound process is running) it can
559 significantly speed up system startup.
561 As readahead(2) blocks until each file has been read, it is best to
562 run this applet as a background job.
566 default n # doesn't build on Ubuntu 9.04
567 depends on PLATFORM_LINUX
569 Enable/disable wireless devices.
571 rfkill list : list all wireless devices
572 rfkill list bluetooth : list all bluetooth devices
573 rfkill list 1 : list device corresponding to the given index
574 rfkill block|unblock wlan : block/unblock all wlan(wifi) devices
580 find the current and previous system runlevel.
582 This applet uses utmp but does not rely on busybox supporing
583 utmp on purpose. It is used by e.g. emdebian via /etc/init.d/rc.
588 depends on PLATFORM_LINUX
590 Receive files using the Xmodem protocol.
596 setsid runs a program in a new session
602 strings prints the printable character sequences for each file
607 default n # doesn't build on some non-x86 targets (m68k)
609 Retrieve or set a processes's CPU affinity.
610 This requires sched_{g,s}etaffinity support in your libc.
612 config FEATURE_TASKSET_FANCY
617 Add code for fancy output. This merely silences a compiler-warning
618 and adds about 135 Bytes. May be needed for machines with alot
625 The time command runs the specified program with the given arguments.
626 When the command finishes, time writes a message to standard output
627 giving timing statistics about this program run.
633 Runs a program and watches it. If it does not terminate in
634 specified number of seconds, it is sent a signal.
640 A replacement for "stty size". Unlike stty, can report only width,
641 only height, or both, in any order. It also does not complain on
642 error, but returns default 80x24.
643 Usage in shell scripts: width=`ttysize w`.
649 Prints a CD-ROM volume name.
655 Write a message to all users that are logged in.
660 depends on PLATFORM_LINUX
662 The watchdog utility is used with hardware or software watchdog
663 device drivers. It opens the specified watchdog device special file
664 and periodically writes a magic character to the device. If the
665 watchdog applet ever fails to write the magic character within a
666 certain amount of time, the watchdog device assumes the system has
667 hung, and will cause the hardware to reboot.