1MP_GetMPLuOidListFCroommmToPnG(M3uMlPtAiPpIa)th Management LiMbPr_aGreytMFPuLnucOtiidoLnisstFromTPG(3MPAPI)
2
3
4

NAME

6       MP_GetMPLuOidListFromTPG - return a list of object IDs
7

SYNOPSIS

9       cc [ flag... ] file... -lMPAPI [ library... ]
10       #include <mpapi.h>
11
12       MP_STATUS MP_GetMPLuOidListFromTPG(MP_OID oid,
13            MP_OID_LIST **ppList);
14
15

PARAMETERS

17       oid       The object ID of the target port group.
18
19
20       ppList    A  pointer  to  a  pointer  to  an  object  ID  that has type
21                 MP_OID_LIST structure. With a successful  return,  this  con‐
22                 tains  a  pointer  to  an object ID that has type MP_OID_LIST
23                 that contains the object IDs of all the  (multipath)  logical
24                 units associated with the specified target port group.
25
26

DESCRIPTION

28       The  MP_GetMPLuOidListFromTPG() function returns the list of object IDs
29       for the multipath logical units associated  with  the  specific  target
30       port group.
31
32
33       When  the  caller  is  finished using the list, it must free the memory
34       used by the list by calling MP_FreeOidList.
35

RETURN VALUES

37       MP_STATUS_INVALID_OBJECT_TYPE
38
39           The oid does not specify any valid object type. This is most likely
40           to happen if an uninitialized object ID is passed to the API.
41
42
43       MP_STATUS_INVALID_PARAMETER
44
45           The  pplist is null or specifies a memory area to which data cannot
46           be written, or  when  the  oid  has  a  type  subfield  other  than
47           MP_OBJECT_TYPE_TARGET_PORT.
48
49
50       MP_STATUS_OBJECT_NOT_FOUND
51
52           The oid owner ID or object sequence number is invalid.
53
54
55       MP_STATUS_SUCCESS
56
57           The operation is successful.
58
59
60       MP_STATUS_FAILED
61
62           The multipath logical unit list for the specified target port group
63           object ID is not found.
64
65
66       MP_STATUS_INSUFFICIENT_MEMORY
67
68           A memory allocation failure occurred.
69
70

ATTRIBUTES

72       See attributes(5) for descriptions of the following attributes:
73
74
75
76
77       ┌─────────────────────────────┬─────────────────────────────┐
78       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
79       ├─────────────────────────────┼─────────────────────────────┤
80       │Interface Stability          │Standard: ANSI  INCITS  412  │
81       │                             │Multipath Management API     │
82       ├─────────────────────────────┼─────────────────────────────┤
83       │MT-Level                     │Safe                         │
84       └─────────────────────────────┴─────────────────────────────┘
85

SEE ALSO

87       libMPAPI(3LIB), MP_GetMPLogicalUnitProperties(3MPAPI), attributes(5)
88
89
90       Multipath Management API Version 1.0
91
92
93
94SunOS 5.11                        15 Feb 2006 MP_GetMPLuOidListFromTPG(3MPAPI)
Impressum