1MP_AssignLogicalUnCiotmTmooTnPGM(u3lMtPiApPaIt)h Management LMiPb_rAasrsyigFnuLnocgtiicoanlsUnitToTPG(3MPAPI)
2
3
4
6 MP_AssignLogicalUnitToTPG - assign a multipath logical unit to a target
7 port group
8
10 cc [ flag... ] file... -lMPAPI [ library... ]
11 #include <mpapi.h>
12
13 MP_STATUS MP_AssignLogicalUnitToTPG(MP_OID tpgOid, MP_OID luOid);
14
15
17 tpgOid An object ID that has type MP_TARGET_PORT_GROUP. The target
18 port group currently in active access state that the adminis‐
19 trator would like the LU assigned to.
20
21
22 luOid An object ID that has type MP_MULTIPATH_LOGICAL_UNIT.
23
24
26 The MP_AssignLogicalUnitToTPG() function assigns a multipath logical
27 unit to a target port group.
28
29
30 Calling this function is valid only if the field supportsLuAssignment
31 in the data structure TARGET_PORT_GROUP_PROPERTIES is true. This capa‐
32 bility is not defined in SCSI standards. In some cases, devices support
33 this capability through non-SCSI interfaces (such as SMI-S or SNMP).
34 This method is only used when devices support this capability through
35 vendor-specific means.
36
37
38 At any given time, each LU will typically be associated with two target
39 port groups, one in active state and one in standby state. The result
40 of this API will be that the LU associations change to a different pair
41 of target port groups. The caller should specify the object ID of the
42 desired target port group in active access state.
43
45 MP_STATUS_INVALID_OBJECT_TYPE
46
47 The tpgOid or luOid parameter does not specify any valid object
48 type. This is most likely to happen if an uninitialized object ID
49 is passed to the API.
50
51
52 MP_STATUS_INVALID_PARAMETER
53
54 The tpgOid parameter has a type subfield other than
55 MP_OBJECT_TYPE_TARGET_PORT_GROUP or luOid has a type subfield other
56 than MP_OBJECT_TYPE_MULTIPATH_LU.
57
58
59 MP_STATUS_OBJECT_NOT_FOUND
60
61 The tpgOid or luOid owner ID or object sequence number is invalid.
62
63
64 MP_STATUS_UNSUPPORTED
65
66 The API is not supported.
67
68
69 MP_STATUS_SUCCESS
70
71 The operation is successful.
72
73
75 See attributes(5) for descriptions of the following attributes:
76
77
78
79
80 ┌─────────────────────────────┬─────────────────────────────┐
81 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
82 ├─────────────────────────────┼─────────────────────────────┤
83 │Interface Stability │Standard: ANSI INCITS 412 │
84 │ │Multipath Management API │
85 ├─────────────────────────────┼─────────────────────────────┤
86 │MT-Level │Safe │
87 └─────────────────────────────┴─────────────────────────────┘
88
90 libMPAPI(3LIB), MP_GetAssociatedTPGOidList(3MPAPI), MP_GetMPLuOidList‐
91 FromTPG(3MPAPI), attributes(5)
92
93
94
95SunOS 5.11 15 Feb 2006MP_AssignLogicalUnitToTPG(3MPAPI)