Solaris_GenericController.c revision 7c478bd95313f5f23a4c958a745db2134aa03244
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License, Version 1.0 only
* (the "License"). You may not use this file except in compliance
* with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* or http://www.opensolaris.org/os/licensing.
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2002 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#pragma ident "%Z%%M% %I% %E% SMI"
#include <unistd.h>
#include <netdb.h>
#include <errno.h>
#include "util.h"
#include "cimKeys.h"
#include "ctrl_descriptors.h"
#include "providerNames.h"
#include "messageStrings.h"
#include "Solaris_GenericController.h"
#define GENERIC_GETINSTANCE "GENERIC_CONTROLLER,GET_INSTANCE"
#define GENERIC_ENUMINSTANCES "GENERIC_CONTROLLER,ENUM_INSTANCES"
#define GENERIC_ENUMINSTANCENAMES "GENERIC_CONTROLLER,ENUM_INSTANCENAMES"
#define GENERIC_CREATEINSTANCE "GENERIC_CONTROLLER,CREATE_INSTANCE"
#define GENERIC_DELETEINSTANCE "GENERIC_CONTROLLER,DELETE_INSTANCE"
#define GENERIC_SETINSTANCE "GENERIC_CONTROLLER,SET_INSTANCE"
#define GENERIC_GETPROPERTY "GENERIC_CONTROLLER,GET_PROPERTY"
#define GENERIC_SETPROPERTY "GENERIC_CONTROLLER,SET_PROPERTY"
#define GENERIC_INVOKEMETHOD "GENERIC_CONTROLLER,INVOKE_METHOD"
#define GENERIC_EXECQUERY "GENERIC_CONTROLLER,EXEC_QUERY"
/*
* Solaris_GenericController provider
*
* It is important to note that all memory allocated by these functions
* and passed to the CIMOM, is freed by the CIMOM as the caller.
*/
/*
* Name: cp_getInstance_Solaris_GenericController
*
* Description: Returns an instance which matches the passed in object path
* if found.
*
* Parameters:
* pOP - An CCIMObjectPath * which contains the information on
* the class for which to find the instance.
* Returns:
* CCIMInstance * if matched instance is found. Otherwise, NULL.
*/
/* ARGSUSED */
CCIMInstance*
cp_getInstance_Solaris_GenericController(CCIMObjectPath* pOP)
{
CCIMInstance *inst = NULL;
CCIMPropertyList *pCurPropList;
dm_descriptor_t uctrl_descriptor;
char *name;
int error;
if (pOP == NULL ||
pOP->mKeyProperties == NULL) {
util_handleError(GENERIC_GETINSTANCE, CIM_ERR_INVALID_PARAMETER,
NULL, NULL, &error);
return ((CCIMInstance *)NULL);
}
pCurPropList = pOP->mKeyProperties;
name = (cimchar *)util_getKeyValue(pCurPropList, string, DEVICEID,
&error);
if (error != 0 || name == NULL) {
util_handleError(GENERIC_GETINSTANCE, CIM_ERR_INVALID_PARAMETER,
NULL, NULL, &error);
return ((CCIMInstance*)NULL);
}
uctrl_descriptor =
dm_get_descriptor_by_name(DM_CONTROLLER, name, &error);
/*
* Not found. Return a null instance.
*/
if (error == ENODEV) {
return ((CCIMInstance *)NULL);
}
if (error != 0) {
util_handleError(GENERIC_GETINSTANCE, CIM_ERR_FAILED,
DM_GET_DESC_BYNAME_FAILURE, NULL, &error);
return ((CCIMInstance*)NULL);
}
/* Turn this descriptor in to a generic controller instance */
inst = ctrl_descriptor_toCCIMInstance(
hostName, uctrl_descriptor, GENERIC_CONTROLLER, &error);
dm_free_descriptor(uctrl_descriptor);
if (error != 0) {
util_handleError(GENERIC_GETINSTANCE, CIM_ERR_FAILED,
UCTRL_DESC_TO_INSTANCE_FAILURE, NULL,
&error);
return ((CCIMInstance*)NULL);
}
return (inst);
}
/*
* Name: cp_enumInstances_Solaris_GenericController
*
* Description: Returns an instance list of Unknown controllers, if any found.
*
* Parameters:
* pOP - An CCIMObjectPath * which contains the information on
* the class for which to find the instances.
* Returns:
* CCIMInstanceList * if matches are found. Otherwise, NULL.
*/
/* ARGSUSED */
CCIMInstanceList*
cp_enumInstances_Solaris_GenericController(CCIMObjectPath* pOP)
{
CCIMInstanceList *instList = NULL;
dm_descriptor_t *uctrl_descriptorp;
int error;
int filter[1];
filter[0] = DM_FILTER_END;
uctrl_descriptorp = dm_get_descriptors(DM_CONTROLLER, filter,
&error);
if (uctrl_descriptorp == NULL ||
uctrl_descriptorp[0] == NULL) {
return ((CCIMInstanceList *)NULL);
}
if (error != 0) {
util_handleError(GENERIC_ENUMINSTANCES, CIM_ERR_FAILED,
DM_GET_DESCRIPTORS, NULL, &error);
return ((CCIMInstanceList *)NULL);
}
/* convert controller to CCIMInstanceList */
instList = ctrl_descriptors_toCCIMInstanceList(GENERIC_CONTROLLER,
uctrl_descriptorp, &error, 1, "unknown");
dm_free_descriptors(uctrl_descriptorp);
if (error != 0) {
util_handleError(GENERIC_ENUMINSTANCES, CIM_ERR_FAILED,
UCTRL_DESC_TO_INSTANCE_FAILURE, NULL, &error);
return ((CCIMInstanceList *)NULL);
}
return (instList);
}
/*
* Name: cp_enumInstanceNames_Solaris_GenericController
*
* Description: Returns an objectPath list of GENERIC controllers, if any found.
*
* Parameters:
* pOP - An CCIMObjectPath * which contains the information on
* the class for which to find the instances.
* Returns:
* CCIMObjectPathList * if matched instances are found. Otherwise, NULL.
*/
/* ARGSUSED */
CCIMObjectPathList*
cp_enumInstanceNames_Solaris_GenericController(CCIMObjectPath * pOP) {
CCIMInstanceList *instList;
CCIMObjectPathList *objList = NULL;
int error;
if (pOP == NULL) {
util_handleError(GENERIC_ENUMINSTANCENAMES,
CIM_ERR_INVALID_PARAMETER, NULL, NULL, &error);
return ((CCIMObjectPathList *)NULL);
}
/*
* Call into enumInstances and then convert the instance list in
* to an object list.
*/
instList = cp_enumInstances_Solaris_GenericController(pOP);
if (instList != NULL) {
objList = cim_createObjectPathList(instList);
cim_freeInstanceList(instList);
}
return (objList);
}
/*
* Creating an instance of a Solaris_GenericController is not supported.
*/
/* ARGSUSED */
CCIMObjectPath*
cp_createInstance_Solaris_GenericController(
CCIMObjectPath* pOP, CCIMInstance* pInst)
{
int error;
util_handleError(GENERIC_CREATEINSTANCE, CIM_ERR_NOT_SUPPORTED, NULL,
NULL, &error);
return ((CCIMObjectPath*)NULL);
}
/*
* Deleting an instance of a Solaris_GenericController is not supported.
*/
/* ARGSUSED */
CIMBool
cp_deleteInstance_Solaris_GenericController(CCIMObjectPath* pInst)
{
int error;
util_handleError(GENERIC_DELETEINSTANCE,
CIM_ERR_NOT_SUPPORTED, NULL, NULL, &error);
return (cim_false);
}
/*
* Name: cp_getProperty_Solaris_GenericController
*
* Description: Returns the property requested, if found.
*
* Parameters:
* pOP - An CCIMObjectPath * which contains the information on
* the class for which to find the instances.
* Returns:
* CCIMProperty * if found.
*/
/* ARGSUSED */
CCIMProperty *
cp_getProperty_Solaris_GenericController(CCIMObjectPath *pOP,
char *pPropName)
{
CCIMProperty *prop = NULL;
CCIMInstance *inst = NULL;
int error = 0;
if (pOP == NULL) {
util_handleError(GENERIC_GETPROPERTY, CIM_ERR_INVALID_PARAMETER,
NULL, NULL, &error);
return ((CCIMProperty *)NULL);
}
inst = cp_getInstance_Solaris_GenericController(pOP);
if (inst == NULL) {
return ((CCIMProperty *)NULL);
}
prop = cim_getProperty(inst, pPropName);
cim_freeInstance(inst);
return (prop);
}
/*
* Setting an instance of a Solaris_GenericController is not supported.
*/
/* ARGSUSED */
CIMBool
cp_setInstance_Solaris_GenericController(CCIMObjectPath* pOP,
CCIMInstance* pInst)
{
int error;
util_handleError(GENERIC_SETINSTANCE, CIM_ERR_NOT_SUPPORTED, NULL,
NULL, &error);
return (cim_false);
}
/*
* Setting a property on an instance of a Solaris_GenericController is not
* supported.
*/
/* ARGSUSED */
CIMBool
cp_setProperty_Solaris_GenericController(CCIMObjectPath* pOP,
CCIMProperty* pProp)
{
int error;
util_handleError(GENERIC_SETPROPERTY, CIM_ERR_NOT_SUPPORTED, NULL,
NULL, &error);
return (cim_false);
}
/*
* No methods available on an instance of a Solaris_GenericController
*/
/* ARGSUSED */
CCIMProperty*
cp_invokeMethod_Solaris_GenericController(CCIMObjectPath* op,
cimchar* methodName, CCIMPropertyList* inParams,
CCIMPropertyList* outParams)
{
CCIMProperty *retVal = (CCIMProperty*)NULL;
return (retVal);
}
/*
* Name: cp_execQuery_Solaris_GenericController
*
* Description:
* Returns an instance list which matches the query if any are found.
*
* Parameters:
* CCIMObjectPath *op - An CCIMObjectPath * which contains the
* information on the class for which to find the instances.
*
* selectList - Not used
* nonJoinExp - Not used
*
* Returns:
* CCIMInstanceList * if matched instances are found. Otherwise, NULL.
*/
/*
* Currently, there is no WQL parser for the C providers. As a result,
* what is returned to the CIMOM is a list of instances with
* a NULL value at the beginning of the list. This NULL value indicates
* to the CIMOM that it must do the filtering for the client.
*/
/* ARGSUSED */
CCIMInstanceList*
cp_execQuery_Solaris_GenericController(CCIMObjectPath *op, cimchar *selectList,
cimchar *nonJoinExp, cimchar *queryExp, int queryType)
{
CCIMInstanceList *instList = NULL;
CCIMInstanceList *result;
CCIMInstance *emptyInst;
CCIMException *ex;
int error;
if (op == NULL) {
util_handleError(GENERIC_EXECQUERY, CIM_ERR_INVALID_PARAMETER, NULL,
NULL, &error);
return ((CCIMInstanceList *)NULL);
}
instList = cp_enumInstances_Solaris_GenericController(op);
if (instList == NULL) {
return ((CCIMInstanceList *)NULL);
}
/*
* Create a null instance and add it to the beginning
* of the list to indicate to the CIMOM that no filtering
* was done.
*/
emptyInst = cim_createInstance("");
if (emptyInst == NULL) {
ex = cim_getLastError();
util_handleError(GENERIC_EXECQUERY, CIM_ERR_FAILED,
CREATE_INSTANCE_FAILURE, ex, &error);
cim_freeInstanceList(instList);
return ((CCIMInstanceList *)NULL);
}
result = cim_createInstanceList();
if (result == NULL) {
ex = cim_getLastError();
util_handleError(GENERIC_EXECQUERY, CIM_ERR_FAILED,
CREATE_INSTANCE_LIST_FAILURE, ex, &error);
cim_freeInstance(emptyInst);
cim_freeInstanceList(instList);
return ((CCIMInstanceList *)NULL);
}
result = cim_addInstance(result, emptyInst);
if (result == NULL) {
ex = cim_getLastError();
util_handleError(GENERIC_EXECQUERY, CIM_ERR_FAILED,
ADD_INSTANCE_FAILURE, ex, &error);
cim_freeInstanceList(instList);
return ((CCIMInstanceList *)NULL);
}
/*
* Since copying the original list to the new list will
* leave no way to free the original list, manually
* concatenate the original list to the new one.
*/
result->mNext = instList;
return (result);
}