]>
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 */
87 #define offsetof(t,f) ((int)&(((t*)0)->f))
89 static unsigned int calc_sb_1_csum(struct mdp_superblock_1
* sb
)
91 unsigned int disk_csum
, csum
;
92 unsigned long long newcsum
;
93 int size
= sizeof(*sb
) + __le32_to_cpu(sb
->max_dev
)*2;
94 unsigned int *isuper
= (unsigned int*)sb
;
97 /* make sure I can count... */
98 if (offsetof(struct mdp_superblock_1
,data_offset
) != 128 ||
99 offsetof(struct mdp_superblock_1
, utime
) != 192 ||
100 sizeof(struct mdp_superblock_1
) != 256) {
101 fprintf(stderr
, "WARNING - superblock isn't sized correctly\n");
104 disk_csum
= sb
->sb_csum
;
107 for (i
=0; size
>=4; size
-= 4 )
108 newcsum
+= __le32_to_cpu(*isuper
++);
111 newcsum
+= __le16_to_cpu(*(unsigned short*) isuper
);
113 csum
= (newcsum
& 0xffffffff) + (newcsum
>> 32);
114 sb
->sb_csum
= disk_csum
;
119 static void examine_super1(void *sbv
)
121 struct mdp_superblock_1
*sb
= sbv
;
128 printf(" Magic : %08x\n", __le32_to_cpu(sb
->magic
));
129 printf(" Version : %02d.%02d\n", 1, __le32_to_cpu(sb
->feature_map
));
130 printf(" Array UUID : ");
131 for (i
=0; i
<16; i
++) {
132 printf("%02x", sb
->set_uuid
[i
]);
133 if ((i
&3)==0 && i
!= 0) printf(":");
136 printf(" Name : %.32s\n", sb
->set_name
);
138 atime
= __le64_to_cpu(sb
->ctime
) & 0xFFFFFFFFFFULL
;
139 printf(" Creation Time : %.24s\n", ctime(&atime
));
140 c
=map_num(pers
, __le32_to_cpu(sb
->level
));
141 printf(" Raid Level : %s\n", c
?c
:"-unknown-");
142 printf(" Raid Devices : %d\n", __le32_to_cpu(sb
->raid_disks
));
144 printf(" Device Size : %llu%s\n", (unsigned long long)sb
->data_size
, human_size(sb
->data_size
<<9));
146 printf(" Data Offset : %llu sectors\n", (unsigned long long)__le64_to_cpu(sb
->data_offset
));
147 if (sb
->super_offset
)
148 printf(" Super Offset : %llu sectors\n", (unsigned long long)__le64_to_cpu(sb
->super_offset
));
149 printf(" State : %s\n", (__le64_to_cpu(sb
->resync_offset
)+1)? "active":"clean");
150 printf(" Device UUID : ");
151 for (i
=0; i
<16; i
++) {
152 printf("%02x", sb
->set_uuid
[i
]);
153 if ((i
&3)==0 && i
!= 0) printf(":");
157 atime
= __le64_to_cpu(sb
->utime
) & 0xFFFFFFFFFFULL
;
158 printf(" Update Time : %.24s\n", ctime(&atime
));
160 if (calc_sb_1_csum(sb
) == sb
->sb_csum
)
161 printf(" Checksum : %x - correct\n", __le32_to_cpu(sb
->sb_csum
));
163 printf(" Checksum : %x - expected %x\n", __le32_to_cpu(sb
->sb_csum
),
164 __le32_to_cpu(calc_sb_1_csum(sb
)));
165 printf(" Events : %llu\n", (unsigned long long)__le64_to_cpu(sb
->events
));
167 if (__le32_to_cpu(sb
->level
) == 5) {
168 c
= map_num(r5layout
, __le32_to_cpu(sb
->layout
));
169 printf(" Layout : %s\n", c
?c
:"-unknown-");
171 switch(__le32_to_cpu(sb
->level
)) {
175 printf(" Chunk Size : %dK\n", __le32_to_cpu(sb
->chunksize
/2));
178 printf(" Rounding : %dK\n", __le32_to_cpu(sb
->chunksize
/2));
183 printf(" Array State : ");
184 for (d
=0; d
<__le32_to_cpu(sb
->raid_disks
); d
++) {
188 for (i
=0; i
< __le32_to_cpu(sb
->max_dev
); i
++) {
189 int role
= __le16_to_cpu(sb
->dev_roles
[i
]);
191 if (i
== __le32_to_cpu(sb
->dev_number
))
196 if (cnt
> 1) printf("?");
197 else if (cnt
== 1 && me
) printf("U");
198 else if (cnt
== 1) printf("u");
202 for (i
=0; i
< __le32_to_cpu(sb
->max_dev
); i
++) {
203 int role
= __le16_to_cpu(sb
->dev_roles
[i
]);
205 case 0xFFFF: spares
++; break;
206 case 0xFFFE: faulty
++;
209 if (spares
) printf(" %d spares", spares
);
210 if (faulty
) printf(" %d failed", faulty
);
215 static void brief_examine_super1(void *sbv
)
217 struct mdp_superblock_1
*sb
= sbv
;
220 char *c
=map_num(pers
, __le32_to_cpu(sb
->level
));
222 printf("ARRAY /dev/?? level=%s metadata=1 num-devices=%d UUID=",
223 c
?c
:"-unknown-", sb
->raid_disks
);
224 for (i
=0; i
<16; i
++) {
225 printf("%02x", sb
->set_uuid
[i
]);
226 if ((i
&3)==0 && i
!= 0) printf(":");
231 static void detail_super1(void *sbv
)
233 struct mdp_superblock_1
*sb
= sbv
;
237 for (i
=0; i
<16; i
++) {
238 printf("%02x", sb
->set_uuid
[i
]);
239 if ((i
&3)==0 && i
!= 0) printf(":");
241 printf("\n Events : %llu\n\n", (unsigned long long)__le64_to_cpu(sb
->events
));
244 static void brief_detail_super1(void *sbv
)
246 struct mdp_superblock_1
*sb
= sbv
;
250 for (i
=0; i
<16; i
++) {
251 printf("%02x", sb
->set_uuid
[i
]);
252 if ((i
&3)==0 && i
!= 0) printf(":");
256 static void uuid_from_super1(int uuid
[4], void * sbv
)
258 struct mdp_superblock_1
*super
= sbv
;
259 char *cuuid
= (char*)uuid
;
262 cuuid
[i
] = super
->set_uuid
[i
];
265 static void getinfo_super1(struct mdinfo
*info
, void *sbv
)
267 struct mdp_superblock_1
*sb
= sbv
;
272 info
->array
.major_version
= 1;
273 info
->array
.minor_version
= __le32_to_cpu(sb
->feature_map
);
274 info
->array
.patch_version
= 0;
275 info
->array
.raid_disks
= __le32_to_cpu(sb
->raid_disks
);
276 info
->array
.level
= __le32_to_cpu(sb
->level
);
277 info
->array
.md_minor
= -1;
278 info
->array
.ctime
= __le64_to_cpu(sb
->ctime
);
280 info
->disk
.major
= 0;
281 info
->disk
.minor
= 0;
283 if (__le32_to_cpu(sb
->dev_number
) >= __le32_to_cpu(sb
->max_dev
) ||
284 __le32_to_cpu(sb
->max_dev
) > 512)
287 role
= __le16_to_cpu(sb
->dev_roles
[__le32_to_cpu(sb
->dev_number
)]);
289 info
->disk
.raid_disk
= -1;
292 info
->disk
.state
= 2; /* spare: ACTIVE, not sync, not faulty */
295 info
->disk
.state
= 1; /* faulty */
298 info
->disk
.state
= 6; /* active and in sync */
299 info
->disk
.raid_disk
= role
;
301 info
->events
= __le64_to_cpu(sb
->events
);
303 memcpy(info
->uuid
, sb
->set_uuid
, 16);
305 for (i
=0; i
< __le32_to_cpu(sb
->max_dev
); i
++) {
306 role
= __le16_to_cpu(sb
->dev_roles
[i
]);
307 if (role
== 0xFFFF || role
< info
->array
.raid_disks
)
311 info
->array
.working_disks
= working
;
314 static int update_super1(struct mdinfo
*info
, void *sbv
, char *update
, char *devname
, int verbose
)
317 struct mdp_superblock_1
*sb
= sbv
;
319 if (strcmp(update
, "force")==0) {
320 sb
->events
= __cpu_to_le32(info
->events
);
321 switch(__le32_to_cpu(sb
->level
)) {
322 case 5: case 4: case 6:
323 /* need to force clean */
324 sb
->resync_offset
= ~0ULL;
327 if (strcmp(update
, "assemble")==0) {
328 int d
= info
->disk
.number
;
330 if (info
->disk
.state
== 6)
331 want
= __cpu_to_le32(info
->disk
.raid_disk
);
334 if (sb
->dev_roles
[d
] != want
) {
335 sb
->dev_roles
[d
] = want
;
340 if (strcmp(update
, "newdev") == 0) {
341 int d
= info
->disk
.number
;
342 memset(&sb
->disks
[d
], 0, sizeof(sb
->disks
[d
]));
343 sb
->disks
[d
].number
= d
;
344 sb
->disks
[d
].major
= info
->disk
.major
;
345 sb
->disks
[d
].minor
= info
->disk
.minor
;
346 sb
->disks
[d
].raid_disk
= info
->disk
.raid_disk
;
347 sb
->disks
[d
].state
= info
->disk
.state
;
348 sb
->this_disk
= sb
->disks
[d
];
351 if (strcmp(update
, "grow") == 0) {
352 sb
->raid_disks
= __cpu_to_le32(info
->array
.raid_disks
);
355 if (strcmp(update
, "resync") == 0) {
356 /* make sure resync happens */
357 sb
->resync_offset
= ~0ULL;
360 sb
->sb_csum
= calc_sb_1_csum(sb
);
365 static __u64
event_super1(void *sbv
)
367 struct mdp_superblock_1
*sb
= sbv
;
368 return __le64_to_cpu(sb
->events
);
371 static int init_super1(void **sbp
, mdu_array_info_t
*info
)
373 struct mdp_superblock_1
*sb
= malloc(1024);
377 if (info
->major_version
== -1)
378 /* zeroing superblock */
381 spares
= info
->working_disks
- info
->active_disks
;
382 if (info
->raid_disks
+ spares
> 384) {
383 fprintf(stderr
, Name
": too many devices requested: %d+%d > %d\n",
384 info
->raid_disks
, spares
, 384);
389 sb
->magic
= __cpu_to_le32(MD_SB_MAGIC
);
390 sb
->major_version
= __cpu_to_le32(1);
393 *(__u32
*)(sb
->set_uuid
) = random();
394 *(__u32
*)(sb
->set_uuid
+4) = random();
395 *(__u32
*)(sb
->set_uuid
+8) = random();
396 *(__u32
*)(sb
->set_uuid
+12) = random();
400 sb
->ctime
= __cpu_to_le64((unsigned long long)time(0));
401 sb
->level
= __cpu_to_le32(info
->level
);
402 sb
->layout
= __cpu_to_le32(info
->level
);
403 sb
->size
= __cpu_to_le64(info
->size
*2ULL);
404 sb
->chunksize
= __cpu_to_le32(info
->chunk_size
>>9);
405 sb
->raid_disks
= __cpu_to_le32(info
->raid_disks
);
407 sb
->data_offset
= __cpu_to_le64(0);
408 sb
->data_size
= __cpu_to_le64(0);
409 sb
->super_offset
= __cpu_to_le64(0);
410 sb
->recovery_offset
= __cpu_to_le64(0);
412 sb
->utime
= sb
->ctime
;
413 sb
->events
= __cpu_to_le64(1);
414 if (info
->state
& MD_SB_CLEAN
)
415 sb
->resync_offset
= ~0ULL;
417 sb
->resync_offset
= 0;
418 sb
->max_dev
= __cpu_to_le32((1024- sizeof(struct mdp_superblock_1
))/
419 sizeof(sb
->dev_roles
[0]));
420 memset(sb
->pad3
, 0, sizeof(sb
->pad3
));
422 memset(sb
->dev_roles
, 0xff, 1024 - sizeof(struct mdp_superblock_1
));
428 /* Add a device to the superblock being created */
429 static void add_to_super1(void *sbv
, mdu_disk_info_t
*dk
)
431 struct mdp_superblock_1
*sb
= sbv
;
432 __u16
*rp
= sb
->dev_roles
+ dk
->number
;
433 if (dk
->state
== 6) /* active, sync */
434 *rp
= __cpu_to_le16(dk
->raid_disk
);
435 else if (dk
->state
== 2) /* active -> spare */
441 static int store_super1(int fd
, void *sbv
)
443 struct mdp_superblock_1
*sb
= sbv
;
448 sb_offset
= __le64_to_cpu(sb
->super_offset
) << 9;
450 if (lseek64(fd
, sb_offset
, 0)< 0LL)
453 sbsize
= sizeof(*sb
) + 2 * __le32_to_cpu(sb
->max_dev
);
455 if (write(fd
, sb
, sbsize
) != sbsize
)
462 static int write_init_super1(struct supertype
*st
, void *sbv
, mdu_disk_info_t
*dinfo
, char *devname
)
464 struct mdp_superblock_1
*sb
= sbv
;
465 int fd
= open(devname
, O_RDWR
, O_EXCL
);
473 fprintf(stderr
, Name
": Failed to open %s to write superblock\n",
478 sb
->dev_number
= __cpu_to_le32(dinfo
->number
);
479 *(__u32
*)(sb
->device_uuid
) = random();
480 *(__u32
*)(sb
->device_uuid
+4) = random();
481 *(__u32
*)(sb
->device_uuid
+8) = random();
482 *(__u32
*)(sb
->device_uuid
+12) = random();
485 if (ioctl(fd
, BLKGETSIZE
, &size
)) {
497 * Calculate the position of the superblock.
498 * It is always aligned to a 4K boundary and
499 * depending on minor_version, it can be:
500 * 0: At least 8K, but less than 12K, from end of device
501 * 1: At start of device
502 * 2: 4K from start of device.
504 switch(st
->minor_version
) {
508 sb_offset
&= ~(4*2-1);
509 sb
->super_offset
= __cpu_to_le64(sb_offset
);
510 sb
->data_offset
= __cpu_to_le64(0);
511 sb
->data_size
= sb
->super_offset
;
514 sb
->super_offset
= __cpu_to_le64(0);
515 sb
->data_offset
= __cpu_to_le64(2);
516 sb
->data_size
= __cpu_to_le64(size
- 2);
520 sb
->super_offset
= __cpu_to_le64(sb_offset
);
521 sb
->data_offset
= __cpu_to_le64(sb_offset
+2);
522 sb
->data_size
= __cpu_to_le64(size
- 4*2 - 2);
529 sb
->sb_csum
= calc_sb_1_csum(sb
);
530 rv
= store_super1(fd
, sb
);
532 fprintf(stderr
, Name
": failed to write superblock to %s\n", devname
);
537 static int compare_super1(void **firstp
, void *secondv
)
541 * 0 same, or first was empty, and second was copied
542 * 1 second had wrong number
546 struct mdp_superblock_1
*first
= *firstp
;
547 struct mdp_superblock_1
*second
= secondv
;
549 if (second
->magic
!= __cpu_to_le32(MD_SB_MAGIC
))
551 if (second
->major_version
!= __cpu_to_le32(1))
555 first
= malloc(1024);
556 memcpy(first
, second
, 1024);
560 if (memcmp(first
->set_uuid
, second
->set_uuid
, 16)!= 0)
563 if (first
->ctime
!= second
->ctime
||
564 first
->level
!= second
->level
||
565 first
->layout
!= second
->layout
||
566 first
->size
!= second
->size
||
567 first
->chunksize
!= second
->chunksize
||
568 first
->raid_disks
!= second
->raid_disks
)
573 static int load_super1(struct supertype
*st
, int fd
, void **sbp
, char *devname
)
576 unsigned long long sb_offset
;
577 struct mdp_superblock_1
*super
;
581 if (st
->ss
== NULL
) {
584 /* guess... choose latest ctime */
586 for (st
->minor_version
= 0; st
->minor_version
<= 2 ; st
->minor_version
++) {
587 switch(load_super1(st
, fd
, sbp
, devname
)) {
588 case 0: super
= *sbp
;
589 if (bestvers
== -1 ||
590 bestctime
< __le64_to_cpu(super
->ctime
)) {
591 bestvers
= st
->minor_version
;
592 bestctime
= __le64_to_cpu(super
->ctime
);
597 case 1: st
->ss
= NULL
; return 1; /*bad device */
598 case 2: break; /* bad, try next */
601 if (bestvers
!= -1) {
603 st
->minor_version
= bestvers
;
605 rv
= load_super1(st
, fd
, sbp
, devname
);
606 if (rv
) st
->ss
= NULL
;
612 if (ioctl(fd
, BLKGETSIZE
, &size
)) {
614 fprintf(stderr
, Name
": cannot find device size for %s: %s\n",
615 devname
, strerror(errno
));
621 fprintf(stderr
, Name
": %s is too small for md: size is %lu sectors.\n",
627 * Calculate the position of the superblock.
628 * It is always aligned to a 4K boundary and
629 * depeding on minor_version, it can be:
630 * 0: At least 8K, but less than 12K, from end of device
631 * 1: At start of device
632 * 2: 4K from start of device.
634 switch(st
->minor_version
) {
638 sb_offset
&= ~(4*2-1);
650 ioctl(fd
, BLKFLSBUF
, 0); /* make sure we read current data */
653 if (lseek64(fd
, sb_offset
<< 9, 0)< 0LL) {
655 fprintf(stderr
, Name
": Cannot seek to superblock on %s: %s\n",
656 devname
, strerror(errno
));
660 super
= malloc(1024);
662 if (read(fd
, super
, 1024) != 1024) {
664 fprintf(stderr
, Name
": Cannot read superblock on %s\n",
670 if (__le32_to_cpu(super
->magic
) != MD_SB_MAGIC
) {
672 fprintf(stderr
, Name
": No super block found on %s (Expected magic %08x, got %08x)\n",
673 devname
, MD_SB_MAGIC
, __le32_to_cpu(super
->magic
));
678 if (__le32_to_cpu(super
->major_version
) != 1) {
680 fprintf(stderr
, Name
": Cannot interpret superblock on %s - version is %d\n",
681 devname
, __le32_to_cpu(super
->major_version
));
685 if (__le64_to_cpu(super
->super_offset
) != sb_offset
) {
687 fprintf(stderr
, Name
": No superblock found on %s (super_offset is wrong)\n",
697 static struct supertype
*match_metadata_desc1(char *arg
)
699 struct supertype
*st
= malloc(sizeof(*st
));
703 if (strcmp(arg
, "1") == 0 ||
704 strcmp(arg
, "1.0") == 0) {
705 st
->minor_version
= 0;
708 if (strcmp(arg
, "1.1") == 0) {
709 st
->minor_version
= 1;
712 if (strcmp(arg
, "1.2") == 0) {
713 st
->minor_version
= 2;
721 static __u64
avail_size1(__u64 devsize
)
726 return (devsize
- 8*2 ) & ~(4*2-1);
729 struct superswitch super1
= {
730 .examine_super
= examine_super1
,
731 .brief_examine_super
= brief_examine_super1
,
732 .detail_super
= detail_super1
,
733 .brief_detail_super
= brief_detail_super1
,
734 .uuid_from_super
= uuid_from_super1
,
735 .getinfo_super
= getinfo_super1
,
736 .update_super
= update_super1
,
737 .event_super
= event_super1
,
738 .init_super
= init_super1
,
739 .add_to_super
= add_to_super1
,
740 .store_super
= store_super1
,
741 .write_init_super
= write_init_super1
,
742 .compare_super
= compare_super1
,
743 .load_super
= load_super1
,
744 .match_metadata_desc
= match_metadata_desc1
,
745 .avail_size
= avail_size1
,