xref: /freebsd/usr.sbin/mptutil/mpt_drive.c (revision 95ee2897e98f5d444f26ed2334cc7c439f9c16c6)
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