API documentation		The XML C parser and toolkit of Gnome

Provides the interfaces of the libvir library to handle Xen domains from a process running in domain 0

Table of Contents

Structure virConnect
struct _virConnect
The content of this structure is not made public by the API.

Typedef virConnect * virConnectPtr

Structure virDomain
struct _virDomain
The content of this structure is not made public by the API.

Enum virDomainFlags

Structure virDomainInfo
struct _virDomainInfo

Typedef virDomainInfo * virDomainInfoPtr

Typedef virDomain * virDomainPtr

Enum virDomainState

int	virConnectClose			(virConnectPtr conn)

unsigned long	virConnectGetVersion	(virConnectPtr conn)

int	virConnectListDomains		(virConnectPtr conn, 
					 int * ids, 
					 int maxids)

virConnectPtr	virConnectOpen		(const char * name)

virConnectPtr	virConnectOpenReadOnly	(const char * name)

virDomainPtr	virDomainCreateLinux	(virConnectPtr conn, 
					 const char * kernel_path, 
					 const char * initrd_path, 
					 const char * cmdline, 
					 unsigned long memory, 
					 unsigned int flags)

int	virDomainDestroy		(virDomainPtr domain)

unsigned int	virDomainGetID		(virDomainPtr domain)

int	virDomainGetInfo		(virDomainPtr domain, 
					 virDomainInfoPtr info)

unsigned long	virDomainGetMaxMemory	(virDomainPtr domain)

const char *	virDomainGetName	(virDomainPtr domain)

virDomainPtr	virDomainLookupByID	(virConnectPtr conn, 
					 int id)

virDomainPtr	virDomainLookupByName	(virConnectPtr conn, 
					 const char * name)

int	virDomainResume			(virDomainPtr domain)

int	virDomainSetMaxMemory		(virDomainPtr domain, 
					 unsigned long memory)

int	virDomainSuspend		(virDomainPtr domain)

Description

Structure virConnect

Structure virConnect
struct _virConnect {
The content of this structure is not made public by the API.
}

Structure virDomain

Structure virDomain
struct _virDomain {
The content of this structure is not made public by the API.
}

Enum virDomainFlags

Enum virDomainFlags {
    VIR_DOMAIN_NONE = 0
}

Structure virDomainInfo

Structure virDomainInfo
struct _virDomainInfo {
    unsigned char	state	: the running state, one of virDomainFlag
    unsigned long	maxMem	: the maximum memory in KBytes allowed
    unsigned long	memory	: the memory in KBytes used by the domain
    unsigned short	nrVirtCpu	: * Informations below are only available
    unsigned long long	cpuTime	: * TODO: * - check what can be extracted
}

Enum virDomainState

Enum virDomainState {
    VIR_DOMAIN_NOSTATE = 0 : no state
    VIR_DOMAIN_RUNNING = 1 : the domain is running
    VIR_DOMAIN_BLOCKED = 2 : the domain is blocked on resource
    VIR_DOMAIN_PAUSED = 3 : the domain is paused by user
    VIR_DOMAIN_SHUTDOWN = 4 : the domain is being shut down
    VIR_DOMAIN_SHUTOFF = 5 : the domain is shut off
}

Function: virConnectClose

int	virConnectClose			(virConnectPtr conn)

This function closes the connection to the Hypervisor. This should not be called if further interaction with the Hypervisor are needed especially if there is running domain which need further monitoring by the application.

Function: virConnectGetVersion

unsigned long	virConnectGetVersion	(virConnectPtr conn)

Get the version level of the Hypervisor running.

Function: virConnectListDomains

int	virConnectListDomains		(virConnectPtr conn, 
					 int * ids, 
					 int maxids)

Collect the list of active domains, and store their ID in @maxids

Function: virConnectOpen

virConnectPtr	virConnectOpen		(const char * name)

This function should be called first to get a connection to the Hypervisor and xen store

Function: virConnectOpenReadOnly

virConnectPtr	virConnectOpenReadOnly	(const char * name)

This function should be called first to get a read-only connection to the xen store. The set of APIs usable are then restricted.

Function: virDomainCreateLinux

virDomainPtr	virDomainCreateLinux	(virConnectPtr conn, 
					 const char * kernel_path, 
					 const char * initrd_path, 
					 const char * cmdline, 
					 unsigned long memory, 
					 unsigned int flags)

Launch a new Linux guest domain

Function: virDomainDestroy

int	virDomainDestroy		(virDomainPtr domain)

Destroy the domain object. The running instance is shutdown if not down already and all resources used by it are given back to the hypervisor.

Function: virDomainGetID

unsigned int	virDomainGetID		(virDomainPtr domain)

Get the hypervisor ID number for the domain

Function: virDomainGetInfo

int	virDomainGetInfo		(virDomainPtr domain, 
					 virDomainInfoPtr info)

Extract information about a domain. Note that if the connection used to get the domain is limited only a partial set of the informations can be extracted.

Function: virDomainGetMaxMemory

unsigned long	virDomainGetMaxMemory	(virDomainPtr domain)

Retrieve the maximum amount of physical memory allocated to a domain. If domain is NULL, then this get the amount of memory reserved to Domain0 i.e. the domain where the application runs.

Function: virDomainGetName

const char *	virDomainGetName	(virDomainPtr domain)

Get the public name for that domain

Function: virDomainLookupByID

virDomainPtr	virDomainLookupByID	(virConnectPtr conn, 
					 int id)

Try to find a domain based on the hypervisor ID number

Function: virDomainLookupByName

virDomainPtr	virDomainLookupByName	(virConnectPtr conn, 
					 const char * name)

Try to lookup a domain on the given hypervisor

Function: virDomainResume

int	virDomainResume			(virDomainPtr domain)

Resume an suspended domain, the process is restarted from the state where it was frozen by calling virSuspendDomain().

Function: virDomainSetMaxMemory

int	virDomainSetMaxMemory		(virDomainPtr domain, 
					 unsigned long memory)

Dynamically change the maximum amount of physical memory allocated to a domain. If domain is NULL, then this change the amount of memory reserved to Domain0 i.e. the domain where the application runs.

Function: virDomainSuspend

int	virDomainSuspend		(virDomainPtr domain)

Suspends an active domain, the process is frozen without further access to CPU resources and I/O but the memory used by the domain at the hypervisor level will stay allocated. Use virDomainResume() to reactivate the domain.

Daniel Veillard