+Fri Jan 13 17:39:24 CET 2006 Daniel Veillard <veillard@redhat.com>
+
+ * include/libvir.h.in include/libvir.h src/internal.h src/libvir.c
+ src/xend_internal.c src/xend_internal.h: starting to plug the
+ xend code in, replacing structures mostly, but not finished.
+
Thu Jan 12 16:36:21 CET 2006 Daniel Veillard <veillard@redhat.com>
* src/Makefile.am src/xend_internal.c src/xend_internal.h:
H2 {font-family: Verdana,Arial,Helvetica}
H3 {font-family: Verdana,Arial,Helvetica}
A:link, A:visited, A:active { text-decoration: underline }
-</style><title>libvir architecture</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>Libvir the virtualization API</h1><h2>libvir architecture</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="news.html">Releases</a></li><li><a href="intro.html">Introduction</a></li><li><a href="architecture.html">libvir architecture</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a style="font-weight:bold" href="html/index.html">API Menu</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="https://www.redhat.com/archives/libvir-list/">Mail archive</a></li><li><a href="http://www.cl.cam.ac.uk/Research/SRG/netos/xen/index.html">Xen project</a></li></ul></td></tr></table></td></tr></table><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-90x34.gif" alt="Made with Libxml2 Logo" /></a></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>In a Xen environment, program using libvir have to execute in "Domain 0",
+</style><title>libvir architecture</title></head><body bgcolor="#8b7765" text="#000000" link="#a06060" vlink="#000000"><table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr><td width="120"><a href="http://www.redhat.com/"><img src="redhat.gif" alt="Red Hat Logo" /></a></td><td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center"><h1>Libvir the virtualization API</h1><h2>libvir architecture</h2></td></tr></table></td></tr></table></td></tr></table><table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr><tr><td bgcolor="#fffacd"><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="20" value="" /><input name="submit" type="submit" value="Search ..." /></form><ul><li><a href="index.html">Home</a></li><li><a href="news.html">Releases</a></li><li><a href="intro.html">Introduction</a></li><li><a href="architecture.html">libvir architecture</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a style="font-weight:bold" href="html/index.html">API Menu</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></td></tr></table><table width="100%" border="0" cellspacing="1" cellpadding="3"><tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr><tr><td bgcolor="#fffacd"><ul><li><a href="https://www.redhat.com/archives/libvir-list/">Mail archive</a></li><li><a href="http://www.cl.cam.ac.uk/Research/SRG/netos/xen/index.html">Xen project</a></li></ul></td></tr></table></td></tr></table><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-90x34.gif" alt="Made with Libxml2 Logo" /></a></td><td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd"><p>In a Xen environment, programs using libvir have to execute in "Domain 0",
which is the primary Linux OS loaded on the machine. That OS kernel provides
most if not all of the actual drivers used by the set of domains. It also
runs the Xen Store, a database of informations shared by the hypervisor, the
VIR_DOMAIN_SHUTOFF = 5 /* the domain is shut off */
} virDomainState;
+/**
+ * virDomainRestart:
+ *
+ * Flags that determine the action to take on a shutdown or crash of a domain
+ */
+typedef enum {
+ VIR_DOMAIN_DESTROY = 1, /* destroy the domain */
+ VIR_DOMAIN_RESTART = 2, /* restart the domain */
+ VIR_DOMAIN_PRESERVE= 3, /* keep as is, need manual destroy, for debug */
+ VIR_DOMAIN_RENAME_RESTART= 4/* restart under an new unique name */
+} virDomainRestart;
+
+/**
+ * virDeviceMode:
+ *
+ * Flags that determine permission to expose a device to the guest
+ */
+typedef enum {
+ VIR_DEVICE_DEFAULT = 0, /* Default mode */
+ VIR_DEVICE_RO = 1, /* Access read-only */
+ VIR_DEVICE_RW = 2, /* Access read-write */
+ VIR_DEVICE_RW_FORCE= 3 /* Forced read-write even if already used */
+} virDeviceMode;
+
/**
* virDomainInfoPtr:
*
typedef virDomainInfo *virDomainInfoPtr;
+/**
+ * virDomainKernel:
+ *
+ * a virDomainImage is the set of kernel related informations associated
+ * to a domain
+ */
+
+typedef struct _virDomainKernel virDomainKernel;
+
+struct _virDomainKernel {
+ const char *kernel; /* filename pointing to the kernel image */
+ const char *ramdisk; /* an optional init ramdisk */
+ const char *root; /* an optional root block device */
+ const char *extra; /* optional kernel command line parameters */
+};
+
+/**
+ * virDomainKernelPtr:
+ *
+ * a virDomainKernelPtr is a pointer to a virDomainKernel structure.
+ */
+
+typedef virDomainKernel *virDomainKernelPtr;
+
/**
* virDomainCreateFlags:
*
VIR_DOMAIN_SHUTOFF = 5 /* the domain is shut off */
} virDomainState;
+/**
+ * virDomainRestart:
+ *
+ * Flags that determine the action to take on a shutdown or crash of a domain
+ */
+typedef enum {
+ VIR_DOMAIN_DESTROY = 1, /* destroy the domain */
+ VIR_DOMAIN_RESTART = 2, /* restart the domain */
+ VIR_DOMAIN_PRESERVE= 3, /* keep as is, need manual destroy, for debug */
+ VIR_DOMAIN_RENAME_RESTART= 4/* restart under an new unique name */
+} virDomainRestart;
+
+/**
+ * virDeviceMode:
+ *
+ * Flags that determine permission to expose a device to the guest
+ */
+typedef enum {
+ VIR_DEVICE_DEFAULT = 0, /* Default mode */
+ VIR_DEVICE_RO = 1, /* Access read-only */
+ VIR_DEVICE_RW = 2, /* Access read-write */
+ VIR_DEVICE_RW_FORCE= 3 /* Forced read-write even if already used */
+} virDeviceMode;
+
/**
* virDomainInfoPtr:
*
};
/**
- * virDomainInfoPtr:
+ * virDomainKernel:
+ *
+ * a virDomainImage is the set of kernel related informations associated
+ * to a domain
+ */
+
+typedef struct _virDomainKernel virDomainKernel;
+
+struct _virDomainKernel {
+ const char *kernel; /* filename pointing to the kernel image */
+ const char *ramdisk; /* an optional init ramdisk */
+ const char *root; /* an optional root block device */
+ const char *extra; /* optional kernel command line parameters */
+};
+
+/**
+ * virDomainKernelPtr:
*
- * a virDomainInfoPtr is a pointer to a virDomainInfo structure.
+ * a virDomainKernelPtr is a pointer to a virDomainKernel structure.
*/
-typedef virDomainInfo *virDomainInfoPtr;
+typedef virDomainKernel *virDomainKernelPtr;
/**
* virDomainCreateFlags:
#ifndef __VIR_INTERNAL_H__
#define __VIR_INTERNAL_H__
+#include <sys/types.h>
+#include <sys/socket.h>
+#include <sys/un.h>
+#include <netinet/in.h>
+#include <netinet/tcp.h>
+
#include "hash.h"
#include "libvir.h"
unsigned int magic; /* specific value to check */
int handle; /* internal handle used for hypercall */
struct xs_handle *xshandle; /* handle to talk to the xenstore */
+
+ /* connection to xend */
+ int type; /* PF_UNIX or PF_INET */
+ int len; /* lenght of addr */
+ struct sockaddr *addr; /* type of address used */
+ struct sockaddr_un addr_un; /* the unix address */
+ struct sockaddr_in addr_in; /* the inet address */
+
virHashTablePtr domains; /* hash table for known domains */
int flags; /* a set of connection flags */
};
#include "libvir.h"
#include "xen_internal.h"
+#include "xend_internal.h"
#include <stdio.h>
#include <stdlib.h>
ret->magic = VIR_CONNECT_MAGIC;
ret->handle = handle;
ret->xshandle = xshandle;
+ if (xend_setup(ret) < 0)
+ goto failed;
ret->domains = virHashCreate(20);
ret->flags = 0;
if (ret->domains == NULL)
ret->magic = VIR_CONNECT_MAGIC;
ret->handle = -1;
ret->xshandle = xshandle;
+ if (xend_setup(ret) < 0)
+ goto failed;
ret->domains = virHashCreate(20);
ret->flags = VIR_CONNECT_RO;
if (ret->domains == NULL)
*/
int
virConnectClose(virConnectPtr conn) {
+ xend_cleanup(conn);
if (!VIR_IS_CONNECT(conn))
return(-1);
virHashFree(conn->domains, (virHashDeallocator) virDomainFreeName);
#include <arpa/inet.h>
#include <netdb.h>
+#include "libvir.h"
+#include "internal.h"
#include "sexpr.h"
#include "xend_internal.h"
* Returns the socket file descriptor or -1 in case of error
*/
static int
-do_connect(struct xend *xend)
+do_connect(virConnectPtr xend)
{
int s;
int serrno;
* Returns the HTTP return code or -1 in case or error.
*/
static int
-xend_get(struct xend *xend, const char *path,
+xend_get(virConnectPtr xend, const char *path,
char *content, size_t n_content)
{
int ret;
* Returns the HTTP return code or -1 in case or error.
*/
static int
-xend_post(struct xend *xend, const char *path, const char *ops,
+xend_post(virConnectPtr xend, const char *path, const char *ops,
char *content, size_t n_content)
{
char buffer[100];
* Returns 0 in case of success, -1 in case of failure.
*/
static int
-xend_op_ext2(struct xend *xend, const char *path, char *error,
+xend_op_ext2(virConnectPtr xend, const char *path, char *error,
size_t n_error, const char *key, va_list ap)
{
char ops[1024];
* Returns 0 in case of success, -1 in case of failure.
*/
static int
-xend_node_op(struct xend *xend, const char *path, const char *key, ...)
+xend_node_op(virConnectPtr xend, const char *path, const char *key, ...)
{
va_list ap;
int ret;
* Returns 0 in case of success, -1 in case of failure.
*/
static int
-xend_op_ext(struct xend *xend, const char *name, char *error,
+xend_op_ext(virConnectPtr xend, const char *name, char *error,
size_t n_error, const char *key, ...)
{
char buffer[1024];
* Returns a parsed S-Expression in case of success, NULL in case of failure
*/
static struct sexpr *
-sexpr_get(struct xend *xend, const char *fmt, ...)
+sexpr_get(virConnectPtr xend, const char *fmt, ...)
{
char buffer[4096];
char path[1024];
*
* Returns the value found or 0 if not found (but may not be an error)
*/
-static enum xend_domain_restart
+static virDomainRestart
sexpr_poweroff(struct sexpr *sexpr, const char *name)
{
const char *value = sexpr_node(sexpr, name);
if (value) {
if (strcmp(value, "poweroff") == 0) {
- return XEND_DESTROY;
+ return VIR_DOMAIN_DESTROY;
} else if (strcmp(value, "restart") == 0) {
- return XEND_RESTART;
+ return VIR_DOMAIN_RESTART;
} else if (strcmp(value, "preserve") == 0) {
- return XEND_PRESERVE;
+ return VIR_DOMAIN_PRESERVE;
} else if (strcmp(value, "rename-restart") == 0) {
- return XEND_RENAME_RESTART;
+ return VIR_DOMAIN_RENAME_RESTART;
}
}
return XEND_DEFAULT;
*
* Returns the value found or 0 if not found (but may not be an error)
*/
-static enum xend_device_vbd_mode
+static virDeviceMode
sexpr_mode(struct sexpr *node, const char *path)
{
const char *mode = sexpr_node(node, path);
- enum xend_device_vbd_mode ret;
+ virDeviceMode ret;
if (!mode) {
- ret = XEND_DEFAULT;
+ ret = VIR_DEVICE_DEFAULT;
} else if (strcmp(mode, "r") == 0) {
- ret = XEND_READ_ONLY;
+ ret = VIR_DEVICE_RO;
} else if (strcmp(mode, "w") == 0) {
- ret = XEND_READ_WRITE;
+ ret = VIR_DEVICE_RW;
} else if (strcmp(mode, "w!") == 0) {
- ret = XEND_READ_WRITE_FORCE;
+ ret = VIR_DEVICE_RW_FORCE;
} else {
- ret = XEND_DEFAULT;
+ ret = VIR_DEVICE_DEFAULT;
}
return ret;
/* PUBLIC FUNCTIONS */
/**
- * xend_new_unix:
+ * xend_setup_unix:
+ * @conn: an existing virtual connection block
* @path: the path for the Xen Daemon socket
*
* Creates a localhost Xen Daemon connection
* Note: this doesn't try to check if the connection actually works
*
- * Returns the new pointer or NULL in case of error.
+ * Returns 0 in case of success, -1 in case of error.
*/
-struct xend *
-xend_new_unix(const char *path)
+int
+xend_setup_unix(virConnectPtr xend, const char *path)
{
- struct xend *xend = malloc(sizeof(*xend));
struct sockaddr_un *addr;
- if (!xend)
- return NULL;
+ if ((xend == NULL) || (path == NULL))
+ return(-1);
addr = &xend->addr_un;
addr->sun_family = AF_UNIX;
xend->addr = (struct sockaddr *) addr;
xend->type = PF_UNIX;
- return xend;
+ return(0);
}
/**
- * xend_new_unix:
+ * xend_setup_tcp:
+ * @conn: an existing virtual connection block
* @host: the host name for the Xen Daemon
* @port: the port
*
* Creates a possibly remote Xen Daemon connection
* Note: this doesn't try to check if the connection actually works
*
- * Returns the new pointer or NULL in case of error.
+ * Returns 0 in case of success, -1 in case of error.
*/
-struct xend *
-xend_new_tcp(const char *host, int port)
+int
+xend_setup_tcp(virConnectPtr xend, const char *host, int port)
{
- struct xend *xend = malloc(sizeof(*xend));
struct in_addr ip;
struct hostent *pent;
- if (!xend)
- return NULL;
+ if ((xend == NULL) || (host == NULL) || (port <= 0))
+ return(-1);
pent = gethostbyname(host);
if (pent == NULL) {
if (inet_aton(host, &ip) == 0) {
errno = ESRCH;
- return NULL;
+ return(-1);
}
} else {
memcpy(&ip, pent->h_addr_list[0], sizeof(ip));
xend->addr_in.sin_port = htons(port);
memcpy(&xend->addr_in.sin_addr, &ip, sizeof(ip));
- return xend;
+ return(0);
}
/**
- * xend_new:
+ * xend_setup:
+ * @conn: an existing virtual connection block
*
* Creates a localhost Xen Daemon connection
* Note: this doesn't try to check if the connection actually works
*
- * Returns the new pointer or NULL in case of error.
+ * Returns 0 in case of success, -1 in case of error.
*/
-struct xend *
-xend_new(void)
+int
+xend_setup(virConnectPtr conn)
{
- return xend_new_unix("/var/lib/xend/xend-socket");
+ return(xend_setup_unix(conn, "/var/lib/xend/xend-socket"));
}
/**
- * xend_delete:
+ * xend_cleanup:
*
- * Free a Xen Daemon connection
+ * Cleanup a xend connection
*/
void
-xend_delete(struct xend *xend)
+xend_cleanup(virConnectPtr xend ATTRIBUTE_UNUSED)
{
- free(xend);
}
/**
* Returns 0 in case of success, -1 (with errno) in case of error.
*/
int
-xend_wait_for_devices(struct xend *xend, const char *name)
+xend_wait_for_devices(virConnectPtr xend, const char *name)
{
return xend_op(xend, name, "op", "wait_for_devices", NULL);
}
* Returns 0 in case of success, -1 (with errno) in case of error.
*/
int
-xend_pause(struct xend *xend, const char *name)
+xend_pause(virConnectPtr xend, const char *name)
{
return xend_op(xend, name, "op", "pause", NULL);
}
* Returns 0 in case of success, -1 (with errno) in case of error.
*/
int
-xend_unpause(struct xend *xend, const char *name)
+xend_unpause(virConnectPtr xend, const char *name)
{
return xend_op(xend, name, "op", "unpause", NULL);
}
* Returns 0 in case of success, -1 (with errno) in case of error.
*/
int
-xend_rename(struct xend *xend, const char *old, const char *new)
+xend_rename(virConnectPtr xend, const char *old, const char *new)
{
if ((xend == NULL) || (old == NULL) || (new == NULL))
return(-1);
* Returns 0 in case of success, -1 (with errno) in case of error.
*/
int
-xend_reboot(struct xend *xend, const char *name)
+xend_reboot(virConnectPtr xend, const char *name)
{
if ((xend == NULL) || (name == NULL))
return(-1);
* Returns 0 in case of success, -1 (with errno) in case of error.
*/
int
-xend_shutdown(struct xend *xend, const char *name)
+xend_shutdown(virConnectPtr xend, const char *name)
{
if ((xend == NULL) || (name == NULL))
return(-1);
* Returns 0 in case of success, -1 (with errno) in case of error.
*/
int
-xend_sysrq(struct xend *xend, const char *name, const char *key)
+xend_sysrq(virConnectPtr xend, const char *name, const char *key)
{
if ((xend == NULL) || (name == NULL) || (key == NULL))
return(-1);
* Returns 0 in case of success, -1 (with errno) in case of error.
*/
int
-xend_destroy(struct xend *xend, const char *name)
+xend_destroy(virConnectPtr xend, const char *name)
{
if ((xend == NULL) || (name == NULL))
return(-1);
* Returns 0 in case of success, -1 (with errno) in case of error.
*/
int
-xend_save(struct xend *xend, const char *name, const char *filename)
+xend_save(virConnectPtr xend, const char *name, const char *filename)
{
if ((xend == NULL) || (filename == NULL))
return(-1);
* Returns 0 in case of success, -1 (with errno) in case of error.
*/
int
-xend_restore(struct xend *xend, const char *filename)
+xend_restore(virConnectPtr xend, const char *filename)
{
if ((xend == NULL) || (filename == NULL))
return(-1);
* Returns a list of names or NULL in case of error.
*/
char **
-xend_get_domains(struct xend *xend)
+xend_get_domains(virConnectPtr xend)
{
size_t extra = 0;
struct sexpr *root = NULL;
*/
int
-xend_create(struct xend *xend, const struct xend_domain *dom)
+xend_create(virConnectPtr xend, const struct xend_domain *dom)
{
int ret, serrno;
struct sexpr *sexpr;
* Returns 0 for success; -1 (with errno) on error
*/
int
-xend_set_max_memory(struct xend *xend, const char *name, uint64_t value)
+xend_set_max_memory(virConnectPtr xend, const char *name, uint64_t value)
{
char buf[1024];
* Returns 0 for success; -1 (with errno) on error
*/
int
-xend_set_memory(struct xend *xend, const char *name, uint64_t value)
+xend_set_memory(virConnectPtr xend, const char *name, uint64_t value)
{
char buf[1024];
* Returns 0 on success; -1 (with errno) on error
*/
int
-xend_vbd_create(struct xend *xend,
+xend_vbd_create(virConnectPtr xend,
const char *name, const struct xend_device_vbd *vbd)
{
char buffer[4096];
* Returns 0 on success; -1 (with errno) on error
*/
int
-xend_vbd_destroy(struct xend *xend,
+xend_vbd_destroy(virConnectPtr xend,
const char *name, const struct xend_device_vbd *vbd)
{
return xend_op(xend, name, "op", "device_destroy", "type", "vbd",
* Returns 0 on success; -1 (with errno) on error
*/
int
-xend_vif_create(struct xend *xend,
+xend_vif_create(virConnectPtr xend,
const char *name, const struct xend_device_vif *vif)
{
char buffer[4096];
}
static int
-get_vif_handle(struct xend *xend,
- const char *name,
+get_vif_handle(virConnectPtr xend,
+ const char *name ATTRIBUTE_UNUSED,
const struct xend_device_vif *vif,
char *buffer, size_t n_buffer)
{
* Returns 0 on success; -1 (with errno) on error
*/
int
-xend_vif_destroy(struct xend *xend,
+xend_vif_destroy(virConnectPtr xend,
const char *name, const struct xend_device_vif *vif)
{
char handle[1024];
* Returns domain info on success; NULL (with errno) on error
*/
struct xend_domain *
-xend_get_domain(struct xend *xend, const char *domname)
+xend_get_domain(virConnectPtr xend, const char *domname)
{
struct sexpr *root;
struct xend_domain *dom = NULL;
* Returns node info on success; NULL (with errno) on error
*/
struct xend_node *
-xend_get_node(struct xend *xend)
+xend_get_node(virConnectPtr xend)
{
struct sexpr *root;
struct xend_node *node = NULL;
* Returns 0 on success; -1 (with errno) on error
*/
int
-xend_node_shutdown(struct xend *xend)
+xend_node_shutdown(virConnectPtr xend)
{
return xend_node_op(xend, "/xend/node/", "op", "shutdown", NULL);
}
* Returns 0 on success; -1 (with errno) on error
*/
int
-xend_node_restart(struct xend *xend)
+xend_node_restart(virConnectPtr xend)
{
return xend_node_op(xend, "/xend/node/", "op", "restart", NULL);
}
* Returns 0 on success; -1 (with errno) on error
*/
int
-xend_dmesg(struct xend *xend, char *buffer, size_t n_buffer)
+xend_dmesg(virConnectPtr xend, char *buffer, size_t n_buffer)
{
return http2unix(xend_get(xend, "/xend/node/dmesg", buffer, n_buffer));
}
* Returns 0 on success; -1 (with errno) on error
*/
int
-xend_dmesg_clear(struct xend *xend)
+xend_dmesg_clear(virConnectPtr xend)
{
return xend_node_op(xend, "/xend/node/dmesg", "op", "clear", NULL);
}
* Returns 0 on success; -1 (with errno) on error
*/
int
-xend_log(struct xend *xend, char *buffer, size_t n_buffer)
+xend_log(virConnectPtr xend, char *buffer, size_t n_buffer)
{
return http2unix(xend_get(xend, "/xend/node/log", buffer, n_buffer));
}
#include <stdint.h>
#include <stdbool.h>
+#include "libvir.h"
+
#ifdef __cplusplus
extern "C" {
#endif
*/
#define XEND_DEFAULT 0
-/**
- Flags that determine the permission to expose a device to the guest as.
-*/
-enum xend_device_vbd_mode
-{
- /**
- Expose the device as read only.
- */
- XEND_READ_ONLY = 1,
-
- /**
- Expose the device as read/write with an in-use check.
-
- If Xend thinks the device is already in use, it will generate an
- error. It uses heuristics so it will not always catch every
- instance of this and will sometimes generate false positives.
- */
- XEND_READ_WRITE,
-
- /**
- Expose the device as read/only without an in-use check.
- */
- XEND_READ_WRITE_FORCE,
-};
-
-/**
- Flags that determine the action to take on a shutdown or crash.
-*/
-enum xend_domain_restart
-{
- /**
- Destroy the domain.
- */
- XEND_DESTROY = 1,
-
- /**
- Restart the domain.
- */
- XEND_RESTART,
-
- /**
- Take no action. The domain will have to be manually destroyed by
- the user. Useful for debugging.
- */
- XEND_PRESERVE,
-
- /**
- Rename the domain to something unique and then create a new instance
- of the domain. Useful for debugging crashes while avoiding
- down time.
- */
- XEND_RENAME_RESTART,
-};
-
/**
Xend context.
*/
struct xend;
-/**
- This structure the image information for a guest.
-*/
-struct xend_image
-{
- /**
- A filename pointing to a paravirtual Xen kernel.
-
- Required.
- */
- const char *kernel;
-
- /**
- A filename pointing to an initrd.
-
- Optional
- */
- const char *ramdisk;
-
- /**
- The root block device.
-
- Optional
- */
- const char *root;
-
- /**
- The kernel command line.
-
- Optional.
- */
- const char *extra;
-};
-
/**
This structure represents a virtual block device.
*/
Required.
*/
- enum xend_device_vbd_mode mode;
+ virDeviceMode mode;
};
/**
Optional.
*/
- enum xend_domain_restart on_poweroff;
+ virDomainRestart on_poweroff;
/**
The action to perform when the domain reboots.
Optional.
*/
- enum xend_domain_restart on_reboot;
+ virDomainRestart on_reboot;
/**
The action to perform when the domain crashes.
Optional.
*/
- enum xend_domain_restart on_crash;
+ virDomainRestart on_crash;
/**
The number of VCPUs to assign to the domain.
/* FIXME cpus */
- struct xend_image image;
+ virDomainKernel image;
/**
The number of VBDs pointed to be vbds.
};
/**
- * \brief Allocate a new Xend instance
- * \return A new xend instance
+ * \brief Setup the connection to the local Xend instance
+ * \return 0 in case of success, -1 in case of error
*
* This method creates a new Xend instance preferrably trying
* to connect with the domain socket but if necessary using
* TCP (only on localhost though).
*
* This function may not fail if Xend is not running.
+ *
+ * Make sure to call xend_cleanup().
*/
-struct xend *xend_new(void);
+int xend_setup(virConnectPtr conn);
/**
- * \brief Creates a new xend instance via TCP
+ * \brief Setup the connection to a xend instance via TCP
* \param host The host name to connect to
* \param port The port number to connect to
- * \return A new xend instance
+ * \return 0 in case of success, -1 in case of error
*
* This method creates a new Xend instance via TCP.
*
* This function may not fail if Xend is not running.
*
- * Make sure to call xen_delete().
+ * Make sure to call xend_cleanup().
*/
-struct xend *xend_new_tcp(const char *host, int port);
+int xend_setup_tcp(virConnectPtr xend, const char *host, int port);
/**
- * \brief Creates a new xend instance via a Unix domain socket
+ * \brief Setup the connection to xend instance via a Unix domain socket
* \param path The path to the domain socket
- * \return A new xend instance
+ * \return 0 in case of success, -1 in case of error
*
* This method creates a new xend instance via a Unix domain socket.
*
* This function may not fail if Xend is not running.
*
- * Make sure to call xen_delete().
+ * Make sure to call xend_cleanup().
*/
-struct xend *xend_new_unix(const char *path);
+int xend_setup_unix(virConnectPtr xend, const char *path);
/**
* \brief Delete a previously allocated Xend instance
* \param xend The xend instance
*
- * This method should be called when a xend instance
- * allocated with xend_new[_{tcp, unix}] is no longer needed
+ * This method should be called when a connection to xend instance
+ * initialized with xend_setup[_{tcp, unix}] is no longer needed
* to free the associated resources.
*/
-void xend_delete(struct xend *xend);
+void xend_cleanup(virConnectPtr xend);
/**
* \brief Blocks until a domain's devices are initialized
* invalid filename, the error won't occur until after this function
* returns.
*/
-int xend_wait_for_devices(struct xend *xend, const char *name);
+int xend_wait_for_devices(virConnectPtr xend, const char *name);
/**
* \brief Pause a domain
* This method will make sure that Xen does not schedule the domain
* anymore until after xend_unpause() has been called.
*/
-int xend_pause(struct xend *xend, const char *name);
+int xend_pause(virConnectPtr xend, const char *name);
/**
* \brief Unpause a domain
* This method will allow a paused domain (the result of xen_pause())
* to be scheduled in the future.
*/
-int xend_unpause(struct xend *xend, const char *name);
+int xend_unpause(virConnectPtr xend, const char *name);
/**
* \brief Unpause a domain
*
* This method allows a domain to have its name changed after creation.
*/
-int xend_rename(struct xend *xend, const char *oldname, const char *name);
+int xend_rename(virConnectPtr xend, const char *oldname, const char *name);
/**
* \brief Sends a SYSRQ to a domain
*
* This method simulates the pressing of a SYSRQ sequence.
*/
-int xend_sysrq(struct xend *xend, const char *name, const char *key);
+int xend_sysrq(virConnectPtr xend, const char *name, const char *key);
/**
* \brief Request a domain to reboot
* a request and the domain may ignore it. It will return immediately
* after queuing the request.
*/
-int xend_reboot(struct xend *xend, const char *name);
+int xend_reboot(virConnectPtr xend, const char *name);
/**
* \brief Request a domain to shutdown
* a request and the domain may ignore it. It will return immediately
* after queuing the request.
*/
-int xend_shutdown(struct xend *xend, const char *name);
+int xend_shutdown(virConnectPtr xend, const char *name);
/**
* \brief Destroy a domain
* dying and will go away completely once all of the resources have been
* unmapped (usually from the backend devices).
*/
-int xend_destroy(struct xend *xend, const char *name);
+int xend_destroy(virConnectPtr xend, const char *name);
/**
* \brief Save a domain to the disk
* a file on disk. Use xend_restore() to restore a domain after
* saving.
*/
-int xend_save(struct xend *xend, const char *name, const char *filename);
+int xend_save(virConnectPtr xend, const char *name, const char *filename);
/**
* \brief Restore a domain from the disk
*
* This method will restore a domain saved to disk by xend_save().
*/
-int xend_restore(struct xend *xend, const char *filename);
+int xend_restore(virConnectPtr xend, const char *filename);
/**
* \brief Obtain a list of currently running domains
* This method will return an array of names of currently running
* domains. The memory should be released will a call to free().
*/
-char **xend_get_domains(struct xend *xend);
+char **xend_get_domains(virConnectPtr xend);
/**
* \brief Create a new domain
* domain will be paused after creation and must be unpaused with
* xend_unpause() to begin execution.
*/
-int xend_create(struct xend *xend, const struct xend_domain *info);
+int xend_create(virConnectPtr xend, const struct xend_domain *info);
/**
* \brief Set the maximum memory for a domain
* on its own (although under normal circumstances, memory allocation for a
* domain is only done through xend_set_memory()).
*/
-int xend_set_max_memory(struct xend *xend, const char *name, uint64_t value);
+int xend_set_max_memory(virConnectPtr xend, const char *name, uint64_t value);
/**
* \brief Set the memory allocation for a domain
* There is no safe guard for allocations that are too small so be careful
* when using this function to reduce a domain's memory usage.
*/
-int xend_set_memory(struct xend *xend, const char *name, uint64_t value);
+int xend_set_memory(virConnectPtr xend, const char *name, uint64_t value);
/**
* \brief Create a virtual block device
* rather, one should use xend_wait_for_devices() to block until the device
* has been successfully attached.
*/
-int xend_vbd_create(struct xend *xend,
+int xend_vbd_create(virConnectPtr xend,
const char *name,
const struct xend_device_vbd *vbd);
* should use xend_wait_for_devices() to block until the device has been
* successfully detached.
*/
-int xend_vbd_destroy(struct xend *xend,
+int xend_vbd_destroy(virConnectPtr xend,
const char *name,
const struct xend_device_vbd *vbd);
* rather, one should use xend_wait_for_devices() to network until the device
* has been successfully attached.
*/
-int xend_vif_create(struct xend *xend,
+int xend_vif_create(virConnectPtr xend,
const char *name,
const struct xend_device_vif *vif);
* rather, one should use xend_wait_for_devices() to network until the device
* has been successfully detached.
*/
-int xend_vif_destroy(struct xend *xend,
+int xend_vif_destroy(virConnectPtr xend,
const char *name,
const struct xend_device_vif *vif);
* it in the form of a struct xend_domain. This should be
* free()'d when no longer needed.
*/
-struct xend_domain *xend_get_domain(struct xend *xend,
+struct xend_domain *xend_get_domain(virConnectPtr xend,
const char *name);
/**
* This method returns information about the physical host
* machine running Xen.
*/
-struct xend_node *xend_get_node(struct xend *xend);
+struct xend_node *xend_get_node(virConnectPtr xend);
/**
* \brief Shutdown physical host machine
*
* This method shuts down the physical machine running Xen.
*/
-int xend_node_shutdown(struct xend *xend);
+int xend_node_shutdown(virConnectPtr xend);
/**
* \brief Restarts physical host machine
*
* This method restarts the physical machine running Xen.
*/
-int xend_node_restart(struct xend *xend);
+int xend_node_restart(virConnectPtr xend);
/**
* \brief Return hypervisor debugging messages
* This function will place the debugging messages from the
* hypervisor into a buffer with a null terminator.
*/
-int xend_dmesg(struct xend *xend,
+int xend_dmesg(virConnectPtr xend,
char *buffer,
size_t n_buffer);
* This function will clear the debugging message ring queue
* in the hypervisor.
*/
-int xend_dmesg_clear(struct xend *xend);
+int xend_dmesg_clear(virConnectPtr xend);
/**
* \brief Obtain the Xend log messages
* This function will place the Xend debugging messages into
* a buffer with a null terminator.
*/
-int xend_log(struct xend *xend,
+int xend_log(virConnectPtr xend,
char *buffer,
size_t n_buffer);
projects / thirdparty / libvirt.git / commitdiff
