2005-11-02 13:19:10 +00:00
|
|
|
/*
|
|
|
|
* internal.h: internal definitions just used by code from the library
|
|
|
|
*/
|
|
|
|
|
2005-12-05 11:16:07 +00:00
|
|
|
#ifndef __VIR_INTERNAL_H__
|
|
|
|
#define __VIR_INTERNAL_H__
|
2005-11-02 13:19:10 +00:00
|
|
|
|
2007-11-12 14:00:32 +00:00
|
|
|
#include <errno.h>
|
Wed Dec 5 13:48:00 UTC 2007 Richard W.M. Jones <rjones@redhat.com>
* python/libvir.c, python/libvirt_wrap.h, qemud/qemud.c,
qemud/remote.c, src/internal.h, src/openvz_conf.c,
src/openvz_driver.c, src/proxy_internal.h, src/qemu_conf.c,
src/qemu_driver.c, src/remote_internal.h, src/test.h, src/util.c,
src/xen_unified.c, src/xen_unified.h, tests/nodeinfotest.c,
tests/qemuxml2argvtest.c, tests/qemuxml2xmltest.c, tests/reconnect.c,
tests/sexpr2xmltest.c, tests/virshtest.c, tests/xencapstest.c,
tests/xmconfigtest.c, tests/xml2sexprtest.c:
Change #include <> to #include "" for local includes.
Removed many includes from src/internal.h and put them in
the C files which actually use them.
Removed <ansidecl.h> - unused.
Added a comment around __func__.
Removed a clashing redefinition of VERSION symbol.
All limits (PATH_MAX etc) now done in src/internal.h, so we
don't need to include those headers in other files.
2007-12-05 13:56:22 +00:00
|
|
|
#include <limits.h>
|
|
|
|
|
2007-11-26 11:40:28 +00:00
|
|
|
#ifdef HAVE_SYS_SYSLIMITS_H
|
|
|
|
#include <sys/syslimits.h>
|
|
|
|
#endif
|
|
|
|
|
Wed Dec 5 13:48:00 UTC 2007 Richard W.M. Jones <rjones@redhat.com>
* python/libvir.c, python/libvirt_wrap.h, qemud/qemud.c,
qemud/remote.c, src/internal.h, src/openvz_conf.c,
src/openvz_driver.c, src/proxy_internal.h, src/qemu_conf.c,
src/qemu_driver.c, src/remote_internal.h, src/test.h, src/util.c,
src/xen_unified.c, src/xen_unified.h, tests/nodeinfotest.c,
tests/qemuxml2argvtest.c, tests/qemuxml2xmltest.c, tests/reconnect.c,
tests/sexpr2xmltest.c, tests/virshtest.c, tests/xencapstest.c,
tests/xmconfigtest.c, tests/xml2sexprtest.c:
Change #include <> to #include "" for local includes.
Removed many includes from src/internal.h and put them in
the C files which actually use them.
Removed <ansidecl.h> - unused.
Added a comment around __func__.
Removed a clashing redefinition of VERSION symbol.
All limits (PATH_MAX etc) now done in src/internal.h, so we
don't need to include those headers in other files.
2007-12-05 13:56:22 +00:00
|
|
|
#include "hash.h"
|
|
|
|
#include "libvirt/libvirt.h"
|
|
|
|
#include "libvirt/virterror.h"
|
|
|
|
#include "driver.h"
|
|
|
|
#include <libintl.h>
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
2007-11-26 11:40:28 +00:00
|
|
|
/* On architectures which lack these limits, define them (ie. Cygwin).
|
|
|
|
* Note that the libvirt code should be robust enough to handle the
|
|
|
|
* case where actual value is longer than these limits (eg. by setting
|
|
|
|
* length correctly in second argument to gethostname and by always
|
|
|
|
* using strncpy instead of strcpy).
|
|
|
|
*/
|
|
|
|
#ifndef HOST_NAME_MAX
|
|
|
|
#define HOST_NAME_MAX 256
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifndef IF_NAMESIZE
|
|
|
|
#define IF_NAMESIZE 16
|
|
|
|
#endif
|
2006-01-13 16:41:01 +00:00
|
|
|
|
2006-09-21 15:24:37 +00:00
|
|
|
#define _(str) dgettext(GETTEXT_PACKAGE, (str))
|
2007-06-15 08:18:55 +00:00
|
|
|
#define N_(str) dgettext(GETTEXT_PACKAGE, (str))
|
2006-09-21 15:24:37 +00:00
|
|
|
#define gettext_noop(str) (str)
|
|
|
|
|
2007-06-22 11:42:22 +00:00
|
|
|
/* String equality tests, suggested by Jim Meyering. */
|
|
|
|
#define STREQ(a,b) (strcmp((a),(b)) == 0)
|
|
|
|
#define STRCASEEQ(a,b) (strcasecmp((a),(b)) == 0)
|
2007-06-26 11:42:46 +00:00
|
|
|
#define STRNEQ(a,b) (strcmp((a),(b)) != 0)
|
|
|
|
#define STRCASENEQ(a,b) (strcasecmp((a),(b)) != 0)
|
2007-07-25 23:16:30 +00:00
|
|
|
#define STREQLEN(a,b,n) (strncmp((a),(b),(n)) == 0)
|
2007-12-05 18:55:04 +00:00
|
|
|
#define STRCASEEQLEN(a,b,n) (strncasecmp((a),(b),(n)) == 0)
|
2007-07-25 23:16:30 +00:00
|
|
|
#define STRNEQLEN(a,b,n) (strncmp((a),(b),(n)) != 0)
|
2007-12-05 18:55:04 +00:00
|
|
|
#define STRCASENEQLEN(a,b,n) (strncasecmp((a),(b),(n)) != 0)
|
2007-06-22 11:42:22 +00:00
|
|
|
|
Wed Dec 5 13:48:00 UTC 2007 Richard W.M. Jones <rjones@redhat.com>
* python/libvir.c, python/libvirt_wrap.h, qemud/qemud.c,
qemud/remote.c, src/internal.h, src/openvz_conf.c,
src/openvz_driver.c, src/proxy_internal.h, src/qemu_conf.c,
src/qemu_driver.c, src/remote_internal.h, src/test.h, src/util.c,
src/xen_unified.c, src/xen_unified.h, tests/nodeinfotest.c,
tests/qemuxml2argvtest.c, tests/qemuxml2xmltest.c, tests/reconnect.c,
tests/sexpr2xmltest.c, tests/virshtest.c, tests/xencapstest.c,
tests/xmconfigtest.c, tests/xml2sexprtest.c:
Change #include <> to #include "" for local includes.
Removed many includes from src/internal.h and put them in
the C files which actually use them.
Removed <ansidecl.h> - unused.
Added a comment around __func__.
Removed a clashing redefinition of VERSION symbol.
All limits (PATH_MAX etc) now done in src/internal.h, so we
don't need to include those headers in other files.
2007-12-05 13:56:22 +00:00
|
|
|
/* C99 uses __func__. __FUNCTION__ is legacy. */
|
2007-09-29 18:16:26 +00:00
|
|
|
#ifndef __GNUC__
|
Wed Dec 5 13:48:00 UTC 2007 Richard W.M. Jones <rjones@redhat.com>
* python/libvir.c, python/libvirt_wrap.h, qemud/qemud.c,
qemud/remote.c, src/internal.h, src/openvz_conf.c,
src/openvz_driver.c, src/proxy_internal.h, src/qemu_conf.c,
src/qemu_driver.c, src/remote_internal.h, src/test.h, src/util.c,
src/xen_unified.c, src/xen_unified.h, tests/nodeinfotest.c,
tests/qemuxml2argvtest.c, tests/qemuxml2xmltest.c, tests/reconnect.c,
tests/sexpr2xmltest.c, tests/virshtest.c, tests/xencapstest.c,
tests/xmconfigtest.c, tests/xml2sexprtest.c:
Change #include <> to #include "" for local includes.
Removed many includes from src/internal.h and put them in
the C files which actually use them.
Removed <ansidecl.h> - unused.
Added a comment around __func__.
Removed a clashing redefinition of VERSION symbol.
All limits (PATH_MAX etc) now done in src/internal.h, so we
don't need to include those headers in other files.
2007-12-05 13:56:22 +00:00
|
|
|
#define __FUNCTION__ __func__
|
2007-09-29 18:16:26 +00:00
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifdef __GNUC__
|
2005-11-07 17:16:18 +00:00
|
|
|
/**
|
|
|
|
* ATTRIBUTE_UNUSED:
|
|
|
|
*
|
|
|
|
* Macro to flag conciously unused parameters to functions
|
|
|
|
*/
|
2005-11-02 13:19:10 +00:00
|
|
|
#ifndef ATTRIBUTE_UNUSED
|
2007-03-16 15:03:21 +00:00
|
|
|
#define ATTRIBUTE_UNUSED __attribute__((__unused__))
|
2005-11-02 13:19:10 +00:00
|
|
|
#endif
|
2007-03-16 15:03:21 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* ATTRIBUTE_FORMAT
|
|
|
|
*
|
|
|
|
* Macro used to check printf/scanf-like functions, if compiling
|
|
|
|
* with gcc.
|
|
|
|
*/
|
|
|
|
#ifndef ATTRIBUTE_FORMAT
|
|
|
|
#define ATTRIBUTE_FORMAT(args...) __attribute__((__format__ (args)))
|
2005-11-02 13:19:10 +00:00
|
|
|
#endif
|
|
|
|
|
2007-03-16 15:03:21 +00:00
|
|
|
#else
|
|
|
|
#define ATTRIBUTE_UNUSED
|
|
|
|
#define ATTRIBUTE_FORMAT(...)
|
2007-09-29 18:16:26 +00:00
|
|
|
#endif /* __GNUC__ */
|
2006-03-27 15:24:36 +00:00
|
|
|
|
2005-11-07 17:16:18 +00:00
|
|
|
/**
|
|
|
|
* TODO:
|
|
|
|
*
|
|
|
|
* macro to flag unimplemented blocks
|
|
|
|
*/
|
|
|
|
#define TODO \
|
|
|
|
fprintf(stderr, "Unimplemented block at %s:%d\n", \
|
|
|
|
__FILE__, __LINE__);
|
|
|
|
|
2005-12-13 16:22:05 +00:00
|
|
|
/**
|
|
|
|
* VIR_CONNECT_MAGIC:
|
|
|
|
*
|
|
|
|
* magic value used to protect the API when pointers to connection structures
|
|
|
|
* are passed down by the uers.
|
|
|
|
*/
|
2005-12-16 18:41:46 +00:00
|
|
|
#define VIR_CONNECT_MAGIC 0x4F23DEAD
|
|
|
|
#define VIR_IS_CONNECT(obj) ((obj) && (obj)->magic==VIR_CONNECT_MAGIC)
|
|
|
|
|
2005-12-13 16:22:05 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* VIR_DOMAIN_MAGIC:
|
|
|
|
*
|
|
|
|
* magic value used to protect the API when pointers to domain structures
|
|
|
|
* are passed down by the uers.
|
|
|
|
*/
|
2005-12-16 18:41:46 +00:00
|
|
|
#define VIR_DOMAIN_MAGIC 0xDEAD4321
|
|
|
|
#define VIR_IS_DOMAIN(obj) ((obj) && (obj)->magic==VIR_DOMAIN_MAGIC)
|
|
|
|
#define VIR_IS_CONNECTED_DOMAIN(obj) (VIR_IS_DOMAIN(obj) && VIR_IS_CONNECT((obj)->conn))
|
2005-12-13 16:22:05 +00:00
|
|
|
|
2007-03-08 14:12:06 +00:00
|
|
|
/**
|
|
|
|
* VIR_NETWORK_MAGIC:
|
|
|
|
*
|
|
|
|
* magic value used to protect the API when pointers to network structures
|
|
|
|
* are passed down by the uers.
|
|
|
|
*/
|
|
|
|
#define VIR_NETWORK_MAGIC 0xDEAD1234
|
|
|
|
#define VIR_IS_NETWORK(obj) ((obj) && (obj)->magic==VIR_NETWORK_MAGIC)
|
|
|
|
#define VIR_IS_CONNECTED_NETWORK(obj) (VIR_IS_NETWORK(obj) && VIR_IS_CONNECT((obj)->conn))
|
|
|
|
|
|
|
|
/*
|
|
|
|
* arbitrary limitations
|
|
|
|
*/
|
2006-11-16 19:06:13 +00:00
|
|
|
#define MAX_DRIVERS 10
|
2007-03-08 14:12:06 +00:00
|
|
|
#define MIN_XEN_GUEST_SIZE 64 /* 64 megabytes */
|
2006-03-29 12:46:03 +00:00
|
|
|
|
2005-12-13 16:22:05 +00:00
|
|
|
/**
|
|
|
|
* _virConnect:
|
|
|
|
*
|
|
|
|
* Internal structure associated to a connection
|
|
|
|
*/
|
2006-03-20 17:49:28 +00:00
|
|
|
struct _virConnect {
|
|
|
|
unsigned int magic; /* specific value to check */
|
2006-03-29 12:46:03 +00:00
|
|
|
|
2006-04-09 13:11:22 +00:00
|
|
|
int uses; /* reference count */
|
2007-04-04 14:19:49 +00:00
|
|
|
|
|
|
|
/* The underlying hypervisor driver and network driver. */
|
|
|
|
virDriverPtr driver;
|
|
|
|
virNetworkDriverPtr networkDriver;
|
|
|
|
|
|
|
|
/* Private data pointer which can be used by driver and
|
|
|
|
* network driver as they wish.
|
|
|
|
* NB: 'private' is a reserved word in C++.
|
|
|
|
*/
|
|
|
|
void * privateData;
|
|
|
|
void * networkPrivateData;
|
|
|
|
|
|
|
|
/* Per-connection error. */
|
2006-03-20 17:49:28 +00:00
|
|
|
virError err; /* the last error */
|
|
|
|
virErrorFunc handler; /* associated handlet */
|
|
|
|
void *userData; /* the user data */
|
|
|
|
|
|
|
|
/* misc */
|
2007-03-08 14:12:06 +00:00
|
|
|
xmlMutexPtr hashes_mux;/* a mutex to protect the domain and networks hash tables */
|
2006-04-05 09:31:29 +00:00
|
|
|
virHashTablePtr domains;/* hash table for known domains */
|
2007-03-08 14:12:06 +00:00
|
|
|
virHashTablePtr networks;/* hash table for known domains */
|
2006-03-20 17:49:28 +00:00
|
|
|
int flags; /* a set of connection flags */
|
2007-11-14 11:40:57 +00:00
|
|
|
char *name; /* connection URI */
|
2006-03-20 17:49:28 +00:00
|
|
|
};
|
2005-12-13 16:22:05 +00:00
|
|
|
|
|
|
|
/**
|
2006-03-20 17:49:28 +00:00
|
|
|
* _virDomain:
|
|
|
|
*
|
|
|
|
* Internal structure associated to a domain
|
|
|
|
*/
|
|
|
|
struct _virDomain {
|
Mon Jan 23 14:36:18 IST 2007 Mark McLoughlin <markmc@redhat.com>
* include/libvirt/libvirt.h.in: add VIR_UUID_BUFLEN and
VIR_UUID_STRING_BUFLEN
* libvirt/proxy/libvirt_proxy.c, libvirt/src/hash.c,
libvirt/src/internal.h, libvirt/src/libvirt.c,
libvirt/src/proxy_internal.c, libvirt/src/test.c,
libvirt/src/virsh.c, libvirt/src/xend_internal.c,
libvirt/src/xm_internal.c, libvirt/src/xml.c,
libvirt/python/libvir.c: use them
2007-01-23 14:39:45 +00:00
|
|
|
unsigned int magic; /* specific value to check */
|
|
|
|
int uses; /* reference count */
|
|
|
|
virConnectPtr conn; /* pointer back to the connection */
|
|
|
|
char *name; /* the domain external name */
|
|
|
|
int id; /* the domain ID */
|
|
|
|
unsigned char uuid[VIR_UUID_BUFLEN]; /* the domain unique identifier */
|
2006-03-20 17:49:28 +00:00
|
|
|
};
|
2005-12-13 16:22:05 +00:00
|
|
|
|
2007-03-08 14:12:06 +00:00
|
|
|
/**
|
|
|
|
* _virNetwork:
|
|
|
|
*
|
|
|
|
* Internal structure associated to a domain
|
|
|
|
*/
|
|
|
|
struct _virNetwork {
|
|
|
|
unsigned int magic; /* specific value to check */
|
|
|
|
int uses; /* reference count */
|
|
|
|
virConnectPtr conn; /* pointer back to the connection */
|
|
|
|
char *name; /* the network external name */
|
|
|
|
unsigned char uuid[VIR_UUID_BUFLEN]; /* the network unique identifier */
|
|
|
|
};
|
|
|
|
|
2005-12-16 00:51:27 +00:00
|
|
|
/*
|
2006-03-20 17:49:28 +00:00
|
|
|
* Internal routines
|
|
|
|
*/
|
|
|
|
char *virDomainGetVM(virDomainPtr domain);
|
|
|
|
char *virDomainGetVMInfo(virDomainPtr domain,
|
|
|
|
const char *vm, const char *name);
|
|
|
|
|
2006-04-09 13:11:22 +00:00
|
|
|
/************************************************************************
|
|
|
|
* *
|
|
|
|
* API for error handling *
|
|
|
|
* *
|
|
|
|
************************************************************************/
|
2006-03-20 17:49:28 +00:00
|
|
|
void __virRaiseError(virConnectPtr conn,
|
|
|
|
virDomainPtr dom,
|
2007-03-08 14:12:06 +00:00
|
|
|
virNetworkPtr net,
|
2006-03-20 17:49:28 +00:00
|
|
|
int domain,
|
|
|
|
int code,
|
|
|
|
virErrorLevel level,
|
|
|
|
const char *str1,
|
|
|
|
const char *str2,
|
|
|
|
const char *str3,
|
2007-03-16 15:03:21 +00:00
|
|
|
int int1, int int2, const char *msg, ...)
|
|
|
|
ATTRIBUTE_FORMAT(printf, 12, 13);
|
2006-03-20 17:49:28 +00:00
|
|
|
const char *__virErrorMsg(virErrorNumber error, const char *info);
|
2006-02-27 16:27:18 +00:00
|
|
|
|
2006-04-09 13:11:22 +00:00
|
|
|
/************************************************************************
|
|
|
|
* *
|
2006-04-24 18:21:29 +00:00
|
|
|
* API for domain/connections (de)allocations and lookups *
|
2006-04-09 13:11:22 +00:00
|
|
|
* *
|
|
|
|
************************************************************************/
|
|
|
|
|
|
|
|
virConnectPtr virGetConnect (void);
|
|
|
|
int virFreeConnect (virConnectPtr conn);
|
2007-05-08 10:53:27 +00:00
|
|
|
virDomainPtr __virGetDomain (virConnectPtr conn,
|
2006-04-09 13:11:22 +00:00
|
|
|
const char *name,
|
2006-05-29 18:03:27 +00:00
|
|
|
const unsigned char *uuid);
|
2006-04-09 13:11:22 +00:00
|
|
|
int virFreeDomain (virConnectPtr conn,
|
|
|
|
virDomainPtr domain);
|
2007-05-08 10:53:27 +00:00
|
|
|
virNetworkPtr __virGetNetwork (virConnectPtr conn,
|
2007-03-08 14:12:06 +00:00
|
|
|
const char *name,
|
|
|
|
const unsigned char *uuid);
|
|
|
|
int virFreeNetwork (virConnectPtr conn,
|
|
|
|
virNetworkPtr domain);
|
2006-04-09 13:11:22 +00:00
|
|
|
|
2007-05-08 10:53:27 +00:00
|
|
|
#define virGetDomain(c,n,u) __virGetDomain((c),(n),(u))
|
|
|
|
#define virGetNetwork(c,n,u) __virGetNetwork((c),(n),(u))
|
|
|
|
|
2007-06-26 22:56:14 +00:00
|
|
|
int __virStateInitialize(void);
|
|
|
|
int __virStateCleanup(void);
|
|
|
|
int __virStateReload(void);
|
|
|
|
int __virStateActive(void);
|
|
|
|
#define virStateInitialize() __virStateInitialize()
|
|
|
|
#define virStateCleanup() __virStateCleanup()
|
|
|
|
#define virStateReload() __virStateReload()
|
|
|
|
#define virStateActive() __virStateActive()
|
|
|
|
|
2007-08-21 09:03:55 +00:00
|
|
|
int __virDrvSupportsFeature (virConnectPtr conn, int feature);
|
|
|
|
|
2007-08-21 09:31:12 +00:00
|
|
|
int __virDomainMigratePrepare (virConnectPtr dconn, char **cookie, int *cookielen, const char *uri_in, char **uri_out, unsigned long flags, const char *dname, unsigned long bandwidth);
|
|
|
|
int __virDomainMigratePerform (virDomainPtr domain, const char *cookie, int cookielen, const char *uri, unsigned long flags, const char *dname, unsigned long bandwidth);
|
|
|
|
virDomainPtr __virDomainMigrateFinish (virConnectPtr dconn, const char *dname, const char *cookie, int cookielen, const char *uri, unsigned long flags);
|
|
|
|
|
2007-11-12 14:00:32 +00:00
|
|
|
/* Like strtol, but produce an "int" result, and check more carefully.
|
|
|
|
Return 0 upon success; return -1 to indicate failure.
|
|
|
|
When END_PTR is NULL, the byte after the final valid digit must be NUL.
|
|
|
|
Otherwise, it's like strtol and lets the caller check any suffix for
|
|
|
|
validity. This function is careful to return -1 when the string S
|
|
|
|
represents a number that is not representable as an "int". */
|
|
|
|
static inline int
|
|
|
|
xstrtol_i(char const *s, char **end_ptr, int base, int *result)
|
|
|
|
{
|
|
|
|
long int val;
|
|
|
|
char *p;
|
|
|
|
int err;
|
|
|
|
|
|
|
|
errno = 0;
|
|
|
|
val = strtol(s, &p, base);
|
|
|
|
err = (errno || (!end_ptr && *p) || p == s || (int) val != val);
|
|
|
|
if (end_ptr)
|
|
|
|
*end_ptr = p;
|
|
|
|
if (err)
|
|
|
|
return -1;
|
|
|
|
*result = val;
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-11-14 10:53:05 +00:00
|
|
|
/* Just like xstrtol_i, above, but produce an "unsigned int" value. */
|
|
|
|
static inline int
|
|
|
|
xstrtol_ui(char const *s, char **end_ptr, int base, unsigned int *result)
|
|
|
|
{
|
|
|
|
unsigned long int val;
|
|
|
|
char *p;
|
|
|
|
int err;
|
|
|
|
|
|
|
|
errno = 0;
|
|
|
|
val = strtoul(s, &p, base);
|
|
|
|
err = (errno || (!end_ptr && *p) || p == s || (unsigned int) val != val);
|
|
|
|
if (end_ptr)
|
|
|
|
*end_ptr = p;
|
|
|
|
if (err)
|
|
|
|
return -1;
|
|
|
|
*result = val;
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2005-11-02 13:19:10 +00:00
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
2006-03-15 12:13:25 +00:00
|
|
|
#endif /* __cplusplus */
|
|
|
|
#endif /* __VIR_INTERNAL_H__ */
|
2007-03-15 17:24:56 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* vim: set tabstop=4:
|
|
|
|
* vim: set shiftwidth=4:
|
|
|
|
* vim: set expandtab:
|
|
|
|
*/
|
|
|
|
/*
|
|
|
|
* Local variables:
|
|
|
|
* indent-tabs-mode: nil
|
|
|
|
* c-indent-level: 4
|
|
|
|
* c-basic-offset: 4
|
|
|
|
* tab-width: 4
|
|
|
|
* End:
|
|
|
|
*/
|