X-Git-Url: http://git.ipfire.org/?p=thirdparty%2Fmdadm.git;a=blobdiff_plain;f=mdadm.h;h=8277594bdb82cef41c1ed6c7ae85609e9ab46178;hp=614dc69029ad42bdf6de9784969545e84c99ca85;hb=df3346e675d731b4c847272fc40bb992ace7554e;hpb=a655e5506478c540db06649fe7833c3c0982f80c diff --git a/mdadm.h b/mdadm.h index 614dc690..8277594b 100644 --- a/mdadm.h +++ b/mdadm.h @@ -64,6 +64,7 @@ extern __off64_t lseek64 __P ((int __fd, __off64_t __offset, int __whence)); #define BLKGETSIZE64 _IOR(0x12,114,size_t) /* return device size in bytes (u64 *arg) */ #endif +#define DEFAULT_CHUNK 512 #define DEFAULT_BITMAP_CHUNK 4096 #define DEFAULT_BITMAP_DELAY 5 #define DEFAULT_MAX_WRITE_BEHIND 256 @@ -93,6 +94,14 @@ extern __off64_t lseek64 __P ((int __fd, __off64_t __offset, int __whence)); #define MDMON_DIR "/dev/.mdadm/" #endif /* MDMON_DIR */ +/* FAILED_SLOTS is where to save files storing recent removal of array + * member in order to allow future reuse of disk inserted in the same + * slot for array recovery + */ +#ifndef FAILED_SLOTS_DIR +#define FAILED_SLOTS_DIR "/dev/.mdadm/failed-slots" +#endif /* FAILED_SLOTS */ + #include "md_u.h" #include "md_p.h" #include "bitmap.h" @@ -261,17 +270,16 @@ extern char Version[], Usage[], Help[], OptionHelp[], Help_manage[], Help_misc[], Help_monitor[], Help_config[]; /* for option that don't have short equivilents, we assign arbitrary - * small numbers. '1' means an undecorated option, so we start at '2'. - * (note we must stop before we get to 65 i.e. 'A') + * numbers later than any 'short' character option. */ enum special_options { - AssumeClean = 2, + AssumeClean = 300, BitmapChunk, WriteBehind, ReAdd, NoDegraded, Sparc22, - BackupFile, /* 8 */ + BackupFile, HomeHost, AutoHomeHost, Symlinks, @@ -279,7 +287,32 @@ enum special_options { Waitclean, DetailPlatform, KillSubarray, - UpdateSubarray, /* 16 */ + UpdateSubarray, + IncrementalPath, + NoSharing, + HelpOptions, + Brief, + ManageOpt, + Add, + Remove, + Fail, + MiscOpt, + WaitOpt, + ConfigFile, + ChunkSize, + WriteMostly, + Layout, + Auto, + Force, + SuperMinor, + EMail, + ProgramOpt, + Increment, + Fork, + Bitmap, + RebuildMapOpt, + InvalidBackup, + UdevRules, }; /* structures read from config file */ @@ -331,14 +364,12 @@ struct mddev_ident { /* List of device names - wildcards expanded */ struct mddev_dev { char *devname; - char disposition; /* 'a' for add, 'r' for remove, 'f' for fail. + int disposition; /* 'a' for add, 'r' for remove, 'f' for fail. * Not set for names read from .config */ char writemostly; /* 1 for 'set writemostly', 2 for 'clear writemostly' */ char re_add; char used; /* set when used */ - struct mdinfo *content; /* If devname is a container, this might list - * the remaining member arrays. */ struct mddev_dev *next; }; @@ -358,7 +389,6 @@ struct mdstat_ent { int resync; /* 3 if check, 2 if reshape, 1 if resync, 0 if recovery */ int devcnt; int raid_disks; - int chunk_size; char * metadata_version; struct dev_member { char *name; @@ -373,6 +403,7 @@ extern void mdstat_wait(int seconds); extern void mdstat_wait_fd(int fd, const sigset_t *sigmask); extern int mddev_busy(int devnum); extern struct mdstat_ent *mdstat_by_component(char *name); +extern struct mdstat_ent *mdstat_by_subdev(char *subdev, int container); struct map_ent { struct map_ent *next; @@ -436,6 +467,8 @@ extern int sysfs_fd_get_ll(int fd, unsigned long long *val); extern int sysfs_get_ll(struct mdinfo *sra, struct mdinfo *dev, char *name, unsigned long long *val); extern int sysfs_fd_get_str(int fd, char *val, int size); +extern int sysfs_attribute_available(struct mdinfo *sra, struct mdinfo *dev, + char *name); extern int sysfs_get_str(struct mdinfo *sra, struct mdinfo *dev, char *name, char *val, int size); extern int sysfs_set_safemode(struct mdinfo *sra, unsigned long ms); @@ -443,8 +476,28 @@ extern int sysfs_set_array(struct mdinfo *info, int vers); extern int sysfs_add_disk(struct mdinfo *sra, struct mdinfo *sd, int resume); extern int sysfs_disk_to_scsi_id(int fd, __u32 *id); extern int sysfs_unique_holder(int devnum, long rdev); +extern int sysfs_freeze_array(struct mdinfo *sra); extern int load_sys(char *path, char *buf); - +extern int reshape_prepare_fdlist(char *devname, + struct mdinfo *sra, + int raid_disks, + int nrdisks, + unsigned long blocks, + char *backup_file, + int *fdlist, + unsigned long long *offsets); +extern void reshape_free_fdlist(int *fdlist, + unsigned long long *offsets, + int size); +extern int reshape_open_backup_file(char *backup, + int fd, + char *devname, + long blocks, + int *fdlist, + unsigned long long *offsets, + int restart); +extern unsigned long compute_backup_blocks(int nchunk, int ochunk, + unsigned int ndata, unsigned int odata); extern int save_stripes(int *source, unsigned long long *offsets, int raid_disks, int chunk_size, int level, int layout, @@ -471,6 +524,31 @@ extern char *map_dev(int major, int minor, int create); struct active_array; struct metadata_update; + +/* 'struct reshape' records the intermediate states + * a general reshape. + * The starting geometry is converted to the 'before' geometry + * by at most an atomic level change. They could be the same. + * Similarly the 'after' geometry is converted to the final + * geometry by at most a level change. + * Note that 'before' and 'after' must have the same level. + * 'blocks' is the minimum number of sectors for a reshape unit. + * This will be a multiple of the stripe size in each of the + * 'before' and 'after' geometries. + * If 'blocks' is 0, no restriping is necessary. + */ +struct reshape { + int level; + int parity; /* number of parity blocks/devices */ + struct { + int layout; + int data_disks; + } before, after; + unsigned long long backup_blocks; + unsigned long long stripes; /* number of old stripes that comprise 'blocks'*/ + unsigned long long new_size; /* New size of array in sectors */ +}; + /* A superswitch provides entry point the a metadata handler. * * The super_switch primarily operates on some "metadata" that @@ -540,7 +618,7 @@ extern struct superswitch { * appear to be failed/missing. */ void (*getinfo_super)(struct supertype *st, struct mdinfo *info, char *map); - + struct mdinfo *(*getinfo_super_disks)(struct supertype *st); /* Check if the given metadata is flagged as belonging to "this" * host. 0 for 'no', 1 for 'yes', -1 for "Don't record homehost" */ @@ -585,7 +663,11 @@ extern struct superswitch { * when hot-adding a spare. */ int (*add_to_super)(struct supertype *st, mdu_disk_info_t *dinfo, - int fd, char *devname); + int fd, char *devname); + /* update the metadata to delete a device, + * when hot-removing. + */ + int (*remove_from_super)(struct supertype *st, mdu_disk_info_t *dinfo); /* Write metadata to one device when fixing problems or adding * a new device. @@ -600,6 +682,7 @@ extern struct superswitch { int (*load_container)(struct supertype *st, int fd, char *devname); struct supertype * (*match_metadata_desc)(char *arg); __u64 (*avail_size)(struct supertype *st, __u64 size); + unsigned long long (*min_acceptable_spare_size)(struct supertype *st); int (*add_internal_bitmap)(struct supertype *st, int *chunkp, int delay, int write_behind, unsigned long long size, int may_change, int major); @@ -614,24 +697,36 @@ extern struct superswitch { * added to validate changing size and new devices. If there are * inter-device dependencies, it should record sufficient details * so these can be validated. - * Both 'size' and '*freesize' are in sectors. chunk is bytes. + * Both 'size' and '*freesize' are in sectors. chunk is KiB. */ int (*validate_geometry)(struct supertype *st, int level, int layout, int raiddisks, - int chunk, unsigned long long size, + int *chunk, unsigned long long size, char *subdev, unsigned long long *freesize, int verbose); struct mdinfo *(*container_content)(struct supertype *st, char *subarray); - /* Allow a metadata handler to override mdadm's default layouts */ - int (*default_layout)(int level); /* optional */ - /* query the supertype for default chunk size */ - int (*default_chunk)(struct supertype *st); /* optional */ + /* query the supertype for default geometry */ + void (*default_geometry)(struct supertype *st, int *level, int *layout, int *chunk); /* optional */ /* Permit subarray's to be deleted from inactive containers */ int (*kill_subarray)(struct supertype *st); /* optional */ /* Permit subarray's to be modified */ int (*update_subarray)(struct supertype *st, char *subarray, char *update, struct mddev_ident *ident); /* optional */ + /* Check if reshape is supported for this external format. + * st is obtained from super_by_fd() where st->subarray[0] is + * initialized to indicate if reshape is being performed at the + * container or subarray level + */ + int (*reshape_super)(struct supertype *st, long long size, int level, + int layout, int chunksize, int raid_disks, + int delta_disks, char *backup, char *dev, + int verbose); /* optional */ + int (*manage_reshape)( /* optional */ + int afd, struct mdinfo *sra, struct reshape *reshape, + struct supertype *st, unsigned long blocks, + int *fds, unsigned long long *offsets, + int dests, int *destfd, unsigned long long *destoffsets); /* for mdmon */ int (*open_new)(struct supertype *c, struct active_array *a, @@ -673,6 +768,21 @@ extern struct superswitch { */ struct mdinfo *(*activate_spare)(struct active_array *a, struct metadata_update **updates); + /* + * Return statically allocated string that represents metadata specific + * controller domain of the disk. The domain is used in disk domain + * matching functions. Disks belong to the same domain if the they have + * the same domain from mdadm.conf and belong the same metadata domain. + * Returning NULL or not providing this handler means that metadata + * does not distinguish the differences between disks that belong to + * different controllers. They are in the domain specified by + * configuration file (mdadm.conf). + * In case when the metadata has the notion of domains based on disk + * it shall return NULL for disks that do not belong to the controller + * the supported domains. Such disks will form another domain and won't + * be mixed with supported ones. + */ + const char *(*get_disk_controller_domain)(const char *path); int swapuuid; /* true if uuid is bigending rather than hostendian */ int external; @@ -687,6 +797,9 @@ struct metadata_update { int len; char *buf; void *space; /* allocated space that monitor will use */ + void **space_list; /* list of allocated spaces that monitor can + * use or that it returned. + */ struct metadata_update *next; }; @@ -714,9 +827,11 @@ struct supertype { int container_dev; /* devnum of container */ void *sb; void *info; - int loaded_container; /* Set if load_super found a container, - * not just one device */ - + int ignore_hw_compat; /* used to inform metadata handlers that it should ignore + HW/firmware related incompatability to load metadata. + Used when examining metadata to display content of disk + when user has no hw/firmare compatible system. + */ struct metadata_update *updates; struct metadata_update **update_tail; @@ -741,6 +856,8 @@ static inline struct supertype *guess_super(int fd) { } extern struct supertype *dup_super(struct supertype *st); extern int get_dev_size(int fd, char *dname, unsigned long long *sizep); +extern int must_be_container(int fd); +extern int dev_size_from_id(dev_t id, unsigned long long *size); extern void get_one_disk(int mdfd, mdu_array_info_t *ainf, mdu_disk_info_t *disk); void wait_for(char *dev, int fd); @@ -759,7 +876,7 @@ struct dev_policy { * name and metadata can be compared by address equality. */ const char *metadata; - char *value; + const char *value; }; extern char pol_act[], pol_domain[], pol_metadata[], pol_auto[]; @@ -803,15 +920,18 @@ extern struct dev_policy *disk_policy(struct mdinfo *disk); extern struct dev_policy *devnum_policy(int dev); extern void dev_policy_free(struct dev_policy *p); -extern void pol_new(struct dev_policy **pol, char *name, char *val, char *metadata); +//extern void pol_new(struct dev_policy **pol, char *name, char *val, char *metadata); +extern void pol_add(struct dev_policy **pol, char *name, char *val, char *metadata); extern struct dev_policy *pol_find(struct dev_policy *pol, char *name); enum policy_action { act_default, act_include, act_re_add, - act_spare, - act_force_spare, + act_spare, /* This only applies to bare devices */ + act_spare_same_slot, /* this allows non-bare devices, + * but only if recent removal */ + act_force_spare, /* this allow non-bare devices in any case */ act_err }; @@ -822,16 +942,22 @@ extern int disk_action_allows(struct mdinfo *disk, const char *metadata, struct domainlist { struct domainlist *next; - char *dom; + const char *dom; }; extern int domain_test(struct domainlist *dom, struct dev_policy *pol, const char *metadata); extern struct domainlist *domain_from_array(struct mdinfo *mdi, const char *metadata); +extern void domainlist_add_dev(struct domainlist **dom, int devnum, + const char *metadata); extern void domain_free(struct domainlist *dl); extern void domain_merge(struct domainlist **domp, struct dev_policy *pol, const char *metadata); +void domain_add(struct domainlist **domp, char *domain); + +extern void policy_save_path(char *id_path, struct map_ent *array); +extern int policy_check_path(struct mdinfo *disk, struct map_ent *array); #if __GNUC__ < 3 struct stat64; @@ -878,13 +1004,16 @@ extern int Manage_ro(char *devname, int fd, int readonly); extern int Manage_runstop(char *devname, int fd, int runstop, int quiet); extern int Manage_resize(char *devname, int fd, long long size, int raid_disks); extern int Manage_subdevs(char *devname, int fd, - struct mddev_dev *devlist, int verbose, int test); + struct mddev_dev *devlist, int verbose, int test, + char *update); extern int autodetect(void); extern int Grow_Add_device(char *devname, int fd, char *newdev); extern int Grow_addbitmap(char *devname, int fd, char *file, int chunk, int delay, int write_behind, int force); extern int Grow_reshape(char *devname, int fd, int quiet, char *backup_file, long long size, - int level, char *layout_str, int chunksize, int raid_disks); + int level, char *layout_str, int chunksize, int raid_disks, + struct mddev_dev *devlist, + int force); extern int Grow_restart(struct supertype *st, struct mdinfo *info, int *fdlist, int cnt, char *backup_file, int verbose); extern int Grow_continue(int mdfd, struct supertype *st, @@ -892,7 +1021,8 @@ extern int Grow_continue(int mdfd, struct supertype *st, extern int Assemble(struct supertype *st, char *mddev, struct mddev_ident *ident, - struct mddev_dev *devlist, char *backup_file, + struct mddev_dev *devlist, + char *backup_file, int invalid_backup, int readonly, int runstop, char *update, char *homehost, int require_homehost, int verbose, int force); @@ -918,7 +1048,8 @@ extern int Examine(struct mddev_dev *devlist, int brief, int export, int scan, extern int Monitor(struct mddev_dev *devlist, char *mailaddr, char *alert_cmd, int period, int daemonise, int scan, int oneshot, - int dosyslog, int test, char *pidfile, int increments); + int dosyslog, int test, char *pidfile, int increments, + int share); extern int Kill(char *dev, struct supertype *st, int force, int quiet, int noexcl); extern int Kill_subarray(char *dev, char *subarray, int quiet); @@ -931,18 +1062,20 @@ extern int Incremental(char *devname, int verbose, int runstop, int autof); extern void RebuildMap(void); extern int IncrementalScan(int verbose); -extern int IncrementalRemove(char *devname, int verbose); +extern int IncrementalRemove(char *devname, char *path, int verbose); extern int CreateBitmap(char *filename, int force, char uuid[16], unsigned long chunksize, unsigned long daemon_sleep, unsigned long write_behind, unsigned long long array_size, int major); extern int ExamineBitmap(char *filename, int brief, struct supertype *st); +extern int Write_rules(char *rule_name); extern int bitmap_update_uuid(int fd, int *uuid, int swap); extern unsigned long bitmap_sectors(struct bitmap_super_s *bsb); extern int md_get_version(int fd); extern int get_linux_version(void); +extern int mdadm_version(char *version); extern long long parse_size(char *size); extern int parse_uuid(char *str, int uuid[4]); extern int parse_layout_10(char *layout); @@ -950,11 +1083,14 @@ extern int parse_layout_faulty(char *layout); extern int check_ext2(int fd, char *name); extern int check_reiser(int fd, char *name); extern int check_raid(int fd, char *name); -extern int check_partitions(int fd, char *dname, unsigned long long freesize); +extern int check_partitions(int fd, char *dname, + unsigned long long freesize, + unsigned long long size); extern int get_mdp_major(void); extern int dev_open(char *dev, int flags); extern int open_dev(int devnum); +extern int open_dev_flags(int devnum, int flags); extern int open_dev_excl(int devnum); extern int is_standard(char *dev, int *nump); extern int same_dev(char *one, char *two); @@ -975,11 +1111,12 @@ extern char *conf_word(FILE *file, int allow_key); extern int conf_name_is_free(char *name); extern int devname_matches(char *name, char *match); extern struct mddev_ident *conf_match(struct mdinfo *info, struct supertype *st); +extern int experimental(void); extern void free_line(char *line); extern int match_oneof(char *devices, char *devname); extern void uuid_from_super(int uuid[4], mdp_super_t *super); -extern const int uuid_match_any[4]; +extern const int uuid_zero[4]; extern int same_uuid(int a[4], int b[4], int swapuuid); extern void copy_uuid(void *a, int b[4], int swapuuid); extern char *__fname_from_uuid(int id[4], int swap, char *buf, char sep); @@ -993,16 +1130,25 @@ extern int ask(char *mesg); extern unsigned long long get_component_size(int fd); extern void remove_partitions(int fd); extern int test_partition(int fd); +extern int test_partition_from_id(dev_t id); extern unsigned long long calc_array_size(int level, int raid_disks, int layout, int chunksize, unsigned long long devsize); extern int flush_metadata_updates(struct supertype *st); extern void append_metadata_update(struct supertype *st, void *buf, int len); extern int assemble_container_content(struct supertype *st, int mdfd, struct mdinfo *content, int runstop, - char *chosen_name, int verbose); - + char *chosen_name, int verbose, + char *backup_file); +extern struct mdinfo *container_choose_spares(struct supertype *st, + unsigned long long min_size, + struct domainlist *domlist, + char *spare_group, + const char *metadata, int get_one); +extern int move_spare(char *from_devname, char *to_devname, dev_t devid); extern int add_disk(int mdfd, struct supertype *st, struct mdinfo *sra, struct mdinfo *info); +extern int remove_disk(int mdfd, struct supertype *st, + struct mdinfo *sra, struct mdinfo *info); extern int set_array_info(int mdfd, struct supertype *st, struct mdinfo *info); unsigned long long min_recovery_start(struct mdinfo *array); @@ -1029,7 +1175,6 @@ extern int open_mddev(char *dev, int report_errors); extern int open_container(int fd); extern int is_container_member(struct mdstat_ent *ent, char *devname); extern int is_subarray_active(char *subarray, char *devname); -int is_container_active(char *devname); extern int open_subarray(char *dev, char *subarray, struct supertype *st, int quiet); extern struct superswitch *version_to_superswitch(char *vers); @@ -1039,7 +1184,13 @@ extern int check_env(char *name); extern __u32 random32(void); extern int start_mdmon(int devnum); +extern int child_monitor(int afd, struct mdinfo *sra, struct reshape *reshape, + struct supertype *st, unsigned long stripes, + int *fds, unsigned long long *offsets, + int dests, int *destfd, unsigned long long *destoffsets); + extern char *devnum2devname(int num); +extern void fmt_devname(char *name, int num); extern int devname2devnum(char *name); extern int stat2devnum(struct stat *st); extern int fd2devnum(int fd); @@ -1069,13 +1220,20 @@ static inline int is_subarray(char *vers) /* The version string for a 'subarray' (an array in a container) * is * /containername/componentname for normal read-write arrays - * -containername/componentname for read-only arrays. + * -containername/componentname for arrays which mdmon must not + * reconfigure. They might be read-only + * or might be undergoing reshape etc. * containername is e.g. md0, md_d1 * componentname is dependant on the metadata. e.g. '1' 'S1' ... */ return (*vers == '/' || *vers == '-'); } +static inline char *to_subarray(struct mdstat_ent *ent, char *container) +{ + return &ent->metadata_version[10+strlen(container)+1]; +} + #ifdef DEBUG #define dprintf(fmt, arg...) \ fprintf(stderr, fmt, ##arg)