2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
6 menu "Miscellaneous Utilities"
8 config BUSYBOX_CONFIG_ADJTIMEX
12 Adjtimex reads and optionally sets adjustment parameters for
13 the Linux clock adjustment algorithm.
15 config BUSYBOX_CONFIG_BBCONFIG
19 The bbconfig applet will print the config file with which
22 config BUSYBOX_CONFIG_CHAT
28 config BUSYBOX_CONFIG_FEATURE_CHAT_NOFAIL
29 bool "Enable NOFAIL expect strings"
30 depends on BUSYBOX_CONFIG_CHAT
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 BUSYBOX_CONFIG_FEATURE_CHAT_TTY_HIFI
40 bool "Force STDIN to be a TTY"
41 depends on BUSYBOX_CONFIG_CHAT
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 BUSYBOX_CONFIG_FEATURE_CHAT_IMPLICIT_CR
48 bool "Enable implicit Carriage Return"
49 depends on BUSYBOX_CONFIG_CHAT
52 When enabled make chat to terminate all SEND strings with a "\r"
53 unless "\c" is met anywhere in the string.
55 config BUSYBOX_CONFIG_FEATURE_CHAT_SWALLOW_OPTS
56 bool "Swallow options"
57 depends on BUSYBOX_CONFIG_CHAT
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 BUSYBOX_CONFIG_FEATURE_CHAT_SEND_ESCAPES
65 bool "Support weird SEND escapes"
66 depends on BUSYBOX_CONFIG_CHAT
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 BUSYBOX_CONFIG_FEATURE_CHAT_VAR_ABORT_LEN
76 bool "Support variable-length ABORT conditions"
77 depends on BUSYBOX_CONFIG_CHAT
80 Original chat uses fixed 50-bytes length ABORT conditions. Say N here.
82 config BUSYBOX_CONFIG_FEATURE_CHAT_CLR_ABORT
83 bool "Support revoking of ABORT conditions"
84 depends on BUSYBOX_CONFIG_CHAT
87 Support CLR_ABORT directive.
89 config BUSYBOX_CONFIG_CHRT
93 manipulate real-time attributes of a process.
94 This requires sched_{g,s}etparam support in your libc.
96 config BUSYBOX_CONFIG_CROND
99 select BUSYBOX_CONFIG_FEATURE_SUID
100 select BUSYBOX_CONFIG_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 BUSYBOX_CONFIG_DEBUG_CROND_OPTION
111 bool "Support option -d to redirect output to stderr"
112 depends on BUSYBOX_CONFIG_CROND
115 -d sets loglevel to 0 (most verbose) and directs all output to stderr.
117 config BUSYBOX_CONFIG_FEATURE_CROND_CALL_SENDMAIL
118 bool "Using /usr/sbin/sendmail?"
120 depends on BUSYBOX_CONFIG_CROND
122 Support calling /usr/sbin/sendmail for send cmd outputs.
124 config BUSYBOX_CONFIG_CRONTAB
127 select BUSYBOX_CONFIG_FEATURE_SUID
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
134 config BUSYBOX_CONFIG_DC
138 Dc is a reverse-polish desk calculator which supports unlimited
139 precision arithmetic.
141 config BUSYBOX_CONFIG_DEVFSD
142 bool "devfsd (obsolete)"
144 select BUSYBOX_CONFIG_FEATURE_SYSLOG
146 This is deprecated, and will be removed at the end of 2008.
148 Provides compatibility with old device names on a devfs systems.
149 You should set it to true if you have devfs enabled.
150 The following keywords in devsfd.conf are supported:
151 "CLEAR_CONFIG", "INCLUDE", "OPTIONAL_INCLUDE", "RESTORE",
152 "PERMISSIONS", "EXECUTE", "COPY", "IGNORE",
153 "MKOLDCOMPAT", "MKNEWCOMPAT","RMOLDCOMPAT", "RMNEWCOMPAT".
155 But only if they are written UPPERCASE!!!!!!!!
157 config BUSYBOX_CONFIG_DEVFSD_MODLOAD
158 bool "Adds support for MODLOAD keyword in devsfd.conf"
160 depends on BUSYBOX_CONFIG_DEVFSD
162 This actually doesn't work with busybox modutils but needs
163 the external modutils.
165 config BUSYBOX_CONFIG_DEVFSD_FG_NP
166 bool "Enables the -fg and -np options"
168 depends on BUSYBOX_CONFIG_DEVFSD
170 -fg Run the daemon in the foreground.
171 -np Exit after parsing the configuration file.
172 Do not poll for events.
174 config BUSYBOX_CONFIG_DEVFSD_VERBOSE
175 bool "Increases logging (and size)"
177 depends on BUSYBOX_CONFIG_DEVFSD
179 Increases logging to stderr or syslog.
181 config BUSYBOX_CONFIG_FEATURE_DEVFS
182 bool "Use devfs names for all devices (obsolete)"
185 This is obsolete and will be going away at the end of 2008..
187 This tells busybox to look for names like /dev/loop/0 instead of
188 /dev/loop0. If your /dev directory has normal names instead of
189 devfs names, you don't want this.
191 config BUSYBOX_CONFIG_EJECT
195 Used to eject cdroms. (defaults to /dev/cdrom)
197 config BUSYBOX_CONFIG_FEATURE_EJECT_SCSI
200 depends on BUSYBOX_CONFIG_EJECT
202 Add the -s option to eject, this allows to eject SCSI-Devices and
205 config BUSYBOX_CONFIG_FBSPLASH
209 Shows splash image and progress bar on framebuffer device.
210 Can be used during boot phase of an embedded device. ~2kb.
212 - use kernel option 'vga=xxx' or otherwise enable fb device.
213 - put somewhere fbsplash.cfg file and an image in .ppm format.
214 - $ setsid fbsplash [params] &
216 -d /dev/fbN: framebuffer device (if not /dev/fb0)
217 -s path_to_image_file (can be "-" for stdin)
218 -i path_to_cfg_file (can be "-" for stdin)
219 -f path_to_fifo (can be "-" for stdin)
220 - if you want to run it only in presence of kernel parameter:
221 grep -q "fbsplash=on" </proc/cmdline && setsid fbsplash [params] &
223 "NN" (ASCII decimal number) - percentage to show on progress bar
224 "exit" - well you guessed it
226 config BUSYBOX_CONFIG_INOTIFYD
230 Simple inotify daemon. Reports filesystem changes. Requires
233 config BUSYBOX_CONFIG_LAST
236 select BUSYBOX_CONFIG_FEATURE_WTMP
238 'last' displays a list of the last users that logged into the system.
241 prompt "Choose last implementation"
242 depends on BUSYBOX_CONFIG_LAST
243 default BUSYBOX_CONFIG_FEATURE_LAST_SMALL
245 config BUSYBOX_CONFIG_FEATURE_LAST_SMALL
248 This is a small version of last with just the basic set of
251 config BUSYBOX_CONFIG_FEATURE_LAST_FANCY
254 'last' displays detailed information about the last users that
255 logged into the system (mimics sysvinit last). +900 bytes.
258 config BUSYBOX_CONFIG_LESS
262 'less' is a pager, meaning that it displays text files. It possesses
263 a wide array of features, and is an improvement over 'more'.
265 config BUSYBOX_CONFIG_FEATURE_LESS_MAXLINES
266 int "Max number of input lines less will try to eat"
268 depends on BUSYBOX_CONFIG_LESS
270 config BUSYBOX_CONFIG_FEATURE_LESS_BRACKETS
271 bool "Enable bracket searching"
273 depends on BUSYBOX_CONFIG_LESS
275 This option adds the capability to search for matching left and right
276 brackets, facilitating programming.
278 config BUSYBOX_CONFIG_FEATURE_LESS_FLAGS
279 bool "Enable extra flags"
281 depends on BUSYBOX_CONFIG_LESS
283 The extra flags provided do the following:
285 The -M flag enables a more sophisticated status line.
286 The -m flag enables a simpler status line with a percentage.
288 config BUSYBOX_CONFIG_FEATURE_LESS_FLAGCS
289 bool "Enable flag changes"
291 depends on BUSYBOX_CONFIG_LESS
293 This enables the ability to change command-line flags within
296 config BUSYBOX_CONFIG_FEATURE_LESS_MARKS
299 depends on BUSYBOX_CONFIG_LESS
301 Marks enable positions in a file to be stored for easy reference.
303 config BUSYBOX_CONFIG_FEATURE_LESS_REGEXP
304 bool "Enable regular expressions"
306 depends on BUSYBOX_CONFIG_LESS
308 Enable regular expressions, allowing complex file searches.
310 config BUSYBOX_CONFIG_HDPARM
314 Get/Set hard drive parameters. Primarily intended for ATA
315 drives. Adds about 13k (or around 30k if you enable the
316 FEATURE_HDPARM_GET_IDENTITY option)....
318 config BUSYBOX_CONFIG_FEATURE_HDPARM_GET_IDENTITY
319 bool "Support obtaining detailed information directly from drives"
321 depends on BUSYBOX_CONFIG_HDPARM
323 Enables the -I and -i options to obtain detailed information
324 directly from drives about their capabilities and supported ATA
325 feature set. If no device name is specified, hdparm will read
326 identify data from stdin. Enabling this option will add about 16k...
328 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_SCAN_HWIF
329 bool "Register an IDE interface (DANGEROUS)"
331 depends on BUSYBOX_CONFIG_HDPARM
333 Enables the 'hdparm -R' option to register an IDE interface.
334 This is dangerous stuff, so you should probably say N.
336 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_UNREGISTER_HWIF
337 bool "Un-register an IDE interface (DANGEROUS)"
339 depends on BUSYBOX_CONFIG_HDPARM
341 Enables the 'hdparm -U' option to un-register an IDE interface.
342 This is dangerous stuff, so you should probably say N.
344 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_DRIVE_RESET
345 bool "Perform device reset (DANGEROUS)"
347 depends on BUSYBOX_CONFIG_HDPARM
349 Enables the 'hdparm -w' option to perform a device reset.
350 This is dangerous stuff, so you should probably say N.
352 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_TRISTATE_HWIF
353 bool "Tristate device for hotswap (DANGEROUS)"
355 depends on BUSYBOX_CONFIG_HDPARM
357 Enables the 'hdparm -x' option to tristate device for hotswap,
358 and the '-b' option to get/set bus state. This is dangerous
359 stuff, so you should probably say N.
361 config BUSYBOX_CONFIG_FEATURE_HDPARM_HDIO_GETSET_DMA
362 bool "Get/set using_dma flag (DANGEROUS)"
364 depends on BUSYBOX_CONFIG_HDPARM
366 Enables the 'hdparm -d' option to get/set using_dma flag.
367 This is dangerous stuff, so you should probably say N.
369 config BUSYBOX_CONFIG_LOCK
373 Small utility for using locks in scripts
375 config BUSYBOX_CONFIG_MAKEDEVS
379 'makedevs' is a utility used to create a batch of devices with
382 There are two choices for command line behaviour, the interface
383 as used by LEAF/Linux Router Project, or a device table file.
385 'leaf' is traditionally what busybox follows, it allows multiple
386 devices of a particluar type to be created per command.
388 Device properties are passed as command line arguments.
390 'table' reads device properties from a file or stdin, allowing
391 a batch of unrelated devices to be made with one command.
392 User/group names are allowed as an alternative to uid/gid.
395 prompt "Choose makedevs behaviour"
396 depends on BUSYBOX_CONFIG_MAKEDEVS
397 default BUSYBOX_CONFIG_FEATURE_MAKEDEVS_TABLE
399 config BUSYBOX_CONFIG_FEATURE_MAKEDEVS_LEAF
402 config BUSYBOX_CONFIG_FEATURE_MAKEDEVS_TABLE
407 config BUSYBOX_CONFIG_MAN
411 Format and display manual pages.
413 config BUSYBOX_CONFIG_MICROCOM
417 The poor man's minicom utility for chatting with serial port devices.
419 config BUSYBOX_CONFIG_MOUNTPOINT
423 mountpoint checks if the directory is a mountpoint.
425 config BUSYBOX_CONFIG_MT
429 mt is used to control tape devices. You can use the mt utility
430 to advance or rewind a tape past a specified number of archive
433 config BUSYBOX_CONFIG_RAIDAUTORUN
437 raidautorun tells the kernel md driver to
438 search and start RAID arrays.
440 config BUSYBOX_CONFIG_READAHEAD
443 depends on BUSYBOX_CONFIG_LFS
445 Preload the files listed on the command line into RAM cache so that
446 subsequent reads on these files will not block on disk I/O.
448 This applet just calls the readahead(2) system call on each file.
449 It is mainly useful in system startup scripts to preload files
450 or executables before they are used. When used at the right time
451 (in particular when a CPU bound process is running) it can
452 significantly speed up system startup.
454 As readahead(2) blocks until each file has been read, it is best to
455 run this applet as a background job.
457 config BUSYBOX_CONFIG_RUNLEVEL
461 find the current and previous system runlevel.
463 This applet uses utmp but does not rely on busybox supporing
464 utmp on purpose. It is used by e.g. emdebian via /etc/init.d/rc.
466 config BUSYBOX_CONFIG_RX
470 Receive files using the Xmodem protocol.
472 config BUSYBOX_CONFIG_SETSID
476 setsid runs a program in a new session
478 config BUSYBOX_CONFIG_STRINGS
482 strings prints the printable character sequences for each file
485 config BUSYBOX_CONFIG_TASKSET
489 Retrieve or set a processes's CPU affinity.
490 This requires sched_{g,s}etaffinity support in your libc.
492 config BUSYBOX_CONFIG_FEATURE_TASKSET_FANCY
495 depends on BUSYBOX_CONFIG_TASKSET
497 Add code for fancy output. This merely silences a compiler-warning
498 and adds about 135 Bytes. May be needed for machines with alot
501 config BUSYBOX_CONFIG_TIME
505 The time command runs the specified program with the given arguments.
506 When the command finishes, time writes a message to standard output
507 giving timing statistics about this program run.
509 config BUSYBOX_CONFIG_TTYSIZE
513 A replacement for "stty size". Unlike stty, can report only width,
514 only height, or both, in any order. It also does not complain on
515 error, but returns default 80x24.
516 Usage in shell scripts: width=`ttysize w`.
518 config BUSYBOX_CONFIG_WATCHDOG
522 The watchdog utility is used with hardware or software watchdog
523 device drivers. It opens the specified watchdog device special file
524 and periodically writes a magic character to the device. If the
525 watchdog applet ever fails to write the magic character within a
526 certain amount of time, the watchdog device assumes the system has
527 hung, and will cause the hardware to reboot.