External/libvirt
1
0
Fork 0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2025-02-01 17:35:17 +00:00
Code Issues Packages Projects Releases Wiki Activity

Fix typo "informations" -> "information" (Atsushi SAKAI and

Browse Source 
Saori FUKUTA).
This commit is contained in:
Richard W.M. Jones 2008-03-14 11:08:03 +00:00
parent adbf991a1d
commit 3e59e29859
26 changed files with 103 additions and 98 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
ChangeLog
View File

@ -1,3 +1,8 @@
Fri Mar 14 11:01:00 BST 2008 Richard W.M. Jones <rjones@redhat.com>
Fix typo "informations" -> "information" (Atsushi SAKAI and
Saori FUKUTA).
Thu Mar 13 10:24:45 CET 2008 Daniel Veillard <veillard@redhat.com> Thu Mar 13 10:24:45 CET 2008 Daniel Veillard <veillard@redhat.com>
* src/libvirt.c: virDomainSetSchedulerParameters need to be * src/libvirt.c: virDomainSetSchedulerParameters need to be

2
docs/apibuild.py
View File

@ -752,7 +752,7 @@ class CParser:
return((args, desc)) return((args, desc))
# #
# Parse a comment block and merge the informations found in the # Parse a comment block and merge the information found in the
# parameters descriptions, finally returns a block as complete # parameters descriptions, finally returns a block as complete
# as possible # as possible
# #

4
docs/architecture.html
View File

@ -8,7 +8,7 @@ engines:</p><ul><li><a href="#Xen">Xen hypervisor</a></li>
</ul><h3><a name="Xen" id="Xen">Libvirt Xen support</a></h3><p>When running in a Xen environment, programs using libvirt have to execute </ul><h3><a name="Xen" id="Xen">Libvirt Xen support</a></h3><p>When running in a Xen environment, programs using libvirt have to execute
in "Domain 0", which is the primary Linux OS loaded on the machine. That OS 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 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 domains. It also runs the Xen Store, a database of information shared by the
hypervisor, the kernels, the drivers and the xen daemon. Xend. The xen daemon hypervisor, the kernels, the drivers and the xen daemon. Xend. The xen daemon
supervise the control and execution of the sets of domains. The hypervisor, supervise the control and execution of the sets of domains. The hypervisor,
drivers, kernels and daemons communicate though a shared system bus drivers, kernels and daemons communicate though a shared system bus
@ -23,7 +23,7 @@ the Xen infrastructure:</p><ul><li>a connection to the Xen Daemon though an HTTP
as root and providing read-only support</li> as root and providing read-only support</li>
</ul><p>The library will usually interact with the Xen daemon for any operation </ul><p>The library will usually interact with the Xen daemon for any operation
changing the state of the system, but for performance and accuracy reasons changing the state of the system, but for performance and accuracy reasons
may talk directly to the hypervisor when gathering state informations at may talk directly to the hypervisor when gathering state information at
least when possible (i.e. when the running program using libvirt has root least when possible (i.e. when the running program using libvirt has root
priviledge access).</p><p>If it runs without root access virConnectOpenReadOnly() should be used to priviledge access).</p><p>If it runs without root access virConnectOpenReadOnly() should be used to
connect to initialize the library. It will then fork a libvirt_proxy connect to initialize the library. It will then fork a libvirt_proxy

4
docs/devhelp/libvirt-libvirt.html
View File

@ -404,8 +404,8 @@ The content of this structure is not made public by the API.
</div> </div>
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="virDomainXMLFlags">Enum </a>virDomainXMLFlags</h3><pre class="programlisting">enum <a href="#virDomainXMLFlags">virDomainXMLFlags</a> { <div class="refsect2" lang="en"><h3><a name="virDomainXMLFlags">Enum </a>virDomainXMLFlags</h3><pre class="programlisting">enum <a href="#virDomainXMLFlags">virDomainXMLFlags</a> {
<a name="VIR_DOMAIN_XML_SECURE">VIR_DOMAIN_XML_SECURE</a> = 1 /* dump security sensitive informations too */ <a name="VIR_DOMAIN_XML_SECURE">VIR_DOMAIN_XML_SECURE</a> = 1 /* dump security sensitive information too */
<a name="VIR_DOMAIN_XML_INACTIVE">VIR_DOMAIN_XML_INACTIVE</a> = 2 /* dump inactive domain informations */ <a name="VIR_DOMAIN_XML_INACTIVE">VIR_DOMAIN_XML_INACTIVE</a> = 2 /* dump inactive domain information */
}; };
</pre><p/> </pre><p/>
</div> </div>

12
docs/errors.html
View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /><link rel="stylesheet" type="text/css" href="libvirt.css" /><link rel="SHORTCUT ICON" href="/32favicon.png" /><title>Handling of errors</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">Handling of errors</h1><p>The main goals of libvirt when it comes to error handling are:</p><ul><li>provide as much detail as possible</li> <html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /><link rel="stylesheet" type="text/css" href="libvirt.css" /><link rel="SHORTCUT ICON" href="/32favicon.png" /><title>Handling of errors</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">Handling of errors</h1><p>The main goals of libvirt when it comes to error handling are:</p><ul><li>provide as much detail as possible</li>
<li>provide the informations as soon as possible</li> <li>provide the information as soon as possible</li>
<li>dont force the library user into one style of error handling</li> <li>dont force the library user into one style of error handling</li>
</ul><p>As result the library provide both synchronous, callback based and </ul><p>As result the library provide both synchronous, callback based and
asynchronous error reporting. When an error happens in the library code the asynchronous error reporting. When an error happens in the library code the
@ -15,7 +15,7 @@ dynamic structure which can be made thread specific. Error callback can be
set specifically to a connection with</p><p>So error handling in the code is the following:</p><ol><li>if the error can be associated to a connection for example when failing set specifically to a connection with</p><p>So error handling in the code is the following:</p><ol><li>if the error can be associated to a connection for example when failing
to look up a domain to look up a domain
<ol><li>if there is a callback associated to the connection set with <a href="html/libvirt-virterror.html#virConnSetErrorFunc">virConnSetErrorFunc</a>, <ol><li>if there is a callback associated to the connection set with <a href="html/libvirt-virterror.html#virConnSetErrorFunc">virConnSetErrorFunc</a>,
call it with the error informations</li> call it with the error information</li>
<li>otherwise if there is a global callback set with <a href="html/libvirt-virterror.html#virSetErrorFunc">virSetErrorFunc</a>, <li>otherwise if there is a global callback set with <a href="html/libvirt-virterror.html#virSetErrorFunc">virSetErrorFunc</a>,
call it with the error information</li> call it with the error information</li>
<li>otherwise call <a href="html/libvirt-virterror.html#virDefaultErrorFunc">virDefaultErrorFunc</a> <li>otherwise call <a href="html/libvirt-virterror.html#virDefaultErrorFunc">virDefaultErrorFunc</a>
@ -31,7 +31,7 @@ set specifically to a connection with</p><p>So error handling in the code is the
on stderr</li> on stderr</li>
<li>save the error in the connection for later retrieval with <a href="html/libvirt-virterror.html#virGetLastError">virGetLastError</a></li> <li>save the error in the connection for later retrieval with <a href="html/libvirt-virterror.html#virGetLastError">virGetLastError</a></li>
</ol></li> </ol></li>
</ol><p>In all cases the error informations are provided as a <a href="html/libvirt-virterror.html#virErrorPtr">virErrorPtr</a> pointer to </ol><p>In all cases the error information is provided as a <a href="html/libvirt-virterror.html#virErrorPtr">virErrorPtr</a> pointer to
read-only structure <a href="html/libvirt-virterror.html#virError">virError</a> containing the read-only structure <a href="html/libvirt-virterror.html#virError">virError</a> containing the
following fields:</p><ul><li>code: an error number from the <a href="html/libvirt-virterror.html#virErrorNumber">virErrorNumber</a> following fields:</p><ul><li>code: an error number from the <a href="html/libvirt-virterror.html#virErrorNumber">virErrorNumber</a>
enum</li> enum</li>
@ -44,10 +44,10 @@ following fields:</p><ul><li>code: an error number from the <a href="html/libvir
connection to the hypervisor where this happened</li> connection to the hypervisor where this happened</li>
<li>dom: if available a pointer to the <a href="html/libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain <li>dom: if available a pointer to the <a href="html/libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain
targetted in the operation</li> targetted in the operation</li>
</ul><p>and then extra raw informations about the error which may be initialized </ul><p>and then extra raw information about the error which may be initialized
to 0 or NULL if unused</p><ul><li>str1, str2, str3: string informations, usually str1 is the error to 0 or NULL if unused</p><ul><li>str1, str2, str3: string information, usually str1 is the error
message format</li> message format</li>
<li>int1, int2: integer informations</li> <li>int1, int2: integer information</li>
</ul><p>So usually, setting up specific error handling with libvirt consist of </ul><p>So usually, setting up specific error handling with libvirt consist of
registering an handler with with <a href="html/libvirt-virterror.html#virSetErrorFunc">virSetErrorFunc</a> or registering an handler with with <a href="html/libvirt-virterror.html#virSetErrorFunc">virSetErrorFunc</a> or
with <a href="html/libvirt-virterror.html#virConnSetErrorFunc">virConnSetErrorFunc</a>, with <a href="html/libvirt-virterror.html#virConnSetErrorFunc">virConnSetErrorFunc</a>,

4
docs/examples/examples.xml
View File

@ -1,7 +1,7 @@
<examples> <examples>
<example filename='info1.c'> <example filename='info1.c'>
<synopsis>Extract informations about Xen domain 0</synopsis> <synopsis>Extract information about Xen domain 0</synopsis>
<purpose>Demonstrate the basic use of the library to connect to the hypervisor and extract domain informations.</purpose> <purpose>Demonstrate the basic use of the library to connect to the hypervisor and extract domain information.</purpose>
<usage>info1</usage> <usage>info1</usage>
<test>info1</test> <test>info1</test>
<author>Daniel Veillard</author> <author>Daniel Veillard</author>

4
docs/examples/index.html
View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /><link rel="stylesheet" type="text/css" href="../libvirt.css" /><link rel="SHORTCUT ICON" href="/32favicon.png" /><title>Libvirt set of C code examples</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">Libvirt set of C code examples</h1><p> The examples are stored per section depending on the main focus <html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /><link rel="stylesheet" type="text/css" href="../libvirt.css" /><link rel="SHORTCUT ICON" href="/32favicon.png" /><title>Libvirt set of C code examples</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">Libvirt set of C code examples</h1><p> The examples are stored per section depending on the main focus
of the example:</p><ul><li><p><a href="#Informations">Informations</a> :</p><ul><li><a href="#info1.c">info1.c</a>: Extract informations about Xen domain 0</li></ul></li><li><p><a href="#Scheduling">Scheduling</a> :</p><ul><li><a href="#suspend.c">suspend.c</a>: Suspend a domain and then resume its execution</li></ul></li></ul><p> Getting the compilation options and libraries dependancies needed of the example:</p><ul><li><p><a href="#Informations">Informations</a> :</p><ul><li><a href="#info1.c">info1.c</a>: Extract information about Xen domain 0</li></ul></li><li><p><a href="#Scheduling">Scheduling</a> :</p><ul><li><a href="#suspend.c">suspend.c</a>: Suspend a domain and then resume its execution</li></ul></li></ul><p> Getting the compilation options and libraries dependancies needed
to generate binaries from the examples is best done on Linux/Unix by using to generate binaries from the examples is best done on Linux/Unix by using
the pkg-config data which should have been installed as part of <i>make the pkg-config data which should have been installed as part of <i>make
install</i> step or when installing the libvirt development package:</p><pre>gcc -o example example.c `pkg-config libvirt --libs`</pre><h2><a name="Informations" id="Informations"></a>Informations Examples</h2><h3><a name="info1.c" href="info1.c" id="info1.c">info1.c</a>: Extract informations about Xen domain 0</h3><p>Demonstrate the basic use of the library to connect to the hypervisor and extract domain informations.</p><p>Uses:</p><ul><li> line 29: Function <a href="../html/libvirt-libvirt.html#virConnectOpenReadOnly">virConnectOpenReadOnly</a> from libvirt.h</li><li> line 36: Function <a href="../html/libvirt-libvirt.html#virDomainLookupByID">virDomainLookupByID</a> from libvirt.h</li><li> line 43: Function <a href="../html/libvirt-libvirt.html#virDomainGetInfo">virDomainGetInfo</a> from libvirt.h</li><li> line 53: Function <a href="../html/libvirt-libvirt.html#virDomainFree">virDomainFree</a> from libvirt.h</li><li> line 55: Function <a href="../html/libvirt-libvirt.html#virConnectClose">virConnectClose</a> from libvirt.h</li></ul><p>Usage:</p><p>info1</p><p>Author: Daniel Veillard</p><h2><a name="Scheduling" id="Scheduling"></a>Scheduling Examples</h2><h3><a name="suspend.c" href="suspend.c" id="suspend.c">suspend.c</a>: Suspend a domain and then resume its execution</h3><p>Demonstrate the basic use of the library to suspend and resume a domain. If no id is given on the command line this script will suspend and resume the first domain found which is not Domain 0.</p><p>Uses:</p><ul><li> line 31: Function <a href="../html/libvirt-libvirt.html#virDomainGetInfo">virDomainGetInfo</a> from libvirt.h</li><li> line 50: Function <a href="../html/libvirt-libvirt.html#virDomainLookupByID">virDomainLookupByID</a> from libvirt.h</li><li> line 62: Function <a href="../html/libvirt-libvirt.html#virDomainSuspend">virDomainSuspend</a> from libvirt.h</li><li> line 73: Function <a href="../html/libvirt-libvirt.html#virDomainResume">virDomainResume</a> from libvirt.h</li><li> line 93: Function <a href="../html/libvirt-libvirt.html#virDomainFree">virDomainFree</a> from libvirt.h</li><li> line 100: Function <a href="../html/libvirt-libvirt.html#virConnectOpenReadOnly">virConnectOpenReadOnly</a> from libvirt.h</li><li> line 111: Function <a href="../html/libvirt-libvirt.html#virConnectListDomains">virConnectListDomains</a> from libvirt.h</li><li> line 132: Function <a href="../html/libvirt-libvirt.html#virConnectClose">virConnectClose</a> from libvirt.h</li></ul><p>Usage:</p><p>suspend [id]</p><p>Author: Daniel Veillard</p></div></div><div class="linkList2"><div class="llinks2"><h3 class="links2"><span>main menu</span></h3><ul><li><a href="../index.html">Home</a></li><li><a href="../html/index.html">API Menu</a></li><li><a href="../examples/index.html">C code examples</a></li><li><a href="../ChangeLog.html">Recent Changes</a></li></ul></div><div class="llinks2"><h3 class="links2"><span>related links</span></h3><ul><li><a href="https://www.redhat.com/archives/libvir-list/">Mail archive</a></li><li><a href="https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora+Core&amp;component=libvirt&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=MODIFIED&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;long_desc_type=allwordssubstr">Open bugs</a></li><li><a href="http://virt-manager.et.redhat.com/">virt-manager</a></li><li><a href="http://search.cpan.org/~danberr/Sys-Virt-0.1.0/">Perl bindings</a></li><li><a href="http://libvirt.org/ocaml/">OCaml bindings</a></li><li><a href="http://libvirt.org/ruby/">Ruby bindings</a></li><li><a href="http://www.cl.cam.ac.uk/Research/SRG/netos/xen/index.html">Xen project</a></li><li><form action="../search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="12" value="Search..." /><input name="submit" type="submit" value="Go" /></form></li><li><a href="http://xmlsoft.org/"><img src="../Libxml2-Logo-90x34.gif" alt="Made with Libxml2 Logo" /></a></li></ul><p class="credits">Graphics and design by <a href="mail:dfong@redhat.com">Diana Fong</a></p></div></div><div id="bottom"><p class="p1"></p></div></div></body></html> install</i> step or when installing the libvirt development package:</p><pre>gcc -o example example.c `pkg-config libvirt --libs`</pre><h2><a name="Informations" id="Informations"></a>Informations Examples</h2><h3><a name="info1.c" href="info1.c" id="info1.c">info1.c</a>: Extract information about Xen domain 0</h3><p>Demonstrate the basic use of the library to connect to the hypervisor and extract domain information.</p><p>Uses:</p><ul><li> line 29: Function <a href="../html/libvirt-libvirt.html#virConnectOpenReadOnly">virConnectOpenReadOnly</a> from libvirt.h</li><li> line 36: Function <a href="../html/libvirt-libvirt.html#virDomainLookupByID">virDomainLookupByID</a> from libvirt.h</li><li> line 43: Function <a href="../html/libvirt-libvirt.html#virDomainGetInfo">virDomainGetInfo</a> from libvirt.h</li><li> line 53: Function <a href="../html/libvirt-libvirt.html#virDomainFree">virDomainFree</a> from libvirt.h</li><li> line 55: Function <a href="../html/libvirt-libvirt.html#virConnectClose">virConnectClose</a> from libvirt.h</li></ul><p>Usage:</p><p>info1</p><p>Author: Daniel Veillard</p><h2><a name="Scheduling" id="Scheduling"></a>Scheduling Examples</h2><h3><a name="suspend.c" href="suspend.c" id="suspend.c">suspend.c</a>: Suspend a domain and then resume its execution</h3><p>Demonstrate the basic use of the library to suspend and resume a domain. If no id is given on the command line this script will suspend and resume the first domain found which is not Domain 0.</p><p>Uses:</p><ul><li> line 31: Function <a href="../html/libvirt-libvirt.html#virDomainGetInfo">virDomainGetInfo</a> from libvirt.h</li><li> line 50: Function <a href="../html/libvirt-libvirt.html#virDomainLookupByID">virDomainLookupByID</a> from libvirt.h</li><li> line 62: Function <a href="../html/libvirt-libvirt.html#virDomainSuspend">virDomainSuspend</a> from libvirt.h</li><li> line 73: Function <a href="../html/libvirt-libvirt.html#virDomainResume">virDomainResume</a> from libvirt.h</li><li> line 93: Function <a href="../html/libvirt-libvirt.html#virDomainFree">virDomainFree</a> from libvirt.h</li><li> line 100: Function <a href="../html/libvirt-libvirt.html#virConnectOpenReadOnly">virConnectOpenReadOnly</a> from libvirt.h</li><li> line 111: Function <a href="../html/libvirt-libvirt.html#virConnectListDomains">virConnectListDomains</a> from libvirt.h</li><li> line 132: Function <a href="../html/libvirt-libvirt.html#virConnectClose">virConnectClose</a> from libvirt.h</li></ul><p>Usage:</p><p>suspend [id]</p><p>Author: Daniel Veillard</p></div></div><div class="linkList2"><div class="llinks2"><h3 class="links2"><span>main menu</span></h3><ul><li><a href="../index.html">Home</a></li><li><a href="../html/index.html">API Menu</a></li><li><a href="../examples/index.html">C code examples</a></li><li><a href="../ChangeLog.html">Recent Changes</a></li></ul></div><div class="llinks2"><h3 class="links2"><span>related links</span></h3><ul><li><a href="https://www.redhat.com/archives/libvir-list/">Mail archive</a></li><li><a href="https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora+Core&amp;component=libvirt&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=MODIFIED&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;long_desc_type=allwordssubstr">Open bugs</a></li><li><a href="http://virt-manager.et.redhat.com/">virt-manager</a></li><li><a href="http://search.cpan.org/~danberr/Sys-Virt-0.1.0/">Perl bindings</a></li><li><a href="http://libvirt.org/ocaml/">OCaml bindings</a></li><li><a href="http://libvirt.org/ruby/">Ruby bindings</a></li><li><a href="http://www.cl.cam.ac.uk/Research/SRG/netos/xen/index.html">Xen project</a></li><li><form action="../search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="12" value="Search..." /><input name="submit" type="submit" value="Go" /></form></li><li><a href="http://xmlsoft.org/"><img src="../Libxml2-Logo-90x34.gif" alt="Made with Libxml2 Logo" /></a></li></ul><p class="credits">Graphics and design by <a href="mail:dfong@redhat.com">Diana Fong</a></p></div></div><div id="bottom"><p class="p1"></p></div></div></body></html>

12
docs/examples/info1.c
View File

@ -1,8 +1,8 @@
/** /**
* section: Informations * section: Informations
* synopsis: Extract informations about Xen domain 0 * synopsis: Extract information about Xen domain 0
* purpose: Demonstrate the basic use of the library to connect to the * purpose: Demonstrate the basic use of the library to connect to the
* hypervisor and extract domain informations. * hypervisor and extract domain information.
* usage: info1 * usage: info1
* test: info1 * test: info1
* author: Daniel Veillard * author: Daniel Veillard
@ -16,13 +16,13 @@
* getDomainInfo: * getDomainInfo:
* @id: the id of the domain * @id: the id of the domain
* *
* extract the domain 0 informations * extract the domain 0 information
*/ */
static void static void
getDomainInfo(int id) { getDomainInfo(int id) {
virConnectPtr conn = NULL; /* the hypervisor connection */ virConnectPtr conn = NULL; /* the hypervisor connection */
virDomainPtr dom = NULL; /* the domain being checked */ virDomainPtr dom = NULL; /* the domain being checked */
virDomainInfo info; /* the informations being fetched */ virDomainInfo info; /* the information being fetched */
int ret; int ret;
/* NULL means connect to local Xen hypervisor */ /* NULL means connect to local Xen hypervisor */
@ -39,10 +39,10 @@ getDomainInfo(int id) {
goto error; goto error;
} }
/* Get the informations */ /* Get the information */
ret = virDomainGetInfo(dom, &info); ret = virDomainGetInfo(dom, &info);
if (ret < 0) { if (ret < 0) {
fprintf(stderr, "Failed to get informations for Domain %d\n", id); fprintf(stderr, "Failed to get information for Domain %d\n", id);
goto error; goto error;
} }

4
docs/examples/suspend.c
View File

@ -25,7 +25,7 @@ static virConnectPtr conn = NULL; /* the hypervisor connection */
*/ */
static int static int
checkDomainState(virDomainPtr dom) { checkDomainState(virDomainPtr dom) {
virDomainInfo info; /* the informations being fetched */ virDomainInfo info; /* the information being fetched */
int ret; int ret;
ret = virDomainGetInfo(dom, &info); ret = virDomainGetInfo(dom, &info);
@ -39,7 +39,7 @@ checkDomainState(virDomainPtr dom) {
* SuspendAndResumeDomain: * SuspendAndResumeDomain:
* @id: the id of the domain * @id: the id of the domain
* *
* extract the domain 0 informations * extract the domain 0 information
*/ */
static void static void
SuspendAndResumeDomain(int id) { SuspendAndResumeDomain(int id) {

4
docs/format.html
View File

@ -157,7 +157,7 @@ systems:</p><pre>&lt;domain type='xen' id='3'&gt;
<li>the <code>&lt;os&gt;</code> block description is very different, first <li>the <code>&lt;os&gt;</code> block description is very different, first
it indicates that the type is 'hvm' for hardware virtualization, then it indicates that the type is 'hvm' for hardware virtualization, then
instead of a kernel, boot and command line arguments, it points to an os instead of a kernel, boot and command line arguments, it points to an os
boot loader which will extract the boot informations from the boot device boot loader which will extract the boot information from the boot device
specified in a separate boot element. The <code>dev</code> attribute on specified in a separate boot element. The <code>dev</code> attribute on
the <code>boot</code> tag can be one of: the <code>boot</code> tag can be one of:
<ul><li><code>fd</code> - boot from first floppy device</li> <ul><li><code>fd</code> - boot from first floppy device</li>
@ -415,7 +415,7 @@ it shows the CPU architecture, and the features of the chip (the feature
block is similar to what you will find in a Xen fully virtualized domain block is similar to what you will find in a Xen fully virtualized domain
description).</p><p>The second block (in blue) indicates the paravirtualization support of the description).</p><p>The second block (in blue) indicates the paravirtualization support of the
Xen support, you will see the os_type of xen to indicate a paravirtual Xen support, you will see the os_type of xen to indicate a paravirtual
kernel, then architecture informations and potential features.</p><p>The third block (in green) gives similar informations but when running a kernel, then architecture information and potential features.</p><p>The third block (in green) gives similar information but when running a
32 bit OS fully virtualized with Xen using the hvm support.</p><p>This section is likely to be updated and augmented in the future, see <a href="https://www.redhat.com/archives/libvir-list/2007-March/msg00215.html">the 32 bit OS fully virtualized with Xen using the hvm support.</p><p>This section is likely to be updated and augmented in the future, see <a href="https://www.redhat.com/archives/libvir-list/2007-March/msg00215.html">the
discussion</a> which led to the capabilities format in the mailing-list discussion</a> which led to the capabilities format in the mailing-list
archives.</p></div></div><div class="linkList2"><div class="llinks2"><h3 class="links2"><span>main menu</span></h3><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">libvirt architecture</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="format.html">XML Format</a></li><li><a href="python.html">Bindings for other languages</a></li><li><a href="errors.html">Handling of errors</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="windows.html">Windows support</a></li><li><a href="remote.html">Remote support</a></li><li><a href="auth.html">Access control</a></li><li><a href="uri.html">Connection URIs</a></li><li><a href="hvsupport.html">Hypervisor support</a></li><li><a href="storage.html">Storage Management</a></li><li><a href="html/index.html">API Menu</a></li><li><a href="examples/index.html">C code examples</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></div><div class="llinks2"><h3 class="links2"><span>related links</span></h3><ul><li><a href="https://www.redhat.com/archives/libvir-list/">Mail archive</a></li><li><a href="https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora+Core&amp;component=libvirt&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=MODIFIED&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;long_desc_type=allwordssubstr">Open bugs</a></li><li><a href="http://virt-manager.et.redhat.com/">virt-manager</a></li><li><a href="http://search.cpan.org/~danberr/Sys-Virt-0.1.0/">Perl bindings</a></li><li><a href="http://libvirt.org/ocaml/">OCaml bindings</a></li><li><a href="http://libvirt.org/ruby/">Ruby bindings</a></li><li><a href="http://www.cl.cam.ac.uk/Research/SRG/netos/xen/index.html">Xen project</a></li><li><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="12" value="Search..." /><input name="submit" type="submit" value="Go" /></form></li><li><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-90x34.gif" alt="Made with Libxml2 Logo" /></a></li></ul><p class="credits">Graphics and design by <a href="mail:dfong@redhat.com">Diana Fong</a></p></div></div><div id="bottom"><p class="p1"></p></div></div></body></html> archives.</p></div></div><div class="linkList2"><div class="llinks2"><h3 class="links2"><span>main menu</span></h3><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">libvirt architecture</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="format.html">XML Format</a></li><li><a href="python.html">Bindings for other languages</a></li><li><a href="errors.html">Handling of errors</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="windows.html">Windows support</a></li><li><a href="remote.html">Remote support</a></li><li><a href="auth.html">Access control</a></li><li><a href="uri.html">Connection URIs</a></li><li><a href="hvsupport.html">Hypervisor support</a></li><li><a href="storage.html">Storage Management</a></li><li><a href="html/index.html">API Menu</a></li><li><a href="examples/index.html">C code examples</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></div><div class="llinks2"><h3 class="links2"><span>related links</span></h3><ul><li><a href="https://www.redhat.com/archives/libvir-list/">Mail archive</a></li><li><a href="https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora+Core&amp;component=libvirt&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=MODIFIED&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;long_desc_type=allwordssubstr">Open bugs</a></li><li><a href="http://virt-manager.et.redhat.com/">virt-manager</a></li><li><a href="http://search.cpan.org/~danberr/Sys-Virt-0.1.0/">Perl bindings</a></li><li><a href="http://libvirt.org/ocaml/">OCaml bindings</a></li><li><a href="http://libvirt.org/ruby/">Ruby bindings</a></li><li><a href="http://www.cl.cam.ac.uk/Research/SRG/netos/xen/index.html">Xen project</a></li><li><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="12" value="Search..." /><input name="submit" type="submit" value="Go" /></form></li><li><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-90x34.gif" alt="Made with Libxml2 Logo" /></a></li></ul><p class="credits">Graphics and design by <a href="mail:dfong@redhat.com">Diana Fong</a></p></div></div><div id="bottom"><p class="p1"></p></div></div></body></html>

4
docs/html/libvirt-libvirt.html
View File

@ -261,8 +261,8 @@ The content of this structure is not made public by the API.
<a name="VIR_DOMAIN_CRASHED" id="VIR_DOMAIN_CRASHED">VIR_DOMAIN_CRASHED</a> = 6 : the domain is crashed <a name="VIR_DOMAIN_CRASHED" id="VIR_DOMAIN_CRASHED">VIR_DOMAIN_CRASHED</a> = 6 : the domain is crashed
} }
</pre><h3>Enum <a name="virDomainXMLFlags" id="virDomainXMLFlags">virDomainXMLFlags</a></h3><pre class="programlisting">Enum virDomainXMLFlags { </pre><h3>Enum <a name="virDomainXMLFlags" id="virDomainXMLFlags">virDomainXMLFlags</a></h3><pre class="programlisting">Enum virDomainXMLFlags {
<a name="VIR_DOMAIN_XML_SECURE" id="VIR_DOMAIN_XML_SECURE">VIR_DOMAIN_XML_SECURE</a> = 1 : dump security sensitive informations too <a name="VIR_DOMAIN_XML_SECURE" id="VIR_DOMAIN_XML_SECURE">VIR_DOMAIN_XML_SECURE</a> = 1 : dump security sensitive information too
<a name="VIR_DOMAIN_XML_INACTIVE" id="VIR_DOMAIN_XML_INACTIVE">VIR_DOMAIN_XML_INACTIVE</a> = 2 : dump inactive domain informations <a name="VIR_DOMAIN_XML_INACTIVE" id="VIR_DOMAIN_XML_INACTIVE">VIR_DOMAIN_XML_INACTIVE</a> = 2 : dump inactive domain information
} }
</pre><h3><a name="virNetwork" id="virNetwork">Structure virNetwork</a></h3><pre class="programlisting">Structure virNetwork<br />struct _virNetwork { </pre><h3><a name="virNetwork" id="virNetwork">Structure virNetwork</a></h3><pre class="programlisting">Structure virNetwork<br />struct _virNetwork {
The content of this structure is not made public by the API. The content of this structure is not made public by the API.

2
docs/index.py
View File

@ -34,7 +34,7 @@
# Bye # Bye
# #
# Then run the script in the doc subdir, it will create the symbols and # Then run the script in the doc subdir, it will create the symbols and
# word tables and populate them with informations extracted from # word tables and populate them with information extracted from
# the libvirt-api.xml API description, and make then accessible read-only # the libvirt-api.xml API description, and make then accessible read-only
# by nobody@loaclhost the user expected to be Apache's one # by nobody@loaclhost the user expected to be Apache's one
# #

40
docs/libvir.html
View File

@ -254,7 +254,7 @@ and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progress.</p>
<li>Documentation: remote support (Richard Jones), description of <li>Documentation: remote support (Richard Jones), description of
the URI connection strings (Richard Jones), update of virsh man the URI connection strings (Richard Jones), update of virsh man
page, matrix of libvirt API/hypervisor support with version page, matrix of libvirt API/hypervisor support with version
informations (Richard Jones)</li> information (Richard Jones)</li>
<li>Bug fixes: examples Makefile.am generation (Richard Jones), <li>Bug fixes: examples Makefile.am generation (Richard Jones),
SetMem fix (Mark Johnson), URI handling and ordering of SetMem fix (Mark Johnson), URI handling and ordering of
drivers (Daniel Berrange), fix virsh help without hypervisor (Richard drivers (Daniel Berrange), fix virsh help without hypervisor (Richard
@ -424,7 +424,7 @@ and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progress.</p>
<h3>0.1.9: Nov 29 2006</h3> <h3>0.1.9: Nov 29 2006</h3>
<ul> <ul>
<li>python bindings: release interpeter lock when calling C (Daniel Berrange)</li> <li>python bindings: release interpeter lock when calling C (Daniel Berrange)</li>
<li>don't raise HTTP error when looking informations for a domain</li> <li>don't raise HTTP error when looking information for a domain</li>
<li>some refactoring to use the driver for all entry points</li> <li>some refactoring to use the driver for all entry points</li>
<li>better error reporting (Daniel Berrange)</li> <li>better error reporting (Daniel Berrange)</li>
<li>fix OS reporting when running as non-root</li> <li>fix OS reporting when running as non-root</li>
@ -442,7 +442,7 @@ and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progress.</p>
<li>added support for inactive domains, new APIs, various associated cleanup (Daniel Berrange)</li> <li>added support for inactive domains, new APIs, various associated cleanup (Daniel Berrange)</li>
<li>special device model for HVM guests (Daniel Berrange)</li> <li>special device model for HVM guests (Daniel Berrange)</li>
<li>add API to dump core of domains (but requires a patched xend)</li> <li>add API to dump core of domains (but requires a patched xend)</li>
<li>pygrub bootloader informations take over &lt;os&gt; informations</li> <li>pygrub bootloader information take over &lt;os&gt; information</li>
<li>updated the localization strings</li> <li>updated the localization strings</li>
</ul> </ul>
<h3>0.1.8: Oct 16 2006</h3> <h3>0.1.8: Oct 16 2006</h3>
@ -459,9 +459,9 @@ and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progress.</p>
</ul> </ul>
<h3>0.1.7: Sep 29 2006</h3> <h3>0.1.7: Sep 29 2006</h3>
<ul> <ul>
<li> fix a memory bug on getting vcpu informations from xend (Daniel Berrange)</li> <li> fix a memory bug on getting vcpu information from xend (Daniel Berrange)</li>
<li> fix another problem in the hypercalls change in Xen changeset <li> fix another problem in the hypercalls change in Xen changeset
86d26e6ec89b when getting domain informations (Daniel Berrange)</li> 86d26e6ec89b when getting domain information (Daniel Berrange)</li>
</ul> </ul>
<h3>0.1.6: Sep 22 2006</h3> <h3>0.1.6: Sep 22 2006</h3>
<ul> <ul>
@ -497,7 +497,7 @@ and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progress.</p>
initialization errors (Daniel Berrange)</li> initialization errors (Daniel Berrange)</li>
<li>improvements: UUID in XML description (Peter Vetere), proxy code <li>improvements: UUID in XML description (Peter Vetere), proxy code
cleanup, virtual CPU and affinity support + virsh support (Michel cleanup, virtual CPU and affinity support + virsh support (Michel
Ponceau, Philippe Berthault, Daniel Berrange), port and tty informations Ponceau, Philippe Berthault, Daniel Berrange), port and tty information
for console in XML (Daniel Berrange), added XML dump to driver and proxy for console in XML (Daniel Berrange), added XML dump to driver and proxy
support (Daniel Berrange), extention of boot options with support for support (Daniel Berrange), extention of boot options with support for
floppy and cdrom (Daniel Berrange), features block in XML to report/ask floppy and cdrom (Daniel Berrange), features block in XML to report/ask
@ -678,7 +678,7 @@ engines:</p>
<p>When running in a Xen environment, programs using libvirt have to execute <p>When running in a Xen environment, programs using libvirt have to execute
in "Domain 0", which is the primary Linux OS loaded on the machine. That OS 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 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 domains. It also runs the Xen Store, a database of information shared by the
hypervisor, the kernels, the drivers and the xen daemon. Xend. The xen daemon hypervisor, the kernels, the drivers and the xen daemon. Xend. The xen daemon
supervise the control and execution of the sets of domains. The hypervisor, supervise the control and execution of the sets of domains. The hypervisor,
drivers, kernels and daemons communicate though a shared system bus drivers, kernels and daemons communicate though a shared system bus
@ -700,7 +700,7 @@ the Xen infrastructure:</p>
<p>The library will usually interact with the Xen daemon for any operation <p>The library will usually interact with the Xen daemon for any operation
changing the state of the system, but for performance and accuracy reasons changing the state of the system, but for performance and accuracy reasons
may talk directly to the hypervisor when gathering state informations at may talk directly to the hypervisor when gathering state information at
least when possible (i.e. when the running program using libvirt has root least when possible (i.e. when the running program using libvirt has root
priviledge access).</p> priviledge access).</p>
@ -995,7 +995,7 @@ systems:</p>
<li>the <code>&lt;os&gt;</code> block description is very different, first <li>the <code>&lt;os&gt;</code> block description is very different, first
it indicates that the type is 'hvm' for hardware virtualization, then it indicates that the type is 'hvm' for hardware virtualization, then
instead of a kernel, boot and command line arguments, it points to an os instead of a kernel, boot and command line arguments, it points to an os
boot loader which will extract the boot informations from the boot device boot loader which will extract the boot information from the boot device
specified in a separate boot element. The <code>dev</code> attribute on specified in a separate boot element. The <code>dev</code> attribute on
the <code>boot</code> tag can be one of: the <code>boot</code> tag can be one of:
<ul> <ul>
@ -1300,9 +1300,9 @@ description).</p>
<p>The second block (in blue) indicates the paravirtualization support of the <p>The second block (in blue) indicates the paravirtualization support of the
Xen support, you will see the os_type of xen to indicate a paravirtual Xen support, you will see the os_type of xen to indicate a paravirtual
kernel, then architecture informations and potential features.</p> kernel, then architecture information and potential features.</p>
<p>The third block (in green) gives similar informations but when running a <p>The third block (in green) gives similar information but when running a
32 bit OS fully virtualized with Xen using the hvm support.</p> 32 bit OS fully virtualized with Xen using the hvm support.</p>
<p>This section is likely to be updated and augmented in the future, see <a <p>This section is likely to be updated and augmented in the future, see <a
@ -1319,7 +1319,7 @@ higher level kind of languages:</p>
<ul> <ul>
<li>Python: Libvirt comes with direct support for the Python language <li>Python: Libvirt comes with direct support for the Python language
(just make sure you installed the libvirt-python package if not (just make sure you installed the libvirt-python package if not
compiling from sources). See below for more informations about compiling from sources). See below for more information about
using libvirt with python</li> using libvirt with python</li>
<li>Perl: Daniel Berrange provides <a <li>Perl: Daniel Berrange provides <a
href="http://search.cpan.org/~danberr/Sys-Virt-0.1.0/">bindings for href="http://search.cpan.org/~danberr/Sys-Virt-0.1.0/">bindings for
@ -1332,7 +1332,7 @@ higher level kind of languages:</p>
<p>Support, requests or help for libvirt bindings are welcome on <p>Support, requests or help for libvirt bindings are welcome on
the <a href="https://www.redhat.com/mailman/listinfo/libvir-list/">mailing the <a href="https://www.redhat.com/mailman/listinfo/libvir-list/">mailing
list</a>, as usual try to provide enough background informations list</a>, as usual try to provide enough background information
and make sure you use recent version, see the <a href="bugs.html">help and make sure you use recent version, see the <a href="bugs.html">help
page</a>.</p> page</a>.</p>
@ -1411,7 +1411,7 @@ from the C API, the only points to notice are:</p>
<li>getting an object representing the Domain 0 using <span <li>getting an object representing the Domain 0 using <span
style="color: #007F00; background-color: #FFFFFF">lookupByName</span></li> style="color: #007F00; background-color: #FFFFFF">lookupByName</span></li>
<li>if the domain is not found a libvirtError exception will be raised</li> <li>if the domain is not found a libvirtError exception will be raised</li>
<li>extracting and printing some informations about the domain using <li>extracting and printing some information about the domain using
various <span various <span
style="color: #E50073; background-color: #FFFFFF">methods</span> style="color: #E50073; background-color: #FFFFFF">methods</span>
associated to the virDomain class.</li> associated to the virDomain class.</li>
@ -1422,7 +1422,7 @@ from the C API, the only points to notice are:</p>
<p>The main goals of libvirt when it comes to error handling are:</p> <p>The main goals of libvirt when it comes to error handling are:</p>
<ul> <ul>
<li>provide as much detail as possible</li> <li>provide as much detail as possible</li>
<li>provide the informations as soon as possible</li> <li>provide the information as soon as possible</li>
<li>dont force the library user into one style of error handling</li> <li>dont force the library user into one style of error handling</li>
</ul> </ul>
@ -1446,7 +1446,7 @@ set specifically to a connection with</p>
<ol> <ol>
<li>if there is a callback associated to the connection set with <a <li>if there is a callback associated to the connection set with <a
href="html/libvirt-virterror.html#virConnSetErrorFunc">virConnSetErrorFunc</a>, href="html/libvirt-virterror.html#virConnSetErrorFunc">virConnSetErrorFunc</a>,
call it with the error informations</li> call it with the error information</li>
<li>otherwise if there is a global callback set with <a <li>otherwise if there is a global callback set with <a
href="html/libvirt-virterror.html#virSetErrorFunc">virSetErrorFunc</a>, href="html/libvirt-virterror.html#virSetErrorFunc">virSetErrorFunc</a>,
call it with the error information</li> call it with the error information</li>
@ -1473,7 +1473,7 @@ set specifically to a connection with</p>
</li> </li>
</ol> </ol>
<p>In all cases the error informations are provided as a <a <p>In all cases the error information is provided as a <a
href="html/libvirt-virterror.html#virErrorPtr">virErrorPtr</a> pointer to href="html/libvirt-virterror.html#virErrorPtr">virErrorPtr</a> pointer to
read-only structure <a read-only structure <a
href="html/libvirt-virterror.html#virError">virError</a> containing the href="html/libvirt-virterror.html#virError">virError</a> containing the
@ -1496,12 +1496,12 @@ following fields:</p>
targetted in the operation</li> targetted in the operation</li>
</ul> </ul>
<p>and then extra raw informations about the error which may be initialized <p>and then extra raw information about the error which may be initialized
to 0 or NULL if unused</p> to 0 or NULL if unused</p>
<ul> <ul>
<li>str1, str2, str3: string informations, usually str1 is the error <li>str1, str2, str3: string information, usually str1 is the error
message format</li> message format</li>
<li>int1, int2: integer informations</li> <li>int1, int2: integer information</li>
</ul> </ul>
<p>So usually, setting up specific error handling with libvirt consist of <p>So usually, setting up specific error handling with libvirt consist of

4
docs/libvirt-api.xml
View File

@ -406,8 +406,8 @@
<enum name='VIR_DOMAIN_SCHED_FIELD_ULLONG' file='libvirt' value='4' type='virSchedParameterType' info='unsigned long long case'/> <enum name='VIR_DOMAIN_SCHED_FIELD_ULLONG' file='libvirt' value='4' type='virSchedParameterType' info='unsigned long long case'/>
<enum name='VIR_DOMAIN_SHUTDOWN' file='libvirt' value='4' type='virDomainState' info='the domain is being shut down'/> <enum name='VIR_DOMAIN_SHUTDOWN' file='libvirt' value='4' type='virDomainState' info='the domain is being shut down'/>
<enum name='VIR_DOMAIN_SHUTOFF' file='libvirt' value='5' type='virDomainState' info='the domain is shut off'/> <enum name='VIR_DOMAIN_SHUTOFF' file='libvirt' value='5' type='virDomainState' info='the domain is shut off'/>
<enum name='VIR_DOMAIN_XML_INACTIVE' file='libvirt' value='2' type='virDomainXMLFlags' info=' dump inactive domain informations'/> <enum name='VIR_DOMAIN_XML_INACTIVE' file='libvirt' value='2' type='virDomainXMLFlags' info=' dump inactive domain information'/>
<enum name='VIR_DOMAIN_XML_SECURE' file='libvirt' value='1' type='virDomainXMLFlags' info='dump security sensitive informations too'/> <enum name='VIR_DOMAIN_XML_SECURE' file='libvirt' value='1' type='virDomainXMLFlags' info='dump security sensitive information too'/>
<enum name='VIR_ERR_AUTH_FAILED' file='virterror' value='45' type='virErrorNumber' info='authentication failed'/> <enum name='VIR_ERR_AUTH_FAILED' file='virterror' value='45' type='virErrorNumber' info='authentication failed'/>
<enum name='VIR_ERR_CALL_FAILED' file='virterror' value='26' type='virErrorNumber' info='not supported by the drivers (DEPRECATED)'/> <enum name='VIR_ERR_CALL_FAILED' file='virterror' value='26' type='virErrorNumber' info='not supported by the drivers (DEPRECATED)'/>
<enum name='VIR_ERR_CONF_SYNTAX' file='virterror' value='33' type='virErrorNumber' info='failed to parse the syntax of a conf file'/> <enum name='VIR_ERR_CONF_SYNTAX' file='virterror' value='33' type='virErrorNumber' info='failed to parse the syntax of a conf file'/>

8
docs/libvirt.rng
View File

@ -25,8 +25,8 @@
<!-- <!--
Description of a Xen domain: Description of a Xen domain:
The description must start with the identification informations and then The description must start with the identification information and then
os or bootloader, resources, features, devices and termination informations os or bootloader, resources, features, devices and termination information
can be given in any order. can be given in any order.
--> -->
<define name='xen-domain'> <define name='xen-domain'>
@ -60,7 +60,7 @@
<!-- <!--
Description of a QEmu domain: Description of a QEmu domain:
The description must start with the identification informations and then The description must start with the identification information and then
os, resources, devices can be given in any order. os, resources, devices can be given in any order.
The specific part are the combinations of architectures and machines The specific part are the combinations of architectures and machines
being emulated. being emulated.
@ -145,7 +145,7 @@
<!-- <!--
Description of a KVM domain: Description of a KVM domain:
The description must start with the identification informations and then The description must start with the identification information and then
os, resources, devices can be given in any order. os, resources, devices can be given in any order.
--> -->
<define name='kvm-domain'> <define name='kvm-domain'>

12
docs/news.html
View File

@ -199,7 +199,7 @@ and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progress.</p><h3>0
</li><li>Documentation: remote support (Richard Jones), description of </li><li>Documentation: remote support (Richard Jones), description of
the URI connection strings (Richard Jones), update of virsh man the URI connection strings (Richard Jones), update of virsh man
page, matrix of libvirt API/hypervisor support with version page, matrix of libvirt API/hypervisor support with version
informations (Richard Jones)</li> information (Richard Jones)</li>
<li>Bug fixes: examples Makefile.am generation (Richard Jones), <li>Bug fixes: examples Makefile.am generation (Richard Jones),
SetMem fix (Mark Johnson), URI handling and ordering of SetMem fix (Mark Johnson), URI handling and ordering of
drivers (Daniel Berrange), fix virsh help without hypervisor (Richard drivers (Daniel Berrange), fix virsh help without hypervisor (Richard
@ -344,7 +344,7 @@ and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progress.</p><h3>0
<li>bug fixes: VCPU info breakages on xen 3.0.3, xenDaemonListDomains buffer overflow (Daniel Berrange), reference count bug when creating Xen domains (Daniel Berrange).</li> <li>bug fixes: VCPU info breakages on xen 3.0.3, xenDaemonListDomains buffer overflow (Daniel Berrange), reference count bug when creating Xen domains (Daniel Berrange).</li>
<li>improvements: support graphic framebuffer for Xen paravirt (Daniel Berrange), VNC listen IP range support (Daniel Berrange), support for default Xen config files and inactive domains of 3.0.4 (Daniel Berrange).</li> <li>improvements: support graphic framebuffer for Xen paravirt (Daniel Berrange), VNC listen IP range support (Daniel Berrange), support for default Xen config files and inactive domains of 3.0.4 (Daniel Berrange).</li>
</ul><h3>0.1.9: Nov 29 2006</h3><ul><li>python bindings: release interpeter lock when calling C (Daniel Berrange)</li> </ul><h3>0.1.9: Nov 29 2006</h3><ul><li>python bindings: release interpeter lock when calling C (Daniel Berrange)</li>
<li>don't raise HTTP error when looking informations for a domain</li> <li>don't raise HTTP error when looking information for a domain</li>
<li>some refactoring to use the driver for all entry points</li> <li>some refactoring to use the driver for all entry points</li>
<li>better error reporting (Daniel Berrange)</li> <li>better error reporting (Daniel Berrange)</li>
<li>fix OS reporting when running as non-root</li> <li>fix OS reporting when running as non-root</li>
@ -362,7 +362,7 @@ and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progress.</p><h3>0
<li>added support for inactive domains, new APIs, various associated cleanup (Daniel Berrange)</li> <li>added support for inactive domains, new APIs, various associated cleanup (Daniel Berrange)</li>
<li>special device model for HVM guests (Daniel Berrange)</li> <li>special device model for HVM guests (Daniel Berrange)</li>
<li>add API to dump core of domains (but requires a patched xend)</li> <li>add API to dump core of domains (but requires a patched xend)</li>
<li>pygrub bootloader informations take over &lt;os&gt; informations</li> <li>pygrub bootloader information take over &lt;os&gt; information</li>
<li>updated the localization strings</li> <li>updated the localization strings</li>
</ul><h3>0.1.8: Oct 16 2006</h3><ul><li> Bug for system with page size != 4k</li> </ul><h3>0.1.8: Oct 16 2006</h3><ul><li> Bug for system with page size != 4k</li>
<li> vcpu number initialization (Philippe Berthault)</li> <li> vcpu number initialization (Philippe Berthault)</li>
@ -373,9 +373,9 @@ and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progress.</p><h3>0
<li> compile fix</li> <li> compile fix</li>
<li> mlock/munlock size fixes (Daniel Berrange)</li> <li> mlock/munlock size fixes (Daniel Berrange)</li>
<li> improve error reporting</li> <li> improve error reporting</li>
</ul><h3>0.1.7: Sep 29 2006</h3><ul><li> fix a memory bug on getting vcpu informations from xend (Daniel Berrange)</li> </ul><h3>0.1.7: Sep 29 2006</h3><ul><li> fix a memory bug on getting vcpu information from xend (Daniel Berrange)</li>
<li> fix another problem in the hypercalls change in Xen changeset <li> fix another problem in the hypercalls change in Xen changeset
86d26e6ec89b when getting domain informations (Daniel Berrange)</li> 86d26e6ec89b when getting domain information (Daniel Berrange)</li>
</ul><h3>0.1.6: Sep 22 2006</h3><ul><li>Support for localization of strings using gettext (Daniel Berrange)</li> </ul><h3>0.1.6: Sep 22 2006</h3><ul><li>Support for localization of strings using gettext (Daniel Berrange)</li>
<li>Support for new Xen-3.0.3 cdrom and disk configuration (Daniel Berrange)</li> <li>Support for new Xen-3.0.3 cdrom and disk configuration (Daniel Berrange)</li>
<li>Support for setting VNC port when creating domains with new <li>Support for setting VNC port when creating domains with new
@ -401,7 +401,7 @@ and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progress.</p><h3>0
initialization errors (Daniel Berrange)</li> initialization errors (Daniel Berrange)</li>
<li>improvements: UUID in XML description (Peter Vetere), proxy code <li>improvements: UUID in XML description (Peter Vetere), proxy code
cleanup, virtual CPU and affinity support + virsh support (Michel cleanup, virtual CPU and affinity support + virsh support (Michel
Ponceau, Philippe Berthault, Daniel Berrange), port and tty informations Ponceau, Philippe Berthault, Daniel Berrange), port and tty information
for console in XML (Daniel Berrange), added XML dump to driver and proxy for console in XML (Daniel Berrange), added XML dump to driver and proxy
support (Daniel Berrange), extention of boot options with support for support (Daniel Berrange), extention of boot options with support for
floppy and cdrom (Daniel Berrange), features block in XML to report/ask floppy and cdrom (Daniel Berrange), features block in XML to report/ask

6
docs/python.html
View File

@ -5,7 +5,7 @@ pure C. First the headers embeds the necessary declarations to
allow direct acces from C++ code, but also we have bindings for allow direct acces from C++ code, but also we have bindings for
higher level kind of languages:</p><ul><li>Python: Libvirt comes with direct support for the Python language higher level kind of languages:</p><ul><li>Python: Libvirt comes with direct support for the Python language
(just make sure you installed the libvirt-python package if not (just make sure you installed the libvirt-python package if not
compiling from sources). See below for more informations about compiling from sources). See below for more information about
using libvirt with python</li> using libvirt with python</li>
<li>Perl: Daniel Berrange provides <a href="http://search.cpan.org/~danberr/Sys-Virt-0.1.0/">bindings for <li>Perl: Daniel Berrange provides <a href="http://search.cpan.org/~danberr/Sys-Virt-0.1.0/">bindings for
Perl</a>.</li> Perl</a>.</li>
@ -13,7 +13,7 @@ higher level kind of languages:</p><ul><li>Python: Libvirt comes with direct sup
<li>Ruby: David Lutterkork provides <a href="http://libvirt.org/ruby/">bindings for Ruby</a>.</li> <li>Ruby: David Lutterkork provides <a href="http://libvirt.org/ruby/">bindings for Ruby</a>.</li>
</ul><p>Support, requests or help for libvirt bindings are welcome on </ul><p>Support, requests or help for libvirt bindings are welcome on
the <a href="https://www.redhat.com/mailman/listinfo/libvir-list/">mailing the <a href="https://www.redhat.com/mailman/listinfo/libvir-list/">mailing
list</a>, as usual try to provide enough background informations list</a>, as usual try to provide enough background information
and make sure you use recent version, see the <a href="bugs.html">help and make sure you use recent version, see the <a href="bugs.html">help
page</a>.</p><p>The remaining of this page focuses on the Python bindings.</p><p>The Python binding should be complete and are mostly automatically page</a>.</p><p>The remaining of this page focuses on the Python bindings.</p><p>The Python binding should be complete and are mostly automatically
generated from the formal description of the API in xml. The bindings are generated from the formal description of the API in xml. The bindings are
@ -59,7 +59,7 @@ from the C API, the only points to notice are:</p><ul><li>the import of the modu
openReadOnly function allows the code to execute as a normal user.</li> openReadOnly function allows the code to execute as a normal user.</li>
<li>getting an object representing the Domain 0 using <span style="color: #007F00; background-color: #FFFFFF">lookupByName</span></li> <li>getting an object representing the Domain 0 using <span style="color: #007F00; background-color: #FFFFFF">lookupByName</span></li>
<li>if the domain is not found a libvirtError exception will be raised</li> <li>if the domain is not found a libvirtError exception will be raised</li>
<li>extracting and printing some informations about the domain using <li>extracting and printing some information about the domain using
various <span style="color: #E50073; background-color: #FFFFFF">methods</span> various <span style="color: #E50073; background-color: #FFFFFF">methods</span>
associated to the virDomain class.</li> associated to the virDomain class.</li>
</ul></div></div><div class="linkList2"><div class="llinks2"><h3 class="links2"><span>main menu</span></h3><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">libvirt architecture</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="format.html">XML Format</a></li><li><a href="python.html">Bindings for other languages</a></li><li><a href="errors.html">Handling of errors</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="windows.html">Windows support</a></li><li><a href="remote.html">Remote support</a></li><li><a href="auth.html">Access control</a></li><li><a href="uri.html">Connection URIs</a></li><li><a href="hvsupport.html">Hypervisor support</a></li><li><a href="storage.html">Storage Management</a></li><li><a href="html/index.html">API Menu</a></li><li><a href="examples/index.html">C code examples</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></div><div class="llinks2"><h3 class="links2"><span>related links</span></h3><ul><li><a href="https://www.redhat.com/archives/libvir-list/">Mail archive</a></li><li><a href="https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora+Core&amp;component=libvirt&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=MODIFIED&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;long_desc_type=allwordssubstr">Open bugs</a></li><li><a href="http://virt-manager.et.redhat.com/">virt-manager</a></li><li><a href="http://search.cpan.org/~danberr/Sys-Virt-0.1.0/">Perl bindings</a></li><li><a href="http://libvirt.org/ocaml/">OCaml bindings</a></li><li><a href="http://libvirt.org/ruby/">Ruby bindings</a></li><li><a href="http://www.cl.cam.ac.uk/Research/SRG/netos/xen/index.html">Xen project</a></li><li><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="12" value="Search..." /><input name="submit" type="submit" value="Go" /></form></li><li><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-90x34.gif" alt="Made with Libxml2 Logo" /></a></li></ul><p class="credits">Graphics and design by <a href="mail:dfong@redhat.com">Diana Fong</a></p></div></div><div id="bottom"><p class="p1"></p></div></div></body></html> </ul></div></div><div class="linkList2"><div class="llinks2"><h3 class="links2"><span>main menu</span></h3><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">libvirt architecture</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="format.html">XML Format</a></li><li><a href="python.html">Bindings for other languages</a></li><li><a href="errors.html">Handling of errors</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="windows.html">Windows support</a></li><li><a href="remote.html">Remote support</a></li><li><a href="auth.html">Access control</a></li><li><a href="uri.html">Connection URIs</a></li><li><a href="hvsupport.html">Hypervisor support</a></li><li><a href="storage.html">Storage Management</a></li><li><a href="html/index.html">API Menu</a></li><li><a href="examples/index.html">C code examples</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></div><div class="llinks2"><h3 class="links2"><span>related links</span></h3><ul><li><a href="https://www.redhat.com/archives/libvir-list/">Mail archive</a></li><li><a href="https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora+Core&amp;component=libvirt&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=MODIFIED&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;long_desc_type=allwordssubstr">Open bugs</a></li><li><a href="http://virt-manager.et.redhat.com/">virt-manager</a></li><li><a href="http://search.cpan.org/~danberr/Sys-Virt-0.1.0/">Perl bindings</a></li><li><a href="http://libvirt.org/ocaml/">OCaml bindings</a></li><li><a href="http://libvirt.org/ruby/">Ruby bindings</a></li><li><a href="http://www.cl.cam.ac.uk/Research/SRG/netos/xen/index.html">Xen project</a></li><li><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="12" value="Search..." /><input name="submit" type="submit" value="Go" /></form></li><li><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-90x34.gif" alt="Made with Libxml2 Logo" /></a></li></ul><p class="credits">Graphics and design by <a href="mail:dfong@redhat.com">Diana Fong</a></p></div></div><div id="bottom"><p class="p1"></p></div></div></body></html>

6
docs/virsh.pod
View File

@ -121,7 +121,7 @@ capabilities in terms of CPU and features, and a set of description
for each kind of guest which can be virtualized. For a more complete for each kind of guest which can be virtualized. For a more complete
description see: description see:
L<http://libvirt.org/format.html#Capa1> L<http://libvirt.org/format.html#Capa1>
The XML also show the NUMA topology informations if available. The XML also show the NUMA topology information if available.
=item B<list> =item B<list>
@ -255,7 +255,7 @@ Returns state about a running domain.
=item B<dumpxml> I<domain-id> =item B<dumpxml> I<domain-id>
Output the domain informations as an XML dump to stdout, this format can be used by the B<create> command. Output the domain information as an XML dump to stdout, this format can be used by the B<create> command.
=item B<reboot> I<domain-id> =item B<reboot> I<domain-id>
@ -413,7 +413,7 @@ if more than one are present on the domain.
The following commands manipulate networks. Libvirt has the capability to The following commands manipulate networks. Libvirt has the capability to
define virtual networks which can then be used by domains and linked to define virtual networks which can then be used by domains and linked to
actual network devices. For more detailed informations about this feature actual network devices. For more detailed information about this feature
see the documentation at L<http://libvirt.org/format.html#Net1> . A lot see the documentation at L<http://libvirt.org/format.html#Net1> . A lot
of the command for virtual networks are similar to the one used for domains, of the command for virtual networks are similar to the one used for domains,
but the way to name a virtual network is either by its name or UUID. but the way to name a virtual network is either by its name or UUID.

12
include/libvirt/libvirt.h
View File

@ -71,7 +71,7 @@ typedef enum {
* virDomainInfoPtr: * virDomainInfoPtr:
* *
* a virDomainInfo is a structure filled by virDomainGetInfo() and extracting * a virDomainInfo is a structure filled by virDomainGetInfo() and extracting
* runtime informations for a given active Domain * runtime information for a given active Domain
*/ */
typedef struct _virDomainInfo virDomainInfo; typedef struct _virDomainInfo virDomainInfo;
@ -106,7 +106,7 @@ typedef enum {
* virNodeInfoPtr: * virNodeInfoPtr:
* *
* a virNodeInfo is a structure filled by virNodeGetInfo() and providing * a virNodeInfo is a structure filled by virNodeGetInfo() and providing
* the informations for the Node. * the information for the Node.
*/ */
typedef struct _virNodeInfo virNodeInfo; typedef struct _virNodeInfo virNodeInfo;
@ -469,7 +469,7 @@ int virDomainCoreDump (virDomainPtr domain,
int flags); int flags);
/* /*
* Domain runtime informations * Domain runtime information
*/ */
int virDomainGetInfo (virDomainPtr domain, int virDomainGetInfo (virDomainPtr domain,
virDomainInfoPtr info); virDomainInfoPtr info);
@ -507,8 +507,8 @@ int virDomainGetMaxVcpus (virDomainPtr domain);
*/ */
typedef enum { typedef enum {
VIR_DOMAIN_XML_SECURE = 1, /* dump security sensitive informations too */ VIR_DOMAIN_XML_SECURE = 1, /* dump security sensitive information too */
VIR_DOMAIN_XML_INACTIVE = 2/* dump inactive domain informations */ VIR_DOMAIN_XML_INACTIVE = 2/* dump inactive domain information */
} virDomainXMLFlags; } virDomainXMLFlags;
char * virDomainGetXMLDesc (virDomainPtr domain, char * virDomainGetXMLDesc (virDomainPtr domain,
@ -744,7 +744,7 @@ int virNetworkDestroy (virNetworkPtr network);
int virNetworkFree (virNetworkPtr network); int virNetworkFree (virNetworkPtr network);
/* /*
* Network informations * Network information
*/ */
const char* virNetworkGetName (virNetworkPtr network); const char* virNetworkGetName (virNetworkPtr network);
int virNetworkGetUUID (virNetworkPtr network, int virNetworkGetUUID (virNetworkPtr network,

12
include/libvirt/libvirt.h.in
View File

@ -71,7 +71,7 @@ typedef enum {
* virDomainInfoPtr: * virDomainInfoPtr:
* *
* a virDomainInfo is a structure filled by virDomainGetInfo() and extracting * a virDomainInfo is a structure filled by virDomainGetInfo() and extracting
* runtime informations for a given active Domain * runtime information for a given active Domain
*/ */
typedef struct _virDomainInfo virDomainInfo; typedef struct _virDomainInfo virDomainInfo;
@ -106,7 +106,7 @@ typedef enum {
* virNodeInfoPtr: * virNodeInfoPtr:
* *
* a virNodeInfo is a structure filled by virNodeGetInfo() and providing * a virNodeInfo is a structure filled by virNodeGetInfo() and providing
* the informations for the Node. * the information for the Node.
*/ */
typedef struct _virNodeInfo virNodeInfo; typedef struct _virNodeInfo virNodeInfo;
@ -469,7 +469,7 @@ int virDomainCoreDump (virDomainPtr domain,
int flags); int flags);
/* /*
* Domain runtime informations * Domain runtime information
*/ */
int virDomainGetInfo (virDomainPtr domain, int virDomainGetInfo (virDomainPtr domain,
virDomainInfoPtr info); virDomainInfoPtr info);
@ -507,8 +507,8 @@ int virDomainGetMaxVcpus (virDomainPtr domain);
*/ */
typedef enum { typedef enum {
VIR_DOMAIN_XML_SECURE = 1, /* dump security sensitive informations too */ VIR_DOMAIN_XML_SECURE = 1, /* dump security sensitive information too */
VIR_DOMAIN_XML_INACTIVE = 2/* dump inactive domain informations */ VIR_DOMAIN_XML_INACTIVE = 2/* dump inactive domain information */
} virDomainXMLFlags; } virDomainXMLFlags;
char * virDomainGetXMLDesc (virDomainPtr domain, char * virDomainGetXMLDesc (virDomainPtr domain,
@ -744,7 +744,7 @@ int virNetworkDestroy (virNetworkPtr network);
int virNetworkFree (virNetworkPtr network); int virNetworkFree (virNetworkPtr network);
/* /*
* Network informations * Network information
*/ */
const char* virNetworkGetName (virNetworkPtr network); const char* virNetworkGetName (virNetworkPtr network);
int virNetworkGetUUID (virNetworkPtr network, int virNetworkGetUUID (virNetworkPtr network,

4
proxy/libvirt_proxy.c
View File

@ -571,7 +571,7 @@ retry2:
goto comm_error; goto comm_error;
/* /*
* Hum, could we expect those informations to be unmutable and * Hum, could we expect those information to be unmutable and
* cache them ? Since it's probably an unfrequent call better * cache them ? Since it's probably an unfrequent call better
* not make assumption and do the xend RPC each call. * not make assumption and do the xend RPC each call.
*/ */
@ -763,7 +763,7 @@ proxyMainLoop(void) {
/** /**
* usage: * usage:
* *
* dump on stdout informations about the program * dump on stdout information about the program
*/ */
static void static void
usage(const char *progname) { usage(const char *progname) {

2
python/libvir.py
View File

@ -85,7 +85,7 @@ class libvirtError(Exception):
def registerErrorHandler(f, ctx): def registerErrorHandler(f, ctx):
"""Register a Python written function to for error reporting. """Register a Python written function to for error reporting.
The function is called back as f(ctx, error), with error The function is called back as f(ctx, error), with error
being a list of informations about the error being raised. being a list of information about the error being raised.
Returns 1 in case of success.""" Returns 1 in case of success."""
return libvirtmod.virRegisterErrorHandler(f,ctx) return libvirtmod.virRegisterErrorHandler(f,ctx)

8
python/libvirt-python-api.xml
View File

@ -34,13 +34,13 @@
<arg name='uuid' type='const unsigned char *' info='the UUID string for the network, must be 16 bytes'/> <arg name='uuid' type='const unsigned char *' info='the UUID string for the network, must be 16 bytes'/>
</function> </function>
<function name='virDomainGetInfo' file='python'> <function name='virDomainGetInfo' file='python'>
<info>Extract informations 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.</info> <info>Extract information about a domain. Note that if the connection used to get the domain is limited only a partial set of the information can be extracted.</info>
<return type='int *' info='the list of informations or None in case of error'/> <return type='int *' info='the list of information or None in case of error'/>
<arg name='domain' type='virDomainPtr' info='a domain object'/> <arg name='domain' type='virDomainPtr' info='a domain object'/>
</function> </function>
<function name='virNodeGetInfo' file='python'> <function name='virNodeGetInfo' file='python'>
<info>Extract hardware informations about the Node.</info> <info>Extract hardware information about the Node.</info>
<return type='int *' info='the list of informations or None in case of error'/> <return type='int *' info='the list of information or None in case of error'/>
<arg name='conn' type='virConnectPtr' info='pointer to the hypervisor connection'/> <arg name='conn' type='virConnectPtr' info='pointer to the hypervisor connection'/>
</function> </function>
<function name='virDomainGetUUID' file='python'> <function name='virDomainGetUUID' file='python'>

4
python/tests/node.py
View File

@ -15,14 +15,14 @@ if conn == None:
try: try:
(model, memory, cpus, mhz, nodes, socket, cores, threads) = conn.getInfo() (model, memory, cpus, mhz, nodes, socket, cores, threads) = conn.getInfo()
except: except:
print 'Failed to extract the current node informations' print 'Failed to extract the current node information'
sys.exit(1) sys.exit(1)
print "Xen running on %d %s processors at %d MHz, %d MBytes of memory" % ( print "Xen running on %d %s processors at %d MHz, %d MBytes of memory" % (
cpus, model, mhz, memory) cpus, model, mhz, memory)
if cpus > nodes * socket * cores * threads: if cpus > nodes * socket * cores * threads:
print "Erroneous CPU informations" print "Erroneous CPU information"
sys.exit(1) sys.exit(1)
if cpus < nodes * socket * cores * threads: if cpus < nodes * socket * cores * threads:

16
src/xen_internal.c
View File

@ -397,28 +397,28 @@ struct xen_v0_domainop {
typedef struct xen_v0_domainop xen_v0_domainop; typedef struct xen_v0_domainop xen_v0_domainop;
/* /*
* The informations for a destroydomain system hypercall * The information for a destroydomain system hypercall
*/ */
#define XEN_V0_OP_DESTROYDOMAIN 9 #define XEN_V0_OP_DESTROYDOMAIN 9
#define XEN_V1_OP_DESTROYDOMAIN 9 #define XEN_V1_OP_DESTROYDOMAIN 9
#define XEN_V2_OP_DESTROYDOMAIN 2 #define XEN_V2_OP_DESTROYDOMAIN 2
/* /*
* The informations for a pausedomain system hypercall * The information for a pausedomain system hypercall
*/ */
#define XEN_V0_OP_PAUSEDOMAIN 10 #define XEN_V0_OP_PAUSEDOMAIN 10
#define XEN_V1_OP_PAUSEDOMAIN 10 #define XEN_V1_OP_PAUSEDOMAIN 10
#define XEN_V2_OP_PAUSEDOMAIN 3 #define XEN_V2_OP_PAUSEDOMAIN 3
/* /*
* The informations for an unpausedomain system hypercall * The information for an unpausedomain system hypercall
*/ */
#define XEN_V0_OP_UNPAUSEDOMAIN 11 #define XEN_V0_OP_UNPAUSEDOMAIN 11
#define XEN_V1_OP_UNPAUSEDOMAIN 11 #define XEN_V1_OP_UNPAUSEDOMAIN 11
#define XEN_V2_OP_UNPAUSEDOMAIN 4 #define XEN_V2_OP_UNPAUSEDOMAIN 4
/* /*
* The informations for an setmaxmem system hypercall * The information for an setmaxmem system hypercall
*/ */
#define XEN_V0_OP_SETMAXMEM 28 #define XEN_V0_OP_SETMAXMEM 28
#define XEN_V1_OP_SETMAXMEM 28 #define XEN_V1_OP_SETMAXMEM 28
@ -442,7 +442,7 @@ struct xen_v2d5_setmaxmem {
typedef struct xen_v2d5_setmaxmem xen_v2d5_setmaxmem; typedef struct xen_v2d5_setmaxmem xen_v2d5_setmaxmem;
/* /*
* The informations for an setmaxvcpu system hypercall * The information for an setmaxvcpu system hypercall
*/ */
#define XEN_V0_OP_SETMAXVCPU 41 #define XEN_V0_OP_SETMAXVCPU 41
#define XEN_V1_OP_SETMAXVCPU 41 #define XEN_V1_OP_SETMAXVCPU 41
@ -461,7 +461,7 @@ struct xen_v2_setmaxvcpu {
typedef struct xen_v2_setmaxvcpu xen_v2_setmaxvcpu; typedef struct xen_v2_setmaxvcpu xen_v2_setmaxvcpu;
/* /*
* The informations for an setvcpumap system hypercall * The information for an setvcpumap system hypercall
* Note that between 1 and 2 the limitation to 64 physical CPU was lifted * Note that between 1 and 2 the limitation to 64 physical CPU was lifted
* hence the difference in structures * hence the difference in structures
*/ */
@ -509,7 +509,7 @@ struct xen_v2d5_setvcpumap {
typedef struct xen_v2d5_setvcpumap xen_v2d5_setvcpumap; typedef struct xen_v2d5_setvcpumap xen_v2d5_setvcpumap;
/* /*
* The informations for an vcpuinfo system hypercall * The information for an vcpuinfo system hypercall
*/ */
#define XEN_V0_OP_GETVCPUINFO 43 #define XEN_V0_OP_GETVCPUINFO 43
#define XEN_V1_OP_GETVCPUINFO 43 #define XEN_V1_OP_GETVCPUINFO 43
@ -980,7 +980,7 @@ xenHypervisorDoV2Dom(int handle, xen_op_v2_dom* op)
* @maxids: maximum number of domains to list * @maxids: maximum number of domains to list
* @dominfos: output structures * @dominfos: output structures
* *
* Do a low level hypercall to list existing domains informations * Do a low level hypercall to list existing domains information
* *
* Returns the number of domains or -1 in case of failure * Returns the number of domains or -1 in case of failure
*/ */

6
virsh.1
View File

@ -241,7 +241,7 @@ capabilities in terms of \s-1CPU\s0 and features, and a set of description
for each kind of guest which can be virtualized. For a more complete for each kind of guest which can be virtualized. For a more complete
description see: description see:
<http://libvirt.org/format.html#Capa1> <http://libvirt.org/format.html#Capa1>
The \s-1XML\s0 also show the \s-1NUMA\s0 topology informations if available. The \s-1XML\s0 also show the \s-1NUMA\s0 topology information if available.
.IP "\fBlist\fR" 4 .IP "\fBlist\fR" 4
.IX Item "list" .IX Item "list"
Prints information about one or more domains. If no domains are Prints information about one or more domains. If no domains are
@ -353,7 +353,7 @@ convert a domain Id to domain name
Returns state about a running domain. Returns state about a running domain.
.IP "\fBdumpxml\fR \fIdomain-id\fR" 4 .IP "\fBdumpxml\fR \fIdomain-id\fR" 4
.IX Item "dumpxml domain-id" .IX Item "dumpxml domain-id"
Output the domain informations as an \s-1XML\s0 dump to stdout, this format can be used by the \fBcreate\fR command. Output the domain information as an \s-1XML\s0 dump to stdout, this format can be used by the \fBcreate\fR command.
.IP "\fBreboot\fR \fIdomain-id\fR" 4 .IP "\fBreboot\fR \fIdomain-id\fR" 4
.IX Item "reboot domain-id" .IX Item "reboot domain-id"
Reboot a domain. This acts just as if the domain had the \fBreboot\fR Reboot a domain. This acts just as if the domain had the \fBreboot\fR
@ -480,7 +480,7 @@ if more than one are present on the domain.
.IX Header "VIRTUAL NETWORKS COMMANDS" .IX Header "VIRTUAL NETWORKS COMMANDS"
The following commands manipulate networks. Libvirt has the capability to The following commands manipulate networks. Libvirt has the capability to
define virtual networks which can then be used by domains and linked to define virtual networks which can then be used by domains and linked to
actual network devices. For more detailed informations about this feature actual network devices. For more detailed information about this feature
see the documentation at <http://libvirt.org/format.html#Net1> . A lot see the documentation at <http://libvirt.org/format.html#Net1> . A lot
of the command for virtual networks are similar to the one used for domains, of the command for virtual networks are similar to the one used for domains,
but the way to name a virtual network is either by its name or \s-1UUID\s0. but the way to name a virtual network is either by its name or \s-1UUID\s0.