/******************************************************************************
*
* Description
* mpapi.c - Implements Multipath Management API Version 1.0
*
* License:
* The contents of this file are subject to the SNIA Public License
* Version 1.1 (the "License"); you may not use this file except in
* compliance with the License. You may obtain a copy of the License at
*
*
* Software distributed under the License is distributed on an "AS IS"
* basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
* the License for the specific language governing rights and limitations
* under the License.
*
* The Original Code is SNIA iSCSI Management API and Multipath Management
* API header files.
*
* The Initial Developer of the Original Code is:
* Benjamin F. Kuo Troika Networks, Inc. (benk@troikanetworks.com)
* David Dillard VERITAS Software(david.dillard@veritas.com)
* Jeff Ding Adaptec, Inc. (jding@corp.adaptec.com)
* Hyon Kim Sun Microsystems(hyon.kim@sun.com)
*
* Contributor(s):
* Paul von Behren Sun Microsystems(paul.vonbehren@sun.com)
*
******************************************************************************
*
* Changes:
* 1/15/2005 Implemented SNIA MP API specification 1.0
* 10/11/2005
* - License location was specified in the header comment.
* - validate_object() routine was updated per the latest
* specification.
* - is_zero_oid() routine was added.
* - MP_GetObjectType() was updated with validate_object().
* - pplist argument checking added in MP_GetMultipathLus().
* - Corrected typo in MP_GetTaregetPortGroupProperties()
* - MP_RegisterForObjectPropertyChanges() was updated with
* is_zero_oid() routine.
* - MP_DeregisterForObjectPropertyChanges() was updated with
* is_zero_oid() routine.
* - MP_RegisterForObjectVisibilityChanges() was updated with
* is_zero_oid() routine.
* - MP_DeregisterForObjectVisibilityChanges() was updated with
* is_zero_oid() routine.
* - Added stat() check in MP_RegisterPlugin() to validate the
* the given plugin file name.
* - Made MP_DeregisterPlugin() return MP_STATUS_UNKNOWN_FN
* to mach the specification description.
******************************************************************************
*/
#include <dlfcn.h>
#include <stdarg.h>
#include <unistd.h>
#include <errno.h>
#include <stdio.h>
#include <fcntl.h>
#include <time.h>
#include <pthread.h>
#include "mpapi.h"
#include "mpapi-sun.h"
#include "mpapi-plugin.h"
void InitLibrary();
void ExitLibrary();
static int is_zero_oid(MP_OID);
/**
******************************************************************************
*
* Validate the oid.
*
* - Return MP_STATUS_OBJECT_NOT_FOUND when no plugin is found or the ownerId
* of input OID is not found.
* - Return MP_STATUS_INVALID_OBJECT_TYPE when no plugin is found or
* the type of input OID is not one of legitimate types defined SNIA
* Multipath Management spec.
* - Return MP_STATUS_INVALID_PARAMETER when the type of input OID is
* legitimate but its object type doesn't match with the object type
* argument.
* - Otherwise return MP_STATUS_SUCCESS.
*
******************************************************************************
*/
{
if ((number_of_plugins == 0) ||
return (MP_STATUS_OBJECT_NOT_FOUND);
return (MP_STATUS_INVALID_OBJECT_TYPE);
if (obj.objectSequenceNumber != 0) {
return (MP_STATUS_OBJECT_NOT_FOUND);
}
}
if (flag == MP_OBJECT_TYPE_MATCH) {
return (MP_STATUS_INVALID_PARAMETER);
}
}
return (MP_STATUS_SUCCESS);
}
/**
******************************************************************************
*
* Check if an oid is ZERO_OID or not.
*
* - Return 1 if the input OID is ZERO_OID
*
* - Return 0 if not.
*
******************************************************************************
*/
{
(oid.objectSequenceNumber != 0)) {
return (0);
}
return (1);
}
/**
******************************************************************************
*
* Initialize by loading plugin libraries and calling Initialize routine.
* Note: The build of libMPAPI.so should include a linker option to make this
* routine executed when it is loaded.
*
* - This routine bypasses a plugin library if it is not found.
* - The implementation of this routine is based on configuration file
* /etc/mpapi.conf that contains a list of plugin libraries.
*
******************************************************************************
*/
void InitLibrary()
{
int fd_mpconf;
MP_UINT32 i = 0; /* index for plugin table */
if(number_of_plugins != -1) {
return;
}
(void) pthread_mutex_lock(&mp_lib_mutex);
number_of_plugins = 0;
/* Open configuration file from known location */
(void) pthread_mutex_unlock(&mp_lib_mutex);
return;
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return;
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return;
}
/* Read in each line and load library */
/* Take out the '\n' */
*charPtr = L'\0';
/* remove leading blank or taps. */
charPtr++;
/*
* look for first tab or space.
*/
/* Set Null termination for library name if found */
*charPtr++ = L'\0';
/* Skip space and tab until the next character found */
charPtr++;
} else {
continue; /* May be invalid entry */
}
/* Copy library name and path */
/*
* Continue to the next line if library name or path is
* invalid
*/
continue;
/* Load the plugin now */
} else {
continue;
}
PassFunc = (InitializeFn)
}
i++;
}
}
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return;
}
number_of_plugins = i;
(void) pthread_mutex_unlock(&mp_lib_mutex);
}
/**
******************************************************************************
*
* Exit by calling Terminate routine of plugin libraries.
*
* Note: The build of libMPAPI.so should include a linker option to make this
* routine executed when it is unloaded.
*
******************************************************************************
*/
void ExitLibrary()
{
MP_UINT32 i, j;
if(number_of_plugins == -1)
return;
(void) pthread_mutex_lock(&mp_lib_mutex);
for (i = 0; i < number_of_plugins; i++) {
if (ExitPassFunc != NULL) {
ExitPassFunc();
}
/* Unload plugin from memory */
}
}
number_of_plugins = -1;
(void) pthread_mutex_unlock(&mp_lib_mutex);
(void) pthread_mutex_destroy(&mp_lib_mutex);
}
/**
******************************************************************************
*
* Gets the properties of the MP API library that is being used.
*
* @param pProps
* A pointer to an @ref MP_LIBRARY_PROPERTIES structure allocated by
* the caller. On successful return this structure will contain the
* properties of the MP library.
*
* @return An MP_STATUS indicating if the operation was successful or
* if an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned if the library properties were successfully returned.
*
* @retval MP_STATUS_INVALID_PARAMETER Returned if @a pProps is NULL or
* specifies a memory area to which data cannot be written.
*
******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
}
/* Fill in properties */
strlen(BUILD_TIME)) {
return (MP_STATUS_INVALID_PARAMETER);
}
return MP_STATUS_SUCCESS;
}
/**
******************************************************************************
*
* Gets a list of the object IDs of all currently loaded plugins.
*
* @param ppList A pointer to a pointer to an @ref MP_OID_LIST. On successful
* return this will contain a pointer to an @ref MP_OID_LIST
* which contains the object IDs of all of the plugins currently loaded
* by the library.
* @return An MP_STATUS indicating if the operation was successful or if
* an error
* occurred.
* @retval MP_SUCCESS Returned if the plugin ID list was successfully returned.
* @retval MP_STATUS_INVALID_PARAMETER Returned if @a ppList is NULL or
* specifies a memory area to which data cannot be written.
*
******************************************************************************
*/
{
MP_UINT32 i;
return (MP_STATUS_INVALID_PARAMETER);
(void) pthread_mutex_lock(&mp_lib_mutex);
if (number_of_plugins == 0) {
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (MP_STATUS_INSUFFICIENT_MEMORY);
}
if (number_of_plugins != 0) {
for (i = 0; i < number_of_plugins; i++) {
}
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return MP_STATUS_SUCCESS;
}
/**
*******************************************************************************
*
* Gets the properties of the specified vendor plugin.
*
* @param oid
* The ID of the plugin whose properties are being retrieved.
*
* @param pProps
* A pointer to an @ref MP_PLUGIN_PROPERTIES structure allocated by
* the caller. On successful return this will contain the properties
* of the plugin specified by pluginOid.
*
* @return An MP_STATUS indicating if the operation was successful or if an
* error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned if the plugin properties were successfully returned.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned if oid has an owner that is not currently known to
* the system.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if 'pProps' is NULL or specifies a memory area to
* which data cannot be written.
*
*******************************************************************************
*/
{
return (MP_STATUS_INVALID_PARAMETER);
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return status;
}
/**
*******************************************************************************
*
* Gets the object ID for the plugin associated with the specified object ID.
*
* @param oid
* The object ID of an object that has been received from a previous
* library call.
*
* @param pPluginOid
* A pointer to an MP_OID structure allocated by the caller. On
* successful return this will contain the object ID of the plugin
* associated with the object specified by @a objectId.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned if the associated plugin ID was successfully returned.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned if oid does not specify a plugin that is currently known to
* the system.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if 'oid' specifies an object not owned by a plugin or
* if pPluginOid is NULL or specifies a memory area to which data
* cannot be written.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if 'oid' specifies an object with an invalid type.
*
*******************************************************************************
*/
{
MP_UINT32 i;
return (MP_STATUS_INVALID_PARAMETER);
return (status);
}
return (MP_STATUS_SUCCESS);
}
/**
*******************************************************************************
*
* Gets the object type of an initialized object ID.
*
* @param oid
* The object ID of an object that has been received from a previous
* library call.
*
* @param pObjectType
* A pointer to an MP_OBJECT_TYPE variable allocated by the caller.
* On successful return this will contain the object type of oid.
*
* @return An MP_STATUS indicating if the operation was successful or
* if an error occurred.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned if oid has an owner that is not currently known to
* the system.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
*******************************************************************************
*/
{
if (pObjectType == NULL)
return MP_STATUS_INVALID_PARAMETER;
!= MP_STATUS_SUCCESS) {
return (status);
}
return MP_STATUS_SUCCESS;
}
/**
*******************************************************************************
*
* Gets a list of the object IDs of all the device product properties
* associated with this plugin.
*
* @param oid
* The object ID of plugin.
*
* @param ppList
* A pointer to a pointer to an MP_OID_LIST structure.
* On a successful return, this will contain a pointer to
* an MP_OID_LIST that contains the object IDs of all the device
* product descriptors associated with the specified plugin.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if ppList pointer passed as placeholder for holding
* the device product list is found to be invalid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_FAILED
* Returned when the plugin for the specified oid is not found.
*
* @retval MP_STATUS_INSUFFICIENT_MEMORY
* Returned when memory allocation failure occurs
*
* @retval MP_STATUS_UNSUPPORTED
* Returned when the API is not supported.
*
*******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_GetDeviceProductOidListPlugin");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return status;
}
/**
*******************************************************************************
*
* Gets the device product properties of the specified plugin oid.
*
* @param oid
* The object ID of the plugin.
*
* @param ppProps
* A pointer to a pointer to an MP_DEVICE_PRODUCT_PROPERTIES structure
* allocated by the caller. On successful return it will contain
* a pointer to an MP_DEVICE_PRODUCT_PROPERTIES structure allocated
* by the library.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if ppProps pointer passed as placeholder for holding
* the device product properties is found to be invalid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_FAILED
* Returned when the plugin for the specified oid is not found.
*
* @retval MP_STATUS_INSUFFICIENT_MEMORY
* Returned when memory allocation failure occurs
*
* @retval MP_STATUS_UNSUPPORTED
* Returned when the API is not supported.
*
*******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_GetDeviceProductProperties");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return status;
}
/**
*******************************************************************************
*
* Gets a list of the object IDs of all the initiator ports associated
* with this plugin.
*
* @param oid
* The object ID of plugin.
*
* @param ppList
* A pointer to a pointer to an MP_OID_LIST structure.
* On a successful return, this will contain a pointer to
* an MP_OID_LIST that contains the object IDs of all the initiator
* ports associated with the specified plugin.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if ppList pointer passed as placeholder for holding
* the initiator port list is found to be invalid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_FAILED
* Returned when the plugin for the specified oid is not found.
*
* @retval MP_STATUS_INSUFFICIENT_MEMORY
* Returned when memory allocation failure occurs
*
* @retval MP_STATUS_UNSUPPORTED
* Returned when the API is not supported.
*
*******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Gets the properties of the specified initiator port.
*
* @param oid
* The object ID of the initiator port.
*
* @param pProps
* A pointer to an MP_INITIATOR_PORT_PROPERTIES structure
* allocated by the caller. On successful return, this structure
* will contain the properties of the port specified by oid.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if pProps is NULL or specifies a memory area to
* which data cannot be written.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned if oid has an owner that is not currently known to
* the system.
*
*******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_GetInitiatorPortProperties");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return status;
}
/**
*******************************************************************************
*
* Gets a list of multipath logical units associated to a plugin.
*
* @param oid
* The object ID of plugin.
*
* @param ppList
* A pointer to a pointer to an MP_OID_LIST structure.
* On a successful return, this will contain a pointer to
* an MP_OID_LIST that contains the object IDs of all the multipath
* logical units associated with the specified plugin.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if ppList pointer passed as placeholder for holding
* the multipath logical unit list is found to be invalid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_FAILED
* Returned when the plugin for the specified oid is not found.
*
* @retval MP_STATUS_INSUFFICIENT_MEMORY
* Returned when memory allocation failure occurs
*
* @retval MP_STATUS_UNSUPPORTED
* Returned when the API is not supported.
*
*******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS) &&
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS)) {
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_GetMultipathLusPlugin");
} else {
}
"MP_GetMultipathLusDevProd");
} else {
}
} else {
}
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Gets the properties of the specified logical unit.
*
* @param oid
* The object ID of the multipath logical unit.
*
* @param pProps
* A pointer to an MP_MULTIPATH_LOGICAL_UNIT_PROPERTIES structure
* allocated by the caller. On successful return, this structure
* will contain the properties of the port specified by oid.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if pProps is NULL or specifies a memory area to
* which data cannot be written.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned if oid has an owner that is not currently known to
* the system.
*
*******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_GetMPLogicalUnitProperties");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Gets a list of the object IDs of all the path logical units associated
* with the specified multipath logical unit, initiator port, or target port.
*
* @param oid
* The object ID of multipath logical unit, initiator port, or
* target port.
*
* @param ppList
* A pointer to a pointer to an MP_OID_LIST structure.
* On a successful return, this will contain a pointer to
* an MP_OID_LIST that contains the object IDs of all the mp path
* logical units associated with the specified OID.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if ppList pointer passed as placeholder for holding
* the device product list is found to be invalid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_FAILED
* Returned when the plugin for the specified oid is not found.
*
* @retval MP_STATUS_INSUFFICIENT_MEMORY
* Returned when memory allocation failure occurs
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned if oid has an owner that is not currently known to
* the system.
*
*******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS) &&
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS) &&
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS)) {
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_GetAssociatedPathOidList");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Gets the properties of the specified path logical unit.
*
* @param oid
* The object ID of the path logical unit.
*
* @param pProps
* A pointer to an MP_PATH_LOGICAL_UNIT_PROPERTIES structure
* allocated by the caller. On successful return, this structure
* will contain the properties of the port specified by oid.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if pProps is NULL or specifies a memory area to
* which data cannot be written.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned if oid has an owner that is not currently known to
* the system.
*
*******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_GetPathLogicalUnitProperties");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Gets a list of the object IDs of all the target port group associated
* with the specified multipath logical unit.
*
* @param oid
* The object ID of the multiple logical unit.
*
* @param ppList
* A pointer to a pointer to an MP_OID_LIST structure.
* On a successful return, this will contain a pointer to
* an MP_OID_LIST that contains the object IDs of all the target
* port group associated with the specified multipath logical unit.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if ppList pointer passed as placeholder for holding
* the target port group list is found to be invalid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_FAILED
* Returned when the plugin for the specified oid is not found.
*
* @retval MP_STATUS_INSUFFICIENT_MEMORY
* Returned when memory allocation failure occurs
*
*
*******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_GetAssociatedTPGOidList");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Gets the properties of the specified target port group.
*
* @param oid
* The object ID of the target port group.
*
* @param pProps
* A pointer to an MP_TARGET_PORT_GROUP_PROPERTIES structure
* allocated by the caller. On successful return, this structure
* will contain the properties of the port specified by oid.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if pProps is NULL or specifies a memory area to
* which data cannot be written.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned if oid has an owner that is not currently known to
* the system.
*
*******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_GetTargetPortGroupProperties");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Gets a list of multipath logical units associated with the specific target
* port group.
*
* @param oid
* The object ID of the target port group.
*
* @param ppList
* A pointer to a pointer to an MP_OID_LIST structure.
* On a successful return, this will contain a pointer to
* an MP_OID_LIST that contains the object IDs of all the multipath
* logical units associated with the specified target port group.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if ppList pointer passed as placeholder for holding
* the multipath logical unit list is found to be invalid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_FAILED
* Returned when the plugin for the specified oid is not found.
*
* @retval MP_STATUS_INSUFFICIENT_MEMORY
* Returned when memory allocation failure occurs
*
*******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_GetMPLuOidListFromTPG");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Gets a list of the object IDs of all the proprietary load balance
* algorithms associated with this plugin.
*
* @param oid
* The object ID of the plugin.
*
* @param ppList
* A pointer to a pointer to an MP_OID_LIST structure.
* On a successful return, this will contain a pointer to
* an MP_OID_LIST that contains the object IDs of all the proprietary
* load balance algorithms associated with the specified plugin.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if ppList pointer passed as placeholder for holding
* the proprietary load balance oid list is found to be invalid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_FAILED
* Returned when the plugin for the specified oid is not found.
*
* @retval MP_STATUS_INSUFFICIENT_MEMORY
* Returned when memory allocation failure occurs
*
* @retval MP_STATUS_UNSUPPORTED
* Returned when the API is not supported.
*
*******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_GetProprietaryLoadBalanceOidListPlugin");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Gets the properties of the specified load balance properties structure.
*
* @param oid
* The object ID of the load balance properties structure.
*
* @param pProps
* A pointer to an MP_LOAD_BALANCE_PROPRIETARY_TYPE structure
* allocated by the caller. On successful return, this structure
* will contain the properties of the proprietary load balance algorithm
* specified by oid.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if pProps is NULL or specifies a memory area to
* which data cannot be written.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned if oid has an owner that is not currently known to
* the system.
*
*******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_GetProprietaryLoadBalanceProperties");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Gets a list of the object IDs of the target ports in the specified target
* port group.
*
* @param oid
* The object ID of the target port group.
*
* @param ppList
* A pointer to a pointer to an MP_OID_LIST structure.
* On a successful return, this will contain a pointer to
* an MP_OID_LIST that contains the object IDs of all the target ports
* associated with the specified target port group.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if ppList pointer passed as placeholder for holding
* the multipath logical unit list is found to be invalid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_FAILED
* Returned when the plugin for the specified oid is not found.
*
* @retval MP_STATUS_INSUFFICIENT_MEMORY
* Returned when memory allocation failure occurs
*
*******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_GetTargetPortOidList");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Gets the properties of the specified target port.
*
* @param oid
* The object ID of the target port.
*
* @param pProps
* A pointer to an MP_TARGET_PORT_PROPERTIES structure
* allocated by the caller. On successful return, this structure
* will contain the properties of the port specified by oid.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if pProps is NULL or specifies a memory area to
* which data cannot be written.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned if oid has an owner that is not currently known to
* the system.
*
*******************************************************************************
*/
{
return MP_STATUS_INVALID_PARAMETER;
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_GetTargetPortProperties");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Assign a multipath logical unit to a target port group.
*
* @param tpgOid
* An MP_TARGET_PORT_GROUP oid. The target port group currently in
* active access state that the administrator would like the LU
* assigned to.
*
* @param luOid
* An MP_MULTIPATH_LOGICAL_UNIT oid.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned when luOid is not associated with tpgOid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned if oid has an owner that is not currently known to
* the system.
*
*******************************************************************************
*/
{
return (MP_STATUS_INVALID_PARAMETER);
}
return (status);
}
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_AssignLogicalUnitToTPG");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Manually override the path for a logical unit. The path exclusively used to
* access the logical unit until cleared.
*
* @param logicalUnitOid
* The object ID of the multipath logical unit.
*
* @param pathOid
* The object ID of the path logical unit.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if the oid of the object is not valid
*
* @retval MP_STATUS_UNSUPPORTED
* Returned when the implementation does not support the API
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_PATH_NONOPERATIONAL
* Returned when the driver cannot communicate through selected path.
*
*******************************************************************************
*/
{
return (status);
}
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_SetOverridePath");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Cancel a path override and re-enable load balancing.
*
* @param luOid
* An MP_MULTIPATH_LOGICAL_UNIT oid.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if MP_MULTIPATH_LOGICAL_UNIT with the luOid is not found.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned if oid has an owner that is not currently known to
* the system.
*
*******************************************************************************
*/
{
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_CancelOverridePath");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Enables Auto-failback.
*
* @param oid
* The oid of the plugin.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if oid is NULL or specifies a memory area that is not
* a valid plugin oid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
*******************************************************************************
*/
{
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS) &&
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS)) {
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_EnableAutoFailbackPlugin");
} else {
}
"MP_EnableAutoFailbackLu");
} else {
}
} else {
}
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Enables Auto-probing.
*
* @param oid
* The oid of the plugin or the multipath logical unit.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if oid is NULL or specifies a memory area that is not
* a valid plugin oid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
*******************************************************************************
*/
{
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS) &&
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS)) {
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_EnableAutoProbingPlugin");
} else {
}
"MP_EnableAutoProbingLu");
} else {
}
} else {
}
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Disables Auto-failback.
*
* @param oid
* The oid of the plugin.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if oid is NULL or specifies a memory area that is not
* a valid plugin oid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
*******************************************************************************
*/
{
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS) &&
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS)) {
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_DisableAutoFailbackPlugin");
} else {
}
"MP_DisableAutoFailbackLu");
} else {
}
} else {
}
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Disables Auto-probing.
*
* @param oid
* The oid of the plugin or the multipath logical unit.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if oid is NULL or specifies a memory area that is not
* a valid plugin oid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
*******************************************************************************
*/
{
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS) &&
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS)) {
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_DisableAutoProbingPlugin");
} else {
}
"MP_DisableAutoProbingLu");
} else {
}
} else {
}
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Enables a path. This API may cause failover in a logical unit with
* asymmetric access.
*
* @param oid
* The oid of the path.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if oid is NULL or specifies a memory area that is not
* a valid path oid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
*******************************************************************************
*/
{
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_EnablePath");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Disables a path. This API may cause failover in a logical unit with
* asymmetric access. This API may cause a logical unit to become unavailable.
*
* @param oid
* The oid of the path.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if oid is NULL or specifies a memory area that is not
* a valid path oid.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
*******************************************************************************
*/
{
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_DisablePath");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Set the multipath logical unit s load balancing policy.
*
* @param logicalUnitoid
* The object ID of the multipath logical unit.
*
* @param loadBanlance
* The desired load balance policy for the specified logical unit.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if no MP_MULTIPATH_LOGICAL_UNIT associated with
* @ref ligicalUnitrOid is found or invalid MP_LOAD_BALANCE_TYPE is
* specified.
*
* @retval MP_STATUS_FAILED
* Returned when the specified loadBalance type cannot be handled
* by the plugin.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
*******************************************************************************
*/
{
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_SetLogicalUnitLoadBalanceType");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Set the weight to be assigned to a particular path.
*
* @param pathOid
* The object ID of the path logical unit.
*
* @param weight
* weight that will be assigned to the path logical unit.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned when the MP Path specified by the PathOid could not be
* found.
*
* @retval MP_STATUS_UNSUPPORTED
* Returned when the implementation does not support the API
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_FAILED
* Returned when the operation failed.
*
* @retval MP_STATUS_PATH_NONOPERATIONAL
* Returned when the driver cannot communicate through selected path.
*
* @retval MP_STATUS_INVALID_WEIGHT
* Returned when the weight parameter is greater than the plugin's
* maxWeight property.
*
*******************************************************************************
*/
{
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_SetPathWeight");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Set the default load balance policy for the plugin.
*
* @param oid
* The object ID of the plugin
*
* @param loadBalance
* The desired default load balance policy for the specified plugin.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned when the the plugin specified by @ref oid could not be
* found.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if the oid of the object is not valid.
*
* @retval MP_STATUS_UNSUPPORTED
* Returned when the implementation does not support the API
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_FAILED
* Returned when the specified loadBalance type cannot be handled
* by the plugin.
*
*******************************************************************************
*/
{
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_SetPluginLoadBalanceTypePlugin");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Set the failback polling rates. Setting both rates to zero disables polling.
*
* @param pluginOid
* The object ID of the plugin or multipath lu.
*
* @param pollingRate
* The value to be set in MP_PLUGIN_PROPERTIES currentPollingRate.or
* MP_MULTIPATH_LOGICAL_UNIT_PROPERTIES pollingRate.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned when the the plugin specified by @ref oid could not be
* found.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if one of the polling values is outside the range
* supported by the driver.
*
* @retval MP_STATUS_UNSUPPORTED
* Returned when the implementation does not support the API
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
*******************************************************************************
*/
{
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS) &&
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS)) {
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_SetFailbackPollingRatePlugin");
} else {
}
"MP_SetFailbackPollingRateLu");
} else {
}
} else {
}
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Set the probing polling rates. Setting both rates to zero disables polling.
*
* @param pluginOid
* The object ID of either the plugin or a multipath logical unit.
*
* @param pollingRate
* The value to be set in MP_PLUGIN_PROPERTIES current pollingRate or
* MP_MULTIPATH_LOGICAL_UNIT_PROPERTIES pollingRate.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned when the the plugin specified by @ref oid could not be
* found.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if one of the polling values is outside the range
* supported by the driver.
*
* @retval MP_STATUS_UNSUPPORTED
* Returned when the implementation does not support the API
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
*******************************************************************************
*/
{
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS) &&
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS)) {
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_SetProbingPollingRatePlugin");
} else {
}
"MP_SetProbingPollingRateLu");
} else {
}
} else {
}
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Set proprietary properties in supported object instances.
*
* @param pluginOid
* The object ID of MP_LOAD_BALANCE_PROPRIETARY_TYPE, MP_PLUGIN_PROPERTIES
* or MP_MULTIPATH_LOGICAL_UNIT_PROPERTIES.
*
* @param count
* The number of valid items in pPropertyList.
*
* @param pPropertyList
* contain the same number of elements as count.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned when the the plugin specified by @ref oid could not be
* found.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if one of the polling values is outside the range
* supported by the driver.
*
* @retval MP_STATUS_UNSUPPORTED
* Returned when the implementation does not support the API
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
*******************************************************************************
*/
{
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS) &&
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS) &&
MP_OBJECT_TYPE_MATCH)) != MP_STATUS_SUCCESS)) {
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_SetProprietaryProperties");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Set the access state for a list of target port groups. This allows
* a client to force a failover or failback to a desired set of target port
* groups.
*
* @param luOid
* The object ID of the logical unit where the command is sent.
*
* @param count
* The number of valid items in the pTpgStateList.
*
* @param pTpgStateList
* A pointer to an array of TPG/access-state values. This array must
* contain the same number of elements as @ref count.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_OBJECT_NOT_FOUND
* Returned when the MP_MULTIPATH_LOGICAL_UNIT associated with @ref
* oid could not be found.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if pTpgStateList is null or if one of the TPGs referenced
* in the list is not associated with the specified MP logical unit.
*
* @retval MP_STATUS_UNSUPPORTED
* Returned when the implementation does not support the API
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_ACCESS_STATE_INVALID
* Returned if the target device returns a status indicating the caller
* is attempting to establish an illegal combination of access states.
*
* @retval MP_STATUS_FAILED
* Returned if the underlying interface failed the commend for some
* reason other than MP_STATUS_ACCESS_STATE_INVALID
*
*******************************************************************************
*/
{
return (status);
}
(void) pthread_mutex_lock(&mp_lib_mutex);
"MP_SetTPGAccess");
} else {
}
} else {
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Registers a client function that is to be called
* whenever the property of an an object changes.
*
* @param pClientFn,
* A pointer to an MP_OBJECT_PROPERTY_FN function defined by the
* client. On successful return this function will be called to
* inform the client of objects that have had one or more properties
* change.
*
* @param objectType
* The type of object the client wishes to deregister for
* property change callbacks. If null, then all objects types are
* deregistered.
*
* @param pCallerData
* A pointer that is passed to the callback routine with each event.
* This may be used by the caller to correlate the event to source of
* the registration.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if pClientFn is NULL or specifies a memory area
* that is not executable.
*
* @retval MP_STATUS_FN_REPLACED
* Returned when an existing client function is replaced with the one
* specified in pClientFn.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
*******************************************************************************
*/
void *pCallerData,
{
MP_UINT32 i;
return (MP_STATUS_INVALID_PARAMETER);
}
if (objectType > MP_OBJECT_TYPE_MAX) {
return (MP_STATUS_INVALID_OBJECT_TYPE);
}
if (!(is_zero_oid(pluginOid))) {
return (status);
}
}
(void) pthread_mutex_lock(&mp_lib_mutex);
if (is_zero_oid(pluginOid)) {
for (i = 0; i < number_of_plugins; i++) {
"MP_RegisterForObjectPropertyChangesPlugin");
}
status =
/* ignore an error and continue */
}
}
} else {
"MP_RegisterForObjectPropertyChangesPlugin");
}
}
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Deregisters a previously registered client function that is to be invoked
* whenever an object's property changes.
*
* @param pClientFn,
* A pointer to an MP_OBJECT_PROPERTY_FN function defined by the
* client that was previously registered using
* the MP_RegisterForObjectPropertyChanges API. On successful return
* this function will no longer be called to inform the client of
* object property changes.
*
* @param objectType
* The type of object the client wishes to deregister for
* property change callbacks. If null, then all objects types are
* deregistered.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if pClientFn is NULL or specifies a memory area
* that is not executable.
*
* @retval MP_STATUS_UNKNOWN_FN
* Returned if pClientFn is not the same as the previously registered
* function.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if oid does not specify any valid object type.
*
* @retval MP_STATUS_FAILED
* Returned if pClientFn deregistration is not possible at this time.
*
*******************************************************************************
*/
{
MP_UINT32 i;
return (MP_STATUS_INVALID_PARAMETER);
}
if (objectType > MP_OBJECT_TYPE_MAX) {
return (MP_STATUS_INVALID_OBJECT_TYPE);
}
if (!(is_zero_oid(pluginOid))) {
return (status);
}
}
(void) pthread_mutex_lock(&mp_lib_mutex);
if (is_zero_oid(pluginOid)) {
for (i = 0; i < number_of_plugins; i++) {
"MP_DeregisterForObjectPropertyChangesPlugin");
}
}
}
} else {
"MP_DeregisterForObjectPropertyChangesPlugin");
}
}
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Registers a client function that is to be called
* whenever a high level object appears or disappears.
*
* @param pClientFn,
* A pointer to an MP_OBJECT_VISIBILITY_FN function defined by the
* client. On successful return this function will be called to
* inform the client of objects whose visibility has changed.
*
* @param objectType
* The type of object the client wishes to deregister for
* property change callbacks. If null, then all objects types are
* deregistered.
*
* @param pCallerData
* A pointer that is passed to the callback routine with each event.
* This may be used by the caller to correlate the event to source of
* the registration.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if pClientFn is NULL or specifies a memory area
* that is not executable.
*
* @retval MP_STATUS_FN_REPLACED
* Returned when an existing client function is replaced with the one
* specified in pClientFn.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if objectType does not specify any valid object type.
*
*******************************************************************************
*/
void *pCallerData,
{
MP_UINT32 i;
return (MP_STATUS_INVALID_PARAMETER);
}
if (objectType > MP_OBJECT_TYPE_MAX) {
return (MP_STATUS_INVALID_OBJECT_TYPE);
}
if (!(is_zero_oid(pluginOid))) {
return (status);
}
}
(void) pthread_mutex_lock(&mp_lib_mutex);
if (is_zero_oid(pluginOid)) {
for (i = 0; i < number_of_plugins; i++) {
"MP_RegisterForObjectVisibilityChangesPlugin");
}
/* ignore an error and continue. */
}
}
} else {
"MP_RegisterForObjectVisibilityChangesPlugin");
}
}
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Deregisters a previously registered client function that is to be invoked
* whenever a high level object appears or disappears.
*
* @param pClientFn,
* A pointer to an MP_OBJECT_VISIBILITY_FN function defined by the
* client that was previously registered using
* the MP_RegisterForObjectVisibilityChanges API. On successful return
* this function will no longer be called to inform the client of
* object property changes.
*
* @param objectType
* The type of object the client wishes to deregister for visibility
* change callbacks. If null, then all objects types are
* deregistered.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the operation is successful.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if pClientFn is NULL or specifies a memory area
* that is not executable.
*
* @retval MP_STATUS_UNKNOWN_FN
* Returned if pClientFn is not the same as the previously registered
* function.
*
* @retval MP_STATUS_INVALID_OBJECT_TYPE
* Returned if objectType does not specify any valid object type.
*
* @retval MP_STATUS_FAILED
* Returned if pClientFn deregistration is not possible at this time.
*
*******************************************************************************
*/
{
MP_UINT32 i;
return (MP_STATUS_INVALID_PARAMETER);
}
if (objectType > MP_OBJECT_TYPE_MAX) {
return (MP_STATUS_INVALID_OBJECT_TYPE);
}
if (!(is_zero_oid(pluginOid))) {
return (status);
}
}
(void) pthread_mutex_lock(&mp_lib_mutex);
if (is_zero_oid(pluginOid)) {
for (i = 0; i < number_of_plugins; i++) {
"MP_DeregisterForObjectVisibilityChangesPlugin");
}
}
}
} else {
"MP_DeregisterForObjectVisibilityChangesPlugin");
}
}
}
(void) pthread_mutex_unlock(&mp_lib_mutex);
return (status);
}
/**
*******************************************************************************
*
* Compare two Oids for equality to see whether they refer to the same object.
*
* @param oid1
* Oid to compare.
*
* @param oid2
* Oid to compare.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when the two Oids do refer to the same object.
*
* @retval MP_STATUS_FAILED
* Returned if the Oids don't compare.
*
*******************************************************************************
*/
{
return (MP_STATUS_SUCCESS);
} else {
return (MP_STATUS_FAILED);
}
}
/**
*******************************************************************************
*
* Frees memory returned by an MP API.
*
* @param pOidList
* A pointer to the memory returned by an MP API. On successful
return, the allocated memory is freed.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when pPluginId is deregistered successfully.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if pMemory is NULL or specifies a memory area to which
* data cannot be written.
*
*******************************************************************************
*/
{
return (MP_STATUS_INVALID_PARAMETER);
}
return (MP_STATUS_SUCCESS);
}
"#\n"
"# This file contains names and references to MP API plugin libraries\n"
"#\n"
"# Do NOT manually edit this file\n"
"#\n"
"# Format:\n"
"#\n"
"# <library ID> <library pathname>\n"
"#\n";
return (MP_STATUS_FAILED); \
} \
return (ret)
/*
* This function sets an advisory lock on the file pointed to by the argument
* fd, which is a file descriptor. The lock is set using fcntl() which uses
* flock structure.
*/
static int
{
}
/*
* This function searches for "srch_str" (of length "slen") in "buf" (of length
* "buflen"). If it is not found, "write_offset" has the offset in "buf" where
* "srch_str" would have to be added in "buf". If "srch_str" is found in "buf",
* "write_offset" has its offset in "buf"
*
* ARGUMENTS :
* buf - buffer to search in
* buflen - length of buffer
* srch_id - id to search
* id_len - length of srch_id
* write_offset - Set in function on exit
* - It is the offset in buf where srch_str is or should be
* bytes_left - Set in function on exit
* - It is the # of bytes left beyond write_offset in buf
* RETURN VALUES :
* Zero - "srch_id" found in "buf"... "write_offset" has offset in "buf"
* != 0 - "srch_str" NOT found in "buf" ... "write_offset" points to the end of
* "buf".
*/
static int
int *write_offset, int *bytes_left)
{
*bytes_left = buflen;
*write_offset = 0;
return (-1);
return (0);
/*
* mp conf file should not be edited but takes care of
* any extra white space when parsing the line.
*
* The line should have id + delimiter + name + newline.
*/
/* skip leading blank or space. */
cur_pos++;
}
/* id matched. */
while (*cur_pos != '\n') {
cur_pos++;
}
return (0);
} else {
/* move to the next line */
while (*cur_pos != '\n') {
cur_pos++;
}
}
}
/* Given strings are not found. */
*write_offset = buflen;
return (-1);
}
/**
*******************************************************************************
*
* Registers a plugin with common library. The implementation of this routine
* is based on configuration file /etc/mpapi.conf that contains a list of
* plugin libraries.
*
* @param pPluginId
* A pointer to the key name shall be the reversed domain name of
* the vendor followed by followed by the vendor specific name for
* the plugin that uniquely identifies the plugin. Should be NULL
* terminated.
*
* @param pFileName
* The full path to the plugin library.
* Should be NULL terminated.
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when pPluginId is deregistered successfully.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if pPluginId is NULL or specifies a memory area that
* is not executable.
*
* @retval MP_STATUS_FAILED
* Returned if pClientFn deregistration is not possible at this time.
*
*******************************************************************************
*/
char *pFileName)
{
return (MP_STATUS_INVALID_PARAMETER);
}
return (MP_STATUS_INVALID_PARAMETER);
}
return (MP_STATUS_INVALID_PARAMETER);
}
*fullline = '\0';
/* add tab */
/* add a new line. */
/* Open configuration file from known location */
new_file_flag = 1;
}
return (MP_STATUS_FAILED);
}
return (MP_STATUS_FAILED);
}
return (MP_STATUS_FAILED);
}
}
}
sizeof_conf_hdr) !=
}
}
}
/* found a match. */
} else {
/* append the fullline to the mpconf. */
write_offset) !=
} else {
}
}
}
/**
*******************************************************************************
*
* Deregisters a plugin from the common library. This routine is based on
* configuration file /etc/mpapi.conf that contains a list of plugin libraries.
*
* @param pPluginId
* A pointer to a Plugin ID previously registered using
* the MP_RegisterPlugin API..
*
* @return An MP_STATUS indicating if the operation was successful or if
* an error occurred.
*
* @retval MP_STATUS_SUCCESS
* Returned when pPluginId is deregistered successfully.
*
* @retval MP_STATUS_INVALID_PARAMETER
* Returned if pPluginId is NULL or specifies a memory area that
* is not executable.
*
* @retval MP_STATUS_FAILED
* Returned if pClientFn deregistration is not possible at this time.
*
*******************************************************************************
*/
{
return (MP_STATUS_INVALID_PARAMETER);
}
return (MP_STATUS_INVALID_PARAMETER);
}
/* Open configuration file from known location */
/* no file found */
return (MP_STATUS_UNKNOWN_FN);
}
return (MP_STATUS_FAILED);
}
return (MP_STATUS_FAILED);
}
return (MP_STATUS_FAILED);
}
}
}
}
&write_offset, &bytes_left) != 0) {
} else {
/*
* found a match.
* construct temp file name using pid.
*/
}
}
}
/* rename temp file to mpConfFile before unlock and close. */
} else {
}
}
}