Super User's BSD Cross Reference: /FreeBSD/usr.sbin/mptutil/mpt_drive.c

1 /*-
2 * SPDX-License-Identifier: BSD-3-Clause
3 *
4 * Copyright (c) 2008 Yahoo!, Inc.
5 * All rights reserved.
6 * Written by: John Baldwin <jhb@FreeBSD.org>
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
10 * are met:
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
16 * 3. Neither the name of the author nor the names of any co-contributors
17 * may be used to endorse or promote products derived from this software
18 * without specific prior written permission.
19 *
20 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
21 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
24 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30 * SUCH DAMAGE.
31 */
32
33#include <sys/cdefs.h>
34 __RCSID("$FreeBSD$");
35
36#include <sys/param.h>
37#include <sys/errno.h>
38#include <ctype.h>
39#include <err.h>
40#include <libutil.h>
41#include <limits.h>
42#include <stdio.h>
43#include <stdlib.h>
44#include <string.h>
45#include <strings.h>
46#include <unistd.h>
47
48#include <camlib.h>
49#include <cam/scsi/scsi_all.h>
50
51#include "mptutil.h"
52
53 const char *
54 mpt_pdstate(CONFIG_PAGE_RAID_PHYS_DISK_0 *info)
55{
56 static char buf[16];
57
58 switch (info->PhysDiskStatus.State) {
59 case MPI_PHYSDISK0_STATUS_ONLINE:
60 if ((info->PhysDiskStatus.Flags &
61 MPI_PHYSDISK0_STATUS_FLAG_OUT_OF_SYNC) &&
62 info->PhysDiskSettings.HotSparePool == 0)
63 return ("REBUILD");
64 else
65 return ("ONLINE");
66 case MPI_PHYSDISK0_STATUS_MISSING:
67 return ("MISSING");
68 case MPI_PHYSDISK0_STATUS_NOT_COMPATIBLE:
69 return ("NOT COMPATIBLE");
70 case MPI_PHYSDISK0_STATUS_FAILED:
71 return ("FAILED");
72 case MPI_PHYSDISK0_STATUS_INITIALIZING:
73 return ("INITIALIZING");
74 case MPI_PHYSDISK0_STATUS_OFFLINE_REQUESTED:
75 return ("OFFLINE REQUESTED");
76 case MPI_PHYSDISK0_STATUS_FAILED_REQUESTED:
77 return ("FAILED REQUESTED");
78 case MPI_PHYSDISK0_STATUS_OTHER_OFFLINE:
79 return ("OTHER OFFLINE");
80 default:
81 sprintf(buf, "PSTATE 0x%02x", info->PhysDiskStatus.State);
82 return (buf);
83 }
84}
85
86 /*
87 * There are several ways to enumerate physical disks. Unfortunately,
88 * none of them are truly complete, so we have to build a union of all of
89 * them. Specifically:
90 *
91 * - IOC2 : This gives us a list of volumes, and by walking the volumes we
92 * can enumerate all of the drives attached to volumes including
93 * online drives and failed drives.
94 * - IOC3 : This gives us a list of all online physical drives including
95 * drives that are not part of a volume nor a spare drive. It
96 * does not include any failed drives.
97 * - IOC5 : This gives us a list of all spare drives including failed
98 * spares.
99 *
100 * The specific edge cases are that 1) a failed volume member can only be
101 * found via IOC2, 2) a drive that is neither a volume member nor a spare
102 * can only be found via IOC3, and 3) a failed spare can only be found via
103 * IOC5.
104 *
105 * To handle this, walk all of the three lists and use the following
106 * routine to add each drive encountered. It quietly succeeds if the
107 * drive is already present in the list. It also sorts the list as it
108 * inserts new drives.
109 */
110 static int
111 mpt_pd_insert(int fd, struct mpt_drive_list *list, U8 PhysDiskNum)
112{
113 int i, j;
114
115 /*
116 * First, do a simple linear search to see if we have already
117 * seen this drive.
118 */
119 for (i = 0; i < list->ndrives; i++) {
120 if (list->drives[i]->PhysDiskNum == PhysDiskNum)
121 return (0);
122 if (list->drives[i]->PhysDiskNum > PhysDiskNum)
123 break;
124 }
125
126 /*
127 * 'i' is our slot for the 'new' drive. Make room and then
128 * read the drive info.
129 */
130 for (j = list->ndrives - 1; j >= i; j--)
131 list->drives[j + 1] = list->drives[j];
132 list->drives[i] = mpt_pd_info(fd, PhysDiskNum, NULL);
133 if (list->drives[i] == NULL)
134 return (errno);
135 list->ndrives++;
136 return (0);
137}
138
139 struct mpt_drive_list *
140 mpt_pd_list(int fd)
141{
142 CONFIG_PAGE_IOC_2 *ioc2;
143 CONFIG_PAGE_IOC_2_RAID_VOL *vol;
144 CONFIG_PAGE_RAID_VOL_0 **volumes;
145 RAID_VOL0_PHYS_DISK *rdisk;
146 CONFIG_PAGE_IOC_3 *ioc3;
147 IOC_3_PHYS_DISK *disk;
148 CONFIG_PAGE_IOC_5 *ioc5;
149 IOC_5_HOT_SPARE *spare;
150 struct mpt_drive_list *list;
151 int count, error, i, j;
152 size_t listsize;
153
154 ioc2 = mpt_read_ioc_page(fd, 2, NULL);
155 if (ioc2 == NULL) {
156 error = errno;
157 warn("Failed to fetch volume list");
158 errno = error;
159 return (NULL);
160 }
161
162 ioc3 = mpt_read_ioc_page(fd, 3, NULL);
163 if (ioc3 == NULL) {
164 error = errno;
165 warn("Failed to fetch drive list");
166 free(ioc2);
167 errno = error;
168 return (NULL);
169 }
170
171 ioc5 = mpt_read_ioc_page(fd, 5, NULL);
172 if (ioc5 == NULL) {
173 error = errno;
174 warn("Failed to fetch spare list");
175 free(ioc3);
176 free(ioc2);
177 errno = error;
178 return (NULL);
179 }
180
181 /*
182 * Go ahead and read the info for all the volumes. For this
183 * pass we figure out how many physical drives there are.
184 */
185 volumes = malloc(sizeof(*volumes) * ioc2->NumActiveVolumes);
186 count = 0;
187 vol = ioc2->RaidVolume;
188 for (i = 0; i < ioc2->NumActiveVolumes; vol++, i++) {
189 volumes[i] = mpt_vol_info(fd, vol->VolumeBus, vol->VolumeID,
190 NULL);
191 if (volumes[i] == NULL) {
192 error = errno;
193 warn("Failed to read volume info");
194 errno = error;
195 free(volumes);
196 free(ioc5);
197 free(ioc3);
198 free(ioc2);
199 return (NULL);
200 }
201 count += volumes[i]->NumPhysDisks;
202 }
203 count += ioc3->NumPhysDisks;
204 count += ioc5->NumHotSpares;
205
206 /* Walk the various lists enumerating drives. */
207 listsize = sizeof(*list) + sizeof(CONFIG_PAGE_RAID_PHYS_DISK_0) * count;
208 list = calloc(1, listsize);
209
210 for (i = 0; i < ioc2->NumActiveVolumes; i++) {
211 rdisk = volumes[i]->PhysDisk;
212 for (j = 0; j < volumes[i]->NumPhysDisks; rdisk++, j++)
213 if (mpt_pd_insert(fd, list, rdisk->PhysDiskNum) < 0) {
214 mpt_free_pd_list(list);
215 free(volumes);
216 free(ioc5);
217 free(ioc3);
218 free(ioc2);
219 return (NULL);
220 }
221 free(volumes[i]);
222 }
223 free(ioc2);
224 free(volumes);
225
226 spare = ioc5->HotSpare;
227 for (i = 0; i < ioc5->NumHotSpares; spare++, i++)
228 if (mpt_pd_insert(fd, list, spare->PhysDiskNum) < 0) {
229 mpt_free_pd_list(list);
230 free(ioc5);
231 free(ioc3);
232 return (NULL);
233 }
234 free(ioc5);
235
236 disk = ioc3->PhysDisk;
237 for (i = 0; i < ioc3->NumPhysDisks; disk++, i++)
238 if (mpt_pd_insert(fd, list, disk->PhysDiskNum) < 0) {
239 mpt_free_pd_list(list);
240 free(ioc3);
241 return (NULL);
242 }
243 free(ioc3);
244
245 return (list);
246}
247
248 void
249 mpt_free_pd_list(struct mpt_drive_list *list)
250{
251 int i;
252
253 for (i = 0; i < list->ndrives; i++)
254 free(list->drives[i]);
255 free(list);
256}
257
258 int
259 mpt_lookup_drive(struct mpt_drive_list *list, const char *drive,
260 U8 *PhysDiskNum)
261{
262 long val;
263 uint8_t bus, id;
264 char *cp;
265
266 /* Look for a raw device id first. */
267 val = strtol(drive, &cp, 0);
268 if (*cp == '0円') {
269 if (val < 0 || val > 0xff)
270 goto bad;
271 *PhysDiskNum = val;
272 return (0);
273 }
274
275 /* Look for a <bus>:<id> string. */
276 if (*cp == ':') {
277 if (val < 0 || val > 0xff)
278 goto bad;
279 bus = val;
280 val = strtol(cp + 1, &cp, 0);
281 if (*cp != '0円')
282 goto bad;
283 if (val < 0 || val > 0xff)
284 goto bad;
285 id = val;
286
287 for (val = 0; val < list->ndrives; val++) {
288 if (list->drives[val]->PhysDiskBus == bus &&
289 list->drives[val]->PhysDiskID == id) {
290 *PhysDiskNum = list->drives[val]->PhysDiskNum;
291 return (0);
292 }
293 }
294 return (ENOENT);
295 }
296
297 bad:
298 return (EINVAL);
299}
300
301 /* Borrowed heavily from scsi_all.c:scsi_print_inquiry(). */
302 const char *
303 mpt_pd_inq_string(CONFIG_PAGE_RAID_PHYS_DISK_0 *pd_info)
304{
305 RAID_PHYS_DISK0_INQUIRY_DATA *inq_data;
306 u_char vendor[9], product[17], revision[5];
307 static char inq_string[64];
308
309 inq_data = &pd_info->InquiryData;
310 cam_strvis(vendor, inq_data->VendorID, sizeof(inq_data->VendorID),
311 sizeof(vendor));
312 cam_strvis(product, inq_data->ProductID, sizeof(inq_data->ProductID),
313 sizeof(product));
314 cam_strvis(revision, inq_data->ProductRevLevel,
315 sizeof(inq_data->ProductRevLevel), sizeof(revision));
316
317 /* Total hack. */
318 if (strcmp(vendor, "ATA") == 0)
319 snprintf(inq_string, sizeof(inq_string), "<%s %s> SATA",
320 product, revision);
321 else
322 snprintf(inq_string, sizeof(inq_string), "<%s %s %s> SAS",
323 vendor, product, revision);
324 return (inq_string);
325}
326
327 /* Helper function to set a drive to a given state. */
328 static int
329 drive_set_state(char *drive, U8 Action, U8 State, const char *name)
330{
331 CONFIG_PAGE_RAID_PHYS_DISK_0 *info;
332 struct mpt_drive_list *list;
333 U8 PhysDiskNum;
334 int error, fd;
335
336 fd = mpt_open(mpt_unit);
337 if (fd < 0) {
338 error = errno;
339 warn("mpt_open");
340 return (error);
341 }
342
343 list = mpt_pd_list(fd);
344 if (list == NULL) {
345 close(fd);
346 return (errno);
347 }
348
349 if (mpt_lookup_drive(list, drive, &PhysDiskNum) < 0) {
350 error = errno;
351 warn("Failed to find drive %s", drive);
352 close(fd);
353 return (error);
354 }
355 mpt_free_pd_list(list);
356
357 /* Get the info for this drive. */
358 info = mpt_pd_info(fd, PhysDiskNum, NULL);
359 if (info == NULL) {
360 error = errno;
361 warn("Failed to fetch info for drive %u", PhysDiskNum);
362 close(fd);
363 return (error);
364 }
365
366 /* Try to change the state. */
367 if (info->PhysDiskStatus.State == State) {
368 warnx("Drive %u is already in the desired state", PhysDiskNum);
369 free(info);
370 close(fd);
371 return (EINVAL);
372 }
373
374 error = mpt_raid_action(fd, Action, 0, 0, PhysDiskNum, 0, NULL, 0, NULL,
375 NULL, 0, NULL, NULL, 0);
376 if (error) {
377 warnc(error, "Failed to set drive %u to %s", PhysDiskNum, name);
378 free(info);
379 close(fd);
380 return (error);
381 }
382
383 free(info);
384 close(fd);
385
386 return (0);
387}
388
389 static int
390 fail_drive(int ac, char **av)
391{
392
393 if (ac != 2) {
394 warnx("fail: %s", ac > 2 ? "extra arguments" :
395 "drive required");
396 return (EINVAL);
397 }
398
399 return (drive_set_state(av[1], MPI_RAID_ACTION_FAIL_PHYSDISK,
400 MPI_PHYSDISK0_STATUS_FAILED_REQUESTED, "FAILED"));
401}
402 MPT_COMMAND(top, fail, fail_drive);
403
404 static int
405 online_drive(int ac, char **av)
406{
407
408 if (ac != 2) {
409 warnx("online: %s", ac > 2 ? "extra arguments" :
410 "drive required");
411 return (EINVAL);
412 }
413
414 return (drive_set_state(av[1], MPI_RAID_ACTION_PHYSDISK_ONLINE,
415 MPI_PHYSDISK0_STATUS_ONLINE, "ONLINE"));
416}
417 MPT_COMMAND(top, online, online_drive);
418
419 static int
420 offline_drive(int ac, char **av)
421{
422
423 if (ac != 2) {
424 warnx("offline: %s", ac > 2 ? "extra arguments" :
425 "drive required");
426 return (EINVAL);
427 }
428
429 return (drive_set_state(av[1], MPI_RAID_ACTION_PHYSDISK_OFFLINE,
430 MPI_PHYSDISK0_STATUS_OFFLINE_REQUESTED, "OFFLINE"));
431}
432 MPT_COMMAND(top, offline, offline_drive);
433 

AltStyle によって変換されたページ (->オリジナル) /