2 md.h : Multiple Devices driver for Linux
3 Copyright (C) 1994-96 Marc ZYNGIER
4 <zyngier@ufr-info-p7.ibp.fr> or
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 You should have received a copy of the GNU General Public License
13 (for example /usr/src/linux/COPYING); if not, write to the Free
14 Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 /* don't include the kernel RAID header! */
23 typedef unsigned int md_u32;
24 typedef unsigned short md_u16;
25 typedef unsigned char md_u8;
27 /*#include <linux/major.h>*/
28 #include <sys/ioctl.h>
30 #define MD_MAJOR MAJOR_MD
33 * Different major versions are not compatible.
34 * Different minor versions are only downward compatible.
35 * Different patchlevel versions are downward and upward compatible.
47 #define MD_READAHEAD (256 * 1024)
49 /* These are the ioctls for md versions < 0.50 */
50 #define REGISTER_MD_DEV _IO (MD_MAJOR, 1)
51 #define START_MD _IO (MD_MAJOR, 2)
52 #define STOP_MD _IO (MD_MAJOR, 3)
55 #define RAID_VERSION _IOR (MD_MAJOR, 0x10, struct md_version)
56 #define GET_ARRAY_INFO _IOR (MD_MAJOR, 0x11, md_array_info_t)
57 #define GET_DISK_INFO _IOR (MD_MAJOR, 0x12, md_disk_info_t)
58 #define PRINT_RAID_DEBUG _IO (MD_MAJOR, 0x13)
61 #define CLEAR_ARRAY _IO (MD_MAJOR, 0x20)
62 #define ADD_NEW_DISK _IOW (MD_MAJOR, 0x21, md_disk_info_t)
63 #define HOT_REMOVE_DISK _IO (MD_MAJOR, 0x22)
64 #define SET_ARRAY_INFO _IOW (MD_MAJOR, 0x23, md_array_info_t)
65 #define SET_DISK_INFO _IO (MD_MAJOR, 0x24)
66 #define WRITE_RAID_INFO _IO (MD_MAJOR, 0x25)
67 #define UNPROTECT_ARRAY _IO (MD_MAJOR, 0x26)
68 #define PROTECT_ARRAY _IO (MD_MAJOR, 0x27)
69 #define HOT_ADD_DISK _IO (MD_MAJOR, 0x28)
72 #define RUN_ARRAY _IOW (MD_MAJOR, 0x30, struct md_param)
73 #define START_ARRAY _IO (MD_MAJOR, 0x31)
74 #define STOP_ARRAY _IO (MD_MAJOR, 0x32)
75 #define STOP_ARRAY_RO _IO (MD_MAJOR, 0x33)
76 #define RESTART_ARRAY_RW _IO (MD_MAJOR, 0x34)
79 /* for raid < 0.50 only */
80 #define MD_PERSONALITY_SHIFT 16
82 #define MD_RESERVED 0UL
88 #define TRANSLUCENT 5UL
90 #define MAX_PERSONALITY 7UL
95 * The MD superblock maintains some statistics on each MD configuration.
96 * Each real device in the MD set contains it near the end of the device.
97 * Some of the ideas are copied from the ext2fs implementation.
99 * We currently use 4096 bytes as follows:
101 * word offset function
103 * 0 - 31 Constant generic MD device information.
104 * 32 - 63 Generic state information.
105 * 64 - 127 Personality specific information.
106 * 128 - 511 12 32-words descriptors of the disks in the raid set.
107 * 512 - 911 Reserved.
108 * 912 - 1023 Disk specific descriptor.
112 * If x is the real device size in bytes, we return an apparent size of:
114 * y = (x & ~(MD_RESERVED_BYTES - 1)) - MD_RESERVED_BYTES
116 * and place the 4kB superblock at offset y.
118 #define MD_RESERVED_BYTES (64 * 1024)
119 #define MD_RESERVED_SECTORS (MD_RESERVED_BYTES / 512)
120 #define MD_RESERVED_BLOCKS (MD_RESERVED_BYTES / BLOCK_SIZE)
122 #define MD_NEW_SIZE_SECTORS(x) ((x & ~(MD_RESERVED_SECTORS - 1)) - MD_RESERVED_SECTORS)
123 #define MD_NEW_SIZE_BLOCKS(x) ((x & ~(MD_RESERVED_BLOCKS - 1)) - MD_RESERVED_BLOCKS)
125 #define MD_SB_BYTES 4096
126 #define MD_SB_WORDS (MD_SB_BYTES / 4)
127 #define MD_SB_BLOCKS (MD_SB_BYTES / BLOCK_SIZE)
128 #define MD_SB_SECTORS (MD_SB_BYTES / 512)
131 * The following are counted in 32-bit words
133 #define MD_SB_GENERIC_OFFSET 0
134 #define MD_SB_PERSONALITY_OFFSET 64
135 #define MD_SB_DISKS_OFFSET 128
136 #define MD_SB_DESCRIPTOR_OFFSET 992
138 #define MD_SB_GENERIC_CONSTANT_WORDS 32
139 #define MD_SB_GENERIC_STATE_WORDS 32
140 #define MD_SB_GENERIC_WORDS (MD_SB_GENERIC_CONSTANT_WORDS + MD_SB_GENERIC_STATE_WORDS)
141 #define MD_SB_PERSONALITY_WORDS 64
142 #define MD_SB_DISKS_WORDS 384
143 #define MD_SB_DESCRIPTOR_WORDS 32
144 #define MD_SB_RESERVED_WORDS (1024 - MD_SB_GENERIC_WORDS - MD_SB_PERSONALITY_WORDS - MD_SB_DISKS_WORDS - MD_SB_DESCRIPTOR_WORDS)
145 #define MD_SB_EQUAL_WORDS (MD_SB_GENERIC_WORDS + MD_SB_PERSONALITY_WORDS + MD_SB_DISKS_WORDS)
146 #define MD_SB_DISKS (MD_SB_DISKS_WORDS / MD_SB_DESCRIPTOR_WORDS)
149 * Device "operational" state bits
151 #define MD_DISK_FAULTY 0 /* disk is faulty / operational */
152 #define MD_DISK_ACTIVE 1 /* disk is running or spare disk */
153 #define MD_DISK_SYNC 2 /* disk is in sync with the raid set */
155 typedef struct md_device_descriptor_s {
156 md_u32 number; /* 0 Device number in the entire set */
157 md_u32 major; /* 1 Device major number */
158 md_u32 minor; /* 2 Device minor number */
159 md_u32 raid_disk; /* 3 The role of the device in the raid set */
160 md_u32 state; /* 4 Operational state */
161 md_u32 reserved[MD_SB_DESCRIPTOR_WORDS - 5];
164 #define MD_SB_MAGIC 0xa92b4efc
167 * Superblock state bits
169 #define MD_SB_CLEAN 0
170 #define MD_SB_ERRORS 1
172 typedef struct md_superblock_s {
174 * Constant generic information
176 md_u32 md_magic; /* 0 MD identifier */
177 md_u32 major_version; /* 1 major version to which the set conforms */
178 md_u32 minor_version; /* 2 minor version ... */
179 md_u32 patch_version; /* 3 patchlevel version ... */
180 md_u32 gvalid_words; /* 4 Number of used words in this section */
181 md_u32 set_magic; /* 5 Raid set identifier */
182 md_u32 ctime; /* 6 Creation time */
183 md_u32 level; /* 7 Raid personality */
184 md_u32 size; /* 8 Apparent size of each individual disk */
185 md_u32 nr_disks; /* 9 total disks in the raid set */
186 md_u32 raid_disks; /* 10 disks in a fully functional raid set */
187 md_u32 md_minor; /* 11 preferred MD minor device number */
188 md_u32 gstate_creserved[MD_SB_GENERIC_CONSTANT_WORDS - 12];
191 * Generic state information
193 md_u32 utime; /* 0 Superblock update time */
194 md_u32 state; /* 1 State bits (clean, ...) */
195 md_u32 active_disks; /* 2 Number of currently active disks */
196 md_u32 working_disks; /* 3 Number of working disks */
197 md_u32 failed_disks; /* 4 Number of failed disks */
198 md_u32 spare_disks; /* 5 Number of spare disks */
199 md_u32 gstate_sreserved[MD_SB_GENERIC_STATE_WORDS - 6];
202 * Personality information
204 md_u32 layout; /* 0 the array's physical layout */
205 md_u32 chunk_size; /* 1 chunk size in bytes */
206 md_u32 pstate_reserved[MD_SB_PERSONALITY_WORDS - 2];
211 md_descriptor_t disks[MD_SB_DISKS];
216 md_u32 reserved[MD_SB_RESERVED_WORDS];
221 md_descriptor_t descriptor;
226 * options passed in raidstart:
229 #define MAX_CHUNK_SIZE (4096*1024)
233 int personality; /* 1,2,3,4 */
234 int chunk_size; /* in bytes */
235 int max_fault; /* unused for now */
238 typedef struct md_array_info_s {
240 * Generic constant information
242 md_u32 major_version;
243 md_u32 minor_version;
244 md_u32 patch_version;
251 md_u32 not_persistent;
254 * Generic state information
256 md_u32 utime; /* 0 Superblock update time */
257 md_u32 state; /* 1 State bits (clean, ...) */
258 md_u32 active_disks; /* 2 Number of currently active disks */
259 md_u32 working_disks; /* 3 Number of working disks */
260 md_u32 failed_disks; /* 4 Number of failed disks */
261 md_u32 spare_disks; /* 5 Number of spare disks */
264 * Personality information
266 md_u32 layout; /* 0 the array's physical layout */
267 md_u32 chunk_size; /* 1 chunk size in bytes */
271 typedef struct md_disk_info_s {
273 * configuration/status of one particular disk
285 * Supported RAID5 algorithms
287 #define RAID5_ALGORITHM_LEFT_ASYMMETRIC 0
288 #define RAID5_ALGORITHM_RIGHT_ASYMMETRIC 1
289 #define RAID5_ALGORITHM_LEFT_SYMMETRIC 2
290 #define RAID5_ALGORITHM_RIGHT_SYMMETRIC 3