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
25 config FEATURE_COMPRESS_BBCONFIG
26 bool "Compress bbconfig data"
30 Store bbconfig data in compressed form, uncompress them on-the-fly
33 If you have a really tiny busybox with few applets enabled (and
34 bunzip2 isn't one of them), the overhead of the decompressor might
35 be noticeable. Also, if you run executables directly from ROM
36 and have very little memory, this might not be a win. Otherwise,
37 you probably want this.
42 depends on PLATFORM_LINUX
44 The beep applets beeps in a given freq/Hz.
46 config FEATURE_BEEP_FREQ
47 int "default frequency"
52 Frequency for default beep.
54 config FEATURE_BEEP_LENGTH_MS
60 Length in ms for default beep.
68 config FEATURE_CHAT_NOFAIL
69 bool "Enable NOFAIL expect strings"
73 When enabled expect strings which are started with a dash trigger
74 no-fail mode. That is when expectation is not met within timeout
75 the script is not terminated but sends next SEND string and waits
76 for next EXPECT string. This allows to compose far more flexible
79 config FEATURE_CHAT_TTY_HIFI
80 bool "Force STDIN to be a TTY"
84 Original chat always treats STDIN as a TTY device and sets for it
85 so-called raw mode. This option turns on such behaviour.
87 config FEATURE_CHAT_IMPLICIT_CR
88 bool "Enable implicit Carriage Return"
92 When enabled make chat to terminate all SEND strings with a "\r"
93 unless "\c" is met anywhere in the string.
95 config FEATURE_CHAT_SWALLOW_OPTS
96 bool "Swallow options"
100 Busybox chat require no options. To make it not fail when used
101 in place of original chat (which has a bunch of options) turn
104 config FEATURE_CHAT_SEND_ESCAPES
105 bool "Support weird SEND escapes"
109 Original chat uses some escape sequences in SEND arguments which
110 are not sent to device but rather performs special actions.
111 E.g. "\K" means to send a break sequence to device.
112 "\d" delays execution for a second, "\p" -- for a 1/100 of second.
113 Before turning this option on think twice: do you really need them?
115 config FEATURE_CHAT_VAR_ABORT_LEN
116 bool "Support variable-length ABORT conditions"
120 Original chat uses fixed 50-bytes length ABORT conditions. Say N here.
122 config FEATURE_CHAT_CLR_ABORT
123 bool "Support revoking of ABORT conditions"
127 Support CLR_ABORT directive.
133 manipulate real-time attributes of a process.
134 This requires sched_{g,s}etparam support in your libc.
140 select FEATURE_SYSLOG
142 Crond is a background daemon that parses individual crontab
143 files and executes commands on behalf of the users in question.
144 This is a port of dcron from slackware. It uses files of the
145 format /var/spool/cron/crontabs/<username> files, for example:
146 $ cat /var/spool/cron/crontabs/root
147 # Run daily cron jobs at 4:40 every day:
148 40 4 * * * /etc/cron/daily > /dev/null 2>&1
150 config FEATURE_CROND_D
151 bool "Support option -d to redirect output to stderr"
155 -d sets loglevel to 0 (most verbose) and directs all output to stderr.
157 config FEATURE_CROND_CALL_SENDMAIL
158 bool "Report command output via email (using sendmail)"
162 Command output will be sent to corresponding user via email.
164 config FEATURE_CROND_DIR
165 string "crond spool directory"
166 default "/var/spool/cron"
167 depends on CROND || CRONTAB
169 Location of crond spool.
176 Crontab manipulates the crontab for a particular user. Only
177 the superuser may specify a different user and/or crontab directory.
178 Note that Busybox binary must be setuid root for this applet to
185 Dc is a reverse-polish desk calculator which supports unlimited
186 precision arithmetic.
188 config FEATURE_DC_LIBM
189 bool "Enable power and exp functions (requires libm)"
193 Enable power and exp functions.
194 NOTE: This will require libm to be present for linking.
197 bool "devfsd (obsolete)"
199 depends on PLATFORM_LINUX
200 select FEATURE_SYSLOG
202 This is deprecated and should NOT be used anymore.
203 Use linux >= 2.6 (optionally with hotplug) and mdev instead!
204 See docs/mdev.txt for detailed instructions on how to use mdev
207 Provides compatibility with old device names on a devfs systems.
208 You should set it to true if you have devfs enabled.
209 The following keywords in devsfd.conf are supported:
210 "CLEAR_CONFIG", "INCLUDE", "OPTIONAL_INCLUDE", "RESTORE",
211 "PERMISSIONS", "EXECUTE", "COPY", "IGNORE",
212 "MKOLDCOMPAT", "MKNEWCOMPAT","RMOLDCOMPAT", "RMNEWCOMPAT".
214 But only if they are written UPPERCASE!!!!!!!!
216 config DEVFSD_MODLOAD
217 bool "Adds support for MODLOAD keyword in devsfd.conf"
221 This actually doesn't work with busybox modutils but needs
222 the external modutils.
225 bool "Enables the -fg and -np options"
229 -fg Run the daemon in the foreground.
230 -np Exit after parsing the configuration file.
231 Do not poll for events.
233 config DEVFSD_VERBOSE
234 bool "Increases logging (and size)"
238 Increases logging to stderr or syslog.
241 bool "Use devfs names for all devices (obsolete)"
243 depends on PLATFORM_LINUX
245 This is obsolete and should NOT be used anymore.
246 Use linux >= 2.6 (optionally with hotplug) and mdev instead!
248 For legacy systems -- if there is no way around devfsd -- this
249 tells busybox to look for names like /dev/loop/0 instead of
250 /dev/loop0. If your /dev directory has normal names instead of
251 devfs names, you don't want this.
257 devmem is a small program that reads and writes from physical
258 memory using /dev/mem.
263 depends on PLATFORM_LINUX
265 Used to eject cdroms. (defaults to /dev/cdrom)
267 config FEATURE_EJECT_SCSI
272 Add the -s option to eject, this allows to eject SCSI-Devices and
278 depends on PLATFORM_LINUX
280 Shows splash image and progress bar on framebuffer device.
281 Can be used during boot phase of an embedded device. ~2kb.
283 - use kernel option 'vga=xxx' or otherwise enable fb device.
284 - put somewhere fbsplash.cfg file and an image in .ppm format.
285 - $ setsid fbsplash [params] &
287 -d /dev/fbN: framebuffer device (if not /dev/fb0)
288 -s path_to_image_file (can be "-" for stdin)
289 -i path_to_cfg_file (can be "-" for stdin)
290 -f path_to_fifo (can be "-" for stdin)
291 - if you want to run it only in presence of kernel parameter:
292 grep -q "fbsplash=on" </proc/cmdline && setsid fbsplash [params] &
294 "NN" (ASCII decimal number) - percentage to show on progress bar
295 "exit" - well you guessed it
299 default n # doesn't build on Ubuntu 8.04
301 The flashcp binary, inspired by mtd-utils as of git head 5eceb74f7.
302 This utility is used to copy images into a MTD device.
306 default n # doesn't build on Ubuntu 8.04
308 The flash_lock binary from mtd-utils as of git head 5ec0c10d0. This
309 utility locks part or all of the flash device.
313 default n # doesn't build on Ubuntu 8.04
315 The flash_unlock binary from mtd-utils as of git head 5ec0c10d0. This
316 utility unlocks part or all of the flash device.
318 config FLASH_ERASEALL
319 bool "flash_eraseall"
320 default n # doesn't build on Ubuntu 8.04
322 The flash_eraseall binary from mtd-utils as of git head c4c6a59eb.
323 This utility is used to erase the whole MTD device.
328 depends on PLATFORM_LINUX
330 Set/set program io scheduling class and priority
331 Requires kernel >= 2.6.13
335 default n # doesn't build on Knoppix 5
337 Simple inotify daemon. Reports filesystem changes. Requires
343 depends on FEATURE_WTMP
345 'last' displays a list of the last users that logged into the system.
348 prompt "Choose last implementation"
350 default FEATURE_LAST_FANCY
352 config FEATURE_LAST_SMALL
355 This is a small version of last with just the basic set of
358 config FEATURE_LAST_FANCY
361 'last' displays detailed information about the last users that
362 logged into the system (mimics sysvinit last). +900 bytes.
369 'less' is a pager, meaning that it displays text files. It possesses
370 a wide array of features, and is an improvement over 'more'.
372 config FEATURE_LESS_MAXLINES
373 int "Max number of input lines less will try to eat"
377 config FEATURE_LESS_BRACKETS
378 bool "Enable bracket searching"
382 This option adds the capability to search for matching left and right
383 brackets, facilitating programming.
385 config FEATURE_LESS_FLAGS
386 bool "Enable extra flags"
390 The extra flags provided do the following:
392 The -M flag enables a more sophisticated status line.
393 The -m flag enables a simpler status line with a percentage.
395 config FEATURE_LESS_MARKS
400 Marks enable positions in a file to be stored for easy reference.
402 config FEATURE_LESS_REGEXP
403 bool "Enable regular expressions"
407 Enable regular expressions, allowing complex file searches.
409 config FEATURE_LESS_WINCH
410 bool "Enable automatic resizing on window size changes"
414 Makes less track window size changes.
416 config FEATURE_LESS_DASHCMD
417 bool "Enable flag changes ('-' command)"
421 This enables the ability to change command-line flags within
422 less itself ('-' keyboard command).
424 config FEATURE_LESS_LINENUMS
425 bool "Enable dynamic switching of line numbers"
427 depends on FEATURE_LESS_DASHCMD
429 Enables "-N" command.
434 depends on PLATFORM_LINUX
436 Get/Set hard drive parameters. Primarily intended for ATA
437 drives. Adds about 13k (or around 30k if you enable the
438 FEATURE_HDPARM_GET_IDENTITY option)....
440 config FEATURE_HDPARM_GET_IDENTITY
441 bool "Support obtaining detailed information directly from drives"
445 Enables the -I and -i options to obtain detailed information
446 directly from drives about their capabilities and supported ATA
447 feature set. If no device name is specified, hdparm will read
448 identify data from stdin. Enabling this option will add about 16k...
450 config FEATURE_HDPARM_HDIO_SCAN_HWIF
451 bool "Register an IDE interface (DANGEROUS)"
455 Enables the 'hdparm -R' option to register an IDE interface.
456 This is dangerous stuff, so you should probably say N.
458 config FEATURE_HDPARM_HDIO_UNREGISTER_HWIF
459 bool "Un-register an IDE interface (DANGEROUS)"
463 Enables the 'hdparm -U' option to un-register an IDE interface.
464 This is dangerous stuff, so you should probably say N.
466 config FEATURE_HDPARM_HDIO_DRIVE_RESET
467 bool "Perform device reset (DANGEROUS)"
471 Enables the 'hdparm -w' option to perform a device reset.
472 This is dangerous stuff, so you should probably say N.
474 config FEATURE_HDPARM_HDIO_TRISTATE_HWIF
475 bool "Tristate device for hotswap (DANGEROUS)"
479 Enables the 'hdparm -x' option to tristate device for hotswap,
480 and the '-b' option to get/set bus state. This is dangerous
481 stuff, so you should probably say N.
483 config FEATURE_HDPARM_HDIO_GETSET_DMA
484 bool "Get/set using_dma flag"
488 Enables the 'hdparm -d' option to get/set using_dma flag.
494 'makedevs' is a utility used to create a batch of devices with
497 There are two choices for command line behaviour, the interface
498 as used by LEAF/Linux Router Project, or a device table file.
500 'leaf' is traditionally what busybox follows, it allows multiple
501 devices of a particluar type to be created per command.
503 Device properties are passed as command line arguments.
505 'table' reads device properties from a file or stdin, allowing
506 a batch of unrelated devices to be made with one command.
507 User/group names are allowed as an alternative to uid/gid.
510 prompt "Choose makedevs behaviour"
512 default FEATURE_MAKEDEVS_TABLE
514 config FEATURE_MAKEDEVS_LEAF
517 config FEATURE_MAKEDEVS_TABLE
526 Format and display manual pages.
532 The poor man's minicom utility for chatting with serial port devices.
538 mountpoint checks if the directory is a mountpoint.
544 mt is used to control tape devices. You can use the mt utility
545 to advance or rewind a tape past a specified number of archive
551 depends on PLATFORM_LINUX
553 raidautorun tells the kernel md driver to
554 search and start RAID arrays.
559 depends on LFS && PLATFORM_LINUX
561 Preload the files listed on the command line into RAM cache so that
562 subsequent reads on these files will not block on disk I/O.
564 This applet just calls the readahead(2) system call on each file.
565 It is mainly useful in system startup scripts to preload files
566 or executables before they are used. When used at the right time
567 (in particular when a CPU bound process is running) it can
568 significantly speed up system startup.
570 As readahead(2) blocks until each file has been read, it is best to
571 run this applet as a background job.
575 default n # doesn't build on Ubuntu 9.04
576 depends on PLATFORM_LINUX
578 Enable/disable wireless devices.
580 rfkill list : list all wireless devices
581 rfkill list bluetooth : list all bluetooth devices
582 rfkill list 1 : list device corresponding to the given index
583 rfkill block|unblock wlan : block/unblock all wlan(wifi) devices
589 find the current and previous system runlevel.
591 This applet uses utmp but does not rely on busybox supporing
592 utmp on purpose. It is used by e.g. emdebian via /etc/init.d/rc.
597 depends on PLATFORM_LINUX
599 Receive files using the Xmodem protocol.
605 setsid runs a program in a new session
611 strings prints the printable character sequences for each file
616 default n # doesn't build on some non-x86 targets (m68k)
618 Retrieve or set a processes's CPU affinity.
619 This requires sched_{g,s}etaffinity support in your libc.
621 config FEATURE_TASKSET_FANCY
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
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.
642 Runs a program and watches it. If it does not terminate in
643 specified number of seconds, it is sent a signal.
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`.
658 Prints a CD-ROM volume name.
664 Write a message to all users that are logged in.
669 depends on PLATFORM_LINUX
671 The watchdog utility is used with hardware or software watchdog
672 device drivers. It opens the specified watchdog device special file
673 and periodically writes a magic character to the device. If the
674 watchdog applet ever fails to write the magic character within a
675 certain amount of time, the watchdog device assumes the system has
676 hung, and will cause the hardware to reboot.