xref: /openbmc/linux/drivers/md/Kconfig (revision 9d09e663)
11da177e4SLinus Torvalds#
21da177e4SLinus Torvalds# Block device driver configuration
31da177e4SLinus Torvalds#
41da177e4SLinus Torvalds
5afd44034SJan Engelhardtmenuconfig MD
61da177e4SLinus Torvalds	bool "Multiple devices driver support (RAID and LVM)"
7afd44034SJan Engelhardt	depends on BLOCK
81da177e4SLinus Torvalds	help
91da177e4SLinus Torvalds	  Support multiple physical spindles through a single logical device.
101da177e4SLinus Torvalds	  Required for RAID and logical volume management.
111da177e4SLinus Torvalds
12afd44034SJan Engelhardtif MD
13afd44034SJan Engelhardt
141da177e4SLinus Torvaldsconfig BLK_DEV_MD
151da177e4SLinus Torvalds	tristate "RAID support"
161da177e4SLinus Torvalds	---help---
171da177e4SLinus Torvalds	  This driver lets you combine several hard disk partitions into one
181da177e4SLinus Torvalds	  logical block device. This can be used to simply append one
191da177e4SLinus Torvalds	  partition to another one or to combine several redundant hard disks
201da177e4SLinus Torvalds	  into a RAID1/4/5 device so as to provide protection against hard
211da177e4SLinus Torvalds	  disk failures. This is called "Software RAID" since the combining of
221da177e4SLinus Torvalds	  the partitions is done by the kernel. "Hardware RAID" means that the
231da177e4SLinus Torvalds	  combining is done by a dedicated controller; if you have such a
241da177e4SLinus Torvalds	  controller, you do not need to say Y here.
251da177e4SLinus Torvalds
261da177e4SLinus Torvalds	  More information about Software RAID on Linux is contained in the
271da177e4SLinus Torvalds	  Software RAID mini-HOWTO, available from
281da177e4SLinus Torvalds	  <http://www.tldp.org/docs.html#howto>. There you will also learn
291da177e4SLinus Torvalds	  where to get the supporting user space utilities raidtools.
301da177e4SLinus Torvalds
311da177e4SLinus Torvalds	  If unsure, say N.
321da177e4SLinus Torvalds
33a364092aSArjan van de Venconfig MD_AUTODETECT
34a364092aSArjan van de Ven	bool "Autodetect RAID arrays during kernel boot"
35ce52aebdSAlan Jenkins	depends on BLK_DEV_MD=y
36a364092aSArjan van de Ven	default y
37a364092aSArjan van de Ven	---help---
38a364092aSArjan van de Ven	  If you say Y here, then the kernel will try to autodetect raid
39a364092aSArjan van de Ven	  arrays as part of its boot process.
40a364092aSArjan van de Ven
41a364092aSArjan van de Ven	  If you don't use raid and say Y, this autodetection can cause
42a364092aSArjan van de Ven	  a several-second delay in the boot time due to various
43a364092aSArjan van de Ven	  synchronisation steps that are part of this step.
44a364092aSArjan van de Ven
45a364092aSArjan van de Ven	  If unsure, say Y.
46a364092aSArjan van de Ven
471da177e4SLinus Torvaldsconfig MD_LINEAR
481da177e4SLinus Torvalds	tristate "Linear (append) mode"
491da177e4SLinus Torvalds	depends on BLK_DEV_MD
501da177e4SLinus Torvalds	---help---
511da177e4SLinus Torvalds	  If you say Y here, then your multiple devices driver will be able to
521da177e4SLinus Torvalds	  use the so-called linear mode, i.e. it will combine the hard disk
531da177e4SLinus Torvalds	  partitions by simply appending one to the other.
541da177e4SLinus Torvalds
551da177e4SLinus Torvalds	  To compile this as a module, choose M here: the module
561da177e4SLinus Torvalds	  will be called linear.
571da177e4SLinus Torvalds
581da177e4SLinus Torvalds	  If unsure, say Y.
591da177e4SLinus Torvalds
601da177e4SLinus Torvaldsconfig MD_RAID0
611da177e4SLinus Torvalds	tristate "RAID-0 (striping) mode"
621da177e4SLinus Torvalds	depends on BLK_DEV_MD
631da177e4SLinus Torvalds	---help---
641da177e4SLinus Torvalds	  If you say Y here, then your multiple devices driver will be able to
651da177e4SLinus Torvalds	  use the so-called raid0 mode, i.e. it will combine the hard disk
661da177e4SLinus Torvalds	  partitions into one logical device in such a fashion as to fill them
671da177e4SLinus Torvalds	  up evenly, one chunk here and one chunk there. This will increase
681da177e4SLinus Torvalds	  the throughput rate if the partitions reside on distinct disks.
691da177e4SLinus Torvalds
701da177e4SLinus Torvalds	  Information about Software RAID on Linux is contained in the
711da177e4SLinus Torvalds	  Software-RAID mini-HOWTO, available from
721da177e4SLinus Torvalds	  <http://www.tldp.org/docs.html#howto>. There you will also
731da177e4SLinus Torvalds	  learn where to get the supporting user space utilities raidtools.
741da177e4SLinus Torvalds
751da177e4SLinus Torvalds	  To compile this as a module, choose M here: the module
761da177e4SLinus Torvalds	  will be called raid0.
771da177e4SLinus Torvalds
781da177e4SLinus Torvalds	  If unsure, say Y.
791da177e4SLinus Torvalds
801da177e4SLinus Torvaldsconfig MD_RAID1
811da177e4SLinus Torvalds	tristate "RAID-1 (mirroring) mode"
821da177e4SLinus Torvalds	depends on BLK_DEV_MD
831da177e4SLinus Torvalds	---help---
841da177e4SLinus Torvalds	  A RAID-1 set consists of several disk drives which are exact copies
851da177e4SLinus Torvalds	  of each other.  In the event of a mirror failure, the RAID driver
861da177e4SLinus Torvalds	  will continue to use the operational mirrors in the set, providing
871da177e4SLinus Torvalds	  an error free MD (multiple device) to the higher levels of the
881da177e4SLinus Torvalds	  kernel.  In a set with N drives, the available space is the capacity
891da177e4SLinus Torvalds	  of a single drive, and the set protects against a failure of (N - 1)
901da177e4SLinus Torvalds	  drives.
911da177e4SLinus Torvalds
921da177e4SLinus Torvalds	  Information about Software RAID on Linux is contained in the
931da177e4SLinus Torvalds	  Software-RAID mini-HOWTO, available from
941da177e4SLinus Torvalds	  <http://www.tldp.org/docs.html#howto>.  There you will also
951da177e4SLinus Torvalds	  learn where to get the supporting user space utilities raidtools.
961da177e4SLinus Torvalds
971da177e4SLinus Torvalds	  If you want to use such a RAID-1 set, say Y.  To compile this code
981da177e4SLinus Torvalds	  as a module, choose M here: the module will be called raid1.
991da177e4SLinus Torvalds
1001da177e4SLinus Torvalds	  If unsure, say Y.
1011da177e4SLinus Torvalds
1021da177e4SLinus Torvaldsconfig MD_RAID10
10308fb730cSNeilBrown	tristate "RAID-10 (mirrored striping) mode"
10408fb730cSNeilBrown	depends on BLK_DEV_MD
1051da177e4SLinus Torvalds	---help---
1061da177e4SLinus Torvalds	  RAID-10 provides a combination of striping (RAID-0) and
1074d2554d0SJustin Piszcz	  mirroring (RAID-1) with easier configuration and more flexible
1081da177e4SLinus Torvalds	  layout.
1091da177e4SLinus Torvalds	  Unlike RAID-0, but like RAID-1, RAID-10 requires all devices to
1101da177e4SLinus Torvalds	  be the same size (or at least, only as much as the smallest device
1111da177e4SLinus Torvalds	  will be used).
1121da177e4SLinus Torvalds	  RAID-10 provides a variety of layouts that provide different levels
1131da177e4SLinus Torvalds	  of redundancy and performance.
1141da177e4SLinus Torvalds
1151da177e4SLinus Torvalds	  RAID-10 requires mdadm-1.7.0 or later, available at:
1161da177e4SLinus Torvalds
1171da177e4SLinus Torvalds	  ftp://ftp.kernel.org/pub/linux/utils/raid/mdadm/
1181da177e4SLinus Torvalds
1191da177e4SLinus Torvalds	  If unsure, say Y.
1201da177e4SLinus Torvalds
12116a53eccSNeilBrownconfig MD_RAID456
12216a53eccSNeilBrown	tristate "RAID-4/RAID-5/RAID-6 mode"
1231da177e4SLinus Torvalds	depends on BLK_DEV_MD
124f5e70d0fSDavid Woodhouse	select RAID6_PQ
1259bc89cd8SDan Williams	select ASYNC_MEMCPY
1269bc89cd8SDan Williams	select ASYNC_XOR
127ac6b53b6SDan Williams	select ASYNC_PQ
128ac6b53b6SDan Williams	select ASYNC_RAID6_RECOV
1291da177e4SLinus Torvalds	---help---
1301da177e4SLinus Torvalds	  A RAID-5 set of N drives with a capacity of C MB per drive provides
1311da177e4SLinus Torvalds	  the capacity of C * (N - 1) MB, and protects against a failure
1321da177e4SLinus Torvalds	  of a single drive. For a given sector (row) number, (N - 1) drives
1331da177e4SLinus Torvalds	  contain data sectors, and one drive contains the parity protection.
1341da177e4SLinus Torvalds	  For a RAID-4 set, the parity blocks are present on a single drive,
1351da177e4SLinus Torvalds	  while a RAID-5 set distributes the parity across the drives in one
1361da177e4SLinus Torvalds	  of the available parity distribution methods.
1371da177e4SLinus Torvalds
13816a53eccSNeilBrown	  A RAID-6 set of N drives with a capacity of C MB per drive
13916a53eccSNeilBrown	  provides the capacity of C * (N - 2) MB, and protects
14016a53eccSNeilBrown	  against a failure of any two drives. For a given sector
14116a53eccSNeilBrown	  (row) number, (N - 2) drives contain data sectors, and two
14216a53eccSNeilBrown	  drives contains two independent redundancy syndromes.  Like
14316a53eccSNeilBrown	  RAID-5, RAID-6 distributes the syndromes across the drives
14416a53eccSNeilBrown	  in one of the available parity distribution methods.
14516a53eccSNeilBrown
1461da177e4SLinus Torvalds	  Information about Software RAID on Linux is contained in the
1471da177e4SLinus Torvalds	  Software-RAID mini-HOWTO, available from
1481da177e4SLinus Torvalds	  <http://www.tldp.org/docs.html#howto>. There you will also
1491da177e4SLinus Torvalds	  learn where to get the supporting user space utilities raidtools.
1501da177e4SLinus Torvalds
15116a53eccSNeilBrown	  If you want to use such a RAID-4/RAID-5/RAID-6 set, say Y.  To
1521da177e4SLinus Torvalds	  compile this code as a module, choose M here: the module
15316a53eccSNeilBrown	  will be called raid456.
1541da177e4SLinus Torvalds
1551da177e4SLinus Torvalds	  If unsure, say Y.
1561da177e4SLinus Torvalds
15707a3b417SDan Williamsconfig MULTICORE_RAID456
15807a3b417SDan Williams	bool "RAID-4/RAID-5/RAID-6 Multicore processing (EXPERIMENTAL)"
15907a3b417SDan Williams	depends on MD_RAID456
16007a3b417SDan Williams	depends on SMP
16107a3b417SDan Williams	depends on EXPERIMENTAL
16207a3b417SDan Williams	---help---
16307a3b417SDan Williams	  Enable the raid456 module to dispatch per-stripe raid operations to a
16407a3b417SDan Williams	  thread pool.
16507a3b417SDan Williams
16607a3b417SDan Williams	  If unsure, say N.
16707a3b417SDan Williams
1681da177e4SLinus Torvaldsconfig MD_MULTIPATH
1691da177e4SLinus Torvalds	tristate "Multipath I/O support"
1701da177e4SLinus Torvalds	depends on BLK_DEV_MD
1711da177e4SLinus Torvalds	help
17293bd89a6SNeilBrown	  MD_MULTIPATH provides a simple multi-path personality for use
17393bd89a6SNeilBrown	  the MD framework.  It is not under active development.  New
17493bd89a6SNeilBrown	  projects should consider using DM_MULTIPATH which has more
17593bd89a6SNeilBrown	  features and more testing.
1761da177e4SLinus Torvalds
1771da177e4SLinus Torvalds	  If unsure, say N.
1781da177e4SLinus Torvalds
1791da177e4SLinus Torvaldsconfig MD_FAULTY
1801da177e4SLinus Torvalds	tristate "Faulty test module for MD"
1811da177e4SLinus Torvalds	depends on BLK_DEV_MD
1821da177e4SLinus Torvalds	help
1831da177e4SLinus Torvalds	  The "faulty" module allows for a block device that occasionally returns
1841da177e4SLinus Torvalds	  read or write errors.  It is useful for testing.
1851da177e4SLinus Torvalds
1861da177e4SLinus Torvalds	  In unsure, say N.
1871da177e4SLinus Torvalds
1881da177e4SLinus Torvaldsconfig BLK_DEV_DM
1891da177e4SLinus Torvalds	tristate "Device mapper support"
1901da177e4SLinus Torvalds	---help---
1911da177e4SLinus Torvalds	  Device-mapper is a low level volume manager.  It works by allowing
1921da177e4SLinus Torvalds	  people to specify mappings for ranges of logical sectors.  Various
1931da177e4SLinus Torvalds	  mapping types are available, in addition people may write their own
1941da177e4SLinus Torvalds	  modules containing custom mappings if they wish.
1951da177e4SLinus Torvalds
1961da177e4SLinus Torvalds	  Higher level volume managers such as LVM2 use this driver.
1971da177e4SLinus Torvalds
1981da177e4SLinus Torvalds	  To compile this as a module, choose M here: the module will be
1991da177e4SLinus Torvalds	  called dm-mod.
2001da177e4SLinus Torvalds
2011da177e4SLinus Torvalds	  If unsure, say N.
2021da177e4SLinus Torvalds
203cc109201SBryn Reevesconfig DM_DEBUG
204cc109201SBryn Reeves	boolean "Device mapper debugging support"
2050149e57fSAlasdair G Kergon	depends on BLK_DEV_DM
206cc109201SBryn Reeves	---help---
207cc109201SBryn Reeves	  Enable this for messages that may help debug device-mapper problems.
208cc109201SBryn Reeves
209cc109201SBryn Reeves	  If unsure, say N.
210cc109201SBryn Reeves
2111da177e4SLinus Torvaldsconfig DM_CRYPT
2121da177e4SLinus Torvalds	tristate "Crypt target support"
2130149e57fSAlasdair G Kergon	depends on BLK_DEV_DM
2141da177e4SLinus Torvalds	select CRYPTO
2153263263fSHerbert Xu	select CRYPTO_CBC
2161da177e4SLinus Torvalds	---help---
2171da177e4SLinus Torvalds	  This device-mapper target allows you to create a device that
2181da177e4SLinus Torvalds	  transparently encrypts the data on it. You'll need to activate
2191da177e4SLinus Torvalds	  the ciphers you're going to use in the cryptoapi configuration.
2201da177e4SLinus Torvalds
2211da177e4SLinus Torvalds	  Information on how to use dm-crypt can be found on
2221da177e4SLinus Torvalds
2231da177e4SLinus Torvalds	  <http://www.saout.de/misc/dm-crypt/>
2241da177e4SLinus Torvalds
2251da177e4SLinus Torvalds	  To compile this code as a module, choose M here: the module will
2261da177e4SLinus Torvalds	  be called dm-crypt.
2271da177e4SLinus Torvalds
2281da177e4SLinus Torvalds	  If unsure, say N.
2291da177e4SLinus Torvalds
2301da177e4SLinus Torvaldsconfig DM_SNAPSHOT
2310149e57fSAlasdair G Kergon       tristate "Snapshot target"
2320149e57fSAlasdair G Kergon       depends on BLK_DEV_DM
2331da177e4SLinus Torvalds       ---help---
2344d2554d0SJustin Piszcz         Allow volume managers to take writable snapshots of a device.
2351da177e4SLinus Torvalds
2361da177e4SLinus Torvaldsconfig DM_MIRROR
2370149e57fSAlasdair G Kergon       tristate "Mirror target"
2380149e57fSAlasdair G Kergon       depends on BLK_DEV_DM
2391da177e4SLinus Torvalds       ---help---
2401da177e4SLinus Torvalds         Allow volume managers to mirror logical volumes, also
2411da177e4SLinus Torvalds         needed for live data migration tools such as 'pvmove'.
2421da177e4SLinus Torvalds
2439d09e663SNeilBrownconfig DM_RAID
2449d09e663SNeilBrown       tristate "RAID 4/5/6 target (EXPERIMENTAL)"
2459d09e663SNeilBrown       depends on BLK_DEV_DM && EXPERIMENTAL
2469d09e663SNeilBrown       select MD_RAID456
2479d09e663SNeilBrown       select BLK_DEV_MD
2489d09e663SNeilBrown       ---help---
2499d09e663SNeilBrown	 A dm target that supports RAID4, RAID5 and RAID6 mappings
2509d09e663SNeilBrown
2519d09e663SNeilBrown	 A RAID-5 set of N drives with a capacity of C MB per drive provides
2529d09e663SNeilBrown	 the capacity of C * (N - 1) MB, and protects against a failure
2539d09e663SNeilBrown	 of a single drive. For a given sector (row) number, (N - 1) drives
2549d09e663SNeilBrown	 contain data sectors, and one drive contains the parity protection.
2559d09e663SNeilBrown	 For a RAID-4 set, the parity blocks are present on a single drive,
2569d09e663SNeilBrown	 while a RAID-5 set distributes the parity across the drives in one
2579d09e663SNeilBrown	 of the available parity distribution methods.
2589d09e663SNeilBrown
2599d09e663SNeilBrown	 A RAID-6 set of N drives with a capacity of C MB per drive
2609d09e663SNeilBrown	 provides the capacity of C * (N - 2) MB, and protects
2619d09e663SNeilBrown	 against a failure of any two drives. For a given sector
2629d09e663SNeilBrown	 (row) number, (N - 2) drives contain data sectors, and two
2639d09e663SNeilBrown	 drives contains two independent redundancy syndromes.  Like
2649d09e663SNeilBrown	 RAID-5, RAID-6 distributes the syndromes across the drives
2659d09e663SNeilBrown	 in one of the available parity distribution methods.
2669d09e663SNeilBrown
267f5db4af4SJonthan Brassowconfig DM_LOG_USERSPACE
268f5db4af4SJonthan Brassow	tristate "Mirror userspace logging (EXPERIMENTAL)"
269f5db4af4SJonthan Brassow	depends on DM_MIRROR && EXPERIMENTAL && NET
270f5db4af4SJonthan Brassow	select CONNECTOR
271f5db4af4SJonthan Brassow	---help---
272f5db4af4SJonthan Brassow	  The userspace logging module provides a mechanism for
273f5db4af4SJonthan Brassow	  relaying the dm-dirty-log API to userspace.  Log designs
274f5db4af4SJonthan Brassow	  which are more suited to userspace implementation (e.g.
275f5db4af4SJonthan Brassow	  shared storage logs) or experimental logs can be implemented
276f5db4af4SJonthan Brassow	  by leveraging this framework.
277f5db4af4SJonthan Brassow
2781da177e4SLinus Torvaldsconfig DM_ZERO
2790149e57fSAlasdair G Kergon	tristate "Zero target"
2800149e57fSAlasdair G Kergon	depends on BLK_DEV_DM
2811da177e4SLinus Torvalds	---help---
2821da177e4SLinus Torvalds	  A target that discards writes, and returns all zeroes for
2831da177e4SLinus Torvalds	  reads.  Useful in some recovery situations.
2841da177e4SLinus Torvalds
2851da177e4SLinus Torvaldsconfig DM_MULTIPATH
2860149e57fSAlasdair G Kergon	tristate "Multipath target"
2870149e57fSAlasdair G Kergon	depends on BLK_DEV_DM
288fe9233fbSChandra Seetharaman	# nasty syntax but means make DM_MULTIPATH independent
289fe9233fbSChandra Seetharaman	# of SCSI_DH if the latter isn't defined but if
290fe9233fbSChandra Seetharaman	# it is, DM_MULTIPATH must depend on it.  We get a build
291fe9233fbSChandra Seetharaman	# error if SCSI_DH=m and DM_MULTIPATH=y
292fe9233fbSChandra Seetharaman	depends on SCSI_DH || !SCSI_DH
2931da177e4SLinus Torvalds	---help---
2941da177e4SLinus Torvalds	  Allow volume managers to support multipath hardware.
2951da177e4SLinus Torvalds
296fd5e0339SKiyoshi Uedaconfig DM_MULTIPATH_QL
297fd5e0339SKiyoshi Ueda	tristate "I/O Path Selector based on the number of in-flight I/Os"
298fd5e0339SKiyoshi Ueda	depends on DM_MULTIPATH
299fd5e0339SKiyoshi Ueda	---help---
300fd5e0339SKiyoshi Ueda	  This path selector is a dynamic load balancer which selects
301fd5e0339SKiyoshi Ueda	  the path with the least number of in-flight I/Os.
302fd5e0339SKiyoshi Ueda
303fd5e0339SKiyoshi Ueda	  If unsure, say N.
304fd5e0339SKiyoshi Ueda
305f392ba88SKiyoshi Uedaconfig DM_MULTIPATH_ST
306f392ba88SKiyoshi Ueda	tristate "I/O Path Selector based on the service time"
307f392ba88SKiyoshi Ueda	depends on DM_MULTIPATH
308f392ba88SKiyoshi Ueda	---help---
309f392ba88SKiyoshi Ueda	  This path selector is a dynamic load balancer which selects
310f392ba88SKiyoshi Ueda	  the path expected to complete the incoming I/O in the shortest
311f392ba88SKiyoshi Ueda	  time.
312f392ba88SKiyoshi Ueda
313f392ba88SKiyoshi Ueda	  If unsure, say N.
314f392ba88SKiyoshi Ueda
31526b9f228SHeinz Mauelshagenconfig DM_DELAY
31626b9f228SHeinz Mauelshagen	tristate "I/O delaying target (EXPERIMENTAL)"
31726b9f228SHeinz Mauelshagen	depends on BLK_DEV_DM && EXPERIMENTAL
31826b9f228SHeinz Mauelshagen	---help---
31926b9f228SHeinz Mauelshagen	A target that delays reads and/or writes and can send
32026b9f228SHeinz Mauelshagen	them to different devices.  Useful for testing.
32126b9f228SHeinz Mauelshagen
32226b9f228SHeinz Mauelshagen	If unsure, say N.
32326b9f228SHeinz Mauelshagen
32451e5b2bdSMike Andersonconfig DM_UEVENT
32551e5b2bdSMike Anderson	bool "DM uevents (EXPERIMENTAL)"
32651e5b2bdSMike Anderson	depends on BLK_DEV_DM && EXPERIMENTAL
32751e5b2bdSMike Anderson	---help---
32851e5b2bdSMike Anderson	Generate udev events for DM events.
32951e5b2bdSMike Anderson
330afd44034SJan Engelhardtendif # MD
331