[thirdparty/mdadm.git] / mdadm.h

/*
 * mdadm - manage Linux "md" devices aka RAID arrays.
 *
 * Copyright (C) 2001-2006 Neil Brown <neilb@suse.de>
 *
 *
 *    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	_GNU_SOURCE
#include	<unistd.h>
#ifndef __dietlibc__
extern __off64_t lseek64 __P ((int __fd, __off64_t __offset, int __whence));
#endif

#include	<sys/types.h>
#include	<sys/stat.h>
#include	<stdlib.h>
#include	<time.h>
#include	<sys/time.h>
#include	<getopt.h>
#include	<fcntl.h>
#include	<stdio.h>
#include	<errno.h>
#include	<string.h>
#include	<syslog.h>
#ifdef __dietlibc__
#include	<strings.h>
/* dietlibc has deprecated random and srandom!! */
#define random rand
#define srandom srand
#endif


#include	<linux/kdev_t.h>
/*#include	<linux/fs.h> */
#include	<sys/mount.h>
#include	<asm/types.h>
#include	<sys/ioctl.h>
#define	MD_MAJOR 9
#define MdpMinorShift 6

#ifndef BLKGETSIZE64
#define BLKGETSIZE64 _IOR(0x12,114,size_t) /* return device size in bytes (u64 *arg) */
#endif

#define DEFAULT_BITMAP_CHUNK 4096
#define DEFAULT_BITMAP_DELAY 5
#define DEFAULT_MAX_WRITE_BEHIND 256

#include	"md_u.h"
#include	"md_p.h"
#include	"bitmap.h"

#include <endian.h>
/* Redhat don't like to #include <asm/byteorder.h>, and
 * some time include <linux/byteorder/xxx_endian.h> isn't enough,
 * and there is no standard conversion function so... */
/* And dietlibc doesn't think byteswap is ok, so.. */
/*  #include <byteswap.h> */
#define bswap_16(x) (((x) & 0x00ffU) << 8 | \
		     ((x) & 0xff00U) >> 8)
#define bswap_32(x) (((x) & 0x000000ffU) << 24 | \
		     ((x) & 0xff000000U) >> 24 | \
		     ((x) & 0x0000ff00U) << 8  | \
		     ((x) & 0x00ff0000U) >> 8)
#define bswap_64(x) (((x) & 0x00000000000000ffULL) << 56 | \
		     ((x) & 0xff00000000000000ULL) >> 56 | \
		     ((x) & 0x000000000000ff00ULL) << 40 | \
		     ((x) & 0x00ff000000000000ULL) >> 40 | \
		     ((x) & 0x0000000000ff0000ULL) << 24 | \
		     ((x) & 0x0000ff0000000000ULL) >> 24 | \
		     ((x) & 0x00000000ff000000ULL) << 8 | \
		     ((x) & 0x000000ff00000000ULL) >> 8)

#if BYTE_ORDER == LITTLE_ENDIAN
#define	__cpu_to_le16(_x) (_x)
#define __cpu_to_le32(_x) (_x)
#define __cpu_to_le64(_x) (_x)
#define	__le16_to_cpu(_x) (_x)
#define __le32_to_cpu(_x) (_x)
#define __le64_to_cpu(_x) (_x)
#elif BYTE_ORDER == BIG_ENDIAN
#define	__cpu_to_le16(_x) bswap_16(_x)
#define __cpu_to_le32(_x) bswap_32(_x)
#define __cpu_to_le64(_x) bswap_64(_x)
#define	__le16_to_cpu(_x) bswap_16(_x)
#define __le32_to_cpu(_x) bswap_32(_x)
#define __le64_to_cpu(_x) bswap_64(_x)
#else
#  error "unknown endianness."
#endif


/* general information that might be extracted from a superblock */
struct mdinfo {
	mdu_array_info_t	array;
	mdu_disk_info_t		disk;
	__u64			events;
	int			uuid[4];
	char			name[33];
	unsigned long long	data_offset;
	unsigned long long	component_size;
	int			reshape_active;
	unsigned long long	reshape_progress;
	int			new_level, delta_disks, new_layout, new_chunk;
};

struct createinfo {
	int	uid;
	int	gid;
	int	autof;
	int	mode;
	int	symlinks;
	struct supertype *supertype;
};

#define Name "mdadm"

enum mode {
	ASSEMBLE=1,
	BUILD,
	CREATE,
	MANAGE,
	MISC,
	MONITOR,
	GROW,
};

extern char short_options[];
extern char short_bitmap_auto_options[];
extern struct option long_options[];
extern char Version[], Usage[], Help[], OptionHelp[],
	Help_create[], Help_build[], Help_assemble[], Help_grow[],
	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'.
 */
enum special_options {
	AssumeClean = 2,
	BitmapChunk,
	WriteBehind,
	ReAdd,
	NoDegraded,
	Sparc22,
	BackupFile,
	HomeHost,
	AutoHomeHost,
	Symlinks,
};

/* structures read from config file */
/* List of mddevice names and identifiers
 * Identifiers can be:
 *    uuid=128-hex-uuid
 *    super-minor=decimal-minor-number-from-superblock
 *    devices=comma,separated,list,of,device,names,with,wildcards
 *
 * If multiple fields are present, the intersection of all matching
 * devices is considered
 */
#define UnSet (0xfffe)
typedef struct mddev_ident_s {
	char	*devname;
	
	int	uuid_set;
	int	uuid[4];
	char	name[33];

	unsigned int super_minor;

	char	*devices;	/* comma separated list of device
				 * names with wild cards
				 */
	int	level;
	unsigned int raid_disks;
	unsigned int spare_disks;
	struct supertype *st;
	int	autof;		/* 1 for normal, 2 for partitioned */
	char	*spare_group;
	char	*bitmap_file;
	int	bitmap_fd;

	struct mddev_ident_s *next;
} *mddev_ident_t;

/* List of device names - wildcards expanded */
typedef struct mddev_dev_s {
	char *devname;
	char disposition;	/* 'a' for add, 'r' for remove, 'f' for fail.
				 * Not set for names read from .config
				 */
	char writemostly;
	char re_add;
	char used;		/* set when used */
	struct mddev_dev_s *next;
} *mddev_dev_t;

typedef struct mapping {
	char *name;
	int num;
} mapping_t;


struct mdstat_ent {
	char		*dev;
	int		devnum;
	int		active;
	char		*level;
	char		*pattern; /* U or up, _ for down */
	int		percent; /* -1 if no resync */
	int		resync; /* 1 if resync, 0 if recovery */
	struct mdstat_ent *next;
};

extern struct mdstat_ent *mdstat_read(int hold, int start);
extern void free_mdstat(struct mdstat_ent *ms);
extern void mdstat_wait(int seconds);

/* Data structure for holding info read from sysfs */
struct sysdev {
	char	name[20];
	int	role;
	int	major, minor;
	unsigned long long offset, size;
	int	state;
	int	errors;
	struct sysdev *next;
};
struct sysarray {
	char	name[20];
	struct sysdev *devs;
	int	chunk;
	unsigned long long component_size;
	int	layout;
	int	level;
	int	spares;
	int	cache_size;
	int	mismatch_cnt;
};
/* various details can be requested */
#define	GET_LEVEL	1
#define	GET_LAYOUT	2
#define	GET_COMPONENT	4
#define	GET_CHUNK	8
#define GET_CACHE	16
#define	GET_MISMATCH	32

#define	GET_DEVS	1024 /* gets role, major, minor */
#define	GET_OFFSET	2048
#define	GET_SIZE	4096
#define	GET_STATE	8192
#define	GET_ERROR	16384

/* If fd >= 0, get the array it is open on,
 * else use devnum. >=0 -> major9. <0.....
 */
extern struct sysarray *sysfs_read(int fd, int devnum, unsigned long options);
extern int sysfs_set_str(struct sysarray *sra, struct sysdev *dev,
			 char *name, char *val);
extern int sysfs_set_num(struct sysarray *sra, struct sysdev *dev,
			 char *name, unsigned long long val);
extern int sysfs_get_ll(struct sysarray *sra, struct sysdev *dev,
			char *name, unsigned long long *val);


extern int save_stripes(int *source, unsigned long long *offsets,
			int raid_disks, int chunk_size, int level, int layout,
			int nwrites, int *dest,
			unsigned long long start, unsigned long long length);
extern int restore_stripes(int *dest, unsigned long long *offsets,
			   int raid_disks, int chunk_size, int level, int layout,
			   int source, unsigned long long read_offset,
			   unsigned long long start, unsigned long long length);

#ifndef Sendmail
#define Sendmail "/usr/lib/sendmail -t"
#endif

#define SYSLOG_FACILITY LOG_DAEMON

extern char *map_num(mapping_t *map, int num);
extern int map_name(mapping_t *map, char *name);
extern mapping_t r5layout[], pers[], modes[], faultylayout[];

extern char *map_dev(int major, int minor, int create);


extern struct superswitch {
	void (*examine_super)(void *sbv, char *homehost);
	void (*brief_examine_super)(void *sbv);
	void (*detail_super)(void *sbv, char *homehost);
	void (*brief_detail_super)(void *sbv);
	void (*uuid_from_super)(int uuid[4], void *sbv);
	void (*getinfo_super)(struct mdinfo *info, void *sbv);
	int (*match_home)(void *sbv, char *homehost);
	int (*update_super)(struct mdinfo *info, void *sbv, char *update,
			    char *devname, int verbose,
			    int uuid_set, char *homehost);
	int (*init_super)(struct supertype *st, void **sbp, mdu_array_info_t *info, unsigned long long size, char *name, char *homehost, int *uuid);
	void (*add_to_super)(void *sbv, mdu_disk_info_t *dinfo);
	int (*store_super)(struct supertype *st, int fd, void *sbv);
	int (*write_init_super)(struct supertype *st, void *sbv, mdu_disk_info_t *dinfo, char *devname);
	int (*compare_super)(void **firstp, void *secondv);
	int (*load_super)(struct supertype *st, int fd, void **sbp, char *devname);
	struct supertype * (*match_metadata_desc)(char *arg);
	__u64 (*avail_size)(struct supertype *st, __u64 size);
	int (*add_internal_bitmap)(struct supertype *st, void *sbv, int *chunkp,
				   int delay, int write_behind,
				   unsigned long long size, int may_change, int major);
	void (*locate_bitmap)(struct supertype *st, int fd, void *sbv);
	int (*write_bitmap)(struct supertype *st, int fd, void *sbv);
	int major;
	int swapuuid; /* true if uuid is bigending rather than hostendian */
} super0, super1, *superlist[];

struct supertype {
	struct superswitch *ss;
	int minor_version;
	int max_devs;
};

extern struct supertype *super_by_version(int vers, int minor);
extern struct supertype *guess_super(int fd);
extern int get_dev_size(int fd, char *dname, unsigned long long *sizep);

#if __GNUC__ < 3
struct stat64;
#endif

#define HAVE_NFTW  we assume
#define HAVE_FTW

#ifdef UCLIBC
# include <features.h>
# ifndef  __UCLIBC_HAS_FTW__
#  undef HAVE_FTW
#  undef HAVE_NFTW
# endif
#endif

#ifdef __dietlibc__
# undef HAVE_NFTW
#endif

#ifndef HAVE_NFTW
# define FTW_PHYS 1
# ifndef HAVE_FTW
  struct FTW {};
# endif
#endif

#ifdef HAVE_FTW
# include <ftw.h>
#endif

extern int add_dev(const char *name, const struct stat *stb, int flag, struct FTW *s);


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_reconfig(char *devname, int fd, int layout);
extern int Manage_subdevs(char *devname, int fd,
			  mddev_dev_t devlist, int verbose);
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, int layout, int chunksize, int raid_disks);
extern int Grow_restart(struct supertype *st, struct mdinfo *info,
			int *fdlist, int cnt, char *backup_file);


extern int Assemble(struct supertype *st, char *mddev, int mdfd,
		    mddev_ident_t ident,
		    mddev_dev_t devlist, char *backup_file,
		    int readonly, int runstop,
		    char *update, char *homehost,
		    int verbose, int force);

extern int Build(char *mddev, int mdfd, int chunk, int level, int layout,
		 int raiddisks,
		 mddev_dev_t devlist, int assume_clean,
		 char *bitmap_file, int bitmap_chunk, int write_behind, int delay, int verbose);


extern int Create(struct supertype *st, char *mddev, int mdfd,
		  int chunk, int level, int layout, unsigned long long size, int raiddisks, int sparedisks,
		  char *name, char *homehost, int *uuid,
		  int subdevs, mddev_dev_t devlist,
		  int runstop, int verbose, int force, int assume_clean,
		  char *bitmap_file, int bitmap_chunk, int write_behind, int delay);

extern int Detail(char *dev, int brief, int test, char *homehost);
extern int Query(char *dev);
extern int Examine(mddev_dev_t devlist, int brief, int scan, int SparcAdjust,
		   struct supertype *forcest, char *homehost);
extern int Monitor(mddev_dev_t devlist,
		   char *mailaddr, char *alert_cmd,
		   int period, int daemonise, int scan, int oneshot,
		   int dosyslog, int test, char *pidfile);

extern int Kill(char *dev, int force, int quiet);
extern int Wait(char *dev);

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 bitmap_update_uuid(int fd, int *uuid, int swap);

extern int md_get_version(int fd);
extern int get_linux_version(void);
extern int parse_uuid(char *str, int uuid[4]);
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 get_mdp_major(void);
extern int dev_open(char *dev, int flags);
extern int is_standard(char *dev, int *nump);

extern int parse_auto(char *str, char *msg, int config);
extern mddev_ident_t conf_get_ident(char *dev);
extern mddev_dev_t conf_get_devs(void);
extern struct createinfo *conf_get_create_info(void);
extern void set_conffile(char *file);
extern char *conf_get_mailaddr(void);
extern char *conf_get_mailfrom(void);
extern char *conf_get_program(void);
extern char *conf_get_homehost(void);
extern char *conf_line(FILE *file);
extern char *conf_word(FILE *file, int allow_key);
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 int same_uuid(int a[4], int b[4], int swapuuid);
extern void copy_uuid(void *a, int b[4], int swapuuid);
/* extern int compare_super(mdp_super_t *first, mdp_super_t *second);*/
extern unsigned long calc_csum(void *super, int bytes);
extern int enough(int level, int raid_disks, int layout, int clean,
		   char *avail, int avail_disks);
extern int ask(char *mesg);
extern unsigned long long get_component_size(int fd);
extern void remove_partitions(int fd);


extern char *human_size(long long bytes);
char *human_size_brief(long long bytes);

extern void put_md_name(char *name);
extern char *get_md_name(int dev);

extern char DefaultConfFile[];

extern int open_mddev(char *dev, int autof);


#define	LEVEL_MULTIPATH		(-4)
#define	LEVEL_LINEAR		(-1)
#define	LEVEL_FAULTY		(-5)


/* faulty stuff */

#define	WriteTransient	0
#define	ReadTransient	1
#define	WritePersistent	2
#define	ReadPersistent	3
#define	WriteAll	4 /* doesn't go to device */
#define	ReadFixable	5
#define	Modes	6

#define	ClearErrors	31
#define	ClearFaults	30

#define AllPersist	100 /* internal use only */
#define	NoPersist	101

#define	ModeMask	0x1f
#define	ModeShift	5


#ifdef __TINYC__
#undef minor
#undef major
#undef makedev
#define minor(x) ((x)&0xff)
#define major(x) (((x)>>8)&0xff)
#define makedev(M,m) (((M)<<8) | (m))
#endif

/* for raid5 */
#define ALGORITHM_LEFT_ASYMMETRIC	0
#define ALGORITHM_RIGHT_ASYMMETRIC	1
#define ALGORITHM_LEFT_SYMMETRIC	2
#define ALGORITHM_RIGHT_SYMMETRIC	3
Commit	Line	Data
	1	/*
	2	* mdadm - manage Linux "md" devices aka RAID arrays.
	3	*
	4	* Copyright (C) 2001-2006 Neil Brown <neilb@suse.de>
	5	*
	6	*
	7	* This program is free software; you can redistribute it and/or modify
	8	* it under the terms of the GNU General Public License as published by
	9	* the Free Software Foundation; either version 2 of the License, or
	10	* (at your option) any later version.
	11	*
	12	* This program is distributed in the hope that it will be useful,
	13	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	14	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	15	* GNU General Public License for more details.
	16	*
	17	* You should have received a copy of the GNU General Public License
	18	* along with this program; if not, write to the Free Software
	19	* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
	20	*
	21	* Author: Neil Brown
	22	* Email: <neilb@cse.unsw.edu.au>
	23	* Paper: Neil Brown
	24	* School of Computer Science and Engineering
	25	* The University of New South Wales
	26	* Sydney, 2052
	27	* Australia
	28	*/
	29
	30	#define _GNU_SOURCE
	31	#include <unistd.h>
	32	#ifndef __dietlibc__
	33	extern __off64_t lseek64 __P ((int __fd, __off64_t __offset, int __whence));
	34	#endif
	35
	36	#include <sys/types.h>
	37	#include <sys/stat.h>
	38	#include <stdlib.h>
	39	#include <time.h>
	40	#include <sys/time.h>
	41	#include <getopt.h>
	42	#include <fcntl.h>
	43	#include <stdio.h>
	44	#include <errno.h>
	45	#include <string.h>
	46	#include <syslog.h>
	47	#ifdef __dietlibc__
	48	#include <strings.h>
	49	/* dietlibc has deprecated random and srandom!! */
	50	#define random rand
	51	#define srandom srand
	52	#endif
	53
	54
	55	#include <linux/kdev_t.h>
	56	/#include <linux/fs.h> /
	57	#include <sys/mount.h>
	58	#include <asm/types.h>
	59	#include <sys/ioctl.h>
	60	#define MD_MAJOR 9
	61	#define MdpMinorShift 6
	62
	63	#ifndef BLKGETSIZE64
	64	#define BLKGETSIZE64 _IOR(0x12,114,size_t) /* return device size in bytes (u64 arg) /
	65	#endif
	66
	67	#define DEFAULT_BITMAP_CHUNK 4096
	68	#define DEFAULT_BITMAP_DELAY 5
	69	#define DEFAULT_MAX_WRITE_BEHIND 256
	70
	71	#include "md_u.h"
	72	#include "md_p.h"
	73	#include "bitmap.h"
	74
	75	#include <endian.h>
	76	/* Redhat don't like to #include <asm/byteorder.h>, and
	77	* some time include <linux/byteorder/xxx_endian.h> isn't enough,
	78	* and there is no standard conversion function so... */
	79	/* And dietlibc doesn't think byteswap is ok, so.. */
	80	/* #include <byteswap.h> */
	81	#define bswap_16(x) (((x) & 0x00ffU) << 8 \| \
	82	((x) & 0xff00U) >> 8)
	83	#define bswap_32(x) (((x) & 0x000000ffU) << 24 \| \
	84	((x) & 0xff000000U) >> 24 \| \
	85	((x) & 0x0000ff00U) << 8 \| \
	86	((x) & 0x00ff0000U) >> 8)
	87	#define bswap_64(x) (((x) & 0x00000000000000ffULL) << 56 \| \
	88	((x) & 0xff00000000000000ULL) >> 56 \| \
	89	((x) & 0x000000000000ff00ULL) << 40 \| \
	90	((x) & 0x00ff000000000000ULL) >> 40 \| \
	91	((x) & 0x0000000000ff0000ULL) << 24 \| \
	92	((x) & 0x0000ff0000000000ULL) >> 24 \| \
	93	((x) & 0x00000000ff000000ULL) << 8 \| \
	94	((x) & 0x000000ff00000000ULL) >> 8)
	95
	96	#if BYTE_ORDER == LITTLE_ENDIAN
	97	#define __cpu_to_le16(_x) (_x)
	98	#define __cpu_to_le32(_x) (_x)
	99	#define __cpu_to_le64(_x) (_x)
	100	#define __le16_to_cpu(_x) (_x)
	101	#define __le32_to_cpu(_x) (_x)
	102	#define __le64_to_cpu(_x) (_x)
	103	#elif BYTE_ORDER == BIG_ENDIAN
	104	#define __cpu_to_le16(_x) bswap_16(_x)
	105	#define __cpu_to_le32(_x) bswap_32(_x)
	106	#define __cpu_to_le64(_x) bswap_64(_x)
	107	#define __le16_to_cpu(_x) bswap_16(_x)
	108	#define __le32_to_cpu(_x) bswap_32(_x)
	109	#define __le64_to_cpu(_x) bswap_64(_x)
	110	#else
	111	# error "unknown endianness."
	112	#endif
	113
	114
	115
	116	/* general information that might be extracted from a superblock */
	117	struct mdinfo {
	118	mdu_array_info_t array;
	119	mdu_disk_info_t disk;
	120	__u64 events;
	121	int uuid[4];
	122	char name[33];
	123	unsigned long long data_offset;
	124	unsigned long long component_size;
	125	int reshape_active;
	126	unsigned long long reshape_progress;
	127	int new_level, delta_disks, new_layout, new_chunk;
	128	};
	129
	130	struct createinfo {
	131	int uid;
	132	int gid;
	133	int autof;
	134	int mode;
	135	int symlinks;
	136	struct supertype *supertype;
	137	};
	138
	139	#define Name "mdadm"
	140
	141	enum mode {
	142	ASSEMBLE=1,
	143	BUILD,
	144	CREATE,
	145	MANAGE,
	146	MISC,
	147	MONITOR,
	148	GROW,
	149	};
	150
	151	extern char short_options[];
	152	extern char short_bitmap_auto_options[];
	153	extern struct option long_options[];
	154	extern char Version[], Usage[], Help[], OptionHelp[],
	155	Help_create[], Help_build[], Help_assemble[], Help_grow[],
	156	Help_manage[], Help_misc[], Help_monitor[], Help_config[];
	157
	158	/* for option that don't have short equivilents, we assign arbitrary
	159	* small numbers. '1' means an undecorated option, so we start at '2'.
	160	*/
	161	enum special_options {
	162	AssumeClean = 2,
	163	BitmapChunk,
	164	WriteBehind,
	165	ReAdd,
	166	NoDegraded,
	167	Sparc22,
	168	BackupFile,
	169	HomeHost,
	170	AutoHomeHost,
	171	Symlinks,
	172	};
	173
	174	/* structures read from config file */
	175	/* List of mddevice names and identifiers
	176	* Identifiers can be:
	177	* uuid=128-hex-uuid
	178	* super-minor=decimal-minor-number-from-superblock
	179	* devices=comma,separated,list,of,device,names,with,wildcards
	180	*
	181	* If multiple fields are present, the intersection of all matching
	182	* devices is considered
	183	*/
	184	#define UnSet (0xfffe)
	185	typedef struct mddev_ident_s {
	186	char *devname;
	187
	188	int uuid_set;
	189	int uuid[4];
	190	char name[33];
	191
	192	unsigned int super_minor;
	193
	194	char devices; / comma separated list of device
	195	* names with wild cards
	196	*/
	197	int level;
	198	unsigned int raid_disks;
	199	unsigned int spare_disks;
	200	struct supertype *st;
	201	int autof; /* 1 for normal, 2 for partitioned */
	202	char *spare_group;
	203	char *bitmap_file;
	204	int bitmap_fd;
	205
	206	struct mddev_ident_s *next;
	207	} *mddev_ident_t;
	208
	209	/* List of device names - wildcards expanded */
	210	typedef struct mddev_dev_s {
	211	char *devname;
	212	char disposition; /* 'a' for add, 'r' for remove, 'f' for fail.
	213	* Not set for names read from .config
	214	*/
	215	char writemostly;
	216	char re_add;
	217	char used; /* set when used */
	218	struct mddev_dev_s *next;
	219	} *mddev_dev_t;
	220
	221	typedef struct mapping {
	222	char *name;
	223	int num;
	224	} mapping_t;
	225
	226
	227	struct mdstat_ent {
	228	char *dev;
	229	int devnum;
	230	int active;
	231	char *level;
	232	char pattern; / U or up, _ for down */
	233	int percent; /* -1 if no resync */
	234	int resync; /* 1 if resync, 0 if recovery */
	235	struct mdstat_ent *next;
	236	};
	237
	238	extern struct mdstat_ent *mdstat_read(int hold, int start);
	239	extern void free_mdstat(struct mdstat_ent *ms);
	240	extern void mdstat_wait(int seconds);
	241
	242	/* Data structure for holding info read from sysfs */
	243	struct sysdev {
	244	char name[20];
	245	int role;
	246	int major, minor;
	247	unsigned long long offset, size;
	248	int state;
	249	int errors;
	250	struct sysdev *next;
	251	};
	252	struct sysarray {
	253	char name[20];
	254	struct sysdev *devs;
	255	int chunk;
	256	unsigned long long component_size;
	257	int layout;
	258	int level;
	259	int spares;
	260	int cache_size;
	261	int mismatch_cnt;
	262	};
	263	/* various details can be requested */
	264	#define GET_LEVEL 1
	265	#define GET_LAYOUT 2
	266	#define GET_COMPONENT 4
	267	#define GET_CHUNK 8
	268	#define GET_CACHE 16
	269	#define GET_MISMATCH 32
	270
	271	#define GET_DEVS 1024 /* gets role, major, minor */
	272	#define GET_OFFSET 2048
	273	#define GET_SIZE 4096
	274	#define GET_STATE 8192
	275	#define GET_ERROR 16384
	276
	277	/* If fd >= 0, get the array it is open on,
	278	* else use devnum. >=0 -> major9. <0.....
	279	*/
	280	extern struct sysarray *sysfs_read(int fd, int devnum, unsigned long options);
	281	extern int sysfs_set_str(struct sysarray sra, struct sysdev dev,
	282	char name, char val);
	283	extern int sysfs_set_num(struct sysarray sra, struct sysdev dev,
	284	char *name, unsigned long long val);
	285	extern int sysfs_get_ll(struct sysarray sra, struct sysdev dev,
	286	char name, unsigned long long val);
	287
	288
	289	extern int save_stripes(int source, unsigned long long offsets,
	290	int raid_disks, int chunk_size, int level, int layout,
	291	int nwrites, int *dest,
	292	unsigned long long start, unsigned long long length);
	293	extern int restore_stripes(int dest, unsigned long long offsets,
	294	int raid_disks, int chunk_size, int level, int layout,
	295	int source, unsigned long long read_offset,
	296	unsigned long long start, unsigned long long length);
	297
	298	#ifndef Sendmail
	299	#define Sendmail "/usr/lib/sendmail -t"
	300	#endif
	301
	302	#define SYSLOG_FACILITY LOG_DAEMON
	303
	304	extern char map_num(mapping_t map, int num);
	305	extern int map_name(mapping_t map, char name);
	306	extern mapping_t r5layout[], pers[], modes[], faultylayout[];
	307
	308	extern char *map_dev(int major, int minor, int create);
	309
	310
	311	extern struct superswitch {
	312	void (examine_super)(void sbv, char *homehost);
	313	void (brief_examine_super)(void sbv);
	314	void (detail_super)(void sbv, char *homehost);
	315	void (brief_detail_super)(void sbv);
	316	void (uuid_from_super)(int uuid[4], void sbv);
	317	void (getinfo_super)(struct mdinfo info, void *sbv);
	318	int (match_home)(void sbv, char *homehost);
	319	int (update_super)(struct mdinfo info, void sbv, char update,
	320	char *devname, int verbose,
	321	int uuid_set, char *homehost);
	322	int (init_super)(struct supertype st, void *sbp, mdu_array_info_t info, unsigned long long size, char name, char homehost, int *uuid);
	323	void (add_to_super)(void sbv, mdu_disk_info_t *dinfo);
	324	int (store_super)(struct supertype st, int fd, void *sbv);
	325	int (write_init_super)(struct supertype st, void sbv, mdu_disk_info_t dinfo, char *devname);
	326	int (compare_super)(void firstp, void secondv);
	327	int (load_super)(struct supertype st, int fd, void *sbp, char devname);
	328	struct supertype * (match_metadata_desc)(char arg);
	329	__u64 (avail_size)(struct supertype st, __u64 size);
	330	int (add_internal_bitmap)(struct supertype st, void sbv, int chunkp,
	331	int delay, int write_behind,
	332	unsigned long long size, int may_change, int major);
	333	void (locate_bitmap)(struct supertype st, int fd, void *sbv);
	334	int (write_bitmap)(struct supertype st, int fd, void *sbv);
	335	int major;
	336	int swapuuid; /* true if uuid is bigending rather than hostendian */
	337	} super0, super1, *superlist[];
	338
	339	struct supertype {
	340	struct superswitch *ss;
	341	int minor_version;
	342	int max_devs;
	343	};
	344
	345	extern struct supertype *super_by_version(int vers, int minor);
	346	extern struct supertype *guess_super(int fd);
	347	extern int get_dev_size(int fd, char dname, unsigned long long sizep);
	348
	349	#if __GNUC__ < 3
	350	struct stat64;
	351	#endif
	352
	353	#define HAVE_NFTW we assume
	354	#define HAVE_FTW
	355
	356	#ifdef UCLIBC
	357	# include <features.h>
	358	# ifndef __UCLIBC_HAS_FTW__
	359	# undef HAVE_FTW
	360	# undef HAVE_NFTW
	361	# endif
	362	#endif
	363
	364	#ifdef __dietlibc__
	365	# undef HAVE_NFTW
	366	#endif
	367
	368	#ifndef HAVE_NFTW
	369	# define FTW_PHYS 1
	370	# ifndef HAVE_FTW
	371	struct FTW {};
	372	# endif
	373	#endif
	374
	375	#ifdef HAVE_FTW
	376	# include <ftw.h>
	377	#endif
	378
	379	extern int add_dev(const char name, const struct stat stb, int flag, struct FTW *s);
	380
	381
	382	extern int Manage_ro(char *devname, int fd, int readonly);
	383	extern int Manage_runstop(char *devname, int fd, int runstop, int quiet);
	384	extern int Manage_resize(char *devname, int fd, long long size, int raid_disks);
	385	extern int Manage_reconfig(char *devname, int fd, int layout);
	386	extern int Manage_subdevs(char *devname, int fd,
	387	mddev_dev_t devlist, int verbose);
	388	extern int Grow_Add_device(char devname, int fd, char newdev);
	389	extern int Grow_addbitmap(char devname, int fd, char file, int chunk, int delay, int write_behind, int force);
	390	extern int Grow_reshape(char devname, int fd, int quiet, char backup_file,
	391	long long size,
	392	int level, int layout, int chunksize, int raid_disks);
	393	extern int Grow_restart(struct supertype st, struct mdinfo info,
	394	int fdlist, int cnt, char backup_file);
	395
	396
	397	extern int Assemble(struct supertype st, char mddev, int mdfd,
	398	mddev_ident_t ident,
	399	mddev_dev_t devlist, char *backup_file,
	400	int readonly, int runstop,
	401	char update, char homehost,
	402	int verbose, int force);
	403
	404	extern int Build(char *mddev, int mdfd, int chunk, int level, int layout,
	405	int raiddisks,
	406	mddev_dev_t devlist, int assume_clean,
	407	char *bitmap_file, int bitmap_chunk, int write_behind, int delay, int verbose);
	408
	409
	410	extern int Create(struct supertype st, char mddev, int mdfd,
	411	int chunk, int level, int layout, unsigned long long size, int raiddisks, int sparedisks,
	412	char name, char homehost, int *uuid,
	413	int subdevs, mddev_dev_t devlist,
	414	int runstop, int verbose, int force, int assume_clean,
	415	char *bitmap_file, int bitmap_chunk, int write_behind, int delay);
	416
	417	extern int Detail(char dev, int brief, int test, char homehost);
	418	extern int Query(char *dev);
	419	extern int Examine(mddev_dev_t devlist, int brief, int scan, int SparcAdjust,
	420	struct supertype forcest, char homehost);
	421	extern int Monitor(mddev_dev_t devlist,
	422	char mailaddr, char alert_cmd,
	423	int period, int daemonise, int scan, int oneshot,
	424	int dosyslog, int test, char *pidfile);
	425
	426	extern int Kill(char *dev, int force, int quiet);
	427	extern int Wait(char *dev);
	428
	429	extern int CreateBitmap(char *filename, int force, char uuid[16],
	430	unsigned long chunksize, unsigned long daemon_sleep,
	431	unsigned long write_behind,
	432	unsigned long long array_size,
	433	int major);
	434	extern int ExamineBitmap(char filename, int brief, struct supertype st);
	435	extern int bitmap_update_uuid(int fd, int *uuid, int swap);
	436
	437	extern int md_get_version(int fd);
	438	extern int get_linux_version(void);
	439	extern int parse_uuid(char *str, int uuid[4]);
	440	extern int check_ext2(int fd, char *name);
	441	extern int check_reiser(int fd, char *name);
	442	extern int check_raid(int fd, char *name);
	443
	444	extern int get_mdp_major(void);
	445	extern int dev_open(char *dev, int flags);
	446	extern int is_standard(char dev, int nump);
	447
	448	extern int parse_auto(char str, char msg, int config);
	449	extern mddev_ident_t conf_get_ident(char *dev);
	450	extern mddev_dev_t conf_get_devs(void);
	451	extern struct createinfo *conf_get_create_info(void);
	452	extern void set_conffile(char *file);
	453	extern char *conf_get_mailaddr(void);
	454	extern char *conf_get_mailfrom(void);
	455	extern char *conf_get_program(void);
	456	extern char *conf_get_homehost(void);
	457	extern char conf_line(FILE file);
	458	extern char conf_word(FILE file, int allow_key);
	459	extern void free_line(char *line);
	460	extern int match_oneof(char devices, char devname);
	461	extern void uuid_from_super(int uuid[4], mdp_super_t *super);
	462	extern int same_uuid(int a[4], int b[4], int swapuuid);
	463	extern void copy_uuid(void *a, int b[4], int swapuuid);
	464	/* extern int compare_super(mdp_super_t first, mdp_super_t second);*/
	465	extern unsigned long calc_csum(void *super, int bytes);
	466	extern int enough(int level, int raid_disks, int layout, int clean,
	467	char *avail, int avail_disks);
	468	extern int ask(char *mesg);
	469	extern unsigned long long get_component_size(int fd);
	470	extern void remove_partitions(int fd);
	471
	472
	473	extern char *human_size(long long bytes);
	474	char *human_size_brief(long long bytes);
	475
	476	extern void put_md_name(char *name);
	477	extern char *get_md_name(int dev);
	478
	479	extern char DefaultConfFile[];
	480
	481	extern int open_mddev(char *dev, int autof);
	482
	483
	484	#define LEVEL_MULTIPATH (-4)
	485	#define LEVEL_LINEAR (-1)
	486	#define LEVEL_FAULTY (-5)
	487
	488
	489	/* faulty stuff */
	490
	491	#define WriteTransient 0
	492	#define ReadTransient 1
	493	#define WritePersistent 2
	494	#define ReadPersistent 3
	495	#define WriteAll 4 /* doesn't go to device */
	496	#define ReadFixable 5
	497	#define Modes 6
	498
	499	#define ClearErrors 31
	500	#define ClearFaults 30
	501
	502	#define AllPersist 100 /* internal use only */
	503	#define NoPersist 101
	504
	505	#define ModeMask 0x1f
	506	#define ModeShift 5
	507
	508
	509	#ifdef __TINYC__
	510	#undef minor
	511	#undef major
	512	#undef makedev
	513	#define minor(x) ((x)&0xff)
	514	#define major(x) (((x)>>8)&0xff)
	515	#define makedev(M,m) (((M)<<8) \| (m))
	516	#endif
	517
	518	/* for raid5 */
	519	#define ALGORITHM_LEFT_ASYMMETRIC 0
	520	#define ALGORITHM_RIGHT_ASYMMETRIC 1
	521	#define ALGORITHM_LEFT_SYMMETRIC 2
	522	#define ALGORITHM_RIGHT_SYMMETRIC 3