]> git.ipfire.org Git - thirdparty/mdadm.git/blob - super-intel.c
projects / thirdparty / mdadm.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
blame | history | raw | HEAD
imsm: add 'mpb_size' to --examine output
[thirdparty/mdadm.git] / super-intel.c
1 /*
2 * mdadm - Intel(R) Matrix Storage Manager Support
3 *
4 * Copyright (C) 2002-2007 Intel Corporation
5 *
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms and conditions of the GNU General Public License,
8 * version 2, as published by the Free Software Foundation.
9 *
10 * This program is distributed in the hope it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
13 * more details.
14 *
15 * You should have received a copy of the GNU General Public License along with
16 * this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
18 */
19
20 #include "mdadm.h"
21 #include "mdmon.h"
22 #include <values.h>
23 #include <scsi/sg.h>
24 #include <ctype.h>
25
26 /* MPB == Metadata Parameter Block */
27 #define MPB_SIGNATURE "Intel Raid ISM Cfg Sig. "
28 #define MPB_SIG_LEN (strlen(MPB_SIGNATURE))
29 #define MPB_VERSION_RAID0 "1.0.00"
30 #define MPB_VERSION_RAID1 "1.1.00"
31 #define MPB_VERSION_RAID5 "1.2.02"
32 #define MAX_SIGNATURE_LENGTH 32
33 #define MAX_RAID_SERIAL_LEN 16
34
35 /* Disk configuration info. */
36 #define IMSM_MAX_DEVICES 255
37 struct imsm_disk {
38 __u8 serial[MAX_RAID_SERIAL_LEN];/* 0xD8 - 0xE7 ascii serial number */
39 __u32 total_blocks; /* 0xE8 - 0xEB total blocks */
40 __u32 scsi_id; /* 0xEC - 0xEF scsi ID */
41 __u32 status; /* 0xF0 - 0xF3 */
42 #define SPARE_DISK 0x01 /* Spare */
43 #define CONFIGURED_DISK 0x02 /* Member of some RaidDev */
44 #define FAILED_DISK 0x04 /* Permanent failure */
45 #define USABLE_DISK 0x08 /* Fully usable unless FAILED_DISK is set */
46
47 #define IMSM_DISK_FILLERS 5
48 __u32 filler[IMSM_DISK_FILLERS]; /* 0xF4 - 0x107 MPB_DISK_FILLERS for future expansion */
49 };
50
51 /* RAID map configuration infos. */
52 struct imsm_map {
53 __u32 pba_of_lba0; /* start address of partition */
54 __u32 blocks_per_member;/* blocks per member */
55 __u32 num_data_stripes; /* number of data stripes */
56 __u16 blocks_per_strip;
57 __u8 map_state; /* Normal, Uninitialized, Degraded, Failed */
58 #define IMSM_T_STATE_NORMAL 0
59 #define IMSM_T_STATE_UNINITIALIZED 1
60 #define IMSM_T_STATE_DEGRADED 2 /* FIXME: is this correct? */
61 #define IMSM_T_STATE_FAILED 3 /* FIXME: is this correct? */
62 __u8 raid_level;
63 #define IMSM_T_RAID0 0
64 #define IMSM_T_RAID1 1
65 #define IMSM_T_RAID5 5 /* since metadata version 1.2.02 ? */
66 __u8 num_members; /* number of member disks */
67 __u8 reserved[3];
68 __u32 filler[7]; /* expansion area */
69 __u32 disk_ord_tbl[1]; /* disk_ord_tbl[num_members],
70 top byte special */
71 } __attribute__ ((packed));
72
73 struct imsm_vol {
74 __u32 reserved[2];
75 __u8 migr_state; /* Normal or Migrating */
76 __u8 migr_type; /* Initializing, Rebuilding, ... */
77 __u8 dirty;
78 __u8 fill[1];
79 __u32 filler[5];
80 struct imsm_map map[1];
81 /* here comes another one if migr_state */
82 } __attribute__ ((packed));
83
84 struct imsm_dev {
85 __u8 volume[MAX_RAID_SERIAL_LEN];
86 __u32 size_low;
87 __u32 size_high;
88 __u32 status; /* Persistent RaidDev status */
89 __u32 reserved_blocks; /* Reserved blocks at beginning of volume */
90 #define IMSM_DEV_FILLERS 12
91 __u32 filler[IMSM_DEV_FILLERS];
92 struct imsm_vol vol;
93 } __attribute__ ((packed));
94
95 struct imsm_super {
96 __u8 sig[MAX_SIGNATURE_LENGTH]; /* 0x00 - 0x1F */
97 __u32 check_sum; /* 0x20 - 0x23 MPB Checksum */
98 __u32 mpb_size; /* 0x24 - 0x27 Size of MPB */
99 __u32 family_num; /* 0x28 - 0x2B Checksum from first time this config was written */
100 __u32 generation_num; /* 0x2C - 0x2F Incremented each time this array's MPB is written */
101 __u32 reserved[2]; /* 0x30 - 0x37 */
102 __u8 num_disks; /* 0x38 Number of configured disks */
103 __u8 num_raid_devs; /* 0x39 Number of configured volumes */
104 __u8 fill[2]; /* 0x3A - 0x3B */
105 #define IMSM_FILLERS 39
106 __u32 filler[IMSM_FILLERS]; /* 0x3C - 0xD7 RAID_MPB_FILLERS */
107 struct imsm_disk disk[1]; /* 0xD8 diskTbl[numDisks] */
108 /* here comes imsm_dev[num_raid_devs] */
109 } __attribute__ ((packed));
110
111 #ifndef MDASSEMBLE
112 static char *map_state_str[] = { "normal", "uninitialized", "degraded", "failed" };
113 #endif
114
115 static unsigned int sector_count(__u32 bytes)
116 {
117 return ((bytes + (512-1)) & (~(512-1))) / 512;
118 }
119
120 static unsigned int mpb_sectors(struct imsm_super *mpb)
121 {
122 return sector_count(__le32_to_cpu(mpb->mpb_size));
123 }
124
125 /* internal representation of IMSM metadata */
126 struct intel_super {
127 union {
128 struct imsm_super *mpb;
129 void *buf;
130 };
131 int updates_pending;
132 struct dl {
133 struct dl *next;
134 int index;
135 __u8 serial[MAX_RAID_SERIAL_LEN];
136 int major, minor;
137 char *devname;
138 int fd;
139 } *disks;
140 };
141
142 static struct supertype *match_metadata_desc_imsm(char *arg)
143 {
144 struct supertype *st;
145
146 if (strcmp(arg, "imsm") != 0 &&
147 strcmp(arg, "default") != 0
148 )
149 return NULL;
150
151 st = malloc(sizeof(*st));
152 st->ss = &super_imsm;
153 st->max_devs = IMSM_MAX_DEVICES;
154 st->minor_version = 0;
155 st->sb = NULL;
156 return st;
157 }
158
159 static struct supertype *match_metadata_desc_imsm_raid(char *arg)
160 {
161 struct supertype *st;
162
163 if (strcmp(arg, "imsm/raid") != 0 &&
164 strcmp(arg, "raid") != 0 &&
165 strcmp(arg, "default") != 0
166 )
167 return NULL;
168
169 st = malloc(sizeof(*st));
170 st->ss = &super_imsm_raid;
171 st->max_devs = IMSM_MAX_DEVICES;
172 st->minor_version = 0;
173 st->sb = NULL;
174 return st;
175 }
176
177 static __u8 *get_imsm_version(struct imsm_super *mpb)
178 {
179 return &mpb->sig[MPB_SIG_LEN];
180 }
181
182 static struct imsm_disk *get_imsm_disk(struct imsm_super *mpb, __u8 index)
183 {
184 if (index > mpb->num_disks - 1)
185 return NULL;
186 return &mpb->disk[index];
187 }
188
189 static __u32 gen_imsm_checksum(struct imsm_super *mpb)
190 {
191 __u32 end = mpb->mpb_size / sizeof(end);
192 __u32 *p = (__u32 *) mpb;
193 __u32 sum = 0;
194
195 while (end--)
196 sum += __le32_to_cpu(*p++);
197
198 return sum - __le32_to_cpu(mpb->check_sum);
199 }
200
201 static size_t sizeof_imsm_dev(struct imsm_dev *dev)
202 {
203 size_t size = sizeof(*dev);
204
205 /* each map has disk_ord_tbl[num_members - 1] additional space */
206 size += sizeof(__u32) * (dev->vol.map[0].num_members - 1);
207
208 /* migrating means an additional map */
209 if (dev->vol.migr_state) {
210 size += sizeof(struct imsm_map);
211 size += sizeof(__u32) * (dev->vol.map[1].num_members - 1);
212 }
213
214 return size;
215 }
216
217 static struct imsm_dev *get_imsm_dev(struct imsm_super *mpb, __u8 index)
218 {
219 int offset;
220 int i;
221 void *_mpb = mpb;
222
223 if (index > mpb->num_raid_devs - 1)
224 return NULL;
225
226 /* devices start after all disks */
227 offset = ((void *) &mpb->disk[mpb->num_disks]) - _mpb;
228
229 for (i = 0; i <= index; i++)
230 if (i == index)
231 return _mpb + offset;
232 else
233 offset += sizeof_imsm_dev(_mpb + offset);
234
235 return NULL;
236 }
237
238 static __u32 get_imsm_disk_idx(struct imsm_map *map, int slot)
239 {
240 __u32 *ord_tbl = &map->disk_ord_tbl[slot];
241
242 /* top byte is 'special' */
243 return __le32_to_cpu(*ord_tbl & ~(0xff << 24));
244 }
245
246 static int get_imsm_raid_level(struct imsm_map *map)
247 {
248 if (map->raid_level == 1) {
249 if (map->num_members == 2)
250 return 1;
251 else
252 return 10;
253 }
254
255 return map->raid_level;
256 }
257
258 #ifndef MDASSEMBLE
259 static void print_imsm_dev(struct imsm_dev *dev, int index)
260 {
261 __u64 sz;
262 int slot;
263 struct imsm_map *map = dev->vol.map;
264
265 printf("\n");
266 printf("[%s]:\n", dev->volume);
267 printf(" RAID Level : %d\n", get_imsm_raid_level(map));
268 printf(" Members : %d\n", map->num_members);
269 for (slot = 0; slot < map->num_members; slot++)
270 if (index == get_imsm_disk_idx(map, slot))
271 break;
272 if (slot < map->num_members)
273 printf(" This Slot : %d\n", slot);
274 else
275 printf(" This Slot : ?\n");
276 sz = __le32_to_cpu(dev->size_high);
277 sz <<= 32;
278 sz += __le32_to_cpu(dev->size_low);
279 printf(" Array Size : %llu%s\n", (unsigned long long)sz,
280 human_size(sz * 512));
281 sz = __le32_to_cpu(map->blocks_per_member);
282 printf(" Per Dev Size : %llu%s\n", (unsigned long long)sz,
283 human_size(sz * 512));
284 printf(" Sector Offset : %u\n",
285 __le32_to_cpu(map->pba_of_lba0));
286 printf(" Num Stripes : %u\n",
287 __le32_to_cpu(map->num_data_stripes));
288 printf(" Chunk Size : %u KiB\n",
289 __le16_to_cpu(map->blocks_per_strip) / 2);
290 printf(" Reserved : %d\n", __le32_to_cpu(dev->reserved_blocks));
291 printf(" Migrate State : %s\n", dev->vol.migr_state ? "migrating" : "idle");
292 printf(" Dirty State : %s\n", dev->vol.dirty ? "dirty" : "clean");
293 printf(" Map State : %s\n", map_state_str[map->map_state]);
294 }
295
296 static void print_imsm_disk(struct imsm_super *mpb, int index)
297 {
298 struct imsm_disk *disk = get_imsm_disk(mpb, index);
299 char str[MAX_RAID_SERIAL_LEN];
300 __u32 s;
301 __u64 sz;
302
303 printf("\n");
304 snprintf(str, MAX_RAID_SERIAL_LEN, "%s", disk->serial);
305 printf(" Disk%02d Serial : %s\n", index, str);
306 s = __le32_to_cpu(disk->status);
307 printf(" State :%s%s%s%s\n", s&SPARE_DISK ? " spare" : "",
308 s&CONFIGURED_DISK ? " active" : "",
309 s&FAILED_DISK ? " failed" : "",
310 s&USABLE_DISK ? " usable" : "");
311 printf(" Id : %08x\n", __le32_to_cpu(disk->scsi_id));
312 sz = __le32_to_cpu(disk->total_blocks) - mpb_sectors(mpb);
313 printf(" Usable Size : %llu%s\n", (unsigned long long)sz,
314 human_size(sz * 512));
315 }
316
317 static void examine_super_imsm(struct supertype *st, char *homehost)
318 {
319 struct intel_super *super = st->sb;
320 struct imsm_super *mpb = super->mpb;
321 char str[MAX_SIGNATURE_LENGTH];
322 int i;
323 __u32 sum;
324
325 snprintf(str, MPB_SIG_LEN, "%s", mpb->sig);
326 printf(" Magic : %s\n", str);
327 snprintf(str, strlen(MPB_VERSION_RAID0), "%s", get_imsm_version(mpb));
328 printf(" Version : %s\n", get_imsm_version(mpb));
329 printf(" Family : %08x\n", __le32_to_cpu(mpb->family_num));
330 printf(" Generation : %08x\n", __le32_to_cpu(mpb->generation_num));
331 sum = __le32_to_cpu(mpb->check_sum);
332 printf(" Checksum : %08x %s\n", sum,
333 gen_imsm_checksum(mpb) == sum ? "correct" : "incorrect");
334 printf(" MPB Sectors : %d\n", mpb_sectors(mpb));
335 printf(" Disks : %d\n", mpb->num_disks);
336 printf(" RAID Devices : %d\n", mpb->num_raid_devs);
337 print_imsm_disk(mpb, super->disks->index);
338 for (i = 0; i < mpb->num_raid_devs; i++)
339 print_imsm_dev(get_imsm_dev(mpb, i), super->disks->index);
340 for (i = 0; i < mpb->num_disks; i++) {
341 if (i == super->disks->index)
342 continue;
343 print_imsm_disk(mpb, i);
344 }
345 }
346
347 static void brief_examine_super_imsm(struct supertype *st)
348 {
349 struct intel_super *super = st->sb;
350 struct imsm_super *mpb = super->mpb;
351
352 printf("ARRAY /dev/imsm family=%08x metadata=external:imsm\n",
353 __le32_to_cpu(mpb->family_num));
354 }
355
356 static void detail_super_imsm(struct supertype *st, char *homehost)
357 {
358 printf("%s\n", __FUNCTION__);
359 }
360
361 static void brief_detail_super_imsm(struct supertype *st)
362 {
363 printf("%s\n", __FUNCTION__);
364 }
365 #endif
366
367 static int match_home_imsm(struct supertype *st, char *homehost)
368 {
369 printf("%s\n", __FUNCTION__);
370
371 return 0;
372 }
373
374 static void uuid_from_super_imsm(struct supertype *st, int uuid[4])
375 {
376 printf("%s\n", __FUNCTION__);
377 }
378
379 static void
380 get_imsm_numerical_version(struct imsm_super *mpb, int *m, int *p)
381 {
382 __u8 *v = get_imsm_version(mpb);
383 __u8 *end = mpb->sig + MAX_SIGNATURE_LENGTH;
384 char major[] = { 0, 0, 0 };
385 char minor[] = { 0 ,0, 0 };
386 char patch[] = { 0, 0, 0 };
387 char *ver_parse[] = { major, minor, patch };
388 int i, j;
389
390 i = j = 0;
391 while (*v != '\0' && v < end) {
392 if (*v != '.' && j < 2)
393 ver_parse[i][j++] = *v;
394 else {
395 i++;
396 j = 0;
397 }
398 v++;
399 }
400
401 *m = strtol(minor, NULL, 0);
402 *p = strtol(patch, NULL, 0);
403 }
404
405 static void getinfo_super_imsm(struct supertype *st, struct mdinfo *info)
406 {
407 struct intel_super *super = st->sb;
408 struct imsm_super *mpb = super->mpb;
409 struct imsm_disk *disk;
410 __u32 s;
411 int i, j;
412
413 info->array.major_version = 2000;
414 get_imsm_numerical_version(mpb, &info->array.minor_version,
415 &info->array.patch_version);
416 info->array.raid_disks = mpb->num_disks;
417 info->array.level = LEVEL_CONTAINER;
418 info->array.layout = 0;
419 info->array.md_minor = -1;
420 info->array.ctime = __le32_to_cpu(mpb->generation_num); //??
421 info->array.utime = 0;
422 info->array.chunk_size = 0;
423
424 info->disk.major = 0;
425 info->disk.minor = 0;
426 info->disk.number = super->disks->index;
427 info->disk.raid_disk = -1;
428 /* is this disk a member of a raid device? */
429 for (i = 0; i < mpb->num_raid_devs; i++) {
430 struct imsm_dev *dev = get_imsm_dev(mpb, i);
431 struct imsm_map *map = dev->vol.map;
432
433 for (j = 0; j < map->num_members; j++) {
434 __u32 index = get_imsm_disk_idx(map, j);
435
436 if (index == super->disks->index) {
437 info->disk.raid_disk = super->disks->index;
438 break;
439 }
440 }
441 if (info->disk.raid_disk != -1)
442 break;
443 }
444 disk = get_imsm_disk(mpb, super->disks->index);
445 s = __le32_to_cpu(disk->status);
446 info->disk.state = s & CONFIGURED_DISK ? (1 << MD_DISK_ACTIVE) : 0;
447 info->disk.state |= s & FAILED_DISK ? (1 << MD_DISK_FAULTY) : 0;
448 info->disk.state |= s & USABLE_DISK ? (1 << MD_DISK_SYNC) : 0;
449 info->reshape_active = 0;
450
451 strcpy(info->text_version, "imsm");
452 }
453
454 static void getinfo_super_imsm_raid(struct supertype *st, struct mdinfo *info)
455 {
456 printf("%s\n", __FUNCTION__);
457
458 sprintf(info->text_version, "/%s/%d",
459 devnum2devname(st->container_dev),
460 info->container_member); // FIXME is this even set here?
461 }
462
463 static int update_super_imsm(struct supertype *st, struct mdinfo *info,
464 char *update, char *devname, int verbose,
465 int uuid_set, char *homehost)
466 {
467 /* FIXME */
468
469 /* For 'assemble' and 'force' we need to return non-zero if any
470 * change was made. For others, the return value is ignored.
471 * Update options are:
472 * force-one : This device looks a bit old but needs to be included,
473 * update age info appropriately.
474 * assemble: clear any 'faulty' flag to allow this device to
475 * be assembled.
476 * force-array: Array is degraded but being forced, mark it clean
477 * if that will be needed to assemble it.
478 *
479 * newdev: not used ????
480 * grow: Array has gained a new device - this is currently for
481 * linear only
482 * resync: mark as dirty so a resync will happen.
483 * name: update the name - preserving the homehost
484 *
485 * Following are not relevant for this imsm:
486 * sparc2.2 : update from old dodgey metadata
487 * super-minor: change the preferred_minor number
488 * summaries: update redundant counters.
489 * uuid: Change the uuid of the array to match watch is given
490 * homehost: update the recorded homehost
491 * _reshape_progress: record new reshape_progress position.
492 */
493 int rv = 0;
494 //struct intel_super *super = st->sb;
495 //struct imsm_super *mpb = super->mpb;
496
497 if (strcmp(update, "grow") == 0) {
498 }
499 if (strcmp(update, "resync") == 0) {
500 /* dev->vol.dirty = 1; */
501 }
502
503 /* IMSM has no concept of UUID or homehost */
504
505 return rv;
506 }
507
508 static __u64 avail_size_imsm(struct supertype *st, __u64 size)
509 {
510 printf("%s\n", __FUNCTION__);
511
512 return 0;
513 }
514
515 static int compare_super_imsm(struct supertype *st, struct supertype *tst)
516 {
517 /*
518 * return:
519 * 0 same, or first was empty, and second was copied
520 * 1 second had wrong number
521 * 2 wrong uuid
522 * 3 wrong other info
523 */
524 struct intel_super *first = st->sb;
525 struct intel_super *sec = tst->sb;
526
527 if (!first) {
528 st->sb = tst->sb;
529 tst->sb = NULL;
530 return 0;
531 }
532
533 if (memcmp(first->mpb->sig, sec->mpb->sig, MAX_SIGNATURE_LENGTH) != 0)
534 return 3;
535 if (first->mpb->family_num != sec->mpb->family_num)
536 return 3;
537 if (first->mpb->mpb_size != sec->mpb->mpb_size)
538 return 3;
539 if (first->mpb->check_sum != sec->mpb->check_sum)
540 return 3;
541
542 return 0;
543 }
544
545 extern int scsi_get_serial(int fd, void *buf, size_t buf_len);
546
547 static int imsm_read_serial(int fd, char *devname,
548 __u8 serial[MAX_RAID_SERIAL_LEN])
549 {
550 unsigned char scsi_serial[255];
551 int sg_fd;
552 int rv;
553 int rsp_len;
554 int i, cnt;
555
556 memset(scsi_serial, 0, sizeof(scsi_serial));
557
558 sg_fd = sysfs_disk_to_sg(fd);
559 if (sg_fd < 0) {
560 if (devname)
561 fprintf(stderr,
562 Name ": Failed to open sg interface for %s: %s\n",
563 devname, strerror(errno));
564 return 1;
565 }
566
567 rv = scsi_get_serial(sg_fd, scsi_serial, sizeof(scsi_serial));
568 close(sg_fd);
569
570 if (rv != 0) {
571 if (devname)
572 fprintf(stderr,
573 Name ": Failed to retrieve serial for %s\n",
574 devname);
575 return rv;
576 }
577
578 rsp_len = scsi_serial[3];
579 for (i = 0, cnt = 0; i < rsp_len; i++) {
580 if (!isspace(scsi_serial[4 + i]))
581 serial[cnt++] = scsi_serial[4 + i];
582 if (cnt == MAX_RAID_SERIAL_LEN)
583 break;
584 }
585
586 serial[MAX_RAID_SERIAL_LEN - 1] = '\0';
587
588 return 0;
589 }
590
591 static int
592 load_imsm_disk(int fd, struct intel_super *super, char *devname, int keep_fd)
593 {
594 struct imsm_super *mpb = super->mpb;
595 struct dl *dl;
596 struct stat stb;
597 struct imsm_disk *disk;
598 int rv;
599 int i;
600
601 dl = malloc(sizeof(*dl));
602 if (!dl) {
603 if (devname)
604 fprintf(stderr,
605 Name ": failed to allocate disk buffer for %s\n",
606 devname);
607 return 2;
608 }
609 memset(dl, 0, sizeof(*dl));
610
611 fstat(fd, &stb);
612 dl->major = major(stb.st_rdev);
613 dl->minor = minor(stb.st_rdev);
614 dl->next = super->disks;
615 dl->fd = keep_fd ? fd : -1;
616 dl->devname = devname ? strdup(devname) : NULL;
617 dl->index = -1;
618 super->disks = dl;
619 rv = imsm_read_serial(fd, devname, dl->serial);
620
621 if (rv != 0)
622 return 2;
623
624 /* look up this disk's index */
625 for (i = 0; i < mpb->num_disks; i++) {
626 disk = get_imsm_disk(mpb, i);
627
628 if (memcmp(disk->serial, dl->serial, MAX_RAID_SERIAL_LEN) == 0)
629 break;
630 }
631
632 if (i > mpb->num_disks)
633 return 2;
634
635 dl->index = i;
636
637 return 0;
638 }
639
640 /* load_imsm_mpb - read matrix metadata
641 * allocates super->mpb to be freed by free_super
642 */
643 static int load_imsm_mpb(int fd, struct intel_super *super, char *devname)
644 {
645 unsigned long long dsize;
646 size_t len, mpb_size;
647 unsigned long long sectors;
648 struct stat;
649 struct imsm_super anchor;
650 __u32 check_sum;
651
652 memset(super, 0, sizeof(*super));
653 get_dev_size(fd, NULL, &dsize);
654
655 if (lseek64(fd, dsize - (512 * 2), SEEK_SET) < 0) {
656 if (devname)
657 fprintf(stderr,
658 Name ": Cannot seek to anchor block on %s: %s\n",
659 devname, strerror(errno));
660 return 1;
661 }
662
663 len = sizeof(anchor);
664 if (read(fd, &anchor, len) != len) {
665 if (devname)
666 fprintf(stderr,
667 Name ": Cannot read anchor block on %s: %s\n",
668 devname, strerror(errno));
669 return 1;
670 }
671
672 if (strncmp((char *) anchor.sig, MPB_SIGNATURE, MPB_SIG_LEN) != 0) {
673 if (devname)
674 fprintf(stderr,
675 Name ": no IMSM anchor on %s\n", devname);
676 return 2;
677 }
678
679 mpb_size = __le32_to_cpu(anchor.mpb_size);
680 super->mpb = malloc(mpb_size < 512 ? 512 : mpb_size);
681 if (!super->mpb) {
682 if (devname)
683 fprintf(stderr,
684 Name ": unable to allocate %zu byte mpb buffer\n",
685 mpb_size);
686 return 2;
687 }
688 memcpy(super->buf, &anchor, sizeof(anchor));
689
690 /* read the rest of the first block */
691 len = 512 - sizeof(anchor);
692 if (read(fd, super->buf + sizeof(anchor), len) != len) {
693 if (devname)
694 fprintf(stderr,
695 Name ": Cannot read anchor remainder on %s: %s\n",
696 devname, strerror(errno));
697 return 2;
698 }
699
700 sectors = mpb_sectors(&anchor) - 1;
701 if (!sectors)
702 return load_imsm_disk(fd, super, devname, 0);
703
704 /* read the extended mpb */
705 if (lseek64(fd, dsize - (512 * (2 + sectors)), SEEK_SET) < 0) {
706 if (devname)
707 fprintf(stderr,
708 Name ": Cannot seek to extended mpb on %s: %s\n",
709 devname, strerror(errno));
710 return 1;
711 }
712
713 len = mpb_size - 512;
714 if (read(fd, super->buf + 512, len) != len) {
715 if (devname)
716 fprintf(stderr,
717 Name ": Cannot read extended mpb on %s: %s\n",
718 devname, strerror(errno));
719 return 2;
720 }
721
722 check_sum = gen_imsm_checksum(super->mpb);
723 if (check_sum != __le32_to_cpu(super->mpb->check_sum)) {
724 if (devname)
725 fprintf(stderr,
726 Name ": IMSM checksum %x != %x on %s\n",
727 check_sum, __le32_to_cpu(super->mpb->check_sum),
728 devname);
729 return 2;
730 }
731
732 return load_imsm_disk(fd, super, devname, 0);
733 }
734
735 struct superswitch super_imsm_container;
736
737 static void free_imsm_disks(struct intel_super *super)
738 {
739 while (super->disks) {
740 struct dl *d = super->disks;
741
742 super->disks = d->next;
743 if (d->fd >= 0)
744 close(d->fd);
745 if (d->devname)
746 free(d->devname);
747 free(d);
748 }
749 }
750
751 static void free_imsm(struct intel_super *super)
752 {
753 if (super->mpb)
754 free(super->mpb);
755 free_imsm_disks(super);
756 free(super);
757 }
758
759
760 static void free_super_imsm(struct supertype *st)
761 {
762 struct intel_super *super = st->sb;
763
764 if (!super)
765 return;
766
767 free_imsm(super);
768 st->sb = NULL;
769 }
770
771 #ifndef MDASSEMBLE
772 static int load_super_imsm_all(struct supertype *st, int fd, void **sbp,
773 char *devname, int keep_fd)
774 {
775 struct mdinfo *sra;
776 struct intel_super *super;
777 struct mdinfo *sd, *best = NULL;
778 __u32 bestgen = 0;
779 __u32 gen;
780 char nm[20];
781 int dfd;
782 int rv;
783
784 /* check if this disk is a member of an active array */
785 sra = sysfs_read(fd, 0, GET_LEVEL|GET_VERSION|GET_DEVS|GET_STATE);
786 if (!sra)
787 return 1;
788
789 if (sra->array.major_version != -1 ||
790 sra->array.minor_version != -2 ||
791 strcmp(sra->text_version, "imsm") != 0)
792 return 1;
793
794 super = malloc(sizeof(*super));
795 if (!super)
796 return 1;
797
798 /* find the most up to date disk in this array */
799 for (sd = sra->devs; sd; sd = sd->next) {
800 sprintf(nm, "%d:%d", sd->disk.major, sd->disk.minor);
801 dfd = dev_open(nm, keep_fd ? O_RDWR : O_RDONLY);
802 if (!dfd) {
803 free_imsm(super);
804 return 2;
805 }
806 rv = load_imsm_mpb(dfd, super, NULL);
807 if (!keep_fd)
808 close(dfd);
809 if (rv == 0) {
810 gen = __le32_to_cpu(super->mpb->generation_num);
811 if (!best || gen > bestgen) {
812 bestgen = gen;
813 best = sd;
814 }
815 } else {
816 free_imsm(super);
817 return 2;
818 }
819 }
820
821 if (!best) {
822 free_imsm(super);
823 return 1;
824 }
825
826 /* load the most up to date anchor */
827 sprintf(nm, "%d:%d", best->disk.major, best->disk.minor);
828 dfd = dev_open(nm, O_RDONLY);
829 if (!dfd) {
830 free_imsm(super);
831 return 1;
832 }
833 rv = load_imsm_mpb(dfd, super, NULL);
834 close(dfd);
835 if (rv != 0) {
836 free_imsm(super);
837 return 2;
838 }
839
840 /* reset the disk list */
841 free_imsm_disks(super);
842
843 /* populate disk list */
844 for (sd = sra->devs ; sd ; sd = sd->next) {
845 sprintf(nm, "%d:%d", sd->disk.major, sd->disk.minor);
846 dfd = dev_open(nm, keep_fd? O_RDWR : O_RDONLY);
847 if (!dfd) {
848 free_imsm(super);
849 return 2;
850 }
851 load_imsm_disk(dfd, super, NULL, keep_fd);
852 if (!keep_fd)
853 close(dfd);
854 }
855
856 *sbp = super;
857 if (st->ss == NULL) {
858 st->ss = &super_imsm_container;
859 st->minor_version = 0;
860 st->max_devs = IMSM_MAX_DEVICES;
861 }
862
863 return 0;
864 }
865 #endif
866
867 static int load_super_imsm(struct supertype *st, int fd, char *devname)
868 {
869 struct intel_super *super;
870 int rv;
871
872 #ifndef MDASSEMBLE
873 if (load_super_imsm_all(st, fd, &st->sb, devname, 1) == 0)
874 return 0;
875 #endif
876
877 super = malloc(sizeof(*super));
878 if (!super) {
879 fprintf(stderr,
880 Name ": malloc of %zu failed.\n",
881 sizeof(*super));
882 return 1;
883 }
884
885 rv = load_imsm_mpb(fd, super, devname);
886
887 if (rv) {
888 if (devname)
889 fprintf(stderr,
890 Name ": Failed to load all information "
891 "sections on %s\n", devname);
892 free_imsm(super);
893 return rv;
894 }
895
896 st->sb = super;
897 if (st->ss == NULL) {
898 st->ss = &super_imsm;
899 st->minor_version = 0;
900 st->max_devs = IMSM_MAX_DEVICES;
901 }
902
903 return 0;
904 }
905
906 static int init_zero_imsm(struct supertype *st, mdu_array_info_t *info,
907 unsigned long long size, char *name,
908 char *homehost, int *uuid)
909 {
910 printf("%s\n", __FUNCTION__);
911
912 return 0;
913 }
914
915 static int init_super_imsm(struct supertype *st, mdu_array_info_t *info,
916 unsigned long long size, char *name,
917 char *homehost, int *uuid)
918 {
919 printf("%s\n", __FUNCTION__);
920
921 return 0;
922 }
923
924 static int init_super_imsm_raid(struct supertype *st, mdu_array_info_t *info,
925 unsigned long long size, char *name,
926 char *homehost, int *uuid)
927 {
928 printf("%s\n", __FUNCTION__);
929
930 return 0;
931 }
932
933 static void add_to_super_imsm(struct supertype *st, mdu_disk_info_t *dinfo,
934 int fd, char *devname)
935 {
936 printf("%s\n", __FUNCTION__);
937 }
938
939 static void add_to_super_imsm_raid(struct supertype *st, mdu_disk_info_t *dinfo,
940 int fd, char *devname)
941 {
942 printf("%s\n", __FUNCTION__);
943 }
944
945 static int write_init_super_imsm(struct supertype *st)
946 {
947 printf("%s\n", __FUNCTION__);
948
949 return 0;
950 }
951
952 static int store_zero_imsm(struct supertype *st, int fd)
953 {
954 printf("%s\n", __FUNCTION__);
955
956 return 0;
957 }
958
959 static void getinfo_super_n_imsm_container(struct supertype *st, struct mdinfo *info)
960 {
961 /* just need offset and size...
962 * of the metadata??
963 */
964 struct intel_super *super = st->sb;
965 struct imsm_super *mpb = super->mpb;
966 struct imsm_disk *disk = get_imsm_disk(mpb, info->disk.number);
967 int sect = mpb_sectors(mpb);
968
969 info->data_offset = __le32_to_cpu(disk->total_blocks) - (2 + sect - 1);
970 info->component_size = sect;
971 }
972
973 static void getinfo_super_n_raid(struct supertype *st, struct mdinfo *info)
974 {
975 printf("%s\n", __FUNCTION__);
976 }
977
978 static int validate_geometry_imsm(struct supertype *st, int level, int layout,
979 int raiddisks, int chunk, unsigned long long size,
980 char *subdev, unsigned long long *freesize)
981 {
982 printf("%s\n", __FUNCTION__);
983
984 return 0;
985 }
986
987 static int validate_geometry_imsm_container(struct supertype *st, int level,
988 int layout, int raiddisks, int chunk,
989 unsigned long long size, char *subdev,
990 unsigned long long *freesize)
991 {
992 printf("%s\n", __FUNCTION__);
993
994 return 0;
995 }
996
997 static int validate_geometry_imsm_raid(struct supertype *st, int level,
998 int layout, int raiddisks, int chunk,
999 unsigned long long size, char *subdev,
1000 unsigned long long *freesize)
1001 {
1002 printf("%s\n", __FUNCTION__);
1003
1004 return 0;
1005 }
1006
1007 static struct mdinfo *container_content_imsm(struct supertype *st)
1008 {
1009 /* Given a container loaded by load_super_imsm_all,
1010 * extract information about all the arrays into
1011 * an mdinfo tree.
1012 *
1013 * For each imsm_dev create an mdinfo, fill it in,
1014 * then look for matching devices in super->disks
1015 * and create appropriate device mdinfo.
1016 */
1017 struct intel_super *super = st->sb;
1018 struct imsm_super *mpb = super->mpb;
1019 struct mdinfo *rest = NULL;
1020 int i;
1021
1022 for (i = 0; i < mpb->num_raid_devs; i++) {
1023 struct imsm_dev *dev = get_imsm_dev(mpb, i);
1024 struct imsm_vol *vol = &dev->vol;
1025 struct imsm_map *map = vol->map;
1026 struct mdinfo *this;
1027 __u64 sz;
1028 int slot;
1029
1030 this = malloc(sizeof(*this));
1031 memset(this, 0, sizeof(*this));
1032 this->next = rest;
1033 rest = this;
1034
1035 this->array.major_version = 2000;
1036 get_imsm_numerical_version(mpb, &this->array.minor_version,
1037 &this->array.patch_version);
1038 this->array.level = get_imsm_raid_level(map);
1039 this->array.raid_disks = map->num_members;
1040 switch(this->array.level) {
1041 case 0:
1042 case 1:
1043 this->array.layout = 0;
1044 break;
1045 case 5:
1046 case 6:
1047 this->array.layout = ALGORITHM_LEFT_SYMMETRIC;
1048 break;
1049 case 10:
1050 this->array.layout = 0x102; //FIXME is this correct?
1051 break;
1052 default:
1053 this->array.layout = -1; // FIXME
1054 }
1055 this->array.md_minor = -1;
1056 this->array.ctime = 0;
1057 this->array.utime = 0;
1058 this->array.chunk_size = __le16_to_cpu(map->blocks_per_strip) << 9;
1059 this->array.state = !vol->dirty;
1060 this->container_member = i;
1061 if (map->map_state == IMSM_T_STATE_UNINITIALIZED || dev->vol.dirty)
1062 this->resync_start = 0;
1063 else
1064 this->resync_start = ~0ULL;
1065
1066 strncpy(this->name, (char *) dev->volume, MAX_RAID_SERIAL_LEN);
1067 this->name[MAX_RAID_SERIAL_LEN] = 0;
1068
1069 sprintf(this->text_version, "/%s/%d",
1070 devnum2devname(st->container_dev),
1071 this->container_member);
1072
1073 memset(this->uuid, 0, sizeof(this->uuid));
1074
1075 sz = __le32_to_cpu(dev->size_high);
1076 sz <<= 32;
1077 sz += __le32_to_cpu(dev->size_low);
1078 this->component_size = sz;
1079 this->array.size = this->component_size / 2;
1080
1081 for (slot = 0 ; slot < map->num_members; slot++) {
1082 struct imsm_disk *disk;
1083 struct mdinfo *info_d;
1084 struct dl *d;
1085 int idx;
1086 __u32 s;
1087
1088 idx = __le32_to_cpu(map->disk_ord_tbl[slot] & ~(0xff << 24));
1089 for (d = super->disks; d ; d = d->next)
1090 if (d->index == idx)
1091 break;
1092
1093 if (d == NULL)
1094 break; /* shouldn't this be continue ?? */
1095
1096 info_d = malloc(sizeof(*info_d));
1097 if (!info_d)
1098 break; /* ditto ?? */
1099 memset(info_d, 0, sizeof(*info_d));
1100 info_d->next = this->devs;
1101 this->devs = info_d;
1102
1103 disk = get_imsm_disk(mpb, idx);
1104 s = __le32_to_cpu(disk->status);
1105
1106 info_d->disk.number = d->index;
1107 info_d->disk.major = d->major;
1108 info_d->disk.minor = d->minor;
1109 info_d->disk.raid_disk = slot;
1110 info_d->disk.state = s & CONFIGURED_DISK ? (1 << MD_DISK_ACTIVE) : 0;
1111 info_d->disk.state |= s & FAILED_DISK ? (1 << MD_DISK_FAULTY) : 0;
1112 info_d->disk.state |= s & USABLE_DISK ? (1 << MD_DISK_SYNC) : 0;
1113
1114 this->array.working_disks++;
1115
1116 info_d->events = __le32_to_cpu(mpb->generation_num);
1117 info_d->data_offset = __le32_to_cpu(map->pba_of_lba0);
1118 info_d->component_size = __le32_to_cpu(map->blocks_per_member);
1119 if (d->devname)
1120 strcpy(info_d->name, d->devname);
1121 }
1122 }
1123
1124 return rest;
1125 }
1126
1127
1128 static int imsm_open_new(struct supertype *c, struct active_array *a,
1129 char *inst)
1130 {
1131 fprintf(stderr, "imsm: open_new %s\n", inst);
1132 a->info.container_member = atoi(inst);
1133 return 0;
1134 }
1135
1136 static void imsm_set_array_state(struct active_array *a, int consistent)
1137 {
1138 int inst = a->info.container_member;
1139 struct intel_super *super = a->container->sb;
1140 struct imsm_dev *dev = get_imsm_dev(super->mpb, inst);
1141 int dirty = !consistent || (a->resync_start != ~0ULL);
1142
1143 if (dev->vol.dirty != dirty) {
1144 fprintf(stderr, "imsm: mark '%s' (%llu)\n",
1145 dirty?"dirty":"clean", a->resync_start);
1146
1147 dev->vol.dirty = dirty;
1148 super->updates_pending++;
1149 }
1150 }
1151
1152 static __u8 imsm_check_degraded(struct imsm_super *mpb, int n, int failed)
1153 {
1154 struct imsm_dev *dev = get_imsm_dev(mpb, n);
1155 struct imsm_map *map = dev->vol.map;
1156
1157 if (!failed)
1158 return map->map_state;
1159
1160 switch (get_imsm_raid_level(map)) {
1161 case 0:
1162 return IMSM_T_STATE_FAILED;
1163 break;
1164 case 1:
1165 if (failed < map->num_members)
1166 return IMSM_T_STATE_DEGRADED;
1167 else
1168 return IMSM_T_STATE_FAILED;
1169 break;
1170 case 10:
1171 {
1172 /**
1173 * check to see if any mirrors have failed,
1174 * otherwise we are degraded
1175 */
1176 int device_per_mirror = 2; /* FIXME is this always the case?
1177 * and are they always adjacent?
1178 */
1179 int failed = 0;
1180 int i;
1181
1182 for (i = 0; i < map->num_members; i++) {
1183 int idx = get_imsm_disk_idx(map, i);
1184 struct imsm_disk *disk = get_imsm_disk(mpb, idx);
1185
1186 if (__le32_to_cpu(disk->status) & FAILED_DISK)
1187 failed++;
1188
1189 if (failed >= device_per_mirror)
1190 return IMSM_T_STATE_FAILED;
1191
1192 /* reset 'failed' for next mirror set */
1193 if (!((i + 1) % device_per_mirror))
1194 failed = 0;
1195 }
1196
1197 return IMSM_T_STATE_DEGRADED;
1198 }
1199 case 5:
1200 if (failed < 2)
1201 return IMSM_T_STATE_DEGRADED;
1202 else
1203 return IMSM_T_STATE_FAILED;
1204 break;
1205 default:
1206 break;
1207 }
1208
1209 return map->map_state;
1210 }
1211
1212 static int imsm_count_failed(struct imsm_super *mpb, struct imsm_map *map)
1213 {
1214 int i;
1215 int failed = 0;
1216 struct imsm_disk *disk;
1217
1218 for (i = 0; i < map->num_members; i++) {
1219 int idx = get_imsm_disk_idx(map, i);
1220
1221 disk = get_imsm_disk(mpb, idx);
1222 if (__le32_to_cpu(disk->status) & FAILED_DISK)
1223 failed++;
1224 }
1225
1226 return failed;
1227 }
1228
1229 static void imsm_set_disk(struct active_array *a, int n, int state)
1230 {
1231 int inst = a->info.container_member;
1232 struct intel_super *super = a->container->sb;
1233 struct imsm_dev *dev = get_imsm_dev(super->mpb, inst);
1234 struct imsm_map *map = dev->vol.map;
1235 struct imsm_disk *disk;
1236 __u32 status;
1237 int failed = 0;
1238 int new_failure = 0;
1239
1240 if (n > map->num_members)
1241 fprintf(stderr, "imsm: set_disk %d out of range 0..%d\n",
1242 n, map->num_members - 1);
1243
1244 if (n < 0)
1245 return;
1246
1247 fprintf(stderr, "imsm: set_disk %d:%x\n", n, state);
1248
1249 disk = get_imsm_disk(super->mpb, get_imsm_disk_idx(map, n));
1250
1251 /* check if we have seen this failure before */
1252 status = __le32_to_cpu(disk->status);
1253 if ((state & DS_FAULTY) && !(status & FAILED_DISK)) {
1254 status |= FAILED_DISK;
1255 disk->status = __cpu_to_le32(status);
1256 new_failure = 1;
1257 }
1258
1259 /**
1260 * the number of failures have changed, count up 'failed' to determine
1261 * degraded / failed status
1262 */
1263 if (new_failure && map->map_state != IMSM_T_STATE_FAILED)
1264 failed = imsm_count_failed(super->mpb, map);
1265
1266 if (failed)
1267 map->map_state = imsm_check_degraded(super->mpb, inst, failed);
1268
1269 if (new_failure)
1270 super->updates_pending++;
1271 }
1272
1273 static int store_imsm_mpb(int fd, struct intel_super *super)
1274 {
1275 struct imsm_super *mpb = super->mpb;
1276 __u32 mpb_size = __le32_to_cpu(mpb->mpb_size);
1277 unsigned long long dsize;
1278 unsigned long long sectors;
1279
1280 get_dev_size(fd, NULL, &dsize);
1281
1282 /* first block is stored on second to last sector of the disk */
1283 if (lseek64(fd, dsize - (512 * 2), SEEK_SET) < 0)
1284 return 1;
1285
1286 if (write(fd, super->buf, 512) != 512)
1287 return 1;
1288
1289 if (mpb_size <= 512)
1290 return 0;
1291
1292 /* -1 because we already wrote a sector */
1293 sectors = mpb_sectors(mpb) - 1;
1294
1295 /* write the extended mpb to the sectors preceeding the anchor */
1296 if (lseek64(fd, dsize - (512 * (2 + sectors)), SEEK_SET) < 0)
1297 return 1;
1298
1299 if (write(fd, super->buf + 512, mpb_size - 512) != mpb_size - 512)
1300 return 1;
1301
1302 fsync(fd);
1303
1304 return 0;
1305 }
1306
1307 static void imsm_sync_metadata(struct supertype *container)
1308 {
1309 struct intel_super *super = container->sb;
1310 struct imsm_super *mpb = super->mpb;
1311 struct dl *d;
1312 __u32 generation;
1313 __u32 sum;
1314
1315 if (!super->updates_pending)
1316 return;
1317
1318 fprintf(stderr, "imsm: sync_metadata\n");
1319
1320 /* 'generation' is incremented everytime the metadata is written */
1321 generation = __le32_to_cpu(mpb->generation_num);
1322 generation++;
1323 mpb->generation_num = __cpu_to_le32(generation);
1324
1325 /* recalculate checksum */
1326 sum = gen_imsm_checksum(mpb);
1327 mpb->check_sum = __cpu_to_le32(sum);
1328
1329 for (d = super->disks; d ; d = d->next)
1330 if (store_imsm_mpb(d->fd, super))
1331 fprintf(stderr, "%s: failed for device %d:%d %s\n",
1332 __func__, d->major, d->minor, strerror(errno));
1333
1334 super->updates_pending = 0;
1335 }
1336
1337 struct superswitch super_imsm = {
1338 #ifndef MDASSEMBLE
1339 .examine_super = examine_super_imsm,
1340 .brief_examine_super = brief_examine_super_imsm,
1341 .detail_super = detail_super_imsm,
1342 .brief_detail_super = brief_detail_super_imsm,
1343 #endif
1344 .match_home = match_home_imsm,
1345 .uuid_from_super= uuid_from_super_imsm,
1346 .getinfo_super = getinfo_super_imsm,
1347 .update_super = update_super_imsm,
1348
1349 .avail_size = avail_size_imsm,
1350
1351 .compare_super = compare_super_imsm,
1352
1353 .load_super = load_super_imsm,
1354 .init_super = init_zero_imsm,
1355 .store_super = store_zero_imsm,
1356 .free_super = free_super_imsm,
1357 .match_metadata_desc = match_metadata_desc_imsm,
1358 .getinfo_super_n = getinfo_super_n_imsm_container,
1359
1360 .validate_geometry = validate_geometry_imsm,
1361 .major = 2000,
1362 .swapuuid = 0,
1363 .external = 1,
1364
1365 /* for mdmon */
1366 .open_new = imsm_open_new,
1367 .load_super = load_super_imsm,
1368 .set_array_state= imsm_set_array_state,
1369 .set_disk = imsm_set_disk,
1370 .sync_metadata = imsm_sync_metadata,
1371 };
1372
1373 /* super_imsm_container is set by validate_geometry_imsm when given a
1374 * device that is not part of any array
1375 */
1376 struct superswitch super_imsm_container = {
1377
1378 .validate_geometry = validate_geometry_imsm_container,
1379 .init_super = init_super_imsm,
1380 .add_to_super = add_to_super_imsm,
1381 .write_init_super = write_init_super_imsm,
1382 .getinfo_super = getinfo_super_imsm,
1383 .getinfo_super_n = getinfo_super_n_imsm_container,
1384 .load_super = load_super_imsm,
1385
1386 #ifndef MDASSEMBLE
1387 .examine_super = examine_super_imsm,
1388 .brief_examine_super = brief_examine_super_imsm,
1389 .detail_super = detail_super_imsm,
1390 .brief_detail_super = brief_detail_super_imsm,
1391 #endif
1392
1393 .free_super = free_super_imsm,
1394
1395 .container_content = container_content_imsm,
1396
1397 .major = 2000,
1398 .swapuuid = 0,
1399 .external = 1,
1400 };
1401
1402 struct superswitch super_imsm_raid = {
1403 .update_super = update_super_imsm,
1404 .init_super = init_super_imsm_raid,
1405 .add_to_super = add_to_super_imsm_raid,
1406 .getinfo_super = getinfo_super_imsm_raid,
1407 .getinfo_super_n = getinfo_super_n_raid,
1408 .write_init_super = write_init_super_imsm,
1409
1410 .load_super = load_super_imsm,
1411 .free_super = free_super_imsm,
1412 .match_metadata_desc = match_metadata_desc_imsm_raid,
1413
1414
1415 .validate_geometry = validate_geometry_imsm_raid,
1416 .major = 2001,
1417 .swapuuid = 0,
1418 .external = 2,
1419 };
Unnamed repository; edit this file 'description' to name the repository.