List of function manipulating types in libvirt

Type int *:

virConnectListDomains

Type unsigned int:

virDomainCreateLinux
-

Type unsigned long:

virDomainCreateLinux
-virDomainSetMaxMemory
+

Type unsigned long:

virDomainSetMaxMemory

Type unsigned long *:

virConnectGetVersion
virGetVersion

Type virConnectPtr:

virConnectClose
diff --git a/docs/html/libvirt-libvirt.html b/docs/html/libvirt-libvirt.html index 228112f727..9419c7e9ca 100644 --- a/docs/html/libvirt-libvirt.html +++ b/docs/html/libvirt-libvirt.html @@ -21,7 +21,7 @@ The content of this structure is not made public by the API.

int	virConnectNumOfDomains		(virConnectPtr conn)

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)

virDomainPtr	virDomainCreateLinux	(virConnectPtr conn, 
					 const char * xmlDesc, 
					 unsigned int flags)

int	virDomainDestroy		(virDomainPtr domain)

int	virDomainFree			(virDomainPtr domain)

unsigned int	virDomainGetID		(virDomainPtr domain)

@@ -102,9 +102,9 @@ The content of this structure is not made public by the API.

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

`name`:	optional argument currently unused, pass NULL
`Returns`:	a pointer to the hypervisor connection or NULL in case of error

Function: virConnectOpenReadOnly

virConnectPtr	virConnectOpenReadOnly	(const char * name)

This function should be called first to get a restricted connection to the libbrary functionalities. The set of APIs usable are then restricted on the available methods to control the domains.

`name`:	optional argument currently unused, pass NULL
`Returns`:	a pointer to the hypervisor connection or NULL in case of error

Function: virDomainCreateLinux

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

+name: optional argument currently unused, pass NULL
Returns: a pointer to the hypervisor connection or NULL in case of error
Function: virDomainCreateLinux
virDomainPtr	virDomainCreateLinux	(virConnectPtr conn, 
					 const char * xmlDesc, 
					 unsigned int flags)

 
Launch a new Linux guest domain, unimplemented yet, API to be defined. This would function requires priviledged access to the hypervisor.
-conn: pointer to the hypervisor connection
kernel_path: the file path to the kernel image
initrd_path: an optional file path to an initrd
cmdline: optional command line parameters for the kernel
memory: the memory size in kilobytes
flags: an optional set of virDomainFlags
Returns: a new domain object or NULL in case of failure
Function: virDomainDestroy
int	virDomainDestroy		(virDomainPtr domain)

+conn: pointer to the hypervisor connection
xmlDesc: an XML description of the domain
flags: an optional set of virDomainFlags
Returns: a new domain object or NULL in case of failure
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. The data structure is freed and should not be used thereafter if the call does not return an error. This function may requires priviledged access
 domain: a domain object
Returns: 0 in case of success and -1 in case of failure.
Function: virDomainFree
int	virDomainFree			(virDomainPtr domain)

 
Free the domain object. The running instance is kept alive. The data structure is freed and should not be used thereafter.
diff --git a/docs/libvirt-api.xml b/docs/libvirt-api.xml
index 450487ac42..f19b6cada7 100644
--- a/docs/libvirt-api.xml
+++ b/docs/libvirt-api.xml
@@ -162,10 +162,7 @@
       Launch a new Linux guest domain, unimplemented yet, API to be defined. This would function requires priviledged access to the hypervisor.
       
       
-      
-      
-      
-      
+      
       
     
     
diff --git a/docs/libvirt-refs.xml b/docs/libvirt-refs.xml
index af83e808a8..ac86df8cbd 100644
--- a/docs/libvirt-refs.xml
+++ b/docs/libvirt-refs.xml
@@ -149,7 +149,6 @@
       
     
     
-      
       
     
     
@@ -427,6 +426,7 @@
       
       
         
+          
           
         
         
@@ -588,7 +588,6 @@
         
         
           
-          
         
         
           
@@ -631,6 +630,7 @@
           
         
         
+          
           
         
         
@@ -703,7 +703,6 @@
           
         
         
-          
           
         
         
@@ -722,7 +721,6 @@
         
           
           
-          
           
           
           
@@ -824,7 +822,6 @@
         
         
           
-          
         
         
           
@@ -836,9 +833,6 @@
         
           
         
-        
-          
-        
         
           
           
@@ -862,10 +856,8 @@
         
         
           
-          
         
         
-          
           
           
         
@@ -897,7 +889,6 @@
         
         
           
-          
         
         
           
@@ -932,7 +923,6 @@
         
         
           
-          
           
           
           
@@ -1051,7 +1041,6 @@
         
         
           
-          
         
         
           
@@ -1061,7 +1050,6 @@
           
         
         
-          
           
           
         
@@ -1222,7 +1210,6 @@
         
         
           
-          
           
           
         
diff --git a/include/libvirt.h b/include/libvirt.h
index 10f271b4f5..b6951868b6 100644
--- a/include/libvirt.h
+++ b/include/libvirt.h
@@ -200,10 +200,7 @@ int			virConnectNumOfDomains	(virConnectPtr conn);
  * Domain creation and destruction
  */
 virDomainPtr		virDomainCreateLinux	(virConnectPtr conn,
-						 const char *kernel_path,
-						 const char *initrd_path,
-						 const char *cmdline,
-						 unsigned long memory,
+						 const char *xmlDesc,
 						 unsigned int flags);
 virDomainPtr		virDomainLookupByName	(virConnectPtr conn,
 						 const char *name);
diff --git a/include/libvirt.h.in b/include/libvirt.h.in
index aa7e0221e2..6655c388e5 100644
--- a/include/libvirt.h.in
+++ b/include/libvirt.h.in
@@ -200,10 +200,7 @@ int			virConnectNumOfDomains	(virConnectPtr conn);
  * Domain creation and destruction
  */
 virDomainPtr		virDomainCreateLinux	(virConnectPtr conn,
-						 const char *kernel_path,
-						 const char *initrd_path,
-						 const char *cmdline,
-						 unsigned long memory,
+						 const char *xmlDesc,
 						 unsigned int flags);
 virDomainPtr		virDomainLookupByName	(virConnectPtr conn,
 						 const char *name);
diff --git a/include/libvirt/libvirt.h b/include/libvirt/libvirt.h
index 10f271b4f5..b6951868b6 100644
--- a/include/libvirt/libvirt.h
+++ b/include/libvirt/libvirt.h
@@ -200,10 +200,7 @@ int			virConnectNumOfDomains	(virConnectPtr conn);
  * Domain creation and destruction
  */
 virDomainPtr		virDomainCreateLinux	(virConnectPtr conn,
-						 const char *kernel_path,
-						 const char *initrd_path,
-						 const char *cmdline,
-						 unsigned long memory,
+						 const char *xmlDesc,
 						 unsigned int flags);
 virDomainPtr		virDomainLookupByName	(virConnectPtr conn,
 						 const char *name);
diff --git a/include/libvirt/libvirt.h.in b/include/libvirt/libvirt.h.in
index aa7e0221e2..6655c388e5 100644
--- a/include/libvirt/libvirt.h.in
+++ b/include/libvirt/libvirt.h.in
@@ -200,10 +200,7 @@ int			virConnectNumOfDomains	(virConnectPtr conn);
  * Domain creation and destruction
  */
 virDomainPtr		virDomainCreateLinux	(virConnectPtr conn,
-						 const char *kernel_path,
-						 const char *initrd_path,
-						 const char *cmdline,
-						 unsigned long memory,
+						 const char *xmlDesc,
 						 unsigned int flags);
 virDomainPtr		virDomainLookupByName	(virConnectPtr conn,
 						 const char *name);
diff --git a/python/tests/create.py b/python/tests/create.py
new file mode 100755
index 0000000000..c31eaa4831
--- /dev/null
+++ b/python/tests/create.py
@@ -0,0 +1,46 @@
+#!/usr/bin/python -u
+import libvirt
+import sys
+
+conn = libvirt.openReadOnly(None)
+if conn == None:
+    print 'Failed to open connection to the hypervisor'
+    sys.exit(1)
+
+xmldesc="""
+  test
+  
+    linux
+    /boot/vmlinuz-2.6.15-1.43_FC5guest
+    /boot/initrd-2.6.15-1.43_FC5guest.img
+     root=/dev/sda1 ro selinux=0 3
+  
+  131072
+  1
+  
+    
+      
+      
+    
+    
+      
+      
+

Letter U:

Letter X:

Letter X:

Letter a:

Letter i:

Letter k:

Letter l:

Letter p:

List of function manipulating types in libvirt

Type int *:

Type unsigned int:

Type unsigned long:

Type unsigned long:

Type unsigned long *:

Type virConnectPtr:

Function: virConnectOpenReadOnly

Function: virDomainCreateLinux

Function: virDomainCreateLinux

Function: virDomainDestroy

Function: virDomainDestroy

Function: virDomainFree

`conn`:	pointer to the hypervisor connection
`kernel_path`:	the file path to the kernel image
`initrd_path`:	an optional file path to an initrd
`cmdline`:	optional command line parameters for the kernel
`memory`:	the memory size in kilobytes
`flags`:	an optional set of virDomainFlags
`Returns`:	a new domain object or NULL in case of failure

`conn`:	pointer to the hypervisor connection
`xmlDesc`:	an XML description of the domain
`flags`:	an optional set of virDomainFlags
`Returns`:	a new domain object or NULL in case of failure

`domain`:	a domain object
`Returns`:	0 in case of success and -1 in case of failure.