1MP_GetAssociatedPaCtohmOmiodnLiMsutl(t3iMpPaAtPhI)ManagementMPL_iGbertaArsysoFcuinactteidoPnasthOidList(3MPAPI)
2
3
4
6 MP_GetAssociatedPathOidList - get a list of object IDs
7
9 cc [ flag... ] file... -lMPAPI [ library... ]
10 #include <mpapi.h>
11
12 MP_STATUS MP_GetAssociatedPathOidList(
13 MP_OID oid, MP_OID MP_OID_LIST **ppList);
14
15
17 oid The object ID of the multipath logical unit, initiator port,
18 or target port.
19
20
21 ppList A pointer to a pointer to an object ID that has type
22 MP_OID_LIST structure. With a successful return, this will
23 contain a pointer to an object ID that has type MP_OID_LIST
24 that contains the object IDs of all the paths associated with
25 the specified (multipath) logical unit, initiator port, or
26 target port oid.
27
28
30 The MP_GetAssociatedPathOidList() function gets a list of oid object
31 IDs for all the path logica l units associated with the specified mul‐
32 tipath logical unit , initiator port, or target port.
33
34
35 Returns a list of object IDs for all the path logical units associated
36 with the specified mult ipath logical unit, initiator port, or target
37 port.
38
39
40 When the caller is finished using the list it must free the memory used
41 by the list by calling MP_FreeOidList.
42
44 MP_STATUS_INVALID_PARAMETER
45
46 The ppList is null or specifies a memory area to that the data can‐
47 not be written or when the oid has a type subfield other than
48 MP_OBJECT_TYPE_MULTI PATH_LU, MP_OBJECT_TYPE_INITIATOR_PORT, or
49 MP_OBJECT_TYPE_TARGET_PORT.
50
51
52 MP_STATUS_INVALID_OBJECT_TYPE
53
54 The oid does not specify any valid object type. This is most likely
55 to happen if an uninitialized object ID is passed to the API.
56
57
58 MP_STATUS_OBJECT_NOT_FOUND
59
60 The oid owner ID or object sequence number is invalid.
61
62
63 MP_STATUS_SUCCESS
64
65 The operation is successful.
66
67
69 See attributes(5) for descriptions of the following attributes:
70
71
72
73
74 ┌─────────────────────────────┬─────────────────────────────┐
75 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
76 ├─────────────────────────────┼─────────────────────────────┤
77 │Interface Stability │Standard: ANSI INCITS 412 │
78 │ │Multipath Management API │
79 ├─────────────────────────────┼─────────────────────────────┤
80 │MT-Level │Safe │
81 └─────────────────────────────┴─────────────────────────────┘
82
84 libMPAPI(3LIB), MP_GetPathLogicalUnitProperties(3MPAPI), attributes(5)
85
86
87 Multipath Management API Version 1.0
88
89
90
91SunOS 5.11 15 Feb 200M6P_GetAssociatedPathOidList(3MPAPI)