[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
#define _FILE_OFFSET_BITS 64
#include	<unistd.h>
#if !defined(__dietlibc__) && !defined(__KLIBC__)
extern __off64_t lseek64 __P ((int __fd, __off64_t __offset, int __whence));
#else
# if defined(__NO_STAT64) || __WORDSIZE != 32
# define lseek64 lseek
# endif
#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 !defined(__KLIBC__)
#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
#endif /* __KLIBC__ */


/* 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;
	int			errors;
	int			cache_size; /* size of raid456 stripe cache*/
	int			mismatch_cnt;
	char			text_version[50];

	char 		sys_name[20];
	struct mdinfo *devs;
	struct mdinfo *next;
};

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,
	INCREMENTAL,
	AUTODETECT,
};

extern char short_options[];
extern char short_bitmap_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_incr[],
	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,
	AutoDetect,
};

/* 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);
extern int mddev_busy(int devnum);

struct map_ent {
	struct map_ent *next;
	int	devnum;
	int	major,minor;
	int	uuid[4];
	char	*path;
};
extern int map_update(struct map_ent **mpp, int devnum, int major, int minor,
		      int uuid[4], char *path);
extern struct map_ent *map_by_uuid(struct map_ent **map, int uuid[4]);
extern void map_read(struct map_ent **melp);
extern int map_write(struct map_ent *mel);
extern void map_delete(struct map_ent **mapp, int devnum);
extern void map_free(struct map_ent *map);
extern void map_add(struct map_ent **melp,
		    int devnum, int major, int minor, int uuid[4], char *path);

/* 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_VERSION	64

#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 void sysfs_free(struct mdinfo *sra);
extern struct mdinfo *sysfs_read(int fd, int devnum, unsigned long options);
extern int sysfs_set_str(struct mdinfo *sra, struct mdinfo *dev,
			 char *name, char *val);
extern int sysfs_set_num(struct mdinfo *sra, struct mdinfo *dev,
			 char *name, unsigned long long val);
extern int sysfs_get_ll(struct mdinfo *sra, struct mdinfo *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)(struct supertype *st, char *homehost);
	void (*brief_examine_super)(struct supertype *st);
	void (*detail_super)(struct supertype *st, char *homehost);
	void (*export_super)(struct supertype *st);
	void (*brief_detail_super)(struct supertype *st);
	void (*uuid_from_super)(struct supertype *st, int uuid[4]);
	void (*getinfo_super)(struct supertype *st, struct mdinfo *info);
	int (*match_home)(struct supertype *st, char *homehost);
	int (*update_super)(struct supertype *st, struct mdinfo *info,
			    char *update,
			    char *devname, int verbose,
			    int uuid_set, char *homehost);
	int (*init_super)(struct supertype *st, mdu_array_info_t *info,
			  unsigned long long size, char *name,
			  char *homehost, int *uuid);
	void (*add_to_super)(struct supertype *st, mdu_disk_info_t *dinfo);
	int (*store_super)(struct supertype *st, int fd);
	int (*write_init_super)(struct supertype *st, mdu_disk_info_t *dinfo,
				char *devname);
	int (*compare_super)(struct supertype *st, struct supertype *tst);
	int (*load_super)(struct supertype *st, int fd, char *devname);
	struct supertype * (*match_metadata_desc)(char *arg);
	__u64 (*avail_size)(struct supertype *st, __u64 size);
	int (*add_internal_bitmap)(struct supertype *st, int *chunkp,
				   int delay, int write_behind,
				   unsigned long long size, int may_change, int major);
	void (*locate_bitmap)(struct supertype *st, int fd);
	int (*write_bitmap)(struct supertype *st, int fd);
	void (*free_super)(struct supertype *st);
	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;
	void *sb;
};

extern struct supertype *super_by_fd(int fd);
extern 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 void get_one_disk(int mdfd, mdu_array_info_t *ainf,
			 mdu_disk_info_t *disk);

#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

#if defined(__KLIBC__)
# undef HAVE_NFTW
# undef HAVE_FTW
#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 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, 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 export, 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 Incremental(char *devname, int verbose, int runstop,
		       struct supertype *st, char *homehost, int autof);
extern void RebuildMap(void);
extern int IncrementalScan(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 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 int conf_test_dev(char *devname);
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 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);
extern int open_mddev_devnum(char *devname, int devnum, char *name,
			     char *chosen_name);


#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
64c4757e	1	/*
9a9dab36	2	* mdadm - manage Linux "md" devices aka RAID arrays.
64c4757e	3	*
4f589ad0	4	* Copyright (C) 2001-2006 Neil Brown <neilb@suse.de>
64c4757e NB	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
4ccdb956	30	#define _GNU_SOURCE
c2c9bb6f	31	#define _FILE_OFFSET_BITS 64
64c4757e	32	#include <unistd.h>
e39b673e	33	#if !defined(__dietlibc__) && !defined(__KLIBC__)
64c4757e	34	extern __off64_t lseek64 __P ((int __fd, __off64_t __offset, int __whence));
f783ca4f	35	#else
fffdbe5e	36	# if defined(__NO_STAT64) \|\| __WORDSIZE != 32
f783ca4f NB	37	# define lseek64 lseek
f783ca4f NB	38	# endif
98c6faba	39	#endif
64c4757e NB	40
	41	#include <sys/types.h>
	42	#include <sys/stat.h>
	43	#include <stdlib.h>
	44	#include <time.h>
11018a45	45	#include <sys/time.h>
64c4757e NB	46	#include <getopt.h>
	47	#include <fcntl.h>
	48	#include <stdio.h>
	49	#include <errno.h>
	50	#include <string.h>
773135f5	51	#include <syslog.h>
b56c3630 NB	52	#ifdef __dietlibc__
b56c3630 NB	53	#include <strings.h>
280a927d NB	54	/* dietlibc has deprecated random and srandom!! */
	55	#define random rand
	56	#define srandom srand
98c6faba NB	57	#endif
98c6faba NB	58
64c4757e NB	59
64c4757e NB	60	#include <linux/kdev_t.h>
e0d19036 NB	61	/#include <linux/fs.h> /
	62	#include <sys/mount.h>
	63	#include <asm/types.h>
64c4757e NB	64	#include <sys/ioctl.h>
64c4757e NB	65	#define MD_MAJOR 9
dd0781e5	66	#define MdpMinorShift 6
64c4757e	67
e0d19036	68	#ifndef BLKGETSIZE64
98c6faba	69	#define BLKGETSIZE64 _IOR(0x12,114,size_t) /* return device size in bytes (u64 arg) /
e0d19036	70	#endif
56eb10c0	71
c82f047c NB	72	#define DEFAULT_BITMAP_CHUNK 4096
c82f047c NB	73	#define DEFAULT_BITMAP_DELAY 5
dfd4d8ee	74	#define DEFAULT_MAX_WRITE_BEHIND 256
64c4757e NB	75
64c4757e NB	76	#include "md_u.h"
e0d19036	77	#include "md_p.h"
c82f047c	78	#include "bitmap.h"
64c4757e	79
1e0d770c	80	#include <endian.h>
efd441d1 NB	81	/* Redhat don't like to #include <asm/byteorder.h>, and
	82	* some time include <linux/byteorder/xxx_endian.h> isn't enough,
	83	* and there is no standard conversion function so... */
0ae03b8a NB	84	/* And dietlibc doesn't think byteswap is ok, so.. */
	85	/* #include <byteswap.h> */
	86	#define bswap_16(x) (((x) & 0x00ffU) << 8 \| \
	87	((x) & 0xff00U) >> 8)
	88	#define bswap_32(x) (((x) & 0x000000ffU) << 24 \| \
	89	((x) & 0xff000000U) >> 24 \| \
	90	((x) & 0x0000ff00U) << 8 \| \
	91	((x) & 0x00ff0000U) >> 8)
	92	#define bswap_64(x) (((x) & 0x00000000000000ffULL) << 56 \| \
	93	((x) & 0xff00000000000000ULL) >> 56 \| \
	94	((x) & 0x000000000000ff00ULL) << 40 \| \
	95	((x) & 0x00ff000000000000ULL) >> 40 \| \
	96	((x) & 0x0000000000ff0000ULL) << 24 \| \
	97	((x) & 0x0000ff0000000000ULL) >> 24 \| \
	98	((x) & 0x00000000ff000000ULL) << 8 \| \
	99	((x) & 0x000000ff00000000ULL) >> 8)
	100
e39b673e	101	#if !defined(__KLIBC__)
efd441d1 NB	102	#if BYTE_ORDER == LITTLE_ENDIAN
	103	#define __cpu_to_le16(_x) (_x)
	104	#define __cpu_to_le32(_x) (_x)
	105	#define __cpu_to_le64(_x) (_x)
	106	#define __le16_to_cpu(_x) (_x)
	107	#define __le32_to_cpu(_x) (_x)
	108	#define __le64_to_cpu(_x) (_x)
	109	#elif BYTE_ORDER == BIG_ENDIAN
	110	#define __cpu_to_le16(_x) bswap_16(_x)
	111	#define __cpu_to_le32(_x) bswap_32(_x)
	112	#define __cpu_to_le64(_x) bswap_64(_x)
	113	#define __le16_to_cpu(_x) bswap_16(_x)
	114	#define __le32_to_cpu(_x) bswap_32(_x)
	115	#define __le64_to_cpu(_x) bswap_64(_x)
1e0d770c NB	116	#else
	117	# error "unknown endianness."
	118	#endif
e39b673e	119	#endif /* __KLIBC__ */
1e0d770c NB	120
	121
	122
4b1ac34b NB	123	/* general information that might be extracted from a superblock */
	124	struct mdinfo {
	125	mdu_array_info_t array;
	126	mdu_disk_info_t disk;
	127	__u64 events;
fbf8a0b7	128	int uuid[4];
31317663	129	char name[33];
353632d9 NB	130	unsigned long long data_offset;
	131	unsigned long long component_size;
	132	int reshape_active;
	133	unsigned long long reshape_progress;
	134	int new_level, delta_disks, new_layout, new_chunk;
06c7f68e	135	int errors;
7e0f6979 NB	136	int cache_size; /* size of raid456 stripe cache*/
	137	int mismatch_cnt;
	138	char text_version[50];
06c7f68e NB	139
06c7f68e NB	140	char sys_name[20];
7e0f6979	141	struct mdinfo *devs;
06c7f68e	142	struct mdinfo *next;
4b1ac34b NB	143	};
4b1ac34b NB	144
5bbb4842 NB	145	struct createinfo {
	146	int uid;
	147	int gid;
	148	int autof;
	149	int mode;
38098016	150	int symlinks;
058574b1	151	struct supertype *supertype;
5bbb4842 NB	152	};
5bbb4842 NB	153
9a9dab36	154	#define Name "mdadm"
682c7051	155
e0d19036 NB	156	enum mode {
	157	ASSEMBLE=1,
	158	BUILD,
	159	CREATE,
	160	MANAGE,
	161	MISC,
	162	MONITOR,
dd0781e5	163	GROW,
8382f19b	164	INCREMENTAL,
1f48664b	165	AUTODETECT,
e0d19036 NB	166	};
e0d19036 NB	167
64c4757e	168	extern char short_options[];
024768c4	169	extern char short_bitmap_options[];
c06487ce	170	extern char short_bitmap_auto_options[];
64c4757e	171	extern struct option long_options[];
56eedc1a	172	extern char Version[], Usage[], Help[], OptionHelp[],
dd0781e5	173	Help_create[], Help_build[], Help_assemble[], Help_grow[],
8382f19b	174	Help_incr[],
e0d19036	175	Help_manage[], Help_misc[], Help_monitor[], Help_config[];
64c4757e	176
997aed5d NB	177	/* for option that don't have short equivilents, we assign arbitrary
	178	* small numbers. '1' means an undecorated option, so we start at '2'.
	179	*/
	180	enum special_options {
	181	AssumeClean = 2,
	182	BitmapChunk,
	183	WriteBehind,
	184	ReAdd,
	185	NoDegraded,
	186	Sparc22,
	187	BackupFile,
	188	HomeHost,
589395d6	189	AutoHomeHost,
38098016	190	Symlinks,
1f48664b	191	AutoDetect,
997aed5d NB	192	};
997aed5d NB	193
64c4757e	194	/* structures read from config file */
52826846 NB	195	/* List of mddevice names and identifiers
	196	* Identifiers can be:
	197	* uuid=128-hex-uuid
	198	* super-minor=decimal-minor-number-from-superblock
	199	* devices=comma,separated,list,of,device,names,with,wildcards
	200	*
	201	* If multiple fields are present, the intersection of all matching
	202	* devices is considered
	203	*/
98c6faba	204	#define UnSet (0xfffe)
52826846	205	typedef struct mddev_ident_s {
dd0781e5	206	char *devname;
aba69144	207
dd0781e5	208	int uuid_set;
3fa06e9d	209	int uuid[4];
947fd4dd	210	char name[33];
52826846	211
98c6faba	212	unsigned int super_minor;
52826846	213
dd0781e5	214	char devices; / comma separated list of device
52826846 NB	215	* names with wild cards
52826846 NB	216	*/
dd0781e5	217	int level;
98c6faba NB	218	unsigned int raid_disks;
98c6faba NB	219	unsigned int spare_disks;
82d9eba6	220	struct supertype *st;
dd0781e5 NB	221	int autof; /* 1 for normal, 2 for partitioned */
dd0781e5 NB	222	char *spare_group;
7ef02d01	223	char *bitmap_file;
c82f047c	224	int bitmap_fd;
dd0781e5	225
52826846 NB	226	struct mddev_ident_s *next;
52826846 NB	227	} *mddev_ident_t;
64c4757e NB	228
	229	/* List of device names - wildcards expanded */
	230	typedef struct mddev_dev_s {
	231	char *devname;
cd29a5c8 NB	232	char disposition; /* 'a' for add, 'r' for remove, 'f' for fail.
	233	* Not set for names read from .config
	234	*/
dfd4d8ee	235	char writemostly;
fe80f49b	236	char re_add;
811e6cbe	237	char used; /* set when used */
64c4757e NB	238	struct mddev_dev_s *next;
	239	} *mddev_dev_t;
	240
682c7051 NB	241	typedef struct mapping {
	242	char *name;
	243	int num;
	244	} mapping_t;
	245
e0d19036 NB	246
	247	struct mdstat_ent {
	248	char *dev;
	249	int devnum;
	250	int active;
	251	char *level;
	252	char pattern; / U or up, _ for down */
	253	int percent; /* -1 if no resync */
e5329c37	254	int resync; /* 1 if resync, 0 if recovery */
e0d19036 NB	255	struct mdstat_ent *next;
	256	};
	257
22a88995	258	extern struct mdstat_ent *mdstat_read(int hold, int start);
e0d19036	259	extern void free_mdstat(struct mdstat_ent *ms);
dd0781e5	260	extern void mdstat_wait(int seconds);
8382f19b NB	261	extern int mddev_busy(int devnum);
	262
	263	struct map_ent {
	264	struct map_ent *next;
	265	int devnum;
	266	int major,minor;
	267	int uuid[4];
	268	char *path;
	269	};
	270	extern int map_update(struct map_ent **mpp, int devnum, int major, int minor,
	271	int uuid[4], char *path);
	272	extern struct map_ent map_by_uuid(struct map_ent *map, int uuid[4]);
	273	extern void map_read(struct map_ent **melp);
	274	extern int map_write(struct map_ent *mel);
	275	extern void map_delete(struct map_ent **mapp, int devnum);
	276	extern void map_free(struct map_ent *map);
	277	extern void map_add(struct map_ent **melp,
	278	int devnum, int major, int minor, int uuid[4], char *path);
e0d19036	279
e86c9dd6 NB	280	/* various details can be requested */
	281	#define GET_LEVEL 1
	282	#define GET_LAYOUT 2
	283	#define GET_COMPONENT 4
	284	#define GET_CHUNK 8
758d3a8e	285	#define GET_CACHE 16
37dfc3d6	286	#define GET_MISMATCH 32
8382f19b	287	#define GET_VERSION 64
e86c9dd6 NB	288
	289	#define GET_DEVS 1024 /* gets role, major, minor */
	290	#define GET_OFFSET 2048
	291	#define GET_SIZE 4096
	292	#define GET_STATE 8192
	293	#define GET_ERROR 16384
	294
	295	/* If fd >= 0, get the array it is open on,
	296	* else use devnum. >=0 -> major9. <0.....
	297	*/
7e0f6979 NB	298	extern void sysfs_free(struct mdinfo *sra);
	299	extern struct mdinfo *sysfs_read(int fd, int devnum, unsigned long options);
	300	extern int sysfs_set_str(struct mdinfo sra, struct mdinfo dev,
e86c9dd6	301	char name, char val);
7e0f6979	302	extern int sysfs_set_num(struct mdinfo sra, struct mdinfo dev,
e86c9dd6	303	char *name, unsigned long long val);
7e0f6979	304	extern int sysfs_get_ll(struct mdinfo sra, struct mdinfo dev,
e86c9dd6 NB	305	char name, unsigned long long val);
	306
	307
	308	extern int save_stripes(int source, unsigned long long offsets,
	309	int raid_disks, int chunk_size, int level, int layout,
	310	int nwrites, int *dest,
	311	unsigned long long start, unsigned long long length);
353632d9 NB	312	extern int restore_stripes(int dest, unsigned long long offsets,
	313	int raid_disks, int chunk_size, int level, int layout,
	314	int source, unsigned long long read_offset,
	315	unsigned long long start, unsigned long long length);
e86c9dd6	316
52826846 NB	317	#ifndef Sendmail
	318	#define Sendmail "/usr/lib/sendmail -t"
	319	#endif
	320
773135f5 NB	321	#define SYSLOG_FACILITY LOG_DAEMON
773135f5 NB	322
682c7051 NB	323	extern char map_num(mapping_t map, int num);
682c7051 NB	324	extern int map_name(mapping_t map, char name);
b5e64645	325	extern mapping_t r5layout[], pers[], modes[], faultylayout[];
682c7051	326
16c6fa80	327	extern char *map_dev(int major, int minor, int create);
64c4757e NB	328
64c4757e NB	329
f9ce90ba	330	extern struct superswitch {
3da92f27 NB	331	void (examine_super)(struct supertype st, char *homehost);
	332	void (brief_examine_super)(struct supertype st);
	333	void (detail_super)(struct supertype st, char *homehost);
	334	void (export_super)(struct supertype st);
	335	void (brief_detail_super)(struct supertype st);
	336	void (uuid_from_super)(struct supertype st, int uuid[4]);
	337	void (getinfo_super)(struct supertype st, struct mdinfo *info);
	338	int (match_home)(struct supertype st, char *homehost);
68c7d6d7	339	int (update_super)(struct supertype st, struct mdinfo *info,
3da92f27	340	char *update,
e5eac01f NB	341	char *devname, int verbose,
e5eac01f NB	342	int uuid_set, char *homehost);
3da92f27 NB	343	int (init_super)(struct supertype st, mdu_array_info_t *info,
	344	unsigned long long size, char *name,
	345	char homehost, int uuid);
	346	void (add_to_super)(struct supertype st, mdu_disk_info_t *dinfo);
	347	int (store_super)(struct supertype st, int fd);
	348	int (write_init_super)(struct supertype st, mdu_disk_info_t *dinfo,
	349	char *devname);
64557c33	350	int (compare_super)(struct supertype st, struct supertype *tst);
3da92f27	351	int (load_super)(struct supertype st, int fd, char *devname);
82d9eba6	352	struct supertype * (match_metadata_desc)(char arg);
1bf4e2d9	353	__u64 (avail_size)(struct supertype st, __u64 size);
3da92f27	354	int (add_internal_bitmap)(struct supertype st, int *chunkp,
199171a2	355	int delay, int write_behind,
f9c25f1d	356	unsigned long long size, int may_change, int major);
3da92f27 NB	357	void (locate_bitmap)(struct supertype st, int fd);
	358	int (write_bitmap)(struct supertype st, int fd);
	359	void (free_super)(struct supertype st);
82d9eba6	360	int major;
f277ce36	361	int swapuuid; /* true if uuid is bigending rather than hostendian */
82d9eba6 NB	362	} super0, super1, *superlist[];
	363
	364	struct supertype {
	365	struct superswitch *ss;
	366	int minor_version;
ea329559	367	int max_devs;
64557c33	368	void *sb;
82d9eba6	369	};
f9ce90ba	370
1686dc25	371	extern struct supertype *super_by_fd(int fd);
82d9eba6	372	extern struct supertype *guess_super(int fd);
3da92f27	373	extern struct supertype dup_super(struct supertype st);
beae1dfe	374	extern int get_dev_size(int fd, char dname, unsigned long long sizep);
8382f19b NB	375	extern void get_one_disk(int mdfd, mdu_array_info_t *ainf,
8382f19b NB	376	mdu_disk_info_t *disk);
f9ce90ba	377
838acbc2 NB	378	#if __GNUC__ < 3
	379	struct stat64;
	380	#endif
	381
45e878bb NB	382	#define HAVE_NFTW we assume
	383	#define HAVE_FTW
	384
173fc515	385	#ifdef UCLIBC
45e878bb NB	386	# include <features.h>
	387	# ifndef __UCLIBC_HAS_FTW__
	388	# undef HAVE_FTW
	389	# undef HAVE_NFTW
	390	# endif
	391	#endif
	392
	393	#ifdef __dietlibc__
	394	# undef HAVE_NFTW
	395	#endif
	396
e39b673e	397	#if defined(__KLIBC__)
	398	# undef HAVE_NFTW
	399	# undef HAVE_FTW
	400	#endif
	401
45e878bb	402	#ifndef HAVE_NFTW
173fc515	403	# define FTW_PHYS 1
45e878bb NB	404	# ifndef HAVE_FTW
45e878bb NB	405	struct FTW {};
173fc515 NB	406	# endif
	407	#endif
	408
45e878bb NB	409	#ifdef HAVE_FTW
	410	# include <ftw.h>
	411	#endif
	412
173fc515 NB	413	extern int add_dev(const char name, const struct stat stb, int flag, struct FTW *s);
173fc515 NB	414
f9ce90ba	415
64c4757e	416	extern int Manage_ro(char *devname, int fd, int readonly);
91f068bf	417	extern int Manage_runstop(char *devname, int fd, int runstop, int quiet);
dd0781e5	418	extern int Manage_resize(char *devname, int fd, long long size, int raid_disks);
b5e64645	419	extern int Manage_reconfig(char *devname, int fd, int layout);
64c4757e	420	extern int Manage_subdevs(char *devname, int fd,
dab6685f	421	mddev_dev_t devlist, int verbose);
1f48664b	422	extern int autodetect(void);
e5329c37	423	extern int Grow_Add_device(char devname, int fd, char newdev);
8fac0577	424	extern int Grow_addbitmap(char devname, int fd, char file, int chunk, int delay, int write_behind, int force);
06b0d786	425	extern int Grow_reshape(char devname, int fd, int quiet, char backup_file,
e86c9dd6 NB	426	long long size,
e86c9dd6 NB	427	int level, int layout, int chunksize, int raid_disks);
06b0d786 NB	428	extern int Grow_restart(struct supertype st, struct mdinfo info,
06b0d786 NB	429	int fdlist, int cnt, char backup_file);
64c4757e NB	430
64c4757e NB	431
82d9eba6	432	extern int Assemble(struct supertype st, char mddev, int mdfd,
52826846	433	mddev_ident_t ident,
06b0d786	434	mddev_dev_t devlist, char *backup_file,
64c4757e	435	int readonly, int runstop,
e5eac01f	436	char update, char homehost,
64c4757e NB	437	int verbose, int force);
64c4757e NB	438
b5e64645	439	extern int Build(char *mddev, int mdfd, int chunk, int level, int layout,
64c4757e	440	int raiddisks,
c82f047c	441	mddev_dev_t devlist, int assume_clean,
dab6685f	442	char *bitmap_file, int bitmap_chunk, int write_behind, int delay, int verbose);
64c4757e NB	443
64c4757e NB	444
82d9eba6	445	extern int Create(struct supertype st, char mddev, int mdfd,
5dd497ee	446	int chunk, int level, int layout, unsigned long long size, int raiddisks, int sparedisks,
3d3dd91e	447	char name, char homehost, int *uuid,
cd29a5c8	448	int subdevs, mddev_dev_t devlist,
47d79ef8	449	int runstop, int verbose, int force, int assume_clean,
dfd4d8ee	450	char *bitmap_file, int bitmap_chunk, int write_behind, int delay);
64c4757e	451
54bad364	452	extern int Detail(char dev, int brief, int export, int test, char homehost);
e0d19036	453	extern int Query(char *dev);
82d9eba6	454	extern int Examine(mddev_dev_t devlist, int brief, int scan, int SparcAdjust,
a1cbd7d0	455	struct supertype forcest, char homehost);
cd29a5c8	456	extern int Monitor(mddev_dev_t devlist,
e0d19036	457	char mailaddr, char alert_cmd,
aa88f531	458	int period, int daemonise, int scan, int oneshot,
8aec876d	459	int dosyslog, int test, char *pidfile);
64c4757e	460
6409687b	461	extern int Kill(char *dev, int force, int quiet);
b90c0e9a	462	extern int Wait(char *dev);
9a9dab36	463
8382f19b NB	464	extern int Incremental(char *devname, int verbose, int runstop,
	465	struct supertype st, char homehost, int autof);
	466	extern void RebuildMap(void);
	467	extern int IncrementalScan(int verbose);
	468
c82f047c NB	469	extern int CreateBitmap(char *filename, int force, char uuid[16],
c82f047c NB	470	unsigned long chunksize, unsigned long daemon_sleep,
dfd4d8ee	471	unsigned long write_behind,
dcec9ee5 NB	472	unsigned long long array_size,
dcec9ee5 NB	473	int major);
55935d51	474	extern int ExamineBitmap(char filename, int brief, struct supertype st);
bf4fb153	475	extern int bitmap_update_uuid(int fd, int *uuid, int swap);
c82f047c	476
64c4757e	477	extern int md_get_version(int fd);
e0d19036	478	extern int get_linux_version(void);
64c4757e	479	extern int parse_uuid(char *str, int uuid[4]);
682c7051 NB	480	extern int check_ext2(int fd, char *name);
	481	extern int check_reiser(int fd, char *name);
	482	extern int check_raid(int fd, char *name);
64c4757e	483
dd0781e5	484	extern int get_mdp_major(void);
8b0dabea	485	extern int dev_open(char *dev, int flags);
8d80900b	486	extern int is_standard(char dev, int nump);
dd0781e5	487
f1ae21c4	488	extern int parse_auto(char str, char msg, int config);
8aec876d NB	489	extern mddev_ident_t conf_get_ident(char *dev);
8aec876d NB	490	extern mddev_dev_t conf_get_devs(void);
8382f19b	491	extern int conf_test_dev(char *devname);
8aec876d NB	492	extern struct createinfo *conf_get_create_info(void);
	493	extern void set_conffile(char *file);
	494	extern char *conf_get_mailaddr(void);
	495	extern char *conf_get_mailfrom(void);
	496	extern char *conf_get_program(void);
	497	extern char *conf_get_homehost(void);
e0d19036	498	extern char conf_line(FILE file);
98c6faba	499	extern char conf_word(FILE file, int allow_key);
e0d19036 NB	500	extern void free_line(char *line);
e0d19036 NB	501	extern int match_oneof(char devices, char devname);
e0d19036	502	extern void uuid_from_super(int uuid[4], mdp_super_t *super);
f277ce36	503	extern int same_uuid(int a[4], int b[4], int swapuuid);
350f29f9	504	extern void copy_uuid(void *a, int b[4], int swapuuid);
4b1ac34b	505	extern unsigned long calc_csum(void *super, int bytes);
583315d9	506	extern int enough(int level, int raid_disks, int layout, int clean,
265e0f17	507	char *avail, int avail_disks);
e0d19036	508	extern int ask(char *mesg);
8fac0577	509	extern unsigned long long get_component_size(int fd);
0430ed48	510	extern void remove_partitions(int fd);
e0d19036	511
cd29a5c8	512
56eb10c0	513	extern char *human_size(long long bytes);
e0d19036 NB	514	char *human_size_brief(long long bytes);
	515
	516	extern void put_md_name(char *name);
	517	extern char *get_md_name(int dev);
	518
c913b90e	519	extern char DefaultConfFile[];
b5e64645 NB	520
b5e64645 NB	521	extern int open_mddev(char *dev, int autof);
8382f19b NB	522	extern int open_mddev_devnum(char devname, int devnum, char name,
8382f19b NB	523	char *chosen_name);
b5e64645 NB	524
	525
	526	#define LEVEL_MULTIPATH (-4)
	527	#define LEVEL_LINEAR (-1)
	528	#define LEVEL_FAULTY (-5)
	529
	530
	531	/* faulty stuff */
	532
	533	#define WriteTransient 0
	534	#define ReadTransient 1
	535	#define WritePersistent 2
	536	#define ReadPersistent 3
	537	#define WriteAll 4 /* doesn't go to device */
	538	#define ReadFixable 5
	539	#define Modes 6
	540
	541	#define ClearErrors 31
	542	#define ClearFaults 30
	543
	544	#define AllPersist 100 /* internal use only */
	545	#define NoPersist 101
	546
	547	#define ModeMask 0x1f
	548	#define ModeShift 5
fe6729fa NB	549
	550
	551	#ifdef __TINYC__
	552	#undef minor
	553	#undef major
	554	#undef makedev
	555	#define minor(x) ((x)&0xff)
	556	#define major(x) (((x)>>8)&0xff)
	557	#define makedev(M,m) (((M)<<8) \| (m))
	558	#endif
	559
e86c9dd6 NB	560	/* for raid5 */
	561	#define ALGORITHM_LEFT_ASYMMETRIC 0
	562	#define ALGORITHM_RIGHT_ASYMMETRIC 1
	563	#define ALGORITHM_LEFT_SYMMETRIC 2
	564	#define ALGORITHM_RIGHT_SYMMETRIC 3