blob: 559e4c17a3752fad1e513b332d1aaeebfad55fca [file] [log] [blame]
Eric Andersenc9f20d92002-12-05 08:41:41 +00001#
2# For a description of the syntax of this configuration file,
3# see scripts/kbuild/config-language.txt.
4#
5
6menu "Linux System Utilities"
7
Denis Vlasenkod16950d2008-11-29 09:05:50 +00008config ACPID
9 bool "acpid"
10 default n
11 help
12 acpid listens to ACPI events coming either in textual form from
13 /proc/acpi/event (though it is marked deprecated it is still widely
14 used and _is_ a standard) or in binary form from specified evdevs
15 (just use /dev/input/event*).
16
17 It parses the event to retrieve ACTION and a possible PARAMETER.
18 It then spawns /etc/acpi/<ACTION>[/<PARAMETER>] either via run-parts
19 (if the resulting path is a directory) or directly as an executable.
20
21 N.B. acpid relies on run-parts so have the latter installed.
22
23config FEATURE_ACPID_COMPAT
24 bool "Accept and ignore redundant options"
25 default n
26 depends on ACPID
27 help
28 Accept and ignore compatibility options -g -m -s -S -v.
29
Denis Vlasenko1e19afd2008-10-12 11:20:08 +000030config BLKID
31 bool "blkid"
32 default n
33 select VOLUMEID
34 help
35 Lists labels and UUIDs of all filesystems.
36 WARNING:
37 With all submodules selected, it will add ~8k to busybox.
38
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000039config DMESG
Eric Andersenc9f20d92002-12-05 08:41:41 +000040 bool "dmesg"
41 default n
42 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000043 dmesg is used to examine or control the kernel ring buffer. When the
Eric Andersena0ac4522003-02-27 03:14:04 +000044 Linux kernel prints messages to the system log, they are stored in
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000045 the kernel ring buffer. You can use dmesg to print the kernel's ring
Eric Andersena0ac4522003-02-27 03:14:04 +000046 buffer, clear the kernel ring buffer, change the size of the kernel
47 ring buffer, and change the priority level at which kernel messages
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000048 are also logged to the system console. Enable this option if you
Eric Andersena0ac4522003-02-27 03:14:04 +000049 wish to enable the 'dmesg' utility.
Eric Andersenc9f20d92002-12-05 08:41:41 +000050
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000051config FEATURE_DMESG_PRETTY
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +000052 bool "Pretty dmesg output"
Rob Landley446129a2006-07-27 16:40:55 +000053 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000054 depends on DMESG
Rob Landley446129a2006-07-27 16:40:55 +000055 help
56 If you wish to scrub the syslog level from the output, say 'Y' here.
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000057 The syslog level is a string prefixed to every line with the form
58 "<#>".
Rob Landley446129a2006-07-27 16:40:55 +000059
60 With this option you will see:
61 # dmesg
62 Linux version 2.6.17.4 .....
63 BIOS-provided physical RAM map:
64 BIOS-e820: 0000000000000000 - 000000000009f000 (usable)
65
66 Without this option you will see:
67 # dmesg
68 <5>Linux version 2.6.17.4 .....
69 <6>BIOS-provided physical RAM map:
70 <6> BIOS-e820: 0000000000000000 - 000000000009f000 (usable)
71
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000072config FBSET
Eric Andersenc9f20d92002-12-05 08:41:41 +000073 bool "fbset"
74 default n
75 help
Eric Andersena0ac4522003-02-27 03:14:04 +000076 fbset is used to show or change the settings of a Linux frame buffer
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000077 device. The frame buffer device provides a simple and unique
78 interface to access a graphics display. Enable this option
Eric Andersen88c916b2003-10-22 09:58:56 +000079 if you wish to enable the 'fbset' utility.
Eric Andersena0ac4522003-02-27 03:14:04 +000080
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000081config FEATURE_FBSET_FANCY
Rob Landley2ec922e2006-04-13 23:22:16 +000082 bool "Turn on extra fbset options"
Eric Andersenc9f20d92002-12-05 08:41:41 +000083 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000084 depends on FBSET
Eric Andersenc9f20d92002-12-05 08:41:41 +000085 help
Eric Andersena0ac4522003-02-27 03:14:04 +000086 This option enables extended fbset options, allowing one to set the
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +000087 framebuffer size, color depth, etc. interface to access a graphics
88 display. Enable this option if you wish to enable extended fbset
Eric Andersena0ac4522003-02-27 03:14:04 +000089 options.
Eric Andersenc9f20d92002-12-05 08:41:41 +000090
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000091config FEATURE_FBSET_READMODE
Rob Landley2ec922e2006-04-13 23:22:16 +000092 bool "Turn on fbset readmode support"
Eric Andersenc9f20d92002-12-05 08:41:41 +000093 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +000094 depends on FBSET
Eric Andersenc9f20d92002-12-05 08:41:41 +000095 help
Eric Andersena0ac4522003-02-27 03:14:04 +000096 This option allows fbset to read the video mode database stored by
97 default as /etc/fb.modes, which can be used to set frame buffer
98 device to pre-defined video modes.
Eric Andersenc9f20d92002-12-05 08:41:41 +000099
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000100config FDFLUSH
Eric Andersenc9f20d92002-12-05 08:41:41 +0000101 bool "fdflush"
102 default n
103 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000104 fdflush is only needed when changing media on slightly-broken
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000105 removable media drives. It is used to make Linux believe that a
Eric Andersena0ac4522003-02-27 03:14:04 +0000106 hardware disk-change switch has been actuated, which causes Linux to
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000107 forget anything it has cached from the previous media. If you have
Eric Andersena0ac4522003-02-27 03:14:04 +0000108 such a slightly-broken drive, you will need to run fdflush every time
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000109 you change a disk. Most people have working hardware and can safely
Eric Andersen88c916b2003-10-22 09:58:56 +0000110 leave this disabled.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000111
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000112config FDFORMAT
Eric Andersen01c3d402003-07-05 07:51:31 +0000113 bool "fdformat"
114 default n
115 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000116 fdformat is used to low-level format a floppy disk.
Eric Andersen01c3d402003-07-05 07:51:31 +0000117
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000118config FDISK
Eric Andersenc9f20d92002-12-05 08:41:41 +0000119 bool "fdisk"
120 default n
121 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000122 The fdisk utility is used to divide hard disks into one or more
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000123 logical disks, which are generally called partitions. This utility
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000124 can be used to list and edit the set of partitions or BSD style
Eric Andersena0ac4522003-02-27 03:14:04 +0000125 'disk slices' that are defined on a hard drive.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000126
Eric Andersen84bdea82004-05-19 10:49:17 +0000127config FDISK_SUPPORT_LARGE_DISKS
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000128 bool "Support over 4GB disks"
Eric Andersen84bdea82004-05-19 10:49:17 +0000129 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000130 depends on FDISK
Eric Andersen84bdea82004-05-19 10:49:17 +0000131 help
132 Enable this option to support large disks > 4GB.
133
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000134config FEATURE_FDISK_WRITABLE
Rob Landley2ec922e2006-04-13 23:22:16 +0000135 bool "Write support"
Glenn L McGrath4dcc2dd2003-01-04 11:56:06 +0000136 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000137 depends on FDISK
Glenn L McGrath4dcc2dd2003-01-04 11:56:06 +0000138 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000139 Enabling this option allows you to create or change a partition table
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000140 and write those changes out to disk. If you leave this option
Eric Andersena0ac4522003-02-27 03:14:04 +0000141 disabled, you will only be able to view the partition table.
Glenn L McGrath4dcc2dd2003-01-04 11:56:06 +0000142
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000143config FEATURE_AIX_LABEL
Rob Landley2ec922e2006-04-13 23:22:16 +0000144 bool "Support AIX disklabels"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000145 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000146 depends on FDISK && FEATURE_FDISK_WRITABLE
Eric Andersenc9f20d92002-12-05 08:41:41 +0000147 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000148 Enabling this option allows you to create or change AIX disklabels.
149 Most people can safely leave this option disabled.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000150
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000151config FEATURE_SGI_LABEL
Rob Landley2ec922e2006-04-13 23:22:16 +0000152 bool "Support SGI disklabels"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000153 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000154 depends on FDISK && FEATURE_FDISK_WRITABLE
Eric Andersenc9f20d92002-12-05 08:41:41 +0000155 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000156 Enabling this option allows you to create or change SGI disklabels.
157 Most people can safely leave this option disabled.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000158
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000159config FEATURE_SUN_LABEL
Rob Landley2ec922e2006-04-13 23:22:16 +0000160 bool "Support SUN disklabels"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000161 default n
Mike Frysinger71a6a4e2007-01-24 08:24:43 +0000162 depends on FDISK && FEATURE_FDISK_WRITABLE
Eric Andersenc9f20d92002-12-05 08:41:41 +0000163 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000164 Enabling this option allows you to create or change SUN disklabels.
165 Most people can safely leave this option disabled.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000166
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000167config FEATURE_OSF_LABEL
Rob Landley2ec922e2006-04-13 23:22:16 +0000168 bool "Support BSD disklabels"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000169 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000170 depends on FDISK && FEATURE_FDISK_WRITABLE
Eric Andersenc9f20d92002-12-05 08:41:41 +0000171 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000172 Enabling this option allows you to create or change BSD disklabels
173 and define and edit BSD disk slices.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000174
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000175config FEATURE_FDISK_ADVANCED
Rob Landley2ec922e2006-04-13 23:22:16 +0000176 bool "Support expert mode"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000177 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000178 depends on FDISK && FEATURE_FDISK_WRITABLE
Eric Andersenc9f20d92002-12-05 08:41:41 +0000179 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000180 Enabling this option allows you to do terribly unsafe things like
181 define arbitrary drive geometry, move the beginning of data in a
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000182 partition, and similarly evil things. Unless you have a very good
Eric Andersena0ac4522003-02-27 03:14:04 +0000183 reason you would be wise to leave this disabled.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000184
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000185config FINDFS
186 bool "findfs"
187 default n
188 select VOLUMEID
189 help
Denis Vlasenko22d10a02008-10-13 08:53:43 +0000190 Prints the name of a filesystem with given label or UUID.
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000191 WARNING:
Denis Vlasenkod25c33f2008-03-17 09:25:05 +0000192 With all submodules selected, it will add ~8k to busybox.
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000193
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000194config FREERAMDISK
Eric Andersenc9f20d92002-12-05 08:41:41 +0000195 bool "freeramdisk"
196 default n
197 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000198 Linux allows you to create ramdisks. This utility allows you to
Eric Andersena0ac4522003-02-27 03:14:04 +0000199 delete them and completely free all memory that was used for the
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000200 ramdisk. For example, if you boot Linux into a ramdisk and later
Eric Andersena0ac4522003-02-27 03:14:04 +0000201 pivot_root, you may want to free the memory that is allocated to the
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000202 ramdisk. If you have no use for freeing memory from a ramdisk, leave
Eric Andersena0ac4522003-02-27 03:14:04 +0000203 this disabled.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000204
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000205config FSCK_MINIX
Eric Andersenc9f20d92002-12-05 08:41:41 +0000206 bool "fsck_minix"
207 default n
208 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000209 The minix filesystem is a nice, small, compact, read-write filesystem
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000210 with little overhead. It is not a journaling filesystem however and
Eric Andersen88c916b2003-10-22 09:58:56 +0000211 can experience corruption if it is not properly unmounted or if the
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000212 power goes off in the middle of a write. This utility allows you to
Eric Andersena0ac4522003-02-27 03:14:04 +0000213 check for and attempt to repair any corruption that occurs to a minix
214 filesystem.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000215
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000216config MKFS_MINIX
Eric Andersenc9f20d92002-12-05 08:41:41 +0000217 bool "mkfs_minix"
218 default n
219 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000220 The minix filesystem is a nice, small, compact, read-write filesystem
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000221 with little overhead. If you wish to be able to create minix
222 filesystems this utility will do the job for you.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000223
224comment "Minix filesystem support"
Mike Frysinger71a6a4e2007-01-24 08:24:43 +0000225 depends on FSCK_MINIX || MKFS_MINIX
Eric Andersenc9f20d92002-12-05 08:41:41 +0000226
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000227config FEATURE_MINIX2
Rob Landley2ec922e2006-04-13 23:22:16 +0000228 bool "Support Minix fs v2 (fsck_minix/mkfs_minix)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000229 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000230 depends on FSCK_MINIX || MKFS_MINIX
Eric Andersenc9f20d92002-12-05 08:41:41 +0000231 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000232 If you wish to be able to create version 2 minix filesystems, enable
233 this. If you enabled 'mkfs_minix' then you almost certainly want to
234 be using the version 2 filesystem support.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000235
Denis Vlasenko9d04b6b2009-03-28 02:13:01 +0000236config MKFS_VFAT
237 bool "mkfs_vfat"
238 default n
239 help
240 Utility to create FAT32 filesystems.
241
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000242config GETOPT
Eric Andersenc9f20d92002-12-05 08:41:41 +0000243 bool "getopt"
244 default n
245 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000246 The getopt utility is used to break up (parse) options in command
247 lines to make it easy to write complex shell scripts that also check
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000248 for legal (and illegal) options. If you want to write horribly
Eric Andersena0ac4522003-02-27 03:14:04 +0000249 complex shell scripts, or use some horribly complex shell script
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000250 written by others, this utility may be for you. Most people will
Eric Andersena0ac4522003-02-27 03:14:04 +0000251 wisely leave this disabled.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000252
Denys Vlasenkof3b92d32009-06-19 12:10:38 +0200253config FEATURE_GETOPT_LONG
254 bool "Support option -l"
255 default y if LONG_OPTS
256 help
257 Enable support for recognising long options using the -l option to
258 getopt.
259
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000260config HEXDUMP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000261 bool "hexdump"
262 default n
263 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000264 The hexdump utility is used to display binary data in a readable
265 way that is comparable to the output from most hex editors.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000266
Denis Vlasenkofbe5f392007-11-18 05:36:50 +0000267config FEATURE_HEXDUMP_REVERSE
268 bool "Support -R, reverse of 'hexdump -Cv'"
269 default n
270 depends on HEXDUMP
271 help
272 The hexdump utility is used to display binary data in an ascii
273 readable way. This option creates binary data from an ascii input.
274 NB: this option is non-standard. It's unwise to use it in scripts
275 aimed to be portable.
276
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000277config HD
278 bool "hd"
279 default n
280 select HEXDUMP
281 help
282 hd is an alias to hexdump -C.
283
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000284config HWCLOCK
Eric Andersenc9f20d92002-12-05 08:41:41 +0000285 bool "hwclock"
286 default n
287 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000288 The hwclock utility is used to read and set the hardware clock
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000289 on a system. This is primarily used to set the current time on
Eric Andersen88c916b2003-10-22 09:58:56 +0000290 shutdown in the hardware clock, so the hardware will keep the
291 correct time when Linux is _not_ running.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000292
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000293config FEATURE_HWCLOCK_LONG_OPTIONS
Rob Landley2ec922e2006-04-13 23:22:16 +0000294 bool "Support long options (--hctosys,...)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000295 default n
Denys Vlasenkof3b92d32009-06-19 12:10:38 +0200296 depends on HWCLOCK && LONG_OPTS
Eric Andersenc9f20d92002-12-05 08:41:41 +0000297 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000298 By default, the hwclock utility only uses short options. If you
Eric Andersen88c916b2003-10-22 09:58:56 +0000299 are overly fond of its long options, such as --hctosys, --utc, etc)
Eric Andersena0ac4522003-02-27 03:14:04 +0000300 then enable this option.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000301
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000302config FEATURE_HWCLOCK_ADJTIME_FHS
Rob Landley2ec922e2006-04-13 23:22:16 +0000303 bool "Use FHS /var/lib/hwclock/adjtime"
Mike Frysinger747fc5d2005-09-28 03:21:21 +0000304 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000305 depends on HWCLOCK
Mike Frysinger747fc5d2005-09-28 03:21:21 +0000306 help
307 Starting with FHS 2.3, the adjtime state file is supposed to exist
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000308 at /var/lib/hwclock/adjtime instead of /etc/adjtime. If you wish
Mike Frysinger747fc5d2005-09-28 03:21:21 +0000309 to use the FHS behavior, answer Y here, otherwise answer N for the
310 classic /etc/adjtime path.
311
Bernhard Reutner-Fischere99a92d2008-07-22 18:32:06 +0000312 pathname.com/fhs/pub/fhs-2.3.html#VARLIBHWCLOCKSTATEDIRECTORYFORHWCLO
Mike Frysinger747fc5d2005-09-28 03:21:21 +0000313
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000314config IPCRM
Rob Landley6eb1e412005-06-20 04:30:36 +0000315 bool "ipcrm"
316 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000317 select FEATURE_SUID
Rob Landley6eb1e412005-06-20 04:30:36 +0000318 help
319 The ipcrm utility allows the removal of System V interprocess
320 communication (IPC) objects and the associated data structures
321 from the system.
322
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000323config IPCS
Rob Landley6eb1e412005-06-20 04:30:36 +0000324 bool "ipcs"
325 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000326 select FEATURE_SUID
Rob Landley6eb1e412005-06-20 04:30:36 +0000327 help
328 The ipcs utility is used to provide information on the currently
329 allocated System V interprocess (IPC) objects in the system.
330
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000331config LOSETUP
Mike Frysinger75aa1922005-09-24 23:12:38 +0000332 bool "losetup"
333 default n
334 help
335 losetup is used to associate or detach a loop device with a regular
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000336 file or block device, and to query the status of a loop device. This
Mike Frysinger75aa1922005-09-24 23:12:38 +0000337 version does not currently support enabling data encryption.
338
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000339config MDEV
Rob Landley70f7ef72005-12-13 08:21:33 +0000340 bool "mdev"
341 default n
342 help
Mike Frysingerae302102007-02-14 13:20:29 +0000343 mdev is a mini-udev implementation for dynamically creating device
344 nodes in the /dev directory.
345
346 For more information, please see docs/mdev.txt
Rob Landley70f7ef72005-12-13 08:21:33 +0000347
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000348config FEATURE_MDEV_CONF
Rob Landley2ec922e2006-04-13 23:22:16 +0000349 bool "Support /etc/mdev.conf"
Rob Landley70f7ef72005-12-13 08:21:33 +0000350 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000351 depends on MDEV
Rob Landley70f7ef72005-12-13 08:21:33 +0000352 help
Mike Frysingerae302102007-02-14 13:20:29 +0000353 Add support for the mdev config file to control ownership and
354 permissions of the device nodes.
Rob Landley70f7ef72005-12-13 08:21:33 +0000355
Mike Frysingerae302102007-02-14 13:20:29 +0000356 For more information, please see docs/mdev.txt
Rob Landley70f7ef72005-12-13 08:21:33 +0000357
Mike Frysingerf0044c42008-02-01 06:53:50 +0000358config FEATURE_MDEV_RENAME
359 bool "Support subdirs/symlinks"
360 default n
361 depends on FEATURE_MDEV_CONF
362 help
363 Add support for renaming devices and creating symlinks.
364
365 For more information, please see docs/mdev.txt
366
Denis Vlasenkof2f38682008-03-29 17:26:10 +0000367config FEATURE_MDEV_RENAME_REGEXP
368 bool "Support regular expressions substitutions when renaming device"
369 default n
370 depends on FEATURE_MDEV_RENAME
371 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000372 Add support for regular expressions substitutions when renaming
373 device.
Denis Vlasenkof2f38682008-03-29 17:26:10 +0000374
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000375config FEATURE_MDEV_EXEC
Rob Landleyef10d522006-06-26 14:11:33 +0000376 bool "Support command execution at device addition/removal"
377 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000378 depends on FEATURE_MDEV_CONF
Rob Landleyef10d522006-06-26 14:11:33 +0000379 help
Mike Frysingerae302102007-02-14 13:20:29 +0000380 This adds support for an optional field to /etc/mdev.conf for
381 executing commands when devices are created/removed.
Rob Landleyef10d522006-06-26 14:11:33 +0000382
Mike Frysingerae302102007-02-14 13:20:29 +0000383 For more information, please see docs/mdev.txt
Rob Landleyef10d522006-06-26 14:11:33 +0000384
Mike Frysingera78ef2c2007-06-13 07:34:15 +0000385config FEATURE_MDEV_LOAD_FIRMWARE
386 bool "Support loading of firmwares"
387 default n
388 depends on MDEV
389 help
390 Some devices need to load firmware before they can be usable.
391
392 These devices will request userspace look up the files in
393 /lib/firmware/ and if it exists, send it to the kernel for
394 loading into the hardware.
395
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000396config MKSWAP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000397 bool "mkswap"
398 default n
399 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000400 The mkswap utility is used to configure a file or disk partition as
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000401 Linux swap space. This allows Linux to use the entire file or
Eric Andersena0ac4522003-02-27 03:14:04 +0000402 partition as if it were additional RAM, which can greatly increase
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000403 the capability of low-memory machines. This additional memory is
Eric Andersena0ac4522003-02-27 03:14:04 +0000404 much slower than real RAM, but can be very helpful at preventing your
Eric Andersen88c916b2003-10-22 09:58:56 +0000405 applications being killed by the Linux out of memory (OOM) killer.
406 Once you have created swap space using 'mkswap' you need to enable
407 the swap space using the 'swapon' utility.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000408
Denys Vlasenkobeca96f2009-06-19 13:14:48 +0200409config FEATURE_MKSWAP_UUID
410 bool "UUID support"
411 default n
412 depends on MKSWAP
413 help
414 Generate swap spaces with universally unique identifiers.
415
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000416config MORE
Eric Andersenc9f20d92002-12-05 08:41:41 +0000417 bool "more"
418 default n
419 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000420 more is a simple utility which allows you to read text one screen
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000421 sized page at a time. If you want to read text that is larger than
Eric Andersena0ac4522003-02-27 03:14:04 +0000422 the screen, and you are using anything faster than a 300 baud modem,
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000423 you will probably find this utility very helpful. If you don't have
Eric Andersena0ac4522003-02-27 03:14:04 +0000424 any need to reading text files, you can leave this disabled.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000425
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000426config FEATURE_USE_TERMIOS
Rob Landley2ec922e2006-04-13 23:22:16 +0000427 bool "Use termios to manipulate the screen"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000428 default y
Paul Fox9e1f92d2008-03-20 16:04:36 +0000429 depends on MORE || TOP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000430 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000431 This option allows utilities such as 'more' and 'top' to determine
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000432 the size of the screen. If you leave this disabled, your utilities
Eric Andersen88c916b2003-10-22 09:58:56 +0000433 that display things on the screen will be especially primitive and
Eric Andersena0ac4522003-02-27 03:14:04 +0000434 will be unable to determine the current screen size, and will be
435 unable to move the cursor.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000436
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000437config VOLUMEID
Denis Vlasenko35a064b2008-11-06 00:49:59 +0000438 bool #No description makes it a hidden option
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000439 default n
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000440
441config FEATURE_VOLUMEID_EXT
442 bool "Ext filesystem"
443 default n
444 depends on VOLUMEID
445 help
446 TODO
447
448config FEATURE_VOLUMEID_REISERFS
449 bool "Reiser filesystem"
450 default n
451 depends on VOLUMEID
452 help
453 TODO
454
455config FEATURE_VOLUMEID_FAT
456 bool "fat filesystem"
457 default n
458 depends on VOLUMEID
459 help
460 TODO
461
462config FEATURE_VOLUMEID_HFS
463 bool "hfs filesystem"
464 default n
465 depends on VOLUMEID
466 help
467 TODO
468
469config FEATURE_VOLUMEID_JFS
470 bool "jfs filesystem"
471 default n
472 depends on VOLUMEID
473 help
474 TODO
475
Denis Vlasenkod25c33f2008-03-17 09:25:05 +0000476### config FEATURE_VOLUMEID_UFS
477### bool "ufs filesystem"
478### default n
479### depends on VOLUMEID
480### help
481### TODO
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000482
483config FEATURE_VOLUMEID_XFS
484 bool "xfs filesystem"
485 default n
486 depends on VOLUMEID
487 help
488 TODO
489
490config FEATURE_VOLUMEID_NTFS
491 bool "ntfs filesystem"
492 default n
493 depends on VOLUMEID
494 help
495 TODO
496
497config FEATURE_VOLUMEID_ISO9660
498 bool "iso9660 filesystem"
499 default n
500 depends on VOLUMEID
501 help
502 TODO
503
504config FEATURE_VOLUMEID_UDF
505 bool "udf filesystem"
506 default n
507 depends on VOLUMEID
508 help
509 TODO
510
511config FEATURE_VOLUMEID_LUKS
512 bool "luks filesystem"
513 default n
514 depends on VOLUMEID
515 help
516 TODO
517
518config FEATURE_VOLUMEID_LINUXSWAP
519 bool "linux swap filesystem"
520 default n
521 depends on VOLUMEID
522 help
523 TODO
524
Denis Vlasenkod25c33f2008-03-17 09:25:05 +0000525### config FEATURE_VOLUMEID_LVM
526### bool "lvm"
527### default n
528### depends on VOLUMEID
529### help
530### TODO
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000531
532config FEATURE_VOLUMEID_CRAMFS
533 bool "cramfs filesystem"
534 default n
535 depends on VOLUMEID
536 help
537 TODO
538
Denis Vlasenkod25c33f2008-03-17 09:25:05 +0000539### config FEATURE_VOLUMEID_HPFS
540### bool "hpfs filesystem"
541### default n
542### depends on VOLUMEID
543### help
544### TODO
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000545
546config FEATURE_VOLUMEID_ROMFS
547 bool "romfs filesystem"
548 default n
549 depends on VOLUMEID
550 help
551 TODO
552
553config FEATURE_VOLUMEID_SYSV
554 bool "sysv filesystem"
555 default n
556 depends on VOLUMEID
557 help
558 TODO
559
Denis Vlasenkod25c33f2008-03-17 09:25:05 +0000560### config FEATURE_VOLUMEID_MINIX
561### bool "minix filesystem"
562### default n
563### depends on VOLUMEID
564### help
565### TODO
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000566
Denis Vlasenkoc5b73722008-03-17 09:21:26 +0000567### These only detect partition tables - not used (yet?)
568### config FEATURE_VOLUMEID_MAC
Denis Vlasenkod25c33f2008-03-17 09:25:05 +0000569### bool "mac filesystem"
570### default n
571### depends on VOLUMEID
572### help
573### TODO
Denis Vlasenko1f228982008-04-22 00:16:29 +0000574###
Denis Vlasenkoc5b73722008-03-17 09:21:26 +0000575### config FEATURE_VOLUMEID_MSDOS
Denis Vlasenkod25c33f2008-03-17 09:25:05 +0000576### bool "msdos filesystem"
577### default n
578### depends on VOLUMEID
579### help
580### TODO
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000581
582config FEATURE_VOLUMEID_OCFS2
583 bool "ocfs2 filesystem"
584 default n
585 depends on VOLUMEID
586 help
587 TODO
588
Denis Vlasenkod25c33f2008-03-17 09:25:05 +0000589### config FEATURE_VOLUMEID_HIGHPOINTRAID
590### bool "highpoint raid"
591### default n
592### depends on VOLUMEID
593### help
594### TODO
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000595
Denis Vlasenkod25c33f2008-03-17 09:25:05 +0000596### config FEATURE_VOLUMEID_ISWRAID
597### bool "intel raid"
598### default n
599### depends on VOLUMEID
600### help
601### TODO
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000602
Denis Vlasenkod25c33f2008-03-17 09:25:05 +0000603### config FEATURE_VOLUMEID_LSIRAID
604### bool "lsi raid"
605### default n
606### depends on VOLUMEID
607### help
608### TODO
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000609
Denis Vlasenkod25c33f2008-03-17 09:25:05 +0000610### config FEATURE_VOLUMEID_VIARAID
611### bool "via raid"
612### default n
613### depends on VOLUMEID
614### help
615### TODO
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000616
Denis Vlasenkod25c33f2008-03-17 09:25:05 +0000617### config FEATURE_VOLUMEID_SILICONRAID
618### bool "silicon raid"
619### default n
620### depends on VOLUMEID
621### help
622### TODO
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000623
Denis Vlasenkod25c33f2008-03-17 09:25:05 +0000624### config FEATURE_VOLUMEID_NVIDIARAID
625### bool "nvidia raid"
626### default n
627### depends on VOLUMEID
628### help
629### TODO
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000630
Denis Vlasenkod25c33f2008-03-17 09:25:05 +0000631### config FEATURE_VOLUMEID_PROMISERAID
632### bool "promise raid"
633### default n
634### depends on VOLUMEID
635### help
636### TODO
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000637
638config FEATURE_VOLUMEID_LINUXRAID
639 bool "linuxraid"
640 default n
641 depends on VOLUMEID
642 help
643 TODO
644
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000645config MOUNT
Mike Frysinger55092282006-02-02 23:14:57 +0000646 bool "mount"
647 default n
648 help
649 All files and filesystems in Unix are arranged into one big directory
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000650 tree. The 'mount' utility is used to graft a filesystem onto a
651 particular part of the tree. A filesystem can either live on a block
Mike Frysinger55092282006-02-02 23:14:57 +0000652 device, or it can be accessible over the network, as is the case with
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000653 NFS filesystems. Most people using BusyBox will also want to enable
Mike Frysinger55092282006-02-02 23:14:57 +0000654 the 'mount' utility.
655
Denis Vlasenkob1d8e7d2008-02-16 23:28:42 +0000656config FEATURE_MOUNT_FAKE
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000657 bool "Support option -f"
Denis Vlasenkob1d8e7d2008-02-16 23:28:42 +0000658 default n
659 depends on MOUNT
660 help
661 Enable support for faking a file system mount.
662
Denis Vlasenkof732e962008-02-18 12:07:49 +0000663config FEATURE_MOUNT_VERBOSE
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000664 bool "Support option -v"
Denis Vlasenkof732e962008-02-18 12:07:49 +0000665 default n
666 depends on MOUNT
667 help
668 Enable multi-level -v[vv...] verbose messages. Useful if you
669 debug mount problems and want to see what is exactly passed
670 to the kernel.
671
Denis Vlasenko2535f122007-09-15 13:28:30 +0000672config FEATURE_MOUNT_HELPERS
673 bool "Support mount helpers"
674 default n
675 depends on MOUNT
676 help
677 Enable mounting of virtual file systems via external helpers.
Denis Vlasenko32d49bc2008-02-03 23:52:41 +0000678 E.g. "mount obexfs#-b00.11.22.33.44.55 /mnt" will in effect call
679 "obexfs -b00.11.22.33.44.55 /mnt"
680 Also "mount -t sometype [-o opts] fs /mnt" will try
681 "sometype [-o opts] fs /mnt" if simple mount syscall fails.
682 The idea is to use such virtual filesystems in /etc/fstab.
Denis Vlasenko2535f122007-09-15 13:28:30 +0000683
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000684config FEATURE_MOUNT_LABEL
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000685 bool "Support specifiying devices by label or UUID"
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000686 default n
687 depends on MOUNT
Denis Vlasenko4824cca2008-03-21 18:29:01 +0000688 select VOLUMEID
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000689 help
690 This allows for specifying a device by label or uuid, rather than by
Denis Vlasenko1e19afd2008-10-12 11:20:08 +0000691 name. This feature utilizes the same functionality as blkid/findfs.
Denis Vlasenkode7684a2008-02-18 21:08:49 +0000692
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000693config FEATURE_MOUNT_NFS
Rob Landley2ec922e2006-04-13 23:22:16 +0000694 bool "Support mounting NFS file systems"
Mike Frysinger55092282006-02-02 23:14:57 +0000695 default n
Denis Vlasenkoa7825f22007-06-16 13:56:51 +0000696 depends on MOUNT
697 select FEATURE_HAVE_RPC
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000698 select FEATURE_SYSLOG
Mike Frysinger55092282006-02-02 23:14:57 +0000699 help
Rob Landleye3781b72006-08-08 01:39:49 +0000700 Enable mounting of NFS file systems.
701
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000702config FEATURE_MOUNT_CIFS
Rob Landley89d9d4d2006-09-01 08:10:44 +0000703 bool "Support mounting CIFS/SMB file systems"
704 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000705 depends on MOUNT
Rob Landley89d9d4d2006-09-01 08:10:44 +0000706 help
707 Enable support for samba mounts.
Denis Vlasenko39e93cc2006-09-10 18:38:17 +0000708
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000709config FEATURE_MOUNT_FLAGS
710 depends on MOUNT
Denis Vlasenko39e93cc2006-09-10 18:38:17 +0000711 bool "Support lots of -o flags in mount"
Rob Landleye3781b72006-08-08 01:39:49 +0000712 default y
713 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000714 Without this, mount only supports ro/rw/remount. With this, it
Rob Landleye3781b72006-08-08 01:39:49 +0000715 supports nosuid, suid, dev, nodev, exec, noexec, sync, async, atime,
716 noatime, diratime, nodiratime, loud, bind, move, shared, slave,
717 private, unbindable, rshared, rslave, rprivate, and runbindable.
718
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000719config FEATURE_MOUNT_FSTAB
720 depends on MOUNT
Rob Landleye3781b72006-08-08 01:39:49 +0000721 bool "Support /etc/fstab and -a"
722 default y
723 help
724 Support mount all and looking for files in /etc/fstab.
Mike Frysinger55092282006-02-02 23:14:57 +0000725
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000726config PIVOT_ROOT
Eric Andersenc9f20d92002-12-05 08:41:41 +0000727 bool "pivot_root"
728 default n
729 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000730 The pivot_root utility swaps the mount points for the root filesystem
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000731 with some other mounted filesystem. This allows you to do all sorts
Eric Andersena0ac4522003-02-27 03:14:04 +0000732 of wild and crazy things with your Linux system and is far more
733 powerful than 'chroot'.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000734
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000735 Note: This is for initrd in linux 2.4. Under initramfs (introduced
Rob Landley0f34a822005-10-27 22:55:50 +0000736 in linux 2.6) use switch_root instead.
737
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000738config RDATE
Eric Andersenc9f20d92002-12-05 08:41:41 +0000739 bool "rdate"
740 default n
741 help
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000742 The rdate utility allows you to synchronize the date and time of your
Eric Andersena0ac4522003-02-27 03:14:04 +0000743 system clock with the date and time of a remote networked system using
744 the RFC868 protocol, which is built into the inetd daemon on most
745 systems.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000746
Bernhard Reutner-Fischerc77e8432008-08-19 11:28:52 +0000747config RDEV
748 bool "rdev"
749 default n
750 help
751 Print the device node associated with the filesystem mounted at '/'.
752
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000753config READPROFILE
Mike Frysinger75aa1922005-09-24 23:12:38 +0000754 bool "readprofile"
755 default n
756 help
757 This allows you to parse /proc/profile for basic profiling.
758
Mike Frysinger6b160e42008-02-15 02:27:19 +0000759config RTCWAKE
760 bool "rtcwake"
761 default n
762 help
763 Enter a system sleep state until specified wakeup time.
764
Denis Vlasenko376003b2008-04-21 05:05:17 +0000765config SCRIPT
766 bool "script"
767 default n
768 help
769 The script makes typescript of terminal session.
770
Denys Vlasenko5e611152009-05-19 17:36:16 +0200771config SCRIPTREPLAY
772 bool "scriptreplay"
773 default n
774 help
775 This program replays a typescript, using timing information
776 given by script -t.
777
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000778config SETARCH
Mike Frysinger0a6b0bf2006-02-21 04:26:52 +0000779 bool "setarch"
780 default n
781 help
782 The linux32 utility is used to create a 32bit environment for the
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000783 specified program (usually a shell). It only makes sense to have
Mike Frysinger0a6b0bf2006-02-21 04:26:52 +0000784 this util on a system that supports both 64bit and 32bit userland
785 (like amd64/x86, ppc64/ppc, sparc64/sparc, etc...).
786
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000787config SWAPONOFF
Eric Andersenc9f20d92002-12-05 08:41:41 +0000788 bool "swaponoff"
789 default n
790 help
Eric Andersena0ac4522003-02-27 03:14:04 +0000791 This option enables both the 'swapon' and the 'swapoff' utilities.
792 Once you have created some swap space using 'mkswap', you also need
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000793 to enable your swap space with the 'swapon' utility. The 'swapoff'
Eric Andersena0ac4522003-02-27 03:14:04 +0000794 utility is used, typically at system shutdown, to disable any swap
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000795 space. If you are not using any swap space, you can leave this
Eric Andersena0ac4522003-02-27 03:14:04 +0000796 option disabled.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000797
Denis Vlasenkoee56e012008-05-18 23:05:34 +0000798config FEATURE_SWAPON_PRI
Bernhard Reutner-Fischer3576bed2008-05-19 08:25:23 +0000799 bool "Support priority option -p"
Denis Vlasenkoee56e012008-05-18 23:05:34 +0000800 default n
801 depends on SWAPONOFF
802 help
803 Enable support for setting swap device priority in swapon.
804
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000805config SWITCH_ROOT
Mike Frysinger55092282006-02-02 23:14:57 +0000806 bool "switch_root"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000807 default n
808 help
Mike Frysinger55092282006-02-02 23:14:57 +0000809 The switch_root utility is used from initramfs to select a new
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000810 root device. Under initramfs, you have to use this instead of
811 pivot_root. (Stop reading here if you don't care why.)
Eric Andersenc9f20d92002-12-05 08:41:41 +0000812
Mike Frysinger55092282006-02-02 23:14:57 +0000813 Booting with initramfs extracts a gzipped cpio archive into rootfs
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000814 (which is a variant of ramfs/tmpfs). Because rootfs can't be moved
815 or unmounted*, pivot_root will not work from initramfs. Instead,
Mike Frysinger55092282006-02-02 23:14:57 +0000816 switch_root deletes everything out of rootfs (including itself),
817 does a mount --move that overmounts rootfs with the new root, and
818 then execs the specified init program.
819
820 * Because the Linux kernel uses rootfs internally as the starting
821 and ending point for searching through the kernel's doubly linked
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000822 list of active mount points. That's why.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000823
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000824config UMOUNT
Eric Andersenc9f20d92002-12-05 08:41:41 +0000825 bool "umount"
826 default n
827 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000828 When you want to remove a mounted filesystem from its current mount
829 point, for example when you are shutting down the system, the
830 'umount' utility is the tool to use. If you enabled the 'mount'
831 utility, you almost certainly also want to enable 'umount'.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000832
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000833config FEATURE_UMOUNT_ALL
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000834 bool "Support option -a"
Rob Landleycc6d8d32006-02-08 20:06:57 +0000835 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000836 depends on UMOUNT
Rob Landleycc6d8d32006-02-08 20:06:57 +0000837 help
838 Support -a option to unmount all currently mounted filesystems.
839
Eric Andersenc9f20d92002-12-05 08:41:41 +0000840comment "Common options for mount/umount"
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000841 depends on MOUNT || UMOUNT
Eric Andersenc9f20d92002-12-05 08:41:41 +0000842
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000843config FEATURE_MOUNT_LOOP
Rob Landley2ec922e2006-04-13 23:22:16 +0000844 bool "Support loopback mounts"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000845 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000846 depends on MOUNT || UMOUNT
Eric Andersenc9f20d92002-12-05 08:41:41 +0000847 help
Rob Landley6a6798b2005-08-10 20:35:54 +0000848 Enabling this feature allows automatic mounting of files (containing
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000849 filesystem images) via the linux kernel's loopback devices.
850 The mount command will detect you are trying to mount a file instead
851 of a block device, and transparently associate the file with a
852 loopback device. The umount command will also free that loopback
853 device.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000854
Rob Landley6a6798b2005-08-10 20:35:54 +0000855 You can still use the 'losetup' utility (to manually associate files
Mike Frysinger71a6a4e2007-01-24 08:24:43 +0000856 with loop devices) if you need to do something advanced, such as
Rob Landley6a6798b2005-08-10 20:35:54 +0000857 specify an offset or cryptographic options to the loopback device.
858 (If you don't want umount to free the loop device, use "umount -D".)
Paul Fox3f6f3172005-07-19 20:55:37 +0000859
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000860config FEATURE_MTAB_SUPPORT
Rob Landley2ec922e2006-04-13 23:22:16 +0000861 bool "Support for the old /etc/mtab file"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000862 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000863 depends on MOUNT || UMOUNT
Denis Vlasenkob1d8e7d2008-02-16 23:28:42 +0000864 select FEATURE_MOUNT_FAKE
Eric Andersenc9f20d92002-12-05 08:41:41 +0000865 help
Rob Landley6a6798b2005-08-10 20:35:54 +0000866 Historically, Unix systems kept track of the currently mounted
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000867 partitions in the file "/etc/mtab". These days, the kernel exports
Rob Landley6a6798b2005-08-10 20:35:54 +0000868 the list of currently mounted partitions in "/proc/mounts", rendering
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000869 the old mtab file obsolete. (In modern systems, /etc/mtab should be
Rob Landley6a6798b2005-08-10 20:35:54 +0000870 a symlink to /proc/mounts.)
Eric Andersena0ac4522003-02-27 03:14:04 +0000871
Rob Landley6a6798b2005-08-10 20:35:54 +0000872 The only reason to have mount maintain an /etc/mtab file itself is if
873 your stripped-down embedded system does not have a /proc directory.
874 If you must use this, keep in mind it's inherently brittle (for
875 example a mount under chroot won't update it), can't handle modern
876 features like separate per-process filesystem namespaces, requires
877 that your /etc directory be writeable, tends to get easily confused
Rob Landley17507fa2006-05-08 02:22:24 +0000878 by --bind or --move mounts, won't update if you rename a directory
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000879 that contains a mount point, and so on. (In brief: avoid.)
Rob Landley17507fa2006-05-08 02:22:24 +0000880
881 About the only reason to use this is if you've removed /proc from
882 your kernel.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000883
Eric Andersenc9f20d92002-12-05 08:41:41 +0000884endmenu