Manual Pages for UNIX Operating System command usage for man MP_GetInitiatorPortOidList

Common Multipath Management Library Functions
                               MP_GetInitiatorPortOidList(3MPAPI)



NAME
     MP_GetInitiatorPortOidList - gets a list of the object IDs

SYNOPSIS
     cc [ flag... ] file... -lMPAPI [ library... ]
     #include 

      MP_STATUS MP_GetInitiatorPortOidList(MP_OID oid,
          MP_OID_LIST **ppList);


PARAMETERS
     oid       The object ID of the plugin.


     ppList    A pointer to a pointer to an object  ID  that  has
               type  MP_OID_LIST  structure.  With  a  successful
               return, this contains a pointer  to  anMP_OID_LIST
               that  contains the object IDs of all the initiator
               ports associated with the specified plugin.


DESCRIPTION
     The MP_GetInitiatorPortOidList() function gets a list of the
     object  IDs  of all the initiator ports associated with this
     plugin. When the caller is finished using the list  it  must
     free the memory used by the list by calling MP_FreeOidList.

RETURN VALUES
     MP_STATUS_INVALID_OBJECT_TYPE

         The oid does not specify any valid object type. This  is
         most  likely  to happen if an uninitialized object ID is
         passed to the API.


     MP_STATUS_INVALID_PARAMETER

         The pplist is null or specifies a memory area  to  which
         data  cannot be written, or when the oid has a type sub-
         field other than MP_OBJECT_TYPE_PLUGIN.


     MP_STATUS_OBJECT_NOT_FOUND

         The oid owner ID or object sequence number  is invalid.


     MP_STATUS_SUCCESS

         The operation is successful.



SunOS 5.11          Last change: 15 Feb 2006                    1






Common Multipath Management Library Functions
                               MP_GetInitiatorPortOidList(3MPAPI)



     MP_STATUS_INSUFFICIENT_MEMORY

         A memory allocation failure occurred.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ________________________________________________________________________
    |       ATTRIBUTE TYPE        |             ATTRIBUTE VALUE             |
    |_____________________________|_________________________________________|
    | Interface Stability         | Committed                               |
    |_____________________________|_________________________________________|
    | MT-Level                    | Safe                                    |
    |_____________________________|_________________________________________|
    | Standard                    | ANSI INCITS 412 Multipath Management API|
    |_____________________________|_________________________________________|


SEE ALSO
     libMPAPI(3LIB),       MP_GetInitiatorPortProperties(3MPAPI),
     attributes(5)


     Multipath Management API Version 1.0


























SunOS 5.11          Last change: 15 Feb 2006                    2






Common Multipath Management Library Functions
                               MP_GetInitiatorPortOidList(3MPAPI)






















































SunOS 5.11          Last change: 15 Feb 2006                    3