xref: /freebsd/usr.sbin/mptutil/mptutil.c (revision f5463265955b829775bbb32e1fd0bc11dafc36ce)
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/param.h>
34 #include <sys/errno.h>
35 #include <err.h>
36 #include <stdio.h>
37 #include <stdlib.h>
38 #include <string.h>
39 #include <unistd.h>
40 #include "mptutil.h"
41 
42 SET_DECLARE(MPT_DATASET(top), struct mptutil_command);
43 
44 int mpt_unit;
45 
46 static void
47 usage(void)
48 {
49 
50 	fprintf(stderr, "usage: mptutil [-u unit] <command> ...\n\n");
51 	fprintf(stderr, "Commands include:\n");
52 	fprintf(stderr, "    version\n");
53 	fprintf(stderr, "    show adapter              - display controller information\n");
54 	fprintf(stderr, "    show config               - display RAID configuration\n");
55 	fprintf(stderr, "    show drives               - list physical drives\n");
56 	fprintf(stderr, "    show events               - display event log\n");
57 	fprintf(stderr, "    show volumes              - list logical volumes\n");
58 	fprintf(stderr, "    fail <drive>              - fail a physical drive\n");
59 	fprintf(stderr, "    online <drive>            - bring an offline physical drive online\n");
60 	fprintf(stderr, "    offline <drive>           - mark a physical drive offline\n");
61 	fprintf(stderr, "    name <volume> <name>\n");
62 	fprintf(stderr, "    volume status <volume>    - display volume status\n");
63 	fprintf(stderr, "    volume cache <volume> <enable|disable>\n");
64 	fprintf(stderr, "                              - Enable or disable the volume drive caches\n");
65 	fprintf(stderr, "    clear                     - clear volume configuration\n");
66 	fprintf(stderr, "    create <type> [-vq] [-s stripe] <drive>[,<drive>[,...]]\n");
67 	fprintf(stderr, "    delete <volume>\n");
68 	fprintf(stderr, "    add <drive> [volume]      - add a hot spare\n");
69 	fprintf(stderr, "    remove <drive>            - remove a hot spare\n");
70 #ifdef DEBUG
71 	fprintf(stderr, "    pd create <drive>         - create RAID physdisk\n");
72 	fprintf(stderr, "    pd delete <drive>         - delete RAID physdisk\n");
73 	fprintf(stderr, "    debug                     - debug 'show config'\n");
74 #endif
75 	exit(1);
76 }
77 
78 static int
79 version(int ac, char **av)
80 {
81 
82 	printf("mptutil version 1.0.3");
83 #ifdef DEBUG
84 	printf(" (DEBUG)");
85 #endif
86 	printf("\n");
87 	return (0);
88 }
89 MPT_COMMAND(top, version, version);
90 
91 int
92 main(int ac, char **av)
93 {
94 	struct mptutil_command **cmd;
95 	int ch;
96 
97 	while ((ch = getopt(ac, av, "u:")) != -1) {
98 		switch (ch) {
99 		case 'u':
100 			mpt_unit = atoi(optarg);
101 			break;
102 		case '?':
103 			usage();
104 		}
105 	}
106 
107 	av += optind;
108 	ac -= optind;
109 
110 	/* getopt() eats av[0], so we can't use mpt_table_handler() directly. */
111 	if (ac == 0)
112 		usage();
113 
114 #if BYTE_ORDER == BIG_ENDIAN
115 	warnx("mptutil is known to be broken on big-endian architectures");
116 #endif
117 
118 	SET_FOREACH(cmd, MPT_DATASET(top)) {
119 		if (strcmp((*cmd)->name, av[0]) == 0) {
120 			if ((*cmd)->handler(ac, av))
121 				return (1);
122 			else
123 				return (0);
124 		}
125 	}
126 	warnx("Unknown command %s.", av[0]);
127 	return (1);
128 }
129