2 * mdadm - manage Linux "md" devices aka RAID arrays.
4 * Copyright (C) 2006-2009 Neil Brown <neilb@suse.de>
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: <neil@brown.name>
24 * Specifications for DDF takes from Common RAID DDF Specification Revision 1.2
25 * (July 28 2006). Reused by permission of SNIA.
28 #define HAVE_STDINT_H 1
34 /* a non-official T10 name for creation GUIDs */
35 static char T10
[] = "Linux-MD";
37 /* DDF timestamps are 1980 based, so we need to add
38 * second-in-decade-of-seventies to convert to linux timestamps.
39 * 10 years with 2 leap years.
41 #define DECADE (3600*24*(365*10+2))
44 const unsigned char *buf
,
47 /* The DDF metadata handling.
48 * DDF metadata lives at the end of the device.
49 * The last 512 byte block provides an 'anchor' which is used to locate
50 * the rest of the metadata which usually lives immediately behind the anchor.
53 * - all multibyte numeric fields are bigendian.
54 * - all strings are space padded.
58 /* Primary Raid Level (PRL) */
59 #define DDF_RAID0 0x00
60 #define DDF_RAID1 0x01
61 #define DDF_RAID3 0x03
62 #define DDF_RAID4 0x04
63 #define DDF_RAID5 0x05
64 #define DDF_RAID1E 0x11
66 #define DDF_CONCAT 0x1f
67 #define DDF_RAID5E 0x15
68 #define DDF_RAID5EE 0x25
69 #define DDF_RAID6 0x06
71 /* Raid Level Qualifier (RLQ) */
72 #define DDF_RAID0_SIMPLE 0x00
73 #define DDF_RAID1_SIMPLE 0x00 /* just 2 devices in this plex */
74 #define DDF_RAID1_MULTI 0x01 /* exactly 3 devices in this plex */
75 #define DDF_RAID3_0 0x00 /* parity in first extent */
76 #define DDF_RAID3_N 0x01 /* parity in last extent */
77 #define DDF_RAID4_0 0x00 /* parity in first extent */
78 #define DDF_RAID4_N 0x01 /* parity in last extent */
79 /* these apply to raid5e and raid5ee as well */
80 #define DDF_RAID5_0_RESTART 0x00 /* same as 'right asymmetric' - layout 1 */
81 #define DDF_RAID6_0_RESTART 0x01 /* raid6 different from raid5 here!!! */
82 #define DDF_RAID5_N_RESTART 0x02 /* same as 'left asymmetric' - layout 0 */
83 #define DDF_RAID5_N_CONTINUE 0x03 /* same as 'left symmetric' - layout 2 */
85 #define DDF_RAID1E_ADJACENT 0x00 /* raid10 nearcopies==2 */
86 #define DDF_RAID1E_OFFSET 0x01 /* raid10 offsetcopies==2 */
88 /* Secondary RAID Level (SRL) */
89 #define DDF_2STRIPED 0x00 /* This is weirder than RAID0 !! */
90 #define DDF_2MIRRORED 0x01
91 #define DDF_2CONCAT 0x02
92 #define DDF_2SPANNED 0x03 /* This is also weird - be careful */
95 #define DDF_HEADER_MAGIC __cpu_to_be32(0xDE11DE11)
96 #define DDF_CONTROLLER_MAGIC __cpu_to_be32(0xAD111111)
97 #define DDF_PHYS_RECORDS_MAGIC __cpu_to_be32(0x22222222)
98 #define DDF_PHYS_DATA_MAGIC __cpu_to_be32(0x33333333)
99 #define DDF_VIRT_RECORDS_MAGIC __cpu_to_be32(0xDDDDDDDD)
100 #define DDF_VD_CONF_MAGIC __cpu_to_be32(0xEEEEEEEE)
101 #define DDF_SPARE_ASSIGN_MAGIC __cpu_to_be32(0x55555555)
102 #define DDF_VU_CONF_MAGIC __cpu_to_be32(0x88888888)
103 #define DDF_VENDOR_LOG_MAGIC __cpu_to_be32(0x01dBEEF0)
104 #define DDF_BBM_LOG_MAGIC __cpu_to_be32(0xABADB10C)
106 #define DDF_GUID_LEN 24
107 #define DDF_REVISION_0 "01.00.00"
108 #define DDF_REVISION_2 "01.02.00"
111 __u32 magic
; /* DDF_HEADER_MAGIC */
113 char guid
[DDF_GUID_LEN
];
114 char revision
[8]; /* 01.02.00 */
115 __u32 seq
; /* starts at '1' */
120 __u8 pad0
; /* 0xff */
121 __u8 pad1
[12]; /* 12 * 0xff */
122 /* 64 bytes so far */
123 __u8 header_ext
[32]; /* reserved: fill with 0xff */
127 __u8 pad2
[3]; /* 0xff */
128 __u32 workspace_len
; /* sectors for vendor space -
129 * at least 32768(sectors) */
131 __u16 max_pd_entries
; /* one of 15, 63, 255, 1023, 4095 */
132 __u16 max_vd_entries
; /* 2^(4,6,8,10,12)-1 : i.e. as above */
133 __u16 max_partitions
; /* i.e. max num of configuration
134 record entries per disk */
135 __u16 config_record_len
; /* 1 +ROUNDUP(max_primary_element_entries
137 __u16 max_primary_element_entries
; /* 16, 64, 256, 1024, or 4096 */
138 __u8 pad3
[54]; /* 0xff */
139 /* 192 bytes so far */
140 __u32 controller_section_offset
;
141 __u32 controller_section_length
;
142 __u32 phys_section_offset
;
143 __u32 phys_section_length
;
144 __u32 virt_section_offset
;
145 __u32 virt_section_length
;
146 __u32 config_section_offset
;
147 __u32 config_section_length
;
148 __u32 data_section_offset
;
149 __u32 data_section_length
;
150 __u32 bbm_section_offset
;
151 __u32 bbm_section_length
;
152 __u32 diag_space_offset
;
153 __u32 diag_space_length
;
156 /* 256 bytes so far */
157 __u8 pad4
[256]; /* 0xff */
161 #define DDF_HEADER_ANCHOR 0x00
162 #define DDF_HEADER_PRIMARY 0x01
163 #define DDF_HEADER_SECONDARY 0x02
165 /* The content of the 'controller section' - global scope */
166 struct ddf_controller_data
{
167 __u32 magic
; /* DDF_CONTROLLER_MAGIC */
169 char guid
[DDF_GUID_LEN
];
170 struct controller_type
{
177 __u8 pad
[8]; /* 0xff */
178 __u8 vendor_data
[448];
181 /* The content of phys_section - global scope */
183 __u32 magic
; /* DDF_PHYS_RECORDS_MAGIC */
188 struct phys_disk_entry
{
189 char guid
[DDF_GUID_LEN
];
193 __u64 config_size
; /* DDF structures must be after here */
194 char path
[18]; /* another horrible structure really */
199 /* phys_disk_entry.type is a bitmap - bigendian remember */
200 #define DDF_Forced_PD_GUID 1
201 #define DDF_Active_in_VD 2
202 #define DDF_Global_Spare 4 /* VD_CONF records are ignored */
203 #define DDF_Spare 8 /* overrides Global_spare */
204 #define DDF_Foreign 16
205 #define DDF_Legacy 32 /* no DDF on this device */
207 #define DDF_Interface_mask 0xf00
208 #define DDF_Interface_SCSI 0x100
209 #define DDF_Interface_SAS 0x200
210 #define DDF_Interface_SATA 0x300
211 #define DDF_Interface_FC 0x400
213 /* phys_disk_entry.state is a bigendian bitmap */
215 #define DDF_Failed 2 /* overrides 1,4,8 */
216 #define DDF_Rebuilding 4
217 #define DDF_Transition 8
219 #define DDF_ReadErrors 32
220 #define DDF_Missing 64
222 /* The content of the virt_section global scope */
223 struct virtual_disk
{
224 __u32 magic
; /* DDF_VIRT_RECORDS_MAGIC */
226 __u16 populated_vdes
;
229 struct virtual_entry
{
230 char guid
[DDF_GUID_LEN
];
232 __u16 pad0
; /* 0xffff */
242 /* virtual_entry.type is a bitmap - bigendian */
244 #define DDF_Enforce_Groups 2
245 #define DDF_Unicode 4
246 #define DDF_Owner_Valid 8
248 /* virtual_entry.state is a bigendian bitmap */
249 #define DDF_state_mask 0x7
250 #define DDF_state_optimal 0x0
251 #define DDF_state_degraded 0x1
252 #define DDF_state_deleted 0x2
253 #define DDF_state_missing 0x3
254 #define DDF_state_failed 0x4
255 #define DDF_state_part_optimal 0x5
257 #define DDF_state_morphing 0x8
258 #define DDF_state_inconsistent 0x10
260 /* virtual_entry.init_state is a bigendian bitmap */
261 #define DDF_initstate_mask 0x03
262 #define DDF_init_not 0x00
263 #define DDF_init_quick 0x01 /* initialisation is progress.
264 * i.e. 'state_inconsistent' */
265 #define DDF_init_full 0x02
267 #define DDF_access_mask 0xc0
268 #define DDF_access_rw 0x00
269 #define DDF_access_ro 0x80
270 #define DDF_access_blocked 0xc0
272 /* The content of the config_section - local scope
273 * It has multiple records each config_record_len sectors
274 * They can be vd_config or spare_assign
278 __u32 magic
; /* DDF_VD_CONF_MAGIC */
280 char guid
[DDF_GUID_LEN
];
284 __u16 prim_elmnt_count
;
285 __u8 chunk_shift
; /* 0 == 512, 1==1024 etc */
288 __u8 sec_elmnt_count
;
291 __u64 blocks
; /* blocks per component could be different
292 * on different component devices...(only
293 * for concat I hope) */
294 __u64 array_blocks
; /* blocks in array */
302 __u8 v0
[32]; /* reserved- 0xff */
303 __u8 v1
[32]; /* reserved- 0xff */
304 __u8 v2
[16]; /* reserved- 0xff */
305 __u8 v3
[16]; /* reserved- 0xff */
307 __u32 phys_refnum
[0]; /* refnum of each disk in sequence */
308 /*__u64 lba_offset[0]; LBA offset in each phys. Note extents in a
309 bvd are always the same size */
312 /* vd_config.cache_pol[7] is a bitmap */
313 #define DDF_cache_writeback 1 /* else writethrough */
314 #define DDF_cache_wadaptive 2 /* only applies if writeback */
315 #define DDF_cache_readahead 4
316 #define DDF_cache_radaptive 8 /* only if doing read-ahead */
317 #define DDF_cache_ifnobatt 16 /* even to write cache if battery is poor */
318 #define DDF_cache_wallowed 32 /* enable write caching */
319 #define DDF_cache_rallowed 64 /* enable read caching */
321 struct spare_assign
{
322 __u32 magic
; /* DDF_SPARE_ASSIGN_MAGIC */
327 __u16 populated
; /* SAEs used */
328 __u16 max
; /* max SAEs */
330 struct spare_assign_entry
{
331 char guid
[DDF_GUID_LEN
];
332 __u16 secondary_element
;
336 /* spare_assign.type is a bitmap */
337 #define DDF_spare_dedicated 0x1 /* else global */
338 #define DDF_spare_revertible 0x2 /* else committable */
339 #define DDF_spare_active 0x4 /* else not active */
340 #define DDF_spare_affinity 0x8 /* enclosure affinity */
342 /* The data_section contents - local scope */
344 __u32 magic
; /* DDF_PHYS_DATA_MAGIC */
346 char guid
[DDF_GUID_LEN
];
347 __u32 refnum
; /* crc of some magic drive data ... */
348 __u8 forced_ref
; /* set when above was not result of magic */
349 __u8 forced_guid
; /* set if guid was forced rather than magic */
354 /* bbm_section content */
355 struct bad_block_log
{
362 struct mapped_block
{
363 __u64 defective_start
;
364 __u32 replacement_start
;
370 /* Struct for internally holding ddf structures */
371 /* The DDF structure stored on each device is potentially
372 * quite different, as some data is global and some is local.
373 * The global data is:
376 * - Physical disk records
377 * - Virtual disk records
379 * - Configuration records
380 * - Physical Disk data section
381 * ( and Bad block and vendor which I don't care about yet).
383 * The local data is parsed into separate lists as it is read
384 * and reconstructed for writing. This means that we only need
385 * to make config changes once and they are automatically
386 * propagated to all devices.
387 * Note that the ddf_super has space of the conf and disk data
388 * for this disk and also for a list of all such data.
389 * The list is only used for the superblock that is being
390 * built in Create or Assemble to describe the whole array.
393 struct ddf_header anchor
, primary
, secondary
;
394 struct ddf_controller_data controller
;
395 struct ddf_header
*active
;
396 struct phys_disk
*phys
;
397 struct virtual_disk
*virt
;
399 unsigned int max_part
, mppe
, conf_rec_len
;
407 __u64
*lba_offset
; /* location in 'conf' of
409 unsigned int vcnum
; /* index into ->virt */
410 __u64
*block_sizes
; /* NULL if all the same */
413 struct vd_config conf
;
414 } *conflist
, *currentconf
;
423 unsigned long long size
; /* sectors */
424 int pdnum
; /* index in ->phys */
425 struct spare_assign
*spare
;
426 void *mdupdate
; /* hold metadata update */
428 /* These fields used by auto-layout */
429 int raiddisk
; /* slot to fill in autolayout */
433 struct disk_data disk
;
434 struct vcl
*vlist
[0]; /* max_part in size */
439 #define offsetof(t,f) ((size_t)&(((t*)0)->f))
443 static unsigned int calc_crc(void *buf
, int len
)
445 /* crcs are always at the same place as in the ddf_header */
446 struct ddf_header
*ddf
= buf
;
447 __u32 oldcrc
= ddf
->crc
;
449 ddf
->crc
= 0xffffffff;
451 newcrc
= crc32(0, buf
, len
);
453 /* The crc is store (like everything) bigendian, so convert
454 * here for simplicity
456 return __cpu_to_be32(newcrc
);
459 static int load_ddf_header(int fd
, unsigned long long lba
,
460 unsigned long long size
,
462 struct ddf_header
*hdr
, struct ddf_header
*anchor
)
464 /* read a ddf header (primary or secondary) from fd/lba
465 * and check that it is consistent with anchor
467 * magic, crc, guid, rev, and LBA's header_type, and
468 * everything after header_type must be the same
473 if (lseek64(fd
, lba
<<9, 0) < 0)
476 if (read(fd
, hdr
, 512) != 512)
479 if (hdr
->magic
!= DDF_HEADER_MAGIC
)
481 if (calc_crc(hdr
, 512) != hdr
->crc
)
483 if (memcmp(anchor
->guid
, hdr
->guid
, DDF_GUID_LEN
) != 0 ||
484 memcmp(anchor
->revision
, hdr
->revision
, 8) != 0 ||
485 anchor
->primary_lba
!= hdr
->primary_lba
||
486 anchor
->secondary_lba
!= hdr
->secondary_lba
||
488 memcmp(anchor
->pad2
, hdr
->pad2
, 512 -
489 offsetof(struct ddf_header
, pad2
)) != 0)
492 /* Looks good enough to me... */
496 static void *load_section(int fd
, struct ddf_super
*super
, void *buf
,
497 __u32 offset_be
, __u32 len_be
, int check
)
499 unsigned long long offset
= __be32_to_cpu(offset_be
);
500 unsigned long long len
= __be32_to_cpu(len_be
);
501 int dofree
= (buf
== NULL
);
504 if (len
!= 2 && len
!= 8 && len
!= 32
505 && len
!= 128 && len
!= 512)
511 /* All pre-allocated sections are a single block */
514 } else if (posix_memalign(&buf
, 512, len
<<9) != 0)
520 if (super
->active
->type
== 1)
521 offset
+= __be64_to_cpu(super
->active
->primary_lba
);
523 offset
+= __be64_to_cpu(super
->active
->secondary_lba
);
525 if ((unsigned long long)lseek64(fd
, offset
<<9, 0) != (offset
<<9)) {
530 if ((unsigned long long)read(fd
, buf
, len
<<9) != (len
<<9)) {
538 static int load_ddf_headers(int fd
, struct ddf_super
*super
, char *devname
)
540 unsigned long long dsize
;
542 get_dev_size(fd
, NULL
, &dsize
);
544 if (lseek64(fd
, dsize
-512, 0) < 0) {
547 Name
": Cannot seek to anchor block on %s: %s\n",
548 devname
, strerror(errno
));
551 if (read(fd
, &super
->anchor
, 512) != 512) {
554 Name
": Cannot read anchor block on %s: %s\n",
555 devname
, strerror(errno
));
558 if (super
->anchor
.magic
!= DDF_HEADER_MAGIC
) {
560 fprintf(stderr
, Name
": no DDF anchor found on %s\n",
564 if (calc_crc(&super
->anchor
, 512) != super
->anchor
.crc
) {
566 fprintf(stderr
, Name
": bad CRC on anchor on %s\n",
570 if (memcmp(super
->anchor
.revision
, DDF_REVISION_0
, 8) != 0 &&
571 memcmp(super
->anchor
.revision
, DDF_REVISION_2
, 8) != 0) {
573 fprintf(stderr
, Name
": can only support super revision"
574 " %.8s and earlier, not %.8s on %s\n",
575 DDF_REVISION_2
, super
->anchor
.revision
,devname
);
578 if (load_ddf_header(fd
, __be64_to_cpu(super
->anchor
.primary_lba
),
580 &super
->primary
, &super
->anchor
) == 0) {
583 Name
": Failed to load primary DDF header "
587 super
->active
= &super
->primary
;
588 if (load_ddf_header(fd
, __be64_to_cpu(super
->anchor
.secondary_lba
),
590 &super
->secondary
, &super
->anchor
)) {
591 if ((__be32_to_cpu(super
->primary
.seq
)
592 < __be32_to_cpu(super
->secondary
.seq
) &&
593 !super
->secondary
.openflag
)
594 || (__be32_to_cpu(super
->primary
.seq
)
595 == __be32_to_cpu(super
->secondary
.seq
) &&
596 super
->primary
.openflag
&& !super
->secondary
.openflag
)
598 super
->active
= &super
->secondary
;
603 static int load_ddf_global(int fd
, struct ddf_super
*super
, char *devname
)
606 ok
= load_section(fd
, super
, &super
->controller
,
607 super
->active
->controller_section_offset
,
608 super
->active
->controller_section_length
,
610 super
->phys
= load_section(fd
, super
, NULL
,
611 super
->active
->phys_section_offset
,
612 super
->active
->phys_section_length
,
614 super
->pdsize
= __be32_to_cpu(super
->active
->phys_section_length
) * 512;
616 super
->virt
= load_section(fd
, super
, NULL
,
617 super
->active
->virt_section_offset
,
618 super
->active
->virt_section_length
,
620 super
->vdsize
= __be32_to_cpu(super
->active
->virt_section_length
) * 512;
630 super
->conflist
= NULL
;
633 super
->max_part
= __be16_to_cpu(super
->active
->max_partitions
);
634 super
->mppe
= __be16_to_cpu(super
->active
->max_primary_element_entries
);
635 super
->conf_rec_len
= __be16_to_cpu(super
->active
->config_record_len
);
639 static int load_ddf_local(int fd
, struct ddf_super
*super
,
640 char *devname
, int keep
)
646 unsigned int confsec
;
648 unsigned int max_virt_disks
= __be16_to_cpu(super
->active
->max_vd_entries
);
649 unsigned long long dsize
;
651 /* First the local disk info */
652 if (posix_memalign((void**)&dl
, 512,
654 (super
->max_part
) * sizeof(dl
->vlist
[0])) != 0) {
655 fprintf(stderr
, Name
": %s could not allocate disk info buffer\n",
660 load_section(fd
, super
, &dl
->disk
,
661 super
->active
->data_section_offset
,
662 super
->active
->data_section_length
,
664 dl
->devname
= devname
? strdup(devname
) : NULL
;
667 dl
->major
= major(stb
.st_rdev
);
668 dl
->minor
= minor(stb
.st_rdev
);
669 dl
->next
= super
->dlist
;
670 dl
->fd
= keep
? fd
: -1;
673 if (get_dev_size(fd
, devname
, &dsize
))
674 dl
->size
= dsize
>> 9;
676 for (i
= 0 ; i
< super
->max_part
; i
++)
680 for (i
= 0; i
< __be16_to_cpu(super
->active
->max_pd_entries
); i
++)
681 if (memcmp(super
->phys
->entries
[i
].guid
,
682 dl
->disk
.guid
, DDF_GUID_LEN
) == 0)
685 /* Now the config list. */
686 /* 'conf' is an array of config entries, some of which are
687 * probably invalid. Those which are good need to be copied into
691 conf
= load_section(fd
, super
, NULL
,
692 super
->active
->config_section_offset
,
693 super
->active
->config_section_length
,
698 confsec
< __be32_to_cpu(super
->active
->config_section_length
);
699 confsec
+= super
->conf_rec_len
) {
700 struct vd_config
*vd
=
701 (struct vd_config
*)((char*)conf
+ confsec
*512);
704 if (vd
->magic
== DDF_SPARE_ASSIGN_MAGIC
) {
707 if (posix_memalign((void**)&dl
->spare
, 512,
708 super
->conf_rec_len
*512) != 0) {
710 ": %s could not allocate spare info buf\n",
715 memcpy(dl
->spare
, vd
, super
->conf_rec_len
*512);
718 if (vd
->magic
!= DDF_VD_CONF_MAGIC
)
720 for (vcl
= super
->conflist
; vcl
; vcl
= vcl
->next
) {
721 if (memcmp(vcl
->conf
.guid
,
722 vd
->guid
, DDF_GUID_LEN
) == 0)
727 dl
->vlist
[vnum
++] = vcl
;
728 if (__be32_to_cpu(vd
->seqnum
) <=
729 __be32_to_cpu(vcl
->conf
.seqnum
))
732 if (posix_memalign((void**)&vcl
, 512,
733 (super
->conf_rec_len
*512 +
734 offsetof(struct vcl
, conf
))) != 0) {
736 ": %s could not allocate vcl buf\n",
740 vcl
->next
= super
->conflist
;
741 vcl
->block_sizes
= NULL
; /* FIXME not for CONCAT */
742 super
->conflist
= vcl
;
743 dl
->vlist
[vnum
++] = vcl
;
745 memcpy(&vcl
->conf
, vd
, super
->conf_rec_len
*512);
746 vcl
->lba_offset
= (__u64
*)
747 &vcl
->conf
.phys_refnum
[super
->mppe
];
749 for (i
=0; i
< max_virt_disks
; i
++)
750 if (memcmp(super
->virt
->entries
[i
].guid
,
751 vcl
->conf
.guid
, DDF_GUID_LEN
)==0)
753 if (i
< max_virt_disks
)
762 static int load_super_ddf_all(struct supertype
*st
, int fd
,
763 void **sbp
, char *devname
, int keep_fd
);
766 static void free_super_ddf(struct supertype
*st
);
768 static int load_super_ddf(struct supertype
*st
, int fd
,
771 unsigned long long dsize
;
772 struct ddf_super
*super
;
776 /* if 'fd' is a container, load metadata from all the devices */
777 if (load_super_ddf_all(st
, fd
, &st
->sb
, devname
, 1) == 0)
781 return 1; /* FIXME Is this correct */
783 if (get_dev_size(fd
, devname
, &dsize
) == 0)
786 if (test_partition(fd
))
787 /* DDF is not allowed on partitions */
790 /* 32M is a lower bound */
791 if (dsize
<= 32*1024*1024) {
794 Name
": %s is too small for ddf: "
795 "size is %llu sectors.\n",
802 Name
": %s is an odd size for ddf: "
803 "size is %llu bytes.\n",
810 if (posix_memalign((void**)&super
, 512, sizeof(*super
))!= 0) {
811 fprintf(stderr
, Name
": malloc of %zu failed.\n",
815 memset(super
, 0, sizeof(*super
));
817 rv
= load_ddf_headers(fd
, super
, devname
);
823 /* Have valid headers and have chosen the best. Let's read in the rest*/
825 rv
= load_ddf_global(fd
, super
, devname
);
830 Name
": Failed to load all information "
831 "sections on %s\n", devname
);
836 rv
= load_ddf_local(fd
, super
, devname
, 0);
841 Name
": Failed to load all information "
842 "sections on %s\n", devname
);
847 if (st
->subarray
[0]) {
852 val
= strtoul(st
->subarray
, &ep
, 10);
858 for (v
= super
->conflist
; v
; v
= v
->next
)
860 super
->currentconf
= v
;
861 if (!super
->currentconf
) {
867 /* Should possibly check the sections .... */
870 if (st
->ss
== NULL
) {
872 st
->minor_version
= 0;
875 st
->loaded_container
= 0;
880 static void free_super_ddf(struct supertype
*st
)
882 struct ddf_super
*ddf
= st
->sb
;
887 while (ddf
->conflist
) {
888 struct vcl
*v
= ddf
->conflist
;
889 ddf
->conflist
= v
->next
;
891 free(v
->block_sizes
);
895 struct dl
*d
= ddf
->dlist
;
896 ddf
->dlist
= d
->next
;
903 while (ddf
->add_list
) {
904 struct dl
*d
= ddf
->add_list
;
905 ddf
->add_list
= d
->next
;
916 static struct supertype
*match_metadata_desc_ddf(char *arg
)
918 /* 'ddf' only support containers */
919 struct supertype
*st
;
920 if (strcmp(arg
, "ddf") != 0 &&
921 strcmp(arg
, "default") != 0
925 st
= malloc(sizeof(*st
));
926 memset(st
, 0, sizeof(*st
));
929 st
->minor_version
= 0;
937 static mapping_t ddf_state
[] = {
943 { "Partially Optimal", 5},
949 static mapping_t ddf_init_state
[] = {
950 { "Not Initialised", 0},
951 { "QuickInit in Progress", 1},
952 { "Fully Initialised", 2},
956 static mapping_t ddf_access
[] = {
960 { "Blocked (no access)", 3},
964 static mapping_t ddf_level
[] = {
965 { "RAID0", DDF_RAID0
},
966 { "RAID1", DDF_RAID1
},
967 { "RAID3", DDF_RAID3
},
968 { "RAID4", DDF_RAID4
},
969 { "RAID5", DDF_RAID5
},
970 { "RAID1E",DDF_RAID1E
},
972 { "CONCAT",DDF_CONCAT
},
973 { "RAID5E",DDF_RAID5E
},
974 { "RAID5EE",DDF_RAID5EE
},
975 { "RAID6", DDF_RAID6
},
978 static mapping_t ddf_sec_level
[] = {
979 { "Striped", DDF_2STRIPED
},
980 { "Mirrored", DDF_2MIRRORED
},
981 { "Concat", DDF_2CONCAT
},
982 { "Spanned", DDF_2SPANNED
},
990 static struct num_mapping ddf_level_num
[] = {
993 { DDF_RAID3
, LEVEL_UNSUPPORTED
},
996 { DDF_RAID1E
, LEVEL_UNSUPPORTED
},
997 { DDF_JBOD
, LEVEL_UNSUPPORTED
},
998 { DDF_CONCAT
, LEVEL_LINEAR
},
999 { DDF_RAID5E
, LEVEL_UNSUPPORTED
},
1000 { DDF_RAID5EE
, LEVEL_UNSUPPORTED
},
1005 static int map_num1(struct num_mapping
*map
, int num
)
1008 for (i
=0 ; map
[i
].num1
!= MAXINT
; i
++)
1009 if (map
[i
].num1
== num
)
1014 static int all_ff(char *guid
)
1017 for (i
= 0; i
< DDF_GUID_LEN
; i
++)
1018 if (guid
[i
] != (char)0xff)
1024 static void print_guid(char *guid
, int tstamp
)
1026 /* A GUIDs are part (or all) ASCII and part binary.
1027 * They tend to be space padded.
1028 * We print the GUID in HEX, then in parentheses add
1029 * any initial ASCII sequence, and a possible
1030 * time stamp from bytes 16-19
1032 int l
= DDF_GUID_LEN
;
1035 for (i
=0 ; i
<DDF_GUID_LEN
; i
++) {
1036 if ((i
&3)==0 && i
!= 0) printf(":");
1037 printf("%02X", guid
[i
]&255);
1041 while (l
&& guid
[l
-1] == ' ')
1043 for (i
=0 ; i
<l
; i
++) {
1044 if (guid
[i
] >= 0x20 && guid
[i
] < 0x7f)
1045 fputc(guid
[i
], stdout
);
1050 time_t then
= __be32_to_cpu(*(__u32
*)(guid
+16)) + DECADE
;
1053 tm
= localtime(&then
);
1054 strftime(tbuf
, 100, " %D %T",tm
);
1055 fputs(tbuf
, stdout
);
1060 static void examine_vd(int n
, struct ddf_super
*sb
, char *guid
)
1062 int crl
= sb
->conf_rec_len
;
1065 for (vcl
= sb
->conflist
; vcl
; vcl
= vcl
->next
) {
1067 struct vd_config
*vc
= &vcl
->conf
;
1069 if (calc_crc(vc
, crl
*512) != vc
->crc
)
1071 if (memcmp(vc
->guid
, guid
, DDF_GUID_LEN
) != 0)
1074 /* Ok, we know about this VD, let's give more details */
1075 printf(" Raid Devices[%d] : %d (", n
,
1076 __be16_to_cpu(vc
->prim_elmnt_count
));
1077 for (i
= 0; i
< __be16_to_cpu(vc
->prim_elmnt_count
); i
++) {
1079 int cnt
= __be16_to_cpu(sb
->phys
->used_pdes
);
1080 for (j
=0; j
<cnt
; j
++)
1081 if (vc
->phys_refnum
[i
] == sb
->phys
->entries
[j
].refnum
)
1090 if (vc
->chunk_shift
!= 255)
1091 printf(" Chunk Size[%d] : %d sectors\n", n
,
1092 1 << vc
->chunk_shift
);
1093 printf(" Raid Level[%d] : %s\n", n
,
1094 map_num(ddf_level
, vc
->prl
)?:"-unknown-");
1095 if (vc
->sec_elmnt_count
!= 1) {
1096 printf(" Secondary Position[%d] : %d of %d\n", n
,
1097 vc
->sec_elmnt_seq
, vc
->sec_elmnt_count
);
1098 printf(" Secondary Level[%d] : %s\n", n
,
1099 map_num(ddf_sec_level
, vc
->srl
) ?: "-unknown-");
1101 printf(" Device Size[%d] : %llu\n", n
,
1102 (unsigned long long)__be64_to_cpu(vc
->blocks
)/2);
1103 printf(" Array Size[%d] : %llu\n", n
,
1104 (unsigned long long)__be64_to_cpu(vc
->array_blocks
)/2);
1108 static void examine_vds(struct ddf_super
*sb
)
1110 int cnt
= __be16_to_cpu(sb
->virt
->populated_vdes
);
1112 printf(" Virtual Disks : %d\n", cnt
);
1114 for (i
=0; i
<cnt
; i
++) {
1115 struct virtual_entry
*ve
= &sb
->virt
->entries
[i
];
1117 printf(" VD GUID[%d] : ", i
); print_guid(ve
->guid
, 1);
1119 printf(" unit[%d] : %d\n", i
, __be16_to_cpu(ve
->unit
));
1120 printf(" state[%d] : %s, %s%s\n", i
,
1121 map_num(ddf_state
, ve
->state
& 7),
1122 (ve
->state
& 8) ? "Morphing, ": "",
1123 (ve
->state
& 16)? "Not Consistent" : "Consistent");
1124 printf(" init state[%d] : %s\n", i
,
1125 map_num(ddf_init_state
, ve
->init_state
&3));
1126 printf(" access[%d] : %s\n", i
,
1127 map_num(ddf_access
, (ve
->init_state
>>6) & 3));
1128 printf(" Name[%d] : %.16s\n", i
, ve
->name
);
1129 examine_vd(i
, sb
, ve
->guid
);
1131 if (cnt
) printf("\n");
1134 static void examine_pds(struct ddf_super
*sb
)
1136 int cnt
= __be16_to_cpu(sb
->phys
->used_pdes
);
1139 printf(" Physical Disks : %d\n", cnt
);
1140 printf(" Number RefNo Size Device Type/State\n");
1142 for (i
=0 ; i
<cnt
; i
++) {
1143 struct phys_disk_entry
*pd
= &sb
->phys
->entries
[i
];
1144 int type
= __be16_to_cpu(pd
->type
);
1145 int state
= __be16_to_cpu(pd
->state
);
1147 //printf(" PD GUID[%d] : ", i); print_guid(pd->guid, 0);
1149 printf(" %3d %08x ", i
,
1150 __be32_to_cpu(pd
->refnum
));
1152 (unsigned long long)__be64_to_cpu(pd
->config_size
)>>1);
1153 for (dl
= sb
->dlist
; dl
; dl
= dl
->next
) {
1154 if (dl
->disk
.refnum
== pd
->refnum
) {
1155 char *dv
= map_dev(dl
->major
, dl
->minor
, 0);
1157 printf("%-15s", dv
);
1164 printf(" %s%s%s%s%s",
1165 (type
&2) ? "active":"",
1166 (type
&4) ? "Global-Spare":"",
1167 (type
&8) ? "spare" : "",
1168 (type
&16)? ", foreign" : "",
1169 (type
&32)? "pass-through" : "");
1170 if (state
& DDF_Failed
)
1171 /* This over-rides these three */
1172 state
&= ~(DDF_Online
|DDF_Rebuilding
|DDF_Transition
);
1173 printf("/%s%s%s%s%s%s%s",
1174 (state
&1)? "Online": "Offline",
1175 (state
&2)? ", Failed": "",
1176 (state
&4)? ", Rebuilding": "",
1177 (state
&8)? ", in-transition": "",
1178 (state
&16)? ", SMART-errors": "",
1179 (state
&32)? ", Unrecovered-Read-Errors": "",
1180 (state
&64)? ", Missing" : "");
1185 static void examine_super_ddf(struct supertype
*st
, char *homehost
)
1187 struct ddf_super
*sb
= st
->sb
;
1189 printf(" Magic : %08x\n", __be32_to_cpu(sb
->anchor
.magic
));
1190 printf(" Version : %.8s\n", sb
->anchor
.revision
);
1191 printf("Controller GUID : "); print_guid(sb
->controller
.guid
, 0);
1193 printf(" Container GUID : "); print_guid(sb
->anchor
.guid
, 1);
1195 printf(" Seq : %08x\n", __be32_to_cpu(sb
->active
->seq
));
1196 printf(" Redundant hdr : %s\n", sb
->secondary
.magic
== DDF_HEADER_MAGIC
1202 static void getinfo_super_ddf(struct supertype
*st
, struct mdinfo
*info
);
1204 static void uuid_from_super_ddf(struct supertype
*st
, int uuid
[4]);
1206 static void brief_examine_super_ddf(struct supertype
*st
, int verbose
)
1208 /* We just write a generic DDF ARRAY entry
1212 getinfo_super_ddf(st
, &info
);
1213 fname_from_uuid(st
, &info
, nbuf
, ':');
1215 printf("ARRAY metadata=ddf UUID=%s\n", nbuf
+ 5);
1218 static void brief_examine_subarrays_ddf(struct supertype
*st
, int verbose
)
1220 /* We just write a generic DDF ARRAY entry
1222 struct ddf_super
*ddf
= st
->sb
;
1226 getinfo_super_ddf(st
, &info
);
1227 fname_from_uuid(st
, &info
, nbuf
, ':');
1229 for (i
= 0; i
< __be16_to_cpu(ddf
->virt
->max_vdes
); i
++) {
1230 struct virtual_entry
*ve
= &ddf
->virt
->entries
[i
];
1233 if (all_ff(ve
->guid
))
1235 memcpy(vcl
.conf
.guid
, ve
->guid
, DDF_GUID_LEN
);
1236 ddf
->currentconf
=&vcl
;
1237 uuid_from_super_ddf(st
, info
.uuid
);
1238 fname_from_uuid(st
, &info
, nbuf1
, ':');
1239 printf("ARRAY container=%s member=%d UUID=%s\n",
1240 nbuf
+5, i
, nbuf1
+5);
1244 static void export_examine_super_ddf(struct supertype
*st
)
1248 getinfo_super_ddf(st
, &info
);
1249 fname_from_uuid(st
, &info
, nbuf
, ':');
1250 printf("MD_METADATA=ddf\n");
1251 printf("MD_LEVEL=container\n");
1252 printf("MD_UUID=%s\n", nbuf
+5);
1256 static void detail_super_ddf(struct supertype
*st
, char *homehost
)
1259 * Could print DDF GUID
1260 * Need to find which array
1261 * If whole, briefly list all arrays
1266 static void brief_detail_super_ddf(struct supertype
*st
)
1268 /* FIXME I really need to know which array we are detailing.
1269 * Can that be stored in ddf_super??
1271 // struct ddf_super *ddf = st->sb;
1274 getinfo_super_ddf(st
, &info
);
1275 fname_from_uuid(st
, &info
, nbuf
,':');
1276 printf(" UUID=%s", nbuf
+ 5);
1280 static int match_home_ddf(struct supertype
*st
, char *homehost
)
1282 /* It matches 'this' host if the controller is a
1283 * Linux-MD controller with vendor_data matching
1286 struct ddf_super
*ddf
= st
->sb
;
1291 len
= strlen(homehost
);
1293 return (memcmp(ddf
->controller
.guid
, T10
, 8) == 0 &&
1294 len
< sizeof(ddf
->controller
.vendor_data
) &&
1295 memcmp(ddf
->controller
.vendor_data
, homehost
,len
) == 0 &&
1296 ddf
->controller
.vendor_data
[len
] == 0);
1300 static struct vd_config
*find_vdcr(struct ddf_super
*ddf
, unsigned int inst
)
1304 for (v
= ddf
->conflist
; v
; v
= v
->next
)
1305 if (inst
== v
->vcnum
)
1311 static int find_phys(struct ddf_super
*ddf
, __u32 phys_refnum
)
1313 /* Find the entry in phys_disk which has the given refnum
1314 * and return it's index
1317 for (i
= 0; i
< __be16_to_cpu(ddf
->phys
->max_pdes
); i
++)
1318 if (ddf
->phys
->entries
[i
].refnum
== phys_refnum
)
1323 static void uuid_from_super_ddf(struct supertype
*st
, int uuid
[4])
1325 /* The uuid returned here is used for:
1326 * uuid to put into bitmap file (Create, Grow)
1327 * uuid for backup header when saving critical section (Grow)
1328 * comparing uuids when re-adding a device into an array
1329 * In these cases the uuid required is that of the data-array,
1330 * not the device-set.
1331 * uuid to recognise same set when adding a missing device back
1332 * to an array. This is a uuid for the device-set.
1334 * For each of these we can make do with a truncated
1335 * or hashed uuid rather than the original, as long as
1337 * In the case of SVD we assume the BVD is of interest,
1338 * though that might be the case if a bitmap were made for
1339 * a mirrored SVD - worry about that later.
1340 * So we need to find the VD configuration record for the
1341 * relevant BVD and extract the GUID and Secondary_Element_Seq.
1342 * The first 16 bytes of the sha1 of these is used.
1344 struct ddf_super
*ddf
= st
->sb
;
1345 struct vcl
*vcl
= ddf
->currentconf
;
1348 struct sha1_ctx ctx
;
1351 guid
= vcl
->conf
.guid
;
1353 guid
= ddf
->anchor
.guid
;
1355 sha1_init_ctx(&ctx
);
1356 sha1_process_bytes(guid
, DDF_GUID_LEN
, &ctx
);
1357 sha1_finish_ctx(&ctx
, buf
);
1358 memcpy(uuid
, buf
, 4*4);
1361 static void getinfo_super_ddf_bvd(struct supertype
*st
, struct mdinfo
*info
);
1363 static void getinfo_super_ddf(struct supertype
*st
, struct mdinfo
*info
)
1365 struct ddf_super
*ddf
= st
->sb
;
1367 if (ddf
->currentconf
) {
1368 getinfo_super_ddf_bvd(st
, info
);
1372 info
->array
.raid_disks
= __be16_to_cpu(ddf
->phys
->used_pdes
);
1373 info
->array
.level
= LEVEL_CONTAINER
;
1374 info
->array
.layout
= 0;
1375 info
->array
.md_minor
= -1;
1376 info
->array
.ctime
= DECADE
+ __be32_to_cpu(*(__u32
*)
1377 (ddf
->anchor
.guid
+16));
1378 info
->array
.utime
= 0;
1379 info
->array
.chunk_size
= 0;
1380 info
->container_enough
= 1;
1383 info
->disk
.major
= 0;
1384 info
->disk
.minor
= 0;
1386 info
->disk
.number
= __be32_to_cpu(ddf
->dlist
->disk
.refnum
);
1387 info
->disk
.raid_disk
= find_phys(ddf
, ddf
->dlist
->disk
.refnum
);
1389 info
->data_offset
= __be64_to_cpu(ddf
->phys
->
1390 entries
[info
->disk
.raid_disk
].
1392 info
->component_size
= ddf
->dlist
->size
- info
->data_offset
;
1394 info
->disk
.number
= -1;
1395 info
->disk
.raid_disk
= -1;
1396 // info->disk.raid_disk = find refnum in the table and use index;
1398 info
->disk
.state
= (1 << MD_DISK_SYNC
) | (1 << MD_DISK_ACTIVE
);
1401 info
->recovery_start
= MaxSector
;
1402 info
->reshape_active
= 0;
1405 info
->array
.major_version
= -1;
1406 info
->array
.minor_version
= -2;
1407 strcpy(info
->text_version
, "ddf");
1408 info
->safe_mode_delay
= 0;
1410 uuid_from_super_ddf(st
, info
->uuid
);
1414 static int rlq_to_layout(int rlq
, int prl
, int raiddisks
);
1416 static void getinfo_super_ddf_bvd(struct supertype
*st
, struct mdinfo
*info
)
1418 struct ddf_super
*ddf
= st
->sb
;
1419 struct vcl
*vc
= ddf
->currentconf
;
1420 int cd
= ddf
->currentdev
;
1424 /* FIXME this returns BVD info - what if we want SVD ?? */
1426 info
->array
.raid_disks
= __be16_to_cpu(vc
->conf
.prim_elmnt_count
);
1427 info
->array
.level
= map_num1(ddf_level_num
, vc
->conf
.prl
);
1428 info
->array
.layout
= rlq_to_layout(vc
->conf
.rlq
, vc
->conf
.prl
,
1429 info
->array
.raid_disks
);
1430 info
->array
.md_minor
= -1;
1431 info
->array
.ctime
= DECADE
+
1432 __be32_to_cpu(*(__u32
*)(vc
->conf
.guid
+16));
1433 info
->array
.utime
= DECADE
+ __be32_to_cpu(vc
->conf
.timestamp
);
1434 info
->array
.chunk_size
= 512 << vc
->conf
.chunk_shift
;
1435 info
->custom_array_size
= 0;
1437 if (cd
>= 0 && (unsigned)cd
< ddf
->mppe
) {
1438 info
->data_offset
= __be64_to_cpu(vc
->lba_offset
[cd
]);
1439 if (vc
->block_sizes
)
1440 info
->component_size
= vc
->block_sizes
[cd
];
1442 info
->component_size
= __be64_to_cpu(vc
->conf
.blocks
);
1445 for (dl
= ddf
->dlist
; dl
; dl
= dl
->next
)
1446 if (dl
->raiddisk
== info
->disk
.raid_disk
)
1448 info
->disk
.major
= 0;
1449 info
->disk
.minor
= 0;
1451 info
->disk
.major
= dl
->major
;
1452 info
->disk
.minor
= dl
->minor
;
1454 // info->disk.number = __be32_to_cpu(ddf->disk.refnum);
1455 // info->disk.raid_disk = find refnum in the table and use index;
1456 // info->disk.state = ???;
1458 info
->container_member
= ddf
->currentconf
->vcnum
;
1460 info
->recovery_start
= MaxSector
;
1461 info
->resync_start
= 0;
1462 info
->reshape_active
= 0;
1463 if (!(ddf
->virt
->entries
[info
->container_member
].state
1464 & DDF_state_inconsistent
) &&
1465 (ddf
->virt
->entries
[info
->container_member
].init_state
1466 & DDF_initstate_mask
)
1468 info
->resync_start
= MaxSector
;
1470 uuid_from_super_ddf(st
, info
->uuid
);
1472 info
->array
.major_version
= -1;
1473 info
->array
.minor_version
= -2;
1474 sprintf(info
->text_version
, "/%s/%s",
1475 devnum2devname(st
->container_dev
),
1477 info
->safe_mode_delay
= 200;
1479 memcpy(info
->name
, ddf
->virt
->entries
[info
->container_member
].name
, 16);
1482 if (info
->name
[j
] == ' ')
1487 static int update_super_ddf(struct supertype
*st
, struct mdinfo
*info
,
1489 char *devname
, int verbose
,
1490 int uuid_set
, char *homehost
)
1492 /* For 'assemble' and 'force' we need to return non-zero if any
1493 * change was made. For others, the return value is ignored.
1494 * Update options are:
1495 * force-one : This device looks a bit old but needs to be included,
1496 * update age info appropriately.
1497 * assemble: clear any 'faulty' flag to allow this device to
1499 * force-array: Array is degraded but being forced, mark it clean
1500 * if that will be needed to assemble it.
1502 * newdev: not used ????
1503 * grow: Array has gained a new device - this is currently for
1505 * resync: mark as dirty so a resync will happen.
1506 * uuid: Change the uuid of the array to match what is given
1507 * homehost: update the recorded homehost
1508 * name: update the name - preserving the homehost
1509 * _reshape_progress: record new reshape_progress position.
1511 * Following are not relevant for this version:
1512 * sparc2.2 : update from old dodgey metadata
1513 * super-minor: change the preferred_minor number
1514 * summaries: update redundant counters.
1517 // struct ddf_super *ddf = st->sb;
1518 // struct vd_config *vd = find_vdcr(ddf, info->container_member);
1519 // struct virtual_entry *ve = find_ve(ddf);
1521 /* we don't need to handle "force-*" or "assemble" as
1522 * there is no need to 'trick' the kernel. We the metadata is
1523 * first updated to activate the array, all the implied modifications
1527 if (strcmp(update
, "grow") == 0) {
1530 if (strcmp(update
, "resync") == 0) {
1531 // info->resync_checkpoint = 0;
1533 /* We ignore UUID updates as they make even less sense
1536 if (strcmp(update
, "homehost") == 0) {
1537 /* homehost is stored in controller->vendor_data,
1538 * or it is when we are the vendor
1540 // if (info->vendor_is_local)
1541 // strcpy(ddf->controller.vendor_data, homehost);
1543 if (strcmp(update
, "name") == 0) {
1544 /* name is stored in virtual_entry->name */
1545 // memset(ve->name, ' ', 16);
1546 // strncpy(ve->name, info->name, 16);
1548 if (strcmp(update
, "_reshape_progress") == 0) {
1549 /* We don't support reshape yet */
1552 // update_all_csum(ddf);
1557 static void make_header_guid(char *guid
)
1560 /* Create a DDF Header of Virtual Disk GUID */
1562 /* 24 bytes of fiction required.
1563 * first 8 are a 'vendor-id' - "Linux-MD"
1564 * next 8 are controller type.. how about 0X DEAD BEEF 0000 0000
1565 * Remaining 8 random number plus timestamp
1567 memcpy(guid
, T10
, sizeof(T10
));
1568 stamp
= __cpu_to_be32(0xdeadbeef);
1569 memcpy(guid
+8, &stamp
, 4);
1570 stamp
= __cpu_to_be32(0);
1571 memcpy(guid
+12, &stamp
, 4);
1572 stamp
= __cpu_to_be32(time(0) - DECADE
);
1573 memcpy(guid
+16, &stamp
, 4);
1575 memcpy(guid
+20, &stamp
, 4);
1578 static int init_super_ddf_bvd(struct supertype
*st
,
1579 mdu_array_info_t
*info
,
1580 unsigned long long size
,
1581 char *name
, char *homehost
,
1584 static int init_super_ddf(struct supertype
*st
,
1585 mdu_array_info_t
*info
,
1586 unsigned long long size
, char *name
, char *homehost
,
1589 /* This is primarily called by Create when creating a new array.
1590 * We will then get add_to_super called for each component, and then
1591 * write_init_super called to write it out to each device.
1592 * For DDF, Create can create on fresh devices or on a pre-existing
1594 * To create on a pre-existing array a different method will be called.
1595 * This one is just for fresh drives.
1597 * We need to create the entire 'ddf' structure which includes:
1598 * DDF headers - these are easy.
1599 * Controller data - a Sector describing this controller .. not that
1600 * this is a controller exactly.
1601 * Physical Disk Record - one entry per device, so
1602 * leave plenty of space.
1603 * Virtual Disk Records - again, just leave plenty of space.
1604 * This just lists VDs, doesn't give details
1605 * Config records - describes the VDs that use this disk
1606 * DiskData - describes 'this' device.
1607 * BadBlockManagement - empty
1608 * Diag Space - empty
1609 * Vendor Logs - Could we put bitmaps here?
1612 struct ddf_super
*ddf
;
1615 int max_phys_disks
, max_virt_disks
;
1616 unsigned long long sector
;
1620 struct phys_disk
*pd
;
1621 struct virtual_disk
*vd
;
1624 return init_super_ddf_bvd(st
, info
, size
, name
, homehost
, uuid
);
1626 if (posix_memalign((void**)&ddf
, 512, sizeof(*ddf
)) != 0) {
1627 fprintf(stderr
, Name
": %s could not allocate superblock\n", __func__
);
1630 memset(ddf
, 0, sizeof(*ddf
));
1631 ddf
->dlist
= NULL
; /* no physical disks yet */
1632 ddf
->conflist
= NULL
; /* No virtual disks yet */
1636 /* zeroing superblock */
1640 /* At least 32MB *must* be reserved for the ddf. So let's just
1641 * start 32MB from the end, and put the primary header there.
1642 * Don't do secondary for now.
1643 * We don't know exactly where that will be yet as it could be
1644 * different on each device. To just set up the lengths.
1648 ddf
->anchor
.magic
= DDF_HEADER_MAGIC
;
1649 make_header_guid(ddf
->anchor
.guid
);
1651 memcpy(ddf
->anchor
.revision
, DDF_REVISION_2
, 8);
1652 ddf
->anchor
.seq
= __cpu_to_be32(1);
1653 ddf
->anchor
.timestamp
= __cpu_to_be32(time(0) - DECADE
);
1654 ddf
->anchor
.openflag
= 0xFF;
1655 ddf
->anchor
.foreignflag
= 0;
1656 ddf
->anchor
.enforcegroups
= 0; /* Is this best?? */
1657 ddf
->anchor
.pad0
= 0xff;
1658 memset(ddf
->anchor
.pad1
, 0xff, 12);
1659 memset(ddf
->anchor
.header_ext
, 0xff, 32);
1660 ddf
->anchor
.primary_lba
= ~(__u64
)0;
1661 ddf
->anchor
.secondary_lba
= ~(__u64
)0;
1662 ddf
->anchor
.type
= DDF_HEADER_ANCHOR
;
1663 memset(ddf
->anchor
.pad2
, 0xff, 3);
1664 ddf
->anchor
.workspace_len
= __cpu_to_be32(32768); /* Must be reserved */
1665 ddf
->anchor
.workspace_lba
= ~(__u64
)0; /* Put this at bottom
1666 of 32M reserved.. */
1667 max_phys_disks
= 1023; /* Should be enough */
1668 ddf
->anchor
.max_pd_entries
= __cpu_to_be16(max_phys_disks
);
1669 max_virt_disks
= 255;
1670 ddf
->anchor
.max_vd_entries
= __cpu_to_be16(max_virt_disks
); /* ?? */
1671 ddf
->anchor
.max_partitions
= __cpu_to_be16(64); /* ?? */
1674 ddf
->conf_rec_len
= 1 + ROUND_UP(ddf
->mppe
* (4+8), 512)/512;
1675 ddf
->anchor
.config_record_len
= __cpu_to_be16(ddf
->conf_rec_len
);
1676 ddf
->anchor
.max_primary_element_entries
= __cpu_to_be16(ddf
->mppe
);
1677 memset(ddf
->anchor
.pad3
, 0xff, 54);
1678 /* controller sections is one sector long immediately
1679 * after the ddf header */
1681 ddf
->anchor
.controller_section_offset
= __cpu_to_be32(sector
);
1682 ddf
->anchor
.controller_section_length
= __cpu_to_be32(1);
1685 /* phys is 8 sectors after that */
1686 pdsize
= ROUND_UP(sizeof(struct phys_disk
) +
1687 sizeof(struct phys_disk_entry
)*max_phys_disks
,
1689 switch(pdsize
/512) {
1690 case 2: case 8: case 32: case 128: case 512: break;
1693 ddf
->anchor
.phys_section_offset
= __cpu_to_be32(sector
);
1694 ddf
->anchor
.phys_section_length
=
1695 __cpu_to_be32(pdsize
/512); /* max_primary_element_entries/8 */
1696 sector
+= pdsize
/512;
1698 /* virt is another 32 sectors */
1699 vdsize
= ROUND_UP(sizeof(struct virtual_disk
) +
1700 sizeof(struct virtual_entry
) * max_virt_disks
,
1702 switch(vdsize
/512) {
1703 case 2: case 8: case 32: case 128: case 512: break;
1706 ddf
->anchor
.virt_section_offset
= __cpu_to_be32(sector
);
1707 ddf
->anchor
.virt_section_length
=
1708 __cpu_to_be32(vdsize
/512); /* max_vd_entries/8 */
1709 sector
+= vdsize
/512;
1711 clen
= ddf
->conf_rec_len
* (ddf
->max_part
+1);
1712 ddf
->anchor
.config_section_offset
= __cpu_to_be32(sector
);
1713 ddf
->anchor
.config_section_length
= __cpu_to_be32(clen
);
1716 ddf
->anchor
.data_section_offset
= __cpu_to_be32(sector
);
1717 ddf
->anchor
.data_section_length
= __cpu_to_be32(1);
1720 ddf
->anchor
.bbm_section_length
= __cpu_to_be32(0);
1721 ddf
->anchor
.bbm_section_offset
= __cpu_to_be32(0xFFFFFFFF);
1722 ddf
->anchor
.diag_space_length
= __cpu_to_be32(0);
1723 ddf
->anchor
.diag_space_offset
= __cpu_to_be32(0xFFFFFFFF);
1724 ddf
->anchor
.vendor_length
= __cpu_to_be32(0);
1725 ddf
->anchor
.vendor_offset
= __cpu_to_be32(0xFFFFFFFF);
1727 memset(ddf
->anchor
.pad4
, 0xff, 256);
1729 memcpy(&ddf
->primary
, &ddf
->anchor
, 512);
1730 memcpy(&ddf
->secondary
, &ddf
->anchor
, 512);
1732 ddf
->primary
.openflag
= 1; /* I guess.. */
1733 ddf
->primary
.type
= DDF_HEADER_PRIMARY
;
1735 ddf
->secondary
.openflag
= 1; /* I guess.. */
1736 ddf
->secondary
.type
= DDF_HEADER_SECONDARY
;
1738 ddf
->active
= &ddf
->primary
;
1740 ddf
->controller
.magic
= DDF_CONTROLLER_MAGIC
;
1742 /* 24 more bytes of fiction required.
1743 * first 8 are a 'vendor-id' - "Linux-MD"
1744 * Remaining 16 are serial number.... maybe a hostname would do?
1746 memcpy(ddf
->controller
.guid
, T10
, sizeof(T10
));
1747 gethostname(hostname
, sizeof(hostname
));
1748 hostname
[sizeof(hostname
) - 1] = 0;
1749 hostlen
= strlen(hostname
);
1750 memcpy(ddf
->controller
.guid
+ 24 - hostlen
, hostname
, hostlen
);
1751 for (i
= strlen(T10
) ; i
+hostlen
< 24; i
++)
1752 ddf
->controller
.guid
[i
] = ' ';
1754 ddf
->controller
.type
.vendor_id
= __cpu_to_be16(0xDEAD);
1755 ddf
->controller
.type
.device_id
= __cpu_to_be16(0xBEEF);
1756 ddf
->controller
.type
.sub_vendor_id
= 0;
1757 ddf
->controller
.type
.sub_device_id
= 0;
1758 memcpy(ddf
->controller
.product_id
, "What Is My PID??", 16);
1759 memset(ddf
->controller
.pad
, 0xff, 8);
1760 memset(ddf
->controller
.vendor_data
, 0xff, 448);
1761 if (homehost
&& strlen(homehost
) < 440)
1762 strcpy((char*)ddf
->controller
.vendor_data
, homehost
);
1764 if (posix_memalign((void**)&pd
, 512, pdsize
) != 0) {
1765 fprintf(stderr
, Name
": %s could not allocate pd\n", __func__
);
1769 ddf
->pdsize
= pdsize
;
1771 memset(pd
, 0xff, pdsize
);
1772 memset(pd
, 0, sizeof(*pd
));
1773 pd
->magic
= DDF_PHYS_RECORDS_MAGIC
;
1774 pd
->used_pdes
= __cpu_to_be16(0);
1775 pd
->max_pdes
= __cpu_to_be16(max_phys_disks
);
1776 memset(pd
->pad
, 0xff, 52);
1778 if (posix_memalign((void**)&vd
, 512, vdsize
) != 0) {
1779 fprintf(stderr
, Name
": %s could not allocate vd\n", __func__
);
1783 ddf
->vdsize
= vdsize
;
1784 memset(vd
, 0, vdsize
);
1785 vd
->magic
= DDF_VIRT_RECORDS_MAGIC
;
1786 vd
->populated_vdes
= __cpu_to_be16(0);
1787 vd
->max_vdes
= __cpu_to_be16(max_virt_disks
);
1788 memset(vd
->pad
, 0xff, 52);
1790 for (i
=0; i
<max_virt_disks
; i
++)
1791 memset(&vd
->entries
[i
], 0xff, sizeof(struct virtual_entry
));
1794 ddf
->updates_pending
= 1;
1798 static int chunk_to_shift(int chunksize
)
1800 return ffs(chunksize
/512)-1;
1803 static int level_to_prl(int level
)
1806 case LEVEL_LINEAR
: return DDF_CONCAT
;
1807 case 0: return DDF_RAID0
;
1808 case 1: return DDF_RAID1
;
1809 case 4: return DDF_RAID4
;
1810 case 5: return DDF_RAID5
;
1811 case 6: return DDF_RAID6
;
1815 static int layout_to_rlq(int level
, int layout
, int raiddisks
)
1819 return DDF_RAID0_SIMPLE
;
1822 case 2: return DDF_RAID1_SIMPLE
;
1823 case 3: return DDF_RAID1_MULTI
;
1828 case 0: return DDF_RAID4_N
;
1833 case ALGORITHM_LEFT_ASYMMETRIC
:
1834 return DDF_RAID5_N_RESTART
;
1835 case ALGORITHM_RIGHT_ASYMMETRIC
:
1836 return DDF_RAID5_0_RESTART
;
1837 case ALGORITHM_LEFT_SYMMETRIC
:
1838 return DDF_RAID5_N_CONTINUE
;
1839 case ALGORITHM_RIGHT_SYMMETRIC
:
1840 return -1; /* not mentioned in standard */
1844 case ALGORITHM_ROTATING_N_RESTART
:
1845 return DDF_RAID5_N_RESTART
;
1846 case ALGORITHM_ROTATING_ZERO_RESTART
:
1847 return DDF_RAID6_0_RESTART
;
1848 case ALGORITHM_ROTATING_N_CONTINUE
:
1849 return DDF_RAID5_N_CONTINUE
;
1855 static int rlq_to_layout(int rlq
, int prl
, int raiddisks
)
1859 return 0; /* hopefully rlq == DDF_RAID0_SIMPLE */
1861 return 0; /* hopefully rlq == SIMPLE or MULTI depending
1869 return -1; /* FIXME this isn't checked */
1873 case DDF_RAID5_N_RESTART
:
1874 return ALGORITHM_LEFT_ASYMMETRIC
;
1875 case DDF_RAID5_0_RESTART
:
1876 return ALGORITHM_RIGHT_ASYMMETRIC
;
1877 case DDF_RAID5_N_CONTINUE
:
1878 return ALGORITHM_LEFT_SYMMETRIC
;
1884 case DDF_RAID5_N_RESTART
:
1885 return ALGORITHM_ROTATING_N_RESTART
;
1886 case DDF_RAID6_0_RESTART
:
1887 return ALGORITHM_ROTATING_ZERO_RESTART
;
1888 case DDF_RAID5_N_CONTINUE
:
1889 return ALGORITHM_ROTATING_N_CONTINUE
;
1899 unsigned long long start
, size
;
1901 static int cmp_extent(const void *av
, const void *bv
)
1903 const struct extent
*a
= av
;
1904 const struct extent
*b
= bv
;
1905 if (a
->start
< b
->start
)
1907 if (a
->start
> b
->start
)
1912 static struct extent
*get_extents(struct ddf_super
*ddf
, struct dl
*dl
)
1914 /* find a list of used extents on the give physical device
1915 * (dnum) of the given ddf.
1916 * Return a malloced array of 'struct extent'
1918 FIXME ignore DDF_Legacy devices?
1925 rv
= malloc(sizeof(struct extent
) * (ddf
->max_part
+ 2));
1929 for (i
= 0; i
< ddf
->max_part
; i
++) {
1930 struct vcl
*v
= dl
->vlist
[i
];
1933 for (j
= 0; j
< v
->conf
.prim_elmnt_count
; j
++)
1934 if (v
->conf
.phys_refnum
[j
] == dl
->disk
.refnum
) {
1935 /* This device plays role 'j' in 'v'. */
1936 rv
[n
].start
= __be64_to_cpu(v
->lba_offset
[j
]);
1937 rv
[n
].size
= __be64_to_cpu(v
->conf
.blocks
);
1942 qsort(rv
, n
, sizeof(*rv
), cmp_extent
);
1944 rv
[n
].start
= __be64_to_cpu(ddf
->phys
->entries
[dl
->pdnum
].config_size
);
1950 static int init_super_ddf_bvd(struct supertype
*st
,
1951 mdu_array_info_t
*info
,
1952 unsigned long long size
,
1953 char *name
, char *homehost
,
1956 /* We are creating a BVD inside a pre-existing container.
1957 * so st->sb is already set.
1958 * We need to create a new vd_config and a new virtual_entry
1960 struct ddf_super
*ddf
= st
->sb
;
1962 struct virtual_entry
*ve
;
1964 struct vd_config
*vc
;
1966 if (__be16_to_cpu(ddf
->virt
->populated_vdes
)
1967 >= __be16_to_cpu(ddf
->virt
->max_vdes
)) {
1968 fprintf(stderr
, Name
": This ddf already has the "
1969 "maximum of %d virtual devices\n",
1970 __be16_to_cpu(ddf
->virt
->max_vdes
));
1975 for (venum
= 0; venum
< __be16_to_cpu(ddf
->virt
->max_vdes
); venum
++)
1976 if (!all_ff(ddf
->virt
->entries
[venum
].guid
)) {
1977 char *n
= ddf
->virt
->entries
[venum
].name
;
1979 if (strncmp(name
, n
, 16) == 0) {
1980 fprintf(stderr
, Name
": This ddf already"
1981 " has an array called %s\n",
1987 for (venum
= 0; venum
< __be16_to_cpu(ddf
->virt
->max_vdes
); venum
++)
1988 if (all_ff(ddf
->virt
->entries
[venum
].guid
))
1990 if (venum
== __be16_to_cpu(ddf
->virt
->max_vdes
)) {
1991 fprintf(stderr
, Name
": Cannot find spare slot for "
1992 "virtual disk - DDF is corrupt\n");
1995 ve
= &ddf
->virt
->entries
[venum
];
1997 /* A Virtual Disk GUID contains the T10 Vendor ID, controller type,
1998 * timestamp, random number
2000 make_header_guid(ve
->guid
);
2001 ve
->unit
= __cpu_to_be16(info
->md_minor
);
2003 ve
->guid_crc
= crc32(0, (unsigned char*)ddf
->anchor
.guid
, DDF_GUID_LEN
);
2005 ve
->state
= DDF_state_degraded
; /* Will be modified as devices are added */
2006 if (info
->state
& 1) /* clean */
2007 ve
->init_state
= DDF_init_full
;
2009 ve
->init_state
= DDF_init_not
;
2011 memset(ve
->pad1
, 0xff, 14);
2012 memset(ve
->name
, ' ', 16);
2014 strncpy(ve
->name
, name
, 16);
2015 ddf
->virt
->populated_vdes
=
2016 __cpu_to_be16(__be16_to_cpu(ddf
->virt
->populated_vdes
)+1);
2018 /* Now create a new vd_config */
2019 if (posix_memalign((void**)&vcl
, 512,
2020 (offsetof(struct vcl
, conf
) + ddf
->conf_rec_len
* 512)) != 0) {
2021 fprintf(stderr
, Name
": %s could not allocate vd_config\n", __func__
);
2024 vcl
->lba_offset
= (__u64
*) &vcl
->conf
.phys_refnum
[ddf
->mppe
];
2026 sprintf(st
->subarray
, "%d", venum
);
2027 vcl
->block_sizes
= NULL
; /* FIXME not for CONCAT */
2031 vc
->magic
= DDF_VD_CONF_MAGIC
;
2032 memcpy(vc
->guid
, ve
->guid
, DDF_GUID_LEN
);
2033 vc
->timestamp
= __cpu_to_be32(time(0)-DECADE
);
2034 vc
->seqnum
= __cpu_to_be32(1);
2035 memset(vc
->pad0
, 0xff, 24);
2036 vc
->prim_elmnt_count
= __cpu_to_be16(info
->raid_disks
);
2037 vc
->chunk_shift
= chunk_to_shift(info
->chunk_size
);
2038 vc
->prl
= level_to_prl(info
->level
);
2039 vc
->rlq
= layout_to_rlq(info
->level
, info
->layout
, info
->raid_disks
);
2040 vc
->sec_elmnt_count
= 1;
2041 vc
->sec_elmnt_seq
= 0;
2043 vc
->blocks
= __cpu_to_be64(info
->size
* 2);
2044 vc
->array_blocks
= __cpu_to_be64(
2045 calc_array_size(info
->level
, info
->raid_disks
, info
->layout
,
2046 info
->chunk_size
, info
->size
*2));
2047 memset(vc
->pad1
, 0xff, 8);
2048 vc
->spare_refs
[0] = 0xffffffff;
2049 vc
->spare_refs
[1] = 0xffffffff;
2050 vc
->spare_refs
[2] = 0xffffffff;
2051 vc
->spare_refs
[3] = 0xffffffff;
2052 vc
->spare_refs
[4] = 0xffffffff;
2053 vc
->spare_refs
[5] = 0xffffffff;
2054 vc
->spare_refs
[6] = 0xffffffff;
2055 vc
->spare_refs
[7] = 0xffffffff;
2056 memset(vc
->cache_pol
, 0, 8);
2058 memset(vc
->pad2
, 0xff, 3);
2059 memset(vc
->pad3
, 0xff, 52);
2060 memset(vc
->pad4
, 0xff, 192);
2061 memset(vc
->v0
, 0xff, 32);
2062 memset(vc
->v1
, 0xff, 32);
2063 memset(vc
->v2
, 0xff, 16);
2064 memset(vc
->v3
, 0xff, 16);
2065 memset(vc
->vendor
, 0xff, 32);
2067 memset(vc
->phys_refnum
, 0xff, 4*ddf
->mppe
);
2068 memset(vc
->phys_refnum
+ddf
->mppe
, 0x00, 8*ddf
->mppe
);
2070 vcl
->next
= ddf
->conflist
;
2071 ddf
->conflist
= vcl
;
2072 ddf
->currentconf
= vcl
;
2073 ddf
->updates_pending
= 1;
2078 static void add_to_super_ddf_bvd(struct supertype
*st
,
2079 mdu_disk_info_t
*dk
, int fd
, char *devname
)
2081 /* fd and devname identify a device with-in the ddf container (st).
2082 * dk identifies a location in the new BVD.
2083 * We need to find suitable free space in that device and update
2084 * the phys_refnum and lba_offset for the newly created vd_config.
2085 * We might also want to update the type in the phys_disk
2088 * Alternately: fd == -1 and we have already chosen which device to
2089 * use and recorded in dlist->raid_disk;
2092 struct ddf_super
*ddf
= st
->sb
;
2093 struct vd_config
*vc
;
2095 unsigned int working
;
2097 unsigned long long blocks
, pos
, esize
;
2101 for (dl
= ddf
->dlist
; dl
; dl
= dl
->next
)
2102 if (dl
->raiddisk
== dk
->raid_disk
)
2105 for (dl
= ddf
->dlist
; dl
; dl
= dl
->next
)
2106 if (dl
->major
== dk
->major
&&
2107 dl
->minor
== dk
->minor
)
2110 if (!dl
|| ! (dk
->state
& (1<<MD_DISK_SYNC
)))
2113 vc
= &ddf
->currentconf
->conf
;
2114 lba_offset
= ddf
->currentconf
->lba_offset
;
2116 ex
= get_extents(ddf
, dl
);
2121 blocks
= __be64_to_cpu(vc
->blocks
);
2122 if (ddf
->currentconf
->block_sizes
)
2123 blocks
= ddf
->currentconf
->block_sizes
[dk
->raid_disk
];
2126 esize
= ex
[i
].start
- pos
;
2127 if (esize
>= blocks
)
2129 pos
= ex
[i
].start
+ ex
[i
].size
;
2131 } while (ex
[i
-1].size
);
2137 ddf
->currentdev
= dk
->raid_disk
;
2138 vc
->phys_refnum
[dk
->raid_disk
] = dl
->disk
.refnum
;
2139 lba_offset
[dk
->raid_disk
] = __cpu_to_be64(pos
);
2141 for (i
= 0; i
< ddf
->max_part
; i
++)
2142 if (dl
->vlist
[i
] == NULL
)
2144 if (i
== ddf
->max_part
)
2146 dl
->vlist
[i
] = ddf
->currentconf
;
2151 dl
->devname
= devname
;
2153 /* Check how many working raid_disks, and if we can mark
2154 * array as optimal yet
2158 for (i
= 0; i
< __be16_to_cpu(vc
->prim_elmnt_count
); i
++)
2159 if (vc
->phys_refnum
[i
] != 0xffffffff)
2162 /* Find which virtual_entry */
2163 i
= ddf
->currentconf
->vcnum
;
2164 if (working
== __be16_to_cpu(vc
->prim_elmnt_count
))
2165 ddf
->virt
->entries
[i
].state
=
2166 (ddf
->virt
->entries
[i
].state
& ~DDF_state_mask
)
2167 | DDF_state_optimal
;
2169 if (vc
->prl
== DDF_RAID6
&&
2170 working
+1 == __be16_to_cpu(vc
->prim_elmnt_count
))
2171 ddf
->virt
->entries
[i
].state
=
2172 (ddf
->virt
->entries
[i
].state
& ~DDF_state_mask
)
2173 | DDF_state_part_optimal
;
2175 ddf
->phys
->entries
[dl
->pdnum
].type
&= ~__cpu_to_be16(DDF_Global_Spare
);
2176 ddf
->phys
->entries
[dl
->pdnum
].type
|= __cpu_to_be16(DDF_Active_in_VD
);
2177 ddf
->updates_pending
= 1;
2180 /* add a device to a container, either while creating it or while
2181 * expanding a pre-existing container
2183 static int add_to_super_ddf(struct supertype
*st
,
2184 mdu_disk_info_t
*dk
, int fd
, char *devname
)
2186 struct ddf_super
*ddf
= st
->sb
;
2190 unsigned long long size
;
2191 struct phys_disk_entry
*pde
;
2195 if (ddf
->currentconf
) {
2196 add_to_super_ddf_bvd(st
, dk
, fd
, devname
);
2200 /* This is device numbered dk->number. We need to create
2201 * a phys_disk entry and a more detailed disk_data entry.
2204 if (posix_memalign((void**)&dd
, 512,
2205 sizeof(*dd
) + sizeof(dd
->vlist
[0]) * ddf
->max_part
) != 0) {
2206 fprintf(stderr
, Name
2207 ": %s could allocate buffer for new disk, aborting\n",
2211 dd
->major
= major(stb
.st_rdev
);
2212 dd
->minor
= minor(stb
.st_rdev
);
2213 dd
->devname
= devname
;
2217 dd
->disk
.magic
= DDF_PHYS_DATA_MAGIC
;
2219 tm
= localtime(&now
);
2220 sprintf(dd
->disk
.guid
, "%8s%04d%02d%02d",
2221 T10
, tm
->tm_year
+1900, tm
->tm_mon
+1, tm
->tm_mday
);
2222 *(__u32
*)(dd
->disk
.guid
+ 16) = random32();
2223 *(__u32
*)(dd
->disk
.guid
+ 20) = random32();
2226 /* Cannot be bothered finding a CRC of some irrelevant details*/
2227 dd
->disk
.refnum
= random32();
2228 for (i
= __be16_to_cpu(ddf
->active
->max_pd_entries
);
2230 if (ddf
->phys
->entries
[i
-1].refnum
== dd
->disk
.refnum
)
2234 dd
->disk
.forced_ref
= 1;
2235 dd
->disk
.forced_guid
= 1;
2236 memset(dd
->disk
.vendor
, ' ', 32);
2237 memcpy(dd
->disk
.vendor
, "Linux", 5);
2238 memset(dd
->disk
.pad
, 0xff, 442);
2239 for (i
= 0; i
< ddf
->max_part
; i
++)
2240 dd
->vlist
[i
] = NULL
;
2242 n
= __be16_to_cpu(ddf
->phys
->used_pdes
);
2243 pde
= &ddf
->phys
->entries
[n
];
2246 if (st
->update_tail
) {
2247 int len
= (sizeof(struct phys_disk
) +
2248 sizeof(struct phys_disk_entry
));
2249 struct phys_disk
*pd
;
2252 pd
->magic
= DDF_PHYS_RECORDS_MAGIC
;
2253 pd
->used_pdes
= __cpu_to_be16(n
);
2254 pde
= &pd
->entries
[0];
2258 ddf
->phys
->used_pdes
= __cpu_to_be16(n
);
2261 memcpy(pde
->guid
, dd
->disk
.guid
, DDF_GUID_LEN
);
2262 pde
->refnum
= dd
->disk
.refnum
;
2263 pde
->type
= __cpu_to_be16(DDF_Forced_PD_GUID
| DDF_Global_Spare
);
2264 pde
->state
= __cpu_to_be16(DDF_Online
);
2265 get_dev_size(fd
, NULL
, &size
);
2266 /* We are required to reserve 32Meg, and record the size in sectors */
2267 pde
->config_size
= __cpu_to_be64( (size
- 32*1024*1024) / 512);
2268 sprintf(pde
->path
, "%17.17s","Information: nil") ;
2269 memset(pde
->pad
, 0xff, 6);
2271 dd
->size
= size
>> 9;
2272 if (st
->update_tail
) {
2273 dd
->next
= ddf
->add_list
;
2276 dd
->next
= ddf
->dlist
;
2278 ddf
->updates_pending
= 1;
2285 * This is the write_init_super method for a ddf container. It is
2286 * called when creating a container or adding another device to a
2290 static unsigned char null_conf
[4096+512];
2292 static int __write_init_super_ddf(struct supertype
*st
, int do_close
)
2295 struct ddf_super
*ddf
= st
->sb
;
2302 unsigned long long size
, sector
;
2304 /* try to write updated metadata,
2305 * if we catch a failure move on to the next disk
2307 for (d
= ddf
->dlist
; d
; d
=d
->next
) {
2314 /* We need to fill in the primary, (secondary) and workspace
2315 * lba's in the headers, set their checksums,
2316 * Also checksum phys, virt....
2318 * Then write everything out, finally the anchor is written.
2320 get_dev_size(fd
, NULL
, &size
);
2322 ddf
->anchor
.workspace_lba
= __cpu_to_be64(size
- 32*1024*2);
2323 ddf
->anchor
.primary_lba
= __cpu_to_be64(size
- 16*1024*2);
2324 ddf
->anchor
.seq
= __cpu_to_be32(1);
2325 memcpy(&ddf
->primary
, &ddf
->anchor
, 512);
2326 memcpy(&ddf
->secondary
, &ddf
->anchor
, 512);
2328 ddf
->anchor
.openflag
= 0xFF; /* 'open' means nothing */
2329 ddf
->anchor
.seq
= 0xFFFFFFFF; /* no sequencing in anchor */
2330 ddf
->anchor
.crc
= calc_crc(&ddf
->anchor
, 512);
2332 ddf
->primary
.openflag
= 0;
2333 ddf
->primary
.type
= DDF_HEADER_PRIMARY
;
2335 ddf
->secondary
.openflag
= 0;
2336 ddf
->secondary
.type
= DDF_HEADER_SECONDARY
;
2338 ddf
->primary
.crc
= calc_crc(&ddf
->primary
, 512);
2339 ddf
->secondary
.crc
= calc_crc(&ddf
->secondary
, 512);
2341 sector
= size
- 16*1024*2;
2342 lseek64(fd
, sector
<<9, 0);
2343 if (write(fd
, &ddf
->primary
, 512) < 0)
2346 ddf
->controller
.crc
= calc_crc(&ddf
->controller
, 512);
2347 if (write(fd
, &ddf
->controller
, 512) < 0)
2350 ddf
->phys
->crc
= calc_crc(ddf
->phys
, ddf
->pdsize
);
2352 if (write(fd
, ddf
->phys
, ddf
->pdsize
) < 0)
2355 ddf
->virt
->crc
= calc_crc(ddf
->virt
, ddf
->vdsize
);
2356 if (write(fd
, ddf
->virt
, ddf
->vdsize
) < 0)
2359 /* Now write lots of config records. */
2360 n_config
= ddf
->max_part
;
2361 conf_size
= ddf
->conf_rec_len
* 512;
2362 for (i
= 0 ; i
<= n_config
; i
++) {
2363 struct vcl
*c
= d
->vlist
[i
];
2365 c
= (struct vcl
*)d
->spare
;
2368 c
->conf
.crc
= calc_crc(&c
->conf
, conf_size
);
2369 if (write(fd
, &c
->conf
, conf_size
) < 0)
2372 char *null_aligned
= (char*)((((unsigned long)null_conf
)+511)&~511UL);
2373 if (null_conf
[0] != 0xff)
2374 memset(null_conf
, 0xff, sizeof(null_conf
));
2375 unsigned int togo
= conf_size
;
2376 while (togo
> sizeof(null_conf
)-512) {
2377 if (write(fd
, null_aligned
, sizeof(null_conf
)-512) < 0)
2379 togo
-= sizeof(null_conf
)-512;
2381 if (write(fd
, null_aligned
, togo
) < 0)
2387 d
->disk
.crc
= calc_crc(&d
->disk
, 512);
2388 if (write(fd
, &d
->disk
, 512) < 0)
2391 /* Maybe do the same for secondary */
2393 lseek64(fd
, (size
-1)*512, SEEK_SET
);
2394 if (write(fd
, &ddf
->anchor
, 512) < 0)
2400 for (d
= ddf
->dlist
; d
; d
=d
->next
) {
2405 return attempts
!= successes
;
2408 static int write_init_super_ddf(struct supertype
*st
)
2410 struct ddf_super
*ddf
= st
->sb
;
2411 struct vcl
*currentconf
= ddf
->currentconf
;
2413 /* we are done with currentconf reset it to point st at the container */
2414 ddf
->currentconf
= NULL
;
2416 if (st
->update_tail
) {
2417 /* queue the virtual_disk and vd_config as metadata updates */
2418 struct virtual_disk
*vd
;
2419 struct vd_config
*vc
;
2423 int len
= (sizeof(struct phys_disk
) +
2424 sizeof(struct phys_disk_entry
));
2426 /* adding a disk to the container. */
2430 append_metadata_update(st
, ddf
->add_list
->mdupdate
, len
);
2431 ddf
->add_list
->mdupdate
= NULL
;
2435 /* Newly created VD */
2437 /* First the virtual disk. We have a slightly fake header */
2438 len
= sizeof(struct virtual_disk
) + sizeof(struct virtual_entry
);
2441 vd
->entries
[0] = ddf
->virt
->entries
[currentconf
->vcnum
];
2442 vd
->populated_vdes
= __cpu_to_be16(currentconf
->vcnum
);
2443 append_metadata_update(st
, vd
, len
);
2445 /* Then the vd_config */
2446 len
= ddf
->conf_rec_len
* 512;
2448 memcpy(vc
, ¤tconf
->conf
, len
);
2449 append_metadata_update(st
, vc
, len
);
2451 /* FIXME I need to close the fds! */
2455 for (d
= ddf
->dlist
; d
; d
=d
->next
)
2456 while (Kill(d
->devname
, NULL
, 0, 1, 1) == 0);
2457 return __write_init_super_ddf(st
, 1);
2463 static __u64
avail_size_ddf(struct supertype
*st
, __u64 devsize
)
2465 /* We must reserve the last 32Meg */
2466 if (devsize
<= 32*1024*2)
2468 return devsize
- 32*1024*2;
2473 static int reserve_space(struct supertype
*st
, int raiddisks
,
2474 unsigned long long size
, int chunk
,
2475 unsigned long long *freesize
)
2477 /* Find 'raiddisks' spare extents at least 'size' big (but
2478 * only caring about multiples of 'chunk') and remember
2480 * If the cannot be found, fail.
2483 struct ddf_super
*ddf
= st
->sb
;
2486 for (dl
= ddf
->dlist
; dl
; dl
=dl
->next
) {
2490 /* Now find largest extent on each device */
2491 for (dl
= ddf
->dlist
; dl
; dl
=dl
->next
) {
2492 struct extent
*e
= get_extents(ddf
, dl
);
2493 unsigned long long pos
= 0;
2496 unsigned long long minsize
= size
;
2504 unsigned long long esize
;
2505 esize
= e
[i
].start
- pos
;
2506 if (esize
>= minsize
) {
2510 pos
= e
[i
].start
+ e
[i
].size
;
2512 } while (e
[i
-1].size
);
2515 dl
->esize
= minsize
;
2519 if (cnt
< raiddisks
) {
2520 fprintf(stderr
, Name
": not enough devices with space to create array.\n");
2521 return 0; /* No enough free spaces large enough */
2524 /* choose the largest size of which there are at least 'raiddisk' */
2525 for (dl
= ddf
->dlist
; dl
; dl
=dl
->next
) {
2527 if (dl
->esize
<= size
)
2529 /* This is bigger than 'size', see if there are enough */
2531 for (dl2
= dl
; dl2
; dl2
=dl2
->next
)
2532 if (dl2
->esize
>= dl
->esize
)
2534 if (cnt
>= raiddisks
)
2538 size
= size
/ chunk
;
2543 fprintf(stderr
, Name
": not enough spare devices to create array.\n");
2547 /* We have a 'size' of which there are enough spaces.
2548 * We simply do a first-fit */
2550 for (dl
= ddf
->dlist
; dl
&& cnt
< raiddisks
; dl
=dl
->next
) {
2551 if (dl
->esize
< size
)
2563 validate_geometry_ddf_container(struct supertype
*st
,
2564 int level
, int layout
, int raiddisks
,
2565 int chunk
, unsigned long long size
,
2566 char *dev
, unsigned long long *freesize
,
2569 static int validate_geometry_ddf_bvd(struct supertype
*st
,
2570 int level
, int layout
, int raiddisks
,
2571 int chunk
, unsigned long long size
,
2572 char *dev
, unsigned long long *freesize
,
2575 static int validate_geometry_ddf(struct supertype
*st
,
2576 int level
, int layout
, int raiddisks
,
2577 int chunk
, unsigned long long size
,
2578 char *dev
, unsigned long long *freesize
,
2585 /* ddf potentially supports lots of things, but it depends on
2586 * what devices are offered (and maybe kernel version?)
2587 * If given unused devices, we will make a container.
2588 * If given devices in a container, we will make a BVD.
2589 * If given BVDs, we make an SVD, changing all the GUIDs in the process.
2592 if (level
== LEVEL_CONTAINER
) {
2593 /* Must be a fresh device to add to a container */
2594 return validate_geometry_ddf_container(st
, level
, layout
,
2596 size
, dev
, freesize
,
2601 /* Initial sanity check. Exclude illegal levels. */
2603 for (i
=0; ddf_level_num
[i
].num1
!= MAXINT
; i
++)
2604 if (ddf_level_num
[i
].num2
== level
)
2606 if (ddf_level_num
[i
].num1
== MAXINT
) {
2608 fprintf(stderr
, Name
": DDF does not support level %d arrays\n",
2612 /* Should check layout? etc */
2614 if (st
->sb
&& freesize
) {
2615 /* --create was given a container to create in.
2616 * So we need to check that there are enough
2617 * free spaces and return the amount of space.
2618 * We may as well remember which drives were
2619 * chosen so that add_to_super/getinfo_super
2622 return reserve_space(st
, raiddisks
, size
, chunk
, freesize
);
2628 /* A container has already been opened, so we are
2629 * creating in there. Maybe a BVD, maybe an SVD.
2630 * Should make a distinction one day.
2632 return validate_geometry_ddf_bvd(st
, level
, layout
, raiddisks
,
2633 chunk
, size
, dev
, freesize
,
2636 /* This is the first device for the array.
2637 * If it is a container, we read it in and do automagic allocations,
2638 * no other devices should be given.
2639 * Otherwise it must be a member device of a container, and we
2640 * do manual allocation.
2641 * Later we should check for a BVD and make an SVD.
2643 fd
= open(dev
, O_RDONLY
|O_EXCL
, 0);
2645 sra
= sysfs_read(fd
, 0, GET_VERSION
);
2647 if (sra
&& sra
->array
.major_version
== -1 &&
2648 strcmp(sra
->text_version
, "ddf") == 0) {
2651 /* find space for 'n' devices. */
2652 /* remember the devices */
2653 /* Somehow return the fact that we have enough */
2658 Name
": ddf: Cannot create this array "
2659 "on device %s - a container is required.\n",
2663 if (errno
!= EBUSY
|| (fd
= open(dev
, O_RDONLY
, 0)) < 0) {
2665 fprintf(stderr
, Name
": ddf: Cannot open %s: %s\n",
2666 dev
, strerror(errno
));
2669 /* Well, it is in use by someone, maybe a 'ddf' container. */
2670 cfd
= open_container(fd
);
2674 fprintf(stderr
, Name
": ddf: Cannot use %s: %s\n",
2675 dev
, strerror(EBUSY
));
2678 sra
= sysfs_read(cfd
, 0, GET_VERSION
);
2680 if (sra
&& sra
->array
.major_version
== -1 &&
2681 strcmp(sra
->text_version
, "ddf") == 0) {
2682 /* This is a member of a ddf container. Load the container
2683 * and try to create a bvd
2685 struct ddf_super
*ddf
;
2686 if (load_super_ddf_all(st
, cfd
, (void **)&ddf
, NULL
, 1) == 0) {
2688 st
->container_dev
= fd2devnum(cfd
);
2690 return validate_geometry_ddf_bvd(st
, level
, layout
,
2691 raiddisks
, chunk
, size
,
2696 } else /* device may belong to a different container */
2703 validate_geometry_ddf_container(struct supertype
*st
,
2704 int level
, int layout
, int raiddisks
,
2705 int chunk
, unsigned long long size
,
2706 char *dev
, unsigned long long *freesize
,
2710 unsigned long long ldsize
;
2712 if (level
!= LEVEL_CONTAINER
)
2717 fd
= open(dev
, O_RDONLY
|O_EXCL
, 0);
2720 fprintf(stderr
, Name
": ddf: Cannot open %s: %s\n",
2721 dev
, strerror(errno
));
2724 if (!get_dev_size(fd
, dev
, &ldsize
)) {
2730 *freesize
= avail_size_ddf(st
, ldsize
>> 9);
2737 static int validate_geometry_ddf_bvd(struct supertype
*st
,
2738 int level
, int layout
, int raiddisks
,
2739 int chunk
, unsigned long long size
,
2740 char *dev
, unsigned long long *freesize
,
2744 struct ddf_super
*ddf
= st
->sb
;
2746 unsigned long long pos
= 0;
2747 unsigned long long maxsize
;
2750 /* ddf/bvd supports lots of things, but not containers */
2751 if (level
== LEVEL_CONTAINER
) {
2753 fprintf(stderr
, Name
": DDF cannot create a container within an container\n");
2756 /* We must have the container info already read in. */
2761 /* General test: make sure there is space for
2762 * 'raiddisks' device extents of size 'size'.
2764 unsigned long long minsize
= size
;
2768 for (dl
= ddf
->dlist
; dl
; dl
= dl
->next
)
2774 e
= get_extents(ddf
, dl
);
2777 unsigned long long esize
;
2778 esize
= e
[i
].start
- pos
;
2779 if (esize
>= minsize
)
2781 pos
= e
[i
].start
+ e
[i
].size
;
2783 } while (e
[i
-1].size
);
2788 if (dcnt
< raiddisks
) {
2791 Name
": ddf: Not enough devices with "
2792 "space for this array (%d < %d)\n",
2798 /* This device must be a member of the set */
2799 if (stat(dev
, &stb
) < 0)
2801 if ((S_IFMT
& stb
.st_mode
) != S_IFBLK
)
2803 for (dl
= ddf
->dlist
; dl
; dl
= dl
->next
) {
2804 if (dl
->major
== (int)major(stb
.st_rdev
) &&
2805 dl
->minor
== (int)minor(stb
.st_rdev
))
2810 fprintf(stderr
, Name
": ddf: %s is not in the "
2815 e
= get_extents(ddf
, dl
);
2819 unsigned long long esize
;
2820 esize
= e
[i
].start
- pos
;
2821 if (esize
>= maxsize
)
2823 pos
= e
[i
].start
+ e
[i
].size
;
2825 } while (e
[i
-1].size
);
2826 *freesize
= maxsize
;
2832 static int load_super_ddf_all(struct supertype
*st
, int fd
,
2833 void **sbp
, char *devname
, int keep_fd
)
2836 struct ddf_super
*super
;
2837 struct mdinfo
*sd
, *best
= NULL
;
2843 sra
= sysfs_read(fd
, 0, GET_LEVEL
|GET_VERSION
|GET_DEVS
|GET_STATE
);
2846 if (sra
->array
.major_version
!= -1 ||
2847 sra
->array
.minor_version
!= -2 ||
2848 strcmp(sra
->text_version
, "ddf") != 0)
2851 if (posix_memalign((void**)&super
, 512, sizeof(*super
)) != 0)
2853 memset(super
, 0, sizeof(*super
));
2855 /* first, try each device, and choose the best ddf */
2856 for (sd
= sra
->devs
; sd
; sd
= sd
->next
) {
2858 sprintf(nm
, "%d:%d", sd
->disk
.major
, sd
->disk
.minor
);
2859 dfd
= dev_open(nm
, O_RDONLY
);
2862 rv
= load_ddf_headers(dfd
, super
, NULL
);
2865 seq
= __be32_to_cpu(super
->active
->seq
);
2866 if (super
->active
->openflag
)
2868 if (!best
|| seq
> bestseq
) {
2876 /* OK, load this ddf */
2877 sprintf(nm
, "%d:%d", best
->disk
.major
, best
->disk
.minor
);
2878 dfd
= dev_open(nm
, O_RDONLY
);
2881 load_ddf_headers(dfd
, super
, NULL
);
2882 load_ddf_global(dfd
, super
, NULL
);
2884 /* Now we need the device-local bits */
2885 for (sd
= sra
->devs
; sd
; sd
= sd
->next
) {
2888 sprintf(nm
, "%d:%d", sd
->disk
.major
, sd
->disk
.minor
);
2889 dfd
= dev_open(nm
, keep_fd
? O_RDWR
: O_RDONLY
);
2892 rv
= load_ddf_headers(dfd
, super
, NULL
);
2894 rv
= load_ddf_local(dfd
, super
, NULL
, keep_fd
);
2895 if (!keep_fd
) close(dfd
);
2899 if (st
->subarray
[0]) {
2904 val
= strtoul(st
->subarray
, &ep
, 10);
2910 for (v
= super
->conflist
; v
; v
= v
->next
)
2911 if (v
->vcnum
== val
)
2912 super
->currentconf
= v
;
2913 if (!super
->currentconf
) {
2920 if (st
->ss
== NULL
) {
2921 st
->ss
= &super_ddf
;
2922 st
->minor_version
= 0;
2924 st
->container_dev
= fd2devnum(fd
);
2926 st
->loaded_container
= 1;
2929 #endif /* MDASSEMBLE */
2931 static struct mdinfo
*container_content_ddf(struct supertype
*st
)
2933 /* Given a container loaded by load_super_ddf_all,
2934 * extract information about all the arrays into
2937 * For each vcl in conflist: create an mdinfo, fill it in,
2938 * then look for matching devices (phys_refnum) in dlist
2939 * and create appropriate device mdinfo.
2941 struct ddf_super
*ddf
= st
->sb
;
2942 struct mdinfo
*rest
= NULL
;
2945 for (vc
= ddf
->conflist
; vc
; vc
=vc
->next
)
2949 struct mdinfo
*this;
2950 this = malloc(sizeof(*this));
2951 memset(this, 0, sizeof(*this));
2955 this->array
.level
= map_num1(ddf_level_num
, vc
->conf
.prl
);
2956 this->array
.raid_disks
=
2957 __be16_to_cpu(vc
->conf
.prim_elmnt_count
);
2958 this->array
.layout
= rlq_to_layout(vc
->conf
.rlq
, vc
->conf
.prl
,
2959 this->array
.raid_disks
);
2960 this->array
.md_minor
= -1;
2961 this->array
.major_version
= -1;
2962 this->array
.minor_version
= -2;
2963 this->array
.ctime
= DECADE
+
2964 __be32_to_cpu(*(__u32
*)(vc
->conf
.guid
+16));
2965 this->array
.utime
= DECADE
+
2966 __be32_to_cpu(vc
->conf
.timestamp
);
2967 this->array
.chunk_size
= 512 << vc
->conf
.chunk_shift
;
2970 if ((ddf
->virt
->entries
[i
].state
& DDF_state_inconsistent
) ||
2971 (ddf
->virt
->entries
[i
].init_state
& DDF_initstate_mask
) !=
2973 this->array
.state
= 0;
2974 this->resync_start
= 0;
2976 this->array
.state
= 1;
2977 this->resync_start
= MaxSector
;
2979 memcpy(this->name
, ddf
->virt
->entries
[i
].name
, 16);
2982 if (this->name
[j
] == ' ')
2985 memset(this->uuid
, 0, sizeof(this->uuid
));
2986 this->component_size
= __be64_to_cpu(vc
->conf
.blocks
);
2987 this->array
.size
= this->component_size
/ 2;
2988 this->container_member
= i
;
2990 ddf
->currentconf
= vc
;
2991 uuid_from_super_ddf(st
, this->uuid
);
2992 ddf
->currentconf
= NULL
;
2994 sprintf(this->text_version
, "/%s/%d",
2995 devnum2devname(st
->container_dev
),
2996 this->container_member
);
2998 for (i
= 0 ; i
< ddf
->mppe
; i
++) {
3003 if (vc
->conf
.phys_refnum
[i
] == 0xFFFFFFFF)
3006 for (d
= ddf
->dlist
; d
; d
=d
->next
)
3007 if (d
->disk
.refnum
== vc
->conf
.phys_refnum
[i
])
3010 /* Haven't found that one yet, maybe there are others */
3012 stt
= __be16_to_cpu(ddf
->phys
->entries
[d
->pdnum
].state
);
3013 if ((stt
& (DDF_Online
|DDF_Failed
|DDF_Rebuilding
))
3017 this->array
.working_disks
++;
3019 dev
= malloc(sizeof(*dev
));
3020 memset(dev
, 0, sizeof(*dev
));
3021 dev
->next
= this->devs
;
3024 dev
->disk
.number
= __be32_to_cpu(d
->disk
.refnum
);
3025 dev
->disk
.major
= d
->major
;
3026 dev
->disk
.minor
= d
->minor
;
3027 dev
->disk
.raid_disk
= i
;
3028 dev
->disk
.state
= (1<<MD_DISK_SYNC
)|(1<<MD_DISK_ACTIVE
);
3029 dev
->recovery_start
= MaxSector
;
3031 dev
->events
= __be32_to_cpu(ddf
->primary
.seq
);
3032 dev
->data_offset
= __be64_to_cpu(vc
->lba_offset
[i
]);
3033 dev
->component_size
= __be64_to_cpu(vc
->conf
.blocks
);
3035 strcpy(dev
->name
, d
->devname
);
3041 static int store_super_ddf(struct supertype
*st
, int fd
)
3043 struct ddf_super
*ddf
= st
->sb
;
3044 unsigned long long dsize
;
3051 /* ->dlist and ->conflist will be set for updates, currently not
3054 if (ddf
->dlist
|| ddf
->conflist
)
3057 if (!get_dev_size(fd
, NULL
, &dsize
))
3060 if (posix_memalign(&buf
, 512, 512) != 0)
3062 memset(buf
, 0, 512);
3064 lseek64(fd
, dsize
-512, 0);
3065 rc
= write(fd
, buf
, 512);
3072 static int compare_super_ddf(struct supertype
*st
, struct supertype
*tst
)
3076 * 0 same, or first was empty, and second was copied
3077 * 1 second had wrong number
3079 * 3 wrong other info
3081 struct ddf_super
*first
= st
->sb
;
3082 struct ddf_super
*second
= tst
->sb
;
3090 if (memcmp(first
->anchor
.guid
, second
->anchor
.guid
, DDF_GUID_LEN
) != 0)
3093 /* FIXME should I look at anything else? */
3099 * A new array 'a' has been started which claims to be instance 'inst'
3100 * within container 'c'.
3101 * We need to confirm that the array matches the metadata in 'c' so
3102 * that we don't corrupt any metadata.
3104 static int ddf_open_new(struct supertype
*c
, struct active_array
*a
, char *inst
)
3106 dprintf("ddf: open_new %s\n", inst
);
3107 a
->info
.container_member
= atoi(inst
);
3112 * The array 'a' is to be marked clean in the metadata.
3113 * If '->resync_start' is not ~(unsigned long long)0, then the array is only
3114 * clean up to the point (in sectors). If that cannot be recorded in the
3115 * metadata, then leave it as dirty.
3117 * For DDF, we need to clear the DDF_state_inconsistent bit in the
3118 * !global! virtual_disk.virtual_entry structure.
3120 static int ddf_set_array_state(struct active_array
*a
, int consistent
)
3122 struct ddf_super
*ddf
= a
->container
->sb
;
3123 int inst
= a
->info
.container_member
;
3124 int old
= ddf
->virt
->entries
[inst
].state
;
3125 if (consistent
== 2) {
3126 /* Should check if a recovery should be started FIXME */
3128 if (!is_resync_complete(&a
->info
))
3132 ddf
->virt
->entries
[inst
].state
&= ~DDF_state_inconsistent
;
3134 ddf
->virt
->entries
[inst
].state
|= DDF_state_inconsistent
;
3135 if (old
!= ddf
->virt
->entries
[inst
].state
)
3136 ddf
->updates_pending
= 1;
3138 old
= ddf
->virt
->entries
[inst
].init_state
;
3139 ddf
->virt
->entries
[inst
].init_state
&= ~DDF_initstate_mask
;
3140 if (is_resync_complete(&a
->info
))
3141 ddf
->virt
->entries
[inst
].init_state
|= DDF_init_full
;
3142 else if (a
->info
.resync_start
== 0)
3143 ddf
->virt
->entries
[inst
].init_state
|= DDF_init_not
;
3145 ddf
->virt
->entries
[inst
].init_state
|= DDF_init_quick
;
3146 if (old
!= ddf
->virt
->entries
[inst
].init_state
)
3147 ddf
->updates_pending
= 1;
3149 dprintf("ddf mark %d %s %llu\n", inst
, consistent
?"clean":"dirty",
3150 a
->info
.resync_start
);
3154 #define container_of(ptr, type, member) ({ \
3155 const typeof( ((type *)0)->member ) *__mptr = (ptr); \
3156 (type *)( (char *)__mptr - offsetof(type,member) );})
3158 * The state of each disk is stored in the global phys_disk structure
3159 * in phys_disk.entries[n].state.
3160 * This makes various combinations awkward.
3161 * - When a device fails in any array, it must be failed in all arrays
3162 * that include a part of this device.
3163 * - When a component is rebuilding, we cannot include it officially in the
3164 * array unless this is the only array that uses the device.
3166 * So: when transitioning:
3167 * Online -> failed, just set failed flag. monitor will propagate
3168 * spare -> online, the device might need to be added to the array.
3169 * spare -> failed, just set failed. Don't worry if in array or not.
3171 static void ddf_set_disk(struct active_array
*a
, int n
, int state
)
3173 struct ddf_super
*ddf
= a
->container
->sb
;
3174 unsigned int inst
= a
->info
.container_member
;
3175 struct vd_config
*vc
= find_vdcr(ddf
, inst
);
3176 int pd
= find_phys(ddf
, vc
->phys_refnum
[n
]);
3182 dprintf("ddf: cannot find instance %d!!\n", inst
);
3185 /* Find the matching slot in 'info'. */
3186 for (mdi
= a
->info
.devs
; mdi
; mdi
= mdi
->next
)
3187 if (mdi
->disk
.raid_disk
== n
)
3192 /* and find the 'dl' entry corresponding to that. */
3193 for (dl
= ddf
->dlist
; dl
; dl
= dl
->next
)
3194 if (mdi
->state_fd
>= 0 &&
3195 mdi
->disk
.major
== dl
->major
&&
3196 mdi
->disk
.minor
== dl
->minor
)
3201 if (pd
< 0 || pd
!= dl
->pdnum
) {
3202 /* disk doesn't currently exist or has changed.
3203 * If it is now in_sync, insert it. */
3204 if ((state
& DS_INSYNC
) && ! (state
& DS_FAULTY
)) {
3207 vc
->phys_refnum
[n
] = dl
->disk
.refnum
;
3208 vcl
= container_of(vc
, struct vcl
, conf
);
3209 vcl
->lba_offset
[n
] = mdi
->data_offset
;
3210 ddf
->phys
->entries
[pd
].type
&=
3211 ~__cpu_to_be16(DDF_Global_Spare
);
3212 ddf
->phys
->entries
[pd
].type
|=
3213 __cpu_to_be16(DDF_Active_in_VD
);
3214 ddf
->updates_pending
= 1;
3217 int old
= ddf
->phys
->entries
[pd
].state
;
3218 if (state
& DS_FAULTY
)
3219 ddf
->phys
->entries
[pd
].state
|= __cpu_to_be16(DDF_Failed
);
3220 if (state
& DS_INSYNC
) {
3221 ddf
->phys
->entries
[pd
].state
|= __cpu_to_be16(DDF_Online
);
3222 ddf
->phys
->entries
[pd
].state
&= __cpu_to_be16(~DDF_Rebuilding
);
3224 if (old
!= ddf
->phys
->entries
[pd
].state
)
3225 ddf
->updates_pending
= 1;
3228 dprintf("ddf: set_disk %d to %x\n", n
, state
);
3230 /* Now we need to check the state of the array and update
3231 * virtual_disk.entries[n].state.
3232 * It needs to be one of "optimal", "degraded", "failed".
3233 * I don't understand 'deleted' or 'missing'.
3236 for (i
=0; i
< a
->info
.array
.raid_disks
; i
++) {
3237 pd
= find_phys(ddf
, vc
->phys_refnum
[i
]);
3240 st
= __be16_to_cpu(ddf
->phys
->entries
[pd
].state
);
3241 if ((st
& (DDF_Online
|DDF_Failed
|DDF_Rebuilding
))
3245 state
= DDF_state_degraded
;
3246 if (working
== a
->info
.array
.raid_disks
)
3247 state
= DDF_state_optimal
;
3248 else switch(vc
->prl
) {
3252 state
= DDF_state_failed
;
3256 state
= DDF_state_failed
;
3260 if (working
< a
->info
.array
.raid_disks
-1)
3261 state
= DDF_state_failed
;
3264 if (working
< a
->info
.array
.raid_disks
-2)
3265 state
= DDF_state_failed
;
3266 else if (working
== a
->info
.array
.raid_disks
-1)
3267 state
= DDF_state_part_optimal
;
3271 if (ddf
->virt
->entries
[inst
].state
!=
3272 ((ddf
->virt
->entries
[inst
].state
& ~DDF_state_mask
)
3275 ddf
->virt
->entries
[inst
].state
=
3276 (ddf
->virt
->entries
[inst
].state
& ~DDF_state_mask
)
3278 ddf
->updates_pending
= 1;
3283 static void ddf_sync_metadata(struct supertype
*st
)
3287 * Write all data to all devices.
3288 * Later, we might be able to track whether only local changes
3289 * have been made, or whether any global data has been changed,
3290 * but ddf is sufficiently weird that it probably always
3291 * changes global data ....
3293 struct ddf_super
*ddf
= st
->sb
;
3294 if (!ddf
->updates_pending
)
3296 ddf
->updates_pending
= 0;
3297 __write_init_super_ddf(st
, 0);
3298 dprintf("ddf: sync_metadata\n");
3301 static void ddf_process_update(struct supertype
*st
,
3302 struct metadata_update
*update
)
3304 /* Apply this update to the metadata.
3305 * The first 4 bytes are a DDF_*_MAGIC which guides
3307 * Possible update are:
3308 * DDF_PHYS_RECORDS_MAGIC
3309 * Add a new physical device. Changes to this record
3310 * only happen implicitly.
3311 * used_pdes is the device number.
3312 * DDF_VIRT_RECORDS_MAGIC
3313 * Add a new VD. Possibly also change the 'access' bits.
3314 * populated_vdes is the entry number.
3316 * New or updated VD. the VIRT_RECORD must already
3317 * exist. For an update, phys_refnum and lba_offset
3318 * (at least) are updated, and the VD_CONF must
3319 * be written to precisely those devices listed with
3321 * DDF_SPARE_ASSIGN_MAGIC
3322 * replacement Spare Assignment Record... but for which device?
3325 * - to create a new array, we send a VIRT_RECORD and
3326 * a VD_CONF. Then assemble and start the array.
3327 * - to activate a spare we send a VD_CONF to add the phys_refnum
3328 * and offset. This will also mark the spare as active with
3329 * a spare-assignment record.
3331 struct ddf_super
*ddf
= st
->sb
;
3332 __u32
*magic
= (__u32
*)update
->buf
;
3333 struct phys_disk
*pd
;
3334 struct virtual_disk
*vd
;
3335 struct vd_config
*vc
;
3340 unsigned int pdnum
, pd2
;
3342 dprintf("Process update %x\n", *magic
);
3345 case DDF_PHYS_RECORDS_MAGIC
:
3347 if (update
->len
!= (sizeof(struct phys_disk
) +
3348 sizeof(struct phys_disk_entry
)))
3350 pd
= (struct phys_disk
*)update
->buf
;
3352 ent
= __be16_to_cpu(pd
->used_pdes
);
3353 if (ent
>= __be16_to_cpu(ddf
->phys
->max_pdes
))
3355 if (!all_ff(ddf
->phys
->entries
[ent
].guid
))
3357 ddf
->phys
->entries
[ent
] = pd
->entries
[0];
3358 ddf
->phys
->used_pdes
= __cpu_to_be16(1 +
3359 __be16_to_cpu(ddf
->phys
->used_pdes
));
3360 ddf
->updates_pending
= 1;
3361 if (ddf
->add_list
) {
3362 struct active_array
*a
;
3363 struct dl
*al
= ddf
->add_list
;
3364 ddf
->add_list
= al
->next
;
3366 al
->next
= ddf
->dlist
;
3369 /* As a device has been added, we should check
3370 * for any degraded devices that might make
3371 * use of this spare */
3372 for (a
= st
->arrays
; a
; a
=a
->next
)
3373 a
->check_degraded
= 1;
3377 case DDF_VIRT_RECORDS_MAGIC
:
3379 if (update
->len
!= (sizeof(struct virtual_disk
) +
3380 sizeof(struct virtual_entry
)))
3382 vd
= (struct virtual_disk
*)update
->buf
;
3384 ent
= __be16_to_cpu(vd
->populated_vdes
);
3385 if (ent
>= __be16_to_cpu(ddf
->virt
->max_vdes
))
3387 if (!all_ff(ddf
->virt
->entries
[ent
].guid
))
3389 ddf
->virt
->entries
[ent
] = vd
->entries
[0];
3390 ddf
->virt
->populated_vdes
= __cpu_to_be16(1 +
3391 __be16_to_cpu(ddf
->virt
->populated_vdes
));
3392 ddf
->updates_pending
= 1;
3395 case DDF_VD_CONF_MAGIC
:
3396 dprintf("len %d %d\n", update
->len
, ddf
->conf_rec_len
);
3398 mppe
= __be16_to_cpu(ddf
->anchor
.max_primary_element_entries
);
3399 if ((unsigned)update
->len
!= ddf
->conf_rec_len
* 512)
3401 vc
= (struct vd_config
*)update
->buf
;
3402 for (vcl
= ddf
->conflist
; vcl
; vcl
= vcl
->next
)
3403 if (memcmp(vcl
->conf
.guid
, vc
->guid
, DDF_GUID_LEN
) == 0)
3405 dprintf("vcl = %p\n", vcl
);
3407 /* An update, just copy the phys_refnum and lba_offset
3410 memcpy(vcl
->conf
.phys_refnum
, vc
->phys_refnum
,
3411 mppe
* (sizeof(__u32
) + sizeof(__u64
)));
3416 vcl
= update
->space
;
3417 update
->space
= NULL
;
3418 vcl
->next
= ddf
->conflist
;
3419 memcpy(&vcl
->conf
, vc
, update
->len
);
3420 vcl
->lba_offset
= (__u64
*)
3421 &vcl
->conf
.phys_refnum
[mppe
];
3423 ent
< __be16_to_cpu(ddf
->virt
->populated_vdes
);
3425 if (memcmp(vc
->guid
, ddf
->virt
->entries
[ent
].guid
,
3426 DDF_GUID_LEN
) == 0) {
3430 ddf
->conflist
= vcl
;
3432 /* Set DDF_Transition on all Failed devices - to help
3433 * us detect those that are no longer in use
3435 for (pdnum
= 0; pdnum
< __be16_to_cpu(ddf
->phys
->used_pdes
); pdnum
++)
3436 if (ddf
->phys
->entries
[pdnum
].state
3437 & __be16_to_cpu(DDF_Failed
))
3438 ddf
->phys
->entries
[pdnum
].state
3439 |= __be16_to_cpu(DDF_Transition
);
3440 /* Now make sure vlist is correct for each dl. */
3441 for (dl
= ddf
->dlist
; dl
; dl
= dl
->next
) {
3443 unsigned int vn
= 0;
3444 int in_degraded
= 0;
3445 for (vcl
= ddf
->conflist
; vcl
; vcl
= vcl
->next
)
3446 for (dn
=0; dn
< ddf
->mppe
; dn
++)
3447 if (vcl
->conf
.phys_refnum
[dn
] ==
3450 dprintf("dev %d has %p at %d\n",
3451 dl
->pdnum
, vcl
, vn
);
3452 /* Clear the Transition flag */
3453 if (ddf
->phys
->entries
[dl
->pdnum
].state
3454 & __be16_to_cpu(DDF_Failed
))
3455 ddf
->phys
->entries
[dl
->pdnum
].state
&=
3456 ~__be16_to_cpu(DDF_Transition
);
3458 dl
->vlist
[vn
++] = vcl
;
3459 vstate
= ddf
->virt
->entries
[vcl
->vcnum
].state
3461 if (vstate
== DDF_state_degraded
||
3462 vstate
== DDF_state_part_optimal
)
3466 while (vn
< ddf
->max_part
)
3467 dl
->vlist
[vn
++] = NULL
;
3469 ddf
->phys
->entries
[dl
->pdnum
].type
&=
3470 ~__cpu_to_be16(DDF_Global_Spare
);
3471 if (!(ddf
->phys
->entries
[dl
->pdnum
].type
&
3472 __cpu_to_be16(DDF_Active_in_VD
))) {
3473 ddf
->phys
->entries
[dl
->pdnum
].type
|=
3474 __cpu_to_be16(DDF_Active_in_VD
);
3476 ddf
->phys
->entries
[dl
->pdnum
].state
|=
3477 __cpu_to_be16(DDF_Rebuilding
);
3481 ddf
->phys
->entries
[dl
->pdnum
].type
&=
3482 ~__cpu_to_be16(DDF_Global_Spare
);
3483 ddf
->phys
->entries
[dl
->pdnum
].type
|=
3484 __cpu_to_be16(DDF_Spare
);
3486 if (!dl
->vlist
[0] && !dl
->spare
) {
3487 ddf
->phys
->entries
[dl
->pdnum
].type
|=
3488 __cpu_to_be16(DDF_Global_Spare
);
3489 ddf
->phys
->entries
[dl
->pdnum
].type
&=
3490 ~__cpu_to_be16(DDF_Spare
|
3495 /* Now remove any 'Failed' devices that are not part
3496 * of any VD. They will have the Transition flag set.
3497 * Once done, we need to update all dl->pdnum numbers.
3500 for (pdnum
= 0; pdnum
< __be16_to_cpu(ddf
->phys
->used_pdes
); pdnum
++)
3501 if ((ddf
->phys
->entries
[pdnum
].state
3502 & __be16_to_cpu(DDF_Failed
))
3503 && (ddf
->phys
->entries
[pdnum
].state
3504 & __be16_to_cpu(DDF_Transition
)))
3505 /* skip this one */;
3506 else if (pdnum
== pd2
)
3509 ddf
->phys
->entries
[pd2
] = ddf
->phys
->entries
[pdnum
];
3510 for (dl
= ddf
->dlist
; dl
; dl
= dl
->next
)
3511 if (dl
->pdnum
== (int)pdnum
)
3515 ddf
->phys
->used_pdes
= __cpu_to_be16(pd2
);
3516 while (pd2
< pdnum
) {
3517 memset(ddf
->phys
->entries
[pd2
].guid
, 0xff, DDF_GUID_LEN
);
3521 ddf
->updates_pending
= 1;
3523 case DDF_SPARE_ASSIGN_MAGIC
:
3528 static void ddf_prepare_update(struct supertype
*st
,
3529 struct metadata_update
*update
)
3531 /* This update arrived at managemon.
3532 * We are about to pass it to monitor.
3533 * If a malloc is needed, do it here.
3535 struct ddf_super
*ddf
= st
->sb
;
3536 __u32
*magic
= (__u32
*)update
->buf
;
3537 if (*magic
== DDF_VD_CONF_MAGIC
)
3538 if (posix_memalign(&update
->space
, 512,
3539 offsetof(struct vcl
, conf
)
3540 + ddf
->conf_rec_len
* 512) != 0)
3541 update
->space
= NULL
;
3545 * Check if the array 'a' is degraded but not failed.
3546 * If it is, find as many spares as are available and needed and
3547 * arrange for their inclusion.
3548 * We only choose devices which are not already in the array,
3549 * and prefer those with a spare-assignment to this array.
3550 * otherwise we choose global spares - assuming always that
3551 * there is enough room.
3552 * For each spare that we assign, we return an 'mdinfo' which
3553 * describes the position for the device in the array.
3554 * We also add to 'updates' a DDF_VD_CONF_MAGIC update with
3555 * the new phys_refnum and lba_offset values.
3557 * Only worry about BVDs at the moment.
3559 static struct mdinfo
*ddf_activate_spare(struct active_array
*a
,
3560 struct metadata_update
**updates
)
3564 struct ddf_super
*ddf
= a
->container
->sb
;
3566 struct mdinfo
*rv
= NULL
;
3568 struct metadata_update
*mu
;
3571 struct vd_config
*vc
;
3574 for (d
= a
->info
.devs
; d
; d
= d
->next
) {
3575 if ((d
->curr_state
& DS_FAULTY
) &&
3577 /* wait for Removal to happen */
3579 if (d
->state_fd
>= 0)
3583 dprintf("ddf_activate: working=%d (%d) level=%d\n", working
, a
->info
.array
.raid_disks
,
3584 a
->info
.array
.level
);
3585 if (working
== a
->info
.array
.raid_disks
)
3586 return NULL
; /* array not degraded */
3587 switch (a
->info
.array
.level
) {
3590 return NULL
; /* failed */
3594 if (working
< a
->info
.array
.raid_disks
- 1)
3595 return NULL
; /* failed */
3598 if (working
< a
->info
.array
.raid_disks
- 2)
3599 return NULL
; /* failed */
3601 default: /* concat or stripe */
3602 return NULL
; /* failed */
3605 /* For each slot, if it is not working, find a spare */
3607 for (i
= 0; i
< a
->info
.array
.raid_disks
; i
++) {
3608 for (d
= a
->info
.devs
; d
; d
= d
->next
)
3609 if (d
->disk
.raid_disk
== i
)
3611 dprintf("found %d: %p %x\n", i
, d
, d
?d
->curr_state
:0);
3612 if (d
&& (d
->state_fd
>= 0))
3615 /* OK, this device needs recovery. Find a spare */
3617 for ( ; dl
; dl
= dl
->next
) {
3618 unsigned long long esize
;
3619 unsigned long long pos
;
3622 int is_dedicated
= 0;
3625 /* If in this array, skip */
3626 for (d2
= a
->info
.devs
; d2
; d2
= d2
->next
)
3627 if (d2
->state_fd
>= 0 &&
3628 d2
->disk
.major
== dl
->major
&&
3629 d2
->disk
.minor
== dl
->minor
) {
3630 dprintf("%x:%x already in array\n", dl
->major
, dl
->minor
);
3635 if (ddf
->phys
->entries
[dl
->pdnum
].type
&
3636 __cpu_to_be16(DDF_Spare
)) {
3637 /* Check spare assign record */
3639 if (dl
->spare
->type
& DDF_spare_dedicated
) {
3640 /* check spare_ents for guid */
3642 j
< __be16_to_cpu(dl
->spare
->populated
);
3644 if (memcmp(dl
->spare
->spare_ents
[j
].guid
,
3645 ddf
->virt
->entries
[a
->info
.container_member
].guid
,
3652 } else if (ddf
->phys
->entries
[dl
->pdnum
].type
&
3653 __cpu_to_be16(DDF_Global_Spare
)) {
3656 if ( ! (is_dedicated
||
3657 (is_global
&& global_ok
))) {
3658 dprintf("%x:%x not suitable: %d %d\n", dl
->major
, dl
->minor
,
3659 is_dedicated
, is_global
);
3663 /* We are allowed to use this device - is there space?
3664 * We need a->info.component_size sectors */
3665 ex
= get_extents(ddf
, dl
);
3667 dprintf("cannot get extents\n");
3674 esize
= ex
[j
].start
- pos
;
3675 if (esize
>= a
->info
.component_size
)
3677 pos
= ex
[j
].start
+ ex
[j
].size
;
3679 } while (ex
[j
-1].size
);
3682 if (esize
< a
->info
.component_size
) {
3683 dprintf("%x:%x has no room: %llu %llu\n",
3684 dl
->major
, dl
->minor
,
3685 esize
, a
->info
.component_size
);
3690 /* Cool, we have a device with some space at pos */
3691 di
= malloc(sizeof(*di
));
3694 memset(di
, 0, sizeof(*di
));
3695 di
->disk
.number
= i
;
3696 di
->disk
.raid_disk
= i
;
3697 di
->disk
.major
= dl
->major
;
3698 di
->disk
.minor
= dl
->minor
;
3700 di
->recovery_start
= 0;
3701 di
->data_offset
= pos
;
3702 di
->component_size
= a
->info
.component_size
;
3703 di
->container_member
= dl
->pdnum
;
3706 dprintf("%x:%x to be %d at %llu\n", dl
->major
, dl
->minor
,
3711 if (!dl
&& ! global_ok
) {
3712 /* not enough dedicated spares, try global */
3720 /* No spares found */
3722 /* Now 'rv' has a list of devices to return.
3723 * Create a metadata_update record to update the
3724 * phys_refnum and lba_offset values
3726 mu
= malloc(sizeof(*mu
));
3727 if (mu
&& posix_memalign(&mu
->space
, 512, sizeof(struct vcl
)) != 0) {
3733 struct mdinfo
*n
= rv
->next
;
3741 mu
->buf
= malloc(ddf
->conf_rec_len
* 512);
3742 mu
->len
= ddf
->conf_rec_len
* 512;
3744 mu
->next
= *updates
;
3745 vc
= find_vdcr(ddf
, a
->info
.container_member
);
3746 memcpy(mu
->buf
, vc
, ddf
->conf_rec_len
* 512);
3748 vc
= (struct vd_config
*)mu
->buf
;
3749 lba
= (__u64
*)&vc
->phys_refnum
[ddf
->mppe
];
3750 for (di
= rv
; di
; di
= di
->next
) {
3751 vc
->phys_refnum
[di
->disk
.raid_disk
] =
3752 ddf
->phys
->entries
[dl
->pdnum
].refnum
;
3753 lba
[di
->disk
.raid_disk
] = di
->data_offset
;
3758 #endif /* MDASSEMBLE */
3760 static int ddf_level_to_layout(int level
)
3767 return ALGORITHM_LEFT_SYMMETRIC
;
3769 return ALGORITHM_ROTATING_N_CONTINUE
;
3777 struct superswitch super_ddf
= {
3779 .examine_super
= examine_super_ddf
,
3780 .brief_examine_super
= brief_examine_super_ddf
,
3781 .brief_examine_subarrays
= brief_examine_subarrays_ddf
,
3782 .export_examine_super
= export_examine_super_ddf
,
3783 .detail_super
= detail_super_ddf
,
3784 .brief_detail_super
= brief_detail_super_ddf
,
3785 .validate_geometry
= validate_geometry_ddf
,
3786 .write_init_super
= write_init_super_ddf
,
3787 .add_to_super
= add_to_super_ddf
,
3789 .match_home
= match_home_ddf
,
3790 .uuid_from_super
= uuid_from_super_ddf
,
3791 .getinfo_super
= getinfo_super_ddf
,
3792 .update_super
= update_super_ddf
,
3794 .avail_size
= avail_size_ddf
,
3796 .compare_super
= compare_super_ddf
,
3798 .load_super
= load_super_ddf
,
3799 .init_super
= init_super_ddf
,
3800 .store_super
= store_super_ddf
,
3801 .free_super
= free_super_ddf
,
3802 .match_metadata_desc
= match_metadata_desc_ddf
,
3803 .container_content
= container_content_ddf
,
3804 .default_layout
= ddf_level_to_layout
,
3810 .open_new
= ddf_open_new
,
3811 .set_array_state
= ddf_set_array_state
,
3812 .set_disk
= ddf_set_disk
,
3813 .sync_metadata
= ddf_sync_metadata
,
3814 .process_update
= ddf_process_update
,
3815 .prepare_update
= ddf_prepare_update
,
3816 .activate_spare
= ddf_activate_spare
,