mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-09-19 22:21:27 +00:00
3a7f2fc3b2
This also fixes a portability problem with the %a format modifier. %a is not portable and made esxDomainDumpXML fail at runtime in MinGW builds.
329 lines
12 KiB
C
329 lines
12 KiB
C
|
|
/*
|
|
* esx_vi.h: client for the VMware VI API 2.5 to manage ESX hosts
|
|
*
|
|
* Copyright (C) 2009-2010 Matthias Bolte <matthias.bolte@googlemail.com>
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
*
|
|
*/
|
|
|
|
#ifndef __ESX_VI_H__
|
|
# define __ESX_VI_H__
|
|
|
|
# include <libxml/tree.h>
|
|
# include <libxml/xpath.h>
|
|
# include <curl/curl.h>
|
|
|
|
# include "internal.h"
|
|
# include "virterror_internal.h"
|
|
# include "datatypes.h"
|
|
# include "esx_vi_types.h"
|
|
|
|
|
|
|
|
# define ESX_VI_ERROR(code, ...) \
|
|
virReportErrorHelper(NULL, VIR_FROM_ESX, code, __FILE__, __FUNCTION__, \
|
|
__LINE__, __VA_ARGS__)
|
|
|
|
|
|
|
|
typedef enum _esxVI_APIVersion esxVI_APIVersion;
|
|
typedef enum _esxVI_ProductVersion esxVI_ProductVersion;
|
|
typedef enum _esxVI_Occurrence esxVI_Occurrence;
|
|
typedef struct _esxVI_ParsedHostCpuIdInfo esxVI_ParsedHostCpuIdInfo;
|
|
typedef struct _esxVI_Context esxVI_Context;
|
|
typedef struct _esxVI_Response esxVI_Response;
|
|
typedef struct _esxVI_Enumeration esxVI_Enumeration;
|
|
typedef struct _esxVI_EnumerationValue esxVI_EnumerationValue;
|
|
typedef struct _esxVI_List esxVI_List;
|
|
|
|
|
|
|
|
enum _esxVI_APIVersion {
|
|
esxVI_APIVersion_Undefined = 0,
|
|
esxVI_APIVersion_Unknown,
|
|
esxVI_APIVersion_25,
|
|
esxVI_APIVersion_40
|
|
};
|
|
|
|
enum _esxVI_ProductVersion {
|
|
esxVI_ProductVersion_Undefined = 0,
|
|
esxVI_ProductVersion_GSX20,
|
|
esxVI_ProductVersion_ESX35,
|
|
esxVI_ProductVersion_ESX40,
|
|
esxVI_ProductVersion_VPX25,
|
|
esxVI_ProductVersion_VPX40
|
|
};
|
|
|
|
enum _esxVI_Occurrence {
|
|
esxVI_Occurrence_Undefined = 0,
|
|
esxVI_Occurrence_RequiredItem,
|
|
esxVI_Occurrence_RequiredList,
|
|
esxVI_Occurrence_OptionalItem,
|
|
esxVI_Occurrence_OptionalList,
|
|
esxVI_Occurrence_None
|
|
};
|
|
|
|
struct _esxVI_ParsedHostCpuIdInfo {
|
|
int level;
|
|
char eax[32];
|
|
char ebx[32];
|
|
char ecx[32];
|
|
char edx[32];
|
|
};
|
|
|
|
|
|
|
|
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
* Context
|
|
*/
|
|
|
|
struct _esxVI_Context {
|
|
char *url;
|
|
char *ipAddress;
|
|
CURL *curl_handle;
|
|
struct curl_slist *curl_headers;
|
|
char curl_error[CURL_ERROR_SIZE];
|
|
virMutex curl_lock;
|
|
char *username;
|
|
char *password;
|
|
esxVI_ServiceContent *service;
|
|
esxVI_APIVersion apiVersion;
|
|
esxVI_ProductVersion productVersion;
|
|
esxVI_UserSession *session;
|
|
esxVI_ManagedObjectReference *datacenter;
|
|
esxVI_ManagedObjectReference *vmFolder;
|
|
esxVI_ManagedObjectReference *hostFolder;
|
|
esxVI_SelectionSpec *fullTraversalSpecList;
|
|
};
|
|
|
|
int esxVI_Context_Alloc(esxVI_Context **ctx);
|
|
void esxVI_Context_Free(esxVI_Context **ctx);
|
|
int esxVI_Context_Connect(esxVI_Context *ctx, const char *ipAddress,
|
|
const char *url, const char *username,
|
|
const char *password, int noVerify);
|
|
int esxVI_Context_DownloadFile(esxVI_Context *ctx, const char *url,
|
|
char **content);
|
|
int esxVI_Context_UploadFile(esxVI_Context *ctx, const char *url,
|
|
const char *content);
|
|
int esxVI_Context_Execute(esxVI_Context *ctx, const char *methodName,
|
|
const char *request, esxVI_Response **response,
|
|
esxVI_Occurrence occurrence);
|
|
|
|
|
|
|
|
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
* Response
|
|
*/
|
|
|
|
struct _esxVI_Response {
|
|
int responseCode; /* required */
|
|
char *content; /* required */
|
|
xmlDocPtr document; /* optional */
|
|
xmlNodePtr node; /* optional, list */
|
|
};
|
|
|
|
int esxVI_Response_Alloc(esxVI_Response **response);
|
|
void esxVI_Response_Free(esxVI_Response **response);
|
|
|
|
|
|
|
|
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
* Enumeration
|
|
*/
|
|
|
|
struct _esxVI_EnumerationValue {
|
|
const char *name;
|
|
int value;
|
|
};
|
|
|
|
struct _esxVI_Enumeration {
|
|
esxVI_Type type;
|
|
esxVI_EnumerationValue values[10];
|
|
};
|
|
|
|
int esxVI_Enumeration_CastFromAnyType(const esxVI_Enumeration *enumeration,
|
|
esxVI_AnyType *anyType, int *value);
|
|
int esxVI_Enumeration_Serialize(const esxVI_Enumeration *enumeration,
|
|
int value, const char *element,
|
|
virBufferPtr output);
|
|
int esxVI_Enumeration_Deserialize(const esxVI_Enumeration *enumeration,
|
|
xmlNodePtr node, int *value);
|
|
|
|
|
|
|
|
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
* List
|
|
*/
|
|
|
|
struct _esxVI_List {
|
|
esxVI_List *_next;
|
|
};
|
|
|
|
typedef int (*esxVI_List_FreeFunc) (esxVI_List **item);
|
|
typedef int (*esxVI_List_DeepCopyFunc) (esxVI_List **dest, esxVI_List *src);
|
|
typedef int (*esxVI_List_CastFromAnyTypeFunc) (esxVI_AnyType *anyType,
|
|
esxVI_List **item);
|
|
typedef int (*esxVI_List_SerializeFunc) (esxVI_List *item, const char *element,
|
|
virBufferPtr output);
|
|
typedef int (*esxVI_List_DeserializeFunc) (xmlNodePtr node, esxVI_List **item);
|
|
|
|
int esxVI_List_Append(esxVI_List **list, esxVI_List *item);
|
|
int esxVI_List_DeepCopy(esxVI_List **destList, esxVI_List *srcList,
|
|
esxVI_List_DeepCopyFunc deepCopyFunc,
|
|
esxVI_List_FreeFunc freeFunc);
|
|
int esxVI_List_CastFromAnyType(esxVI_AnyType *anyType, esxVI_List **list,
|
|
esxVI_List_CastFromAnyTypeFunc castFromAnyTypeFunc,
|
|
esxVI_List_FreeFunc freeFunc);
|
|
int esxVI_List_Serialize(esxVI_List *list, const char *element,
|
|
virBufferPtr output,
|
|
esxVI_List_SerializeFunc serializeFunc);
|
|
int esxVI_List_Deserialize(xmlNodePtr node, esxVI_List **list,
|
|
esxVI_List_DeserializeFunc deserializeFunc,
|
|
esxVI_List_FreeFunc freeFunc);
|
|
|
|
|
|
|
|
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
* Utility and Convenience Functions
|
|
*
|
|
* Function naming scheme:
|
|
* - 'lookup' functions query the ESX or vCenter for information
|
|
* - 'get' functions get information from a local object
|
|
*/
|
|
|
|
int esxVI_Alloc(void **ptrptr, size_t size);
|
|
|
|
int esxVI_BuildFullTraversalSpecItem
|
|
(esxVI_SelectionSpec **fullTraversalSpecList, const char *name,
|
|
const char *type, const char *path, const char *selectSetNames);
|
|
|
|
int esxVI_BuildFullTraversalSpecList
|
|
(esxVI_SelectionSpec **fullTraversalSpecList);
|
|
|
|
int esxVI_EnsureSession(esxVI_Context *ctx);
|
|
|
|
int esxVI_LookupObjectContentByType(esxVI_Context *ctx,
|
|
esxVI_ManagedObjectReference *root,
|
|
const char *type,
|
|
esxVI_String *propertyNameList,
|
|
esxVI_Boolean recurse,
|
|
esxVI_ObjectContent **objectContentList);
|
|
|
|
int esxVI_GetManagedEntityStatus
|
|
(esxVI_ObjectContent *objectContent, const char *propertyName,
|
|
esxVI_ManagedEntityStatus *managedEntityStatus);
|
|
|
|
int esxVI_GetVirtualMachinePowerState
|
|
(esxVI_ObjectContent *virtualMachine,
|
|
esxVI_VirtualMachinePowerState *powerState);
|
|
|
|
int esxVI_GetVirtualMachineQuestionInfo
|
|
(esxVI_ObjectContent *virtualMachine,
|
|
esxVI_VirtualMachineQuestionInfo **questionInfo);
|
|
|
|
int esxVI_LookupNumberOfDomainsByPowerState
|
|
(esxVI_Context *ctx, esxVI_VirtualMachinePowerState powerState,
|
|
esxVI_Boolean inverse);
|
|
|
|
int esxVI_GetVirtualMachineIdentity(esxVI_ObjectContent *virtualMachine,
|
|
int *id, char **name, unsigned char *uuid);
|
|
|
|
int esxVI_GetNumberOfSnapshotTrees
|
|
(esxVI_VirtualMachineSnapshotTree *snapshotTreeList);
|
|
|
|
int esxVI_GetSnapshotTreeNames
|
|
(esxVI_VirtualMachineSnapshotTree *snapshotTreeList, char **names,
|
|
int nameslen);
|
|
|
|
int esxVI_GetSnapshotTreeByName
|
|
(esxVI_VirtualMachineSnapshotTree *snapshotTreeList, const char *name,
|
|
esxVI_VirtualMachineSnapshotTree **snapshotTree,
|
|
esxVI_VirtualMachineSnapshotTree **snapshotTreeParent,
|
|
esxVI_Occurrence occurrence);
|
|
|
|
int esxVI_GetSnapshotTreeBySnapshot
|
|
(esxVI_VirtualMachineSnapshotTree *snapshotTreeList,
|
|
esxVI_ManagedObjectReference *snapshot,
|
|
esxVI_VirtualMachineSnapshotTree **snapshotTree);
|
|
|
|
int esxVI_LookupResourcePoolByHostSystem
|
|
(esxVI_Context *ctx, esxVI_ObjectContent *hostSystem,
|
|
esxVI_ManagedObjectReference **resourcePool);
|
|
|
|
int esxVI_LookupHostSystemByIp(esxVI_Context *ctx, const char *ipAddress,
|
|
esxVI_String *propertyNameList,
|
|
esxVI_ObjectContent **hostSystem);
|
|
|
|
int esxVI_LookupVirtualMachineByUuid(esxVI_Context *ctx,
|
|
const unsigned char *uuid,
|
|
esxVI_String *propertyNameList,
|
|
esxVI_ObjectContent **virtualMachine,
|
|
esxVI_Occurrence occurrence);
|
|
|
|
int esxVI_LookupVirtualMachineByName(esxVI_Context *ctx, const char *name,
|
|
esxVI_String *propertyNameList,
|
|
esxVI_ObjectContent **virtualMachine,
|
|
esxVI_Occurrence occurrence);
|
|
|
|
int esxVI_LookupVirtualMachineByUuidAndPrepareForTask
|
|
(esxVI_Context *ctx, const unsigned char *uuid,
|
|
esxVI_String *propertyNameList, esxVI_ObjectContent **virtualMachine,
|
|
esxVI_Boolean autoAnswer);
|
|
|
|
int esxVI_LookupDatastoreByName(esxVI_Context *ctx, const char *name,
|
|
esxVI_String *propertyNameList,
|
|
esxVI_ObjectContent **datastore,
|
|
esxVI_Occurrence occurrence);
|
|
|
|
int esxVI_LookupTaskInfoByTask(esxVI_Context *ctx,
|
|
esxVI_ManagedObjectReference *task,
|
|
esxVI_TaskInfo **taskInfo);
|
|
|
|
int esxVI_LookupPendingTaskInfoListByVirtualMachine
|
|
(esxVI_Context *ctx, esxVI_ObjectContent *virtualMachine,
|
|
esxVI_TaskInfo **pendingTaskInfoList);
|
|
|
|
int esxVI_LookupAndHandleVirtualMachineQuestion(esxVI_Context *ctx,
|
|
const unsigned char *uuid,
|
|
esxVI_Boolean autoAnswer);
|
|
|
|
int esxVI_LookupRootSnapshotTreeList
|
|
(esxVI_Context *ctx, const unsigned char *virtualMachineUuid,
|
|
esxVI_VirtualMachineSnapshotTree **rootSnapshotTreeList);
|
|
|
|
int esxVI_LookupCurrentSnapshotTree
|
|
(esxVI_Context *ctx, const unsigned char *virtualMachineUuid,
|
|
esxVI_VirtualMachineSnapshotTree **currentSnapshotTree,
|
|
esxVI_Occurrence occurrence);
|
|
|
|
int esxVI_HandleVirtualMachineQuestion
|
|
(esxVI_Context *ctx,
|
|
esxVI_ManagedObjectReference *virtualMachine,
|
|
esxVI_VirtualMachineQuestionInfo *questionInfo,
|
|
esxVI_Boolean autoAnswer);
|
|
|
|
int esxVI_WaitForTaskCompletion(esxVI_Context *ctx,
|
|
esxVI_ManagedObjectReference *task,
|
|
const unsigned char *virtualMachineUuid,
|
|
esxVI_Boolean autoAnswer,
|
|
esxVI_TaskInfoState *finalState);
|
|
|
|
int esxVI_ParseHostCpuIdInfo(esxVI_ParsedHostCpuIdInfo *parsedHostCpuIdInfo,
|
|
esxVI_HostCpuIdInfo *hostCpuIdInfo);
|
|
|
|
#endif /* __ESX_VI_H__ */
|