xref: /illumos-gate/usr/src/cmd/zinject/zinject.c (revision cde58dbc6a23d4d38db7c8866312be83221c765f)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 /*
22  * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
23  */
24 
25 /*
26  * ZFS Fault Injector
27  *
28  * This userland component takes a set of options and uses libzpool to translate
29  * from a user-visible object type and name to an internal representation.
30  * There are two basic types of faults: device faults and data faults.
31  *
32  *
33  * DEVICE FAULTS
34  *
35  * Errors can be injected into a particular vdev using the '-d' option.  This
36  * option takes a path or vdev GUID to uniquely identify the device within a
37  * pool.  There are two types of errors that can be injected, EIO and ENXIO,
38  * that can be controlled through the '-e' option.  The default is ENXIO.  For
39  * EIO failures, any attempt to read data from the device will return EIO, but
40  * subsequent attempt to reopen the device will succeed.  For ENXIO failures,
41  * any attempt to read from the device will return EIO, but any attempt to
42  * reopen the device will also return ENXIO.
43  * For label faults, the -L option must be specified. This allows faults
44  * to be injected into either the nvlist, uberblock, pad1, or pad2 region
45  * of all the labels for the specified device.
46  *
47  * This form of the command looks like:
48  *
49  * 	zinject -d device [-e errno] [-L <uber | nvlist | pad1 | pad2>] pool
50  *
51  *
52  * DATA FAULTS
53  *
54  * We begin with a tuple of the form:
55  *
56  * 	<type,level,range,object>
57  *
58  * 	type	A string describing the type of data to target.  Each type
59  * 		implicitly describes how to interpret 'object'. Currently,
60  * 		the following values are supported:
61  *
62  * 		data		User data for a file
63  * 		dnode		Dnode for a file or directory
64  *
65  *		The following MOS objects are special.  Instead of injecting
66  *		errors on a particular object or blkid, we inject errors across
67  *		all objects of the given type.
68  *
69  * 		mos		Any data in the MOS
70  * 		mosdir		object directory
71  * 		config		pool configuration
72  * 		bpobj		blkptr list
73  * 		spacemap	spacemap
74  * 		metaslab	metaslab
75  * 		errlog		persistent error log
76  *
77  * 	level	Object level.  Defaults to '0', not applicable to all types.  If
78  * 		a range is given, this corresponds to the indirect block
79  * 		corresponding to the specific range.
80  *
81  *	range	A numerical range [start,end) within the object.  Defaults to
82  *		the full size of the file.
83  *
84  * 	object	A string describing the logical location of the object.  For
85  * 		files and directories (currently the only supported types),
86  * 		this is the path of the object on disk.
87  *
88  * This is translated, via libzpool, into the following internal representation:
89  *
90  * 	<type,objset,object,level,range>
91  *
92  * These types should be self-explanatory.  This tuple is then passed to the
93  * kernel via a special ioctl() to initiate fault injection for the given
94  * object.  Note that 'type' is not strictly necessary for fault injection, but
95  * is used when translating existing faults into a human-readable string.
96  *
97  *
98  * The command itself takes one of the forms:
99  *
100  * 	zinject
101  * 	zinject <-a | -u pool>
102  * 	zinject -c <id|all>
103  * 	zinject [-q] <-t type> [-f freq] [-u] [-a] [-m] [-e errno] [-l level]
104  *	    [-r range] <object>
105  * 	zinject [-f freq] [-a] [-m] [-u] -b objset:object:level:start:end pool
106  *
107  * With no arguments, the command prints all currently registered injection
108  * handlers, with their numeric identifiers.
109  *
110  * The '-c' option will clear the given handler, or all handlers if 'all' is
111  * specified.
112  *
113  * The '-e' option takes a string describing the errno to simulate.  This must
114  * be either 'io' or 'checksum'.  In most cases this will result in the same
115  * behavior, but RAID-Z will produce a different set of ereports for this
116  * situation.
117  *
118  * The '-a', '-u', and '-m' flags toggle internal flush behavior.  If '-a' is
119  * specified, then the ARC cache is flushed appropriately.  If '-u' is
120  * specified, then the underlying SPA is unloaded.  Either of these flags can be
121  * specified independently of any other handlers.  The '-m' flag automatically
122  * does an unmount and remount of the underlying dataset to aid in flushing the
123  * cache.
124  *
125  * The '-f' flag controls the frequency of errors injected, expressed as a
126  * integer percentage between 1 and 100.  The default is 100.
127  *
128  * The this form is responsible for actually injecting the handler into the
129  * framework.  It takes the arguments described above, translates them to the
130  * internal tuple using libzpool, and then issues an ioctl() to register the
131  * handler.
132  *
133  * The final form can target a specific bookmark, regardless of whether a
134  * human-readable interface has been designed.  It allows developers to specify
135  * a particular block by number.
136  */
137 
138 #include <errno.h>
139 #include <fcntl.h>
140 #include <stdio.h>
141 #include <stdlib.h>
142 #include <strings.h>
143 #include <unistd.h>
144 
145 #include <sys/fs/zfs.h>
146 #include <sys/mount.h>
147 
148 #include <libzfs.h>
149 
150 #undef verify	/* both libzfs.h and zfs_context.h want to define this */
151 
152 #include "zinject.h"
153 
154 libzfs_handle_t *g_zfs;
155 int zfs_fd;
156 
157 #define	ECKSUM	EBADE
158 
159 static const char *errtable[TYPE_INVAL] = {
160 	"data",
161 	"dnode",
162 	"mos",
163 	"mosdir",
164 	"metaslab",
165 	"config",
166 	"bpobj",
167 	"spacemap",
168 	"errlog",
169 	"uber",
170 	"nvlist",
171 	"pad1",
172 	"pad2"
173 };
174 
175 static err_type_t
176 name_to_type(const char *arg)
177 {
178 	int i;
179 	for (i = 0; i < TYPE_INVAL; i++)
180 		if (strcmp(errtable[i], arg) == 0)
181 			return (i);
182 
183 	return (TYPE_INVAL);
184 }
185 
186 static const char *
187 type_to_name(uint64_t type)
188 {
189 	switch (type) {
190 	case DMU_OT_OBJECT_DIRECTORY:
191 		return ("mosdir");
192 	case DMU_OT_OBJECT_ARRAY:
193 		return ("metaslab");
194 	case DMU_OT_PACKED_NVLIST:
195 		return ("config");
196 	case DMU_OT_BPOBJ:
197 		return ("bpobj");
198 	case DMU_OT_SPACE_MAP:
199 		return ("spacemap");
200 	case DMU_OT_ERROR_LOG:
201 		return ("errlog");
202 	default:
203 		return ("-");
204 	}
205 }
206 
207 
208 /*
209  * Print usage message.
210  */
211 void
212 usage(void)
213 {
214 	(void) printf(
215 	    "usage:\n"
216 	    "\n"
217 	    "\tzinject\n"
218 	    "\n"
219 	    "\t\tList all active injection records.\n"
220 	    "\n"
221 	    "\tzinject -c <id|all>\n"
222 	    "\n"
223 	    "\t\tClear the particular record (if given a numeric ID), or\n"
224 	    "\t\tall records if 'all' is specificed.\n"
225 	    "\n"
226 	    "\tzinject -p <function name> pool\n"
227 	    "\t\tInject a panic fault at the specified function. Only \n"
228 	    "\t\tfunctions which call spa_vdev_config_exit(), or \n"
229 	    "\t\tspa_vdev_exit() will trigger a panic.\n"
230 	    "\n"
231 	    "\tzinject -d device [-e errno] [-L <nvlist|uber|pad1|pad2>] [-F]\n"
232 	    "\t    [-T <read|write|free|claim|all> pool\n"
233 	    "\t\tInject a fault into a particular device or the device's\n"
234 	    "\t\tlabel.  Label injection can either be 'nvlist', 'uber',\n "
235 	    "\t\t'pad1', or 'pad2'.\n"
236 	    "\t\t'errno' can either be 'nxio' (the default) or 'io'.\n"
237 	    "\n"
238 	    "\tzinject -d device -A <degrade|fault> pool\n"
239 	    "\t\tPerform a specific action on a particular device\n"
240 	    "\n"
241 	    "\tzinject -I [-s <seconds> | -g <txgs>] pool\n"
242 	    "\t\tCause the pool to stop writing blocks yet not\n"
243 	    "\t\treport errors for a duration.  Simulates buggy hardware\n"
244 	    "\t\tthat fails to honor cache flush requests.\n"
245 	    "\t\tDefault duration is 30 seconds.  The machine is panicked\n"
246 	    "\t\tat the end of the duration.\n"
247 	    "\n"
248 	    "\tzinject -b objset:object:level:blkid pool\n"
249 	    "\n"
250 	    "\t\tInject an error into pool 'pool' with the numeric bookmark\n"
251 	    "\t\tspecified by the remaining tuple.  Each number is in\n"
252 	    "\t\thexidecimal, and only one block can be specified.\n"
253 	    "\n"
254 	    "\tzinject [-q] <-t type> [-e errno] [-l level] [-r range]\n"
255 	    "\t    [-a] [-m] [-u] [-f freq] <object>\n"
256 	    "\n"
257 	    "\t\tInject an error into the object specified by the '-t' option\n"
258 	    "\t\tand the object descriptor.  The 'object' parameter is\n"
259 	    "\t\tinterperted depending on the '-t' option.\n"
260 	    "\n"
261 	    "\t\t-q\tQuiet mode.  Only print out the handler number added.\n"
262 	    "\t\t-e\tInject a specific error.  Must be either 'io' or\n"
263 	    "\t\t\t'checksum'.  Default is 'io'.\n"
264 	    "\t\t-l\tInject error at a particular block level. Default is "
265 	    "0.\n"
266 	    "\t\t-m\tAutomatically remount underlying filesystem.\n"
267 	    "\t\t-r\tInject error over a particular logical range of an\n"
268 	    "\t\t\tobject.  Will be translated to the appropriate blkid\n"
269 	    "\t\t\trange according to the object's properties.\n"
270 	    "\t\t-a\tFlush the ARC cache.  Can be specified without any\n"
271 	    "\t\t\tassociated object.\n"
272 	    "\t\t-u\tUnload the associated pool.  Can be specified with only\n"
273 	    "\t\t\ta pool object.\n"
274 	    "\t\t-f\tOnly inject errors a fraction of the time.  Expressed as\n"
275 	    "\t\t\ta percentage between 1 and 100.\n"
276 	    "\n"
277 	    "\t-t data\t\tInject an error into the plain file contents of a\n"
278 	    "\t\t\tfile.  The object must be specified as a complete path\n"
279 	    "\t\t\tto a file on a ZFS filesystem.\n"
280 	    "\n"
281 	    "\t-t dnode\tInject an error into the metadnode in the block\n"
282 	    "\t\t\tcorresponding to the dnode for a file or directory.  The\n"
283 	    "\t\t\t'-r' option is incompatible with this mode.  The object\n"
284 	    "\t\t\tis specified as a complete path to a file or directory\n"
285 	    "\t\t\ton a ZFS filesystem.\n"
286 	    "\n"
287 	    "\t-t <mos>\tInject errors into the MOS for objects of the given\n"
288 	    "\t\t\ttype.  Valid types are: mos, mosdir, config, bpobj,\n"
289 	    "\t\t\tspacemap, metaslab, errlog.  The only valid <object> is\n"
290 	    "\t\t\tthe poolname.\n");
291 }
292 
293 static int
294 iter_handlers(int (*func)(int, const char *, zinject_record_t *, void *),
295     void *data)
296 {
297 	zfs_cmd_t zc;
298 	int ret;
299 
300 	zc.zc_guid = 0;
301 
302 	while (ioctl(zfs_fd, ZFS_IOC_INJECT_LIST_NEXT, &zc) == 0)
303 		if ((ret = func((int)zc.zc_guid, zc.zc_name,
304 		    &zc.zc_inject_record, data)) != 0)
305 			return (ret);
306 
307 	if (errno != ENOENT) {
308 		(void) fprintf(stderr, "Unable to list handlers: %s\n",
309 		    strerror(errno));
310 		return (-1);
311 	}
312 
313 	return (0);
314 }
315 
316 static int
317 print_data_handler(int id, const char *pool, zinject_record_t *record,
318     void *data)
319 {
320 	int *count = data;
321 
322 	if (record->zi_guid != 0 || record->zi_func[0] != '\0')
323 		return (0);
324 
325 	if (*count == 0) {
326 		(void) printf("%3s  %-15s  %-6s  %-6s  %-8s  %3s  %-15s\n",
327 		    "ID", "POOL", "OBJSET", "OBJECT", "TYPE", "LVL",  "RANGE");
328 		(void) printf("---  ---------------  ------  "
329 		    "------  --------  ---  ---------------\n");
330 	}
331 
332 	*count += 1;
333 
334 	(void) printf("%3d  %-15s  %-6llu  %-6llu  %-8s  %3d  ", id, pool,
335 	    (u_longlong_t)record->zi_objset, (u_longlong_t)record->zi_object,
336 	    type_to_name(record->zi_type), record->zi_level);
337 
338 	if (record->zi_start == 0 &&
339 	    record->zi_end == -1ULL)
340 		(void) printf("all\n");
341 	else
342 		(void) printf("[%llu, %llu]\n", (u_longlong_t)record->zi_start,
343 		    (u_longlong_t)record->zi_end);
344 
345 	return (0);
346 }
347 
348 static int
349 print_device_handler(int id, const char *pool, zinject_record_t *record,
350     void *data)
351 {
352 	int *count = data;
353 
354 	if (record->zi_guid == 0 || record->zi_func[0] != '\0')
355 		return (0);
356 
357 	if (*count == 0) {
358 		(void) printf("%3s  %-15s  %s\n", "ID", "POOL", "GUID");
359 		(void) printf("---  ---------------  ----------------\n");
360 	}
361 
362 	*count += 1;
363 
364 	(void) printf("%3d  %-15s  %llx\n", id, pool,
365 	    (u_longlong_t)record->zi_guid);
366 
367 	return (0);
368 }
369 
370 static int
371 print_panic_handler(int id, const char *pool, zinject_record_t *record,
372     void *data)
373 {
374 	int *count = data;
375 
376 	if (record->zi_func[0] == '\0')
377 		return (0);
378 
379 	if (*count == 0) {
380 		(void) printf("%3s  %-15s  %s\n", "ID", "POOL", "FUNCTION");
381 		(void) printf("---  ---------------  ----------------\n");
382 	}
383 
384 	*count += 1;
385 
386 	(void) printf("%3d  %-15s  %s\n", id, pool, record->zi_func);
387 
388 	return (0);
389 }
390 
391 /*
392  * Print all registered error handlers.  Returns the number of handlers
393  * registered.
394  */
395 static int
396 print_all_handlers(void)
397 {
398 	int count = 0;
399 
400 	(void) iter_handlers(print_device_handler, &count);
401 	(void) printf("\n");
402 	count = 0;
403 	(void) iter_handlers(print_data_handler, &count);
404 	(void) printf("\n");
405 	count = 0;
406 	(void) iter_handlers(print_panic_handler, &count);
407 
408 	return (count);
409 }
410 
411 /* ARGSUSED */
412 static int
413 cancel_one_handler(int id, const char *pool, zinject_record_t *record,
414     void *data)
415 {
416 	zfs_cmd_t zc;
417 
418 	zc.zc_guid = (uint64_t)id;
419 
420 	if (ioctl(zfs_fd, ZFS_IOC_CLEAR_FAULT, &zc) != 0) {
421 		(void) fprintf(stderr, "failed to remove handler %d: %s\n",
422 		    id, strerror(errno));
423 		return (1);
424 	}
425 
426 	return (0);
427 }
428 
429 /*
430  * Remove all fault injection handlers.
431  */
432 static int
433 cancel_all_handlers(void)
434 {
435 	int ret = iter_handlers(cancel_one_handler, NULL);
436 
437 	if (ret == 0)
438 		(void) printf("removed all registered handlers\n");
439 
440 	return (ret);
441 }
442 
443 /*
444  * Remove a specific fault injection handler.
445  */
446 static int
447 cancel_handler(int id)
448 {
449 	zfs_cmd_t zc;
450 
451 	zc.zc_guid = (uint64_t)id;
452 
453 	if (ioctl(zfs_fd, ZFS_IOC_CLEAR_FAULT, &zc) != 0) {
454 		(void) fprintf(stderr, "failed to remove handler %d: %s\n",
455 		    id, strerror(errno));
456 		return (1);
457 	}
458 
459 	(void) printf("removed handler %d\n", id);
460 
461 	return (0);
462 }
463 
464 /*
465  * Register a new fault injection handler.
466  */
467 static int
468 register_handler(const char *pool, int flags, zinject_record_t *record,
469     int quiet)
470 {
471 	zfs_cmd_t zc;
472 
473 	(void) strcpy(zc.zc_name, pool);
474 	zc.zc_inject_record = *record;
475 	zc.zc_guid = flags;
476 
477 	if (ioctl(zfs_fd, ZFS_IOC_INJECT_FAULT, &zc) != 0) {
478 		(void) fprintf(stderr, "failed to add handler: %s\n",
479 		    strerror(errno));
480 		return (1);
481 	}
482 
483 	if (flags & ZINJECT_NULL)
484 		return (0);
485 
486 	if (quiet) {
487 		(void) printf("%llu\n", (u_longlong_t)zc.zc_guid);
488 	} else {
489 		(void) printf("Added handler %llu with the following "
490 		    "properties:\n", (u_longlong_t)zc.zc_guid);
491 		(void) printf("  pool: %s\n", pool);
492 		if (record->zi_guid) {
493 			(void) printf("  vdev: %llx\n",
494 			    (u_longlong_t)record->zi_guid);
495 		} else if (record->zi_func[0] != '\0') {
496 			(void) printf("  panic function: %s\n",
497 			    record->zi_func);
498 		} else if (record->zi_duration > 0) {
499 			(void) printf(" time: %lld seconds\n",
500 			    (u_longlong_t)record->zi_duration);
501 		} else if (record->zi_duration < 0) {
502 			(void) printf(" txgs: %lld \n",
503 			    (u_longlong_t)-record->zi_duration);
504 		} else {
505 			(void) printf("objset: %llu\n",
506 			    (u_longlong_t)record->zi_objset);
507 			(void) printf("object: %llu\n",
508 			    (u_longlong_t)record->zi_object);
509 			(void) printf("  type: %llu\n",
510 			    (u_longlong_t)record->zi_type);
511 			(void) printf(" level: %d\n", record->zi_level);
512 			if (record->zi_start == 0 &&
513 			    record->zi_end == -1ULL)
514 				(void) printf(" range: all\n");
515 			else
516 				(void) printf(" range: [%llu, %llu)\n",
517 				    (u_longlong_t)record->zi_start,
518 				    (u_longlong_t)record->zi_end);
519 		}
520 	}
521 
522 	return (0);
523 }
524 
525 int
526 perform_action(const char *pool, zinject_record_t *record, int cmd)
527 {
528 	zfs_cmd_t zc;
529 
530 	ASSERT(cmd == VDEV_STATE_DEGRADED || cmd == VDEV_STATE_FAULTED);
531 	(void) strlcpy(zc.zc_name, pool, sizeof (zc.zc_name));
532 	zc.zc_guid = record->zi_guid;
533 	zc.zc_cookie = cmd;
534 
535 	if (ioctl(zfs_fd, ZFS_IOC_VDEV_SET_STATE, &zc) == 0)
536 		return (0);
537 
538 	return (1);
539 }
540 
541 int
542 main(int argc, char **argv)
543 {
544 	int c;
545 	char *range = NULL;
546 	char *cancel = NULL;
547 	char *end;
548 	char *raw = NULL;
549 	char *device = NULL;
550 	int level = 0;
551 	int quiet = 0;
552 	int error = 0;
553 	int domount = 0;
554 	int io_type = ZIO_TYPES;
555 	int action = VDEV_STATE_UNKNOWN;
556 	err_type_t type = TYPE_INVAL;
557 	err_type_t label = TYPE_INVAL;
558 	zinject_record_t record = { 0 };
559 	char pool[MAXNAMELEN];
560 	char dataset[MAXNAMELEN];
561 	zfs_handle_t *zhp;
562 	int nowrites = 0;
563 	int dur_txg = 0;
564 	int dur_secs = 0;
565 	int ret;
566 	int flags = 0;
567 
568 	if ((g_zfs = libzfs_init()) == NULL) {
569 		(void) fprintf(stderr, "internal error: failed to "
570 		    "initialize ZFS library\n");
571 		return (1);
572 	}
573 
574 	libzfs_print_on_error(g_zfs, B_TRUE);
575 
576 	if ((zfs_fd = open(ZFS_DEV, O_RDWR)) < 0) {
577 		(void) fprintf(stderr, "failed to open ZFS device\n");
578 		return (1);
579 	}
580 
581 	if (argc == 1) {
582 		/*
583 		 * No arguments.  Print the available handlers.  If there are no
584 		 * available handlers, direct the user to '-h' for help
585 		 * information.
586 		 */
587 		if (print_all_handlers() == 0) {
588 			(void) printf("No handlers registered.\n");
589 			(void) printf("Run 'zinject -h' for usage "
590 			    "information.\n");
591 		}
592 
593 		return (0);
594 	}
595 
596 	while ((c = getopt(argc, argv,
597 	    ":aA:b:d:f:Fg:qhIc:t:T:l:mr:s:e:uL:p:")) != -1) {
598 		switch (c) {
599 		case 'a':
600 			flags |= ZINJECT_FLUSH_ARC;
601 			break;
602 		case 'A':
603 			if (strcasecmp(optarg, "degrade") == 0) {
604 				action = VDEV_STATE_DEGRADED;
605 			} else if (strcasecmp(optarg, "fault") == 0) {
606 				action = VDEV_STATE_FAULTED;
607 			} else {
608 				(void) fprintf(stderr, "invalid action '%s': "
609 				    "must be 'degrade' or 'fault'\n", optarg);
610 				usage();
611 				return (1);
612 			}
613 			break;
614 		case 'b':
615 			raw = optarg;
616 			break;
617 		case 'c':
618 			cancel = optarg;
619 			break;
620 		case 'd':
621 			device = optarg;
622 			break;
623 		case 'e':
624 			if (strcasecmp(optarg, "io") == 0) {
625 				error = EIO;
626 			} else if (strcasecmp(optarg, "checksum") == 0) {
627 				error = ECKSUM;
628 			} else if (strcasecmp(optarg, "nxio") == 0) {
629 				error = ENXIO;
630 			} else {
631 				(void) fprintf(stderr, "invalid error type "
632 				    "'%s': must be 'io', 'checksum' or "
633 				    "'nxio'\n", optarg);
634 				usage();
635 				return (1);
636 			}
637 			break;
638 		case 'f':
639 			record.zi_freq = atoi(optarg);
640 			if (record.zi_freq < 1 || record.zi_freq > 100) {
641 				(void) fprintf(stderr, "frequency range must "
642 				    "be in the range (0, 100]\n");
643 				return (1);
644 			}
645 			break;
646 		case 'F':
647 			record.zi_failfast = B_TRUE;
648 			break;
649 		case 'g':
650 			dur_txg = 1;
651 			record.zi_duration = (int)strtol(optarg, &end, 10);
652 			if (record.zi_duration <= 0 || *end != '\0') {
653 				(void) fprintf(stderr, "invalid duration '%s': "
654 				    "must be a positive integer\n", optarg);
655 				usage();
656 				return (1);
657 			}
658 			/* store duration of txgs as its negative */
659 			record.zi_duration *= -1;
660 			break;
661 		case 'h':
662 			usage();
663 			return (0);
664 		case 'I':
665 			/* default duration, if one hasn't yet been defined */
666 			nowrites = 1;
667 			if (dur_secs == 0 && dur_txg == 0)
668 				record.zi_duration = 30;
669 			break;
670 		case 'l':
671 			level = (int)strtol(optarg, &end, 10);
672 			if (*end != '\0') {
673 				(void) fprintf(stderr, "invalid level '%s': "
674 				    "must be an integer\n", optarg);
675 				usage();
676 				return (1);
677 			}
678 			break;
679 		case 'm':
680 			domount = 1;
681 			break;
682 		case 'p':
683 			(void) strlcpy(record.zi_func, optarg,
684 			    sizeof (record.zi_func));
685 			break;
686 		case 'q':
687 			quiet = 1;
688 			break;
689 		case 'r':
690 			range = optarg;
691 			break;
692 		case 's':
693 			dur_secs = 1;
694 			record.zi_duration = (int)strtol(optarg, &end, 10);
695 			if (record.zi_duration <= 0 || *end != '\0') {
696 				(void) fprintf(stderr, "invalid duration '%s': "
697 				    "must be a positive integer\n", optarg);
698 				usage();
699 				return (1);
700 			}
701 			break;
702 		case 'T':
703 			if (strcasecmp(optarg, "read") == 0) {
704 				io_type = ZIO_TYPE_READ;
705 			} else if (strcasecmp(optarg, "write") == 0) {
706 				io_type = ZIO_TYPE_WRITE;
707 			} else if (strcasecmp(optarg, "free") == 0) {
708 				io_type = ZIO_TYPE_FREE;
709 			} else if (strcasecmp(optarg, "claim") == 0) {
710 				io_type = ZIO_TYPE_CLAIM;
711 			} else if (strcasecmp(optarg, "all") == 0) {
712 				io_type = ZIO_TYPES;
713 			} else {
714 				(void) fprintf(stderr, "invalid I/O type "
715 				    "'%s': must be 'read', 'write', 'free', "
716 				    "'claim' or 'all'\n", optarg);
717 				usage();
718 				return (1);
719 			}
720 			break;
721 		case 't':
722 			if ((type = name_to_type(optarg)) == TYPE_INVAL &&
723 			    !MOS_TYPE(type)) {
724 				(void) fprintf(stderr, "invalid type '%s'\n",
725 				    optarg);
726 				usage();
727 				return (1);
728 			}
729 			break;
730 		case 'u':
731 			flags |= ZINJECT_UNLOAD_SPA;
732 			break;
733 		case 'L':
734 			if ((label = name_to_type(optarg)) == TYPE_INVAL &&
735 			    !LABEL_TYPE(type)) {
736 				(void) fprintf(stderr, "invalid label type "
737 				    "'%s'\n", optarg);
738 				usage();
739 				return (1);
740 			}
741 			break;
742 		case ':':
743 			(void) fprintf(stderr, "option -%c requires an "
744 			    "operand\n", optopt);
745 			usage();
746 			return (1);
747 		case '?':
748 			(void) fprintf(stderr, "invalid option '%c'\n",
749 			    optopt);
750 			usage();
751 			return (2);
752 		}
753 	}
754 
755 	argc -= optind;
756 	argv += optind;
757 
758 	if (cancel != NULL) {
759 		/*
760 		 * '-c' is invalid with any other options.
761 		 */
762 		if (raw != NULL || range != NULL || type != TYPE_INVAL ||
763 		    level != 0 || record.zi_func[0] != '\0' ||
764 		    record.zi_duration != 0) {
765 			(void) fprintf(stderr, "cancel (-c) incompatible with "
766 			    "any other options\n");
767 			usage();
768 			return (2);
769 		}
770 		if (argc != 0) {
771 			(void) fprintf(stderr, "extraneous argument to '-c'\n");
772 			usage();
773 			return (2);
774 		}
775 
776 		if (strcmp(cancel, "all") == 0) {
777 			return (cancel_all_handlers());
778 		} else {
779 			int id = (int)strtol(cancel, &end, 10);
780 			if (*end != '\0') {
781 				(void) fprintf(stderr, "invalid handle id '%s':"
782 				    " must be an integer or 'all'\n", cancel);
783 				usage();
784 				return (1);
785 			}
786 			return (cancel_handler(id));
787 		}
788 	}
789 
790 	if (device != NULL) {
791 		/*
792 		 * Device (-d) injection uses a completely different mechanism
793 		 * for doing injection, so handle it separately here.
794 		 */
795 		if (raw != NULL || range != NULL || type != TYPE_INVAL ||
796 		    level != 0 || record.zi_func[0] != '\0' ||
797 		    record.zi_duration != 0) {
798 			(void) fprintf(stderr, "device (-d) incompatible with "
799 			    "data error injection\n");
800 			usage();
801 			return (2);
802 		}
803 
804 		if (argc != 1) {
805 			(void) fprintf(stderr, "device (-d) injection requires "
806 			    "a single pool name\n");
807 			usage();
808 			return (2);
809 		}
810 
811 		(void) strcpy(pool, argv[0]);
812 		dataset[0] = '\0';
813 
814 		if (error == ECKSUM) {
815 			(void) fprintf(stderr, "device error type must be "
816 			    "'io' or 'nxio'\n");
817 			return (1);
818 		}
819 
820 		record.zi_iotype = io_type;
821 		if (translate_device(pool, device, label, &record) != 0)
822 			return (1);
823 		if (!error)
824 			error = ENXIO;
825 
826 		if (action != VDEV_STATE_UNKNOWN)
827 			return (perform_action(pool, &record, action));
828 
829 	} else if (raw != NULL) {
830 		if (range != NULL || type != TYPE_INVAL || level != 0 ||
831 		    record.zi_func[0] != '\0' || record.zi_duration != 0) {
832 			(void) fprintf(stderr, "raw (-b) format with "
833 			    "any other options\n");
834 			usage();
835 			return (2);
836 		}
837 
838 		if (argc != 1) {
839 			(void) fprintf(stderr, "raw (-b) format expects a "
840 			    "single pool name\n");
841 			usage();
842 			return (2);
843 		}
844 
845 		(void) strcpy(pool, argv[0]);
846 		dataset[0] = '\0';
847 
848 		if (error == ENXIO) {
849 			(void) fprintf(stderr, "data error type must be "
850 			    "'checksum' or 'io'\n");
851 			return (1);
852 		}
853 
854 		if (translate_raw(raw, &record) != 0)
855 			return (1);
856 		if (!error)
857 			error = EIO;
858 	} else if (record.zi_func[0] != '\0') {
859 		if (raw != NULL || range != NULL || type != TYPE_INVAL ||
860 		    level != 0 || device != NULL || record.zi_duration != 0) {
861 			(void) fprintf(stderr, "panic (-p) incompatible with "
862 			    "other options\n");
863 			usage();
864 			return (2);
865 		}
866 
867 		if (argc < 1 || argc > 2) {
868 			(void) fprintf(stderr, "panic (-p) injection requires "
869 			    "a single pool name and an optional id\n");
870 			usage();
871 			return (2);
872 		}
873 
874 		(void) strcpy(pool, argv[0]);
875 		if (argv[1] != NULL)
876 			record.zi_type = atoi(argv[1]);
877 		dataset[0] = '\0';
878 	} else if (record.zi_duration != 0) {
879 		if (nowrites == 0) {
880 			(void) fprintf(stderr, "-s or -g meaningless "
881 			    "without -I (ignore writes)\n");
882 			usage();
883 			return (2);
884 		} else if (dur_secs && dur_txg) {
885 			(void) fprintf(stderr, "choose a duration either "
886 			    "in seconds (-s) or a number of txgs (-g) "
887 			    "but not both\n");
888 			usage();
889 			return (2);
890 		} else if (argc != 1) {
891 			(void) fprintf(stderr, "ignore writes (-I) "
892 			    "injection requires a single pool name\n");
893 			usage();
894 			return (2);
895 		}
896 
897 		(void) strcpy(pool, argv[0]);
898 		dataset[0] = '\0';
899 	} else if (type == TYPE_INVAL) {
900 		if (flags == 0) {
901 			(void) fprintf(stderr, "at least one of '-b', '-d', "
902 			    "'-t', '-a', '-p', '-I' or '-u' "
903 			    "must be specified\n");
904 			usage();
905 			return (2);
906 		}
907 
908 		if (argc == 1 && (flags & ZINJECT_UNLOAD_SPA)) {
909 			(void) strcpy(pool, argv[0]);
910 			dataset[0] = '\0';
911 		} else if (argc != 0) {
912 			(void) fprintf(stderr, "extraneous argument for "
913 			    "'-f'\n");
914 			usage();
915 			return (2);
916 		}
917 
918 		flags |= ZINJECT_NULL;
919 	} else {
920 		if (argc != 1) {
921 			(void) fprintf(stderr, "missing object\n");
922 			usage();
923 			return (2);
924 		}
925 
926 		if (error == ENXIO) {
927 			(void) fprintf(stderr, "data error type must be "
928 			    "'checksum' or 'io'\n");
929 			return (1);
930 		}
931 
932 		if (translate_record(type, argv[0], range, level, &record, pool,
933 		    dataset) != 0)
934 			return (1);
935 		if (!error)
936 			error = EIO;
937 	}
938 
939 	/*
940 	 * If this is pool-wide metadata, unmount everything.  The ioctl() will
941 	 * unload the pool, so that we trigger spa-wide reopen of metadata next
942 	 * time we access the pool.
943 	 */
944 	if (dataset[0] != '\0' && domount) {
945 		if ((zhp = zfs_open(g_zfs, dataset, ZFS_TYPE_DATASET)) == NULL)
946 			return (1);
947 
948 		if (zfs_unmount(zhp, NULL, 0) != 0)
949 			return (1);
950 	}
951 
952 	record.zi_error = error;
953 
954 	ret = register_handler(pool, flags, &record, quiet);
955 
956 	if (dataset[0] != '\0' && domount)
957 		ret = (zfs_mount(zhp, NULL, 0) != 0);
958 
959 	libzfs_fini(g_zfs);
960 
961 	return (ret);
962 }
963