| blob | 615fa25144dcfcee5ef0bb2bb8c97ec1c1b396af |
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 2009 Sun Microsystems, Inc. All rights reserved.
23 * Use is subject to license terms.
24 */
26 /*
27 * mpathadm.c : MP API CLI program
28 *
29 */
31 #include <libintl.h>
33 #include <mpapi.h>
38 #include <sys/types.h>
39 #include <sys/stat.h>
40 #include <unistd.h>
41 #include <stdlib.h>
42 #include <devid.h>
43 #include <fcntl.h>
45 /* helper functions */
48 /* object functions per subcommand */
57 #define VERSION_STRING_MAX_LEN 10
68 /*
69 * Version number: (copied from iscsiadm)
70 * MAJOR - This should only change when there is an incompatible change made
71 * to the interfaces or the output.
72 *
73 * MINOR - This should change whenever there is a new command or new feature
74 * with no incompatible change.
75 */
80 /* globals */
84 /*
85 * ****************************************************************************
86 *
87 * getExecBasename - copied from iscsiadm code
88 *
89 * input:
90 * execFullName - exec name of program (argv[0])
91 *
92 * Returns:
93 * command name portion of execFullName
94 *
95 * ****************************************************************************
96 */
99 {
102 /* guard against '/' at end of command invocation */
113 }
115 }
116 }
118 }
121 /*
122 * Add new options here
123 */
125 /* tables set up based on cmdparse instructions */
126 optionTbl_t longOptions[] = {
137 };
140 /*
141 * Add new subcommands here
142 */
143 subcommand_t subcommands[] = {
152 };
154 /*
155 * Add objects here
156 */
157 object_t objects[] = {
164 };
166 /*
167 * Rules for subcommands and objects
168 *
169 * command
170 *
171 * reqOpCmd -> subcommands that must have an operand
172 * optOpCmd -> subcommands that may have an operand
173 * noOpCmd -> subcommands that will have no operand
174 * invCmd -> subcommands that are invalid
175 * multOpCmd -> subcommands that can accept multiple operands
176 * operandDefinition -> Usage definition for the operand of this object
177 */
178 objectRules_t objectRules[] = {
192 };
194 /*
195 * list of objects, subcommands, valid short options, required flag and
196 * exclusive option string
197 *
198 * If it's not here, there are no options for that object.
199 */
200 optionRules_t optionRules[] = {
210 };
213 /*
214 * ****************************************************************************
215 *
216 * listMpathSupport - mpathadm list mpath-support
217 *
218 * operandLen - number of operands user passed into the cli
219 * operand - pointer to operand list from user
220 *
221 * ****************************************************************************
222 */
223 int
225 {
227 MP_PLUGIN_PROPERTIES pluginProps;
230 /* number of plugins listed */
238 }
243 }
246 /* loop through operands first */
254 mpstatus =
262 /* if no operands, list them all */
265 TEXT_LB_MPATH_SUPPORT),
268 /* if there is an operand... */
269 /* ... compare and display if match */
275 TEXT_LB_MPATH_SUPPORT),
278 /* begin back-up indentation */
279 /* LINTED E_SEC_PRINTF_VAR_FMT */
281 ERR_CANT_FIND_MPATH_SUPPORT_WITH_NAME),
283 /* end back-up indentation */
285 }
286 }
287 }
288 }
289 }
292 }
295 /*
296 * ****************************************************************************
297 *
298 * showMpathSupport - mpathadm show mpath-support <mpath-support name>, ...
299 *
300 * operandLen - number of operands user passed into the cli
301 * operand - pointer to operand list from user
302 *
303 * ****************************************************************************
304 */
305 int
307 {
309 MP_PLUGIN_PROPERTIES pluginProps;
312 MP_DEVICE_PRODUCT_PROPERTIES devProps;
315 MP_LOAD_BALANCE_TYPE lb;
319 MP_STATUS_SUCCESS) {
323 }
328 }
337 mpstatus =
344 }
347 /* if no operand, list it */
350 /* ... compare and display if match */
355 }
356 }
360 }
366 /* display the info for this plugin */
376 /* don't ignore load balance type none. */
383 }
389 /* check each bit, display string if found set */
397 supportedLoadBalanceTypes)) {
400 pluginProps.
401 supportedLoadBalanceTypes);
403 }
406 }
421 (MP_AUTOFAILBACK_SUPPORT_PLUGINANDMPLU
440 }
466 }
475 /* LINTED E_SEC_PRINTF_VAR_FMT */
478 /* if only supports specific products, */
479 /* get device product properties supported */
487 ERR_NO_SUPP_DEVICE_INFO));
488 /* can't get any more info, */
489 /* so we're done with this one */
491 }
494 j++) {
495 /* begin backup indentation */
498 /* end backup indentation */
506 TEXT_LB_VENDOR));
511 TEXT_LB_PRODUCT));
516 TEXT_LB_REVISION));
522 TEXT_LB_SUPPORTED_LB));
523 /* begin back-up indentation */
536 }
539 }
540 /* end back-up indentation */
547 ERR_NO_SUPP_DEVICE_INFO));
548 }
555 /* LINTED E_SEC_PRINTF_VAR_FMT */
557 ERR_CANT_FIND_MPATH_SUPPORT_WITH_NAME),
561 }
567 }
570 /*
571 * ****************************************************************************
572 *
573 * modifyMpathSupport -
574 * mpathadm modify mpath-support [options] <mpath-support name>, ...
575 *
576 * operandLen - number of operands user passed into the cli
577 * operand - pointer to operand list from user
578 * options - pointer to option list from user
579 *
580 * ****************************************************************************
581 */
582 int
584 {
586 MP_PLUGIN_PROPERTIES pluginProps;
589 MP_OID pluginOid;
599 }
604 }
610 i++) {
622 }
626 }
630 }
632 /* begin back-up indentation */
633 /* we found the plugin oid */
634 /* now change the options requested */
637 /* modify autofailback */
641 mpstatus =
646 mpstatus =
649 /* LINTED E_SEC_PRINTF_VAR_FMT */
651 ERR_FAILED_TO_CHANGE_OPTION_WITH_REASON),
652 cmdStr,
656 }
659 /* modify autoprobing */
663 mpstatus =
668 mpstatus =
671 /* LINTED E_SEC_PRINTF_VAR_FMT */
673 ERR_FAILED_TO_CHANGE_OPTION_WITH_REASON),
674 cmdStr,
678 }
681 /* modify loadbalance type */
683 /* user of the cli sends text string, we need the int */
684 /* value to pass to the mpapi */
686 mpstatus =
688 lbValue);
693 /* LINTED E_SEC_PRINTF_VAR_FMT */
696 ERR_FAILED_TO_CHANGE_OPTION_WITH_REASON),
700 }
701 /* end back-up indentation */
706 /* LINTED E_SEC_PRINTF_VAR_FMT */
709 ERR_FAILED_TO_CHANGE_OPTION_WITH_REASON),
710 cmdStr,
714 }
719 }
722 /*
723 * ****************************************************************************
724 *
725 * listLogicalUnit -
726 * mpathadm list {logical-unit | LU} [options] [<logical-unit name>, ...]
727 *
728 * operandLen - number of operands user passed into the cli
729 * operand - pointer to operand list from user
730 * options - pointer to option list from user
731 *
732 * ****************************************************************************
733 */
734 int
736 {
738 MP_MULTIPATH_LOGICAL_UNIT_PROPERTIES luProps;
739 MP_PLUGIN_PROPERTIES pluginProps;
740 MP_TARGET_PORT_PROPERTIES tportProps;
745 MP_OID luOid;
750 /* count number of options */
752 opListCount++;
753 }
760 }
762 /* list to keep track of multiple options */
766 }
770 /* if no operands or options, list everything we find */
777 }
783 }
786 /* get properties so we can list the name */
795 }
797 /* attempt to find this logical unit */
804 }
807 /* begin backup indentation */
808 /* get lu properties so we can check the name */
811 /* end backup indentation */
812 mpstatus =
818 cmdName,
821 }
827 }
832 /* check if we have operands */
834 /* no operands */
838 /* operands */
841 }
848 }
854 }
857 /* loop through operands */
862 /*
863 * loop through plugin, and get properties
864 * so we can list the name
865 */
873 cmdName,
876 }
878 /* attempt to find this logical unit */
879 mpstatus =
884 cmdName,
887 }
891 lu++) {
893 /* begin backup indentation */
894 /* get lu props & check the name */
897 /* end backup indentation */
898 mpstatus =
906 ERR_NO_PROPERTIES));
908 }
910 /*
911 * compare operand - is it a match?
912 * If so, continue
913 */
917 bContinue =
921 }
926 /* check options */
929 /* begin backup indentation */
940 }
943 /* get TPG list */
944 mpstatus =
951 }
953 /* get target ports */
958 mpstatus =
963 cmdName,
966 }
968 /* get target port properties for the name */
974 mpstatus =
979 cmdName,
982 }
985 /* check the name */
991 }
996 /* end back-up indentation */
999 /*
1000 * if no options,
1001 * listit
1002 */
1005 }
1016 }
1018 }
1024 /* option/operand combo not found */
1025 /* LINTED E_SEC_PRINTF_VAR_FMT */
1028 ERR_LU_NOT_FOUND_WITH_MISSING_LU_STR),
1031 }
1032 }
1036 opIndex++) {
1038 /* LINTED E_SEC_PRINTF_VAR_FMT */
1041 ERR_LU_NOT_FOUND_WITH_MISSING_LU_STR),
1044 }
1045 }
1054 }
1057 /*
1058 * ****************************************************************************
1059 *
1060 * compareLUName -
1061 * compare names directly and via devid if no match directly
1062 *
1063 * cmpString - first string to compare
1064 * deviceProperty - string from properties
1065 * sizeToCompare - size of deviceProperty
1066 *
1067 * returns B_TRUE if the strings match either directly or via devid
1068 * B_FALSE otherwise
1069 *
1070 * ****************************************************************************
1071 */
1072 boolean_t
1074 {
1083 /* user input didn't match, try via devid */
1084 /*
1085 * I don't see a reason to print the error for
1086 * any of these since they'll get the error at
1087 * the end anyway
1088 */
1099 }
1100 }
1104 }
1107 }
1111 }
1114 }
1118 }
1121 /*
1122 * ****************************************************************************
1123 *
1124 * listIndivudualLogicalUnit -
1125 * Used by list logical unit cli.
1126 * Displays info about an LU
1127 *
1128 * luOid - LU to list
1129 * luProps - properties of he LU to list
1130 *
1131 * ****************************************************************************
1132 */
1133 int
1135 MP_MULTIPATH_LOGICAL_UNIT_PROPERTIES luProps)
1136 {
1137 MP_PATH_LOGICAL_UNIT_PROPERTIES pathProps;
1149 /* LINTED E_SEC_PRINTF_VAR_FMT */
1156 }
1164 mpstatus =
1171 }
1173 /* cycle through and check status of each for */
1174 /* operation path count */
1176 numOperationalPaths++;
1177 }
1178 }
1184 }
1187 /*
1188 * ****************************************************************************
1189 *
1190 * showLogicalUnit -
1191 * mpathadm show {logical-unit | LU} <logical-unit name>, ...
1192 *
1193 * operandLen - number of operands user passed into the cli
1194 * operand - pointer to operand list from user
1195 *
1196 * ****************************************************************************
1197 */
1198 int
1200 {
1202 MP_MULTIPATH_LOGICAL_UNIT_PROPERTIES luProps;
1203 MP_PLUGIN_PROPERTIES pluginProps;
1211 }
1215 mpstatus =
1222 }
1224 mpstatus =
1228 cmdName,
1231 }
1233 mpstatus =
1239 }
1244 }
1247 /* LINTED E_SEC_PRINTF_VAR_FMT */
1249 ERR_LU_NOT_FOUND_WITH_MISSING_LU_STR),
1252 }
1257 }
1260 /*
1261 * ****************************************************************************
1262 *
1263 * showIndivudualLogicalUnit -
1264 * Used by show logical unit cli.
1265 * Displays info about an LU
1266 *
1267 * luOid - LU to show
1268 * luProps - properties of he LU to show
1269 * pluginProps - propertis of the plugin this LU belongs to
1270 *
1271 * ****************************************************************************
1272 */
1273 int
1275 MP_MULTIPATH_LOGICAL_UNIT_PROPERTIES luProps,
1276 MP_PLUGIN_PROPERTIES pluginProps)
1277 {
1278 MP_PATH_LOGICAL_UNIT_PROPERTIES pathProps;
1279 MP_TARGET_PORT_GROUP_PROPERTIES tpgProps;
1280 MP_TARGET_PORT_PROPERTIES tportProps;
1281 MP_INITIATOR_PORT_PROPERTIES initProps;
1313 /* don't ignore load balance type none. */
1318 }
1326 }
1334 }
1342 }
1345 /* get path info */
1354 }
1367 }
1379 }
1391 }
1401 }
1410 }
1412 /* get tpg info */
1419 /* display tpg info only if is assymetric */
1422 }
1433 /* display tpg info only if is assymetric */
1436 }
1443 TEXT_LB_EXPLICIT_FAILOVER),
1450 TEXT_LB_ACCESS_STATE),
1453 /* display label for each tpg. */
1457 /* display label once for symmetric. */
1459 /* begin back-up indentation */
1463 /* end back-up indentation */
1464 }
1465 }
1467 /* get target port info */
1473 cmdName,
1477 /* begin back-up indentation */
1503 }
1504 /* insert blank line if not the last target port. */
1507 }
1508 }
1510 /* end back-up indentation */
1519 }
1522 /*
1523 * ****************************************************************************
1524 *
1525 * modifyLogicalUnit -
1526 * mpathadm modify {logical-unit | LU} [options] <logical-unit name>, ...
1527 *
1528 * operandLen - number of operands user passed into the cli
1529 * operand - pointer to operand list from user
1530 * options - pointer to option list from user
1531 *
1532 * ****************************************************************************
1533 */
1534 int
1536 {
1538 MP_OID luOid;
1545 /* LINTED E_SEC_PRINTF_VAR_FMT */
1551 }
1553 /* we found the lu oid, now change the options requested */
1556 /* modify autofailback */
1560 mpstatus =
1564 mpstatus =
1567 /* begin back-up indentation */
1568 /* LINTED E_SEC_PRINTF_VAR_FMT */
1570 ERR_FAILED_TO_CHANGE_OPTION_WITH_REASON),
1572 TEXT_ILLEGAL_ARGUMENT));
1575 /* start back-up indentation */
1576 }
1579 /* modify autoprobing */
1583 mpstatus =
1587 mpstatus =
1590 /* begin back-up indentation */
1591 /* LINTED E_SEC_PRINTF_VAR_FMT */
1593 ERR_FAILED_TO_CHANGE_OPTION_WITH_REASON),
1595 TEXT_ILLEGAL_ARGUMENT));
1598 /* end back-up indentation */
1599 }
1602 /* modify loadbalance type */
1604 mpstatus =
1611 /* LINTED E_SEC_PRINTF_VAR_FMT */
1614 ERR_FAILED_TO_CHANGE_OPTION_WITH_REASON),
1618 }
1621 }
1624 /*
1625 * ****************************************************************************
1626 *
1627 * failoverLogicalUnit -
1628 * mpathadm failover {logical-unit | LU} <logical-unit name>, ...
1629 *
1630 * operand - pointer to operand list from user
1631 *
1632 * ****************************************************************************
1633 */
1634 int
1636 {
1638 MP_OID luOid;
1639 MP_MULTIPATH_LOGICAL_UNIT_PROPERTIES luProps;
1640 MP_TARGET_PORT_GROUP_PROPERTIES tpgProps;
1643 MP_TPG_STATE_PAIR tpgStatePair;
1648 /* LINTED E_SEC_PRINTF_VAR_FMT */
1650 ERR_LU_NOT_FOUND_WITH_MISSING_LU_STR),
1654 }
1656 /* get LUN properties and check to be sure it's asymmetric */
1659 mpstatus =
1665 }
1671 }
1673 /* get TPGs for this LUN */
1674 mpstatus =
1680 }
1682 /* pick a TPG whose state is active or standby, and change it */
1683 /* to opposite via MP_SetTPGAccessState */
1688 mpstatus =
1695 }
1700 }
1702 /* find one that is standby */
1711 MP_ACCESS_STATE_ACTIVE;
1712 mpstatus =
1715 /* begin back-up indentation */
1716 /* LINTED E_SEC_PRINTF_VAR_FMT */
1718 ERR_FAILED_TO_FAILOVER_WITH_REASON),
1722 /* end back-up indentation */
1723 }
1724 }
1733 }
1736 }
1739 /*
1740 * ****************************************************************************
1741 *
1742 * getLogicalUnitOid -
1743 * Search through all plugins and get the OID for specified logical unit
1744 *
1745 * luFileName - file name of LU (specified by the user) to find
1746 * pLuOid - OID to return
1747 *
1748 * ****************************************************************************
1749 */
1750 boolean_t
1752 {
1754 MP_MULTIPATH_LOGICAL_UNIT_PROPERTIES luProps;
1755 MP_PLUGIN_PROPERTIES pluginProps;
1765 /* print some kind of error msg here - should never happen */
1766 /* LINTED E_SEC_PRINTF_VAR_FMT */
1770 }
1781 }
1786 }
1789 /* get properties so we can list the name */
1797 }
1799 /* attempt to find this logical unit */
1806 }
1811 /* get lu properties so we can check the name */
1814 mpstatus =
1821 }
1827 /* user input didn't match, try via devid */
1828 /*
1829 * I don't see a reason to print the error for
1830 * any of these since they'll get the error at
1831 * the end anyway
1832 */
1846 }
1847 }
1851 }
1854 }
1858 }
1861 }
1862 }
1865 pLogicalUnitOidList->
1868 pLogicalUnitOidList->
1872 }
1873 }
1874 }
1877 }
1880 /*
1881 * ****************************************************************************
1882 *
1883 * listInitiatorPort -
1884 * mpathadm list initiator-port [<initiator-port name>, ...]
1885 *
1886 * operandLen - number of operands user passed into the cli
1887 * operand - pointer to operand list from user
1888 *
1889 * ****************************************************************************
1890 */
1891 int
1893 {
1895 MP_INITIATOR_PORT_PROPERTIES initProps;
1907 }
1911 }
1918 }
1923 }
1926 mpstatus =
1930 /* LINTED E_SEC_PRINTF_VAR_FMT */
1951 /* if no operands listed, */
1952 /* list all we find */
1957 /* check each operand */
1958 /* Is it */
1959 /* the one we want to list? */
1964 initProps.
1965 portID)) {
1966 bListIt =
1967 B_TRUE;
1969 B_TRUE;
1970 }
1971 }
1972 }
1973 }
1980 }
1991 /* LINTED E_SEC_PRINTF_VAR_FMT */
1993 ERR_INIT_PORT_NOT_FOUND_WITH_MISSING_LU_STR),
1996 }
1997 }
2000 }
2003 /*
2004 * ****************************************************************************
2005 *
2006 * listIndividualInitiatorPort -
2007 * used by listInitiatorPort to list info for one init port
2008 *
2009 * initProps - properties of initiator port to list
2010 *
2011 * ****************************************************************************
2012 */
2013 int
2015 {
2025 }
2028 /*
2029 * ****************************************************************************
2030 *
2031 * showInitiatorPort -
2032 * mpathadm show initiator-port <initiator-port name>, ...
2033 *
2034 * operandLen - number of operands user passed into the cli
2035 * operand - pointer to operand list from user
2036 *
2037 * ****************************************************************************
2038 */
2039 int
2041 {
2043 MP_INITIATOR_PORT_PROPERTIES initProps;
2053 }
2058 }
2065 mpstatus =
2069 /* LINTED E_SEC_PRINTF_VAR_FMT */
2072 ERR_NO_INIT_PORT_LIST_WITH_REASON),
2083 iport ++) {
2091 /* begin back-up indentation */
2095 /* end back-up indentation */
2101 }
2102 }
2105 mpstatus =
2107 initProps);
2110 }
2120 /* need temp string here since we need to fill in a */
2121 /* name in the error string */
2122 /* LINTED E_SEC_PRINTF_VAR_FMT */
2124 ERR_INIT_PORT_NOT_FOUND_WITH_MISSING_LU_STR),
2127 }
2132 }
2135 /*
2136 * ****************************************************************************
2137 *
2138 * showIndividualInitiatorPort -
2139 * used by showInitiatorPort to show info for one init port
2140 *
2141 * initProps - properties of initiator port to show
2142 *
2143 * ****************************************************************************
2144 */
2145 int
2147 {
2164 }
2167 /*
2168 * ****************************************************************************
2169 *
2170 * enablePath -
2171 * mpathadm enable path -i <initiator-port>
2172 * -t <target-port name> -l <logical-unit name>
2173 *
2174 * options - pointer to option list from user
2175 *
2176 * ****************************************************************************
2177 */
2178 int
2180 {
2182 MP_OID pathOid;
2190 /* have init port name */
2194 /* have target port id */
2198 /* have LU name */
2201 }
2202 }
2204 /* LINTED E_SEC_PRINTF_VAR_FMT */
2211 /* LINTED E_SEC_PRINTF_VAR_FMT */
2218 /* LINTED E_SEC_PRINTF_VAR_FMT */
2224 }
2227 /* LINTED E_SEC_PRINTF_VAR_FMT */
2233 }
2235 /* found the path, attempt to enable it */
2238 /* LINTED E_SEC_PRINTF_VAR_FMT */
2244 }
2247 }
2250 /*
2251 * ****************************************************************************
2252 *
2253 * disablePath -
2254 * mpathadm disable path -i <initiator-port>
2255 * -t <target-port name> -l <logical-unit name>
2256 *
2257 * options - pointer to option list from user
2258 *
2259 * ****************************************************************************
2260 */
2261 int
2263 {
2265 MP_OID pathOid;
2274 /* have init port name */
2278 /* have target port id */
2282 /* have LU name */
2285 }
2286 }
2288 /* LINTED E_SEC_PRINTF_VAR_FMT */
2295 /* LINTED E_SEC_PRINTF_VAR_FMT */
2302 /* LINTED E_SEC_PRINTF_VAR_FMT */
2308 }
2311 /* LINTED E_SEC_PRINTF_VAR_FMT */
2317 }
2319 /* found the path, attempt to enable it */
2322 /* LINTED E_SEC_PRINTF_VAR_FMT */
2324 ERR_FAILED_TO_DISABLE_PATH_WITH_REASON),
2328 }
2332 }
2335 /*
2336 * ****************************************************************************
2337 *
2338 * overridePath -
2339 * mpathadm override path {-i <initiator-port>
2340 * -t <target-port name> | -c} <logical-unit name>
2341 *
2342 * options - pointer to option list from user
2343 *
2344 * ****************************************************************************
2345 */
2346 int
2348 {
2355 /* First check to see if we have the cancel option, */
2356 /* May as well save off the lun while we're at it */
2360 /* we have a cancel */
2364 /* we have a lun- save it while we're here */
2368 }
2369 }
2372 /* if we have the cancel option, */
2374 /* LINTED E_SEC_PRINTF_VAR_FMT */
2377 ERR_FAILED_TO_CANCEL_OVERRIDE_PATH_WITH_REASON),
2381 }
2383 /* cancel the override path for the specified LU */
2386 /* LINTED E_SEC_PRINTF_VAR_FMT */
2389 ERR_FAILED_TO_CANCEL_OVERRIDE_PATH_WITH_REASON),
2393 }
2395 /* must be wanting to override the path */
2397 /* LINTED E_SEC_PRINTF_VAR_FMT */
2400 ERR_FAILED_TO_OVERRIDE_PATH_WITH_REASON),
2404 }
2407 /* LINTED E_SEC_PRINTF_VAR_FMT */
2410 ERR_FAILED_TO_OVERRIDE_PATH_WITH_REASON),
2415 }
2417 /* attempt to set the override path */
2420 /* LINTED E_SEC_PRINTF_VAR_FMT */
2423 ERR_FAILED_TO_OVERRIDE_PATH_WITH_REASON),
2427 }
2428 }
2431 }
2434 /*
2435 * ****************************************************************************
2436 *
2437 * getPathOid -
2438 * Search through all plugins and get the OID for specified path
2439 *
2440 * operand - pointer to operand list from user
2441 * options - pointer to option list from user
2442 *
2443 * ****************************************************************************
2444 */
2445 boolean_t
2447 {
2449 MP_MULTIPATH_LOGICAL_UNIT_PROPERTIES luProps;
2450 MP_PATH_LOGICAL_UNIT_PROPERTIES pathProps;
2451 MP_INITIATOR_PORT_PROPERTIES initProps;
2452 MP_TARGET_PORT_PROPERTIES targProps;
2468 }
2473 /* save init port name */
2479 /* save target port id */
2485 /* save LU name */
2490 }
2491 }
2497 /* if we don't have all three pieces, we can't find the path */
2500 }
2502 /* get the plugin ist */
2508 }
2513 }
2517 /* get Logical Unit list */
2524 }
2529 /* get lu properties so we can check the name */
2532 mpstatus =
2539 }
2542 /* get paths for this LU and search from here */
2543 mpstatus =
2548 /* LINTED E_SEC_PRINTF_VAR_FMT */
2551 ERR_FAILED_TO_FIND_PATH));
2554 }
2559 mpstatus =
2560 MP_GetPathLogicalUnitProperties
2567 ERR_NO_PROPERTIES));
2569 }
2571 /*
2572 * get properties of iniator port and
2573 * target port to see if we have the
2574 * right path
2575 */
2576 mpstatus =
2585 ERR_NO_PROPERTIES));
2587 }
2589 /* lu and init port matches, check target port */
2596 }
2599 /* we found our path */
2606 }
2618 }
2621 /*
2622 * ****************************************************************************
2623 *
2624 * getLbValueFromString
2625 * Gets the MP_LOAD_BALANCE_TYPE specified load balance type string
2626 *
2627 * lbStr - load balance string defined in the .h file
2628 * This is what users will be required to feed into the
2629 * modify lu command.
2630 *
2631 * ****************************************************************************
2632 */
2633 MP_LOAD_BALANCE_TYPE
2635 {
2703 }
2711 /*
2712 * ****************************************************************************
2713 *
2714 * displayLogicalUnitNameTypeString
2715 * Displays the text equivalent string for the MP_LOGICAL_UNIT_NAME_TYPE
2716 * specified load balance type
2717 *
2718 * typeVal - load balance type defined in the MPAPI spec
2719 *
2720 * ****************************************************************************
2721 */
2722 void
2724 {
2743 typeString =
2749 }
2756 /*
2757 * ****************************************************************************
2758 *
2759 * displayLoadBalanceString
2760 * Displays the text equivalent string for the MP_LOAD_BALANCE_TYPE
2761 * specified load balance type
2762 *
2763 * lbVal - load balance type defined in the MPAPI spec
2764 *
2765 * ****************************************************************************
2766 */
2767 void
2769 {
2847 }
2854 /*
2855 * ****************************************************************************
2856 *
2857 * displayTransportTypeString
2858 * Displays the text equivalent string for the MP_PORT_TRANSPORT_TYPE
2859 * specified load balance type
2860 *
2861 * transportTypeVal - transport type defined in the MPAPI spec
2862 *
2863 * ****************************************************************************
2864 */
2865 void
2867 {
2873 ttypeString =
2891 }
2898 /*
2899 * ****************************************************************************
2900 *
2901 * getMpStatusStr
2902 * Gets the string description for the specified load balance type value
2903 *
2904 * mpstatus - MP_STATUS value
2905 *
2906 * ****************************************************************************
2907 */
2910 {
2956 }
2962 /*
2963 * ****************************************************************************
2964 *
2965 * GetPathStateStr
2966 * Gets the string description for the specified path state type value
2967 *
2968 * pathState - MP_PATH_STATE values
2969 *
2970 * ****************************************************************************
2971 */
2974 {
2994 pathString =
2998 pathString =
3002 pathString =
3006 pathString =
3012 }
3019 /*
3020 * ****************************************************************************
3021 *
3022 * getAccessStateStr
3023 * Gets the string description for the specified access state type value
3024 *
3025 * accessState - MP_ACCESS_STATE_TYPE values
3026 *
3027 * ****************************************************************************
3028 */
3031 {
3036 accessString =
3040 accessString =
3042 TEXT_ACCESS_STATE_ACTIVE_NONOPTIMIZED);
3045 accessString =
3049 accessString =
3053 accessString =
3062 }
3067 /*
3068 * ****************************************************************************
3069 *
3070 * displayArray
3071 * Print out the specified array.
3072 *
3073 * arrayToDisplay - array to display
3074 * arraySize - size of array to display
3075 *
3076 * ****************************************************************************
3077 */
3078 void
3080 {
3086 }
3087 }
3089 }
3092 /*
3093 * ****************************************************************************
3094 *
3095 * getStringArray
3096 * Return a null terminated array for the specified array as a string,
3097 * This is used for inputting into the %s in formatted strings.
3098 *
3099 * arrayToDisplay - array to display
3100 * arraySize - size of array to display
3101 *
3102 * ****************************************************************************
3103 */
3104 MP_CHAR *
3106 {
3119 }
3121 }
3124 }
3127 /*
3128 * ****************************************************************************
3129 *
3130 * displayWideArray
3131 * Print out the specified wide character array as a string,
3132 * adding the null termination
3133 *
3134 * arrayToDisplay - array to display
3135 * arraySize - size of array to display
3136 *
3137 * ****************************************************************************
3138 */
3139 void
3141 {
3148 }
3149 }
3150 }
3153 /*
3154 * ****************************************************************************
3155 *
3156 * listfunc
3157 * Used by cmdparse for list clis
3158 *
3159 * ****************************************************************************
3160 */
3161 /*ARGSUSED*/
3162 static int
3165 {
3183 }
3186 }
3189 /*
3190 * ****************************************************************************
3191 *
3192 * showFunc
3193 * used bycmdparse for show clis
3194 *
3195 * ****************************************************************************
3196 */
3197 /*ARGSUSED*/
3198 static int
3201 {
3217 }
3220 }
3223 /*
3224 * ****************************************************************************
3225 *
3226 * modifyFunc
3227 * Used by cmdparse for midify clis
3228 *
3229 *
3230 * ****************************************************************************
3231 */
3232 /*ARGSUSED*/
3233 static int
3236 {
3249 }
3253 }
3256 /*
3257 * ****************************************************************************
3258 *
3259 * enableFunc
3260 * Used by cmdpars for enable clis
3261 *
3262 * ****************************************************************************
3263 */
3264 /*ARGSUSED*/
3265 static int
3268 {
3278 }
3281 }
3284 /*
3285 * ****************************************************************************
3286 *
3287 * disableFunc
3288 * Used by cmdpars for disable clis
3289 *
3290 * ****************************************************************************
3291 */
3292 /*ARGSUSED*/
3293 static int
3296 {
3306 }
3309 }
3312 /*
3313 * ****************************************************************************
3314 *
3315 * failoverFunc
3316 * Used by cmdpars for failover clis
3317 *
3318 * ****************************************************************************
3319 */
3320 /*ARGSUSED*/
3321 static int
3324 {
3334 }
3337 }
3340 /*
3341 * ****************************************************************************
3342 *
3343 * overrideFunc
3344 * Used by cmdpars for override clis
3345 *
3346 * ****************************************************************************
3347 */
3348 /*ARGSUSED*/
3349 static int
3353 {
3363 }
3367 }
3370 /*
3371 * *************************************************************************
3372 *
3373 * main
3374 *
3375 * *************************************************************************
3376 */
3377 int
3379 {
3380 synTables_t synTables;
3386 /* set global command name */
3407 }
3413 }