]>
git.ipfire.org Git - thirdparty/mdadm.git/blob - super1.c
2 * mdadm - manage Linux "md" devices aka RAID arrays.
4 * Copyright (C) 2001-2004 Neil Brown <neilb@cse.unsw.edu.au>
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 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 * Email: <neilb@cse.unsw.edu.au>
24 * School of Computer Science and Engineering
25 * The University of New South Wales
32 #include "asm/byteorder.h"
34 * The version-1 superblock :
35 * All numeric fields are little-endian.
37 * total size: 256 bytes plus 2 per device.
38 * 1K allows 384 devices.
40 struct mdp_superblock_1
{
41 /* constant array information - 128 bytes */
42 __u32 magic
; /* MD_SB_MAGIC: 0xa92b4efc - little endian */
43 __u32 major_version
; /* 1 */
44 __u32 feature_map
; /* 0 for now */
45 __u32 pad0
; /* always set to 0 when writing */
47 __u8 set_uuid
[16]; /* user-space generated. */
48 char set_name
[32]; /* set and interpreted by user-space */
50 __u64 ctime
; /* lo 40 bits are seconds, top 24 are microseconds or 0*/
51 __u32 level
; /* -4 (multipath), -1 (linear), 0,1,4,5 */
52 __u32 layout
; /* only for raid5 currently */
53 __u64 size
; /* used size of component devices, in 512byte sectors */
55 __u32 chunksize
; /* in 512byte sectors */
57 __u8 pad1
[128-96]; /* set to 0 when written */
59 /* constant this-device information - 64 bytes */
60 __u64 data_offset
; /* sector start of data, often 0 */
61 __u64 data_size
; /* sectors in this device that can be used for data */
62 __u64 super_offset
; /* sector start of this superblock */
63 __u64 recovery_offset
;/* sectors before this offset (from data_offset) have been recovered */
64 __u32 dev_number
; /* permanent identifier of this device - not role in raid */
65 __u32 cnt_corrected_read
; /* number of read errors that were corrected by re-writing */
66 __u8 device_uuid
[16]; /* user-space setable, ignored by kernel */
67 __u8 pad2
[64-56]; /* set to 0 when writing */
69 /* array state information - 64 bytes */
70 __u64 utime
; /* 40 bits second, 24 btes microseconds */
71 __u64 events
; /* incremented when superblock updated */
72 __u64 resync_offset
; /* data before this offset (from data_offset) known to be in sync */
73 __u32 sb_csum
; /* checksum upto devs[max_dev] */
74 __u32 max_dev
; /* size of devs[] array to consider */
75 __u8 pad3
[64-32]; /* set to 0 when writing */
77 /* device state information. Indexed by dev_number.
79 * Note there are no per-device state flags. State information is rolled
80 * into the 'roles' value. If a device is spare or faulty, then it doesn't
81 * have a meaningful role.
83 __u16 dev_roles
[0]; /* role in array, or 0xffff for a spare, or 0xfffe for faulty */
86 #define offsetof(t,f) ((int)&(((t*)0)->f))
87 static unsigned int calc_sb_1_csum(struct mdp_superblock_1
* sb
)
89 unsigned int disk_csum
, csum
;
90 unsigned long long newcsum
;
91 int size
= sizeof(*sb
) + __le32_to_cpu(sb
->max_dev
)*2;
92 unsigned int *isuper
= (unsigned int*)sb
;
95 /* make sure I can count... */
96 if (offsetof(struct mdp_superblock_1
,data_offset
) != 128 ||
97 offsetof(struct mdp_superblock_1
, utime
) != 192 ||
98 sizeof(struct mdp_superblock_1
) != 256) {
99 fprintf(stderr
, "WARNING - superblock isn't sized correctly\n");
102 disk_csum
= sb
->sb_csum
;
105 for (i
=0; size
>=4; size
-= 4 )
106 newcsum
+= __le32_to_cpu(*isuper
++);
109 newcsum
+= __le16_to_cpu(*(unsigned short*) isuper
);
111 csum
= (newcsum
& 0xffffffff) + (newcsum
>> 32);
112 sb
->sb_csum
= disk_csum
;
117 static void examine_super1(void *sbv
)
119 struct mdp_superblock_1
*sb
= sbv
;
126 printf(" Magic : %08x\n", __le32_to_cpu(sb
->magic
));
127 printf(" Version : %02d.%02d\n", 1, __le32_to_cpu(sb
->feature_map
));
128 printf(" Array UUID : ");
129 for (i
=0; i
<16; i
++) {
130 printf("%02x", sb
->set_uuid
[i
]);
131 if ((i
&3)==0 && i
!= 0) printf(":");
134 printf(" Name : %.32s\n", sb
->set_name
);
136 atime
= __le64_to_cpu(sb
->ctime
) & 0xFFFFFFFFFFULL
;
137 printf(" Creation Time : %.24s\n", ctime(&atime
));
138 c
=map_num(pers
, __le32_to_cpu(sb
->level
));
139 printf(" Raid Level : %s\n", c
?c
:"-unknown-");
140 printf(" Raid Devices : %d\n", __le32_to_cpu(sb
->raid_disks
));
142 printf(" Device Size : %llu%s\n", sb
->data_size
, human_size(sb
->data_size
<<9));
144 printf(" Data Offset : %llu sectors\n", __le64_to_cpu(sb
->data_offset
));
145 if (sb
->super_offset
)
146 printf(" Super Offset : %llu sectors\n", __le64_to_cpu(sb
->super_offset
));
147 printf(" Device UUID : ");
148 for (i
=0; i
<16; i
++) {
149 printf("%02x", sb
->set_uuid
[i
]);
150 if ((i
&3)==0 && i
!= 0) printf(":");
154 atime
= __le64_to_cpu(sb
->utime
) & 0xFFFFFFFFFFULL
;
155 printf(" Update Time : %.24s\n", ctime(&atime
));
157 if (calc_sb_1_csum(sb
) == sb
->sb_csum
)
158 printf(" Checksum : %x - correct\n", __le32_to_cpu(sb
->sb_csum
));
160 printf(" Checksum : %x - expected %x\n", __le32_to_cpu(sb
->sb_csum
),
161 __le32_to_cpu(calc_sb_1_csum(sb
)));
162 printf(" Events : %llu\n", __le64_to_cpu(sb
->events
));
164 if (__le32_to_cpu(sb
->level
) == 5) {
165 c
= map_num(r5layout
, __le32_to_cpu(sb
->layout
));
166 printf(" Layout : %s\n", c
?c
:"-unknown-");
168 switch(__le32_to_cpu(sb
->level
)) {
172 printf(" Chunk Size : %dK\n", __le32_to_cpu(sb
->chunksize
/2));
175 printf(" Rounding : %dK\n", __le32_to_cpu(sb
->chunksize
/2));
180 printf(" Array State : ");
181 for (d
=0; d
<__le32_to_cpu(sb
->raid_disks
); d
++) {
185 for (i
=0; i
< __le32_to_cpu(sb
->max_dev
); i
++) {
186 int role
= __le16_to_cpu(sb
->dev_roles
[i
]);
188 if (i
== __le32_to_cpu(sb
->dev_number
))
193 if (cnt
> 1) printf("?");
194 else if (cnt
== 1 && me
) printf("U");
195 else if (cnt
== 1) printf("u");
199 for (i
=0; i
< __le32_to_cpu(sb
->max_dev
); i
++) {
200 int role
= __le16_to_cpu(sb
->dev_roles
[i
]);
202 case 0xFFFF: spares
++; break;
203 case 0xFFFE: faulty
++;
206 if (spares
) printf(" %d spares", spares
);
207 if (faulty
) printf(" %d failed", faulty
);
212 static void brief_examine_super1(void *sbv
)
214 struct mdp_superblock_1
*sb
= sbv
;
217 char *c
=map_num(pers
, __le32_to_cpu(sb
->level
));
219 printf("ARRAY /dev/?? level=%s metadata=1 num-devices=%d UUID=",
220 c
?c
:"-unknown-", sb
->raid_disks
);
221 for (i
=0; i
<16; i
++) {
222 printf("%02x", sb
->set_uuid
[i
]);
223 if ((i
&3)==0 && i
!= 0) printf(":");
228 static void detail_super1(void *sbv
)
230 struct mdp_superblock_1
*sb
= sbv
;
234 for (i
=0; i
<16; i
++) {
235 printf("%02x", sb
->set_uuid
[i
]);
236 if ((i
&3)==0 && i
!= 0) printf(":");
238 printf("\n Events : %llu\n\n", __le64_to_cpu(sb
->events
));
241 static void brief_detail_super1(void *sbv
)
243 struct mdp_superblock_1
*sb
= sbv
;
247 for (i
=0; i
<16; i
++) {
248 printf("%02x", sb
->set_uuid
[i
]);
249 if ((i
&3)==0 && i
!= 0) printf(":");
253 static void uuid_from_super1(int uuid
[4], void * sbv
)
255 struct mdp_superblock_1
*super
= sbv
;
256 char *cuuid
= (char*)uuid
;
259 cuuid
[i
] = super
->set_uuid
[i
];
262 static void getinfo_super1(struct mdinfo
*info
, void *sbv
)
264 struct mdp_superblock_1
*sb
= sbv
;
269 info
->array
.major_version
= 1;
270 info
->array
.minor_version
= __le32_to_cpu(sb
->feature_map
);
271 info
->array
.patch_version
= 0;
272 info
->array
.raid_disks
= __le32_to_cpu(sb
->raid_disks
);
273 info
->array
.level
= __le32_to_cpu(sb
->level
);
274 info
->array
.md_minor
= -1;
275 info
->array
.ctime
= __le64_to_cpu(sb
->ctime
);
277 info
->disk
.major
= 0;
278 info
->disk
.minor
= 0;
280 if (__le32_to_cpu(sb
->dev_number
) >= __le32_to_cpu(sb
->max_dev
) ||
281 __le32_to_cpu(sb
->max_dev
) > 512)
284 role
= __le16_to_cpu(sb
->dev_roles
[__le32_to_cpu(sb
->dev_number
)]);
286 info
->disk
.raid_disk
= -1;
289 info
->disk
.state
= 2; /* spare: ACTIVE, not sync, not faulty */
292 info
->disk
.state
= 1; /* faulty */
295 info
->disk
.state
= 6; /* active and in sync */
296 info
->disk
.raid_disk
= role
;
298 info
->events
= __le64_to_cpu(sb
->events
);
300 memcpy(info
->uuid
, sb
->set_uuid
, 16);
302 for (i
=0; i
< __le32_to_cpu(sb
->max_dev
); i
++) {
303 role
= __le16_to_cpu(sb
->dev_roles
[i
]);
304 if (role
== 0xFFFF || role
< info
->array
.raid_disks
)
308 info
->array
.working_disks
= working
;
311 static int update_super1(struct mdinfo
*info
, void *sbv
, char *update
, char *devname
, int verbose
)
314 struct mdp_superblock_1
*sb
= sbv
;
316 if (strcmp(update
, "force")==0) {
317 sb
->events
= __cpu_to_le32(info
->events
);
318 switch(__le32_to_cpu(sb
->level
)) {
319 case 5: case 4: case 6:
320 /* need to force clean */
321 sb
->resync_offset
= ~0ULL;
324 if (strcmp(update
, "assemble")==0) {
325 int d
= info
->disk
.number
;
327 if (info
->disk
.state
== 6)
328 want
= __cpu_to_le32(info
->disk
.raid_disk
);
331 if (sb
->dev_roles
[d
] != want
) {
332 sb
->dev_roles
[d
] = want
;
337 if (strcmp(update
, "newdev") == 0) {
338 int d
= info
->disk
.number
;
339 memset(&sb
->disks
[d
], 0, sizeof(sb
->disks
[d
]));
340 sb
->disks
[d
].number
= d
;
341 sb
->disks
[d
].major
= info
->disk
.major
;
342 sb
->disks
[d
].minor
= info
->disk
.minor
;
343 sb
->disks
[d
].raid_disk
= info
->disk
.raid_disk
;
344 sb
->disks
[d
].state
= info
->disk
.state
;
345 sb
->this_disk
= sb
->disks
[d
];
348 if (strcmp(update
, "grow") == 0) {
349 sb
->raid_disks
= __cpu_to_le32(info
->array
.raid_disks
);
352 if (strcmp(update
, "resync") == 0) {
353 /* make sure resync happens */
354 sb
->resync_offset
= ~0ULL;
357 sb
->sb_csum
= calc_sb_1_csum(sb
);
362 static __u64
event_super1(void *sbv
)
364 struct mdp_superblock_1
*sb
= sbv
;
365 return __le64_to_cpu(sb
->events
);
368 static int init_super1(void **sbp
, mdu_array_info_t
*info
)
370 struct mdp_superblock_1
*sb
= malloc(1024);
374 if (info
->major_version
== -1)
375 /* zeroing superblock */
378 spares
= info
->working_disks
- info
->active_disks
;
379 if (info
->raid_disks
+ spares
> 384) {
380 fprintf(stderr
, Name
": too many devices requested: %d+%d > %d\n",
381 info
->raid_disks
, spares
, 384);
386 sb
->magic
= __cpu_to_le32(MD_SB_MAGIC
);
387 sb
->major_version
= __cpu_to_le32(1);
390 *(__u32
*)(sb
->set_uuid
) = random();
391 *(__u32
*)(sb
->set_uuid
+4) = random();
392 *(__u32
*)(sb
->set_uuid
+8) = random();
393 *(__u32
*)(sb
->set_uuid
+12) = random();
397 sb
->ctime
= __cpu_to_le64((unsigned long long)time(0));
398 sb
->level
= __cpu_to_le32(info
->level
);
399 sb
->layout
= __cpu_to_le32(info
->level
);
400 sb
->size
= __cpu_to_le64(info
->size
*2ULL);
401 sb
->chunksize
= __cpu_to_le32(info
->chunk_size
>>9);
402 sb
->raid_disks
= __cpu_to_le32(info
->raid_disks
);
404 sb
->data_offset
= __cpu_to_le64(0);
405 sb
->data_size
= __cpu_to_le64(0);
406 sb
->super_offset
= __cpu_to_le64(0);
407 sb
->recovery_offset
= __cpu_to_le64(0);
409 sb
->utime
= sb
->ctime
;
410 sb
->events
= __cpu_to_le64(1);
411 if (info
->state
& MD_SB_CLEAN
)
412 sb
->resync_offset
= ~0ULL;
414 sb
->resync_offset
= 0;
415 sb
->max_dev
= __cpu_to_le32((1024- sizeof(struct mdp_superblock_1
))/
416 sizeof(sb
->dev_roles
[0]));
417 memset(sb
->pad3
, 0, sizeof(sb
->pad3
));
419 memset(sb
->dev_roles
, 0xff, 1024 - sizeof(struct mdp_superblock_1
));
425 /* Add a device to the superblock being created */
426 static void add_to_super1(void *sbv
, mdu_disk_info_t
*dk
)
428 struct mdp_superblock_1
*sb
= sbv
;
429 __u16
*rp
= sb
->dev_roles
+ dk
->number
;
430 if (dk
->state
== 6) /* active, sync */
431 *rp
= __cpu_to_le16(dk
->raid_disk
);
432 else if (dk
->state
== 2) /* active -> spare */
438 static int store_super1(int fd
, void *sbv
)
440 struct mdp_superblock_1
*sb
= sbv
;
445 sb_offset
= __le64_to_cpu(sb
->super_offset
) << 9;
447 if (lseek64(fd
, sb_offset
, 0)< 0LL)
450 sbsize
= sizeof(*sb
) + 2 * __le32_to_cpu(sb
->max_dev
);
452 if (write(fd
, sb
, sbsize
) != sbsize
)
458 static int write_init_super1(struct supertype
*st
, void *sbv
, mdu_disk_info_t
*dinfo
, char *devname
)
460 struct mdp_superblock_1
*sb
= sbv
;
461 int fd
= open(devname
, O_RDWR
, O_EXCL
);
469 fprintf(stderr
, Name
": Failed to open %s to write superblock\n",
474 sb
->dev_number
= __cpu_to_le32(dinfo
->number
);
475 *(__u32
*)(sb
->device_uuid
) = random();
476 *(__u32
*)(sb
->device_uuid
+4) = random();
477 *(__u32
*)(sb
->device_uuid
+8) = random();
478 *(__u32
*)(sb
->device_uuid
+12) = random();
481 if (ioctl(fd
, BLKGETSIZE
, &size
))
489 * Calculate the position of the superblock.
490 * It is always aligned to a 4K boundary and
491 * depending on minor_version, it can be:
492 * 0: At least 8K, but less than 12K, from end of device
493 * 1: At start of device
494 * 2: 4K from start of device.
496 switch(st
->minor_version
) {
500 sb_offset
&= ~(4*2-1);
501 sb
->super_offset
= __cpu_to_le64(sb_offset
);
502 sb
->data_offset
= __cpu_to_le64(0);
503 sb
->data_size
= sb
->super_offset
;
506 sb
->super_offset
= __cpu_to_le64(0);
507 sb
->data_offset
= __cpu_to_le64(2);
508 sb
->data_size
= __cpu_to_le64(size
- 2);
512 sb
->super_offset
= __cpu_to_le64(sb_offset
);
513 sb
->data_offset
= __cpu_to_le64(sb_offset
+2);
514 sb
->data_size
= __cpu_to_le64(size
- 4*2 - 2);
521 sb
->sb_csum
= calc_sb_1_csum(sb
);
522 rv
= store_super1(fd
, sb
);
524 fprintf(stderr
, Name
": failed to write superblock to %s\n", devname
);
528 static int compare_super1(void **firstp
, void *secondv
)
532 * 0 same, or first was empty, and second was copied
533 * 1 second had wrong number
537 struct mdp_superblock_1
*first
= *firstp
;
538 struct mdp_superblock_1
*second
= secondv
;
540 if (second
->magic
!= __cpu_to_le32(MD_SB_MAGIC
))
542 if (second
->major_version
!= __cpu_to_le32(1))
546 first
= malloc(1024);
547 memcpy(first
, second
, 1024);
551 if (memcmp(first
->set_uuid
, second
->set_uuid
, 16)!= 0)
554 if (first
->ctime
!= second
->ctime
||
555 first
->level
!= second
->level
||
556 first
->layout
!= second
->layout
||
557 first
->size
!= second
->size
||
558 first
->chunksize
!= second
->chunksize
||
559 first
->raid_disks
!= second
->raid_disks
)
564 static int load_super1(struct supertype
*st
, int fd
, void **sbp
, char *devname
)
567 unsigned long long sb_offset
;
568 struct mdp_superblock_1
*super
;
572 if (st
->ss
== NULL
) {
575 for (st
->minor_version
= 0; st
->minor_version
<= 2 ; st
->minor_version
++) {
576 switch(load_super1(st
, fd
, sbp
, devname
)) {
577 case 0: return 0; /* good */
578 case 1: st
->ss
= NULL
; return 1; /*bad device */
579 case 2: break; /* bad, try next */
585 if (ioctl(fd
, BLKGETSIZE
, &size
)) {
587 fprintf(stderr
, Name
": cannot find device size for %s: %s\n",
588 devname
, strerror(errno
));
594 fprintf(stderr
, Name
": %s is too small for md: size is %lu sectors.\n",
600 * Calculate the position of the superblock.
601 * It is always aligned to a 4K boundary and
602 * depeding on minor_version, it can be:
603 * 0: At least 8K, but less than 12K, from end of device
604 * 1: At start of device
605 * 2: 4K from start of device.
607 switch(st
->minor_version
) {
611 sb_offset
&= ~(4*2-1);
623 ioctl(fd
, BLKFLSBUF
, 0); /* make sure we read current data */
626 if (lseek64(fd
, sb_offset
<< 9, 0)< 0LL) {
628 fprintf(stderr
, Name
": Cannot seek to superblock on %s: %s\n",
629 devname
, strerror(errno
));
633 super
= malloc(1024);
635 if (read(fd
, super
, 1024) != 1024) {
637 fprintf(stderr
, Name
": Cannot read superblock on %s\n",
643 if (__le32_to_cpu(super
->magic
) != MD_SB_MAGIC
) {
645 fprintf(stderr
, Name
": No super block found on %s (Expected magic %08x, got %08x)\n",
646 devname
, MD_SB_MAGIC
, __le32_to_cpu(super
->magic
));
651 if (__le32_to_cpu(super
->major_version
) != 1) {
653 fprintf(stderr
, Name
": Cannot interpret superblock on %s - version is %d\n",
654 devname
, __le32_to_cpu(super
->major_version
));
658 if (__le64_to_cpu(super
->super_offset
) != sb_offset
) {
660 fprintf(stderr
, Name
": No superblock found on %s (super_offset is wrong)\n",
670 static struct supertype
*match_metadata_desc1(char *arg
)
672 struct supertype
*st
= malloc(sizeof(*st
));
676 if (strcmp(arg
, "1") == 0 ||
677 strcmp(arg
, "1.0") == 0) {
678 st
->minor_version
= 0;
681 if (strcmp(arg
, "1.1") == 0) {
682 st
->minor_version
= 1;
685 if (strcmp(arg
, "1.2") == 0) {
686 st
->minor_version
= 2;
694 static __u64
avail_size1(__u64 devsize
)
699 return (devsize
- 8*2 ) & ~(4*2-1);
702 struct superswitch super1
= {
703 .examine_super
= examine_super1
,
704 .brief_examine_super
= brief_examine_super1
,
705 .detail_super
= detail_super1
,
706 .brief_detail_super
= brief_detail_super1
,
707 .uuid_from_super
= uuid_from_super1
,
708 .getinfo_super
= getinfo_super1
,
709 .update_super
= update_super1
,
710 .event_super
= event_super1
,
711 .init_super
= init_super1
,
712 .add_to_super
= add_to_super1
,
713 .store_super
= store_super1
,
714 .write_init_super
= write_init_super1
,
715 .compare_super
= compare_super1
,
716 .load_super
= load_super1
,
717 .match_metadata_desc
= match_metadata_desc1
,
718 .avail_size
= avail_size1
,