2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
6 menu "Miscellaneous Utilities"
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.
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 Crontab manipulates the crontab for a particular user. Only
141 the superuser may specify a different user and/or crontab directory.
142 Note that Busybox binary must be setuid root for this applet to
149 Dc is a reverse-polish desk calculator which supports unlimited
150 precision arithmetic.
152 config FEATURE_DC_LIBM
153 bool "Enable power and exp functions (requires libm)"
157 Enable power and exp functions.
158 NOTE: This will require libm to be present for linking.
161 bool "devfsd (obsolete)"
163 select PLATFORM_LINUX
164 select FEATURE_SYSLOG
166 This is deprecated and should NOT be used anymore.
167 Use linux >= 2.6 (optionally with hotplug) and mdev instead!
168 See docs/mdev.txt for detailed instructions on how to use mdev
171 Provides compatibility with old device names on a devfs systems.
172 You should set it to true if you have devfs enabled.
173 The following keywords in devsfd.conf are supported:
174 "CLEAR_CONFIG", "INCLUDE", "OPTIONAL_INCLUDE", "RESTORE",
175 "PERMISSIONS", "EXECUTE", "COPY", "IGNORE",
176 "MKOLDCOMPAT", "MKNEWCOMPAT","RMOLDCOMPAT", "RMNEWCOMPAT".
178 But only if they are written UPPERCASE!!!!!!!!
180 config DEVFSD_MODLOAD
181 bool "Adds support for MODLOAD keyword in devsfd.conf"
185 This actually doesn't work with busybox modutils but needs
186 the external modutils.
189 bool "Enables the -fg and -np options"
193 -fg Run the daemon in the foreground.
194 -np Exit after parsing the configuration file.
195 Do not poll for events.
197 config DEVFSD_VERBOSE
198 bool "Increases logging (and size)"
202 Increases logging to stderr or syslog.
205 bool "Use devfs names for all devices (obsolete)"
207 select PLATFORM_LINUX
209 This is obsolete and should NOT be used anymore.
210 Use linux >= 2.6 (optionally with hotplug) and mdev instead!
212 For legacy systems -- if there is no way around devfsd -- this
213 tells busybox to look for names like /dev/loop/0 instead of
214 /dev/loop0. If your /dev directory has normal names instead of
215 devfs names, you don't want this.
221 devmem is a small program that reads and writes from physical
222 memory using /dev/mem.
227 select PLATFORM_LINUX
229 Used to eject cdroms. (defaults to /dev/cdrom)
231 config FEATURE_EJECT_SCSI
236 Add the -s option to eject, this allows to eject SCSI-Devices and
242 select PLATFORM_LINUX
244 Shows splash image and progress bar on framebuffer device.
245 Can be used during boot phase of an embedded device. ~2kb.
247 - use kernel option 'vga=xxx' or otherwise enable fb device.
248 - put somewhere fbsplash.cfg file and an image in .ppm format.
249 - $ setsid fbsplash [params] &
251 -d /dev/fbN: framebuffer device (if not /dev/fb0)
252 -s path_to_image_file (can be "-" for stdin)
253 -i path_to_cfg_file (can be "-" for stdin)
254 -f path_to_fifo (can be "-" for stdin)
255 - if you want to run it only in presence of kernel parameter:
256 grep -q "fbsplash=on" </proc/cmdline && setsid fbsplash [params] &
258 "NN" (ASCII decimal number) - percentage to show on progress bar
259 "exit" - well you guessed it
263 default n # doesn't build on Ubuntu 8.04
265 The flashcp binary, inspired by mtd-utils as of git head 5eceb74f7.
266 This utility is used to copy images into a MTD device.
270 default n # doesn't build on Ubuntu 8.04
272 The flash_lock binary from mtd-utils as of git head 5ec0c10d0. This
273 utility locks part or all of the flash device.
277 default n # doesn't build on Ubuntu 8.04
279 The flash_unlock binary from mtd-utils as of git head 5ec0c10d0. This
280 utility unlocks part or all of the flash device.
282 config FLASH_ERASEALL
283 bool "flash_eraseall"
284 default n # doesn't build on Ubuntu 8.04
286 The flash_eraseall binary from mtd-utils as of git head c4c6a59eb.
287 This utility is used to erase the whole MTD device.
292 select PLATFORM_LINUX
294 Set/set program io scheduling class and priority
295 Requires kernel >= 2.6.13
299 default n # doesn't build on Knoppix 5
301 Simple inotify daemon. Reports filesystem changes. Requires
307 depends on FEATURE_WTMP
309 'last' displays a list of the last users that logged into the system.
312 prompt "Choose last implementation"
314 default FEATURE_LAST_FANCY
316 config FEATURE_LAST_SMALL
319 This is a small version of last with just the basic set of
322 config FEATURE_LAST_FANCY
325 'last' displays detailed information about the last users that
326 logged into the system (mimics sysvinit last). +900 bytes.
332 select PLATFORM_LINUX
334 Get/Set hard drive parameters. Primarily intended for ATA
335 drives. Adds about 13k (or around 30k if you enable the
336 FEATURE_HDPARM_GET_IDENTITY option)....
338 config FEATURE_HDPARM_GET_IDENTITY
339 bool "Support obtaining detailed information directly from drives"
343 Enables the -I and -i options to obtain detailed information
344 directly from drives about their capabilities and supported ATA
345 feature set. If no device name is specified, hdparm will read
346 identify data from stdin. Enabling this option will add about 16k...
348 config FEATURE_HDPARM_HDIO_SCAN_HWIF
349 bool "Register an IDE interface (DANGEROUS)"
353 Enables the 'hdparm -R' option to register an IDE interface.
354 This is dangerous stuff, so you should probably say N.
356 config FEATURE_HDPARM_HDIO_UNREGISTER_HWIF
357 bool "Un-register an IDE interface (DANGEROUS)"
361 Enables the 'hdparm -U' option to un-register an IDE interface.
362 This is dangerous stuff, so you should probably say N.
364 config FEATURE_HDPARM_HDIO_DRIVE_RESET
365 bool "Perform device reset (DANGEROUS)"
369 Enables the 'hdparm -w' option to perform a device reset.
370 This is dangerous stuff, so you should probably say N.
372 config FEATURE_HDPARM_HDIO_TRISTATE_HWIF
373 bool "Tristate device for hotswap (DANGEROUS)"
377 Enables the 'hdparm -x' option to tristate device for hotswap,
378 and the '-b' option to get/set bus state. This is dangerous
379 stuff, so you should probably say N.
381 config FEATURE_HDPARM_HDIO_GETSET_DMA
382 bool "Get/set using_dma flag"
386 Enables the 'hdparm -d' option to get/set using_dma flag.
392 'makedevs' is a utility used to create a batch of devices with
395 There are two choices for command line behaviour, the interface
396 as used by LEAF/Linux Router Project, or a device table file.
398 'leaf' is traditionally what busybox follows, it allows multiple
399 devices of a particluar type to be created per command.
401 Device properties are passed as command line arguments.
403 'table' reads device properties from a file or stdin, allowing
404 a batch of unrelated devices to be made with one command.
405 User/group names are allowed as an alternative to uid/gid.
408 prompt "Choose makedevs behaviour"
410 default FEATURE_MAKEDEVS_TABLE
412 config FEATURE_MAKEDEVS_LEAF
415 config FEATURE_MAKEDEVS_TABLE
424 Format and display manual pages.
430 The poor man's minicom utility for chatting with serial port devices.
436 mountpoint checks if the directory is a mountpoint.
442 mt is used to control tape devices. You can use the mt utility
443 to advance or rewind a tape past a specified number of archive
449 select PLATFORM_LINUX
451 raidautorun tells the kernel md driver to
452 search and start RAID arrays.
458 select PLATFORM_LINUX
460 Preload the files listed on the command line into RAM cache so that
461 subsequent reads on these files will not block on disk I/O.
463 This applet just calls the readahead(2) system call on each file.
464 It is mainly useful in system startup scripts to preload files
465 or executables before they are used. When used at the right time
466 (in particular when a CPU bound process is running) it can
467 significantly speed up system startup.
469 As readahead(2) blocks until each file has been read, it is best to
470 run this applet as a background job.
475 depends on FEATURE_UTMP
477 find the current and previous system runlevel.
479 This applet uses utmp but does not rely on busybox supporing
480 utmp on purpose. It is used by e.g. emdebian via /etc/init.d/rc.
485 select PLATFORM_LINUX
487 Receive files using the Xmodem protocol.
493 setsid runs a program in a new session
499 strings prints the printable character sequences for each file
504 default n # doesn't build on some non-x86 targets (m68k)
506 Retrieve or set a processes's CPU affinity.
507 This requires sched_{g,s}etaffinity support in your libc.
509 config FEATURE_TASKSET_FANCY
514 Add code for fancy output. This merely silences a compiler-warning
515 and adds about 135 Bytes. May be needed for machines with alot
522 The time command runs the specified program with the given arguments.
523 When the command finishes, time writes a message to standard output
524 giving timing statistics about this program run.
530 Runs a program and watches it. If it does not terminate in
531 specified number of seconds, it is sent a signal.
537 A replacement for "stty size". Unlike stty, can report only width,
538 only height, or both, in any order. It also does not complain on
539 error, but returns default 80x24.
540 Usage in shell scripts: width=`ttysize w`.
546 Prints a CD-ROM volume name.
551 select PLATFORM_LINUX
553 The watchdog utility is used with hardware or software watchdog
554 device drivers. It opens the specified watchdog device special file
555 and periodically writes a magic character to the device. If the
556 watchdog applet ever fails to write the magic character within a
557 certain amount of time, the watchdog device assumes the system has
558 hung, and will cause the hardware to reboot.