[PATCH] dm: add debug macro
[linux-2.6.git] / drivers / md / Kconfig
1 #
2 # Block device driver configuration
3 #
4
5 if BLOCK
6
7 menu "Multi-device support (RAID and LVM)"
8
9 config MD
10         bool "Multiple devices driver support (RAID and LVM)"
11         help
12           Support multiple physical spindles through a single logical device.
13           Required for RAID and logical volume management.
14
15 config BLK_DEV_MD
16         tristate "RAID support"
17         depends on MD
18         ---help---
19           This driver lets you combine several hard disk partitions into one
20           logical block device. This can be used to simply append one
21           partition to another one or to combine several redundant hard disks
22           into a RAID1/4/5 device so as to provide protection against hard
23           disk failures. This is called "Software RAID" since the combining of
24           the partitions is done by the kernel. "Hardware RAID" means that the
25           combining is done by a dedicated controller; if you have such a
26           controller, you do not need to say Y here.
27
28           More information about Software RAID on Linux is contained in the
29           Software RAID mini-HOWTO, available from
30           <http://www.tldp.org/docs.html#howto>. There you will also learn
31           where to get the supporting user space utilities raidtools.
32
33           If unsure, say N.
34
35 config MD_LINEAR
36         tristate "Linear (append) mode"
37         depends on BLK_DEV_MD
38         ---help---
39           If you say Y here, then your multiple devices driver will be able to
40           use the so-called linear mode, i.e. it will combine the hard disk
41           partitions by simply appending one to the other.
42
43           To compile this as a module, choose M here: the module
44           will be called linear.
45
46           If unsure, say Y.
47
48 config MD_RAID0
49         tristate "RAID-0 (striping) mode"
50         depends on BLK_DEV_MD
51         ---help---
52           If you say Y here, then your multiple devices driver will be able to
53           use the so-called raid0 mode, i.e. it will combine the hard disk
54           partitions into one logical device in such a fashion as to fill them
55           up evenly, one chunk here and one chunk there. This will increase
56           the throughput rate if the partitions reside on distinct disks.
57
58           Information about Software RAID on Linux is contained in the
59           Software-RAID mini-HOWTO, available from
60           <http://www.tldp.org/docs.html#howto>. There you will also
61           learn where to get the supporting user space utilities raidtools.
62
63           To compile this as a module, choose M here: the module
64           will be called raid0.
65
66           If unsure, say Y.
67
68 config MD_RAID1
69         tristate "RAID-1 (mirroring) mode"
70         depends on BLK_DEV_MD
71         ---help---
72           A RAID-1 set consists of several disk drives which are exact copies
73           of each other.  In the event of a mirror failure, the RAID driver
74           will continue to use the operational mirrors in the set, providing
75           an error free MD (multiple device) to the higher levels of the
76           kernel.  In a set with N drives, the available space is the capacity
77           of a single drive, and the set protects against a failure of (N - 1)
78           drives.
79
80           Information about Software RAID on Linux is contained in the
81           Software-RAID mini-HOWTO, available from
82           <http://www.tldp.org/docs.html#howto>.  There you will also
83           learn where to get the supporting user space utilities raidtools.
84
85           If you want to use such a RAID-1 set, say Y.  To compile this code
86           as a module, choose M here: the module will be called raid1.
87
88           If unsure, say Y.
89
90 config MD_RAID10
91         tristate "RAID-10 (mirrored striping) mode (EXPERIMENTAL)"
92         depends on BLK_DEV_MD && EXPERIMENTAL
93         ---help---
94           RAID-10 provides a combination of striping (RAID-0) and
95           mirroring (RAID-1) with easier configuration and more flexible
96           layout.
97           Unlike RAID-0, but like RAID-1, RAID-10 requires all devices to
98           be the same size (or at least, only as much as the smallest device
99           will be used).
100           RAID-10 provides a variety of layouts that provide different levels
101           of redundancy and performance.
102
103           RAID-10 requires mdadm-1.7.0 or later, available at:
104
105           ftp://ftp.kernel.org/pub/linux/utils/raid/mdadm/
106
107           If unsure, say Y.
108
109 config MD_RAID456
110         tristate "RAID-4/RAID-5/RAID-6 mode"
111         depends on BLK_DEV_MD
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
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
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
134           If you want to use such a RAID-4/RAID-5/RAID-6 set, say Y.  To
135           compile this code as a module, choose M here: the module
136           will be called raid456.
137
138           If unsure, say Y.
139
140 config MD_RAID5_RESHAPE
141         bool "Support adding drives to a raid-5 array (experimental)"
142         depends on MD_RAID456 && EXPERIMENTAL
143         ---help---
144           A RAID-5 set can be expanded by adding extra drives. This
145           requires "restriping" the array which means (almost) every
146           block must be written to a different place.
147
148           This option allows such restriping to be done while the array
149           is online.  However it is still EXPERIMENTAL code.  It should
150           work, but please be sure that you have backups.
151
152           You will need mdadm version 2.4.1 or later to use this
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.
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
167 config MD_MULTIPATH
168         tristate "Multipath I/O support"
169         depends on BLK_DEV_MD
170         help
171           Multipath-IO is the ability of certain devices to address the same
172           physical disk over multiple 'IO paths'. The code ensures that such
173           paths can be defined and handled at runtime, and ensures that a
174           transparent failover to the backup path(s) happens if a IO errors
175           arrives on the primary path.
176
177           If unsure, say N.
178
179 config MD_FAULTY
180         tristate "Faulty test module for MD"
181         depends on BLK_DEV_MD
182         help
183           The "faulty" module allows for a block device that occasionally returns
184           read or write errors.  It is useful for testing.
185
186           In unsure, say N.
187
188 config BLK_DEV_DM
189         tristate "Device mapper support"
190         depends on MD
191         ---help---
192           Device-mapper is a low level volume manager.  It works by allowing
193           people to specify mappings for ranges of logical sectors.  Various
194           mapping types are available, in addition people may write their own
195           modules containing custom mappings if they wish.
196
197           Higher level volume managers such as LVM2 use this driver.
198
199           To compile this as a module, choose M here: the module will be
200           called dm-mod.
201
202           If unsure, say N.
203
204 config DM_DEBUG
205         boolean "Device mapper debugging support"
206         depends on BLK_DEV_DM && EXPERIMENTAL
207         ---help---
208           Enable this for messages that may help debug device-mapper problems.
209
210           If unsure, say N.
211
212 config DM_CRYPT
213         tristate "Crypt target support"
214         depends on BLK_DEV_DM && EXPERIMENTAL
215         select CRYPTO
216         ---help---
217           This device-mapper target allows you to create a device that
218           transparently encrypts the data on it. You'll need to activate
219           the ciphers you're going to use in the cryptoapi configuration.
220
221           Information on how to use dm-crypt can be found on
222
223           <http://www.saout.de/misc/dm-crypt/>
224
225           To compile this code as a module, choose M here: the module will
226           be called dm-crypt.
227
228           If unsure, say N.
229
230 config DM_SNAPSHOT
231        tristate "Snapshot target (EXPERIMENTAL)"
232        depends on BLK_DEV_DM && EXPERIMENTAL
233        ---help---
234          Allow volume managers to take writable snapshots of a device.
235
236 config DM_MIRROR
237        tristate "Mirror target (EXPERIMENTAL)"
238        depends on BLK_DEV_DM && EXPERIMENTAL
239        ---help---
240          Allow volume managers to mirror logical volumes, also
241          needed for live data migration tools such as 'pvmove'.
242
243 config DM_ZERO
244         tristate "Zero target (EXPERIMENTAL)"
245         depends on BLK_DEV_DM && EXPERIMENTAL
246         ---help---
247           A target that discards writes, and returns all zeroes for
248           reads.  Useful in some recovery situations.
249
250 config DM_MULTIPATH
251         tristate "Multipath target (EXPERIMENTAL)"
252         depends on BLK_DEV_DM && EXPERIMENTAL
253         ---help---
254           Allow volume managers to support multipath hardware.
255
256 config DM_MULTIPATH_EMC
257         tristate "EMC CX/AX multipath support (EXPERIMENTAL)"
258         depends on DM_MULTIPATH && BLK_DEV_DM && EXPERIMENTAL
259         ---help---
260           Multipath support for EMC CX/AX series hardware.
261
262 endmenu
263
264 endif