]> git.ipfire.org Git - thirdparty/mdadm.git/blame - Detail.c
Clarify when update=super-minor happens automatcially
[thirdparty/mdadm.git] / Detail.c
CommitLineData
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
9a9dab36 30#include "mdadm.h"
64c4757e
NB
31#include "md_p.h"
32#include "md_u.h"
33
b6750aa8 34int Detail(char *dev, int brief, int test, char *homehost)
64c4757e
NB
35{
36 /*
37 * Print out details for an md array by using
38 * GET_ARRAY_INFO and GET_DISK_INFO ioctl calls
39 */
40
41 int fd = open(dev, O_RDONLY, 0);
42 int vers;
43 mdu_array_info_t array;
b0c63f32
NB
44 mdu_disk_info_t *disks;
45 int next;
64c4757e
NB
46 int d;
47 time_t atime;
682c7051 48 char *c;
d013a55e 49 char *devices = NULL;
feb716e9 50 int spares = 0;
dd0781e5 51 struct stat stb;
e5329c37
NB
52 int is_26 = get_linux_version() >= 2006000;
53 int is_rebuilding = 0;
54 int failed = 0;
82d9eba6 55 struct supertype *st = NULL;
e27d562b 56 int max_disks = MD_SB_DISKS; /* just a default */
bed256c2 57 struct mdinfo info;
64c4757e 58
4b1ac34b 59 void *super = NULL;
feb716e9 60 int rv = test ? 4 : 1;
82b27616 61
64c4757e 62 if (fd < 0) {
682c7051 63 fprintf(stderr, Name ": cannot open %s: %s\n",
64c4757e 64 dev, strerror(errno));
feb716e9 65 return rv;
64c4757e
NB
66 }
67 vers = md_get_version(fd);
68 if (vers < 0) {
682c7051 69 fprintf(stderr, Name ": %s does not appear to be an md device\n",
64c4757e
NB
70 dev);
71 close(fd);
feb716e9 72 return rv;
64c4757e 73 }
682c7051
NB
74 if (vers < 9000) {
75 fprintf(stderr, Name ": cannot get detail for md device %s: driver version too old.\n",
64c4757e
NB
76 dev);
77 close(fd);
feb716e9 78 return rv;
64c4757e
NB
79 }
80 if (ioctl(fd, GET_ARRAY_INFO, &array)<0) {
81 if (errno == ENODEV)
682c7051 82 fprintf(stderr, Name ": md device %s does not appear to be active.\n",
64c4757e
NB
83 dev);
84 else
682c7051 85 fprintf(stderr, Name ": cannot get array detail for %s: %s\n",
64c4757e
NB
86 dev, strerror(errno));
87 close(fd);
feb716e9 88 return rv;
64c4757e 89 }
82d9eba6 90 st = super_by_version(array.major_version, array.minor_version);
f9ce90ba 91
dd0781e5
NB
92 if (fstat(fd, &stb) != 0 && !S_ISBLK(stb.st_mode))
93 stb.st_rdev = 0;
feb716e9 94 rv = 0;
e5329c37 95
ea329559
NB
96 if (st) max_disks = st->max_devs;
97
e5329c37 98 /* try to load a superblock */
ea329559 99 for (d= 0; d<max_disks; d++) {
e5329c37
NB
100 mdu_disk_info_t disk;
101 char *dv;
102 disk.number = d;
103 if (ioctl(fd, GET_DISK_INFO, &disk) < 0)
104 continue;
105 if (d >= array.raid_disks &&
106 disk.major == 0 &&
107 disk.minor == 0)
108 continue;
16c6fa80 109 if ((dv=map_dev(disk.major, disk.minor, 1))) {
4b1ac34b 110 if (!super && (disk.state & (1<<MD_DISK_ACTIVE))) {
e5329c37
NB
111 /* try to read the superblock from this device
112 * to get more info
113 */
16c6fa80 114 int fd2 = dev_open(dv, O_RDONLY);
82d9eba6
NB
115 if (fd2 >=0 && st &&
116 st->ss->load_super(st, fd2, &super, NULL) == 0) {
31317663 117 st->ss->getinfo_super(&info, super);
4b1ac34b
NB
118 if (info.array.ctime != array.ctime ||
119 info.array.level != array.level) {
120 free(super);
121 super = NULL;
122 }
123 }
e5329c37
NB
124 if (fd2 >= 0) close(fd2);
125 }
126 }
127 }
128
64c4757e 129 /* Ok, we have some info to print... */
682c7051 130 c = map_num(pers, array.level);
cd29a5c8 131 if (brief)
b83d95f3 132 printf("ARRAY %s level=%s num-devices=%d", dev, c?c:"-unknown-",array.raid_disks );
cd29a5c8 133 else {
8fac0577 134 mdu_bitmap_file_t bmf;
e0d19036
NB
135 unsigned long array_size;
136 unsigned long long larray_size;
22a88995 137 struct mdstat_ent *ms = mdstat_read(0, 0);
dd0781e5
NB
138 struct mdstat_ent *e;
139 int devnum = array.md_minor;
0df46c2a 140 if (major(stb.st_rdev) != MD_MAJOR)
dd0781e5
NB
141 devnum = -1 - devnum;
142
143 for (e=ms; e; e=e->next)
144 if (e->devnum == devnum)
145 break;
11a3e71d 146#ifdef BLKGETSIZE64
56eb10c0
NB
147 if (ioctl(fd, BLKGETSIZE64, &larray_size)==0)
148 ;
11a3e71d
NB
149 else
150#endif
b83d95f3
NB
151 if (ioctl(fd, BLKGETSIZE, &array_size)==0) {
152 larray_size = array_size;
153 larray_size <<= 9;
154 }
155
56eb10c0
NB
156 else larray_size = 0;
157
cd29a5c8
NB
158 printf("%s:\n", dev);
159 printf(" Version : %02d.%02d.%02d\n",
160 array.major_version, array.minor_version, array.patch_version);
161 atime = array.ctime;
162 printf(" Creation Time : %.24s\n", ctime(&atime));
163 printf(" Raid Level : %s\n", c?c:"-unknown-");
56eb10c0 164 if (larray_size)
dd0781e5 165 printf(" Array Size : %llu%s\n", (larray_size>>10), human_size(larray_size));
3d4064cc
NB
166 if (array.level >= 1) {
167 if (array.major_version != 0 &&
6ee5c05a
NB
168 (larray_size >= 0xFFFFFFFFULL|| array.size == 0)) {
169 unsigned long long dsize = get_component_size(fd);
170 if (dsize > 0)
171 printf(" Device Size : %llu%s\n", dsize, human_size((long long)array.size<<10));
172 else
173 printf(" Device Size : unknown\n");
174 } else
3d4064cc
NB
175 printf(" Device Size : %d%s\n", array.size, human_size((long long)array.size<<10));
176 }
b83d95f3
NB
177 printf(" Raid Devices : %d\n", array.raid_disks);
178 printf(" Total Devices : %d\n", array.nr_disks);
cd29a5c8 179 printf("Preferred Minor : %d\n", array.md_minor);
b83d95f3 180 printf(" Persistence : Superblock is %spersistent\n",
cd29a5c8
NB
181 array.not_persistent?"not ":"");
182 printf("\n");
4027ddca
NB
183 /* Only try GET_BITMAP_FILE for 0.90.01 and later */
184 if (vers >= 9001 &&
185 ioctl(fd, GET_BITMAP_FILE, &bmf) == 0 &&
186 bmf.pathname[0]) {
8fac0577
NB
187 printf(" Intent Bitmap : %s\n", bmf.pathname);
188 printf("\n");
189 } else if (array.state & (1<<MD_SB_BITMAP_PRESENT))
190 printf(" Intent Bitmap : Internal\n\n");
cd29a5c8
NB
191 atime = array.utime;
192 printf(" Update Time : %.24s\n", ctime(&atime));
120230a4 193 printf(" State : %s%s%s%s\n",
182661f4 194 (array.state&(1<<MD_SB_CLEAN))?"clean":"active",
dd0781e5 195 array.active_disks < array.raid_disks? ", degraded":"",
e5329c37 196 (!e || e->percent < 0) ? "" :
120230a4
NB
197 (e->resync) ? ", resyncing": ", recovering",
198 larray_size ? "": ", Not Started");
b83d95f3
NB
199 printf(" Active Devices : %d\n", array.active_disks);
200 printf("Working Devices : %d\n", array.working_disks);
201 printf(" Failed Devices : %d\n", array.failed_disks);
202 printf(" Spare Devices : %d\n", array.spare_disks);
cd29a5c8
NB
203 printf("\n");
204 if (array.level == 5) {
205 c = map_num(r5layout, array.layout);
206 printf(" Layout : %s\n", c?c:"-unknown-");
207 }
e5329c37 208 if (array.level == 10) {
b578481c
NB
209 printf(" Layout : near=%d, %s=%d\n",
210 array.layout&255, (array.layout&0x10000)?"offset":"far",
211 (array.layout>>8)&255);
e5329c37 212 }
cd29a5c8
NB
213 switch (array.level) {
214 case 0:
215 case 4:
216 case 5:
e5329c37
NB
217 case 10:
218 case 6:
219 printf(" Chunk Size : %dK\n\n", array.chunk_size/1024);
cd29a5c8
NB
220 break;
221 case -1:
e5329c37 222 printf(" Rounding : %dK\n\n", array.chunk_size/1024);
cd29a5c8
NB
223 break;
224 default: break;
225 }
82b27616 226
e5329c37 227 if (e && e->percent >= 0) {
bed256c2
NB
228 printf(" Re%s Status : %d%% complete\n",
229 (super && info.reshape_active)? "shape":"build",
230 e->percent);
e5329c37
NB
231 is_rebuilding = 1;
232 }
dd0781e5
NB
233 free_mdstat(ms);
234
bed256c2
NB
235 if (super && info.reshape_active) {
236#if 0
237This is pretty boring
238 printf(" Reshape pos'n : %llu%s\n", (unsigned long long) info.reshape_progress<<9,
239 human_size(info.reshape_progress<<9));
240#endif
241 if (info.delta_disks > 0)
242 printf(" Delta Devices : %d, (%d->%d)\n",
243 info.delta_disks, array.raid_disks - info.delta_disks, array.raid_disks);
244 if (info.delta_disks < 0)
245 printf(" Delta Devices : %d, (%d->%d)\n",
246 info.delta_disks, array.raid_disks, array.raid_disks + info.delta_disks);
247 if (info.new_level != array.level) {
248 char *c = map_num(pers, info.new_level);
249 printf(" New Level : %s\n", c?c:"-unknown-");
250 }
251 if (info.new_level != array.level ||
252 info.new_layout != array.layout) {
253 if (info.new_level == 5) {
254 char *c = map_num(r5layout, info.new_layout);
255 printf(" New Layout : %s\n",
256 c?c:"-unknown-");
257 }
258 if (info.new_level == 10) {
b578481c 259 printf(" New Layout : near=%d, %s=%d\n",
bed256c2 260 info.new_layout&255,
b578481c 261 (info.new_layout&0x10000)?"offset":"far",
bed256c2
NB
262 (info.new_layout>>8)&255);
263 }
264 }
265 if (info.new_chunk != array.chunk_size)
266 printf(" New Chunksize : %dK\n", info.new_chunk/1024);
267 printf("\n");
268 } else if (e && e->percent >= 0)
269 printf("\n");
82d9eba6 270 if (super && st)
b6750aa8 271 st->ss->detail_super(super, homehost);
e5329c37 272
b83d95f3 273 printf(" Number Major Minor RaidDevice State\n");
cd29a5c8 274 }
b0c63f32
NB
275 disks = malloc(max_disks * sizeof(mdu_disk_info_t));
276 for (d=0; d<max_disks; d++) {
277 disks[d].state = (1<<MD_DISK_REMOVED);
278 disks[d].major = disks[d].minor = 0;
8352ab3e 279 disks[d].number = disks[d].raid_disk = d;
b0c63f32
NB
280 }
281
282 next = array.raid_disks;
283 for (d=0; d < max_disks; d++) {
64c4757e
NB
284 mdu_disk_info_t disk;
285 disk.number = d;
286 if (ioctl(fd, GET_DISK_INFO, &disk) < 0) {
e0d19036 287 if (d < array.raid_disks)
b83d95f3 288 fprintf(stderr, Name ": cannot get device detail for device %d: %s\n",
e0d19036 289 d, strerror(errno));
64c4757e
NB
290 continue;
291 }
67687afe
NB
292 if (disk.major == 0 && disk.minor == 0)
293 continue;
b0c63f32
NB
294 if (disk.raid_disk >= 0 && disk.raid_disk < array.raid_disks)
295 disks[disk.raid_disk] = disk;
296 else if (next < max_disks)
297 disks[next++] = disk;
298 }
299
300 for (d= 0; d < max_disks; d++) {
301 char *dv;
302 mdu_disk_info_t disk = disks[d];
303
e0d19036
NB
304 if (d >= array.raid_disks &&
305 disk.major == 0 &&
306 disk.minor == 0)
307 continue;
cd29a5c8 308 if (!brief) {
b0c63f32 309 if (d == array.raid_disks) printf("\n");
e5329c37
NB
310 if (disk.raid_disk < 0)
311 printf(" %5d %5d %5d - ",
312 disk.number, disk.major, disk.minor);
313 else
314 printf(" %5d %5d %5d %5d ",
315 disk.number, disk.major, disk.minor, disk.raid_disk);
316 if (disk.state & (1<<MD_DISK_FAULTY)) {
317 printf(" faulty");
318 if (disk.raid_disk < array.raid_disks &&
319 disk.raid_disk >= 0)
320 failed++;
321 }
cd29a5c8
NB
322 if (disk.state & (1<<MD_DISK_ACTIVE)) printf(" active");
323 if (disk.state & (1<<MD_DISK_SYNC)) printf(" sync");
324 if (disk.state & (1<<MD_DISK_REMOVED)) printf(" removed");
b0c63f32
NB
325 if (disk.state & (1<<MD_DISK_WRITEMOSTLY)) printf(" writemostly");
326 if ((disk.state &
327 ((1<<MD_DISK_ACTIVE)|(1<<MD_DISK_SYNC)|(1<<MD_DISK_REMOVED)))
328 == 0) {
329 printf(" spare");
e5329c37
NB
330 if (is_26) {
331 if (disk.raid_disk < array.raid_disks && disk.raid_disk >= 0)
332 printf(" rebuilding");
333 } else if (is_rebuilding && failed) {
334 /* Taking a bit of a risk here, we remove the
335 * device from the array, and then put it back.
336 * If this fails, we are rebuilding
337 */
0df46c2a
NB
338 int err = ioctl(fd, HOT_REMOVE_DISK, makedev(disk.major, disk.minor));
339 if (err == 0) ioctl(fd, HOT_ADD_DISK, makedev(disk.major, disk.minor));
e5329c37
NB
340 if (err && errno == EBUSY)
341 printf(" rebuilding");
342 }
343 }
feb716e9 344 }
e5329c37 345 if (disk.state == 0) spares++;
feb716e9
NB
346 if (test && d < array.raid_disks && disk.state & (1<<MD_DISK_FAULTY)) {
347 if ((rv & 1) && (array.level ==4 || array.level == 5))
348 rv |= 2;
349 rv |= 1;
cd29a5c8 350 }
16c6fa80 351 if ((dv=map_dev(disk.major, disk.minor, 0))) {
d013a55e
NB
352 if (brief) {
353 if (devices) {
354 devices = realloc(devices,
355 strlen(devices)+1+strlen(dv)+1);
356 strcat(strcat(devices,","),dv);
357 } else
358 devices = strdup(dv);
359 } else
360 printf(" %s", dv);
82b27616 361 }
cd29a5c8 362 if (!brief) printf("\n");
64c4757e 363 }
feb716e9 364 if (spares && brief) printf(" spares=%d", spares);
82d9eba6
NB
365 if (super && brief && st)
366 st->ss->brief_detail_super(super);
4b1ac34b 367
22892d56 368 if (brief > 1 && devices) printf("\n devices=%s", devices);
cd29a5c8 369 if (brief) printf("\n");
feb716e9 370 if (test && (rv&2)) rv &= ~1;
e5329c37 371 close(fd);
feb716e9 372 return rv;
64c4757e 373}