]> git.ipfire.org Git - thirdparty/mdadm.git/commitdiff
mdctl-v0.2 mdctl-v0.2
authorNeil Brown <neilb@suse.de>
Fri, 8 Jun 2001 02:36:23 +0000 (02:36 +0000)
committerNeil Brown <neilb@suse.de>
Fri, 8 Jun 2001 02:36:23 +0000 (02:36 +0000)
16 files changed:
Assemble.c [new file with mode: 0644]
Build.c [new file with mode: 0644]
Create.c [new file with mode: 0644]
Detail.c [new file with mode: 0644]
Examine.c [new file with mode: 0644]
Makefile [new file with mode: 0644]
Manage.c [new file with mode: 0644]
ReadMe.c [new file with mode: 0644]
TODO [new file with mode: 0644]
config.c [new file with mode: 0644]
makedist [new file with mode: 0755]
md_p.h [new file with mode: 0644]
md_u.h [new file with mode: 0644]
mdctl.c [new file with mode: 0644]
mdctl.h [new file with mode: 0644]
util.c [new file with mode: 0644]

diff --git a/Assemble.c b/Assemble.c
new file mode 100644 (file)
index 0000000..504bde7
--- /dev/null
@@ -0,0 +1,366 @@
+/*
+ * mdctl - manage Linux "md" devices aka RAID arrays.
+ *
+ * Copyright (C) 2001 Neil Brown <neilb@cse.unsw.edu.au>
+ *
+ *
+ *    This program is free software; you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation; either version 2 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program; if not, write to the Free Software
+ *    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ *    Author: Neil Brown
+ *    Email: <neilb@cse.unsw.edu.au>
+ *    Paper: Neil Brown
+ *           School of Computer Science and Engineering
+ *           The University of New South Wales
+ *           Sydney, 2052
+ *           Australia
+ */
+
+#include       "mdctl.h"
+#include       "md_p.h"
+#include       "md_u.h"
+
+int Assemble(char *mddev, int mdfd,
+            int uuid[4], int uuidset,
+            char *conffile, int scan,
+            int subdevs, char **subdev,
+            int readonly, int runstop,
+            int verbose, int force)
+{
+       /*
+        * The task of Assemble is to submit a
+        * SET_ARRAY_INFO ioctl with no arg - to prepare
+        * the array - and then submit a number of
+        * ADD_NEW_DISK ioctls to add disks into
+        * the array.  Finally RUN_ARRAY might
+        * be submitted to start the array.
+        *
+        * Much of the work of Assemble is in finding and/or
+        * checking the disks to make sure they look right.
+        *
+        * If mddev is not set, then scan must be and we
+        *  read through the config file for dev+uuid mapping
+        *  We recurse, setting mddev, for each device that
+        *    - isn't running
+        *    - has a valid uuid (or any uuid if !uuidset
+        *
+        * If mddev is set, we try to determine state of md.
+        *   check version - must be at least 0.90.0
+        *   check kernel version.  must be at least 2.4.
+        *    If not, we can possibly fall back on START_ARRAY
+        *   Try to GET_ARRAY_INFO.
+        *     If possible, give up
+        *     If not, try to STOP_ARRAY just to make sure
+        *
+        * If !uuidset and scan, look in conf-file for uuid
+        *       If not found, give up
+        * If !subdevs and scan and uuidset, get list of devs from conf-file 
+        *
+        * For each device:
+        *   Check superblock - discard if bad
+        *   Check uuid (set if we don't have one) - discard if no match
+        *   Check superblock similarity if we have a superbloc - discard if different
+        *   Record events, devicenum, utime
+        * This should give us a list of devices for the array
+        * We should collect the most recent event and utime numbers
+        *
+        * Count disks with recent enough event count
+        * While force && !enough disks
+        *    Choose newest rejected disks, update event count
+        *     mark clean and rewrite superblock
+        * If recent kernel:
+        *    SET_ARRAY_INFO
+        *    foreach device with recent events : ADD_NEW_DISK
+        *    if runstop == 1 || "enough" disks and runstop==0 -> RUN_ARRAY
+        * If old kernel:
+        *    Check the device numbers in superblock are right
+        *    update superblock if any changes
+        *    START_ARRAY
+        *
+        */
+       int old_linux = 0;
+       int vers;
+       mdu_array_info_t array;
+       mddev_dev_t devlist = NULL;
+       mdp_super_t first_super, super;
+       struct {
+               char *devname;
+               int major, minor;
+               long long events;
+               time_t utime;
+               int uptodate;
+       } devices[MD_SB_DISKS];
+       int best[MD_SB_DISKS]; /* indexed by raid_disk */
+       int devcnt = 0, okcnt;
+       int i;
+       int most_recent = 0;
+       
+       if (!mddev && !scan) {
+               fputs("mdctl: internal error - Assemble called with no devie or scan\n", stderr);
+               return 1;
+       }
+       if (!mddev) {
+               mddev_uuid_t device_list;
+               int found = 0;
+               device_list = conf_get_uuids(conffile);
+               if (!device_list) {
+                       fprintf(stderr, "mdctl: No devices found in config file\n");
+                       return 1;
+               }
+               while (device_list) {
+                       if (!uuidset || same_uuid(device_list->uuid,uuid)) {
+                               mdfd = open(device_list->devname, O_RDONLY, 0);
+                               if (mdfd < 0) {
+                                       fprintf(stderr,
+                                               "mdctl: error opening %s: %s\n",
+                                               device_list->devname,
+                                               strerror(errno));
+                                       continue;
+                               }
+                               if (Assemble(device_list->devname, mdfd,
+                                        device_list->uuid, 1,
+                                        conffile, 1,
+                                        subdevs, subdev,
+                                            readonly, runstop, verbose, force)==0)
+                                       found++;
+                               close(mdfd);
+                       }
+                       device_list = device_list->next;
+               }
+               if (found)
+                       return 0;
+               fprintf(stderr,"mdctl: Did not successful Assemble any devices\n");
+               return 1;
+       }
+
+       /*
+        * Ok, we have an mddev, check it out
+        */
+       vers = md_get_version(mdfd);
+       if (vers <= 0) {
+               fprintf(stderr, "mdctl: %s appears not to be an md device.\n");
+               return 1;
+       }
+       if (vers < (90<<8)) {
+               fprintf(stderr, "mdctl: Assemble requires driver version 0.90.0 or later.\n"
+                       "    Upgrade your kernel or try --Build\n");
+               return 1;
+       }
+       if (get_linux_version() < 0x020400)
+               old_linux = 1;
+
+       if (ioctl(mdfd, GET_ARRAY_INFO, &array)>=0) {
+               fprintf(stderr, "mdctl: device %s already active - cannot assemble it\n",
+                       mddev);
+               return 1;
+       }
+       ioctl(mdfd, STOP_ARRAY, NULL); /* just incase it was started but has no content */
+
+       /*
+        * We have a valid mddev, check out uuid
+        */
+       if (!uuidset && scan) {
+               /* device must be listed with uuid in conf file */
+               mddev_uuid_t device_list;
+               device_list = conf_get_uuids(conffile);
+               while (device_list &&
+                      strcmp(device_list->devname, mddev) != 0)
+                       device_list = device_list->next;
+
+               if (!device_list) {
+                       fprintf(stderr, "mdctl: --scan set and no uuid found for %s in config file.\n",
+                               mddev);
+                       return 1;
+               }
+               /* the uuid is safe until next call to conf_get_uuids */
+               uuid = device_list->uuid;
+               uuidset = 1;
+       }
+
+       /* Now to start looking at devices.
+        * If no devices were given, but a uuid is available and
+        * --scan was set, then we should scan all devices listed in the
+        * config file
+        *
+        */
+       if (subdevs==0 && scan && uuidset)
+               devlist = conf_get_devs(conffile);
+
+       if (subdevs == 0 && devlist == NULL) {
+               fprintf(stderr, "mdctl: no devices given for %s\n", mddev);
+               return 1;
+       }
+       /* now for each device */
+       first_super.md_magic = 0;
+       for (i=0; i<MD_SB_DISKS; i++)
+               best[i] = -1;
+
+       while (subdevs || devlist) {
+               char *devname;
+               int this_uuid[4];
+               int dfd;
+               struct stat stb;
+               int inargv;
+               if (subdevs) {
+                       devname = *subdev++;
+                       subdevs--;
+                       inargv=1;
+               } else {
+                       devname = devlist->devname;
+                       devlist = devlist->next;
+                       inargv=0;
+               }
+
+               dfd = open(devname, O_RDONLY, 0);
+               if (dfd < 0) {
+                       if (inargv || verbose)
+                               fprintf(stderr, "mdctl: cannot open device %s: %s\n",
+                                       devname, strerror(errno));
+                       continue;
+               }
+               if (fstat(dfd, &stb)< 0) {
+                   /* Impossible! */
+                   fprintf(stderr, "mdctl: fstat failed for %s: %s\n",
+                           devname, strerror(errno));
+                   close(dfd);
+                   continue;
+               }
+               if ((stb.st_mode & S_IFMT) != S_IFBLK) {
+                   fprintf(stderr, "mdctl: %d is not a block device.\n",
+                           devname);
+                   close(dfd);
+                   continue;
+               }
+               if (load_super(dfd, &super)) {
+                       if (inargv || verbose)
+                               fprintf( stderr, "mdctl: no RAID superblock on %s\n",
+                                        devname);
+                       close(dfd);
+                       continue;
+               }
+               close(dfd);
+               if (compare_super(&first_super, &super)) {
+                       if (inargv || verbose)
+                               fprintf(stderr, "mdctl: superblock on %s doesn't match\n",
+                                       devname);
+                       continue;
+               }
+               if (uuidset) {
+                       uuid_from_super(this_uuid, &first_super);
+                       if (!same_uuid(this_uuid, uuid)) {
+                               if (inargv || verbose)
+                                       fprintf(stderr, "mdctl: %s has wrong uuid.\n",
+                                               devname);
+                               continue;
+                       }
+               } else {
+                       uuid_from_super(uuid, &first_super);
+                       uuidset = 1;
+               }
+
+               /* Ok, this one is at least worth considering */
+               if (devcnt >= MD_SB_DISKS) {
+                   fprintf(stderr, "mdctl: ouch - too many devices appear to be in this array. Ignoring %s\n",
+                           devname);
+                   continue;
+               }
+               devices[devcnt].devname = devname;
+               devices[devcnt].major = MAJOR(stb.st_rdev);
+               devices[devcnt].minor = MINOR(stb.st_rdev);
+               devices[devcnt].events = md_event(&super);
+               devices[devcnt].utime = super.utime;
+               devices[devcnt].uptodate = 0;
+               if (most_recent < devcnt) {
+                       if (devices[devcnt].events
+                           > devices[most_recent].events)
+                               most_recent = devcnt;
+               }
+               i = super.this_disk.raid_disk;
+               if (best[i] == -1
+                   || devices[best[i]].events < devices[devcnt].events) {
+                       best[i] = devcnt;
+               }
+               devcnt++;
+       }
+
+       if (devcnt == 0) {
+               fprintf(stderr, "mdctl: no devices found for %s\n",
+                       mddev);
+               return 1;
+       }
+       /* now we have some devices that might be suitable.
+        * I wonder how many
+        */
+       okcnt = 0;
+       for (i=0; i< first_super.raid_disks;i++) {
+               int j = best[i];
+               if (j < 0) continue;
+               if (devices[j].events+1 >=
+                   devices[most_recent].events) {
+                       devices[j].uptodate = 1;
+                       okcnt++;
+               }
+       }
+       while (force && !enough(first_super.level, first_super.raid_disks, okcnt)) {
+               /* Choose the newest best drive which is
+                * not up-to-date, update the superblock
+                * and add it.
+                */
+               fprintf(stderr,"NoImplementedYet\n");
+               /* FIXME */
+               exit(2);
+       }
+       /* Almost ready to actually *do* something */
+       if (!old_linux) {
+               if (ioctl(mdfd, SET_ARRAY_INFO, NULL) != 0) {
+                       fprintf(stderr, "mdctl: SET_ARRAY_INFO failed for %s: %s\n",
+                               mddev, strerror(errno));
+                       return 1;
+               }
+               /* First, add the raid disks */
+               for (i=0; i<first_super.raid_disks; i++) {
+                       int j = best[i];
+                       if (devices[j].uptodate) {
+                               mdu_disk_info_t disk;
+                               memset(&disk, 0, sizeof(disk));
+                               disk.major = devices[j].major;
+                               disk.minor = devices[j].minor;
+                               if (ioctl(mdfd, ADD_NEW_DISK, &disk)!=0) {
+                                       fprintf(stderr, "mdctl: failed to add %s to %s: %s\n",
+                                               devices[j].devname,
+                                               mddev,
+                                               strerror(errno));
+                               } else
+                                       okcnt--;
+                       } else if (verbose)
+                               fprintf(stderr, "mdctl: no uptodate device for slot %d of %s\n",
+                                       i, mddev);
+               }
+               if (runstop == 1 ||
+                   (runstop == 0 && 
+                    enough(first_super.level, first_super.raid_disks, okcnt))) {
+                       if (ioctl(mdfd, RUN_ARRAY, NULL)==0)
+                               return 0;
+                       fprintf(stderr, "mdctl: failed to RUN_ARRAY %s: %s\n",
+                               mddev, strerror(errno));
+                       return 1;
+               }
+               if (runstop == -1)
+                       return 0;
+               else return 1;
+       } else {
+               /* FIXME */
+               return 1;
+       }
+}
diff --git a/Build.c b/Build.c
new file mode 100644 (file)
index 0000000..bcad0a6
--- /dev/null
+++ b/Build.c
@@ -0,0 +1,36 @@
+/*
+ * mdctl - manage Linux "md" devices aka RAID arrays.
+ *
+ * Copyright (C) 2001 Neil Brown <neilb@cse.unsw.edu.au>
+ *
+ *
+ *    This program is free software; you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation; either version 2 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program; if not, write to the Free Software
+ *    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ *    Author: Neil Brown
+ *    Email: <neilb@cse.unsw.edu.au>
+ *    Paper: Neil Brown
+ *           School of Computer Science and Engineering
+ *           The University of New South Wales
+ *           Sydney, 2052
+ *           Australia
+ */
+
+#include "mdctl.h"
+
+int Build(char *mddev, int mdfd, int chunk, int level,
+         int raiddisks,
+         int subdevs, char *subdev[])
+{
+}
diff --git a/Create.c b/Create.c
new file mode 100644 (file)
index 0000000..dda54fd
--- /dev/null
+++ b/Create.c
@@ -0,0 +1,37 @@
+/*
+ * mdctl - manage Linux "md" devices aka RAID arrays.
+ *
+ * Copyright (C) 2001 Neil Brown <neilb@cse.unsw.edu.au>
+ *
+ *
+ *    This program is free software; you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation; either version 2 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program; if not, write to the Free Software
+ *    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ *    Author: Neil Brown
+ *    Email: <neilb@cse.unsw.edu.au>
+ *    Paper: Neil Brown
+ *           School of Computer Science and Engineering
+ *           The University of New South Wales
+ *           Sydney, 2052
+ *           Australia
+ */
+
+#include "mdctl.h"
+
+int Create(char *mddev, int mdfd,
+          int chunk, int level, int layout, int raiddisks, int sparedisks,
+          int subdevs, char *subdev[],
+          int runstop)
+{
+}
diff --git a/Detail.c b/Detail.c
new file mode 100644 (file)
index 0000000..9f81e04
--- /dev/null
+++ b/Detail.c
@@ -0,0 +1,120 @@
+/*
+ * mdctl - manage Linux "md" devices aka RAID arrays.
+ *
+ * Copyright (C) 2001 Neil Brown <neilb@cse.unsw.edu.au>
+ *
+ *
+ *    This program is free software; you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation; either version 2 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program; if not, write to the Free Software
+ *    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ *    Author: Neil Brown
+ *    Email: <neilb@cse.unsw.edu.au>
+ *    Paper: Neil Brown
+ *           School of Computer Science and Engineering
+ *           The University of New South Wales
+ *           Sydney, 2052
+ *           Australia
+ */
+
+#include       "mdctl.h"
+#include       "md_p.h"
+#include       "md_u.h"
+
+int Detail(char *dev)
+{
+       /*
+        * Print out details for an md array by using
+        * GET_ARRAY_INFO and GET_DISK_INFO ioctl calls
+        */
+
+       int fd = open(dev, O_RDONLY, 0);
+       int vers;
+       mdu_array_info_t array;
+       int d;
+       time_t atime;
+
+       if (fd < 0) {
+               fprintf(stderr, "mdctl: cannot open %s: %s\n",
+                       dev, strerror(errno));
+               return 1;
+       }
+       vers = md_get_version(fd);
+       if (vers < 0) {
+               fprintf(stderr, "mdctl: %s does not appear to be an md device\n",
+                       dev);
+               close(fd);
+               return 1;
+       }
+       if (vers < (90<<8)) {
+               fprintf(stderr, "mdctl: cannot get detail for md device %s: driver version too old.\n",
+                       dev);
+               close(fd);
+               return 1;
+       }
+       if (ioctl(fd, GET_ARRAY_INFO, &array)<0) {
+               if (errno == ENODEV)
+                       fprintf(stderr, "mdctl: md device %s does not appear to be active.\n",
+                               dev);
+               else
+                       fprintf(stderr, "mdctl: cannot get array detail for %s: %s\n",
+                               dev, strerror(errno));
+               close(fd);
+               return 1;
+       }
+       /* Ok, we have some info to print... */
+       printf("%s:\n", dev);
+       printf("        Version : %02d.%02d.%02d\n",
+              array.major_version, array.minor_version, array.patch_version);
+       atime = array.ctime;
+       printf("  Creation Time : %.24s\n", ctime(&atime));
+       printf("     Raid Level : %d\n", array.level);
+       printf("           Size : %d\n", array.size);
+       printf("     Raid Disks : %d\n", array.raid_disks);
+       printf("    Total Disks : %d\n", array.nr_disks);
+       printf("Preferred Minor : %d\n", array.md_minor);
+       printf("    Persistance : Superblock is %spersistant\n",
+              array.not_persistent?"not ":"");
+       printf("\n");
+       atime = array.utime;
+       printf("    Update Time : %.24s\n", ctime(&atime));
+       printf("          State : %s, %serrors\n",
+              (array.state&(1<<MD_SB_CLEAN))?"clean":"dirty",
+              (array.state&(1<<MD_SB_ERRORS))?"":"no-");
+       printf("  Active Drives : %d\n", array.active_disks);
+       printf(" Working Drives : %d\n", array.working_disks);
+       printf("  Failed Drives : %d\n", array.failed_disks);
+       printf("   Spare Drives : %d\n", array.spare_disks);
+       printf("\n");
+       printf("         Layout : %d\n", array.layout);
+       printf("     Chunk Size : %dK\n", array.chunk_size/1024);
+       printf("\n");
+       printf("    Number   Major   Minor   RaidDisk   State\n");
+       for (d= 0; d<array.nr_disks; d++) {
+               mdu_disk_info_t disk;
+               disk.number = d;
+               if (ioctl(fd, GET_DISK_INFO, &disk) < 0) {
+                       fprintf(stderr, "mdctl: cannot get disk detail for disk %d: %s\n",
+                               d, strerror(errno));
+                       continue;
+               }
+               printf("   %5d   %5d    %5d    %5d     ", 
+                      disk.number, disk.major, disk.minor, disk.raid_disk);
+               if (disk.state & (1<<MD_DISK_FAULTY)) printf(" faulty");
+               if (disk.state & (1<<MD_DISK_ACTIVE)) printf(" active");
+               if (disk.state & (1<<MD_DISK_SYNC)) printf(" sync");
+               if (disk.state & (1<<MD_DISK_REMOVED)) printf(" removed");
+               printf("\n");
+       }
+       return 0;
+}
diff --git a/Examine.c b/Examine.c
new file mode 100644 (file)
index 0000000..ea223c6
--- /dev/null
+++ b/Examine.c
@@ -0,0 +1,144 @@
+/*
+ * mdctl - manage Linux "md" devices aka RAID arrays.
+ *
+ * Copyright (C) 2001 Neil Brown <neilb@cse.unsw.edu.au>
+ *
+ *
+ *    This program is free software; you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation; either version 2 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program; if not, write to the Free Software
+ *    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ *    Author: Neil Brown
+ *    Email: <neilb@cse.unsw.edu.au>
+ *    Paper: Neil Brown
+ *           School of Computer Science and Engineering
+ *           The University of New South Wales
+ *           Sydney, 2052
+ *           Australia
+ */
+
+#include       "mdctl.h"
+
+#include       "md_u.h"
+#include       "md_p.h"
+int Examine(char *dev)
+{
+
+       /* Read the raid superblock from a device and
+        * display important content.
+        *
+        * If cannot be found, print reason: too small, bad magic
+        *
+        * Print:
+        *   version, ctime, level, size, raid+spare+
+        *   prefered minor
+        *   uuid
+        *
+        *   utime, state etc
+        *
+        */
+       int fd = open(dev, O_RDONLY, 0);
+       time_t atime;
+       mdp_super_t super;
+       int d;
+       int rv;
+
+       if (fd < 0) {
+               fprintf(stderr,"mdctl: cannot open %s: %s\n",
+                       dev, strerror(errno));
+               return 1;
+       }
+
+       rv = load_super(fd, &super);
+       close(fd);
+       switch(rv) {
+       case 1:
+               fprintf(stderr, "mdctl: cannot find device size for %s: %s\n",
+                       dev, strerror(errno));
+               return 1;
+       case 2:
+/*             fprintf(stderr, "mdctl: %s is too small for md: size is %ld sectors\n",
+                       dev, size);
+*/
+               fprintf(stderr, "mdctl: %s is too small for md\n",
+                       dev);
+               return 1;
+       case 3:
+               fprintf(stderr, "mdctl: Cannot seek to superblock on %s: %s\n",
+                       dev, strerror(errno));
+               return 1;
+       case 4:
+               fprintf(stderr, "mdctl: Cannot read superblock on %s\n",
+                       dev);
+               return 1;
+       case 5:
+               fprintf(stderr, "mdctl: No super block found on %s (Expected magic %08x, got %08x)\n",
+                       dev, MD_SB_MAGIC, super.md_magic);
+               return 1;
+       case 6:
+               fprintf(stderr, "mdctl: Cannot interpret superblock on %s - version is %d\n",
+                       dev, super.major_version);
+               return 1;
+       }
+    
+       /* Ok, its good enough to try, though the checksum could be wrong */
+       printf("%s:\n",dev);
+       printf("          Magic : %08x\n", super.md_magic);
+       printf("        Version : %02d.%02d.%02d\n", super.major_version, super.minor_version,
+              super.patch_version);
+       if (super.minor_version >= 90)
+               printf("           UUID : %08x:%08x:%08x:%08x\n", super.set_uuid0, super.set_uuid1,
+                      super.set_uuid2, super.set_uuid3);
+       else
+               printf("           UUID : %08x\n", super.set_uuid0);
+
+       atime = super.ctime;
+       printf("  Creation Time : %.24s\n", ctime(&atime));
+       printf("     Raid Level : %d\n", super.level);
+       printf("           Size : %d\n", super.size);
+       printf("     Raid Disks : %d\n", super.raid_disks);
+       printf("    Total Disks : %d\n", super.nr_disks);
+       printf("Preferred Minor : %d\n", super.md_minor);
+       printf("\n");
+       atime = super.utime;
+       printf("    Update Time : %.24s\n", ctime(&atime));
+       printf("          State : %s, %serrors\n",
+              (super.state&(1<<MD_SB_CLEAN))?"clean":"dirty",
+              (super.state&(1<<MD_SB_ERRORS))?"":"no-");
+       printf("  Active Drives : %d\n", super.active_disks);
+       printf(" Working Drives : %d\n", super.working_disks);
+       printf("  Failed Drives : %d\n", super.failed_disks);
+       printf("   Spare Drives : %d\n", super.spare_disks);
+       printf("   - checksum not checked yet - \n");
+       printf("         Events : %d.%d\n", super.events_hi, super.events_lo);
+       printf("\n");
+       printf("         Layout : %d\n", super.layout);
+       printf("     Chunk Size : %dK\n", super.chunk_size/1024);
+       printf("\n");
+       printf("      Number   Major   Minor   RaidDisk   State\n");
+       for (d= -1; d<(signed int)super.nr_disks; d++) {
+               mdp_disk_t *dp;
+               char nb[5];
+               if (d>=0) dp = &super.disks[d];
+               else dp = &super.this_disk;
+               sprintf(nb, "%4d", d);
+               printf("%4s %5d   %5d    %5d    %5d     ", d < 0 ? "this" :  nb,
+                      dp->number, dp->major, dp->minor, dp->raid_disk);
+               if (dp->state & (1<<MD_DISK_FAULTY)) printf(" faulty");
+               if (dp->state & (1<<MD_DISK_ACTIVE)) printf(" active");
+               if (dp->state & (1<<MD_DISK_SYNC)) printf(" sync");
+               if (dp->state & (1<<MD_DISK_REMOVED)) printf(" removed");
+               printf("\n");
+       }
+       return 0;
+}
diff --git a/Makefile b/Makefile
new file mode 100644 (file)
index 0000000..4fe9ba8
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,44 @@
+#
+# mdctl - manage Linux "md" devices aka RAID arrays.
+#
+# Copyright (C) 2001 Neil Brown <neilb@cse.unsw.edu.au>
+#
+#
+#    This program is free software; you can redistribute it and/or modify
+#    it under the terms of the GNU General Public License as published by
+#    the Free Software Foundation; either version 2 of the License, or
+#    (at your option) any later version.
+#
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU General Public License for more details.
+#
+#    You should have received a copy of the GNU General Public License
+#    along with this program; if not, write to the Free Software
+#    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#
+#    Author: Neil Brown
+#    Email: <neilb@cse.unsw.edu.au>
+#    Paper: Neil Brown
+#           School of Computer Science and Engineering
+#           The University of New South Wales
+#           Sydney, 2052
+#           Australia
+#
+
+CFLAGS = -Wall,error
+
+OBJS =  mdctl.o config.o  ReadMe.o util.o Manage.o Assemble.o Build.o Create.o Detail.o Examine.o
+all : mdctl
+
+mdctl : $(OBJS)
+       $(CC) -o mdctl $^
+
+$(OBJS) : mdctl.h
+
+clean : 
+       rm -f mdctl $(OBJS)
+
+dist : clean
+       ./makedist
diff --git a/Manage.c b/Manage.c
new file mode 100644 (file)
index 0000000..302a425
--- /dev/null
+++ b/Manage.c
@@ -0,0 +1,43 @@
+/*
+ * mdctl - manage Linux "md" devices aka RAID arrays.
+ *
+ * Copyright (C) 2001 Neil Brown <neilb@cse.unsw.edu.au>
+ *
+ *
+ *    This program is free software; you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation; either version 2 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program; if not, write to the Free Software
+ *    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ *    Author: Neil Brown
+ *    Email: <neilb@cse.unsw.edu.au>
+ *    Paper: Neil Brown
+ *           School of Computer Science and Engineering
+ *           The University of New South Wales
+ *           Sydney, 2052
+ *           Australia
+ */
+
+#include "mdctl.h"
+
+int Manage_ro(char *devname, int fd, int readonly)
+{
+}
+
+int Manage_runstop(char *devname, int fd, int runstop)
+{
+}
+
+int Manage_subdevs(char *devname, int fd,
+                  int devcnt, char *devnames[], int devmodes[])
+{
+}
diff --git a/ReadMe.c b/ReadMe.c
new file mode 100644 (file)
index 0000000..e07cc42
--- /dev/null
+++ b/ReadMe.c
@@ -0,0 +1,246 @@
+/*
+ * mdctl - manage Linux "md" devices aka RAID arrays.
+ *
+ * Copyright (C) 2001 Neil Brown <neilb@cse.unsw.edu.au>
+ *
+ *
+ *    This program is free software; you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation; either version 2 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program; if not, write to the Free Software
+ *    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ *    Author: Neil Brown
+ *    Email: <neilb@cse.unsw.edu.au>
+ *    Paper: Neil Brown
+ *           School of Computer Science and Engineering
+ *           The University of New South Wales
+ *           Sydney, 2052
+ *           Australia
+ */
+
+#include "mdctl.h"
+
+char Version[] = "mdctl - v0.2 - 06 June 2001\n";
+/*
+ * File: ReadMe.c
+ *
+ * This file contains general comments about the implementation
+ * and the various usage messages that can be displayed by mdctl
+ *
+ * mdctl is a single program that can be used to control Linux md devices.
+ * It is intended to provide all the functionality of the mdtools and
+ * raidtools but with a very different interface.
+ * mdctl can perform all functions without a configuration file.
+ * There is the option of using a configuration file, but not in the same
+ * way that raidtools uses one
+ * raidtools uses a configuration file to describe how to create a RAID
+ * array, and also uses this file partially to start a previously
+ * created RAID array.  Further, raidtools requires the configuration
+ * file for such things as stopping a raid array which needs to know
+ * nothing about the array.
+ *
+ * The configuration file that can be used by mdctl lists two
+ * different things:
+ * 1/ a mapping from uuid to md device to identify which arrays are
+ *    expect and what names (numbers) they should be given
+ * 2/ a list of devices that should be scanned for md sub-devices
+ *
+ *
+ */
+
+/*
+ * mdctl has 4 major modes of operation:
+ * 1/ Create
+ *     This mode is used to create a new array with a superbock
+ *     It can progress in several step create-add-add-run
+ *     or it can all happen with one command
+ * 2/ Assemble
+ *     This mode is used to assemble the parts of a previously created
+ *     array into an active array.  Components can be explicitly given
+ *     or can be searched for.  mdctl (optionally) check that the components
+ *     do form a bonafide array, and can, on request, fiddle superblock
+ *     version numbers so as to assemble a faulty array.
+ * 3/ Build
+ *     This is for building legacy arrays without superblocks
+ * 4/ Manage
+ *     This is for odd bits an pieces like hotadd, hotremove, setfaulty,
+ *     stop, readonly,readwrite
+ *     If an array is only partially setup by the Create/Assemble/Build
+ *     command, subsequent Manage commands can finish the job.
+ */
+
+char short_options[]="-ABCDEhVvc:l:p:n:x:u:c:sarfRSow";
+struct option long_options[] = {
+    {"manage",    0, 0, '@'},
+    {"assemble",  0, 0, 'A'},
+    {"build",     0, 0, 'B'},
+    {"create",    0, 0, 'C'},
+    {"detail",    0, 0, 'D'},
+    {"examine",   0, 0, 'E'},
+    /* after those will normally come the name of the md device */
+    {"help",      0, 0, 'h'},
+    {"version",          0, 0, 'V'},
+    {"verbose",   0, 0, 'v'},
+
+    /* For create or build: */
+    {"chunk",    1, 0, 'c'},
+    {"rounding",  1, 0, 'c'}, /* for linear, chunk is really a rounding number */
+    {"level",     1, 0, 'l'}, /* 0,1,4,5,linear */
+    {"parity",    1, 0, 'p'}, /* {left,right}-{a,}symetric */
+    {"layout",    1, 0, 'p'},
+    {"raid-disks",1, 0, 'n'},
+    {"spare-disks",1,0, 'x'},
+
+    /* For assemble */
+    {"uuid",      1, 0, 'u'},
+    {"config",    1, 0, 'c'},
+    {"scan",      0, 0, 's'},
+    {"force",    0, 0, 'f'},
+    /* Management */
+    {"add",       0, 0, 'a'},
+    {"remove",    0, 0, 'r'},
+    {"fail",      0, 0, 'f'},
+    {"set-faulty",0, 0, 'f'},
+    {"run",       0, 0, 'R'},
+    {"stop",      0, 0, 'S'},
+    {"readonly",  0, 0, 'o'},
+    {"readwrite", 0, 0, 'w'},
+    
+    {0, 0, 0, 0}
+};
+
+char Usage[] =
+"Usage: mdctl --help\n"
+"  for help\n"
+;
+
+char Help[] =
+"Usage: mdctl --create device options...\n"
+"       mdctl --assemble device options...\n"
+"       mdctl --build device options...\n"
+"       mdctl --detail device\n"
+"       mdctl --examine device\n"
+"       mdctl device options...\n"
+" mdctl is used for controlling Linux md devices (aka RAID arrays)\n"
+" For detail help on major modes use, e.g.\n"
+"         mdctl --assemble --help\n"
+"\n"
+"Any parameter that does not start with '-' is treated as a device name\n"
+"The first such name is normally the name of an md device.  Subsequent\n"
+"names are names of component devices."
+"\n"
+"Available options are:\n"
+"  --create      -C   : Create a new array\n"
+"  --assemble    -A   : Assemble an existing array\n"
+"  --build       -B   : Build a legacy array without superblock\n"
+"  --detail      -D   : Print detail of a given md array\n"
+"  --examine     -E   : Print content of md superblock on device\n"
+"  --help        -h   : This help message or, after above option,\n"
+"                       mode specific help message\n"
+"  --version     -V   : Print version information for mdctl\n"
+"  --verbose     -v   : Be more verbose about what is happening\n"
+"\n"
+" For create or build:\n"
+"  --chunk=      -c   : chunk size of kibibytes\n"
+"  --rounding=        : rounding factor for linear array (==chunck size)\n"
+"  --level=      -l   : raid level: 0,1,4,5,linear.  0 or linear for build\n"
+"  --paritiy=    -p   : raid5 parity algorith: {left,right}-{,a}symmetric\n"
+"  --layout=          : same as --parity\n"
+"  --raid-disks= -n   : number of active devices in array\n"
+"  --spare-disks= -x  : number of spares (eXtras) to allow space for\n"
+"\n"
+" For assemble:\n"
+"  --uuid=       -u   : uuid of array to assemble. Devices which don't\n"
+"                       have this uuid are excluded\n"
+"  --config=     -c   : config file\n"
+"  --scan        -s   : scan config file for missing information\n"
+"  --force       -f   : Assemble the array even if some superblocks appear out-of-date\n"
+"\n"
+" General management:\n"
+"  --add         -a   : add, or hotadd subsequent devices\n"
+"  --remove      -r   : remove subsequent devices\n"
+"  --fail        -f   : mark subsequent devices a faulty\n"
+"  --set-faulty       : same as --fail\n"
+"  --run         -R   : start a partially built array\n"
+"  --stop        -S   : deactive array, releasing all resources\n"
+"  --readonly    -o   : mark array as readonly\n"
+"  --readwrite   -w   : mark array as readwrite\n"
+;
+
+
+char Help_create[] =
+"Usage:  mdctl --create device -chunk=X --level=Y --raid-disks=Z devices\n"
+"\n"
+" This usage will initialise a new md array and possibly associate some\n"
+" devices with it.  If enough devices are given to complete the array,\n"
+" the array will be activated.  Otherwise it will be left inactive\n"
+" to be competed and activated by subsequent management commands.\n"
+"\n"
+" As devices are added, they are checked to see if they contain\n"
+" raid superblock or filesystems.  They are also check to see if\n"
+" the variance in device size exceeds 1%.\n"
+" If any discrepancy is found, the array will not automatically\n"
+" be run, though the presence of a '--run' can override this\n"
+" caution.\n"
+"\n"
+" The General management options that are valid with --create are:\n"
+"   --run   : insist of running the array even if not all devices\n"
+"             are present or some look odd.\n"
+"   --readonly: start the array readonly - not supported yet.\n"
+"\n"
+;
+
+char Help_build[] =
+"Usage:  mdctl --build device -chunk=X --level=Y --raid-disks=Z devices\n"
+"\n"
+" This usage is similar to --create.  The difference is that it creates\n"
+" a legacy array with a superblock.  With these arrays there is no\n"
+" different between initially creating the array and subsequently\n"
+" assembling the array, except that hopefully there is useful data\n"
+" there in the second case.\n"
+"\n"
+" The level may only be 0 or linear.\n"
+" All devices must be listed and the array will be started once complete.\n"
+;
+
+char Help_assemble[] =
+"Usage: mdctl --assemble device options...\n"
+"       mdctl --assemble --scan options...\n"
+"\n"
+"This usage assembles one or more raid arrays from pre-existing\n"
+"components.\n"
+"For each array, mdctl needs to know the md device, the uuid, and\n"
+"a number of sub devices.  These can be found in a number of ways.\n"
+"\n"
+"The md device is either given before --scan or is found from the\n"
+"config file.  In the latter case, multiple md devices can be started\n"
+"with a single mdctl command.\n"
+"\n"
+"The uuid can be given with the --uuid option, or can be found in\n"
+"in the config file, or will be taken from the super block on the first\n"
+"subdevice listed on the command line or in a subsequent --add command.\n"
+"\n"
+"Devices can be given on the --assemble command line, on subsequent\n"
+"'mdctl --add' command lines, or from the config file.  Only devices\n"
+"which have an md superblock which contains the right uuid will be\n"
+"considered for any device.\n"
+"\n"
+"The config file is only used if explicitly named with --config or\n"
+"requested with --scan.  In the later case, '/etc/md.conf' is used.\n"
+"\n"
+"If --scan is not given, then the config file will only be used\n"
+"to find uuids for md arrays.\n"
+"\n"
+"The format of the config file is:\n"
+"   not yet documented\n"
+"\n"
+;
diff --git a/TODO b/TODO
new file mode 100644 (file)
index 0000000..62dab1c
--- /dev/null
+++ b/TODO
@@ -0,0 +1,7 @@
+
+- check superblock checksum in examine
+- report "chunk" or "rounding" depending on raid level
+- report "linear" instead of "-1" for raid level
+- decode ayout depending on raid level
+- get Assemble to upgrade devices if force flag.
+- --verbose and --force flags.
\ No newline at end of file
diff --git a/config.c b/config.c
new file mode 100644 (file)
index 0000000..b4d235c
--- /dev/null
+++ b/config.c
@@ -0,0 +1,54 @@
+/*
+ * mdctl - manage Linux "md" devices aka RAID arrays.
+ *
+ * Copyright (C) 2001 Neil Brown <neilb@cse.unsw.edu.au>
+ *
+ *
+ *    This program is free software; you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation; either version 2 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program; if not, write to the Free Software
+ *    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ *    Author: Neil Brown
+ *    Email: <neilb@cse.unsw.edu.au>
+ *    Paper: Neil Brown
+ *           School of Computer Science and Engineering
+ *           The University of New South Wales
+ *           Sydney, 2052
+ *           Australia
+ */
+
+#include       "mdctl.h"
+
+/*
+ * Read the config file
+ *
+ * conf_get_uuids gets a list of devicename+uuid pairs
+ * conf_get_devs gets device names after expanding wildcards
+ *
+ * Each keeps the returned list and frees it when asked to make
+ * a new list.
+ *
+ */
+
+char DefaultConfFile[] = "/etc/mdctl.conf";
+
+mddev_uuid_t conf_get_uuids(char *conffile)
+{
+    return NULL;
+}
+
+mddev_dev_t conf_get_devs(char *conffile)
+{
+    return NULL;
+}
+
diff --git a/makedist b/makedist
new file mode 100755 (executable)
index 0000000..5b6db54
--- /dev/null
+++ b/makedist
@@ -0,0 +1,20 @@
+#!/bin/sh
+
+target=${1-~/public_html/source/mdctl}
+if [ -d $target ]
+then :
+else echo $target is not a directory
+     exit 2
+fi
+set `grep '^char Version' ReadMe.c `
+echo version = $6
+base=mdctl-$6.tgz
+if [ -f $target/$base ] 
+then 
+  echo $target/$base exists.
+  exit 1
+fi
+trap "rm $target/$base; exit" 1 2 3
+( cd .. ; tar czvf - mdctl )  > $target/$base
+chmod a+r $target/$base
+ls -l $target/$base
\ No newline at end of file
diff --git a/md_p.h b/md_p.h
new file mode 100644 (file)
index 0000000..d6bb37a
--- /dev/null
+++ b/md_p.h
@@ -0,0 +1,172 @@
+/*
+   md_p.h : physical layout of Linux RAID devices
+          Copyright (C) 1996-98 Ingo Molnar, Gadi Oxman
+         
+   This program is free software; you can redistribute it and/or modify
+   it under the terms of the GNU General Public License as published by
+   the Free Software Foundation; either version 2, or (at your option)
+   any later version.
+   
+   You should have received a copy of the GNU General Public License
+   (for example /usr/src/linux/COPYING); if not, write to the Free
+   Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  
+*/
+
+#ifndef _MD_P_H
+#define _MD_P_H
+
+/*
+ * RAID superblock.
+ *
+ * The RAID superblock maintains some statistics on each RAID configuration.
+ * Each real device in the RAID set contains it near the end of the device.
+ * Some of the ideas are copied from the ext2fs implementation.
+ *
+ * We currently use 4096 bytes as follows:
+ *
+ *     word offset     function
+ *
+ *        0  -    31   Constant generic RAID device information.
+ *        32  -    63   Generic state information.
+ *       64  -   127   Personality specific information.
+ *      128  -   511   12 32-words descriptors of the disks in the raid set.
+ *      512  -   911   Reserved.
+ *      912  -  1023   Disk specific descriptor.
+ */
+
+/*
+ * If x is the real device size in bytes, we return an apparent size of:
+ *
+ *     y = (x & ~(MD_RESERVED_BYTES - 1)) - MD_RESERVED_BYTES
+ *
+ * and place the 4kB superblock at offset y.
+ */
+#define MD_RESERVED_BYTES              (64 * 1024)
+#define MD_RESERVED_SECTORS            (MD_RESERVED_BYTES / 512)
+#define MD_RESERVED_BLOCKS             (MD_RESERVED_BYTES / BLOCK_SIZE)
+
+#define MD_NEW_SIZE_SECTORS(x)         ((x & ~(MD_RESERVED_SECTORS - 1)) - MD_RESERVED_SECTORS)
+#define MD_NEW_SIZE_BLOCKS(x)          ((x & ~(MD_RESERVED_BLOCKS - 1)) - MD_RESERVED_BLOCKS)
+
+#define MD_SB_BYTES                    4096
+#define MD_SB_WORDS                    (MD_SB_BYTES / 4)
+#define MD_SB_BLOCKS                   (MD_SB_BYTES / BLOCK_SIZE)
+#define MD_SB_SECTORS                  (MD_SB_BYTES / 512)
+
+/*
+ * The following are counted in 32-bit words
+ */
+#define        MD_SB_GENERIC_OFFSET            0
+#define MD_SB_PERSONALITY_OFFSET       64
+#define MD_SB_DISKS_OFFSET             128
+#define MD_SB_DESCRIPTOR_OFFSET                992
+
+#define MD_SB_GENERIC_CONSTANT_WORDS   32
+#define MD_SB_GENERIC_STATE_WORDS      32
+#define MD_SB_GENERIC_WORDS            (MD_SB_GENERIC_CONSTANT_WORDS + MD_SB_GENERIC_STATE_WORDS)
+#define MD_SB_PERSONALITY_WORDS                64
+#define MD_SB_DESCRIPTOR_WORDS         32
+#define MD_SB_DISKS                    27
+#define MD_SB_DISKS_WORDS              (MD_SB_DISKS*MD_SB_DESCRIPTOR_WORDS)
+#define MD_SB_RESERVED_WORDS           (1024 - MD_SB_GENERIC_WORDS - MD_SB_PERSONALITY_WORDS - MD_SB_DISKS_WORDS - MD_SB_DESCRIPTOR_WORDS)
+#define MD_SB_EQUAL_WORDS              (MD_SB_GENERIC_WORDS + MD_SB_PERSONALITY_WORDS + MD_SB_DISKS_WORDS)
+
+/*
+ * Device "operational" state bits
+ */
+#define MD_DISK_FAULTY         0 /* disk is faulty / operational */
+#define MD_DISK_ACTIVE         1 /* disk is running or spare disk */
+#define MD_DISK_SYNC           2 /* disk is in sync with the raid set */
+#define MD_DISK_REMOVED                3 /* disk is in sync with the raid set */
+
+typedef struct mdp_device_descriptor_s {
+       __u32 number;           /* 0 Device number in the entire set          */
+       __u32 major;            /* 1 Device major number                      */
+       __u32 minor;            /* 2 Device minor number                      */
+       __u32 raid_disk;        /* 3 The role of the device in the raid set   */
+       __u32 state;            /* 4 Operational state                        */
+       __u32 reserved[MD_SB_DESCRIPTOR_WORDS - 5];
+} mdp_disk_t;
+
+#define MD_SB_MAGIC            0xa92b4efc
+
+/*
+ * Superblock state bits
+ */
+#define MD_SB_CLEAN            0
+#define MD_SB_ERRORS           1
+
+typedef struct mdp_superblock_s {
+       /*
+        * Constant generic information
+        */
+       __u32 md_magic;         /*  0 MD identifier                           */
+       __u32 major_version;    /*  1 major version to which the set conforms */
+       __u32 minor_version;    /*  2 minor version ...                       */
+       __u32 patch_version;    /*  3 patchlevel version ...                  */
+       __u32 gvalid_words;     /*  4 Number of used words in this section    */
+       __u32 set_uuid0;        /*  5 Raid set identifier                     */
+       __u32 ctime;            /*  6 Creation time                           */
+       __u32 level;            /*  7 Raid personality                        */
+       __u32 size;             /*  8 Apparent size of each individual disk   */
+       __u32 nr_disks;         /*  9 total disks in the raid set             */
+       __u32 raid_disks;       /* 10 disks in a fully functional raid set    */
+       __u32 md_minor;         /* 11 preferred MD minor device number        */
+       __u32 not_persistent;   /* 12 does it have a persistent superblock    */
+       __u32 set_uuid1;        /* 13 Raid set identifier #2                  */
+       __u32 set_uuid2;        /* 14 Raid set identifier #3                  */
+       __u32 set_uuid3;        /* 15 Raid set identifier #4                  */
+       __u32 gstate_creserved[MD_SB_GENERIC_CONSTANT_WORDS - 16];
+
+       /*
+        * Generic state information
+        */
+       __u32 utime;            /*  0 Superblock update time                  */
+       __u32 state;            /*  1 State bits (clean, ...)                 */
+       __u32 active_disks;     /*  2 Number of currently active disks        */
+       __u32 working_disks;    /*  3 Number of working disks                 */
+       __u32 failed_disks;     /*  4 Number of failed disks                  */
+       __u32 spare_disks;      /*  5 Number of spare disks                   */
+       __u32 sb_csum;          /*  6 checksum of the whole superblock        */
+#ifdef __BIG_ENDIAN
+       __u32 events_hi;        /*  7 high-order of superblock update count   */
+       __u32 events_lo;        /*  8 low-order of superblock update count    */
+#else
+       __u32 events_lo;        /*  7 low-order of superblock update count    */
+       __u32 events_hi;        /*  8 high-order of superblock update count   */
+#endif
+       __u32 gstate_sreserved[MD_SB_GENERIC_STATE_WORDS - 9];
+
+       /*
+        * Personality information
+        */
+       __u32 layout;           /*  0 the array's physical layout             */
+       __u32 chunk_size;       /*  1 chunk size in bytes                     */
+       __u32 root_pv;          /*  2 LV root PV */
+       __u32 root_block;       /*  3 LV root block */
+       __u32 pstate_reserved[MD_SB_PERSONALITY_WORDS - 4];
+
+       /*
+        * Disks information
+        */
+       mdp_disk_t disks[MD_SB_DISKS];
+
+       /*
+        * Reserved
+        */
+       __u32 reserved[MD_SB_RESERVED_WORDS];
+
+       /*
+        * Active descriptor
+        */
+       mdp_disk_t this_disk;
+
+} mdp_super_t;
+
+static inline __u64 md_event(mdp_super_t *sb) {
+       __u64 ev = sb->events_hi;
+       return (ev<<32)| sb->events_lo;
+}
+
+#endif 
+
diff --git a/md_u.h b/md_u.h
new file mode 100644 (file)
index 0000000..22a1543
--- /dev/null
+++ b/md_u.h
@@ -0,0 +1,116 @@
+/*
+   md_u.h : user <=> kernel API between Linux raidtools and RAID drivers
+          Copyright (C) 1998 Ingo Molnar
+         
+   This program is free software; you can redistribute it and/or modify
+   it under the terms of the GNU General Public License as published by
+   the Free Software Foundation; either version 2, or (at your option)
+   any later version.
+   
+   You should have received a copy of the GNU General Public License
+   (for example /usr/src/linux/COPYING); if not, write to the Free
+   Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  
+*/
+
+#ifndef _MD_U_H
+#define _MD_U_H
+
+/* ioctls */
+
+/* status */
+#define RAID_VERSION           _IOR (MD_MAJOR, 0x10, mdu_version_t)
+#define GET_ARRAY_INFO         _IOR (MD_MAJOR, 0x11, mdu_array_info_t)
+#define GET_DISK_INFO          _IOR (MD_MAJOR, 0x12, mdu_disk_info_t)
+#define PRINT_RAID_DEBUG       _IO (MD_MAJOR, 0x13)
+#define RAID_AUTORUN           _IO (MD_MAJOR, 0x14)
+
+/* configuration */
+#define CLEAR_ARRAY            _IO (MD_MAJOR, 0x20)
+#define ADD_NEW_DISK           _IOW (MD_MAJOR, 0x21, mdu_disk_info_t)
+#define HOT_REMOVE_DISK                _IO (MD_MAJOR, 0x22)
+#define SET_ARRAY_INFO         _IOW (MD_MAJOR, 0x23, mdu_array_info_t)
+#define SET_DISK_INFO          _IO (MD_MAJOR, 0x24)
+#define WRITE_RAID_INFO                _IO (MD_MAJOR, 0x25)
+#define UNPROTECT_ARRAY                _IO (MD_MAJOR, 0x26)
+#define PROTECT_ARRAY          _IO (MD_MAJOR, 0x27)
+#define HOT_ADD_DISK           _IO (MD_MAJOR, 0x28)
+#define SET_DISK_FAULTY                _IO (MD_MAJOR, 0x29)
+
+/* usage */
+#define RUN_ARRAY              _IOW (MD_MAJOR, 0x30, mdu_param_t)
+#define START_ARRAY            _IO (MD_MAJOR, 0x31)
+#define STOP_ARRAY             _IO (MD_MAJOR, 0x32)
+#define STOP_ARRAY_RO          _IO (MD_MAJOR, 0x33)
+#define RESTART_ARRAY_RW       _IO (MD_MAJOR, 0x34)
+
+typedef struct mdu_version_s {
+       int major;
+       int minor;
+       int patchlevel;
+} mdu_version_t;
+
+typedef struct mdu_array_info_s {
+       /*
+        * Generic constant information
+        */
+       int major_version;
+       int minor_version;
+       int patch_version;
+       int ctime;
+       int level;
+       int size;
+       int nr_disks;
+       int raid_disks;
+       int md_minor;
+       int not_persistent;
+
+       /*
+        * Generic state information
+        */
+       int utime;              /*  0 Superblock update time                  */
+       int state;              /*  1 State bits (clean, ...)                 */
+       int active_disks;       /*  2 Number of currently active disks        */
+       int working_disks;      /*  3 Number of working disks                 */
+       int failed_disks;       /*  4 Number of failed disks                  */
+       int spare_disks;        /*  5 Number of spare disks                   */
+
+       /*
+        * Personality information
+        */
+       int layout;             /*  0 the array's physical layout             */
+       int chunk_size; /*  1 chunk size in bytes                     */
+
+} mdu_array_info_t;
+
+typedef struct mdu_disk_info_s {
+       /*
+        * configuration/status of one particular disk
+        */
+       int number;
+       int major;
+       int minor;
+       int raid_disk;
+       int state;
+
+} mdu_disk_info_t;
+
+typedef struct mdu_start_info_s {
+       /*
+        * configuration/status of one particular disk
+        */
+       int major;
+       int minor;
+       int raid_disk;
+       int state;
+
+} mdu_start_info_t;
+
+typedef struct mdu_param_s
+{
+       int                     personality;    /* 1,2,3,4 */
+       int                     chunk_size;     /* in bytes */
+       int                     max_fault;      /* unused for now */
+} mdu_param_t;
+
+#endif 
+
diff --git a/mdctl.c b/mdctl.c
new file mode 100644 (file)
index 0000000..a2ece91
--- /dev/null
+++ b/mdctl.c
@@ -0,0 +1,395 @@
+/*
+ * mdctl - manage Linux "md" devices aka RAID arrays.
+ *
+ * Copyright (C) 2001 Neil Brown <neilb@cse.unsw.edu.au>
+ *
+ *
+ *    This program is free software; you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation; either version 2 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program; if not, write to the Free Software
+ *    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ *    Author: Neil Brown
+ *    Email: <neilb@cse.unsw.edu.au>
+ *    Paper: Neil Brown
+ *           School of Computer Science and Engineering
+ *           The University of New South Wales
+ *           Sydney, 2052
+ *           Australia
+ */
+
+#include "mdctl.h"
+#include "md_p.h"
+
+int main(int argc, char *argv[])
+{
+    char mode = '\0';
+    int opt;
+    char *help_text;
+    char *c;
+    int rv;
+    int i;
+
+    int chunk = 0;
+    int level = -10;
+    int layout = -1;
+    int raiddisks = 0;
+    int sparedisks = 0;
+    int uuid[4];
+    int uuidset = 0;
+    char *configfile = NULL;
+    int scan = 0;
+    char devmode = 0;
+    int runstop = 0;
+    int readonly = 0;
+    char *mddev = NULL;
+    char *subdev[MD_SB_DISKS];
+    int devmodes[MD_SB_DISKS];
+    int subdevs = 0;
+    int verbose = 0;
+    int force = 0;
+
+    int mdfd = -1;
+
+    while ((opt=getopt_long(argc, argv,
+                           short_options, long_options,
+                           NULL)) != -1) {
+       
+       switch(opt) {
+       case '@': /* just incase they say --manage */
+       case 'A':
+       case 'B':
+       case 'C':
+       case 'D':
+       case 'E':
+           /* setting mode - only once */
+           if (mode) {
+               fprintf(stderr, "mdctl: --%s/-%c not allowed, mode already set to %s\n",
+                       long_options[opt-'A'+1].name,
+                       long_options[opt-'A'+1].val,
+                       long_options[mode-'A'+1].name);
+               exit(2);
+           }
+           mode = opt;
+           continue;
+
+       case 'h':
+           help_text = Help;
+           switch (mode) {
+           case 'C': help_text = Help_create; break;
+           case 'B': help_text = Help_build; break;
+           case 'A': help_text = Help_assemble; break;
+           }
+           fputs(help_text,stderr);
+           exit(0);
+
+       case 'V':
+           fputs(Version, stderr);
+           exit(0);
+
+       case 'v': verbose = 1;
+               continue;
+
+       case 1: /* an undecorated option - must be a device name.
+                * The first device is the "md" device unless scan
+                * has been set or mode is Examine or Detail
+                */
+           if (mddev == NULL && !scan && mode != 'E' && mode != 'D')
+               mddev = optarg;
+           else {
+               if (subdevs +1 >= MD_SB_DISKS) {
+                   fprintf(stderr, "mdctl: too many devices at %s - current limit -s %d\n",
+                           optarg, MD_SB_DISKS);
+                   exit(2);
+               }
+               subdev[subdevs] = optarg;
+               devmodes[subdevs] = devmode;
+               subdevs++;
+           }
+           continue;
+
+       case ':':
+       case '?':
+           fputs(Usage, stderr);
+           exit(2);
+       default:
+           /* force mode setting - @==manage if nothing else */
+           if (!mode) mode = '@';
+       }
+
+       /* We've got a mode, and opt is now something else which
+        * could depend on the mode */
+#define O(a,b) ((a<<8)|b)
+       switch (O(mode,opt)) {
+       case O('C','c'):
+       case O('B','c'): /* chunk or rounding */
+           if (chunk) {
+               fprintf(stderr, "mdctl: chunk/rounding may only be specified once. "
+                       "Second value is %s.\n", optarg);
+               exit(2);
+           }
+           chunk = strtol(optarg, &c, 10);
+           if (!optarg[0] || *c) {
+               fprintf(stderr, "mdctl: invalid chunk/rounding value: %s\n",
+                       optarg);
+               exit(2);
+           }
+           continue;
+
+       case O('C','l'):
+       case O('B','l'): /* set raid level*/
+           if (level != -10) {
+               fprintf(stderr, "mdctl: raid level may only be set once.  "
+                       "Second value is %s.\n", optarg);
+               exit(2);
+           }
+           if (strcmp(optarg,"linear")==0)
+               level = -1;
+           else if (strlen(optarg)==1 && strchr("01245", optarg[0]))
+               level = optarg[0]-'0';
+           else {
+               fprintf(stderr, "mdctl: invalid raid level: %s\n",
+                       optarg);
+               exit(2);
+           }
+           if (level > 0 && mode == 'B') {
+               fprintf(stderr, "mdctl: Raid level %s not permitted with --build.\n",
+                       optarg);
+               exit(2);
+           }
+           if (layout >=0 && level < 4) {
+               fprintf(stderr, "mdctl: raid level %s is incompatible with layout setting\n",
+                       optarg);
+               exit(2);
+           }
+           if (sparedisks > 0 && level < 1) {
+               fprintf(stderr, "mdctl: raid level %s is incompatible with spare-disks setting.\n",
+                       optarg);
+               exit(2);
+           }
+           continue;
+
+       case O('C','p'): /* raid5 layout */
+           if (layout >= 0) {
+               fprintf(stderr,"mdctl: layout may only be sent once.  "
+                       "Second value was %s\n", optarg);
+               exit(2);
+           }
+           if (level > -10 && level < 4) {
+               fprintf(stderr,"mdctl: layout is incompatible with raid levels below 4.\n");
+               exit(2);
+           }
+           if (strcmp(optarg, "left-symmetric")==0 || strcmp(optarg,"ls")==0)
+               layout = ALGORITHM_LEFT_SYMMETRIC;
+           else if (strcmp(optarg, "left-asymmetric")==0 || strcmp(optarg,"la")==0)
+               layout = ALGORITHM_LEFT_ASYMMETRIC;
+           else if (strcmp(optarg, "right-symmetric")==0 || strcmp(optarg,"rs")==0)
+               layout = ALGORITHM_RIGHT_SYMMETRIC;
+           else if (strcmp(optarg, "right-asymmetric")==0 || strcmp(optarg,"ra")==0)
+               layout = ALGORITHM_RIGHT_ASYMMETRIC;
+           else {
+               fprintf(stderr,"mdctl: %s is not a valid layout value\n",
+                       optarg);
+               exit(2);
+           }
+           continue;
+
+       case O('C','n'):
+       case O('B','n'): /* number of raid disks */
+           if (raiddisks) {
+               fprintf(stderr, "mdctl: raid-disks set twice: %d and %s\n",
+                       raiddisks, optarg);
+               exit(2);
+           }
+           raiddisks = strtol(optarg, &c, 10);
+           if (!optarg[0] || *c || raiddisks<=0 || raiddisks > MD_SB_DISKS) {
+               fprintf(stderr, "mdctl: invalid number of raid disks: %s\n",
+                       optarg);
+               exit(2);
+           }
+           continue;
+
+       case O('C','x'): /* number of spare (eXtra) discs */
+           if (sparedisks) {
+               fprintf(stderr,"mdctl: spare-disks set twice: %d and %s\n",
+                       sparedisks, optarg);
+               exit(2);
+           }
+           if (level > -10 && level < 1) {
+               fprintf(stderr, "mdctl: spare-disks setting is incompatible with raid level %d\n",
+                       level);
+               exit(2);
+           }
+           sparedisks = strtol(optarg, &c, 10);
+           if (!optarg[0] || *c || sparedisks < 0 || sparedisks > MD_SB_DISKS - raiddisks) {
+               fprintf(stderr, "mdctl: invalid number of spare disks: %s\n",
+                       optarg);
+               exit(2);
+           }
+           continue;
+
+           /* now for the Assemble options */
+       case O('A','f'): /* force assembly */
+               force = 1;
+               continue;
+       case O('A','u'): /* uuid of array */
+           if (uuidset) {
+               fprintf(stderr, "mdctl: uuid cannot bet set twice.  "
+                       "Second value %s.\n", optarg);
+               exit(2);
+           }
+           if (parse_uuid(optarg, uuid))
+               uuidset = 1;
+           else {
+               fprintf(stderr,"mdctl: Bad uuid: %s\n", optarg);
+               exit(2);
+           }
+           continue;
+
+       case O('A','c'): /* config file */
+           if (configfile) {
+               fprintf(stderr, "mdctl: configfile cannot be set twice.  "
+                       "Second value is %s.\n", optarg);
+               exit(2);
+           }
+           configfile = optarg;
+           /* FIXME possibly check that config file exists.  Even parse it */
+           continue;
+       case O('A','s'): /* scan */
+           scan = 1;
+           continue;
+
+           /* now the general management options.  Some are applicable
+            * to other modes. None have arguments.
+            */
+       case O('@','a'):
+       case O('C','a'):
+       case O('B','a'):
+       case O('A','a'): /* add a drive */
+           devmode = 'a';
+           continue;
+       case O('@','r'): /* remove a drive */
+           devmode = 'r';
+           continue;
+       case O('@','f'): /* set faulty */
+       case O('C','f'):
+           devmode = 'f';
+           continue;
+       case O('@','R'):
+       case O('A','R'):
+       case O('B','R'):
+       case O('C','R'): /* Run the array */
+           if (runstop < 0) {
+               fprintf(stderr, "mdctl: Cannot both Stop and Run an array\n");
+               exit(2);
+           }
+           runstop = 1;
+           continue;
+       case O('@','S'):
+           if (runstop > 0) {
+               fprintf(stderr, "mdctl: Cannot both Run and Stop an array\n");
+               exit(2);
+           }
+           runstop = -1;
+           continue;
+
+       case O('@','o'):
+           if (readonly < 0) {
+               fprintf(stderr, "mdctl: Cannot have both readonly and readwrite\n");
+               exit(2);
+           }
+           readonly = 1;
+           continue;
+       case O('@','w'):
+           if (readonly > 0) {
+               fprintf(stderr, "mkdctl: Cannot have both readwrite and readonly.\n");
+               exit(2);
+           }
+           readonly = -1;
+           continue;
+       }
+       /* We have now processed all the valid options. Anything else is
+        * an error
+        */
+       fprintf(stderr, "mdctl: option %c not valid in mode %c\n",
+               opt, mode);
+       exit(2);
+
+    }
+
+    if (!mode) {
+           fputs(Usage, stderr);
+           exit(2);
+    }
+    /* Ok, got the option parsing out of the way
+     * hopefully it's mostly right but there might be some stuff
+     * missing
+     *
+     * That is mosty checked in ther per-mode stuff but...
+     *
+     * There must be an mddev unless D or E or (A and scan)
+     * If there is one, we open it.
+     */
+    if (mode !='D' && mode !='E' && ! (mode =='A' && scan)) {
+       if (!mddev) {
+           fprintf(stderr, "mdctl: an md device must be given in this mode\n");
+           exit(2);
+       }
+       mdfd = open(mddev, O_RDWR, 0);
+       if (mdfd < 0) {
+           fprintf(stderr,"mdctl: error opening %s: %s\n",
+                   mddev, strerror(errno));
+           exit(1);
+       }
+       if (md_get_version(mdfd) <= 0) {
+           fprintf(stderr, "mdctl: %s does not appear to be an md device\n",
+                   mddev);
+           close(mdfd);
+           exit(1);
+       }
+    }
+    
+    rv  =0;
+    switch(mode) {
+    case '@':/* Management */
+       /* readonly, add/remove, readwrite, runstop */
+       if (readonly>1)
+           rv = Manage_ro(mddev, mdfd, readonly);
+       if (!rv && subdevs)
+           rv = Manage_subdevs(mddev, mdfd, subdevs, subdev, devmodes);
+       if (!rv && readonly < 1)
+           rv = Manage_ro(mddev, mdfd, readonly);
+       if (!rv && runstop)
+           rv = Manage_runstop(mddev, mdfd, runstop);
+       break;
+    case 'A': /* Assemble */
+       rv = Assemble(mddev, mdfd, uuid, uuidset, configfile, scan, subdevs, subdev, readonly, runstop, verbose, force);
+       break;
+    case 'B': /* Build */
+       rv = Build(mddev, mdfd, chunk, level, raiddisks, subdevs,subdev);
+       break;
+    case 'C': /* Create */
+       rv = Create(mddev, mdfd, chunk, level, layout, raiddisks, sparedisks,
+                   subdevs,subdev,runstop);
+       break;
+    case 'D': /* Detail */
+       for (i=0; i<subdevs; i++)
+           rv |= Detail(subdev[i]);
+       break;
+    case 'E': /* Examine */
+       for (i=0; i<subdevs; i++)
+           rv |= Examine(subdev[i]);
+       break;
+    }
+    exit(rv);
+}
+
diff --git a/mdctl.h b/mdctl.h
new file mode 100644 (file)
index 0000000..7e7c389
--- /dev/null
+++ b/mdctl.h
@@ -0,0 +1,110 @@
+/*
+ * mdctl - manage Linux "md" devices aka RAID arrays.
+ *
+ * Copyright (C) 2001 Neil Brown <neilb@cse.unsw.edu.au>
+ *
+ *
+ *    This program is free software; you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation; either version 2 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program; if not, write to the Free Software
+ *    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ *    Author: Neil Brown
+ *    Email: <neilb@cse.unsw.edu.au>
+ *    Paper: Neil Brown
+ *           School of Computer Science and Engineering
+ *           The University of New South Wales
+ *           Sydney, 2052
+ *           Australia
+ */
+
+#define        __USE_LARGEFILE64
+#include       <unistd.h>
+extern __off64_t lseek64 __P ((int __fd, __off64_t __offset, int __whence));
+
+#include       <sys/types.h>
+#include       <sys/stat.h>
+#include       <stdlib.h>
+#include       <time.h>
+#include       <getopt.h>
+#include       <fcntl.h>
+#include       <stdio.h>
+#include       <errno.h>
+#include       <string.h>
+
+#include       <linux/kdev_t.h>
+#include       <linux/fs.h>
+#include       <sys/ioctl.h>
+#define        MD_MAJOR 9
+
+
+#include       "md_u.h"
+
+extern char short_options[];
+extern struct option long_options[];
+extern char Version[], Usage[], Help[], Help_create[], Help_build[], Help_assemble[];
+
+/* structures read from config file */
+/* List of mddevice names and uuids */
+typedef struct mddev_uuid_s {
+       char *devname;
+       __u32 uuid[4];
+       struct mddev_uuid_s *next;
+} *mddev_uuid_t;
+
+/* List of device names - wildcards expanded */
+typedef struct mddev_dev_s {
+       char *devname;
+       struct mddev_dev_s *next;
+} *mddev_dev_t;
+
+/*
+ * RAID5 supported algorithms
+ */
+#define ALGORITHM_LEFT_ASYMMETRIC      0
+#define ALGORITHM_RIGHT_ASYMMETRIC     1
+#define ALGORITHM_LEFT_SYMMETRIC       2
+#define ALGORITHM_RIGHT_SYMMETRIC      3
+
+
+extern int Manage_ro(char *devname, int fd, int readonly);
+extern int Manage_runstop(char *devname, int fd, int runstop);
+extern int Manage_subdevs(char *devname, int fd,
+                         int devcnt, char *devnames[], int devmodes[]);
+
+
+extern int Assemble(char *mddev, int mdfd,
+                   int uuid[4], int uuidset,
+                   char *conffile, int scan,
+                   int subdevs, char *subdev[],
+                   int readonly, int runstop,
+                   int verbose, int force);
+
+extern int Build(char *mddev, int mdfd, int chunk, int level,
+                int raiddisks,
+                int subdevs, char *subdev[]);
+
+
+extern int Create(char *mddev, int mdfd,
+                 int chunk, int level, int layout, int raiddisks, int sparedisks,
+                 int subdevs, char *subdev[],
+                 int runstop);
+
+extern int Detail(char *dev);
+extern int Examine(char *dev);
+
+extern int md_get_version(int fd);
+extern int get_linux_version();
+extern int parse_uuid(char *str, int uuid[4]);
+
+extern mddev_uuid_t conf_get_uuids(char *);
+extern mddev_dev_t conf_get_devs(char *);
diff --git a/util.c b/util.c
new file mode 100644 (file)
index 0000000..bd7f1d8
--- /dev/null
+++ b/util.c
@@ -0,0 +1,224 @@
+/*
+ * mdctl - manage Linux "md" devices aka RAID arrays.
+ *
+ * Copyright (C) 2001 Neil Brown <neilb@cse.unsw.edu.au>
+ *
+ *
+ *    This program is free software; you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation; either version 2 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License
+ *    along with this program; if not, write to the Free Software
+ *    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ *    Author: Neil Brown
+ *    Email: <neilb@cse.unsw.edu.au>
+ *    Paper: Neil Brown
+ *           School of Computer Science and Engineering
+ *           The University of New South Wales
+ *           Sydney, 2052
+ *           Australia
+ */
+
+#include       "mdctl.h"
+#include       "md_p.h"
+#include       <sys/utsname.h>
+
+/*
+ * Parse a 128 bit uuid in 4 integers
+ * format is 32 hexx nibbles with options :.<space> separator
+ * If not exactly 32 hex digits are found, return 0
+ * else return 1
+ */
+int parse_uuid(char *str, int uuid[4])
+{
+    int hit = 0; /* number of Hex digIT */
+    int i;
+    char c;
+    for (i=0; i<4; i++) uuid[i]=0;
+
+    while ((c= *str++)) {
+       int n;
+       if (c>='0' && c<='9')
+           n = c-'0';
+       else if (c>='a' && c <= 'f')
+           n = 10 + c - 'a';
+       else if (c>='A' && c <= 'F')
+           n = 10 + c - 'A';
+       else if (strchr(":. -", c))
+           continue;
+       else return 0;
+
+       uuid[hit/4] <<= 4;
+       uuid[hit/4] += n;
+       hit++;
+    }
+    if (hit == 32)
+       return 1;
+    return 0;
+    
+}
+
+
+/*
+ * Get the md version number.
+ * We use the RAID_VERSION ioctl if it is supported
+ * If not, but we have a block device with major '9', we assume
+ * 0.36.0
+ *
+ * Return version number as 24 but number - assume version parts
+ * always < 255
+ */
+
+int md_get_version(int fd)
+{
+    struct stat stb;
+    mdu_version_t vers;
+
+    if (fstat(fd, &stb)<0)
+       return -1;
+    if ((S_IFMT&stb.st_mode) != S_IFBLK)
+       return -1;
+
+    if (ioctl(fd, RAID_VERSION, &vers) == 0)
+       return  (vers.major<<16) | (vers.minor<<8) | vers.patchlevel;
+
+    if (MAJOR(stb.st_rdev) == MD_MAJOR)
+       return (36<<8);
+    return -1;
+}
+
+    
+int get_linux_version()
+{
+       struct utsname name;
+       int a,b,c;
+       if (uname(&name) <0)
+               return -1;
+
+       if (sscanf(name.release, "%d.%d.%d", &a,&b,&c)!= 3)
+               return -1;
+       return (a<<16)+(b<<8)+c;
+}
+
+int enough(int level, int raid_disks, int avail_disks)
+{
+       switch (level) {
+       case -1:
+       case 0:
+               return avail_disks == raid_disks;
+       case 1:
+               return avail_disks >= 1;
+       case 4:
+       case 5:
+               return avail_disks >= raid_disks-1;
+       default:
+               return 0;
+       }
+}
+
+int same_uuid(int a[4], int b[4])
+{
+    if (a[0]==b[0] &&
+       a[1]==b[1] &&
+       a[2]==b[2] &&
+       a[3]==b[3])
+       return 1;
+    return 0;
+}
+
+void uuid_from_super(int uuid[4], mdp_super_t *super)
+{
+    uuid[0] = super->set_uuid0;
+    if (super->minor_version >= 90) {
+       uuid[1] = super->set_uuid1;
+       uuid[2] = super->set_uuid2;
+       uuid[3] = super->set_uuid3;
+    } else {
+       uuid[1] = 0;
+       uuid[2] = 0;
+       uuid[3] = 0;
+    }
+}
+
+int compare_super(mdp_super_t *first, mdp_super_t *second)
+{
+    /*
+     * return:
+     *  0 same, or first was empty, and second was copied
+     *  1 second had wrong number
+     *  2 wrong uuid
+     *  3 wrong other info
+     */
+    int uuid1[4], uuid2[4];
+    if (second->md_magic != MD_SB_MAGIC)
+       return 1;
+    if (first-> md_magic != MD_SB_MAGIC) {
+       memcpy(first, second, sizeof(*first));
+       return 0;
+    }
+
+    uuid_from_super(uuid1, first);
+    uuid_from_super(uuid2, second);
+    if (!same_uuid(uuid1, uuid2))
+       return 2;
+    if (first->major_version != second->major_version ||
+       first->minor_version != second->minor_version ||
+       first->patch_version != second->patch_version ||
+       first->gvalid_words  != second->gvalid_words  ||
+       first->ctime         != second->ctime         ||
+       first->level         != second->level         ||
+       first->size          != second->size          ||
+       first->raid_disks    != second->raid_disks    )
+       return 3;
+
+    return 0;
+}
+
+int load_super(int fd, mdp_super_t *super)
+{
+       /* try to read in the superblock
+        *
+        * return
+        *   0 - success
+        *   1 - no block size
+        *   2 - too small
+        *   3 - no seek
+        *   4 - no read
+        *   5 - no magic
+        *   6 - wrong major version
+        */
+       long size;
+       long long offset;
+    
+       if (ioctl(fd, BLKGETSIZE, &size))
+               return 1;
+
+       if (size < MD_RESERVED_SECTORS*2)
+               return 2;
+       
+       offset = MD_NEW_SIZE_SECTORS(size);
+
+       offset *= 512;
+
+       if (lseek64(fd, offset, 0)< 0LL)
+               return 3;
+
+       if (read(fd, &super, sizeof(super)) != sizeof(super))
+               return 4;
+
+       if (super->md_magic != MD_SB_MAGIC)
+               return 5;
+
+       if (super->major_version != 0)
+               return 6;
+       return 0;
+}
+