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