2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
6 menu "Miscellaneous Utilities"
12 Adjtimex reads and optionally sets adjustment parameters for
13 the Linux clock adjustment algorithm.
19 The bbconfig applet will print the config file with which
28 config FEATURE_CHAT_NOFAIL
29 bool "Enable NOFAIL expect strings"
33 When enabled expect strings which are started with a dash trigger
34 no-fail mode. That is when expectation is not met within timeout
35 the script is not terminated but sends next SEND string and waits
36 for next EXPECT string. This allows to compose far more flexible
39 config FEATURE_CHAT_TTY_HIFI
40 bool "Force STDIN to be a TTY"
44 Original chat always treats STDIN as a TTY device and sets for it
45 so-called raw mode. This option turns on such behaviour.
47 config FEATURE_CHAT_IMPLICIT_CR
48 bool "Enable implicit Carriage Return"
52 When enabled make chat to terminate all SEND strings with a "\r"
53 unless "\c" is met anywhere in the string.
55 config FEATURE_CHAT_SWALLOW_OPTS
56 bool "Swallow options"
60 Busybox chat require no options. To make it not fail when used
61 in place of original chat (which has a bunch of options) turn
64 config FEATURE_CHAT_SEND_ESCAPES
65 bool "Support weird SEND escapes"
69 Original chat uses some escape sequences in SEND arguments which
70 are not sent to device but rather performs special actions.
71 E.g. "\K" means to send a break sequence to device.
72 "\d" delays execution for a second, "\p" -- for a 1/100 of second.
73 Before turning this option on think twice: do you really need them?
75 config FEATURE_CHAT_VAR_ABORT_LEN
76 bool "Support variable-length ABORT conditions"
80 Original chat uses fixed 50-bytes length ABORT conditions. Say N here.
82 config FEATURE_CHAT_CLR_ABORT
83 bool "Support revoking of ABORT conditions"
87 Support CLR_ABORT directive.
93 manipulate real-time attributes of a process.
94 This requires sched_{g,s}etparam support in your libc.
100 select FEATURE_SYSLOG
102 Crond is a background daemon that parses individual crontab
103 files and executes commands on behalf of the users in question.
104 This is a port of dcron from slackware. It uses files of the
105 format /var/spool/cron/crontabs/<username> files, for example:
106 $ cat /var/spool/cron/crontabs/root
107 # Run daily cron jobs at 4:40 every day:
108 40 4 * * * /etc/cron/daily > /dev/null 2>&1
110 config FEATURE_CROND_D
111 bool "Support option -d to redirect output to stderr"
115 -d sets loglevel to 0 (most verbose) and directs all output to stderr.
117 config FEATURE_CROND_CALL_SENDMAIL
118 bool "Using /usr/sbin/sendmail?"
122 Support calling /usr/sbin/sendmail for send cmd outputs.
129 Crontab manipulates the crontab for a particular user. Only
130 the superuser may specify a different user and/or crontab directory.
131 Note that Busybox binary must be setuid root for this applet to
138 Dc is a reverse-polish desk calculator which supports unlimited
139 precision arithmetic.
141 config FEATURE_DC_LIBM
142 bool "Enable power and exp functions (requires libm)"
146 Enable power and exp functions.
147 NOTE: This will require libm to be present for linking.
150 bool "devfsd (obsolete)"
152 select FEATURE_SYSLOG
154 This is deprecated, and will be removed at the end of 2008.
156 Provides compatibility with old device names on a devfs systems.
157 You should set it to true if you have devfs enabled.
158 The following keywords in devsfd.conf are supported:
159 "CLEAR_CONFIG", "INCLUDE", "OPTIONAL_INCLUDE", "RESTORE",
160 "PERMISSIONS", "EXECUTE", "COPY", "IGNORE",
161 "MKOLDCOMPAT", "MKNEWCOMPAT","RMOLDCOMPAT", "RMNEWCOMPAT".
163 But only if they are written UPPERCASE!!!!!!!!
165 config DEVFSD_MODLOAD
166 bool "Adds support for MODLOAD keyword in devsfd.conf"
170 This actually doesn't work with busybox modutils but needs
171 the external modutils.
174 bool "Enables the -fg and -np options"
178 -fg Run the daemon in the foreground.
179 -np Exit after parsing the configuration file.
180 Do not poll for events.
182 config DEVFSD_VERBOSE
183 bool "Increases logging (and size)"
187 Increases logging to stderr or syslog.
190 bool "Use devfs names for all devices (obsolete)"
193 This is obsolete and will be going away at the end of 2008..
195 This tells busybox to look for names like /dev/loop/0 instead of
196 /dev/loop0. If your /dev directory has normal names instead of
197 devfs names, you don't want this.
203 devmem is a small program that reads and writes from physical
204 memory using /dev/mem.
210 Used to eject cdroms. (defaults to /dev/cdrom)
212 config FEATURE_EJECT_SCSI
217 Add the -s option to eject, this allows to eject SCSI-Devices and
224 Shows splash image and progress bar on framebuffer device.
225 Can be used during boot phase of an embedded device. ~2kb.
227 - use kernel option 'vga=xxx' or otherwise enable fb device.
228 - put somewhere fbsplash.cfg file and an image in .ppm format.
229 - $ setsid fbsplash [params] &
231 -d /dev/fbN: framebuffer device (if not /dev/fb0)
232 -s path_to_image_file (can be "-" for stdin)
233 -i path_to_cfg_file (can be "-" for stdin)
234 -f path_to_fifo (can be "-" for stdin)
235 - if you want to run it only in presence of kernel parameter:
236 grep -q "fbsplash=on" </proc/cmdline && setsid fbsplash [params] &
238 "NN" (ASCII decimal number) - percentage to show on progress bar
239 "exit" - well you guessed it
245 Simple inotify daemon. Reports filesystem changes. Requires
253 'last' displays a list of the last users that logged into the system.
256 prompt "Choose last implementation"
258 default FEATURE_LAST_SMALL
260 config FEATURE_LAST_SMALL
263 This is a small version of last with just the basic set of
266 config FEATURE_LAST_FANCY
269 'last' displays detailed information about the last users that
270 logged into the system (mimics sysvinit last). +900 bytes.
277 'less' is a pager, meaning that it displays text files. It possesses
278 a wide array of features, and is an improvement over 'more'.
280 config FEATURE_LESS_MAXLINES
281 int "Max number of input lines less will try to eat"
285 config FEATURE_LESS_BRACKETS
286 bool "Enable bracket searching"
290 This option adds the capability to search for matching left and right
291 brackets, facilitating programming.
293 config FEATURE_LESS_FLAGS
294 bool "Enable extra flags"
298 The extra flags provided do the following:
300 The -M flag enables a more sophisticated status line.
301 The -m flag enables a simpler status line with a percentage.
303 config FEATURE_LESS_MARKS
308 Marks enable positions in a file to be stored for easy reference.
310 config FEATURE_LESS_REGEXP
311 bool "Enable regular expressions"
315 Enable regular expressions, allowing complex file searches.
317 config FEATURE_LESS_WINCH
318 bool "Enable automatic resizing on window size changes"
322 Makes less track window size changes.
324 config FEATURE_LESS_DASHCMD
325 bool "Enable flag changes ('-' command)"
329 This enables the ability to change command-line flags within
330 less itself ('-' keyboard command).
332 config FEATURE_LESS_LINENUMS
333 bool "Enable dynamic switching of line numbers"
335 depends on FEATURE_LESS_DASHCMD
343 Get/Set hard drive parameters. Primarily intended for ATA
344 drives. Adds about 13k (or around 30k if you enable the
345 FEATURE_HDPARM_GET_IDENTITY option)....
347 config FEATURE_HDPARM_GET_IDENTITY
348 bool "Support obtaining detailed information directly from drives"
352 Enables the -I and -i options to obtain detailed information
353 directly from drives about their capabilities and supported ATA
354 feature set. If no device name is specified, hdparm will read
355 identify data from stdin. Enabling this option will add about 16k...
357 config FEATURE_HDPARM_HDIO_SCAN_HWIF
358 bool "Register an IDE interface (DANGEROUS)"
362 Enables the 'hdparm -R' option to register an IDE interface.
363 This is dangerous stuff, so you should probably say N.
365 config FEATURE_HDPARM_HDIO_UNREGISTER_HWIF
366 bool "Un-register an IDE interface (DANGEROUS)"
370 Enables the 'hdparm -U' option to un-register an IDE interface.
371 This is dangerous stuff, so you should probably say N.
373 config FEATURE_HDPARM_HDIO_DRIVE_RESET
374 bool "Perform device reset (DANGEROUS)"
378 Enables the 'hdparm -w' option to perform a device reset.
379 This is dangerous stuff, so you should probably say N.
381 config FEATURE_HDPARM_HDIO_TRISTATE_HWIF
382 bool "Tristate device for hotswap (DANGEROUS)"
386 Enables the 'hdparm -x' option to tristate device for hotswap,
387 and the '-b' option to get/set bus state. This is dangerous
388 stuff, so you should probably say N.
390 config FEATURE_HDPARM_HDIO_GETSET_DMA
391 bool "Get/set using_dma flag (DANGEROUS)"
395 Enables the 'hdparm -d' option to get/set using_dma flag.
396 This is dangerous stuff, so you should probably say N.
402 'makedevs' is a utility used to create a batch of devices with
405 There are two choices for command line behaviour, the interface
406 as used by LEAF/Linux Router Project, or a device table file.
408 'leaf' is traditionally what busybox follows, it allows multiple
409 devices of a particluar type to be created per command.
411 Device properties are passed as command line arguments.
413 'table' reads device properties from a file or stdin, allowing
414 a batch of unrelated devices to be made with one command.
415 User/group names are allowed as an alternative to uid/gid.
418 prompt "Choose makedevs behaviour"
420 default FEATURE_MAKEDEVS_TABLE
422 config FEATURE_MAKEDEVS_LEAF
425 config FEATURE_MAKEDEVS_TABLE
434 Format and display manual pages.
440 The poor man's minicom utility for chatting with serial port devices.
446 mountpoint checks if the directory is a mountpoint.
452 mt is used to control tape devices. You can use the mt utility
453 to advance or rewind a tape past a specified number of archive
460 raidautorun tells the kernel md driver to
461 search and start RAID arrays.
468 Preload the files listed on the command line into RAM cache so that
469 subsequent reads on these files will not block on disk I/O.
471 This applet just calls the readahead(2) system call on each file.
472 It is mainly useful in system startup scripts to preload files
473 or executables before they are used. When used at the right time
474 (in particular when a CPU bound process is running) it can
475 significantly speed up system startup.
477 As readahead(2) blocks until each file has been read, it is best to
478 run this applet as a background job.
484 find the current and previous system runlevel.
486 This applet uses utmp but does not rely on busybox supporing
487 utmp on purpose. It is used by e.g. emdebian via /etc/init.d/rc.
493 Receive files using the Xmodem protocol.
499 setsid runs a program in a new session
505 strings prints the printable character sequences for each file
512 Retrieve or set a processes's CPU affinity.
513 This requires sched_{g,s}etaffinity support in your libc.
515 config FEATURE_TASKSET_FANCY
520 Add code for fancy output. This merely silences a compiler-warning
521 and adds about 135 Bytes. May be needed for machines with alot
528 The time command runs the specified program with the given arguments.
529 When the command finishes, time writes a message to standard output
530 giving timing statistics about this program run.
536 Runs a program and watches it. If it does not terminate in
537 specified number of seconds, it is sent a signal.
543 A replacement for "stty size". Unlike stty, can report only width,
544 only height, or both, in any order. It also does not complain on
545 error, but returns default 80x24.
546 Usage in shell scripts: width=`ttysize w`.
552 The watchdog utility is used with hardware or software watchdog
553 device drivers. It opens the specified watchdog device special file
554 and periodically writes a magic character to the device. If the
555 watchdog applet ever fails to write the magic character within a
556 certain amount of time, the watchdog device assumes the system has
557 hung, and will cause the hardware to reboot.