| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | # | 
|  | 2 | # Block device driver configuration | 
|  | 3 | # | 
|  | 4 |  | 
| Jan Engelhardt | afd4403 | 2007-07-17 04:06:11 -0700 | [diff] [blame] | 5 | menuconfig MD | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 6 | bool "Multiple devices driver support (RAID and LVM)" | 
| Jan Engelhardt | afd4403 | 2007-07-17 04:06:11 -0700 | [diff] [blame] | 7 | depends on BLOCK | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 8 | help | 
|  | 9 | Support multiple physical spindles through a single logical device. | 
|  | 10 | Required for RAID and logical volume management. | 
|  | 11 |  | 
| Jan Engelhardt | afd4403 | 2007-07-17 04:06:11 -0700 | [diff] [blame] | 12 | if MD | 
|  | 13 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 14 | config BLK_DEV_MD | 
|  | 15 | tristate "RAID support" | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 16 | ---help--- | 
|  | 17 | This driver lets you combine several hard disk partitions into one | 
|  | 18 | logical block device. This can be used to simply append one | 
|  | 19 | partition to another one or to combine several redundant hard disks | 
|  | 20 | into a RAID1/4/5 device so as to provide protection against hard | 
|  | 21 | disk failures. This is called "Software RAID" since the combining of | 
|  | 22 | the partitions is done by the kernel. "Hardware RAID" means that the | 
|  | 23 | combining is done by a dedicated controller; if you have such a | 
|  | 24 | controller, you do not need to say Y here. | 
|  | 25 |  | 
|  | 26 | More information about Software RAID on Linux is contained in the | 
|  | 27 | Software RAID mini-HOWTO, available from | 
|  | 28 | <http://www.tldp.org/docs.html#howto>. There you will also learn | 
|  | 29 | where to get the supporting user space utilities raidtools. | 
|  | 30 |  | 
|  | 31 | If unsure, say N. | 
|  | 32 |  | 
|  | 33 | config MD_LINEAR | 
|  | 34 | tristate "Linear (append) mode" | 
|  | 35 | depends on BLK_DEV_MD | 
|  | 36 | ---help--- | 
|  | 37 | If you say Y here, then your multiple devices driver will be able to | 
|  | 38 | use the so-called linear mode, i.e. it will combine the hard disk | 
|  | 39 | partitions by simply appending one to the other. | 
|  | 40 |  | 
|  | 41 | To compile this as a module, choose M here: the module | 
|  | 42 | will be called linear. | 
|  | 43 |  | 
|  | 44 | If unsure, say Y. | 
|  | 45 |  | 
|  | 46 | config MD_RAID0 | 
|  | 47 | tristate "RAID-0 (striping) mode" | 
|  | 48 | depends on BLK_DEV_MD | 
|  | 49 | ---help--- | 
|  | 50 | If you say Y here, then your multiple devices driver will be able to | 
|  | 51 | use the so-called raid0 mode, i.e. it will combine the hard disk | 
|  | 52 | partitions into one logical device in such a fashion as to fill them | 
|  | 53 | up evenly, one chunk here and one chunk there. This will increase | 
|  | 54 | the throughput rate if the partitions reside on distinct disks. | 
|  | 55 |  | 
|  | 56 | Information about Software RAID on Linux is contained in the | 
|  | 57 | Software-RAID mini-HOWTO, available from | 
|  | 58 | <http://www.tldp.org/docs.html#howto>. There you will also | 
|  | 59 | learn where to get the supporting user space utilities raidtools. | 
|  | 60 |  | 
|  | 61 | To compile this as a module, choose M here: the module | 
|  | 62 | will be called raid0. | 
|  | 63 |  | 
|  | 64 | If unsure, say Y. | 
|  | 65 |  | 
|  | 66 | config MD_RAID1 | 
|  | 67 | tristate "RAID-1 (mirroring) mode" | 
|  | 68 | depends on BLK_DEV_MD | 
|  | 69 | ---help--- | 
|  | 70 | A RAID-1 set consists of several disk drives which are exact copies | 
|  | 71 | of each other.  In the event of a mirror failure, the RAID driver | 
|  | 72 | will continue to use the operational mirrors in the set, providing | 
|  | 73 | an error free MD (multiple device) to the higher levels of the | 
|  | 74 | kernel.  In a set with N drives, the available space is the capacity | 
|  | 75 | of a single drive, and the set protects against a failure of (N - 1) | 
|  | 76 | drives. | 
|  | 77 |  | 
|  | 78 | Information about Software RAID on Linux is contained in the | 
|  | 79 | Software-RAID mini-HOWTO, available from | 
|  | 80 | <http://www.tldp.org/docs.html#howto>.  There you will also | 
|  | 81 | learn where to get the supporting user space utilities raidtools. | 
|  | 82 |  | 
|  | 83 | If you want to use such a RAID-1 set, say Y.  To compile this code | 
|  | 84 | as a module, choose M here: the module will be called raid1. | 
|  | 85 |  | 
|  | 86 | If unsure, say Y. | 
|  | 87 |  | 
|  | 88 | config MD_RAID10 | 
|  | 89 | tristate "RAID-10 (mirrored striping) mode (EXPERIMENTAL)" | 
|  | 90 | depends on BLK_DEV_MD && EXPERIMENTAL | 
|  | 91 | ---help--- | 
|  | 92 | RAID-10 provides a combination of striping (RAID-0) and | 
| Justin Piszcz | 4d2554d | 2006-06-26 00:27:50 -0700 | [diff] [blame] | 93 | mirroring (RAID-1) with easier configuration and more flexible | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 94 | layout. | 
|  | 95 | Unlike RAID-0, but like RAID-1, RAID-10 requires all devices to | 
|  | 96 | be the same size (or at least, only as much as the smallest device | 
|  | 97 | will be used). | 
|  | 98 | RAID-10 provides a variety of layouts that provide different levels | 
|  | 99 | of redundancy and performance. | 
|  | 100 |  | 
|  | 101 | RAID-10 requires mdadm-1.7.0 or later, available at: | 
|  | 102 |  | 
|  | 103 | ftp://ftp.kernel.org/pub/linux/utils/raid/mdadm/ | 
|  | 104 |  | 
|  | 105 | If unsure, say Y. | 
|  | 106 |  | 
| NeilBrown | 16a53ec | 2006-06-26 00:27:38 -0700 | [diff] [blame] | 107 | config MD_RAID456 | 
|  | 108 | tristate "RAID-4/RAID-5/RAID-6 mode" | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 109 | depends on BLK_DEV_MD | 
| Dan Williams | 9bc89cd | 2007-01-02 11:10:44 -0700 | [diff] [blame] | 110 | select ASYNC_MEMCPY | 
|  | 111 | select ASYNC_XOR | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 112 | ---help--- | 
|  | 113 | A RAID-5 set of N drives with a capacity of C MB per drive provides | 
|  | 114 | the capacity of C * (N - 1) MB, and protects against a failure | 
|  | 115 | of a single drive. For a given sector (row) number, (N - 1) drives | 
|  | 116 | contain data sectors, and one drive contains the parity protection. | 
|  | 117 | For a RAID-4 set, the parity blocks are present on a single drive, | 
|  | 118 | while a RAID-5 set distributes the parity across the drives in one | 
|  | 119 | of the available parity distribution methods. | 
|  | 120 |  | 
| NeilBrown | 16a53ec | 2006-06-26 00:27:38 -0700 | [diff] [blame] | 121 | A RAID-6 set of N drives with a capacity of C MB per drive | 
|  | 122 | provides the capacity of C * (N - 2) MB, and protects | 
|  | 123 | against a failure of any two drives. For a given sector | 
|  | 124 | (row) number, (N - 2) drives contain data sectors, and two | 
|  | 125 | drives contains two independent redundancy syndromes.  Like | 
|  | 126 | RAID-5, RAID-6 distributes the syndromes across the drives | 
|  | 127 | in one of the available parity distribution methods. | 
|  | 128 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 129 | Information about Software RAID on Linux is contained in the | 
|  | 130 | Software-RAID mini-HOWTO, available from | 
|  | 131 | <http://www.tldp.org/docs.html#howto>. There you will also | 
|  | 132 | learn where to get the supporting user space utilities raidtools. | 
|  | 133 |  | 
| NeilBrown | 16a53ec | 2006-06-26 00:27:38 -0700 | [diff] [blame] | 134 | If you want to use such a RAID-4/RAID-5/RAID-6 set, say Y.  To | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 135 | compile this code as a module, choose M here: the module | 
| NeilBrown | 16a53ec | 2006-06-26 00:27:38 -0700 | [diff] [blame] | 136 | will be called raid456. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 137 |  | 
|  | 138 | If unsure, say Y. | 
|  | 139 |  | 
| NeilBrown | 2926955 | 2006-03-27 01:18:10 -0800 | [diff] [blame] | 140 | config MD_RAID5_RESHAPE | 
| NeilBrown | 14f50b4 | 2006-10-03 01:16:00 -0700 | [diff] [blame] | 141 | bool "Support adding drives to a raid-5 array" | 
|  | 142 | depends on MD_RAID456 | 
|  | 143 | default y | 
| NeilBrown | 2926955 | 2006-03-27 01:18:10 -0800 | [diff] [blame] | 144 | ---help--- | 
|  | 145 | A RAID-5 set can be expanded by adding extra drives. This | 
|  | 146 | requires "restriping" the array which means (almost) every | 
|  | 147 | block must be written to a different place. | 
|  | 148 |  | 
|  | 149 | This option allows such restriping to be done while the array | 
| NeilBrown | 14f50b4 | 2006-10-03 01:16:00 -0700 | [diff] [blame] | 150 | is online. | 
| NeilBrown | 2926955 | 2006-03-27 01:18:10 -0800 | [diff] [blame] | 151 |  | 
| Justin Piszcz | 4d2554d | 2006-06-26 00:27:50 -0700 | [diff] [blame] | 152 | You will need mdadm version 2.4.1 or later to use this | 
| NeilBrown | 6f91fe8 | 2006-04-10 22:52:48 -0700 | [diff] [blame] | 153 | feature safely.  During the early stage of reshape there is | 
|  | 154 | a critical section where live data is being over-written.  A | 
|  | 155 | crash during this time needs extra care for recovery.  The | 
|  | 156 | newer mdadm takes a copy of the data in the critical section | 
|  | 157 | and will restore it, if necessary, after a crash. | 
| NeilBrown | 2926955 | 2006-03-27 01:18:10 -0800 | [diff] [blame] | 158 |  | 
|  | 159 | The mdadm usage is e.g. | 
|  | 160 | mdadm --grow /dev/md1 --raid-disks=6 | 
|  | 161 | to grow '/dev/md1' to having 6 disks. | 
|  | 162 |  | 
|  | 163 | Note: The array can only be expanded, not contracted. | 
|  | 164 | There should be enough spares already present to make the new | 
|  | 165 | array workable. | 
|  | 166 |  | 
| NeilBrown | 14f50b4 | 2006-10-03 01:16:00 -0700 | [diff] [blame] | 167 | If unsure, say Y. | 
|  | 168 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 169 | config MD_MULTIPATH | 
|  | 170 | tristate "Multipath I/O support" | 
|  | 171 | depends on BLK_DEV_MD | 
|  | 172 | help | 
|  | 173 | Multipath-IO is the ability of certain devices to address the same | 
|  | 174 | physical disk over multiple 'IO paths'. The code ensures that such | 
|  | 175 | paths can be defined and handled at runtime, and ensures that a | 
|  | 176 | transparent failover to the backup path(s) happens if a IO errors | 
|  | 177 | arrives on the primary path. | 
|  | 178 |  | 
|  | 179 | If unsure, say N. | 
|  | 180 |  | 
|  | 181 | config MD_FAULTY | 
|  | 182 | tristate "Faulty test module for MD" | 
|  | 183 | depends on BLK_DEV_MD | 
|  | 184 | help | 
|  | 185 | The "faulty" module allows for a block device that occasionally returns | 
|  | 186 | read or write errors.  It is useful for testing. | 
|  | 187 |  | 
|  | 188 | In unsure, say N. | 
|  | 189 |  | 
|  | 190 | config BLK_DEV_DM | 
|  | 191 | tristate "Device mapper support" | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 192 | ---help--- | 
|  | 193 | Device-mapper is a low level volume manager.  It works by allowing | 
|  | 194 | people to specify mappings for ranges of logical sectors.  Various | 
|  | 195 | mapping types are available, in addition people may write their own | 
|  | 196 | modules containing custom mappings if they wish. | 
|  | 197 |  | 
|  | 198 | Higher level volume managers such as LVM2 use this driver. | 
|  | 199 |  | 
|  | 200 | To compile this as a module, choose M here: the module will be | 
|  | 201 | called dm-mod. | 
|  | 202 |  | 
|  | 203 | If unsure, say N. | 
|  | 204 |  | 
| Bryn Reeves | cc10920 | 2006-10-03 01:15:35 -0700 | [diff] [blame] | 205 | config DM_DEBUG | 
|  | 206 | boolean "Device mapper debugging support" | 
| Alasdair G Kergon | 0149e57 | 2008-02-08 02:10:32 +0000 | [diff] [blame] | 207 | depends on BLK_DEV_DM | 
| Bryn Reeves | cc10920 | 2006-10-03 01:15:35 -0700 | [diff] [blame] | 208 | ---help--- | 
|  | 209 | Enable this for messages that may help debug device-mapper problems. | 
|  | 210 |  | 
|  | 211 | If unsure, say N. | 
|  | 212 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 213 | config DM_CRYPT | 
|  | 214 | tristate "Crypt target support" | 
| Alasdair G Kergon | 0149e57 | 2008-02-08 02:10:32 +0000 | [diff] [blame] | 215 | depends on BLK_DEV_DM | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 216 | select CRYPTO | 
| Herbert Xu | 3263263 | 2006-12-10 09:50:36 +1100 | [diff] [blame] | 217 | select CRYPTO_CBC | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 218 | ---help--- | 
|  | 219 | This device-mapper target allows you to create a device that | 
|  | 220 | transparently encrypts the data on it. You'll need to activate | 
|  | 221 | the ciphers you're going to use in the cryptoapi configuration. | 
|  | 222 |  | 
|  | 223 | Information on how to use dm-crypt can be found on | 
|  | 224 |  | 
|  | 225 | <http://www.saout.de/misc/dm-crypt/> | 
|  | 226 |  | 
|  | 227 | To compile this code as a module, choose M here: the module will | 
|  | 228 | be called dm-crypt. | 
|  | 229 |  | 
|  | 230 | If unsure, say N. | 
|  | 231 |  | 
|  | 232 | config DM_SNAPSHOT | 
| Alasdair G Kergon | 0149e57 | 2008-02-08 02:10:32 +0000 | [diff] [blame] | 233 | tristate "Snapshot target" | 
|  | 234 | depends on BLK_DEV_DM | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 235 | ---help--- | 
| Justin Piszcz | 4d2554d | 2006-06-26 00:27:50 -0700 | [diff] [blame] | 236 | Allow volume managers to take writable snapshots of a device. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 237 |  | 
|  | 238 | config DM_MIRROR | 
| Alasdair G Kergon | 0149e57 | 2008-02-08 02:10:32 +0000 | [diff] [blame] | 239 | tristate "Mirror target" | 
|  | 240 | depends on BLK_DEV_DM | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 241 | ---help--- | 
|  | 242 | Allow volume managers to mirror logical volumes, also | 
|  | 243 | needed for live data migration tools such as 'pvmove'. | 
|  | 244 |  | 
|  | 245 | config DM_ZERO | 
| Alasdair G Kergon | 0149e57 | 2008-02-08 02:10:32 +0000 | [diff] [blame] | 246 | tristate "Zero target" | 
|  | 247 | depends on BLK_DEV_DM | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 248 | ---help--- | 
|  | 249 | A target that discards writes, and returns all zeroes for | 
|  | 250 | reads.  Useful in some recovery situations. | 
|  | 251 |  | 
|  | 252 | config DM_MULTIPATH | 
| Alasdair G Kergon | 0149e57 | 2008-02-08 02:10:32 +0000 | [diff] [blame] | 253 | tristate "Multipath target" | 
|  | 254 | depends on BLK_DEV_DM | 
| Chandra Seetharaman | fe9233f | 2008-05-23 18:16:40 -0700 | [diff] [blame] | 255 | # nasty syntax but means make DM_MULTIPATH independent | 
|  | 256 | # of SCSI_DH if the latter isn't defined but if | 
|  | 257 | # it is, DM_MULTIPATH must depend on it.  We get a build | 
|  | 258 | # error if SCSI_DH=m and DM_MULTIPATH=y | 
|  | 259 | depends on SCSI_DH || !SCSI_DH | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 260 | ---help--- | 
|  | 261 | Allow volume managers to support multipath hardware. | 
|  | 262 |  | 
| Heinz Mauelshagen | 26b9f22 | 2007-05-09 02:33:06 -0700 | [diff] [blame] | 263 | config DM_DELAY | 
|  | 264 | tristate "I/O delaying target (EXPERIMENTAL)" | 
|  | 265 | depends on BLK_DEV_DM && EXPERIMENTAL | 
|  | 266 | ---help--- | 
|  | 267 | A target that delays reads and/or writes and can send | 
|  | 268 | them to different devices.  Useful for testing. | 
|  | 269 |  | 
|  | 270 | If unsure, say N. | 
|  | 271 |  | 
| Mike Anderson | 51e5b2b | 2007-10-19 22:48:00 +0100 | [diff] [blame] | 272 | config DM_UEVENT | 
|  | 273 | bool "DM uevents (EXPERIMENTAL)" | 
|  | 274 | depends on BLK_DEV_DM && EXPERIMENTAL | 
|  | 275 | ---help--- | 
|  | 276 | Generate udev events for DM events. | 
|  | 277 |  | 
| Jan Engelhardt | afd4403 | 2007-07-17 04:06:11 -0700 | [diff] [blame] | 278 | endif # MD |