mp_freeoidlist(3mpapi) [opensolaris man page]

MP_FreeOidList(3MPAPI)				   Common Multipath Management Library Functions			    MP_FreeOidList(3MPAPI)

NAME

       MP_FreeOidList - free up memory

SYNOPSIS

       cc [ flag... ] file... -lMPAPI [ library... ]
       #include <mpapi.h>

       MP_STATUS MP_FreeOidList(MP_OID_LIST *pOidList);

PARAMETERS

       pOidList    A pointer to an object ID list returned by an MP API.  With a successful return, the allocated memory is freed.

		   The client will free all MP_OID_LIST structures returned by any API by using this function.

DESCRIPTION

       The MP_FreeOidList() function frees memory returned by an MP API.

RETURN VALUES

       MP_STATUS_INVALID_PARAMETER

	   The pOidList is null or specifies a memory area to which data cannot be written.

       MP_STATUS_SUCCESS

	   The operation is successful.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard:  ANSI  INCITS 412  |
       |			     |Multipath Management API	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       libMPAPI(3LIB), attributes(5)

       Multipath Management API Version 1.0

SunOS 5.11							    15 Feb 2006 					    MP_FreeOidList(3MPAPI)

MP_GetPluginOidList(3MPAPI)			   Common Multipath Management Library Functions		       MP_GetPluginOidList(3MPAPI)

NAME

       MP_GetPluginOidList - get a list of the object IDs

SYNOPSIS

       cc [ flag... ] file... -lMPAPI [ library... ]
       #include <mpapi.h>

       MP_STATUS MP_GetPluginOidList(MP_OID_LIST **ppList);

PARAMETERS

       ppList	 A  pointer to a pointer to an object ID that has type MP_OID_LIST. With a successful return, this contains a pointer to an object
		 ID that has type MP_OID_LIST that contains the object IDs of all of the plugins currently loaded by the library.

DESCRIPTION

       The MP_GetPluginOidList() function returns a list of the object IDs of all currently loaded plugins. The returned list is guaranteed to not
       contain any duplicate entries.

       When the caller is finished using the list it must free the memory used by the list by calling MP_FreeOidList(3MPAPI).

RETURN VALUES

       MP_STATUS_INVALID_PARAMETER

	   The ppList is null or specifies a memory area to which data cannot be written.

       MP_STATUS_SUCCESS

	   The operation is successful.

       MP_STATUS_FAILED

	   The plugin for the specified object ID  is not found.

       MP_STATUS_INSUFFICIENT_MEMORY

	   A memory allocation failure occurred.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard:  ANSI  INCITS 412  |
       |			     |Multipath Management API	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       libMPAPI(3LIB), MP_FreeOidList(3MPAPI), MP_GetPluginProperties(3MPAPI), attributes(5)

       Multipath Management API Version 1.0

SunOS 5.11							    15 Feb 2006 				       MP_GetPluginOidList(3MPAPI)