mdadm-1.5.0
[thirdparty/mdadm.git] / mdadm.h
CommitLineData
64c4757e 1/*
9a9dab36 2 * mdadm - manage Linux "md" devices aka RAID arrays.
64c4757e 3 *
cd29a5c8 4 * Copyright (C) 2001-2002 Neil Brown <neilb@cse.unsw.edu.au>
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
30#define __USE_LARGEFILE64
31#include <unistd.h>
98c6faba 32#ifndef __dietlibc__
64c4757e 33extern __off64_t lseek64 __P ((int __fd, __off64_t __offset, int __whence));
98c6faba 34#endif
64c4757e
NB
35
36#include <sys/types.h>
37#include <sys/stat.h>
38#include <stdlib.h>
39#include <time.h>
40#include <getopt.h>
41#include <fcntl.h>
42#include <stdio.h>
43#include <errno.h>
44#include <string.h>
98c6faba
NB
45#ifdef __dietlibc__NONO
46int strncmp(const char *s1, const char *s2, size_t n) __THROW __pure__;
47char *strncpy(char *dest, const char *src, size_t n) __THROW;
48#include <strings.h>
49#endif
50
64c4757e
NB
51
52#include <linux/kdev_t.h>
e0d19036
NB
53/*#include <linux/fs.h> */
54#include <sys/mount.h>
55#include <asm/types.h>
64c4757e
NB
56#include <sys/ioctl.h>
57#define MD_MAJOR 9
58
e0d19036 59#ifndef BLKGETSIZE64
98c6faba 60#define BLKGETSIZE64 _IOR(0x12,114,size_t) /* return device size in bytes (u64 *arg) */
e0d19036 61#endif
56eb10c0 62
64c4757e
NB
63
64#include "md_u.h"
e0d19036 65#include "md_p.h"
64c4757e 66
9a9dab36 67#define Name "mdadm"
682c7051 68
e0d19036
NB
69enum mode {
70 ASSEMBLE=1,
71 BUILD,
72 CREATE,
73 MANAGE,
74 MISC,
75 MONITOR,
76};
77
64c4757e
NB
78extern char short_options[];
79extern struct option long_options[];
56eedc1a 80extern char Version[], Usage[], Help[], OptionHelp[],
e0d19036
NB
81 Help_create[], Help_build[], Help_assemble[],
82 Help_manage[], Help_misc[], Help_monitor[], Help_config[];
64c4757e
NB
83
84/* structures read from config file */
52826846
NB
85/* List of mddevice names and identifiers
86 * Identifiers can be:
87 * uuid=128-hex-uuid
88 * super-minor=decimal-minor-number-from-superblock
89 * devices=comma,separated,list,of,device,names,with,wildcards
90 *
91 * If multiple fields are present, the intersection of all matching
92 * devices is considered
93 */
98c6faba 94#define UnSet (0xfffe)
52826846 95typedef struct mddev_ident_s {
64c4757e 96 char *devname;
52826846
NB
97
98 int uuid_set;
64c4757e 99 __u32 uuid[4];
52826846 100
98c6faba 101 unsigned int super_minor;
52826846
NB
102
103 char *devices; /* comma separated list of device
104 * names with wild cards
105 */
98c6faba
NB
106 int level;
107 unsigned int raid_disks;
108 unsigned int spare_disks;
52826846
NB
109 char *spare_group;
110 struct mddev_ident_s *next;
111} *mddev_ident_t;
64c4757e
NB
112
113/* List of device names - wildcards expanded */
114typedef struct mddev_dev_s {
115 char *devname;
cd29a5c8
NB
116 char disposition; /* 'a' for add, 'r' for remove, 'f' for fail.
117 * Not set for names read from .config
118 */
64c4757e
NB
119 struct mddev_dev_s *next;
120} *mddev_dev_t;
121
682c7051
NB
122typedef struct mapping {
123 char *name;
124 int num;
125} mapping_t;
126
e0d19036
NB
127
128struct mdstat_ent {
129 char *dev;
130 int devnum;
131 int active;
132 char *level;
133 char *pattern; /* U or up, _ for down */
134 int percent; /* -1 if no resync */
135 struct mdstat_ent *next;
136};
137
138extern struct mdstat_ent *mdstat_read(void);
139extern void free_mdstat(struct mdstat_ent *ms);
140
52826846
NB
141#ifndef Sendmail
142#define Sendmail "/usr/lib/sendmail -t"
143#endif
144
682c7051
NB
145extern char *map_num(mapping_t *map, int num);
146extern int map_name(mapping_t *map, char *name);
e0d19036 147extern mapping_t r5layout[], pers[], modes[];
682c7051 148
82b27616 149extern char *map_dev(int major, int minor);
64c4757e
NB
150
151
152extern int Manage_ro(char *devname, int fd, int readonly);
153extern int Manage_runstop(char *devname, int fd, int runstop);
154extern int Manage_subdevs(char *devname, int fd,
cd29a5c8 155 mddev_dev_t devlist);
64c4757e
NB
156
157
158extern int Assemble(char *mddev, int mdfd,
52826846
NB
159 mddev_ident_t ident,
160 char *conffile,
cd29a5c8 161 mddev_dev_t devlist,
64c4757e 162 int readonly, int runstop,
5787fa49 163 char *update,
64c4757e
NB
164 int verbose, int force);
165
166extern int Build(char *mddev, int mdfd, int chunk, int level,
167 int raiddisks,
cd29a5c8 168 mddev_dev_t devlist);
64c4757e
NB
169
170
171extern int Create(char *mddev, int mdfd,
aa88f531 172 int chunk, int level, int layout, unsigned long size, int raiddisks, int sparedisks,
cd29a5c8 173 int subdevs, mddev_dev_t devlist,
52826846 174 int runstop, int verbose, int force);
64c4757e 175
feb716e9 176extern int Detail(char *dev, int brief, int test);
e0d19036 177extern int Query(char *dev);
bd526cee 178extern int Examine(mddev_dev_t devlist, int brief, int scan, int SparcAdjust);
cd29a5c8 179extern int Monitor(mddev_dev_t devlist,
e0d19036 180 char *mailaddr, char *alert_cmd,
aa88f531 181 int period, int daemonise, int scan, int oneshot,
98c6faba 182 char *config, int test);
64c4757e 183
9a9dab36
NB
184extern int Kill(char *dev, int force);
185
64c4757e 186extern int md_get_version(int fd);
e0d19036 187extern int get_linux_version(void);
64c4757e 188extern int parse_uuid(char *str, int uuid[4]);
682c7051
NB
189extern int check_ext2(int fd, char *name);
190extern int check_reiser(int fd, char *name);
191extern int check_raid(int fd, char *name);
64c4757e 192
e0d19036
NB
193extern mddev_ident_t conf_get_ident(char *conffile, char *dev);
194extern mddev_dev_t conf_get_devs(char *conffile);
195extern char *conf_get_mailaddr(char *conffile);
196extern char *conf_get_program(char *conffile);
197extern char *conf_line(FILE *file);
98c6faba 198extern char *conf_word(FILE *file, int allow_key);
e0d19036
NB
199extern void free_line(char *line);
200extern int match_oneof(char *devices, char *devname);
201extern int load_super(int fd, mdp_super_t *super);
202extern void uuid_from_super(int uuid[4], mdp_super_t *super);
203extern int same_uuid(int a[4], int b[4]);
204extern int compare_super(mdp_super_t *first, mdp_super_t *second);
98c6faba 205extern unsigned long calc_sb_csum(mdp_super_t *super);
e0d19036
NB
206extern int store_super(int fd, mdp_super_t *super);
207extern int enough(int level, int raid_disks, int avail_disks);
208extern int ask(char *mesg);
209
cd29a5c8 210
56eb10c0 211extern char *human_size(long long bytes);
e0d19036
NB
212char *human_size_brief(long long bytes);
213
214extern void put_md_name(char *name);
215extern char *get_md_name(int dev);
216
c913b90e 217extern char DefaultConfFile[];