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

* include/libvirt/libvirt.h[.in] include/libvirt/virterror.h

Browse Source 
proxy/libvirt_proxy.c qemud/Makefile.am qemud/conf.c qemud/conf.h
  qemud/dispatch.c qemud/internal.h qemud/protocol.h
  src/driver.h src/internal.h src/libvirt.c src/libvirt_sym.version
  src/proxy_internal.c src/proxy_internal.h src/qemu_internal.c
  src/test.c src/virsh.c src/virterror.c src/xen_internal.c
  src/xen_internal.h src/xend_internal.c src/xm_internal.c
  src/xml.h src/xs_internal.c: applied patch from Richard Jones
  adding virConnectGetCapabilities(), plus various small little
  fixes
* docs/*: fixed the api extractor script and regenerated
Daniel
This commit is contained in:
Daniel Veillard 2007-03-15 17:24:56 +00:00
parent d59bfbd00e
commit 635ae38979
54 changed files with 2209 additions and 1242 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
.cvsignore
View File

@ -1,3 +1,4 @@
.git
Makefile Makefile
aclocal.m4 aclocal.m4
autom4te.cache autom4te.cache

15
ChangeLog
View File

@ -1,3 +1,18 @@
Thu Mar 15 18:20:03 CET 2007 Daniel Veillard <veillard@redhat.com>
* include/libvirt/libvirt.h[.in] include/libvirt/virterror.h
proxy/libvirt_proxy.c qemud/Makefile.am qemud/conf.c qemud/conf.h
qemud/dispatch.c qemud/internal.h qemud/protocol.h
src/driver.h src/internal.h src/libvirt.c src/libvirt_sym.version
src/proxy_internal.c src/proxy_internal.h src/qemu_internal.c
src/test.c src/virsh.c src/virterror.c src/xen_internal.c
src/xen_internal.h src/xend_internal.c src/xm_internal.c
src/xml.h src/xs_internal.c: applied patch from Richard Jones
adding virConnectGetCapabilities(), plus various small little
fixes
* docs/*: fixed the api extractor script and regenerated
Thu Mar 15 16:21:46 CET 2007 Daniel Veillard <veillard@redhat.com> Thu Mar 15 16:21:46 CET 2007 Daniel Veillard <veillard@redhat.com>
* python/generator.py: fix the python binding generation for * python/generator.py: fix the python binding generation for

205
NEWS
View File

@ -6,14 +6,14 @@
Releases Releases
0.2.0: Feb 14 2007: 0.2.0: Feb 14 2007:
- Various internal cleanups (Mark McLoughlin, Richard Jones, - Various internal cleanups (Mark McLoughlin, Richard Jones,Daniel
Daniel Berrange, Karel Zak) Berrange, Karel Zak)
- Bug fixes: avoid a crash in connect (Daniel Berrange), virsh args - Bug fixes: avoid a crash in connect (Daniel Berrange), virsh
parsing (Richard Jones) argsparsing (Richard Jones)
- Add support for QEmu and KVM virtualization (Daniel Berrange) - Add support for QEmu and KVM virtualization (Daniel Berrange)
- Add support for network configuration (Mark McLoughlin) - Add support for network configuration (Mark McLoughlin)
- Minor improvements: regression testing (Daniel Berrange), - Minor improvements: regression testing (Daniel Berrange),localization
localization string updates string updates
0.1.11: Jan 22 2007: 0.1.11: Jan 22 2007:
@ -25,12 +25,18 @@ Releases
0.1.10: Dec 20 2006: 0.1.10: Dec 20 2006:
- more localizations - more localizations
- bug fixes: VCPU info breakages on xen 3.0.3, xenDaemonListDomains buffer overflow (Daniel Berrange), reference count bug when creating Xen domains (Daniel Berrange). - bug fixes: VCPU info breakages on xen 3.0.3, xenDaemonListDomains
- 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). buffer overflow (Daniel Berrange), reference count bug when creating Xen
domains (Daniel Berrange).
- 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).
0.1.9: Nov 29 2006: 0.1.9: Nov 29 2006:
- python bindings: release interpeter lock when calling C (Daniel Berrange) - python bindings: release interpeter lock when calling C (Daniel
Berrange)
- don't raise HTTP error when looking informations for a domain - don't raise HTTP error when looking informations for a domain
- some refactoring to use the driver for all entry points - some refactoring to use the driver for all entry points
- better error reporting (Daniel Berrange) - better error reporting (Daniel Berrange)
@ -38,15 +44,20 @@ Releases
- provide XML parsing errors - provide XML parsing errors
- extension of the test framework (Daniel Berrange) - extension of the test framework (Daniel Berrange)
- fix the reconnect regression test - fix the reconnect regression test
- python bindings: Domain instances now link to the Connect to avoid garbage collection and disconnect - python bindings: Domain instances now link to the Connect to avoid
- separate the notion of maximum memory and current use at the XML level garbage collection and disconnect
- separate the notion of maximum memory and current use at the XML
level
- Fix a memory leak (Daniel Berrange) - Fix a memory leak (Daniel Berrange)
- add support for shareable drives - add support for shareable drives
- add support for non-bridge style networking configs for guests(Daniel Berrange) - add support for non-bridge style networking configs for guests(Daniel
Berrange)
- python bindings: fix unsigned long marshalling (Daniel Berrange) - python bindings: fix unsigned long marshalling (Daniel Berrange)
- new config APIs virConfNew() and virConfSetValue() to build configs from scratch - new config APIs virConfNew() and virConfSetValue() to build configs
from scratch
- hot plug device support based on Michel Ponceau patch - hot plug device support based on Michel Ponceau patch
- added support for inactive domains, new APIs, various associated cleanup (Daniel Berrange) - added support for inactive domains, new APIs, various associated
cleanup (Daniel Berrange)
- special device model for HVM guests (Daniel Berrange) - special device model for HVM guests (Daniel Berrange)
- add API to dump core of domains (but requires a patched xend) - add API to dump core of domains (but requires a patched xend)
- pygrub bootloader informations take over <os> informations - pygrub bootloader informations take over <os> informations
@ -54,72 +65,78 @@ Releases
0.1.8: Oct 16 2006: 0.1.8: Oct 16 2006:
- Bug for system with page size != 4k - Bug for system with page size != 4k
- vcpu number initialization (Philippe Berthault) - vcpu number initialization (Philippe Berthault)
- don't label crashed domains as shut off (Peter Vetere) - don't label crashed domains as shut off (Peter Vetere)
- fix virsh man page (Noriko Mizumoto) - fix virsh man page (Noriko Mizumoto)
- blktapdd support for alternate drivers like blktap (Daniel Berrange) - blktapdd support for alternate drivers like blktap (Daniel
- memory leak fixes (xend interface and XML parsing) (Daniel Berrange) Berrange)
- compile fix - memory leak fixes (xend interface and XML parsing) (Daniel
- mlock/munlock size fixes (Daniel Berrange) Berrange)
- improve error reporting - compile fix
- mlock/munlock size fixes (Daniel Berrange)
- improve error reporting
0.1.7: Sep 29 2006: 0.1.7: Sep 29 2006:
- fix a memory bug on getting vcpu informations from xend (Daniel Berrange) - fix a memory bug on getting vcpu informations from xend (Daniel
- fix another problem in the hypercalls change in Xen changeset Berrange)
86d26e6ec89b when getting domain informations (Daniel Berrange) - fix another problem in the hypercalls change in Xen
changeset86d26e6ec89b when getting domain informations (Daniel
Berrange)
0.1.6: Sep 22 2006: 0.1.6: Sep 22 2006:
- Support for localization of strings using gettext (Daniel Berrange) - Support for localization of strings using gettext (Daniel Berrange)
- Support for new Xen-3.0.3 cdrom and disk configuration (Daniel Berrange) - Support for new Xen-3.0.3 cdrom and disk configuration (Daniel
- Support for setting VNC port when creating domains with new Berrange)
xend config files (Daniel Berrange) - Support for setting VNC port when creating domains with newxend config
files (Daniel Berrange)
- Fix bug when running against xen-3.0.2 hypercalls (Jim Fehlig) - Fix bug when running against xen-3.0.2 hypercalls (Jim Fehlig)
- Fix reconnection problem when talking directly to http xend - Fix reconnection problem when talking directly to http xend
0.1.5: Sep 5 2006: 0.1.5: Sep 5 2006:
- Support for new hypercalls change in Xen changeset 86d26e6ec89b - Support for new hypercalls change in Xen changeset 86d26e6ec89b
- bug fixes: virParseUUID() was wrong, netwoking for paravirt guestsi - bug fixes: virParseUUID() was wrong, netwoking for paravirt
(Daniel Berrange), virsh on non-existent domains (Daniel Berrange), guestsi(Daniel Berrange), virsh on non-existent domains (Daniel
string cast bug when handling error in python (Pete Vetere), HTTP Berrange),string cast bug when handling error in python (Pete Vetere),
500 xend error code handling (Pete Vetere and Daniel Berrange) HTTP500 xend error code handling (Pete Vetere and Daniel Berrange)
- improvements: test suite for SEXPR <-> XML format conversions (Daniel - improvements: test suite for SEXPR <-> XML format conversions
Berrange), virsh output regression suite (Daniel Berrange), new environ (DanielBerrange), virsh output regression suite (Daniel Berrange), new
variable VIRSH_DEFAULT_CONNECT_URI for the default URI when connecting environvariable VIRSH_DEFAULT_CONNECT_URI for the default URI when
(Daniel Berrange), graphical console support for paravirt guests connecting(Daniel Berrange), graphical console support for paravirt
(Jeremy Katz), parsing of simple Xen config files (with Daniel Berrange), guests(Jeremy Katz), parsing of simple Xen config files (with Daniel
early work on defined (not running) domains (Daniel Berrange), Berrange),early work on defined (not running) domains (Daniel
virsh output improvement (Daniel Berrange Berrange),virsh output improvement (Daniel Berrange
0.1.4: Aug 16 2006: 0.1.4: Aug 16 2006:
- bug fixes: spec file fix (Mark McLoughlin), error report problem (with - bug fixes: spec file fix (Mark McLoughlin), error report problem
Hugh Brock), long integer in Python bindings (with Daniel Berrange), XML (withHugh Brock), long integer in Python bindings (with Daniel Berrange),
generation bug for CDRom (Daniel Berrange), bug whem using number() XPath XMLgeneration bug for CDRom (Daniel Berrange), bug whem using number()
function (Mark McLoughlin), fix python detection code, remove duplicate XPathfunction (Mark McLoughlin), fix python detection code, remove
initialization errors (Daniel Berrange) duplicateinitialization errors (Daniel Berrange)
- improvements: UUID in XML description (Peter Vetere), proxy code - improvements: UUID in XML description (Peter Vetere), proxy
cleanup, virtual CPU and affinity support + virsh support (Michel codecleanup, virtual CPU and affinity support + virsh support
Ponceau, Philippe Berthault, Daniel Berrange), port and tty informations (MichelPonceau, Philippe Berthault, Daniel Berrange), port and tty
for console in XML (Daniel Berrange), added XML dump to driver and proxy informationsfor console in XML (Daniel Berrange), added XML dump to
support (Daniel Berrange), extention of boot options with support for driver and proxysupport (Daniel Berrange), extention of boot options with
floppy and cdrom (Daniel Berrange), features block in XML to report/ask support forfloppy and cdrom (Daniel Berrange), features block in XML to
PAE, ACPI, APIC for HVM domains (Daniel Berrange), fail saide-effect report/askPAE, ACPI, APIC for HVM domains (Daniel Berrange), fail
operations when using read-only connection, large improvements to test saide-effectoperations when using read-only connection, large
driver (Daniel Berrange) improvements to testdriver (Daniel Berrange)
- documentation: spelling (Daniel Berrange), test driver examples. - documentation: spelling (Daniel Berrange), test driver examples.
0.1.3: Jul 11 2006: 0.1.3: Jul 11 2006:
- bugfixes: build as non-root, fix xend access when root, handling of - bugfixes: build as non-root, fix xend access when root, handling
empty XML elements (Mark McLoughlin), XML serialization and parsing fixes ofempty XML elements (Mark McLoughlin), XML serialization and parsing
(Mark McLoughlin), allow to create domains without disk (Mark fixes(Mark McLoughlin), allow to create domains without disk
McLoughlin), (MarkMcLoughlin),
- improvement: xenDaemonLookupByID from O(n^2) to O(n) (Daniel Berrange), - improvement: xenDaemonLookupByID from O(n^2) to O(n) (Daniel
support for fully virtualized guest (Jim Fehlig, DV, Mark McLoughlin) Berrange),support for fully virtualized guest (Jim Fehlig, DV, Mark
McLoughlin)
- documentation: augmented to cover hvm domains - documentation: augmented to cover hvm domains
@ -129,57 +146,57 @@ Releases
0.1.1: Jun 21 2006: 0.1.1: Jun 21 2006:
- building fixes: ncurses fallback (Jim Fehlig), VPATH builds (Daniel P. - building fixes: ncurses fallback (Jim Fehlig), VPATH builds (Daniel
Berrange) P.Berrange)
- driver cleanups: new entry points, cleanup of libvirt.c (with Daniel P. - driver cleanups: new entry points, cleanup of libvirt.c (with Daniel
Berrange) P.Berrange)
- Cope with API change introduced in Xen changeset 10277 - Cope with API change introduced in Xen changeset 10277
- new test driver for regression checks (Daniel P. Berrange) - new test driver for regression checks (Daniel P. Berrange)
- improvements: added UUID to XML serialization, buffer usage (Karel - improvements: added UUID to XML serialization, buffer usage (KarelZak),
Zak), --connect argument to virsh (Daniel P. Berrange), --connect argument to virsh (Daniel P. Berrange),
- bug fixes: uninitialized memory access in error reporting, S-Expr - bug fixes: uninitialized memory access in error reporting,
parsing (Jim Fehlig, Jeremy Katz), virConnectOpen bug, remove a TODO in S-Exprparsing (Jim Fehlig, Jeremy Katz), virConnectOpen bug, remove a
xs_internal.c TODO inxs_internal.c
- documentation: Python examples (David Lutterkort), new Perl binding - documentation: Python examples (David Lutterkort), new Perl bindingURL,
URL, man page update (Karel Zak) man page update (Karel Zak)
0.1.0: Apr 10 2006: 0.1.0: Apr 10 2006:
- building fixes: --with-xen-distdir option (Ronald Aigner), out of tree - building fixes: --with-xen-distdir option (Ronald Aigner), out of
build and pkginfo cflag fix (Daniel Berrange) treebuild and pkginfo cflag fix (Daniel Berrange)
- enhancement and fixes of the XML description format (David Lutterkort - enhancement and fixes of the XML description format (David
and Jim Fehlig) Lutterkortand Jim Fehlig)
- new APIs: for Node information and Reboot - new APIs: for Node information and Reboot
- internal code cleanup: refactoring internals into a driver model, more - internal code cleanup: refactoring internals into a driver model,
error handling, structure sharing, thread safety and ref counting moreerror handling, structure sharing, thread safety and ref counting
- bug fixes: error message (Jim Meyering), error allocation in virsh (Jim - bug fixes: error message (Jim Meyering), error allocation in virsh
Meyering), virDomainLookupByID (Jim Fehlig), (JimMeyering), virDomainLookupByID (Jim Fehlig),
- documentation: updates on architecture, and format, typo fix (Jim - documentation: updates on architecture, and format, typo fix
Meyering) (JimMeyering)
- bindings: exception handling in examples (Jim Meyering), perl ones out - bindings: exception handling in examples (Jim Meyering), perl ones
of tree (Daniel Berrange) outof tree (Daniel Berrange)
- virsh: more options, create, nodeinfo (Karel Zak), renaming of some - virsh: more options, create, nodeinfo (Karel Zak), renaming of
options (Karel Zak), use stderr only for errors (Karel Zak), man page someoptions (Karel Zak), use stderr only for errors (Karel Zak), man
(Andrew Puch) page(Andrew Puch)
0.0.6: Feb 28 2006: 0.0.6: Feb 28 2006:
- add UUID lookup and extract API - add UUID lookup and extract API
- add error handling APIs both synchronous and asynchronous - add error handling APIs both synchronous and asynchronous
- added minimal hook for error handling at the python level, improved the - added minimal hook for error handling at the python level, improved
python bindings thepython bindings
- augment the documentation and tests to cover error handling - augment the documentation and tests to cover error handling
0.0.5: Feb 23 2006: 0.0.5: Feb 23 2006:
- Added XML description parsing, dependance to libxml2, implemented the - Added XML description parsing, dependance to libxml2, implemented
creation API virDomainCreateLinux() thecreation API virDomainCreateLinux()
- new APIs to lookup and name domain by UUID - new APIs to lookup and name domain by UUID
- fixed the XML dump when using the Xend access - fixed the XML dump when using the Xend access
- Fixed a few more problem related to the name change - Fixed a few more problem related to the name change
- Adding regression tests in python and examples in C - Adding regression tests in python and examples in C
- web site improvement, extended the documentation to cover the XML - web site improvement, extended the documentation to cover the XMLformat
format and Python API and Python API
- Added devhelp help for Gnome/Gtk programmers - Added devhelp help for Gnome/Gtk programmers
@ -195,8 +212,8 @@ Releases
0.0.2: Jan 29 2006: 0.0.2: Jan 29 2006:
- Update of the documentation, web site redesign (Diana Fong) - Update of the documentation, web site redesign (Diana Fong)
- integration of HTTP xend RPC based on libxend by Anthony Liquori for - integration of HTTP xend RPC based on libxend by Anthony Liquori
most operations formost operations
- Adding Save and Restore APIs - Adding Save and Restore APIs
- extended the virsh command line tool (Karel Zak) - extended the virsh command line tool (Karel Zak)
- remove xenstore transactions (Anthony Liguori) - remove xenstore transactions (Anthony Liguori)

4
configure.in
View File

@ -43,6 +43,8 @@ AC_PATH_PROG(TAR, tar, /bin/tar)
AC_PATH_PROG(XMLLINT, xmllint, /usr/bin/xmllint) AC_PATH_PROG(XMLLINT, xmllint, /usr/bin/xmllint)
AC_PATH_PROG(XSLTPROC, xsltproc, /usr/bin/xsltproc) AC_PATH_PROG(XSLTPROC, xsltproc, /usr/bin/xsltproc)
dnl Availability of various common functions.
AC_CHECK_FUNCS([regexec])
dnl Make sure we have an ANSI compiler dnl Make sure we have an ANSI compiler
AM_C_PROTOTYPES AM_C_PROTOTYPES
@ -50,6 +52,8 @@ test "x$U" != "x" && AC_MSG_ERROR(Compiler not ANSI compliant)
AM_PROG_LIBTOOL AM_PROG_LIBTOOL
AM_PROG_CC_C_O
LIBVIRT_COMPILE_WARNINGS(maximum) LIBVIRT_COMPILE_WARNINGS(maximum)
dnl Specific dir for HTML output ? dnl Specific dir for HTML output ?

14
docs/APIchunk0.html
View File

@ -113,11 +113,17 @@
<a href="html/libvirt-libvirt.html#virDomainGetXMLDesc">virDomainGetXMLDesc</a><br /> <a href="html/libvirt-libvirt.html#virDomainGetXMLDesc">virDomainGetXMLDesc</a><br />
<a href="html/libvirt-virterror.html#virGetLastError">virGetLastError</a><br /> <a href="html/libvirt-virterror.html#virGetLastError">virGetLastError</a><br />
<a href="html/libvirt-libvirt.html#virNetworkGetXMLDesc">virNetworkGetXMLDesc</a><br /> <a href="html/libvirt-libvirt.html#virNetworkGetXMLDesc">virNetworkGetXMLDesc</a><br />
</dd><dt>Provides</dt><dd><a href="html/libvirt-libvirt.html#virConnectNumOfDefinedDomains">virConnectNumOfDefinedDomains</a><br /> </dd><dt>Provides</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetCapabilities">virConnectGetCapabilities</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetMaxVcpus">virConnectGetMaxVcpus</a><br />
<a href="html/libvirt-libvirt.html#virConnectNumOfDefinedDomains">virConnectNumOfDefinedDomains</a><br />
<a href="html/libvirt-libvirt.html#virConnectNumOfDefinedNetworks">virConnectNumOfDefinedNetworks</a><br /> <a href="html/libvirt-libvirt.html#virConnectNumOfDefinedNetworks">virConnectNumOfDefinedNetworks</a><br />
<a href="html/libvirt-libvirt.html#virConnectNumOfDomains">virConnectNumOfDomains</a><br /> <a href="html/libvirt-libvirt.html#virConnectNumOfDomains">virConnectNumOfDomains</a><br />
<a href="html/libvirt-libvirt.html#virConnectNumOfNetworks">virConnectNumOfNetworks</a><br /> <a href="html/libvirt-libvirt.html#virConnectNumOfNetworks">virConnectNumOfNetworks</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetAutostart">virDomainGetAutostart</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetMaxVcpus">virDomainGetMaxVcpus</a><br />
<a href="html/libvirt-libvirt.html#virGetVersion">virGetVersion</a><br /> <a href="html/libvirt-libvirt.html#virGetVersion">virGetVersion</a><br />
<a href="html/libvirt-libvirt.html#virNetworkGetAutostart">virNetworkGetAutostart</a><br />
<a href="html/libvirt-libvirt.html#virNetworkGetBridgeName">virNetworkGetBridgeName</a><br />
</dd></dl><h2>Letter R:</h2><dl><dt>RFC4122</dt><dd><a href="html/libvirt-libvirt.html#virDomainGetUUIDString">virDomainGetUUIDString</a><br /> </dd></dl><h2>Letter R:</h2><dl><dt>RFC4122</dt><dd><a href="html/libvirt-libvirt.html#virDomainGetUUIDString">virDomainGetUUIDString</a><br />
<a href="html/libvirt-libvirt.html#virNetworkGetUUIDString">virNetworkGetUUIDString</a><br /> <a href="html/libvirt-libvirt.html#virNetworkGetUUIDString">virNetworkGetUUIDString</a><br />
</dd><dt>Read-Only</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br /> </dd><dt>Read-Only</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br />
@ -127,11 +133,6 @@
<a href="html/libvirt-virterror.html#virResetLastError">virResetLastError</a><br /> <a href="html/libvirt-virterror.html#virResetLastError">virResetLastError</a><br />
</dd><dt>Resume</dt><dd><a href="html/libvirt-libvirt.html#virDomainResume">virDomainResume</a><br /> </dd><dt>Resume</dt><dd><a href="html/libvirt-libvirt.html#virDomainResume">virDomainResume</a><br />
</dd><dt>Retrieve</dt><dd><a href="html/libvirt-libvirt.html#virDomainGetMaxMemory">virDomainGetMaxMemory</a><br /> </dd><dt>Retrieve</dt><dd><a href="html/libvirt-libvirt.html#virDomainGetMaxMemory">virDomainGetMaxMemory</a><br />
</dd><dt>Returns</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetMaxVcpus">virConnectGetMaxVcpus</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetAutostart">virDomainGetAutostart</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetMaxVcpus">virDomainGetMaxVcpus</a><br />
<a href="html/libvirt-libvirt.html#virNetworkGetAutostart">virNetworkGetAutostart</a><br />
<a href="html/libvirt-libvirt.html#virNetworkGetBridgeName">virNetworkGetBridgeName</a><br />
</dd></dl><h2>Letter S:</h2><dl><dt>Set</dt><dd><a href="html/libvirt-virterror.html#virConnSetErrorFunc">virConnSetErrorFunc</a><br /> </dd></dl><h2>Letter S:</h2><dl><dt>Set</dt><dd><a href="html/libvirt-virterror.html#virConnSetErrorFunc">virConnSetErrorFunc</a><br />
<a href="html/libvirt-virterror.html#virSetErrorFunc">virSetErrorFunc</a><br /> <a href="html/libvirt-virterror.html#virSetErrorFunc">virSetErrorFunc</a><br />
</dd><dt>Shutdown</dt><dd><a href="html/libvirt-libvirt.html#virDomainShutdown">virDomainShutdown</a><br /> </dd><dt>Shutdown</dt><dd><a href="html/libvirt-libvirt.html#virDomainShutdown">virDomainShutdown</a><br />
@ -147,6 +148,7 @@
<a href="html/libvirt-libvirt.html#VIR_NODEINFO_MAXCPUS">VIR_NODEINFO_MAXCPUS</a><br /> <a href="html/libvirt-libvirt.html#VIR_NODEINFO_MAXCPUS">VIR_NODEINFO_MAXCPUS</a><br />
<a href="html/libvirt-libvirt.html#VIR_UNUSE_CPU">VIR_UNUSE_CPU</a><br /> <a href="html/libvirt-libvirt.html#VIR_UNUSE_CPU">VIR_UNUSE_CPU</a><br />
<a href="html/libvirt-libvirt.html#VIR_USE_CPU">VIR_USE_CPU</a><br /> <a href="html/libvirt-libvirt.html#VIR_USE_CPU">VIR_USE_CPU</a><br />
<a href="html/libvirt-libvirt.html#VIR_UUID_BUFLEN">VIR_UUID_BUFLEN</a><br />
<a href="html/libvirt-libvirt.html#VIR_UUID_STRING_BUFLEN">VIR_UUID_STRING_BUFLEN</a><br /> <a href="html/libvirt-libvirt.html#VIR_UUID_STRING_BUFLEN">VIR_UUID_STRING_BUFLEN</a><br />
<a href="">cpumap</a><br /> <a href="">cpumap</a><br />
<a href="html/libvirt-libvirt.html#virConnectClose">virConnectClose</a><br /> <a href="html/libvirt-libvirt.html#virConnectClose">virConnectClose</a><br />

8
docs/APIchunk1.html
View File

@ -34,7 +34,8 @@
<a href="html/libvirt-libvirt.html#virConnectNumOfNetworks">virConnectNumOfNetworks</a><br /> <a href="html/libvirt-libvirt.html#virConnectNumOfNetworks">virConnectNumOfNetworks</a><br />
<a href="html/libvirt-libvirt.html#virDomainSuspend">virDomainSuspend</a><br /> <a href="html/libvirt-libvirt.html#virDomainSuspend">virDomainSuspend</a><br />
</dd><dt>add</dt><dd><a href="html/libvirt-libvirt.html#virDomainShutdown">virDomainShutdown</a><br /> </dd><dt>add</dt><dd><a href="html/libvirt-libvirt.html#virDomainShutdown">virDomainShutdown</a><br />
</dd><dt>after</dt><dd><a href="html/libvirt-libvirt.html#virDomainReboot">virDomainReboot</a><br /> </dd><dt>after</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetCapabilities">virConnectGetCapabilities</a><br />
<a href="html/libvirt-libvirt.html#virDomainReboot">virDomainReboot</a><br />
<a href="html/libvirt-libvirt.html#virDomainSave">virDomainSave</a><br /> <a href="html/libvirt-libvirt.html#virDomainSave">virDomainSave</a><br />
<a href="html/libvirt-libvirt.html#virDomainShutdown">virDomainShutdown</a><br /> <a href="html/libvirt-libvirt.html#virDomainShutdown">virDomainShutdown</a><br />
</dd><dt>against</dt><dd><a href="html/libvirt-libvirt.html#virGetVersion">virGetVersion</a><br /> </dd><dt>against</dt><dd><a href="html/libvirt-libvirt.html#virGetVersion">virGetVersion</a><br />
@ -137,7 +138,8 @@
<a href="html/libvirt-libvirt.html#virNetworkGetAutostart">virNetworkGetAutostart</a><br /> <a href="html/libvirt-libvirt.html#virNetworkGetAutostart">virNetworkGetAutostart</a><br />
<a href="html/libvirt-libvirt.html#virNetworkSetAutostart">virNetworkSetAutostart</a><br /> <a href="html/libvirt-libvirt.html#virNetworkSetAutostart">virNetworkSetAutostart</a><br />
</dd><dt>bridge</dt><dd><a href="html/libvirt-libvirt.html#virNetworkGetBridgeName">virNetworkGetBridgeName</a><br /> </dd><dt>bridge</dt><dd><a href="html/libvirt-libvirt.html#virNetworkGetBridgeName">virNetworkGetBridgeName</a><br />
</dd><dt>buffer</dt><dd><a href="html/libvirt-libvirt.html#VIR_UUID_STRING_BUFLEN">VIR_UUID_STRING_BUFLEN</a><br /> </dd><dt>buffer</dt><dd><a href="html/libvirt-libvirt.html#VIR_UUID_BUFLEN">VIR_UUID_BUFLEN</a><br />
<a href="html/libvirt-libvirt.html#VIR_UUID_STRING_BUFLEN">VIR_UUID_STRING_BUFLEN</a><br />
</dd><dt>but</dt><dd><a href="html/libvirt-libvirt.html#VIR_NODEINFO_MAXCPUS">VIR_NODEINFO_MAXCPUS</a><br /> </dd><dt>but</dt><dd><a href="html/libvirt-libvirt.html#VIR_NODEINFO_MAXCPUS">VIR_NODEINFO_MAXCPUS</a><br />
<a href="html/libvirt-virterror.html#virConnGetLastError">virConnGetLastError</a><br /> <a href="html/libvirt-virterror.html#virConnGetLastError">virConnGetLastError</a><br />
<a href="html/libvirt-libvirt.html#virDomainDefineXML">virDomainDefineXML</a><br /> <a href="html/libvirt-libvirt.html#virDomainDefineXML">virDomainDefineXML</a><br />
@ -186,6 +188,7 @@
</dd><dt>can</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br /> </dd><dt>can</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetInfo">virDomainGetInfo</a><br /> <a href="html/libvirt-libvirt.html#virDomainGetInfo">virDomainGetInfo</a><br />
<a href="html/libvirt-libvirt.html#virDomainPinVcpu">virDomainPinVcpu</a><br /> <a href="html/libvirt-libvirt.html#virDomainPinVcpu">virDomainPinVcpu</a><br />
</dd><dt>capabilities</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetCapabilities">virConnectGetCapabilities</a><br />
</dd><dt>capacities</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br /> </dd><dt>capacities</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br />
</dd><dt>caught</dt><dd><a href="html/libvirt-virterror.html#virConnCopyLastError">virConnCopyLastError</a><br /> </dd><dt>caught</dt><dd><a href="html/libvirt-virterror.html#virConnCopyLastError">virConnCopyLastError</a><br />
<a href="html/libvirt-virterror.html#virConnGetLastError">virConnGetLastError</a><br /> <a href="html/libvirt-virterror.html#virConnGetLastError">virConnGetLastError</a><br />
@ -200,6 +203,7 @@
<a href="html/libvirt-libvirt.html#virDomainSetMemory">virDomainSetMemory</a><br /> <a href="html/libvirt-libvirt.html#virDomainSetMemory">virDomainSetMemory</a><br />
<a href="html/libvirt-libvirt.html#virDomainSetVcpus">virDomainSetVcpus</a><br /> <a href="html/libvirt-libvirt.html#virDomainSetVcpus">virDomainSetVcpus</a><br />
</dd><dt>clean</dt><dd><a href="html/libvirt-virterror.html#virResetError">virResetError</a><br /> </dd><dt>clean</dt><dd><a href="html/libvirt-virterror.html#virResetError">virResetError</a><br />
</dd><dt>client</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetCapabilities">virConnectGetCapabilities</a><br />
</dd><dt>closes</dt><dd><a href="html/libvirt-libvirt.html#virConnectClose">virConnectClose</a><br /> </dd><dt>closes</dt><dd><a href="html/libvirt-libvirt.html#virConnectClose">virConnectClose</a><br />
</dd><dt>code</dt><dd><a href="html/libvirt-virterror.html#_virError">_virError</a><br /> </dd><dt>code</dt><dd><a href="html/libvirt-virterror.html#_virError">_virError</a><br />
<a href="html/libvirt-virterror.html#virConnCopyLastError">virConnCopyLastError</a><br /> <a href="html/libvirt-virterror.html#virConnCopyLastError">virConnCopyLastError</a><br />

4
docs/APIchunk2.html
View File

@ -54,7 +54,8 @@
<a href="html/libvirt-libvirt.html#virDomainCreate">virDomainCreate</a><br /> <a href="html/libvirt-libvirt.html#virDomainCreate">virDomainCreate</a><br />
</dd><dt>down</dt><dd><a href="html/libvirt-libvirt.html#virDomainDestroy">virDomainDestroy</a><br /> </dd><dt>down</dt><dd><a href="html/libvirt-libvirt.html#virDomainDestroy">virDomainDestroy</a><br />
<a href="html/libvirt-libvirt.html#virNetworkDestroy">virNetworkDestroy</a><br /> <a href="html/libvirt-libvirt.html#virNetworkDestroy">virNetworkDestroy</a><br />
</dd><dt>driver</dt><dd><a href="html/libvirt-libvirt.html#virGetVersion">virGetVersion</a><br /> </dd><dt>driver</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetCapabilities">virConnectGetCapabilities</a><br />
<a href="html/libvirt-libvirt.html#virGetVersion">virGetVersion</a><br />
</dd><dt>dump</dt><dd><a href="html/libvirt-libvirt.html#virDomainCoreDump">virDomainCoreDump</a><br /> </dd><dt>dump</dt><dd><a href="html/libvirt-libvirt.html#virDomainCoreDump">virDomainCoreDump</a><br />
</dd></dl><h2>Letter e:</h2><dl><dt>each</dt><dd><a href="html/libvirt-libvirt.html#virDomainPinVcpu">virDomainPinVcpu</a><br /> </dd></dl><h2>Letter e:</h2><dl><dt>each</dt><dd><a href="html/libvirt-libvirt.html#virDomainPinVcpu">virDomainPinVcpu</a><br />
</dd><dt>element</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetMaxVcpus">virConnectGetMaxVcpus</a><br /> </dd><dt>element</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetMaxVcpus">virConnectGetMaxVcpus</a><br />
@ -93,6 +94,7 @@
<a href="html/libvirt-libvirt.html#virConnectNumOfNetworks">virConnectNumOfNetworks</a><br /> <a href="html/libvirt-libvirt.html#virConnectNumOfNetworks">virConnectNumOfNetworks</a><br />
<a href="html/libvirt-virterror.html#virCopyLastError">virCopyLastError</a><br /> <a href="html/libvirt-virterror.html#virCopyLastError">virCopyLastError</a><br />
</dd><dt>free</dt><dd><a href="html/libvirt-virterror.html#virConnCopyLastError">virConnCopyLastError</a><br /> </dd><dt>free</dt><dd><a href="html/libvirt-virterror.html#virConnCopyLastError">virConnCopyLastError</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetCapabilities">virConnectGetCapabilities</a><br />
<a href="html/libvirt-virterror.html#virCopyLastError">virCopyLastError</a><br /> <a href="html/libvirt-virterror.html#virCopyLastError">virCopyLastError</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetXMLDesc">virDomainGetXMLDesc</a><br /> <a href="html/libvirt-libvirt.html#virDomainGetXMLDesc">virDomainGetXMLDesc</a><br />
<a href="html/libvirt-libvirt.html#virNetworkGetBridgeName">virNetworkGetBridgeName</a><br /> <a href="html/libvirt-libvirt.html#virNetworkGetBridgeName">virNetworkGetBridgeName</a><br />

3
docs/APIchunk3.html
View File

@ -29,6 +29,7 @@
</dd><dt>launch</dt><dd><a href="html/libvirt-libvirt.html#virDomainCreate">virDomainCreate</a><br /> </dd><dt>launch</dt><dd><a href="html/libvirt-libvirt.html#virDomainCreate">virDomainCreate</a><br />
</dd><dt>least</dt><dd><a href="html/libvirt-libvirt.html#virDomainPinVcpu">virDomainPinVcpu</a><br /> </dd><dt>least</dt><dd><a href="html/libvirt-libvirt.html#virDomainPinVcpu">virDomainPinVcpu</a><br />
</dd><dt>length</dt><dd><a href="html/libvirt-libvirt.html#VIR_CPU_MAPLEN">VIR_CPU_MAPLEN</a><br /> </dd><dt>length</dt><dd><a href="html/libvirt-libvirt.html#VIR_CPU_MAPLEN">VIR_CPU_MAPLEN</a><br />
<a href="html/libvirt-libvirt.html#VIR_UUID_BUFLEN">VIR_UUID_BUFLEN</a><br />
<a href="html/libvirt-libvirt.html#VIR_UUID_STRING_BUFLEN">VIR_UUID_STRING_BUFLEN</a><br /> <a href="html/libvirt-libvirt.html#VIR_UUID_STRING_BUFLEN">VIR_UUID_STRING_BUFLEN</a><br />
<a href="">maplen</a><br /> <a href="">maplen</a><br />
</dd><dt>level</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br /> </dd><dt>level</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br />
@ -78,6 +79,7 @@
<a href="html/libvirt-libvirt.html#VIR_NODEINFO_MAXCPUS">VIR_NODEINFO_MAXCPUS</a><br /> <a href="html/libvirt-libvirt.html#VIR_NODEINFO_MAXCPUS">VIR_NODEINFO_MAXCPUS</a><br />
<a href="html/libvirt-libvirt.html#VIR_UNUSE_CPU">VIR_UNUSE_CPU</a><br /> <a href="html/libvirt-libvirt.html#VIR_UNUSE_CPU">VIR_UNUSE_CPU</a><br />
<a href="html/libvirt-libvirt.html#VIR_USE_CPU">VIR_USE_CPU</a><br /> <a href="html/libvirt-libvirt.html#VIR_USE_CPU">VIR_USE_CPU</a><br />
<a href="html/libvirt-libvirt.html#VIR_UUID_BUFLEN">VIR_UUID_BUFLEN</a><br />
<a href="html/libvirt-libvirt.html#VIR_UUID_STRING_BUFLEN">VIR_UUID_STRING_BUFLEN</a><br /> <a href="html/libvirt-libvirt.html#VIR_UUID_STRING_BUFLEN">VIR_UUID_STRING_BUFLEN</a><br />
</dd><dt>major</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br /> </dd><dt>major</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br />
<a href="html/libvirt-libvirt.html#virGetVersion">virGetVersion</a><br /> <a href="html/libvirt-libvirt.html#virGetVersion">virGetVersion</a><br />
@ -141,6 +143,7 @@
<a href="html/libvirt-virterror.html#virGetLastError">virGetLastError</a><br /> <a href="html/libvirt-virterror.html#virGetLastError">virGetLastError</a><br />
<a href="html/libvirt-libvirt.html#virInitialize">virInitialize</a><br /> <a href="html/libvirt-libvirt.html#virInitialize">virInitialize</a><br />
</dd><dt>must</dt><dd><a href="">cpumap</a><br /> </dd><dt>must</dt><dd><a href="">cpumap</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetCapabilities">virConnectGetCapabilities</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetOSType">virDomainGetOSType</a><br /> <a href="html/libvirt-libvirt.html#virDomainGetOSType">virDomainGetOSType</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetVcpus">virDomainGetVcpus</a><br /> <a href="html/libvirt-libvirt.html#virDomainGetVcpus">virDomainGetVcpus</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetXMLDesc">virDomainGetXMLDesc</a><br /> <a href="html/libvirt-libvirt.html#virDomainGetXMLDesc">virDomainGetXMLDesc</a><br />

16
docs/APIchunk4.html
View File

@ -19,6 +19,7 @@
<a href="html/libvirt-libvirt.html#virNetworkCreateXML">virNetworkCreateXML</a><br /> <a href="html/libvirt-libvirt.html#virNetworkCreateXML">virNetworkCreateXML</a><br />
</dd><dt>only</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br /> </dd><dt>only</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetInfo">virDomainGetInfo</a><br /> <a href="html/libvirt-libvirt.html#virDomainGetInfo">virDomainGetInfo</a><br />
</dd><dt>opaque</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetCapabilities">virConnectGetCapabilities</a><br />
</dd><dt>operation</dt><dd><a href="html/libvirt-libvirt.html#virDomainGetOSType">virDomainGetOSType</a><br /> </dd><dt>operation</dt><dd><a href="html/libvirt-libvirt.html#virDomainGetOSType">virDomainGetOSType</a><br />
<a href="html/libvirt-libvirt.html#virDomainReboot">virDomainReboot</a><br /> <a href="html/libvirt-libvirt.html#virDomainReboot">virDomainReboot</a><br />
</dd><dt>option</dt><dd><a href="html/libvirt-libvirt.html#virDomainShutdown">virDomainShutdown</a><br /> </dd><dt>option</dt><dd><a href="html/libvirt-libvirt.html#virDomainShutdown">virDomainShutdown</a><br />
@ -84,7 +85,8 @@
<a href="html/libvirt-libvirt.html#virConnectListDefinedNetworks">virConnectListDefinedNetworks</a><br /> <a href="html/libvirt-libvirt.html#virConnectListDefinedNetworks">virConnectListDefinedNetworks</a><br />
<a href="html/libvirt-virterror.html#virErrorFunc">virErrorFunc</a><br /> <a href="html/libvirt-virterror.html#virErrorFunc">virErrorFunc</a><br />
<a href="html/libvirt-virterror.html#virSetErrorFunc">virSetErrorFunc</a><br /> <a href="html/libvirt-virterror.html#virSetErrorFunc">virSetErrorFunc</a><br />
</dd><dt>provides</dt><dd><a href="html/libvirt-libvirt.html#VIR_UUID_STRING_BUFLEN">VIR_UUID_STRING_BUFLEN</a><br /> </dd><dt>provides</dt><dd><a href="html/libvirt-libvirt.html#VIR_UUID_BUFLEN">VIR_UUID_BUFLEN</a><br />
<a href="html/libvirt-libvirt.html#VIR_UUID_STRING_BUFLEN">VIR_UUID_STRING_BUFLEN</a><br />
</dd><dt>providing</dt><dd><a href="html/libvirt-libvirt.html#LIBVIR_VERSION_NUMBER">LIBVIR_VERSION_NUMBER</a><br /> </dd><dt>providing</dt><dd><a href="html/libvirt-libvirt.html#LIBVIR_VERSION_NUMBER">LIBVIR_VERSION_NUMBER</a><br />
</dd><dt>public</dt><dd><a href="html/libvirt-libvirt.html#virDomainGetName">virDomainGetName</a><br /> </dd><dt>public</dt><dd><a href="html/libvirt-libvirt.html#virDomainGetName">virDomainGetName</a><br />
<a href="html/libvirt-libvirt.html#virNetworkGetName">virNetworkGetName</a><br /> <a href="html/libvirt-libvirt.html#virNetworkGetName">virNetworkGetName</a><br />
@ -116,6 +118,7 @@
</dd><dt>request</dt><dd><a href="html/libvirt-libvirt.html#virDomainReboot">virDomainReboot</a><br /> </dd><dt>request</dt><dd><a href="html/libvirt-libvirt.html#virDomainReboot">virDomainReboot</a><br />
<a href="html/libvirt-libvirt.html#virDomainShutdown">virDomainShutdown</a><br /> <a href="html/libvirt-libvirt.html#virDomainShutdown">virDomainShutdown</a><br />
</dd><dt>required</dt><dd><a href="html/libvirt-libvirt.html#VIR_CPU_MAPLEN">VIR_CPU_MAPLEN</a><br /> </dd><dt>required</dt><dd><a href="html/libvirt-libvirt.html#VIR_CPU_MAPLEN">VIR_CPU_MAPLEN</a><br />
<a href="html/libvirt-libvirt.html#VIR_UUID_BUFLEN">VIR_UUID_BUFLEN</a><br />
<a href="html/libvirt-libvirt.html#VIR_UUID_STRING_BUFLEN">VIR_UUID_STRING_BUFLEN</a><br /> <a href="html/libvirt-libvirt.html#VIR_UUID_STRING_BUFLEN">VIR_UUID_STRING_BUFLEN</a><br />
</dd><dt>requires</dt><dd><a href="html/libvirt-libvirt.html#virDomainCreateLinux">virDomainCreateLinux</a><br /> </dd><dt>requires</dt><dd><a href="html/libvirt-libvirt.html#virDomainCreateLinux">virDomainCreateLinux</a><br />
<a href="html/libvirt-libvirt.html#virDomainDestroy">virDomainDestroy</a><br /> <a href="html/libvirt-libvirt.html#virDomainDestroy">virDomainDestroy</a><br />
@ -146,12 +149,15 @@
<a href="html/libvirt-libvirt.html#virDomainDestroy">virDomainDestroy</a><br /> <a href="html/libvirt-libvirt.html#virDomainDestroy">virDomainDestroy</a><br />
<a href="html/libvirt-libvirt.html#virGetVersion">virGetVersion</a><br /> <a href="html/libvirt-libvirt.html#virGetVersion">virGetVersion</a><br />
<a href="html/libvirt-libvirt.html#virNetworkDestroy">virNetworkDestroy</a><br /> <a href="html/libvirt-libvirt.html#virNetworkDestroy">virNetworkDestroy</a><br />
</dd><dt>returned</dt><dd><a href="html/libvirt-libvirt.html#virDomainCreateLinux">virDomainCreateLinux</a><br /> </dd><dt>returned</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetCapabilities">virConnectGetCapabilities</a><br />
<a href="html/libvirt-libvirt.html#virDomainCreateLinux">virDomainCreateLinux</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetAutostart">virDomainGetAutostart</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetVcpus">virDomainGetVcpus</a><br /> <a href="html/libvirt-libvirt.html#virDomainGetVcpus">virDomainGetVcpus</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetXMLDesc">virDomainGetXMLDesc</a><br /> <a href="html/libvirt-libvirt.html#virDomainGetXMLDesc">virDomainGetXMLDesc</a><br />
<a href="html/libvirt-libvirt.html#virDomainPinVcpu">virDomainPinVcpu</a><br /> <a href="html/libvirt-libvirt.html#virDomainPinVcpu">virDomainPinVcpu</a><br />
<a href="html/libvirt-libvirt.html#virGetVersion">virGetVersion</a><br /> <a href="html/libvirt-libvirt.html#virGetVersion">virGetVersion</a><br />
<a href="html/libvirt-libvirt.html#virNetworkCreateXML">virNetworkCreateXML</a><br /> <a href="html/libvirt-libvirt.html#virNetworkCreateXML">virNetworkCreateXML</a><br />
<a href="html/libvirt-libvirt.html#virNetworkGetAutostart">virNetworkGetAutostart</a><br />
<a href="html/libvirt-libvirt.html#virNetworkGetBridgeName">virNetworkGetBridgeName</a><br /> <a href="html/libvirt-libvirt.html#virNetworkGetBridgeName">virNetworkGetBridgeName</a><br />
<a href="html/libvirt-libvirt.html#virNetworkGetXMLDesc">virNetworkGetXMLDesc</a><br /> <a href="html/libvirt-libvirt.html#virNetworkGetXMLDesc">virNetworkGetXMLDesc</a><br />
</dd><dt>returns</dt><dd><a href="html/libvirt-libvirt.html#VIR_CPU_MAPLEN">VIR_CPU_MAPLEN</a><br /> </dd><dt>returns</dt><dd><a href="html/libvirt-libvirt.html#VIR_CPU_MAPLEN">VIR_CPU_MAPLEN</a><br />
@ -199,9 +205,11 @@
<a href="html/libvirt-libvirt.html#virConnectOpenReadOnly">virConnectOpenReadOnly</a><br /> <a href="html/libvirt-libvirt.html#virConnectOpenReadOnly">virConnectOpenReadOnly</a><br />
<a href="html/libvirt-libvirt.html#virDomainDestroy">virDomainDestroy</a><br /> <a href="html/libvirt-libvirt.html#virDomainDestroy">virDomainDestroy</a><br />
<a href="html/libvirt-libvirt.html#virDomainFree">virDomainFree</a><br /> <a href="html/libvirt-libvirt.html#virDomainFree">virDomainFree</a><br />
<a href="html/libvirt-libvirt.html#virDomainSetAutostart">virDomainSetAutostart</a><br />
<a href="html/libvirt-libvirt.html#virDomainShutdown">virDomainShutdown</a><br /> <a href="html/libvirt-libvirt.html#virDomainShutdown">virDomainShutdown</a><br />
<a href="html/libvirt-libvirt.html#virNetworkDestroy">virNetworkDestroy</a><br /> <a href="html/libvirt-libvirt.html#virNetworkDestroy">virNetworkDestroy</a><br />
<a href="html/libvirt-libvirt.html#virNetworkFree">virNetworkFree</a><br /> <a href="html/libvirt-libvirt.html#virNetworkFree">virNetworkFree</a><br />
<a href="html/libvirt-libvirt.html#virNetworkSetAutostart">virNetworkSetAutostart</a><br />
</dd><dt>shutdown</dt><dd><a href="html/libvirt-libvirt.html#virDomainDestroy">virDomainDestroy</a><br /> </dd><dt>shutdown</dt><dd><a href="html/libvirt-libvirt.html#virDomainDestroy">virDomainDestroy</a><br />
<a href="html/libvirt-libvirt.html#virNetworkDestroy">virNetworkDestroy</a><br /> <a href="html/libvirt-libvirt.html#virNetworkDestroy">virNetworkDestroy</a><br />
</dd><dt>significant</dt><dd><a href="html/libvirt-libvirt.html#virDomainPinVcpu">virDomainPinVcpu</a><br /> </dd><dt>significant</dt><dd><a href="html/libvirt-libvirt.html#virDomainPinVcpu">virDomainPinVcpu</a><br />
@ -255,6 +263,7 @@
<a href="html/libvirt-libvirt.html#virConnectListDefinedNetworks">virConnectListDefinedNetworks</a><br /> <a href="html/libvirt-libvirt.html#virConnectListDefinedNetworks">virConnectListDefinedNetworks</a><br />
</dd><dt>string</dt><dd><a href="html/libvirt-virterror.html#_virError">_virError</a><br /> </dd><dt>string</dt><dd><a href="html/libvirt-virterror.html#_virError">_virError</a><br />
<a href="html/libvirt-libvirt.html#_virNodeInfo">_virNodeInfo</a><br /> <a href="html/libvirt-libvirt.html#_virNodeInfo">_virNodeInfo</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetCapabilities">virConnectGetCapabilities</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetType">virConnectGetType</a><br /> <a href="html/libvirt-libvirt.html#virConnectGetType">virConnectGetType</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetName">virDomainGetName</a><br /> <a href="html/libvirt-libvirt.html#virDomainGetName">virDomainGetName</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetOSType">virDomainGetOSType</a><br /> <a href="html/libvirt-libvirt.html#virDomainGetOSType">virDomainGetOSType</a><br />
@ -263,7 +272,8 @@
<a href="html/libvirt-libvirt.html#virNetworkGetName">virNetworkGetName</a><br /> <a href="html/libvirt-libvirt.html#virNetworkGetName">virNetworkGetName</a><br />
<a href="html/libvirt-libvirt.html#virNetworkGetUUIDString">virNetworkGetUUIDString</a><br /> <a href="html/libvirt-libvirt.html#virNetworkGetUUIDString">virNetworkGetUUIDString</a><br />
<a href="html/libvirt-libvirt.html#virNetworkLookupByUUIDString">virNetworkLookupByUUIDString</a><br /> <a href="html/libvirt-libvirt.html#virNetworkLookupByUUIDString">virNetworkLookupByUUIDString</a><br />
</dd><dt>structure</dt><dd><a href="html/libvirt-libvirt.html#virDomainDestroy">virDomainDestroy</a><br /> </dd><dt>structure</dt><dd><a href="html/libvirt-libvirt.html#virConnectGetCapabilities">virConnectGetCapabilities</a><br />
<a href="html/libvirt-libvirt.html#virDomainDestroy">virDomainDestroy</a><br />
<a href="html/libvirt-libvirt.html#virDomainFree">virDomainFree</a><br /> <a href="html/libvirt-libvirt.html#virDomainFree">virDomainFree</a><br />
<a href="html/libvirt-libvirt.html#virDomainGetInfo">virDomainGetInfo</a><br /> <a href="html/libvirt-libvirt.html#virDomainGetInfo">virDomainGetInfo</a><br />
<a href="html/libvirt-libvirt.html#virNetworkDestroy">virNetworkDestroy</a><br /> <a href="html/libvirt-libvirt.html#virNetworkDestroy">virNetworkDestroy</a><br />

2
docs/APIfiles.html
View File

@ -35,6 +35,7 @@
<a href="html/libvirt-libvirt.html#_virVcpuInfo">_virVcpuInfo</a><br /> <a href="html/libvirt-libvirt.html#_virVcpuInfo">_virVcpuInfo</a><br />
<a href="html/libvirt-libvirt.html#virConnect">virConnect</a><br /> <a href="html/libvirt-libvirt.html#virConnect">virConnect</a><br />
<a href="html/libvirt-libvirt.html#virConnectClose">virConnectClose</a><br /> <a href="html/libvirt-libvirt.html#virConnectClose">virConnectClose</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetCapabilities">virConnectGetCapabilities</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetMaxVcpus">virConnectGetMaxVcpus</a><br /> <a href="html/libvirt-libvirt.html#virConnectGetMaxVcpus">virConnectGetMaxVcpus</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetType">virConnectGetType</a><br /> <a href="html/libvirt-libvirt.html#virConnectGetType">virConnectGetType</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br /> <a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br />
@ -155,6 +156,7 @@
<a href="html/libvirt-virterror.html#VIR_ERR_POST_FAILED">VIR_ERR_POST_FAILED</a><br /> <a href="html/libvirt-virterror.html#VIR_ERR_POST_FAILED">VIR_ERR_POST_FAILED</a><br />
<a href="html/libvirt-virterror.html#VIR_ERR_READ_FAILED">VIR_ERR_READ_FAILED</a><br /> <a href="html/libvirt-virterror.html#VIR_ERR_READ_FAILED">VIR_ERR_READ_FAILED</a><br />
<a href="html/libvirt-virterror.html#VIR_ERR_SEXPR_SERIAL">VIR_ERR_SEXPR_SERIAL</a><br /> <a href="html/libvirt-virterror.html#VIR_ERR_SEXPR_SERIAL">VIR_ERR_SEXPR_SERIAL</a><br />
<a href="html/libvirt-virterror.html#VIR_ERR_SYSTEM_ERROR">VIR_ERR_SYSTEM_ERROR</a><br />
<a href="html/libvirt-virterror.html#VIR_ERR_UNKNOWN_HOST">VIR_ERR_UNKNOWN_HOST</a><br /> <a href="html/libvirt-virterror.html#VIR_ERR_UNKNOWN_HOST">VIR_ERR_UNKNOWN_HOST</a><br />
<a href="html/libvirt-virterror.html#VIR_ERR_WARNING">VIR_ERR_WARNING</a><br /> <a href="html/libvirt-virterror.html#VIR_ERR_WARNING">VIR_ERR_WARNING</a><br />
<a href="html/libvirt-virterror.html#VIR_ERR_WRITE_FAILED">VIR_ERR_WRITE_FAILED</a><br /> <a href="html/libvirt-virterror.html#VIR_ERR_WRITE_FAILED">VIR_ERR_WRITE_FAILED</a><br />

1
docs/APIfunctions.html
View File

@ -25,6 +25,7 @@
<a href="html/libvirt-virterror.html#virConnResetLastError">virConnResetLastError</a><br /> <a href="html/libvirt-virterror.html#virConnResetLastError">virConnResetLastError</a><br />
<a href="html/libvirt-virterror.html#virConnSetErrorFunc">virConnSetErrorFunc</a><br /> <a href="html/libvirt-virterror.html#virConnSetErrorFunc">virConnSetErrorFunc</a><br />
<a href="html/libvirt-libvirt.html#virConnectClose">virConnectClose</a><br /> <a href="html/libvirt-libvirt.html#virConnectClose">virConnectClose</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetCapabilities">virConnectGetCapabilities</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetMaxVcpus">virConnectGetMaxVcpus</a><br /> <a href="html/libvirt-libvirt.html#virConnectGetMaxVcpus">virConnectGetMaxVcpus</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetType">virConnectGetType</a><br /> <a href="html/libvirt-libvirt.html#virConnectGetType">virConnectGetType</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br /> <a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br />

2
docs/APIsymbols.html
View File

@ -55,6 +55,7 @@
<a href="html/libvirt-virterror.html#VIR_ERR_POST_FAILED">VIR_ERR_POST_FAILED</a><br /> <a href="html/libvirt-virterror.html#VIR_ERR_POST_FAILED">VIR_ERR_POST_FAILED</a><br />
<a href="html/libvirt-virterror.html#VIR_ERR_READ_FAILED">VIR_ERR_READ_FAILED</a><br /> <a href="html/libvirt-virterror.html#VIR_ERR_READ_FAILED">VIR_ERR_READ_FAILED</a><br />
<a href="html/libvirt-virterror.html#VIR_ERR_SEXPR_SERIAL">VIR_ERR_SEXPR_SERIAL</a><br /> <a href="html/libvirt-virterror.html#VIR_ERR_SEXPR_SERIAL">VIR_ERR_SEXPR_SERIAL</a><br />
<a href="html/libvirt-virterror.html#VIR_ERR_SYSTEM_ERROR">VIR_ERR_SYSTEM_ERROR</a><br />
<a href="html/libvirt-virterror.html#VIR_ERR_UNKNOWN_HOST">VIR_ERR_UNKNOWN_HOST</a><br /> <a href="html/libvirt-virterror.html#VIR_ERR_UNKNOWN_HOST">VIR_ERR_UNKNOWN_HOST</a><br />
<a href="html/libvirt-virterror.html#VIR_ERR_WARNING">VIR_ERR_WARNING</a><br /> <a href="html/libvirt-virterror.html#VIR_ERR_WARNING">VIR_ERR_WARNING</a><br />
<a href="html/libvirt-virterror.html#VIR_ERR_WRITE_FAILED">VIR_ERR_WRITE_FAILED</a><br /> <a href="html/libvirt-virterror.html#VIR_ERR_WRITE_FAILED">VIR_ERR_WRITE_FAILED</a><br />
@ -93,6 +94,7 @@
<a href="html/libvirt-virterror.html#virConnSetErrorFunc">virConnSetErrorFunc</a><br /> <a href="html/libvirt-virterror.html#virConnSetErrorFunc">virConnSetErrorFunc</a><br />
<a href="html/libvirt-libvirt.html#virConnect">virConnect</a><br /> <a href="html/libvirt-libvirt.html#virConnect">virConnect</a><br />
<a href="html/libvirt-libvirt.html#virConnectClose">virConnectClose</a><br /> <a href="html/libvirt-libvirt.html#virConnectClose">virConnectClose</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetCapabilities">virConnectGetCapabilities</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetMaxVcpus">virConnectGetMaxVcpus</a><br /> <a href="html/libvirt-libvirt.html#virConnectGetMaxVcpus">virConnectGetMaxVcpus</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetType">virConnectGetType</a><br /> <a href="html/libvirt-libvirt.html#virConnectGetType">virConnectGetType</a><br />
<a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br /> <a href="html/libvirt-libvirt.html#virConnectGetVersion">virConnectGetVersion</a><br />

80
docs/FAQ.html
View File

@ -5,48 +5,49 @@
<li><a href="FAQ.html#Compilatio">Compilation</a></li> <li><a href="FAQ.html#Compilatio">Compilation</a></li>
<li><a href="FAQ.html#Developer">Developer corner</a></li> <li><a href="FAQ.html#Developer">Developer corner</a></li>
</ul><h3><a name="License" id="License">License</a>(s)</h3><ol><li><em>Licensing Terms for libvirt</em> </ul><h3><a name="License" id="License">License</a>(s)</h3><ol><li><em>Licensing Terms for libvirt</em>
<p>libvirt is released under the <a href="http://www.opensource.org/licenses/lgpl-license.html">GNU Lesser <p>libvirt is released under the <a href="http://www.opensource.org/licenses/lgpl-license.html">GNU
General Public License</a>, see the file COPYING.LIB in the distribution LesserGeneral Public License</a>, see the file COPYING.LIB in the
for the precise wording. The only library that libvirt depends upon is distributionfor the precise wording. The only library that libvirt
the Xen store access library which is also licenced under the LGPL.</p> depends upon isthe Xen store access library which is also licenced under
the LGPL.</p>
</li> </li>
<li><em>Can I embed libvirt in a proprietary application ?</em> <li><em>Can I embed libvirt in a proprietary application ?</em>
<p>Yes. The LGPL allows you to embed libvirt into a proprietary <p>Yes. The LGPL allows you to embed libvirt into a
application. It would be graceful to send-back bug fixes and improvements proprietaryapplication. It would be graceful to send-back bug fixes and
as patches for possible incorporation in the main development tree. It improvementsas patches for possible incorporation in the main development
will decrease your maintainance costs anyway if you do so.</p> tree. Itwill decrease your maintainance costs anyway if you do so.</p>
</li> </li>
</ol><h3><a name="Installati" id="Installati">Installation</a></h3><ol><li><em>Where can I get libvirt</em> ? </ol><h3><a name="Installati" id="Installati">Installation</a></h3><ol><li><em>Where can I get libvirt</em>?
<p>The original distribution comes from <a href="ftp://libvirt.org/libvirt/">ftp://libvirt.org/libvirt/</a>.</p> <p>The original distribution comes from <a href="ftp://libvirt.org/libvirt/">ftp://libvirt.org/libvirt/</a>.</p>
</li> </li>
<li><em>I can't install the libvirt/libvirt-devel RPM packages due to <li><em>I can't install the libvirt/libvirt-devel RPM packages due tofailed
failed dependencies</em> dependencies</em>
<p>The most generic solution is to re-fetch the latest src.rpm , and <p>The most generic solution is to re-fetch the latest src.rpm ,
rebuild it locally with</p> andrebuild it locally with</p>
<p><code>rpm --rebuild libvirt-xxx.src.rpm</code>.</p> <p><code>rpm --rebuild libvirt-xxx.src.rpm</code>.</p>
<p>If everything goes well it will generate two binary rpm packages (one <p>If everything goes well it will generate two binary rpm packages
providing the shared libs and virsh, and the other one, the -devel (oneproviding the shared libs and virsh, and the other one, the
package, providing includes, static libraries and scripts needed to build -develpackage, providing includes, static libraries and scripts needed to
applications with libvirt that you can install locally.</p> buildapplications with libvirt that you can install locally.</p>
<p>One can also rebuild the RPMs from a tarball:</p> <p>One can also rebuild the RPMs from a tarball:</p>
<p><code>rpmbuild -ta libdir-xxx.tar.gz</code></p> <p><code>rpmbuild -ta libdir-xxx.tar.gz</code></p>
<p>Or from a configured tree with:</p> <p>Or from a configured tree with:</p>
<p><code>make rpm</code></p> <p><code>make rpm</code></p>
</li> </li>
<li><em>Failure to use the API for non-root users</em> <li><em>Failure to use the API for non-root users</em>
<p>Large parts of the API may only be accessible with root priviledges, <p>Large parts of the API may only be accessible with root
however the read only access to the xenstore data doesnot have to be priviledges,however the read only access to the xenstore data doesnot
forbidden to user, at least for monitoring purposes. If "virsh dominfo" have to beforbidden to user, at least for monitoring purposes. If "virsh
fails to run as an user, change the mode of the xenstore read-only socket dominfo"fails to run as an user, change the mode of the xenstore
with:</p> read-only socketwith:</p>
<p><code>chmod 666 /var/run/xenstored/socket_ro</code></p> <p><code>chmod 666 /var/run/xenstored/socket_ro</code></p>
<p>and also make sure that the Xen Daemon is running correctly with local <p>and also make sure that the Xen Daemon is running correctly with
HTTP server enabled, this is defined in localHTTP server enabled, this is defined
<code>/etc/xen/xend-config.sxp</code> which need the following line to be in<code>/etc/xen/xend-config.sxp</code>which need the following line to
enabled:</p> beenabled:</p>
<p><code>(xend-http-server yes)</code></p> <p><code>(xend-http-server yes)</code></p>
<p>If needed restart the xend daemon after making the change with the <p>If needed restart the xend daemon after making the change with
following command run as root:</p> thefollowing command run as root:</p>
<p><code>service xend restart</code></p> <p><code>service xend restart</code></p>
</li> </li>
</ol><h3><a name="Compilatio" id="Compilatio">Compilation</a></h3><ol><li><em>What is the process to compile libvirt ?</em> </ol><h3><a name="Compilatio" id="Compilatio">Compilation</a></h3><ol><li><em>What is the process to compile libvirt ?</em>
@ -58,23 +59,24 @@
<p><code>./configure [possible options]</code></p> <p><code>./configure [possible options]</code></p>
<p><code>make</code></p> <p><code>make</code></p>
<p><code>make install</code></p> <p><code>make install</code></p>
<p>At that point you may have to rerun ldconfig or a similar utility to <p>At that point you may have to rerun ldconfig or a similar utility
update your list of installed shared libs.</p> toupdate your list of installed shared libs.</p>
</li> </li>
<li><em>What other libraries are needed to compile/install libvirt ?</em> <li><em>What other libraries are needed to compile/install libvirt ?</em>
<p>Libvirt requires libxenstore, which is usually provided by the xen <p>Libvirt requires libxenstore, which is usually provided by the
packages as well as the public headers to compile against libxenstore.</p> xenpackages as well as the public headers to compile against
libxenstore.</p>
</li> </li>
<li><em>I use the CVS version and there is no configure script</em> <li><em>I use the CVS version and there is no configure script</em>
<p>The configure script (and other Makefiles) are generated. Use the <p>The configure script (and other Makefiles) are generated. Use
autogen.sh script to regenerate the configure script and Makefiles, theautogen.sh script to regenerate the configure script and
like:</p> Makefiles,like:</p>
<p><code>./autogen.sh --prefix=/usr --disable-shared</code></p> <p><code>./autogen.sh --prefix=/usr --disable-shared</code></p>
</li> </li>
</ol><h3><a name="Developer" id="Developer">Developer</a> corner</h3><ol><li><em>Troubles compiling or linking programs using libvirt</em> </ol><h3><a name="Developer" id="Developer">Developer</a>corner</h3><ol><li><em>Troubles compiling or linking programs using libvirt</em>
<p>To simplify the process of reusing the library, libvirt comes with <p>To simplify the process of reusing the library, libvirt comes
pkgconfig support, which can be used directly from autoconf support or withpkgconfig support, which can be used directly from autoconf support
via the pkg-config command line tool, like:</p> orvia the pkg-config command line tool, like:</p>
<p><code>pkg-config libvirt --libs</code></p> <p><code>pkg-config libvirt --libs</code></p>
</li> </li>
</ol></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">Binding for Python</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="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://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> </ol></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">Binding for Python</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="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://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>

2
docs/apibuild.py
View File

@ -33,6 +33,8 @@ ignored_files = {
"xs_internal.c": "internal code", "xs_internal.c": "internal code",
"xm_internal.h": "internal code", "xm_internal.h": "internal code",
"xm_internal.c": "internal code", "xm_internal.c": "internal code",
"qemu_internal.h": "internal code",
"qemu_internal.c": "internal code",
"sexpr.h": "internal includes and defines", "sexpr.h": "internal includes and defines",
"sexpr.c": "internal code", "sexpr.c": "internal code",
"xml.h": "internal includes and defines", "xml.h": "internal includes and defines",

127
docs/architecture.html
View File

@ -1,67 +1,68 @@
<?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 architecture</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">libvirt architecture</h1><p> Currently libvirt supports 2 kind of virtualization, and its internal <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 architecture</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">libvirt architecture</h1><p>Currently libvirt supports 2 kind of virtualization, and its
structure is based on a driver model which simplifies adding new engines:</p><ul><li><a href="#Xen">Xen hypervisor</a></li> internalstructure is based on a driver model which simplifies adding new
<li><a href="#QEmu">QEmu and KVM based virtualization</a></li> engines:</p><ul><li><a href="#Xen">Xen hypervisor</a></li>
<li><a href="#drivers">the driver architecture</a></li> <li><a href="#QEmu">QEmu and KVM based virtualization</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 <li><a href="#drivers">the driver architecture</a></li>
in "Domain 0", which is the primary Linux OS loaded on the machine. That OS </ul><h3><a name="Xen" id="Xen">Libvirt Xen support</a></h3><p>When running in a Xen environment, programs using libvirt have to
kernel provides most if not all of the actual drivers used by the set of executein "Domain 0", which is the primary Linux OS loaded on the machine.
domains. It also runs the Xen Store, a database of informations shared by the That OSkernel provides most if not all of the actual drivers used by the set
hypervisor, the kernels, the drivers and the xen daemon. Xend. The xen daemon ofdomains. It also runs the Xen Store, a database of informations shared by
supervise the control and execution of the sets of domains. The hypervisor, thehypervisor, the kernels, the drivers and the xen daemon. Xend. The xen
drivers, kernels and daemons communicate though a shared system bus daemonsupervise the control and execution of the sets of domains. The
implemented in the hypervisor. The figure below tries to provide a view of hypervisor,drivers, kernels and daemons communicate though a shared system
this environment:</p><img src="architecture.gif" alt="The Xen architecture" /><p>The library can be initialized in 2 ways depending on the level of busimplemented in the hypervisor. The figure below tries to provide a view
priviledge of the embedding program. If it runs with root access, ofthis environment:</p><img src="architecture.gif" alt="The Xen architecture" /><p>The library can be initialized in 2 ways depending on the level
virConnectOpen() can be used, it will use different ways to connect to ofpriviledge of the embedding program. If it runs with root
the Xen infrastructure:</p><ul><li>a connection to the Xen Daemon though an HTTP RPC layer</li> access,virConnectOpen() can be used, it will use different ways to connect
tothe Xen infrastructure:</p><ul><li>a connection to the Xen Daemon though an HTTP RPC layer</li>
<li>a read/write connection to the Xen Store</li> <li>a read/write connection to the Xen Store</li>
<li>use Xen Hypervisor calls</li> <li>use Xen Hypervisor calls</li>
<li>when used as non-root libvirt connect to a proxy daemon running <li>when used as non-root libvirt connect to a proxy daemon runningas root
as root and providing read-only support</li> 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
changing the state of the system, but for performance and accuracy reasons operationchanging the state of the system, but for performance and accuracy
may talk directly to the hypervisor when gathering state informations at reasonsmay talk directly to the hypervisor when gathering state informations
least when possible (i.e. when the running program using libvirt has root atleast when possible (i.e. when the running program using libvirt has
priviledge access).</p><p>If it runs without root access virConnectOpenReadOnly() should be used to rootpriviledge access).</p><p>If it runs without root access virConnectOpenReadOnly() should be used
connect to initialize the library. It will then fork a libvirt_proxy program toconnect to initialize the library. It will then fork a libvirt_proxy
running as root and providing read_only access to the API, this is then programrunning as root and providing read_only access to the API, this is
only useful for reporting and monitoring.</p><h3><a name="QEmu" id="QEmu">Libvirt QEmu and KVM support</a></h3><p>The model for QEmu and KVM is completely similar, basically KVM is thenonly useful for reporting and monitoring.</p><h3><a name="QEmu" id="QEmu">Libvirt QEmu and KVM support</a></h3><p>The model for QEmu and KVM is completely similar, basically KVM isbased on
based on QEmu for the process controlling a new domain, only small details QEmu for the process controlling a new domain, only small detailsdiffers
differs between the two. In both case the libvirt API is provided between the two. In both case the libvirt API is providedby a controlling
by a controlling process forked by libvirt in the background and process forked by libvirt in the background andwhich launch and control the
which launch and control the QEmu or KVM process. That program called QEmu or KVM process. That program calledlibvirt_qemud talks though a specific
libvirt_qemud talks though a specific protocol to the library, and protocol to the library, andconnects to the console of the QEmu process in
connects to the console of the QEmu process in order to control and order to control andreport on its status. Libvirt tries to expose all the
report on its status. Libvirt tries to expose all the emulations emulationsmodels of QEmu, the selection is done when creating the new
models of QEmu, the selection is done when creating the new domain, domain,by specifying the architecture and machine type targetted.</p><p>The code controlling the QEmu process is available in
by specifying the architecture and machine type targetted.</p><p>The code controlling the QEmu process is available in the the<code>qemud/</code>subdirectory.</p><h3><a name="drivers" id="drivers">the driver based architecture</a></h3><p>As the previous section explains, libvirt can communicate using
<code>qemud/</code> subdirectory.</p><h3><a name="drivers" id="drivers">the driver based architecture</a></h3><p>As the previous section explains, libvirt can communicate using different differentchannels with the Xen hypervisor, and is also able to use different
channels with the Xen hypervisor, and is also able to use different kind kindof hypervisor. To simplify the internal design, code, easemaintainance
of hypervisor. To simplify the internal design, code, ease and simplify the support of other virtualization engine theinternals have
maintainance and simplify the support of other virtualization engine the been structured as one core component, the libvirt.c moduleacting as a
internals have been structured as one core component, the libvirt.c module front-end for the library API and a set of hypvisor driversdefining a common
acting as a front-end for the library API and a set of hypvisor drivers set of routines. That way the Xen Daemon accces, the XenStore one, the
defining a common set of routines. That way the Xen Daemon accces, the Xen Hypervisor hypercall are all isolated in separate C modulesimplementing at
Store one, the Hypervisor hypercall are all isolated in separate C modules least a subset of the common operations defined by thedrivers present in
implementing at least a subset of the common operations defined by the driver.h. The driver architecture is used to add supportfor other
drivers present in driver.h. The driver architecture is used to add support virtualization engines and</p><ul><li>xend_internal: implements the driver functions though the
for other virtualization engines and </p><ul><li>xend_internal: implements the driver functions though the Xen XenDaemon.</li>
Daemon.</li> <li>xs_internal: implements the subset of the driver availble though theXen
<li>xs_internal: implements the subset of the driver availble though the Store.</li>
Xen Store.</li> <li>xen_internal: provide the implementation of the functions possible
<li>xen_internal: provide the implementation of the functions possible via viadirect Xen hypervisor access.</li>
direct Xen hypervisor access.</li> <li>proxy_internal: provide read-only Xen access via a proxy, the proxycode
<li>proxy_internal: provide read-only Xen access via a proxy, the proxy is in the <code>proxy/</code>sub directory.</li>
code is in the <code>proxy/</code> sub directory.</li> <li>xm_internal: provide support for Xen defined but not running
<li>xm_internal: provide support for Xen defined but not running domains.</li> domains.</li>
<li>qemu_internal: implement the driver functions for QEmu and KVM <li>qemu_internal: implement the driver functions for QEmu and
virtualization engines. It also uses a qemud/ specific daemon which KVMvirtualization engines. It also uses a qemud/ specific daemon
interracts with the QEmu process to implement libvirt API.</li> whichinterracts with the QEmu process to implement libvirt API.</li>
<li>test: this is a test driver useful for regression tests of the <li>test: this is a test driver useful for regression tests of thefront-end
front-end part of libvirt.</li> part of libvirt.</li>
</ul><p>Note that a given driver may only implement a subset of those functions, </ul><p>Note that a given driver may only implement a subset of those
for example saving a Xen domain state to disk and restoring it is only possible functions,for example saving a Xen domain state to disk and restoring it is
though the Xen Daemon, in that case the driver entry points are initialized to only possiblethough the Xen Daemon, in that case the driver entry points are
NULL.</p><p></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">Binding for Python</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="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://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> initialized toNULL.</p><p></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">Binding for Python</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="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://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>

21
docs/bugs.html
View File

@ -1,12 +1,13 @@
<?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>Reporting bugs and getting help</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">Reporting bugs and getting help</h1><p>There is a mailing-list <a href="mailto:libvir-list@redhat.com">libvir-list@redhat.com</a> for libvirt, <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>Reporting bugs and getting help</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">Reporting bugs and getting help</h1><p>There is a mailing-list <a href="mailto:libvir-list@redhat.com">libvir-list@redhat.com</a>for
with an <a href="https://www.redhat.com/archives/libvir-list/">on-line libvirt,with an <a href="https://www.redhat.com/archives/libvir-list/">on-linearchive</a>.
archive</a>. Please subscribe to this list before posting by visiting the <a href="https://www.redhat.com/mailman/listinfo/libvir-list">associated Web</a> Please subscribe to this list before posting by visiting the <a href="https://www.redhat.com/mailman/listinfo/libvir-list">associated
page and follow the instructions. Patches with explanations and provided as Web</a>page and follow the instructions. Patches with explanations and
attachments are really appreciated and will be discussed on the mailing list. provided asattachments are really appreciated and will be discussed on the
If possible generate the patches by using cvs diff -u in a CVS checkout.</p><p>We use Red Hat Bugzilla to track bugs to libvirt. If you want to report a mailing list.If possible generate the patches by using cvs diff -u in a CVS
bug, please check <a href="http://bugzilla.redhat.com/bugzilla/buglist.cgi?component=libvirt&amp;component=libvirt-devel&amp;component=libvirt-python&amp;bug_status=ASSIGNED&amp;bug_status=INVESTIGATE&amp;bug_status=NEW&amp;bug_status=REOPENED&amp;bug_status=VERIFIED&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;long_desc_type=allwordssubstr&amp;long_desc=&amp;Search=Search">the existing open bugs</a>, then if yours isn't a duplicate of checkout.</p><p>We use Red Hat Bugzilla to track bugs to libvirt. If you want to report
an existing bug, <a href="http://bugzilla.redhat.com/bugzilla/enter_bug.cgi?product=Fedora%20Core&amp;component=libvirt">log a new bug</a>. It may be good abug, please check <a href="http://bugzilla.redhat.com/bugzilla/buglist.cgi?component=libvirt&amp;component=libvirt-devel&amp;component=libvirt-python&amp;bug_status=ASSIGNED&amp;bug_status=INVESTIGATE&amp;bug_status=NEW&amp;bug_status=REOPENED&amp;bug_status=VERIFIED&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;long_desc_type=allwordssubstr&amp;long_desc=&amp;Search=Search">the
to post to the <a href="mailto:libvir-list@redhat.com">mailing-list</a> existing open bugs</a>, then if yours isn't a duplicate ofan existing bug, <a href="http://bugzilla.redhat.com/bugzilla/enter_bug.cgi?product=Fedora%20Core&amp;component=libvirt">log
too if the issue looks serious, thanks !</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">Binding for Python</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="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://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> a new bug</a>. It may be goodto post to the <a href="mailto:libvir-list@redhat.com">mailing-list</a>too if the issue looks
serious, thanks !</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">Binding for Python</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="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://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>

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

@ -77,7 +77,7 @@ int <a href="#virDomainShutdown">virDomainShutdown</a> (<a href="libvirt-libvir
int <a href="#virNetworkUndefine">virNetworkUndefine</a> (<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network); int <a href="#virNetworkUndefine">virNetworkUndefine</a> (<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network);
int <a href="#virGetVersion">virGetVersion</a> (unsigned long * libVer, <br/> const char * type, <br/> unsigned long * typeVer); int <a href="#virGetVersion">virGetVersion</a> (unsigned long * libVer, <br/> const char * type, <br/> unsigned long * typeVer);
int <a href="#virConnectListDefinedDomains">virConnectListDefinedDomains</a> (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/> char ** const names, <br/> int maxnames); int <a href="#virConnectListDefinedDomains">virConnectListDefinedDomains</a> (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/> char ** const names, <br/> int maxnames);
int <a href="#virDomainSetMaxMemory">virDomainSetMaxMemory</a> (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/> unsigned long memory); char * <a href="#virConnectGetCapabilities">virConnectGetCapabilities</a> (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn);
int <a href="#virNetworkGetUUID">virNetworkGetUUID</a> (<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network, <br/> unsigned char * uuid); int <a href="#virNetworkGetUUID">virNetworkGetUUID</a> (<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network, <br/> unsigned char * uuid);
<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> <a href="#virDomainLookupByName">virDomainLookupByName</a> (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/> const char * name); <a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> <a href="#virDomainLookupByName">virDomainLookupByName</a> (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/> const char * name);
<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> <a href="#virNetworkLookupByUUID">virNetworkLookupByUUID</a> (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/> const unsigned char * uuid); <a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> <a href="#virNetworkLookupByUUID">virNetworkLookupByUUID</a> (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/> const unsigned char * uuid);
@ -131,6 +131,7 @@ int <a href="#virDomainDetachDevice">virDomainDetachDevice</a> (<a href="libvir
int <a href="#virDomainGetAutostart">virDomainGetAutostart</a> (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/> int * autostart); int <a href="#virDomainGetAutostart">virDomainGetAutostart</a> (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/> int * autostart);
int <a href="#virDomainGetVcpus">virDomainGetVcpus</a> (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/> <a href="libvirt-libvirt.html#virVcpuInfoPtr">virVcpuInfoPtr</a> info, <br/> int maxinfo, <br/> unsigned char * cpumaps, <br/> int maplen); int <a href="#virDomainGetVcpus">virDomainGetVcpus</a> (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/> <a href="libvirt-libvirt.html#virVcpuInfoPtr">virVcpuInfoPtr</a> info, <br/> int maxinfo, <br/> unsigned char * cpumaps, <br/> int maplen);
char * <a href="#virDomainGetXMLDesc">virDomainGetXMLDesc</a> (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/> int flags); char * <a href="#virDomainGetXMLDesc">virDomainGetXMLDesc</a> (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/> int flags);
int <a href="#virDomainSetMaxMemory">virDomainSetMaxMemory</a> (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/> unsigned long memory);
int <a href="#virConnectGetVersion">virConnectGetVersion</a> (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/> unsigned long * hvVer); int <a href="#virConnectGetVersion">virConnectGetVersion</a> (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/> unsigned long * hvVer);
int <a href="#virConnectListNetworks">virConnectListNetworks</a> (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/> char ** const names, <br/> int maxnames); int <a href="#virConnectListNetworks">virConnectListNetworks</a> (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/> char ** const names, <br/> int maxnames);
<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> <a href="#virDomainLookupByID">virDomainLookupByID</a> (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/> int id); <a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> <a href="#virDomainLookupByID">virDomainLookupByID</a> (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/> int id);
@ -176,7 +177,7 @@ int <a href="#virConnectListNetworks">virConnectListNetworks</a> (<a href="libv
</div> </div>
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="VIR_UUID_BUFLEN">Macro </a>VIR_UUID_BUFLEN</h3><pre class="programlisting">#define <a href="#VIR_UUID_BUFLEN">VIR_UUID_BUFLEN</a>; <div class="refsect2" lang="en"><h3><a name="VIR_UUID_BUFLEN">Macro </a>VIR_UUID_BUFLEN</h3><pre class="programlisting">#define <a href="#VIR_UUID_BUFLEN">VIR_UUID_BUFLEN</a>;
</pre><p/> </pre><p>This macro provides the length of the buffer required for virDomainGetUUID()</p>
</div> </div>
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="VIR_UUID_STRING_BUFLEN">Macro </a>VIR_UUID_STRING_BUFLEN</h3><pre class="programlisting">#define <a href="#VIR_UUID_STRING_BUFLEN">VIR_UUID_STRING_BUFLEN</a>; <div class="refsect2" lang="en"><h3><a name="VIR_UUID_STRING_BUFLEN">Macro </a>VIR_UUID_STRING_BUFLEN</h3><pre class="programlisting">#define <a href="#VIR_UUID_STRING_BUFLEN">VIR_UUID_STRING_BUFLEN</a>;
@ -317,10 +318,14 @@ The content of this structure is not made public by the API.
<div class="refsect2" lang="en"><h3><a name="virConnectClose"/>virConnectClose ()</h3><pre class="programlisting">int virConnectClose (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn)<br/> <div class="refsect2" lang="en"><h3><a name="virConnectClose"/>virConnectClose ()</h3><pre class="programlisting">int virConnectClose (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn)<br/>
</pre><p>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.</p> </pre><p>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.</p>
<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success or -1 in case of error.</td></tr></tbody></table></div></div> <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success or -1 in case of error.</td></tr></tbody></table></div></div>
<hr/>
<div class="refsect2" lang="en"><h3><a name="virConnectGetCapabilities"/>virConnectGetCapabilities ()</h3><pre class="programlisting">char * virConnectGetCapabilities (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn)<br/>
</pre><p>Provides capabilities of the hypervisor / driver.</p>
<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>NULL in case of error, or a pointer to an opaque virCapabilities structure (virCapabilitiesPtr). The client must free the returned string after use.</td></tr></tbody></table></div></div>
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="virConnectGetMaxVcpus"/>virConnectGetMaxVcpus ()</h3><pre class="programlisting">int virConnectGetMaxVcpus (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/> const char * type)<br/> <div class="refsect2" lang="en"><h3><a name="virConnectGetMaxVcpus"/>virConnectGetMaxVcpus ()</h3><pre class="programlisting">int virConnectGetMaxVcpus (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn, <br/> const char * type)<br/>
</pre><p/> </pre><p>Provides the maximum number of virtual CPUs supported for a guest VM of a specific type. The 'type' parameter here corresponds to the 'type' attribute in the &lt;domain&gt; element of the XML.</p>
<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td>value of the 'type' attribute in the &lt;domain&gt; element</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the maximum number of virtual CPUs supported for a guest VM of a specific type. The 'type' parameter here corresponds to the 'type' attribute in the &lt;domain&gt; element of the XML. Returns the maximum of virtual CPU or -1 in case of error.</td></tr></tbody></table></div></div> <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>conn</tt></i>:</span></td><td>pointer to the hypervisor connection</td></tr><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td>value of the 'type' attribute in the &lt;domain&gt; element</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the maximum of virtual CPU or -1 in case of error.</td></tr></tbody></table></div></div>
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="virConnectGetType"/>virConnectGetType ()</h3><pre class="programlisting">const char * virConnectGetType (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn)<br/> <div class="refsect2" lang="en"><h3><a name="virConnectGetType"/>virConnectGetType ()</h3><pre class="programlisting">const char * virConnectGetType (<a href="libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> conn)<br/>
</pre><p>Get the name of the Hypervisor software used.</p> </pre><p>Get the name of the Hypervisor software used.</p>
@ -403,8 +408,8 @@ The content of this structure is not made public by the API.
<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>a domain object</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of failure.</td></tr></tbody></table></div></div> <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>a domain object</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of failure.</td></tr></tbody></table></div></div>
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="virDomainGetAutostart"/>virDomainGetAutostart ()</h3><pre class="programlisting">int virDomainGetAutostart (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/> int * autostart)<br/> <div class="refsect2" lang="en"><h3><a name="virDomainGetAutostart"/>virDomainGetAutostart ()</h3><pre class="programlisting">int virDomainGetAutostart (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/> int * autostart)<br/>
</pre><p/> </pre><p>Provides a boolean value indicating whether the domain configured to be automatically started when the host machine boots.</p>
<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>a domain object</td></tr><tr><td><span class="term"><i><tt>autostart</tt></i>:</span></td><td/></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a boolean value indicating whether the domain configured to be automatically started when the host machine boots. Returns -1 in case of error, 0 in case of success</td></tr></tbody></table></div></div> <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>a domain object</td></tr><tr><td><span class="term"><i><tt>autostart</tt></i>:</span></td><td>the value returned</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>-1 in case of error, 0 in case of success</td></tr></tbody></table></div></div>
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="virDomainGetID"/>virDomainGetID ()</h3><pre class="programlisting">unsigned int virDomainGetID (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain)<br/> <div class="refsect2" lang="en"><h3><a name="virDomainGetID"/>virDomainGetID ()</h3><pre class="programlisting">unsigned int virDomainGetID (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain)<br/>
</pre><p>Get the hypervisor ID number for the domain</p> </pre><p>Get the hypervisor ID number for the domain</p>
@ -419,8 +424,8 @@ The content of this structure is not made public by the API.
<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>a domain object or NULL</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the memory size in kilobytes or 0 in case of error.</td></tr></tbody></table></div></div> <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>a domain object or NULL</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the memory size in kilobytes or 0 in case of error.</td></tr></tbody></table></div></div>
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="virDomainGetMaxVcpus"/>virDomainGetMaxVcpus ()</h3><pre class="programlisting">int virDomainGetMaxVcpus (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain)<br/> <div class="refsect2" lang="en"><h3><a name="virDomainGetMaxVcpus"/>virDomainGetMaxVcpus ()</h3><pre class="programlisting">int virDomainGetMaxVcpus (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain)<br/>
</pre><p/> </pre><p>Provides the maximum number of virtual CPUs supported for the guest VM. If the guest is inactive, this is basically the same as virConnectGetMaxVcpus. If the guest is running this will reflect the maximum number of virtual CPUs the guest was booted with.</p>
<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>pointer to domain object</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the maximum number of virtual CPUs supported for the guest VM. If the guest is inactive, this is basically the same as virConnectGetMaxVcpus. If the guest is running this will reflect the maximum number of virtual CPUs the guest was booted with. Returns the maximum of virtual CPU or -1 in case of error.</td></tr></tbody></table></div></div> <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>pointer to domain object</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the maximum of virtual CPU or -1 in case of error.</td></tr></tbody></table></div></div>
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="virDomainGetName"/>virDomainGetName ()</h3><pre class="programlisting">const char * virDomainGetName (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain)<br/> <div class="refsect2" lang="en"><h3><a name="virDomainGetName"/>virDomainGetName ()</h3><pre class="programlisting">const char * virDomainGetName (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain)<br/>
</pre><p>Get the public name for that domain</p> </pre><p>Get the public name for that domain</p>
@ -484,7 +489,7 @@ The content of this structure is not made public by the API.
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="virDomainSetAutostart"/>virDomainSetAutostart ()</h3><pre class="programlisting">int virDomainSetAutostart (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/> int autostart)<br/> <div class="refsect2" lang="en"><h3><a name="virDomainSetAutostart"/>virDomainSetAutostart ()</h3><pre class="programlisting">int virDomainSetAutostart (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/> int autostart)<br/>
</pre><p>Configure the domain to be automatically started when the host machine boots.</p> </pre><p>Configure the domain to be automatically started when the host machine boots.</p>
<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>a domain object</td></tr><tr><td><span class="term"><i><tt>autostart</tt></i>:</span></td><td/></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>-1 in case of error, 0 in case of success</td></tr></tbody></table></div></div> <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>domain</tt></i>:</span></td><td>a domain object</td></tr><tr><td><span class="term"><i><tt>autostart</tt></i>:</span></td><td>whether the domain should be automatically started 0 or 1</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>-1 in case of error, 0 in case of success</td></tr></tbody></table></div></div>
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="virDomainSetMaxMemory"/>virDomainSetMaxMemory ()</h3><pre class="programlisting">int virDomainSetMaxMemory (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/> unsigned long memory)<br/> <div class="refsect2" lang="en"><h3><a name="virDomainSetMaxMemory"/>virDomainSetMaxMemory ()</h3><pre class="programlisting">int virDomainSetMaxMemory (<a href="libvirt-libvirt.html#virDomainPtr">virDomainPtr</a> domain, <br/> unsigned long memory)<br/>
</pre><p>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. This function requires priviledged access to the hypervisor.</p> </pre><p>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. This function requires priviledged access to the hypervisor.</p>
@ -539,12 +544,12 @@ The content of this structure is not made public by the API.
<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td>a network object</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of failure.</td></tr></tbody></table></div></div> <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td>a network object</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of failure.</td></tr></tbody></table></div></div>
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="virNetworkGetAutostart"/>virNetworkGetAutostart ()</h3><pre class="programlisting">int virNetworkGetAutostart (<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network, <br/> int * autostart)<br/> <div class="refsect2" lang="en"><h3><a name="virNetworkGetAutostart"/>virNetworkGetAutostart ()</h3><pre class="programlisting">int virNetworkGetAutostart (<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network, <br/> int * autostart)<br/>
</pre><p/> </pre><p>Provides a boolean value indicating whether the network configured to be automatically started when the host machine boots.</p>
<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td>a network object</td></tr><tr><td><span class="term"><i><tt>autostart</tt></i>:</span></td><td/></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a boolean value indicating whether the network configured to be automatically started when the host machine boots. Returns -1 in case of error, 0 in case of success</td></tr></tbody></table></div></div> <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td>a network object</td></tr><tr><td><span class="term"><i><tt>autostart</tt></i>:</span></td><td>the value returned</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>-1 in case of error, 0 in case of success</td></tr></tbody></table></div></div>
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="virNetworkGetBridgeName"/>virNetworkGetBridgeName ()</h3><pre class="programlisting">char * virNetworkGetBridgeName (<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network)<br/> <div class="refsect2" lang="en"><h3><a name="virNetworkGetBridgeName"/>virNetworkGetBridgeName ()</h3><pre class="programlisting">char * virNetworkGetBridgeName (<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network)<br/>
</pre><p/> </pre><p>Provides a bridge interface name to which a domain may connect a network interface in order to join the network.</p>
<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td>a network object</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a bridge interface name to which a domain may connect a network interface in order to join the network. Returns a 0 terminated interface name, or NULL in case of error. the caller must free() the returned value.</td></tr></tbody></table></div></div> <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td>a network object</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a 0 terminated interface name, or NULL in case of error. the caller must free() the returned value.</td></tr></tbody></table></div></div>
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="virNetworkGetName"/>virNetworkGetName ()</h3><pre class="programlisting">const char * virNetworkGetName (<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network)<br/> <div class="refsect2" lang="en"><h3><a name="virNetworkGetName"/>virNetworkGetName ()</h3><pre class="programlisting">const char * virNetworkGetName (<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network)<br/>
</pre><p>Get the public name for that network</p> </pre><p>Get the public name for that network</p>
@ -576,7 +581,7 @@ The content of this structure is not made public by the API.
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="virNetworkSetAutostart"/>virNetworkSetAutostart ()</h3><pre class="programlisting">int virNetworkSetAutostart (<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network, <br/> int autostart)<br/> <div class="refsect2" lang="en"><h3><a name="virNetworkSetAutostart"/>virNetworkSetAutostart ()</h3><pre class="programlisting">int virNetworkSetAutostart (<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network, <br/> int autostart)<br/>
</pre><p>Configure the network to be automatically started when the host machine boots.</p> </pre><p>Configure the network to be automatically started when the host machine boots.</p>
<div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td>a network object</td></tr><tr><td><span class="term"><i><tt>autostart</tt></i>:</span></td><td/></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>-1 in case of error, 0 in case of success</td></tr></tbody></table></div></div> <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>network</tt></i>:</span></td><td>a network object</td></tr><tr><td><span class="term"><i><tt>autostart</tt></i>:</span></td><td>whether the network should be automatically started 0 or 1</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>-1 in case of error, 0 in case of success</td></tr></tbody></table></div></div>
<hr/> <hr/>
<div class="refsect2" lang="en"><h3><a name="virNetworkUndefine"/>virNetworkUndefine ()</h3><pre class="programlisting">int virNetworkUndefine (<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network)<br/> <div class="refsect2" lang="en"><h3><a name="virNetworkUndefine"/>virNetworkUndefine ()</h3><pre class="programlisting">int virNetworkUndefine (<a href="libvirt-libvirt.html#virNetworkPtr">virNetworkPtr</a> network)<br/>
</pre><p>Undefine a network but does not stop it if it is running</p> </pre><p>Undefine a network but does not stop it if it is running</p>

3
docs/devhelp/libvirt-virterror.html
View File

@ -142,7 +142,8 @@ void <a href="#virConnResetLastError">virConnResetLastError</a> (<a href="libvi
<a name="VIR_ERR_WRITE_FAILED">VIR_ERR_WRITE_FAILED</a> = 34 /* failed to write a conf file */ <a name="VIR_ERR_WRITE_FAILED">VIR_ERR_WRITE_FAILED</a> = 34 /* failed to write a conf file */
<a name="VIR_ERR_XML_DETAIL">VIR_ERR_XML_DETAIL</a> = 35 /* detail of an XML error */ <a name="VIR_ERR_XML_DETAIL">VIR_ERR_XML_DETAIL</a> = 35 /* detail of an XML error */
<a name="VIR_ERR_INVALID_NETWORK">VIR_ERR_INVALID_NETWORK</a> = 36 /* invalid network object */ <a name="VIR_ERR_INVALID_NETWORK">VIR_ERR_INVALID_NETWORK</a> = 36 /* invalid network object */
<a name="VIR_ERR_NETWORK_EXIST">VIR_ERR_NETWORK_EXIST</a> = 37 /* the network already exist */ <a name="VIR_ERR_NETWORK_EXIST">VIR_ERR_NETWORK_EXIST</a> = 37 /* the network already exist */
<a name="VIR_ERR_SYSTEM_ERROR">VIR_ERR_SYSTEM_ERROR</a> = 38 /* general system call failure */
}; };
</pre><p/> </pre><p/>
</div> </div>

16
docs/downloads.html
View File

@ -1,10 +1,10 @@
<?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>Downloads</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">Downloads</h1><p>The latest versions of libvirt can be found on the <a href="ftp://libvirt.org/libvirt/">libvirt.org</a> server ( <a href="http://libvirt.org/sources/">HTTP</a>, <a href="ftp://libvirt.org/libvirt/">FTP</a>). You will find there the released <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>Downloads</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">Downloads</h1><p>The latest versions of libvirt can be found on the <a href="ftp://libvirt.org/libvirt/">libvirt.org</a>server ( <a href="http://libvirt.org/sources/">HTTP</a>, <a href="ftp://libvirt.org/libvirt/">FTP</a>). You will find there the
versions as well as <a href="http://libvirt.org/sources/libvirt-cvs-snapshot.tar.gz">snapshot releasedversions as well as <a href="http://libvirt.org/sources/libvirt-cvs-snapshot.tar.gz">snapshottarballs</a>updated
tarballs</a> updated from CVS head every hour</p><p>Anonymous <a href="http://ximbiot.com/cvs/cvshome/docs/">CVS</a> is also from CVS head every hour</p><p>Anonymous <a href="http://ximbiot.com/cvs/cvshome/docs/">CVS</a>is
available, first register onto the server:</p><p><code>cvs -d :pserver:anoncvs@libvirt.org:2401/data/cvs login</code></p><p>it will request a password, enter <strong>anoncvs</strong>. Then you can alsoavailable, first register onto the server:</p><p><code>cvs -d :pserver:anoncvs@libvirt.org:2401/data/cvs login</code></p><p>it will request a password, enter <strong>anoncvs</strong>. Then you
checkout the development tree with:</p><p><code>cvs -d :pserver:anoncvs@libvirt.org:2401/data/cvs co cancheckout the development tree with:</p><p><code>cvs -d :pserver:anoncvs@libvirt.org:2401/data/cvs
libvirt</code></p><p>Use ./autogen.sh to configure the local checkout, then <code>make</code> colibvirt</code></p><p>Use ./autogen.sh to configure the local checkout, then
and <code>make install</code>, as usual. All normal cvs commands are now <code>make</code>and <code>make install</code>, as usual. All normal cvs
available except commiting to the base.</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">Binding for Python</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="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://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> commands are nowavailable except commiting to the base.</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">Binding for Python</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="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://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>

102
docs/errors.html
View File

@ -3,67 +3,65 @@
<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 informations 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
asynchronous error reporting. When an error happens in the library code the andasynchronous error reporting. When an error happens in the library code
error is logged, allowing to retrieve it later and if the user registered an theerror is logged, allowing to retrieve it later and if the user registered
error callback it will be called synchronously. Once the call to libvirt ends anerror callback it will be called synchronously. Once the call to libvirt
the error can be detected by the return value and the full information for endsthe error can be detected by the return value and the full information
the last logged error can be retrieved.</p><p>To avoid as much as prossible troubles with a global variable in a forthe last logged error can be retrieved.</p><p>To avoid as much as prossible troubles with a global variable in
multithreaded environment, libvirt will associate when possible the errors to amultithreaded environment, libvirt will associate when possible the errors
the current connection they are related to, that way the error is stored in a tothe current connection they are related to, that way the error is stored in
dynamic structure which can be made thread specific. Error callback can be adynamic structure which can be made thread specific. Error callback can
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 beset 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
to look up a domain failingto 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
call it with the error informations</li> it with the error informations</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
call it with the error information</li> 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>which
which is the default error function of the library issuing the error is the default error function of the library issuing the erroron
on stderr</li> stderr</li>
<li>save the error in the connection for later retrieval with <a href="html/libvirt-virterror.html#virConnGetLastError">virConnGetLastError</a></li> <li>save the error in the connection for later retrieval with <a href="html/libvirt-virterror.html#virConnGetLastError">virConnGetLastError</a></li>
</ol></li> </ol></li>
<li>otherwise like when failing to create an hypervisor connection: <li>otherwise like when failing to create an hypervisor connection:
<ol><li>if there is a global callback set with <a href="html/libvirt-virterror.html#virSetErrorFunc">virSetErrorFunc</a>, <ol><li>if there is a global callback set with <a href="html/libvirt-virterror.html#virSetErrorFunc">virSetErrorFunc</a>,call
call it with the error information</li> 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>which
which is the default error function of the library issuing the error is the default error function of the library issuing the erroron
on stderr</li> 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 informations are provided as a <a href="html/libvirt-virterror.html#virErrorPtr">virErrorPtr</a>pointer
read-only structure <a href="html/libvirt-virterror.html#virError">virError</a> containing the toread-only structure <a href="html/libvirt-virterror.html#virError">virError</a>containing
following fields:</p><ul><li>code: an error number from the <a href="html/libvirt-virterror.html#virErrorNumber">virErrorNumber</a> thefollowing fields:</p><ul><li>code: an error number from the <a href="html/libvirt-virterror.html#virErrorNumber">virErrorNumber</a>enum</li>
enum</li> <li>domain: an enum indicating which part of libvirt raised the error see<a href="html/libvirt-virterror.html#virErrorDomain">virErrorDomain</a></li>
<li>domain: an enum indicating which part of libvirt raised the error see <li>level: the error level, usually VIR_ERR_ERROR, though there is room
<a href="html/libvirt-virterror.html#virErrorDomain">virErrorDomain</a></li> forwarnings like VIR_ERR_WARNING</li>
<li>level: the error level, usually VIR_ERR_ERROR, though there is room for
warnings like VIR_ERR_WARNING</li>
<li>message: the full human-readable formatted string of the error</li> <li>message: the full human-readable formatted string of the error</li>
<li>conn: if available a pointer to the <a href="html/libvirt-libvirt.html#virConnectPtr">virConnectPtr</a> <li>conn: if available a pointer to the <a href="html/libvirt-libvirt.html#virConnectPtr">virConnectPtr</a>connection
connection to the hypervisor where this happened</li> 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>domaintargetted
targetted in the operation</li> in the operation</li>
</ul><p>and then extra raw informations about the error which may be initialized </ul><p>and then extra raw informations about the error which may be initializedto
to 0 or NULL if unused</p><ul><li>str1, str2, str3: string informations, usually str1 is the error 0 or NULL if unused</p><ul><li>str1, str2, str3: string informations, usually str1 is the errormessage
message format</li> format</li>
<li>int1, int2: integer informations</li> <li>int1, int2: integer informations</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
registering an handler with with <a href="html/libvirt-virterror.html#virSetErrorFunc">virSetErrorFunc</a> or ofregistering an handler with with <a href="html/libvirt-virterror.html#virSetErrorFunc">virSetErrorFunc</a>orwith
with <a href="html/libvirt-virterror.html#virConnSetErrorFunc">virConnSetErrorFunc</a>, <a href="html/libvirt-virterror.html#virConnSetErrorFunc">virConnSetErrorFunc</a>,chech
chech the value of the code value, take appropriate action, if needed let the value of the code value, take appropriate action, if needed letlibvirt
libvirt print the error on stderr by calling <a href="html/libvirt-virterror.html#virDefaultErrorFunc">virDefaultErrorFunc</a>. print the error on stderr by calling <a href="html/libvirt-virterror.html#virDefaultErrorFunc">virDefaultErrorFunc</a>.For
For asynchronous error handing, set such a function doing nothing to avoid asynchronous error handing, set such a function doing nothing to avoidthe
the error being reported on stderr, and call virConnGetLastError or error being reported on stderr, and call virConnGetLastError
virGetLastError when an API call returned an error value. It can be a good orvirGetLastError when an API call returned an error value. It can be a
idea to use <a href="html/libvirt-virterror.html#virResetLastError">virResetError</a> or <a href="html/libvirt-virterror.html#virConnResetLastError">virConnResetLastError</a> goodidea to use <a href="html/libvirt-virterror.html#virResetLastError">virResetError</a>or <a href="html/libvirt-virterror.html#virConnResetLastError">virConnResetLastError</a>once
once an error has been processed fully.</p><p>At the python level, there only a global reporting callback function at an error has been processed fully.</p><p>At the python level, there only a global reporting callback function
this point, see the error.py example about it:</p><pre>def handler(ctxt, err): atthis point, see the error.py example about it:</p><pre>def handler(ctxt, err):
global errno global errno
#print "handler(%s, %s)" % (ctxt, err) #print "handler(%s, %s)" % (ctxt, err)
errno = err errno = err
libvirt.registerErrorHandler(handler, 'context') </pre><p>the second argument to the registerErrorHandler function is passed as the libvirt.registerErrorHandler(handler, 'context') </pre><p>the second argument to the registerErrorHandler function is passed as
fist argument of the callback like in the C version. The error is a tuple thefist argument of the callback like in the C version. The error is a
containing the same field as a virError in C, but cast to Python.</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">Binding for Python</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="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://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> tuplecontaining the same field as a virError in C, but cast to Python.</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">Binding for Python</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="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://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>

232
docs/format.html
View File

@ -1,17 +1,18 @@
<?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>XML Format</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">XML Format</h1><p>This section describes the XML format used to represent domains, there are <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>XML Format</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">XML Format</h1><p>This section describes the XML format used to represent domains, there
variations on the format based on the kind of domains run and the options arevariations on the format based on the kind of domains run and the
used to launch them:</p><ul><li><a href="#Normal1">Normal paravirtualized Xen domains</a></li> optionsused to launch them:</p><ul><li><a href="#Normal1">Normal paravirtualized Xen domains</a></li>
<li><a href="#Fully1">Fully virtualized Xen domains</a></li> <li><a href="#Fully1">Fully virtualized Xen domains</a></li>
<li><a href="#KVM1">KVM domains</a></li> <li><a href="#KVM1">KVM domains</a></li>
<li><a href="#QEmu1">QEmu domains</a></li> <li><a href="#QEmu1">QEmu domains</a></li>
</ul><p>The formats try as much as possible to follow the same structure and reuse </ul><p>The formats try as much as possible to follow the same structure and
elements and attributes where it makes sense.</p><h3 id="Normal"><a name="Normal1" id="Normal1">Normal paravirtualized Xen reuseelements and attributes where it makes sense.</p><h3 id="Normal"><a name="Normal1" id="Normal1">Normal paravirtualized
domains</a>:</h3><p>The library use an XML format to describe domains, as input to <a href="html/libvirt-libvirt.html#virDomainCreateLinux">virDomainCreateLinux()</a> Xendomains</a>:</h3><p>The library use an XML format to describe domains, as input to <a href="html/libvirt-libvirt.html#virDomainCreateLinux">virDomainCreateLinux()</a>and
and as the output of <a href="html/libvirt-libvirt.html#virDomainGetXMLDesc">virDomainGetXMLDesc()</a>, as the output of <a href="html/libvirt-libvirt.html#virDomainGetXMLDesc">virDomainGetXMLDesc()</a>,the
the following is an example of the format as returned by the shell command following is an example of the format as returned by the shell
<code>virsh xmldump fc4</code> , where fc4 was one of the running domains:</p><pre>&lt;domain type='xen' <span style="color: #0071FF; background-color: #FFFFFF">id='18'</span>&gt; command<code>virsh xmldump fc4</code>, where fc4 was one of the running
domains:</p><pre>&lt;domain type='xen' <span style="color: #0071FF; background-color: #FFFFFF">id='18'</span>&gt;
&lt;name&gt;fc4&lt;/name&gt; &lt;name&gt;fc4&lt;/name&gt;
<span style="color: #00B200; background-color: #FFFFFF">&lt;os&gt; <span style="color: #00B200; background-color: #FFFFFF">&lt;os&gt;
&lt;type&gt;linux&lt;/type&gt; &lt;type&gt;linux&lt;/type&gt;
@ -34,70 +35,72 @@ the following is an example of the format as returned by the shell command
&lt;/interface&gt;</span> &lt;/interface&gt;</span>
<span style="color: #FF8000; background-color: #FFFFFF">&lt;console tty='/dev/pts/5'/&gt;</span> <span style="color: #FF8000; background-color: #FFFFFF">&lt;console tty='/dev/pts/5'/&gt;</span>
&lt;/devices&gt; &lt;/devices&gt;
&lt;/domain&gt;</pre><p>The root element must be called <code>domain</code> with no namespace, the &lt;/domain&gt;</pre><p>The root element must be called <code>domain</code>with no namespace,
<code>type</code> attribute indicates the kind of hypervisor used, 'xen' is the<code>type</code>attribute indicates the kind of hypervisor used, 'xen'
the default value. The <code>id</code> attribute gives the domain id at isthe default value. The <code>id</code>attribute gives the domain id
runtime (not however that this may change, for example if the domain is saved atruntime (not however that this may change, for example if the domain is
to disk and restored). The domain has a few children whose order is not savedto disk and restored). The domain has a few children whose order is
significant:</p><ul><li>name: the domain name, preferably ASCII based</li> notsignificant:</p><ul><li>name: the domain name, preferably ASCII based</li>
<li>memory: the maximum memory allocated to the domain in kilobytes</li> <li>memory: the maximum memory allocated to the domain in kilobytes</li>
<li>vcpu: the number of virtual cpu configured for the domain</li> <li>vcpu: the number of virtual cpu configured for the domain</li>
<li>os: a block describing the Operating System, its content will be <li>os: a block describing the Operating System, its content will
dependant on the OS type bedependant on the OS type
<ul><li>type: indicate the OS type, always linux at this point</li> <ul><li>type: indicate the OS type, always linux at this point</li>
<li>kernel: path to the kernel on the Domain 0 filesystem</li> <li>kernel: path to the kernel on the Domain 0 filesystem</li>
<li>initrd: an optional path for the init ramdisk on the Domain 0 <li>initrd: an optional path for the init ramdisk on the Domain
filesystem</li> 0filesystem</li>
<li>cmdline: optional command line to the kernel</li> <li>cmdline: optional command line to the kernel</li>
<li>root: the root filesystem from the guest viewpoint, it may be <li>root: the root filesystem from the guest viewpoint, it may bepassed
passed as part of the cmdline content too</li> as part of the cmdline content too</li>
</ul></li> </ul></li>
<li>devices: a list of <code>disk</code>, <code>interface</code> and <li>devices: a list of <code>disk</code>,
<code>console</code> descriptions in no special order</li> <code>interface</code>and<code>console</code>descriptions in no special
</ul><p>The format of the devices and their type may grow over time, but the order</li>
following should be sufficient for basic use:</p><p>A <code>disk</code> device indicates a block device, it can have two </ul><p>The format of the devices and their type may grow over time, but
values for the type attribute either 'file' or 'block' corresponding to the 2 thefollowing should be sufficient for basic use:</p><p>A <code>disk</code>device indicates a block device, it can have twovalues
options availble at the Xen layer. It has two mandatory children, and one for the type attribute either 'file' or 'block' corresponding to the 2options
optional one in no specific order:</p><ul><li>source with a file attribute containing the path in Domain 0 to the availble at the Xen layer. It has two mandatory children, and oneoptional one
file or a dev attribute if using a block device, containing the device in no specific order:</p><ul><li>source with a file attribute containing the path in Domain 0 to thefile
name ('hda5' or '/dev/hda5')</li> or a dev attribute if using a block device, containing the devicename
<li>target indicates in a dev attribute the device where it is mapped in ('hda5' or '/dev/hda5')</li>
the guest</li> <li>target indicates in a dev attribute the device where it is mapped inthe
<li>readonly an optional empty element indicating the device is guest</li>
read-only</li> <li>readonly an optional empty element indicating the device
</ul><p>An <code>interface</code> element describes a network device mapped on the isread-only</li>
guest, it also has a type whose value is currently 'bridge', it also have a </ul><p>An <code>interface</code>element describes a network device mapped on
number of children in no specific order:</p><ul><li>source: indicating the bridge name</li> theguest, it also has a type whose value is currently 'bridge', it also have
anumber of children in no specific order:</p><ul><li>source: indicating the bridge name</li>
<li>mac: the optional mac address provided in the address attribute</li> <li>mac: the optional mac address provided in the address attribute</li>
<li>ip: the optional IP address provided in the address attribute</li> <li>ip: the optional IP address provided in the address attribute</li>
<li>script: the script used to bridge the interfcae in the Domain 0</li> <li>script: the script used to bridge the interfcae in the Domain 0</li>
<li>target: and optional target indicating the device name.</li> <li>target: and optional target indicating the device name.</li>
</ul><p>A <code>console</code> element describes a serial console connection to </ul><p>A <code>console</code>element describes a serial console connection tothe
the guest. It has no children, and a single attribute <code>tty</code> which guest. It has no children, and a single attribute
provides the path to the Pseudo TTY on which the guest console can be <code>tty</code>whichprovides the path to the Pseudo TTY on which the guest
accessed</p><p>Life cycle actions for the domain can also be expressed in the XML format, console can beaccessed</p><p>Life cycle actions for the domain can also be expressed in the XML
they drive what should be happening if the domain crashes, is rebooted or is format,they drive what should be happening if the domain crashes, is rebooted
poweroff. There is various actions possible when this happen:</p><ul><li>destroy: The domain is cleaned up (that's the default normal processing or ispoweroff. There is various actions possible when this happen:</p><ul><li>destroy: The domain is cleaned up (that's the default normal
in Xen)</li> processingin Xen)</li>
<li>restart: A new domain is started in place of the old one with the same <li>restart: A new domain is started in place of the old one with the
configuration parameters</li> sameconfiguration parameters</li>
<li>preserve: The domain will remain in memory until it is destroyed <li>preserve: The domain will remain in memory until it is
manually, it won't be running but allows for post-mortem debugging</li> destroyedmanually, it won't be running but allows for post-mortem
<li>rename-restart: a variant of the previous one but where the old domain debugging</li>
is renamed before being saved to allow a restart</li> <li>rename-restart: a variant of the previous one but where the old
domainis renamed before being saved to allow a restart</li>
</ul><p>The following could be used for a Xen production system:</p><pre>&lt;domain&gt; </ul><p>The following could be used for a Xen production system:</p><pre>&lt;domain&gt;
... ...
&lt;on_reboot&gt;restart&lt;/on_reboot&gt; &lt;on_reboot&gt;restart&lt;/on_reboot&gt;
&lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt; &lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
&lt;on_crash&gt;rename-restart&lt;/on_crash&gt; &lt;on_crash&gt;rename-restart&lt;/on_crash&gt;
... ...
&lt;/domain&gt;</pre><p>While the format may be extended in various ways as support for more &lt;/domain&gt;</pre><p>While the format may be extended in various ways as support for
hypervisor types and features are added, it is expected that this core subset morehypervisor types and features are added, it is expected that this core
will remain functional in spite of the evolution of the library.</p><h3 id="Fully"><a name="Fully1" id="Fully1">Fully virtualized guests</a> subsetwill remain functional in spite of the evolution of the library.</p><h3 id="Fully"><a name="Fully1" id="Fully1">Fully virtualized
(added in 0.1.3):</h3><p>Here is an example of a domain description used to start a fully guests</a>(added in 0.1.3):</h3><p>Here is an example of a domain description used to start a
virtualized (a.k.a. HVM) Xen domain. This requires hardware virtualization fullyvirtualized (a.k.a. HVM) Xen domain. This requires hardware
support at the processor level but allows to run unmodified operating virtualizationsupport at the processor level but allows to run unmodified
systems:</p><pre>&lt;domain type='xen' id='3'&gt; operatingsystems:</p><pre>&lt;domain type='xen' id='3'&gt;
&lt;name&gt;fv0&lt;/name&gt; &lt;name&gt;fv0&lt;/name&gt;
&lt;uuid&gt;4dea22b31d52d8f32516782e98ab3fa0&lt;/uuid&gt; &lt;uuid&gt;4dea22b31d52d8f32516782e98ab3fa0&lt;/uuid&gt;
&lt;os&gt; &lt;os&gt;
@ -137,46 +140,75 @@ systems:</p><pre>&lt;domain type='xen' id='3'&gt;
&lt;/disk&gt; &lt;/disk&gt;
<span style="color: #0000E5; background-color: #FFFFFF">&lt;graphics type='vnc' port='5904'/&gt;</span> <span style="color: #0000E5; background-color: #FFFFFF">&lt;graphics type='vnc' port='5904'/&gt;</span>
&lt;/devices&gt; &lt;/devices&gt;
&lt;/domain&gt;</pre><p>There is a few things to notice specifically for HVM domains:</p><ul><li>the optional <code>&lt;features&gt;</code> block is used to enable &lt;/domain&gt;</pre><p>There is a few things to notice specifically for HVM domains:</p><ul><li>the optional <code>&lt;features&gt;</code>block is used to
certain guest CPU / system features. For HVM guests the following enablecertain guest CPU / system features. For HVM guests the
features are defined: followingfeatures are defined:
<ul><li><code>pae</code> - enable PAE memory addressing</li> <ul><li><code>pae</code>- enable PAE memory addressing</li>
<li><code>apic</code> - enable IO APIC</li> <li><code>apic</code>- enable IO APIC</li>
<li><code>acpi</code> - enable ACPI bios</li> <li><code>acpi</code>- enable ACPI bios</li>
</ul></li> </ul></li>
<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, firstit
it indicates that the type is 'hvm' for hardware virtualization, then indicates that the type is 'hvm' for hardware virtualization, theninstead
instead of a kernel, boot and command line arguments, it points to an os of a kernel, boot and command line arguments, it points to an osboot
boot loader which will extract the boot informations from the boot device loader which will extract the boot informations from the boot
specified in a separate boot element. The <code>dev</code> attribute on devicespecified in a separate boot element. The <code>dev</code>attribute
the <code>boot</code> tag can be one of: onthe <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>
<li><code>hd</code> - boot from first harddisk device</li> <li><code>hd</code>- boot from first harddisk device</li>
<li><code>cdrom</code> - boot from first cdrom device</li> <li><code>cdrom</code>- boot from first cdrom device</li>
</ul></li> </ul></li>
<li>the <code>&lt;devices&gt;</code> section includes an emulator entry <li>the <code>&lt;devices&gt;</code>section includes an emulator
pointing to an additional program in charge of emulating the devices</li> entrypointing to an additional program in charge of emulating the
<li>the disk entry indicates in the dev target section that the emulation devices</li>
for the drive is the first IDE disk device hda. The list of device names <li>the disk entry indicates in the dev target section that the
supported is dependant on the Hypervisor, but for Xen it can be any IDE emulationfor the drive is the first IDE disk device hda. The list of
device <code>hda</code>-<code>hdd</code>, or a floppy device device namessupported is dependant on the Hypervisor, but for Xen it can
<code>fda</code>, <code>fdb</code>. The <code>&lt;disk&gt;</code> element be any IDEdevice <code>hda</code>-<code>hdd</code>, or a floppy
also supports a 'device' attribute to indicate what kinda of hardware to device<code>fda</code>, <code>fdb</code>. The
emulate. The following values are supported: <code>&lt;disk&gt;</code>elementalso supports a 'device' attribute to
<ul><li><code>floppy</code> - a floppy disk controller</li> indicate what kinda of hardware toemulate. The following values are
<li><code>disk</code> - a generic hard drive (the default it supported:
omitted)</li> <ul><li><code>floppy</code>- a floppy disk controller</li>
<li><code>cdrom</code> - a CDROM device</li> <li><code>disk</code>- a generic hard drive (the default itomitted)</li>
<li><code>cdrom</code>- a CDROM device</li>
</ul> </ul>
For Xen 3.0.2 and earlier a CDROM device can only be emulated on the For Xen 3.0.2 and earlier a CDROM device can only be emulated on
<code>hdc</code> channel, while for 3.0.3 and later, it can be emulated the<code>hdc</code>channel, while for 3.0.3 and later, it can be
on any IDE channel.</li> emulatedon any IDE channel.</li>
<li>the <code>&lt;devices&gt;</code> section also include at least one <li>the <code>&lt;devices&gt;</code>section also include at least oneentry
entry for the graphic device used to render the os. Currently there is for the graphic device used to render the os. Currently there isjust 2
just 2 types possible 'vnc' or 'sdl'. If the type is 'vnc', then an types possible 'vnc' or 'sdl'. If the type is 'vnc', then anadditional
additional <code>port</code> attribute will be present indicating the TCP <code>port</code>attribute will be present indicating the TCPport on
port on which the VNC server is accepting client connections.</li> which the VNC server is accepting client connections.</li>
</ul><p>It is likely that the HVM description gets additional optional elements </ul><p>It is likely that the HVM description gets additional optional elementsand
and attributes as the support for fully virtualized domain expands, attributes as the support for fully virtualized domain expands,especially for
especially for the variety of devices emulated and the graphic support the variety of devices emulated and the graphic supportoptions offered.</p><h3><a name="KVM1" id="KVM1">KVM domain (added in 0.2.0)</a></h3><p>Support for the KVM virtualization is provided in recent Linux kernels
options offered.</p><h3><a name="KVM1" id="KVM1">KVM domain</a></h3><p></p><h3><a name="QEmu1" id="QEmu1">QEmu domain</a></h3><p></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">Binding for Python</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="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://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> (2.6.20 and onward). This requires specific hardware with acceleration
support and the availability of the special version of the <a href="http://fabrice.bellard.free.fr/qemu/">QEmu</a> binary. Since this
relies on QEmu for the machine emulation like fully virtualized guests the
XML description is quite similar, here is a simple example:</p><pre>&lt;domain <span style="color: #FF0000; background-color: #FFFFFF">type='kvm'</span>&gt;
&lt;name&gt;demo2&lt;/name&gt;
&lt;uuid&gt;4dea24b3-1d52-d8f3-2516-782e98a23fa0&lt;/uuid&gt;
&lt;memory&gt;131072&lt;/memory&gt;
&lt;vcpu&gt;1&lt;/vcpu&gt;
&lt;os&gt;
&lt;type&gt;hvm&lt;/type&gt;
&lt;/os&gt;
&lt;devices&gt;
<span style="color: #FF0000; background-color: #FFFFFF">&lt;emulator&gt;/home/user/usr/kvm-devel/bin/qemu-system-x86_64&lt;/emulator&gt;</span>
&lt;disk type='file' device='disk'&gt;
&lt;source file='/home/user/fedora/diskboot.img'/&gt;
&lt;target dev='hda'/&gt;
&lt;/disk&gt;
&lt;interface <span style="color: #FF0000; background-color: #FFFFFF">type='user'</span>&gt;
&lt;mac address='24:42:53:21:52:45'/&gt;
&lt;/interface&gt;
&lt;graphics type='vnc' port='-1'/&gt;
&lt;/devices&gt;
&lt;/domain&gt;</pre><p>The specific points to note if using KVM are:</p><ul><li>the top level domain element carries a type of 'kvm'</li>
<li>the &lt;devices&gt; emulator points to the special qemu binary required
for KVM</li>
<li>networking interface definitions definitions are somewhat different due
to a different model from Xen (@@TODO)</li>
</ul><p>except those points the options should be quite similar to Xen HVM
ones.</p><h3><a name="QEmu1" id="QEmu1">QEmu domain (added in 0.2.0)</a></h3><p></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">Binding for Python</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="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://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>

19
docs/index.html
View File

@ -15,16 +15,15 @@
</div> </div>
<div id="content"> <div id="content">
<h3>what is <span class="style1">libvirt?</span></h3> <h3>what is <span class="style1">libvirt?</span></h3>
<p>Libvirt is a C toolkit to interact with the virtualization capabilities <p>Libvirt is a C toolkit to interact with the virtualization capabilitiesof
of recent versions of Linux (and other OSes). It is free software available recent versions of Linux (and other OSes). It is free software availableunder
under the <a href="http://www.opensource.org/licenses/lgpl-license.html">GNU the <a href="http://www.opensource.org/licenses/lgpl-license.html">GNULesser
Lesser General Public License</a>. Virtualization of the Linux Operating General Public License</a>. Virtualization of the Linux OperatingSystem means
System means the ability to run multiple instances of Operating Systems the ability to run multiple instances of Operating Systemsconcurently on a
concurently on a single hardware system where the basic resources are driven single hardware system where the basic resources are drivenby a Linux
by a Linux instance. The library aim at providing long term stable C API instance. The library aim at providing long term stable C APIinitially for
initially for the <a href="http://www.cl.cam.ac.uk/Research/SRG/netos/xen/index.html">Xen the <a href="http://www.cl.cam.ac.uk/Research/SRG/netos/xen/index.html">Xenparavirtualization</a>but
paravirtualization</a> but should be able to integrate other virtualization should be able to integrate other virtualizationmechanisms if needed.</p>
mechanisms if needed.</p>
</div> </div>
</div> </div>
<div class="linkList"> <div class="linkList">

60
docs/intro.html
View File

@ -1,32 +1,32 @@
<?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>Introduction</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">Introduction</h1><p>Libvirt is a C toolkit to interact with the virtualization capabilities of <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>Introduction</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">Introduction</h1><p>Libvirt is a C toolkit to interact with the virtualization capabilities
recent versions of Linux (and other OSes), but libvirt won't try to provide ofrecent versions of Linux (and other OSes), but libvirt won't try to
all possible interfaces for interacting with the virtualization features.</p><p>To avoid ambiguity about the terms used here here are the definitions for provideall possible interfaces for interacting with the virtualization
some of the specific concepts used in libvirt documentation:</p><ul><li>a <strong>node</strong> is a single physical machine</li> features.</p><p>To avoid ambiguity about the terms used here here are the definitions
<li>an <strong>hypervisor</strong> is a layer of software allowing to forsome of the specific concepts used in libvirt documentation:</p><ul><li>a <strong>node</strong>is a single physical machine</li>
virtualize a node in a set of virtual machines with possibly different <li>an <strong>hypervisor</strong>is a layer of software allowing
configurations than the node itself</li> tovirtualize a node in a set of virtual machines with possibly
<li>a <strong>domain</strong> is an instance of an operating system running differentconfigurations than the node itself</li>
on a virtualized machine provided by the hypervisor</li> <li>a <strong>domain</strong>is an instance of an operating system
</ul><p style="text-align: center"><img alt="Hypervisor and domains running on a node" src="node.gif" /></p><p>Now we can define the goal of libvirt: to provide the lowest possible runningon a virtualized machine provided by the hypervisor</li>
generic and stable layer to manage domains on a node.</p><p>This implies the following:</p><ul><li>the API is not targetted to a single virtualization environment, it </ul><p style="text-align: center"><img alt="Hypervisor and domains running on a node" src="node.gif" /></p><p>Now we can define the goal of libvirt: to provide the lowest
currently supports Xen and QEmu/KVM. This also implies that some very possiblegeneric and stable layer to manage domains on a node.</p><p>This implies the following:</p><ul><li>the API is not targetted to a single virtualization environment,
specific capabilities which are not generic enough may not be provided as itcurrently supports Xen and QEmu/KVM. This also implies that some
libvirt APIs</li> veryspecific capabilities which are not generic enough may not be
<li>the API should allow to do efficiently and cleanly all the operations provided aslibvirt APIs</li>
needed to manage domains on a node</li> <li>the API should allow to do efficiently and cleanly all the
<li>the API will not try to provide hight level multi-nodes management operationsneeded to manage domains on a node</li>
features like load balancing, though they could be implemented on top of <li>the API will not try to provide hight level multi-nodes
libvirt</li> managementfeatures like load balancing, though they could be implemented
<li>stability of the API is a big concern, libvirt should isolate on top oflibvirt</li>
applications from the frequent changes expected at the lower level of the <li>stability of the API is a big concern, libvirt should
virtualization framework</li> isolateapplications from the frequent changes expected at the lower level
</ul><p>So libvirt should be a building block for higher level management tools of thevirtualization framework</li>
and for applications focusing on virtualization of a single node (the only </ul><p>So libvirt should be a building block for higher level management toolsand
exception being domain migration between node capabilities which may need to for applications focusing on virtualization of a single node (the
be added at the libvirt level). Where possible libvirt should be extendable onlyexception being domain migration between node capabilities which may need
to be able to provide the same API for remote nodes, however this is not the tobe added at the libvirt level). Where possible libvirt should be
case at the moment, the code currently handle only local node accesses extendableto be able to provide the same API for remote nodes, however this
(extension for remote access support is being worked on, see is not thecase at the moment, the code currently handle only local node
<a href="bugs.html">the mailing list</a> discussions about it).</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">Binding for Python</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="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://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> accesses(extension for remote access support is being worked on, see<a href="bugs.html">the mailing list</a>discussions about it).</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">Binding for Python</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="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://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>

1058
docs/libvir.html
View File

File diff suppressed because it is too large Load Diff

41
docs/libvirt-api.xml
View File

@ -67,7 +67,7 @@
<exports symbol='virNetworkUndefine' type='function'/> <exports symbol='virNetworkUndefine' type='function'/>
<exports symbol='virGetVersion' type='function'/> <exports symbol='virGetVersion' type='function'/>
<exports symbol='virConnectListDefinedDomains' type='function'/> <exports symbol='virConnectListDefinedDomains' type='function'/>
<exports symbol='virDomainSetMaxMemory' type='function'/> <exports symbol='virConnectGetCapabilities' type='function'/>
<exports symbol='virNetworkGetUUID' type='function'/> <exports symbol='virNetworkGetUUID' type='function'/>
<exports symbol='virDomainLookupByName' type='function'/> <exports symbol='virDomainLookupByName' type='function'/>
<exports symbol='virNetworkLookupByUUID' type='function'/> <exports symbol='virNetworkLookupByUUID' type='function'/>
@ -121,6 +121,7 @@
<exports symbol='virDomainGetAutostart' type='function'/> <exports symbol='virDomainGetAutostart' type='function'/>
<exports symbol='virDomainGetVcpus' type='function'/> <exports symbol='virDomainGetVcpus' type='function'/>
<exports symbol='virDomainGetXMLDesc' type='function'/> <exports symbol='virDomainGetXMLDesc' type='function'/>
<exports symbol='virDomainSetMaxMemory' type='function'/>
<exports symbol='virConnectGetVersion' type='function'/> <exports symbol='virConnectGetVersion' type='function'/>
<exports symbol='virConnectListNetworks' type='function'/> <exports symbol='virConnectListNetworks' type='function'/>
<exports symbol='virDomainLookupByID' type='function'/> <exports symbol='virDomainLookupByID' type='function'/>
@ -132,6 +133,7 @@
<author>Daniel Veillard &lt;veillard@redhat.com&gt; </author> <author>Daniel Veillard &lt;veillard@redhat.com&gt; </author>
<exports symbol='VIR_FROM_XML' type='enum'/> <exports symbol='VIR_FROM_XML' type='enum'/>
<exports symbol='VIR_ERR_CALL_FAILED' type='enum'/> <exports symbol='VIR_ERR_CALL_FAILED' type='enum'/>
<exports symbol='VIR_ERR_SYSTEM_ERROR' type='enum'/>
<exports symbol='VIR_ERR_WARNING' type='enum'/> <exports symbol='VIR_ERR_WARNING' type='enum'/>
<exports symbol='VIR_ERR_NO_XEN' type='enum'/> <exports symbol='VIR_ERR_NO_XEN' type='enum'/>
<exports symbol='VIR_ERR_INVALID_ARG' type='enum'/> <exports symbol='VIR_ERR_INVALID_ARG' type='enum'/>
@ -245,6 +247,7 @@
<arg name='cpu' info='the physical CPU number'/> <arg name='cpu' info='the physical CPU number'/>
</macro> </macro>
<macro name='VIR_UUID_BUFLEN' file='libvirt'> <macro name='VIR_UUID_BUFLEN' file='libvirt'>
<info>This macro provides the length of the buffer required for virDomainGetUUID()</info>
</macro> </macro>
<macro name='VIR_UUID_STRING_BUFLEN' file='libvirt'> <macro name='VIR_UUID_STRING_BUFLEN' file='libvirt'>
<info>This macro provides the length of the buffer required for virDomainGetUUIDString()</info> <info>This macro provides the length of the buffer required for virDomainGetUUIDString()</info>
@ -277,7 +280,7 @@
<enum name='VIR_ERR_INVALID_CONN' file='virterror' value='6' type='virErrorNumber' info='invalid connection object'/> <enum name='VIR_ERR_INVALID_CONN' file='virterror' value='6' type='virErrorNumber' info='invalid connection object'/>
<enum name='VIR_ERR_INVALID_DOMAIN' file='virterror' value='7' type='virErrorNumber' info='invalid domain object'/> <enum name='VIR_ERR_INVALID_DOMAIN' file='virterror' value='7' type='virErrorNumber' info='invalid domain object'/>
<enum name='VIR_ERR_INVALID_NETWORK' file='virterror' value='36' type='virErrorNumber' info='invalid network object'/> <enum name='VIR_ERR_INVALID_NETWORK' file='virterror' value='36' type='virErrorNumber' info='invalid network object'/>
<enum name='VIR_ERR_NETWORK_EXIST' file='virterror' value='37' type='virErrorNumber' info=' the network already exist'/> <enum name='VIR_ERR_NETWORK_EXIST' file='virterror' value='37' type='virErrorNumber' info='the network already exist'/>
<enum name='VIR_ERR_NONE' file='virterror' value='0' type='virErrorLevel'/> <enum name='VIR_ERR_NONE' file='virterror' value='0' type='virErrorLevel'/>
<enum name='VIR_ERR_NO_CONNECT' file='virterror' value='5' type='virErrorNumber' info='can&apos;t connect to hypervisor'/> <enum name='VIR_ERR_NO_CONNECT' file='virterror' value='5' type='virErrorNumber' info='can&apos;t connect to hypervisor'/>
<enum name='VIR_ERR_NO_DEVICE' file='virterror' value='23' type='virErrorNumber' info='missing domain devices information'/> <enum name='VIR_ERR_NO_DEVICE' file='virterror' value='23' type='virErrorNumber' info='missing domain devices information'/>
@ -300,6 +303,7 @@
<enum name='VIR_ERR_POST_FAILED' file='virterror' value='11' type='virErrorNumber' info='a HTTP POST command to failed'/> <enum name='VIR_ERR_POST_FAILED' file='virterror' value='11' type='virErrorNumber' info='a HTTP POST command to failed'/>
<enum name='VIR_ERR_READ_FAILED' file='virterror' value='31' type='virErrorNumber' info='failed to read a conf file'/> <enum name='VIR_ERR_READ_FAILED' file='virterror' value='31' type='virErrorNumber' info='failed to read a conf file'/>
<enum name='VIR_ERR_SEXPR_SERIAL' file='virterror' value='13' type='virErrorNumber' info='failure to serialize an S-Expr'/> <enum name='VIR_ERR_SEXPR_SERIAL' file='virterror' value='13' type='virErrorNumber' info='failure to serialize an S-Expr'/>
<enum name='VIR_ERR_SYSTEM_ERROR' file='virterror' value='38' type='virErrorNumber' info=' general system call failure'/>
<enum name='VIR_ERR_UNKNOWN_HOST' file='virterror' value='4' type='virErrorNumber' info='could not resolve hostname'/> <enum name='VIR_ERR_UNKNOWN_HOST' file='virterror' value='4' type='virErrorNumber' info='could not resolve hostname'/>
<enum name='VIR_ERR_WARNING' file='virterror' value='1' type='virErrorLevel' info='A simple warning'/> <enum name='VIR_ERR_WARNING' file='virterror' value='1' type='virErrorLevel' info='A simple warning'/>
<enum name='VIR_ERR_WRITE_FAILED' file='virterror' value='34' type='virErrorNumber' info='failed to write a conf file'/> <enum name='VIR_ERR_WRITE_FAILED' file='virterror' value='34' type='virErrorNumber' info='failed to write a conf file'/>
@ -423,9 +427,14 @@
<return type='int' info='0 in case of success or -1 in case of error.'/> <return type='int' info='0 in case of success or -1 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='virConnectGetCapabilities' file='libvirt' module='libvirt'>
<info>Provides capabilities of the hypervisor / driver.</info>
<return type='char *' info='NULL in case of error, or a pointer to an opaque virCapabilities structure (virCapabilitiesPtr). The client must free the returned string after use.'/>
<arg name='conn' type='virConnectPtr' info='pointer to the hypervisor connection'/>
</function>
<function name='virConnectGetMaxVcpus' file='libvirt' module='libvirt'> <function name='virConnectGetMaxVcpus' file='libvirt' module='libvirt'>
<info></info> <info>Provides the maximum number of virtual CPUs supported for a guest VM of a specific type. The &apos;type&apos; parameter here corresponds to the &apos;type&apos; attribute in the &lt;domain&gt; element of the XML.</info>
<return type='int' info='the maximum number of virtual CPUs supported for a guest VM of a specific type. The &apos;type&apos; parameter here corresponds to the &apos;type&apos; attribute in the &lt;domain&gt; element of the XML. Returns the maximum of virtual CPU or -1 in case of error.'/> <return type='int' info='the maximum of virtual CPU or -1 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'/>
<arg name='type' type='const char *' info='value of the &apos;type&apos; attribute in the &lt;domain&gt; element'/> <arg name='type' type='const char *' info='value of the &apos;type&apos; attribute in the &lt;domain&gt; element'/>
</function> </function>
@ -556,10 +565,10 @@
<arg name='domain' type='virDomainPtr' info='a domain object'/> <arg name='domain' type='virDomainPtr' info='a domain object'/>
</function> </function>
<function name='virDomainGetAutostart' file='libvirt' module='libvirt'> <function name='virDomainGetAutostart' file='libvirt' module='libvirt'>
<info></info> <info>Provides a boolean value indicating whether the domain configured to be automatically started when the host machine boots.</info>
<return type='int' info='a boolean value indicating whether the domain configured to be automatically started when the host machine boots. Returns -1 in case of error, 0 in case of success'/> <return type='int' info='-1 in case of error, 0 in case of success'/>
<arg name='domain' type='virDomainPtr' info='a domain object'/> <arg name='domain' type='virDomainPtr' info='a domain object'/>
<arg name='autostart' type='int *' info=''/> <arg name='autostart' type='int *' info='the value returned'/>
</function> </function>
<function name='virDomainGetID' file='libvirt' module='libvirt'> <function name='virDomainGetID' file='libvirt' module='libvirt'>
<info>Get the hypervisor ID number for the domain</info> <info>Get the hypervisor ID number for the domain</info>
@ -578,8 +587,8 @@
<arg name='domain' type='virDomainPtr' info='a domain object or NULL'/> <arg name='domain' type='virDomainPtr' info='a domain object or NULL'/>
</function> </function>
<function name='virDomainGetMaxVcpus' file='libvirt' module='libvirt'> <function name='virDomainGetMaxVcpus' file='libvirt' module='libvirt'>
<info></info> <info>Provides the maximum number of virtual CPUs supported for the guest VM. If the guest is inactive, this is basically the same as virConnectGetMaxVcpus. If the guest is running this will reflect the maximum number of virtual CPUs the guest was booted with.</info>
<return type='int' info='the maximum number of virtual CPUs supported for the guest VM. If the guest is inactive, this is basically the same as virConnectGetMaxVcpus. If the guest is running this will reflect the maximum number of virtual CPUs the guest was booted with. Returns the maximum of virtual CPU or -1 in case of error.'/> <return type='int' info='the maximum of virtual CPU or -1 in case of error.'/>
<arg name='domain' type='virDomainPtr' info='pointer to domain object'/> <arg name='domain' type='virDomainPtr' info='pointer to domain object'/>
</function> </function>
<function name='virDomainGetName' file='libvirt' module='libvirt'> <function name='virDomainGetName' file='libvirt' module='libvirt'>
@ -678,7 +687,7 @@
<info>Configure the domain to be automatically started when the host machine boots.</info> <info>Configure the domain to be automatically started when the host machine boots.</info>
<return type='int' info='-1 in case of error, 0 in case of success'/> <return type='int' info='-1 in case of error, 0 in case of success'/>
<arg name='domain' type='virDomainPtr' info='a domain object'/> <arg name='domain' type='virDomainPtr' info='a domain object'/>
<arg name='autostart' type='int' info=''/> <arg name='autostart' type='int' info='whether the domain should be automatically started 0 or 1'/>
</function> </function>
<function name='virDomainSetMaxMemory' file='libvirt' module='libvirt'> <function name='virDomainSetMaxMemory' file='libvirt' module='libvirt'>
<info>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. This function requires priviledged access to the hypervisor.</info> <info>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. This function requires priviledged access to the hypervisor.</info>
@ -762,14 +771,14 @@
<arg name='network' type='virNetworkPtr' info='a network object'/> <arg name='network' type='virNetworkPtr' info='a network object'/>
</function> </function>
<function name='virNetworkGetAutostart' file='libvirt' module='libvirt'> <function name='virNetworkGetAutostart' file='libvirt' module='libvirt'>
<info></info> <info>Provides a boolean value indicating whether the network configured to be automatically started when the host machine boots.</info>
<return type='int' info='a boolean value indicating whether the network configured to be automatically started when the host machine boots. Returns -1 in case of error, 0 in case of success'/> <return type='int' info='-1 in case of error, 0 in case of success'/>
<arg name='network' type='virNetworkPtr' info='a network object'/> <arg name='network' type='virNetworkPtr' info='a network object'/>
<arg name='autostart' type='int *' info=''/> <arg name='autostart' type='int *' info='the value returned'/>
</function> </function>
<function name='virNetworkGetBridgeName' file='libvirt' module='libvirt'> <function name='virNetworkGetBridgeName' file='libvirt' module='libvirt'>
<info></info> <info>Provides a bridge interface name to which a domain may connect a network interface in order to join the network.</info>
<return type='char *' info='a bridge interface name to which a domain may connect a network interface in order to join the network. Returns a 0 terminated interface name, or NULL in case of error. the caller must free() the returned value.'/> <return type='char *' info='a 0 terminated interface name, or NULL in case of error. the caller must free() the returned value.'/>
<arg name='network' type='virNetworkPtr' info='a network object'/> <arg name='network' type='virNetworkPtr' info='a network object'/>
</function> </function>
<function name='virNetworkGetName' file='libvirt' module='libvirt'> <function name='virNetworkGetName' file='libvirt' module='libvirt'>
@ -817,7 +826,7 @@
<info>Configure the network to be automatically started when the host machine boots.</info> <info>Configure the network to be automatically started when the host machine boots.</info>
<return type='int' info='-1 in case of error, 0 in case of success'/> <return type='int' info='-1 in case of error, 0 in case of success'/>
<arg name='network' type='virNetworkPtr' info='a network object'/> <arg name='network' type='virNetworkPtr' info='a network object'/>
<arg name='autostart' type='int' info=''/> <arg name='autostart' type='int' info='whether the network should be automatically started 0 or 1'/>
</function> </function>
<function name='virNetworkUndefine' file='libvirt' module='libvirt'> <function name='virNetworkUndefine' file='libvirt' module='libvirt'>
<info>Undefine a network but does not stop it if it is running</info> <info>Undefine a network but does not stop it if it is running</info>

58
docs/libvirt-refs.xml
View File

@ -56,6 +56,7 @@
<reference name='VIR_ERR_POST_FAILED' href='html/libvirt-virterror.html#VIR_ERR_POST_FAILED'/> <reference name='VIR_ERR_POST_FAILED' href='html/libvirt-virterror.html#VIR_ERR_POST_FAILED'/>
<reference name='VIR_ERR_READ_FAILED' href='html/libvirt-virterror.html#VIR_ERR_READ_FAILED'/> <reference name='VIR_ERR_READ_FAILED' href='html/libvirt-virterror.html#VIR_ERR_READ_FAILED'/>
<reference name='VIR_ERR_SEXPR_SERIAL' href='html/libvirt-virterror.html#VIR_ERR_SEXPR_SERIAL'/> <reference name='VIR_ERR_SEXPR_SERIAL' href='html/libvirt-virterror.html#VIR_ERR_SEXPR_SERIAL'/>
<reference name='VIR_ERR_SYSTEM_ERROR' href='html/libvirt-virterror.html#VIR_ERR_SYSTEM_ERROR'/>
<reference name='VIR_ERR_UNKNOWN_HOST' href='html/libvirt-virterror.html#VIR_ERR_UNKNOWN_HOST'/> <reference name='VIR_ERR_UNKNOWN_HOST' href='html/libvirt-virterror.html#VIR_ERR_UNKNOWN_HOST'/>
<reference name='VIR_ERR_WARNING' href='html/libvirt-virterror.html#VIR_ERR_WARNING'/> <reference name='VIR_ERR_WARNING' href='html/libvirt-virterror.html#VIR_ERR_WARNING'/>
<reference name='VIR_ERR_WRITE_FAILED' href='html/libvirt-virterror.html#VIR_ERR_WRITE_FAILED'/> <reference name='VIR_ERR_WRITE_FAILED' href='html/libvirt-virterror.html#VIR_ERR_WRITE_FAILED'/>
@ -94,6 +95,7 @@
<reference name='virConnSetErrorFunc' href='html/libvirt-virterror.html#virConnSetErrorFunc'/> <reference name='virConnSetErrorFunc' href='html/libvirt-virterror.html#virConnSetErrorFunc'/>
<reference name='virConnect' href='html/libvirt-libvirt.html#virConnect'/> <reference name='virConnect' href='html/libvirt-libvirt.html#virConnect'/>
<reference name='virConnectClose' href='html/libvirt-libvirt.html#virConnectClose'/> <reference name='virConnectClose' href='html/libvirt-libvirt.html#virConnectClose'/>
<reference name='virConnectGetCapabilities' href='html/libvirt-libvirt.html#virConnectGetCapabilities'/>
<reference name='virConnectGetMaxVcpus' href='html/libvirt-libvirt.html#virConnectGetMaxVcpus'/> <reference name='virConnectGetMaxVcpus' href='html/libvirt-libvirt.html#virConnectGetMaxVcpus'/>
<reference name='virConnectGetType' href='html/libvirt-libvirt.html#virConnectGetType'/> <reference name='virConnectGetType' href='html/libvirt-libvirt.html#virConnectGetType'/>
<reference name='virConnectGetVersion' href='html/libvirt-libvirt.html#virConnectGetVersion'/> <reference name='virConnectGetVersion' href='html/libvirt-libvirt.html#virConnectGetVersion'/>
@ -251,6 +253,7 @@
<ref name='VIR_ERR_POST_FAILED'/> <ref name='VIR_ERR_POST_FAILED'/>
<ref name='VIR_ERR_READ_FAILED'/> <ref name='VIR_ERR_READ_FAILED'/>
<ref name='VIR_ERR_SEXPR_SERIAL'/> <ref name='VIR_ERR_SEXPR_SERIAL'/>
<ref name='VIR_ERR_SYSTEM_ERROR'/>
<ref name='VIR_ERR_UNKNOWN_HOST'/> <ref name='VIR_ERR_UNKNOWN_HOST'/>
<ref name='VIR_ERR_WARNING'/> <ref name='VIR_ERR_WARNING'/>
<ref name='VIR_ERR_WRITE_FAILED'/> <ref name='VIR_ERR_WRITE_FAILED'/>
@ -293,6 +296,7 @@
<ref name='virConnSetErrorFunc'/> <ref name='virConnSetErrorFunc'/>
<ref name='virConnect'/> <ref name='virConnect'/>
<ref name='virConnectClose'/> <ref name='virConnectClose'/>
<ref name='virConnectGetCapabilities'/>
<ref name='virConnectGetMaxVcpus'/> <ref name='virConnectGetMaxVcpus'/>
<ref name='virConnectGetType'/> <ref name='virConnectGetType'/>
<ref name='virConnectGetVersion'/> <ref name='virConnectGetVersion'/>
@ -464,6 +468,7 @@
<ref name='virConnResetLastError'/> <ref name='virConnResetLastError'/>
<ref name='virConnSetErrorFunc'/> <ref name='virConnSetErrorFunc'/>
<ref name='virConnectClose'/> <ref name='virConnectClose'/>
<ref name='virConnectGetCapabilities'/>
<ref name='virConnectGetMaxVcpus'/> <ref name='virConnectGetMaxVcpus'/>
<ref name='virConnectGetType'/> <ref name='virConnectGetType'/>
<ref name='virConnectGetVersion'/> <ref name='virConnectGetVersion'/>
@ -595,6 +600,7 @@
<ref name='_virVcpuInfo'/> <ref name='_virVcpuInfo'/>
<ref name='virConnect'/> <ref name='virConnect'/>
<ref name='virConnectClose'/> <ref name='virConnectClose'/>
<ref name='virConnectGetCapabilities'/>
<ref name='virConnectGetMaxVcpus'/> <ref name='virConnectGetMaxVcpus'/>
<ref name='virConnectGetType'/> <ref name='virConnectGetType'/>
<ref name='virConnectGetVersion'/> <ref name='virConnectGetVersion'/>
@ -717,6 +723,7 @@
<ref name='VIR_ERR_POST_FAILED'/> <ref name='VIR_ERR_POST_FAILED'/>
<ref name='VIR_ERR_READ_FAILED'/> <ref name='VIR_ERR_READ_FAILED'/>
<ref name='VIR_ERR_SEXPR_SERIAL'/> <ref name='VIR_ERR_SEXPR_SERIAL'/>
<ref name='VIR_ERR_SYSTEM_ERROR'/>
<ref name='VIR_ERR_UNKNOWN_HOST'/> <ref name='VIR_ERR_UNKNOWN_HOST'/>
<ref name='VIR_ERR_WARNING'/> <ref name='VIR_ERR_WARNING'/>
<ref name='VIR_ERR_WRITE_FAILED'/> <ref name='VIR_ERR_WRITE_FAILED'/>
@ -960,11 +967,17 @@
<ref name='virNetworkGetXMLDesc'/> <ref name='virNetworkGetXMLDesc'/>
</word> </word>
<word name='Provides'> <word name='Provides'>
<ref name='virConnectGetCapabilities'/>
<ref name='virConnectGetMaxVcpus'/>
<ref name='virConnectNumOfDefinedDomains'/> <ref name='virConnectNumOfDefinedDomains'/>
<ref name='virConnectNumOfDefinedNetworks'/> <ref name='virConnectNumOfDefinedNetworks'/>
<ref name='virConnectNumOfDomains'/> <ref name='virConnectNumOfDomains'/>
<ref name='virConnectNumOfNetworks'/> <ref name='virConnectNumOfNetworks'/>
<ref name='virDomainGetAutostart'/>
<ref name='virDomainGetMaxVcpus'/>
<ref name='virGetVersion'/> <ref name='virGetVersion'/>
<ref name='virNetworkGetAutostart'/>
<ref name='virNetworkGetBridgeName'/>
</word> </word>
</letter> </letter>
<letter name='R'> <letter name='R'>
@ -989,13 +1002,6 @@
<word name='Retrieve'> <word name='Retrieve'>
<ref name='virDomainGetMaxMemory'/> <ref name='virDomainGetMaxMemory'/>
</word> </word>
<word name='Returns'>
<ref name='virConnectGetMaxVcpus'/>
<ref name='virDomainGetAutostart'/>
<ref name='virDomainGetMaxVcpus'/>
<ref name='virNetworkGetAutostart'/>
<ref name='virNetworkGetBridgeName'/>
</word>
</letter> </letter>
<letter name='S'> <letter name='S'>
<word name='Set'> <word name='Set'>
@ -1028,6 +1034,7 @@
<ref name='VIR_NODEINFO_MAXCPUS'/> <ref name='VIR_NODEINFO_MAXCPUS'/>
<ref name='VIR_UNUSE_CPU'/> <ref name='VIR_UNUSE_CPU'/>
<ref name='VIR_USE_CPU'/> <ref name='VIR_USE_CPU'/>
<ref name='VIR_UUID_BUFLEN'/>
<ref name='VIR_UUID_STRING_BUFLEN'/> <ref name='VIR_UUID_STRING_BUFLEN'/>
<ref name='cpumap'/> <ref name='cpumap'/>
<ref name='virConnectClose'/> <ref name='virConnectClose'/>
@ -1170,6 +1177,7 @@
<ref name='virDomainShutdown'/> <ref name='virDomainShutdown'/>
</word> </word>
<word name='after'> <word name='after'>
<ref name='virConnectGetCapabilities'/>
<ref name='virDomainReboot'/> <ref name='virDomainReboot'/>
<ref name='virDomainSave'/> <ref name='virDomainSave'/>
<ref name='virDomainShutdown'/> <ref name='virDomainShutdown'/>
@ -1349,6 +1357,7 @@
<ref name='virNetworkGetBridgeName'/> <ref name='virNetworkGetBridgeName'/>
</word> </word>
<word name='buffer'> <word name='buffer'>
<ref name='VIR_UUID_BUFLEN'/>
<ref name='VIR_UUID_STRING_BUFLEN'/> <ref name='VIR_UUID_STRING_BUFLEN'/>
</word> </word>
<word name='but'> <word name='but'>
@ -1423,6 +1432,9 @@
<ref name='virDomainGetInfo'/> <ref name='virDomainGetInfo'/>
<ref name='virDomainPinVcpu'/> <ref name='virDomainPinVcpu'/>
</word> </word>
<word name='capabilities'>
<ref name='virConnectGetCapabilities'/>
</word>
<word name='capacities'> <word name='capacities'>
<ref name='virConnectGetVersion'/> <ref name='virConnectGetVersion'/>
</word> </word>
@ -1447,6 +1459,9 @@
<word name='clean'> <word name='clean'>
<ref name='virResetError'/> <ref name='virResetError'/>
</word> </word>
<word name='client'>
<ref name='virConnectGetCapabilities'/>
</word>
<word name='closes'> <word name='closes'>
<ref name='virConnectClose'/> <ref name='virConnectClose'/>
</word> </word>
@ -1626,6 +1641,7 @@
<ref name='virNetworkDestroy'/> <ref name='virNetworkDestroy'/>
</word> </word>
<word name='driver'> <word name='driver'>
<ref name='virConnectGetCapabilities'/>
<ref name='virGetVersion'/> <ref name='virGetVersion'/>
</word> </word>
<word name='dump'> <word name='dump'>
@ -1709,6 +1725,7 @@
</word> </word>
<word name='free'> <word name='free'>
<ref name='virConnCopyLastError'/> <ref name='virConnCopyLastError'/>
<ref name='virConnectGetCapabilities'/>
<ref name='virCopyLastError'/> <ref name='virCopyLastError'/>
<ref name='virDomainGetXMLDesc'/> <ref name='virDomainGetXMLDesc'/>
<ref name='virNetworkGetBridgeName'/> <ref name='virNetworkGetBridgeName'/>
@ -1969,6 +1986,7 @@
</word> </word>
<word name='length'> <word name='length'>
<ref name='VIR_CPU_MAPLEN'/> <ref name='VIR_CPU_MAPLEN'/>
<ref name='VIR_UUID_BUFLEN'/>
<ref name='VIR_UUID_STRING_BUFLEN'/> <ref name='VIR_UUID_STRING_BUFLEN'/>
<ref name='maplen'/> <ref name='maplen'/>
</word> </word>
@ -2048,6 +2066,7 @@
<ref name='VIR_NODEINFO_MAXCPUS'/> <ref name='VIR_NODEINFO_MAXCPUS'/>
<ref name='VIR_UNUSE_CPU'/> <ref name='VIR_UNUSE_CPU'/>
<ref name='VIR_USE_CPU'/> <ref name='VIR_USE_CPU'/>
<ref name='VIR_UUID_BUFLEN'/>
<ref name='VIR_UUID_STRING_BUFLEN'/> <ref name='VIR_UUID_STRING_BUFLEN'/>
</word> </word>
<word name='major'> <word name='major'>
@ -2155,6 +2174,7 @@
</word> </word>
<word name='must'> <word name='must'>
<ref name='cpumap'/> <ref name='cpumap'/>
<ref name='virConnectGetCapabilities'/>
<ref name='virDomainGetOSType'/> <ref name='virDomainGetOSType'/>
<ref name='virDomainGetVcpus'/> <ref name='virDomainGetVcpus'/>
<ref name='virDomainGetXMLDesc'/> <ref name='virDomainGetXMLDesc'/>
@ -2273,6 +2293,9 @@
<ref name='virConnectGetVersion'/> <ref name='virConnectGetVersion'/>
<ref name='virDomainGetInfo'/> <ref name='virDomainGetInfo'/>
</word> </word>
<word name='opaque'>
<ref name='virConnectGetCapabilities'/>
</word>
<word name='operation'> <word name='operation'>
<ref name='virDomainGetOSType'/> <ref name='virDomainGetOSType'/>
<ref name='virDomainReboot'/> <ref name='virDomainReboot'/>
@ -2395,6 +2418,7 @@
<ref name='virSetErrorFunc'/> <ref name='virSetErrorFunc'/>
</word> </word>
<word name='provides'> <word name='provides'>
<ref name='VIR_UUID_BUFLEN'/>
<ref name='VIR_UUID_STRING_BUFLEN'/> <ref name='VIR_UUID_STRING_BUFLEN'/>
</word> </word>
<word name='providing'> <word name='providing'>
@ -2465,6 +2489,7 @@
</word> </word>
<word name='required'> <word name='required'>
<ref name='VIR_CPU_MAPLEN'/> <ref name='VIR_CPU_MAPLEN'/>
<ref name='VIR_UUID_BUFLEN'/>
<ref name='VIR_UUID_STRING_BUFLEN'/> <ref name='VIR_UUID_STRING_BUFLEN'/>
</word> </word>
<word name='requires'> <word name='requires'>
@ -2517,12 +2542,15 @@
<ref name='virNetworkDestroy'/> <ref name='virNetworkDestroy'/>
</word> </word>
<word name='returned'> <word name='returned'>
<ref name='virConnectGetCapabilities'/>
<ref name='virDomainCreateLinux'/> <ref name='virDomainCreateLinux'/>
<ref name='virDomainGetAutostart'/>
<ref name='virDomainGetVcpus'/> <ref name='virDomainGetVcpus'/>
<ref name='virDomainGetXMLDesc'/> <ref name='virDomainGetXMLDesc'/>
<ref name='virDomainPinVcpu'/> <ref name='virDomainPinVcpu'/>
<ref name='virGetVersion'/> <ref name='virGetVersion'/>
<ref name='virNetworkCreateXML'/> <ref name='virNetworkCreateXML'/>
<ref name='virNetworkGetAutostart'/>
<ref name='virNetworkGetBridgeName'/> <ref name='virNetworkGetBridgeName'/>
<ref name='virNetworkGetXMLDesc'/> <ref name='virNetworkGetXMLDesc'/>
</word> </word>
@ -2598,9 +2626,11 @@
<ref name='virConnectOpenReadOnly'/> <ref name='virConnectOpenReadOnly'/>
<ref name='virDomainDestroy'/> <ref name='virDomainDestroy'/>
<ref name='virDomainFree'/> <ref name='virDomainFree'/>
<ref name='virDomainSetAutostart'/>
<ref name='virDomainShutdown'/> <ref name='virDomainShutdown'/>
<ref name='virNetworkDestroy'/> <ref name='virNetworkDestroy'/>
<ref name='virNetworkFree'/> <ref name='virNetworkFree'/>
<ref name='virNetworkSetAutostart'/>
</word> </word>
<word name='shutdown'> <word name='shutdown'>
<ref name='virDomainDestroy'/> <ref name='virDomainDestroy'/>
@ -2700,6 +2730,7 @@
<word name='string'> <word name='string'>
<ref name='_virError'/> <ref name='_virError'/>
<ref name='_virNodeInfo'/> <ref name='_virNodeInfo'/>
<ref name='virConnectGetCapabilities'/>
<ref name='virConnectGetType'/> <ref name='virConnectGetType'/>
<ref name='virDomainGetName'/> <ref name='virDomainGetName'/>
<ref name='virDomainGetOSType'/> <ref name='virDomainGetOSType'/>
@ -2710,6 +2741,7 @@
<ref name='virNetworkLookupByUUIDString'/> <ref name='virNetworkLookupByUUIDString'/>
</word> </word>
<word name='structure'> <word name='structure'>
<ref name='virConnectGetCapabilities'/>
<ref name='virDomainDestroy'/> <ref name='virDomainDestroy'/>
<ref name='virDomainFree'/> <ref name='virDomainFree'/>
<ref name='virDomainGetInfo'/> <ref name='virDomainGetInfo'/>
@ -2873,6 +2905,7 @@
</word> </word>
<word name='use'> <word name='use'>
<ref name='virConnGetLastError'/> <ref name='virConnGetLastError'/>
<ref name='virConnectGetCapabilities'/>
<ref name='virErrorFunc'/> <ref name='virErrorFunc'/>
<ref name='virGetLastError'/> <ref name='virGetLastError'/>
</word> </word>
@ -2934,6 +2967,12 @@
<ref name='virConnectGetVersion'/> <ref name='virConnectGetVersion'/>
<ref name='virGetVersion'/> <ref name='virGetVersion'/>
</word> </word>
<word name='virCapabilities'>
<ref name='virConnectGetCapabilities'/>
</word>
<word name='virCapabilitiesPtr'>
<ref name='virConnectGetCapabilities'/>
</word>
<word name='virConnCopyLastError'> <word name='virConnCopyLastError'>
<ref name='virConnGetLastError'/> <ref name='virConnGetLastError'/>
</word> </word>
@ -2950,6 +2989,9 @@
<ref name='_virDomainInfo'/> <ref name='_virDomainInfo'/>
<ref name='virDomainCreateLinux'/> <ref name='virDomainCreateLinux'/>
</word> </word>
<word name='virDomainGetUUID'>
<ref name='VIR_UUID_BUFLEN'/>
</word>
<word name='virDomainGetUUIDString'> <word name='virDomainGetUUIDString'>
<ref name='VIR_UUID_STRING_BUFLEN'/> <ref name='VIR_UUID_STRING_BUFLEN'/>
</word> </word>
@ -3054,7 +3096,9 @@
</word> </word>
<word name='whether'> <word name='whether'>
<ref name='virDomainGetAutostart'/> <ref name='virDomainGetAutostart'/>
<ref name='virDomainSetAutostart'/>
<ref name='virNetworkGetAutostart'/> <ref name='virNetworkGetAutostart'/>
<ref name='virNetworkSetAutostart'/>
</word> </word>
<word name='which'> <word name='which'>
<ref name='virConnGetLastError'/> <ref name='virConnGetLastError'/>

210
docs/news.html
View File

@ -1,23 +1,30 @@
<?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>Releases</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">Releases</h1><p>Here is the list of official releases, however since it is early on in the <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>Releases</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">Releases</h1><p>Here is the list of official releases, however since it is early on in
development of libvirt, it is preferable when possible to just use the <a href="downloads.html">CVS version or snapshot</a>, contact the mailing list thedevelopment of libvirt, it is preferable when possible to just use the <a href="downloads.html">CVS version or snapshot</a>, contact the mailing
and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progresses.</p><h3>0.2.0: Feb 14 2007</h3><ul><li>Various internal cleanups (Mark McLoughlin, Richard Jones, listand check the <a href="ChangeLog.html">ChangeLog</a>to gauge
Daniel Berrange, Karel Zak)</li> progresses.</p><h3>0.2.0: Feb 14 2007</h3><ul><li>Various internal cleanups (Mark McLoughlin, Richard Jones,Daniel
<li>Bug fixes: avoid a crash in connect (Daniel Berrange), virsh args Berrange, Karel Zak)</li>
parsing (Richard Jones)</li> <li>Bug fixes: avoid a crash in connect (Daniel Berrange), virsh
argsparsing (Richard Jones)</li>
<li>Add support for QEmu and KVM virtualization (Daniel Berrange)</li> <li>Add support for QEmu and KVM virtualization (Daniel Berrange)</li>
<li>Add support for network configuration (Mark McLoughlin)</li> <li>Add support for network configuration (Mark McLoughlin)</li>
<li>Minor improvements: regression testing (Daniel Berrange), <li>Minor improvements: regression testing (Daniel Berrange),localization
localization string updates</li> string updates</li>
</ul><h3>0.1.11: Jan 22 2007</h3><ul><li>Finish XML &lt;-&gt; XM config files support</li> </ul><h3>0.1.11: Jan 22 2007</h3><ul><li>Finish XML &lt;-&gt; XM config files support</li>
<li>Remove memory leak when freeing virConf objects</li> <li>Remove memory leak when freeing virConf objects</li>
<li>Finishing inactive domain support (Daniel Berrange)</li> <li>Finishing inactive domain support (Daniel Berrange)</li>
<li>Added a Relax-NG schemas to check XML instances</li> <li>Added a Relax-NG schemas to check XML instances</li>
</ul><h3>0.1.10: Dec 20 2006</h3><ul><li>more localizations</li> </ul><h3>0.1.10: Dec 20 2006</h3><ul><li>more localizations</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>bug fixes: VCPU info breakages on xen 3.0.3, xenDaemonListDomains
<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> buffer overflow (Daniel Berrange), reference count bug when creating Xen
</ul><h3>0.1.9: Nov 29 2006</h3><ul><li>python bindings: release interpeter lock when calling C (Daniel Berrange)</li> 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>
</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 informations 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>
@ -25,123 +32,134 @@ and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progresses.</p><h3
<li>provide XML parsing errors</li> <li>provide XML parsing errors</li>
<li>extension of the test framework (Daniel Berrange)</li> <li>extension of the test framework (Daniel Berrange)</li>
<li>fix the reconnect regression test</li> <li>fix the reconnect regression test</li>
<li>python bindings: Domain instances now link to the Connect to avoid garbage collection and disconnect</li> <li>python bindings: Domain instances now link to the Connect to avoid
<li>separate the notion of maximum memory and current use at the XML level</li> garbage collection and disconnect</li>
<li>separate the notion of maximum memory and current use at the XML
level</li>
<li>Fix a memory leak (Daniel Berrange)</li> <li>Fix a memory leak (Daniel Berrange)</li>
<li>add support for shareable drives</li> <li>add support for shareable drives</li>
<li>add support for non-bridge style networking configs for guests(Daniel Berrange)</li> <li>add support for non-bridge style networking configs for guests(Daniel
Berrange)</li>
<li>python bindings: fix unsigned long marshalling (Daniel Berrange)</li> <li>python bindings: fix unsigned long marshalling (Daniel Berrange)</li>
<li>new config APIs virConfNew() and virConfSetValue() to build configs from scratch</li> <li>new config APIs virConfNew() and virConfSetValue() to build configs
from scratch</li>
<li>hot plug device support based on Michel Ponceau patch</li> <li>hot plug device support based on Michel Ponceau patch</li>
<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 informations take over &lt;os&gt; informations</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>
<li> don't label crashed domains as shut off (Peter Vetere)</li> <li>don't label crashed domains as shut off (Peter Vetere)</li>
<li> fix virsh man page (Noriko Mizumoto)</li> <li>fix virsh man page (Noriko Mizumoto)</li>
<li> blktapdd support for alternate drivers like blktap (Daniel Berrange)</li> <li>blktapdd support for alternate drivers like blktap (Daniel
<li> memory leak fixes (xend interface and XML parsing) (Daniel Berrange)</li> Berrange)</li>
<li> compile fix</li> <li>memory leak fixes (xend interface and XML parsing) (Daniel
<li> mlock/munlock size fixes (Daniel Berrange)</li> Berrange)</li>
<li> improve error reporting</li> <li>compile fix</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> <li>mlock/munlock size fixes (Daniel Berrange)</li>
<li> fix another problem in the hypercalls change in Xen changeset <li>improve error reporting</li>
86d26e6ec89b when getting domain informations (Daniel Berrange)</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>
<li>fix another problem in the hypercalls change in Xen
changeset86d26e6ec89b when getting domain informations (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
<li>Support for setting VNC port when creating domains with new Berrange)</li>
xend config files (Daniel Berrange) </li> <li>Support for setting VNC port when creating domains with newxend config
files (Daniel Berrange)</li>
<li>Fix bug when running against xen-3.0.2 hypercalls (Jim Fehlig)</li> <li>Fix bug when running against xen-3.0.2 hypercalls (Jim Fehlig)</li>
<li>Fix reconnection problem when talking directly to http xend</li> <li>Fix reconnection problem when talking directly to http xend</li>
</ul><h3>0.1.5: Sep 5 2006</h3><ul><li>Support for new hypercalls change in Xen changeset 86d26e6ec89b</li> </ul><h3>0.1.5: Sep 5 2006</h3><ul><li>Support for new hypercalls change in Xen changeset 86d26e6ec89b</li>
<li>bug fixes: virParseUUID() was wrong, netwoking for paravirt guestsi <li>bug fixes: virParseUUID() was wrong, netwoking for paravirt
(Daniel Berrange), virsh on non-existent domains (Daniel Berrange), guestsi(Daniel Berrange), virsh on non-existent domains (Daniel
string cast bug when handling error in python (Pete Vetere), HTTP Berrange),string cast bug when handling error in python (Pete Vetere),
500 xend error code handling (Pete Vetere and Daniel Berrange)</li> HTTP500 xend error code handling (Pete Vetere and Daniel Berrange)</li>
<li>improvements: test suite for SEXPR &lt;-&gt; XML format conversions (Daniel <li>improvements: test suite for SEXPR &lt;-&gt; XML format conversions
Berrange), virsh output regression suite (Daniel Berrange), new environ (DanielBerrange), virsh output regression suite (Daniel Berrange), new
variable VIRSH_DEFAULT_CONNECT_URI for the default URI when connecting environvariable VIRSH_DEFAULT_CONNECT_URI for the default URI when
(Daniel Berrange), graphical console support for paravirt guests connecting(Daniel Berrange), graphical console support for paravirt
(Jeremy Katz), parsing of simple Xen config files (with Daniel Berrange), guests(Jeremy Katz), parsing of simple Xen config files (with Daniel
early work on defined (not running) domains (Daniel Berrange), Berrange),early work on defined (not running) domains (Daniel
virsh output improvement (Daniel Berrange</li> Berrange),virsh output improvement (Daniel Berrange</li>
</ul><h3>0.1.4: Aug 16 2006</h3><ul><li>bug fixes: spec file fix (Mark McLoughlin), error report problem (with </ul><h3>0.1.4: Aug 16 2006</h3><ul><li>bug fixes: spec file fix (Mark McLoughlin), error report problem
Hugh Brock), long integer in Python bindings (with Daniel Berrange), XML (withHugh Brock), long integer in Python bindings (with Daniel Berrange),
generation bug for CDRom (Daniel Berrange), bug whem using number() XPath XMLgeneration bug for CDRom (Daniel Berrange), bug whem using number()
function (Mark McLoughlin), fix python detection code, remove duplicate XPathfunction (Mark McLoughlin), fix python detection code, remove
initialization errors (Daniel Berrange)</li> duplicateinitialization errors (Daniel Berrange)</li>
<li>improvements: UUID in XML description (Peter Vetere), proxy code <li>improvements: UUID in XML description (Peter Vetere), proxy
cleanup, virtual CPU and affinity support + virsh support (Michel codecleanup, virtual CPU and affinity support + virsh support
Ponceau, Philippe Berthault, Daniel Berrange), port and tty informations (MichelPonceau, Philippe Berthault, Daniel Berrange), port and tty
for console in XML (Daniel Berrange), added XML dump to driver and proxy informationsfor console in XML (Daniel Berrange), added XML dump to
support (Daniel Berrange), extention of boot options with support for driver and proxysupport (Daniel Berrange), extention of boot options with
floppy and cdrom (Daniel Berrange), features block in XML to report/ask support forfloppy and cdrom (Daniel Berrange), features block in XML to
PAE, ACPI, APIC for HVM domains (Daniel Berrange), fail saide-effect report/askPAE, ACPI, APIC for HVM domains (Daniel Berrange), fail
operations when using read-only connection, large improvements to test saide-effectoperations when using read-only connection, large
driver (Daniel Berrange) </li> improvements to testdriver (Daniel Berrange)</li>
<li>documentation: spelling (Daniel Berrange), test driver examples.</li> <li>documentation: spelling (Daniel Berrange), test driver examples.</li>
</ul><h3>0.1.3: Jul 11 2006</h3><ul><li>bugfixes: build as non-root, fix xend access when root, handling of </ul><h3>0.1.3: Jul 11 2006</h3><ul><li>bugfixes: build as non-root, fix xend access when root, handling
empty XML elements (Mark McLoughlin), XML serialization and parsing fixes ofempty XML elements (Mark McLoughlin), XML serialization and parsing
(Mark McLoughlin), allow to create domains without disk (Mark fixes(Mark McLoughlin), allow to create domains without disk
McLoughlin),</li> (MarkMcLoughlin),</li>
<li>improvement: xenDaemonLookupByID from O(n^2) to O(n) (Daniel Berrange), <li>improvement: xenDaemonLookupByID from O(n^2) to O(n) (Daniel
support for fully virtualized guest (Jim Fehlig, DV, Mark McLoughlin)</li> Berrange),support for fully virtualized guest (Jim Fehlig, DV, Mark
McLoughlin)</li>
<li>documentation: augmented to cover hvm domains</li> <li>documentation: augmented to cover hvm domains</li>
</ul><h3>0.1.2: Jul 3 2006</h3><ul><li>headers include paths fixup</li> </ul><h3>0.1.2: Jul 3 2006</h3><ul><li>headers include paths fixup</li>
<li>proxy mechanism for unpriviledged read-only access by httpu</li> <li>proxy mechanism for unpriviledged read-only access by httpu</li>
</ul><h3>0.1.1: Jun 21 2006</h3><ul><li>building fixes: ncurses fallback (Jim Fehlig), VPATH builds (Daniel P. </ul><h3>0.1.1: Jun 21 2006</h3><ul><li>building fixes: ncurses fallback (Jim Fehlig), VPATH builds (Daniel
Berrange)</li> P.Berrange)</li>
<li>driver cleanups: new entry points, cleanup of libvirt.c (with Daniel P. <li>driver cleanups: new entry points, cleanup of libvirt.c (with Daniel
Berrange)</li> P.Berrange)</li>
<li>Cope with API change introduced in Xen changeset 10277</li> <li>Cope with API change introduced in Xen changeset 10277</li>
<li>new test driver for regression checks (Daniel P. Berrange)</li> <li>new test driver for regression checks (Daniel P. Berrange)</li>
<li>improvements: added UUID to XML serialization, buffer usage (Karel <li>improvements: added UUID to XML serialization, buffer usage (KarelZak),
Zak), --connect argument to virsh (Daniel P. Berrange),</li> --connect argument to virsh (Daniel P. Berrange),</li>
<li>bug fixes: uninitialized memory access in error reporting, S-Expr <li>bug fixes: uninitialized memory access in error reporting,
parsing (Jim Fehlig, Jeremy Katz), virConnectOpen bug, remove a TODO in S-Exprparsing (Jim Fehlig, Jeremy Katz), virConnectOpen bug, remove a
xs_internal.c</li> TODO inxs_internal.c</li>
<li>documentation: Python examples (David Lutterkort), new Perl binding <li>documentation: Python examples (David Lutterkort), new Perl bindingURL,
URL, man page update (Karel Zak)</li> man page update (Karel Zak)</li>
</ul><h3>0.1.0: Apr 10 2006</h3><ul><li>building fixes: --with-xen-distdir option (Ronald Aigner), out of tree </ul><h3>0.1.0: Apr 10 2006</h3><ul><li>building fixes: --with-xen-distdir option (Ronald Aigner), out of
build and pkginfo cflag fix (Daniel Berrange)</li> treebuild and pkginfo cflag fix (Daniel Berrange)</li>
<li>enhancement and fixes of the XML description format (David Lutterkort <li>enhancement and fixes of the XML description format (David
and Jim Fehlig)</li> Lutterkortand Jim Fehlig)</li>
<li>new APIs: for Node information and Reboot</li> <li>new APIs: for Node information and Reboot</li>
<li>internal code cleanup: refactoring internals into a driver model, more <li>internal code cleanup: refactoring internals into a driver model,
error handling, structure sharing, thread safety and ref counting</li> moreerror handling, structure sharing, thread safety and ref counting</li>
<li>bug fixes: error message (Jim Meyering), error allocation in virsh (Jim <li>bug fixes: error message (Jim Meyering), error allocation in virsh
Meyering), virDomainLookupByID (Jim Fehlig),</li> (JimMeyering), virDomainLookupByID (Jim Fehlig),</li>
<li>documentation: updates on architecture, and format, typo fix (Jim <li>documentation: updates on architecture, and format, typo fix
Meyering)</li> (JimMeyering)</li>
<li>bindings: exception handling in examples (Jim Meyering), perl ones out <li>bindings: exception handling in examples (Jim Meyering), perl ones
of tree (Daniel Berrange)</li> outof tree (Daniel Berrange)</li>
<li>virsh: more options, create, nodeinfo (Karel Zak), renaming of some <li>virsh: more options, create, nodeinfo (Karel Zak), renaming of
options (Karel Zak), use stderr only for errors (Karel Zak), man page someoptions (Karel Zak), use stderr only for errors (Karel Zak), man
(Andrew Puch)</li> page(Andrew Puch)</li>
</ul><h3>0.0.6: Feb 28 2006</h3><ul><li>add UUID lookup and extract API</li> </ul><h3>0.0.6: Feb 28 2006</h3><ul><li>add UUID lookup and extract API</li>
<li>add error handling APIs both synchronous and asynchronous</li> <li>add error handling APIs both synchronous and asynchronous</li>
<li>added minimal hook for error handling at the python level, improved the <li>added minimal hook for error handling at the python level, improved
python bindings</li> thepython bindings</li>
<li>augment the documentation and tests to cover error handling</li> <li>augment the documentation and tests to cover error handling</li>
</ul><h3>0.0.5: Feb 23 2006</h3><ul><li>Added XML description parsing, dependance to libxml2, implemented the </ul><h3>0.0.5: Feb 23 2006</h3><ul><li>Added XML description parsing, dependance to libxml2, implemented
creation API virDomainCreateLinux()</li> thecreation API virDomainCreateLinux()</li>
<li>new APIs to lookup and name domain by UUID</li> <li>new APIs to lookup and name domain by UUID</li>
<li>fixed the XML dump when using the Xend access</li> <li>fixed the XML dump when using the Xend access</li>
<li>Fixed a few more problem related to the name change</li> <li>Fixed a few more problem related to the name change</li>
<li>Adding regression tests in python and examples in C</li> <li>Adding regression tests in python and examples in C</li>
<li>web site improvement, extended the documentation to cover the XML <li>web site improvement, extended the documentation to cover the XMLformat
format and Python API</li> and Python API</li>
<li>Added devhelp help for Gnome/Gtk programmers</li> <li>Added devhelp help for Gnome/Gtk programmers</li>
</ul><h3>0.0.4: Feb 10 2006</h3><ul><li>Fix various bugs introduced in the name change</li> </ul><h3>0.0.4: Feb 10 2006</h3><ul><li>Fix various bugs introduced in the name change</li>
</ul><h3>0.0.3: Feb 9 2006</h3><ul><li>Switch name from from 'libvir' to libvirt</li> </ul><h3>0.0.3: Feb 9 2006</h3><ul><li>Switch name from from 'libvir' to libvirt</li>
<li>Starting infrastructure to add code examples</li> <li>Starting infrastructure to add code examples</li>
<li>Update of python bindings for completeness</li> <li>Update of python bindings for completeness</li>
</ul><h3>0.0.2: Jan 29 2006</h3><ul><li>Update of the documentation, web site redesign (Diana Fong)</li> </ul><h3>0.0.2: Jan 29 2006</h3><ul><li>Update of the documentation, web site redesign (Diana Fong)</li>
<li>integration of HTTP xend RPC based on libxend by Anthony Liquori for <li>integration of HTTP xend RPC based on libxend by Anthony Liquori
most operations</li> formost operations</li>
<li>Adding Save and Restore APIs</li> <li>Adding Save and Restore APIs</li>
<li>extended the virsh command line tool (Karel Zak)</li> <li>extended the virsh command line tool (Karel Zak)</li>
<li>remove xenstore transactions (Anthony Liguori)</li> <li>remove xenstore transactions (Anthony Liguori)</li>

57
docs/python.html
View File

@ -1,32 +1,33 @@
<?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>Binding for Python</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">Binding for Python</h1><p>Libvirt comes with direct support for the Python language (just make sure <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>Binding for Python</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">Binding for Python</h1><p>Libvirt comes with direct support for the Python language (just make
you installed the libvirt-python package if not compiling from sources). Also sureyou installed the libvirt-python package if not compiling from sources).
note that Daniel Berrange provides <a href="http://search.cpan.org/~danberr/Sys-Virt-0.1.0/">bindings for Perl</a> Alsonote that Daniel Berrange provides <a href="http://search.cpan.org/~danberr/Sys-Virt-0.1.0/">bindings for
too.</p><p>The Python binding should be complete and are mostly automatically Perl</a>too.</p><p>The Python binding should be complete and are mostly
generated from the formal description of the API in xml. The bindings are automaticallygenerated from the formal description of the API in xml. The
articulated around 2 classes <code>virConnect</code> and virDomain mapping to bindings arearticulated around 2 classes <code>virConnect</code>and virDomain
the C types. Functions in the C API taking either type as argument then mapping tothe C types. Functions in the C API taking either type as argument
becomes methods for the classes, their name is just stripped from the thenbecomes methods for the classes, their name is just stripped from
virConnect or virDomain(Get) prefix and the first letter gets converted to thevirConnect or virDomain(Get) prefix and the first letter gets converted
lower case, for example the C functions:</p><p><code>int <a href="html/libvirt-libvirt.html#virConnectNumOfDomains">virConnectNumOfDomains</a> tolower case, for example the C functions:</p><p><code>int <a href="html/libvirt-libvirt.html#virConnectNumOfDomains">virConnectNumOfDomains</a>(virConnectPtr
(virConnectPtr conn);</code></p><p><code>int <a href="html/libvirt-libvirt.html#virDomainSetMaxMemory">virDomainSetMaxMemory</a> conn);</code></p><p><code>int <a href="html/libvirt-libvirt.html#virDomainSetMaxMemory">virDomainSetMaxMemory</a>(virDomainPtr
(virDomainPtr domain, unsigned long memory);</code></p><p>become</p><p><code>virConn::numOfDomains(self)</code></p><p><code>virDomain::setMaxMemory(self, memory)</code></p><p>This process is fully automated, you can get a summary of the conversion domain, unsigned long memory);</code></p><p>become</p><p><code>virConn::numOfDomains(self)</code></p><p><code>virDomain::setMaxMemory(self, memory)</code></p><p>This process is fully automated, you can get a summary of the conversionin
in the file libvirtclass.txt present in the python dir or in the docs.There the file libvirtclass.txt present in the python dir or in the docs.Thereis a
is a couple of function who don't map directly to their C counterparts due to couple of function who don't map directly to their C counterparts due
specificities in their argument conversions:</p><ul><li><code><a href="html/libvirt-libvirt.html#virConnectListDomains">virConnectListDomains</a></code> tospecificities in their argument conversions:</p><ul><li><code><a href="html/libvirt-libvirt.html#virConnectListDomains">virConnectListDomains</a></code>is
is replaced by <code>virDomain::listDomainsID(self)</code> which returns replaced by <code>virDomain::listDomainsID(self)</code>which returnsa
a list of the integer ID for the currently running domains</li> list of the integer ID for the currently running domains</li>
<li><code><a href="html/libvirt-libvirt.html#virDomainGetInfo">virDomainGetInfo</a></code> <li><code><a href="html/libvirt-libvirt.html#virDomainGetInfo">virDomainGetInfo</a></code>is
is replaced by <code>virDomain::info()</code> which returns a list of replaced by <code>virDomain::info()</code>which returns a list of
<ol><li>state: one of the state values (virDomainState)</li> <ol><li>state: one of the state values (virDomainState)</li>
<li>maxMemory: the maximum memory used by the domain</li> <li>maxMemory: the maximum memory used by the domain</li>
<li>memory: the current amount of memory used by the domain</li> <li>memory: the current amount of memory used by the domain</li>
<li>nbVirtCPU: the number of virtual CPU</li> <li>nbVirtCPU: the number of virtual CPU</li>
<li>cpuTime: the time used by the domain in nanoseconds</li> <li>cpuTime: the time used by the domain in nanoseconds</li>
</ol></li> </ol></li>
</ul><p>So let's look at a simple example inspired from the <code>basic.py</code> </ul><p>So let's look at a simple example inspired from the
test found in <code>python/tests/</code> in the source tree:</p><pre>import <span style="color: #0071FF; background-color: #FFFFFF">libvirt</span> <code>basic.py</code>test found in <code>python/tests/</code>in the source
tree:</p><pre>import <span style="color: #0071FF; background-color: #FFFFFF">libvirt</span>
import sys import sys
conn = <span style="color: #0071FF; background-color: #FFFFFF">libvirt</span>.openReadOnly(None) conn = <span style="color: #0071FF; background-color: #FFFFFF">libvirt</span>.openReadOnly(None)
@ -41,13 +42,13 @@ except:
sys.exit(1) sys.exit(1)
print "Domain 0: id %d running %s" % (dom0.<span style="color: #FF0080; background-color: #FFFFFF">ID</span>(), dom0.<span style="color: #FF0080; background-color: #FFFFFF">OSType</span>()) print "Domain 0: id %d running %s" % (dom0.<span style="color: #FF0080; background-color: #FFFFFF">ID</span>(), dom0.<span style="color: #FF0080; background-color: #FFFFFF">OSType</span>())
print dom0.<span style="color: #FF0080; background-color: #FFFFFF">info</span>()</pre><p>There is not much to comment about it, it really is a straight mapping print dom0.<span style="color: #FF0080; background-color: #FFFFFF">info</span>()</pre><p>There is not much to comment about it, it really is a straight mappingfrom
from the C API, the only points to notice are:</p><ul><li>the import of the module called <code><span style="color: #0071FF; background-color: #FFFFFF">libvirt</span></code></li> the C API, the only points to notice are:</p><ul><li>the import of the module called <code><span style="color: #0071FF; background-color: #FFFFFF">libvirt</span></code></li>
<li>getting a connection to the hypervisor, in that case using the <li>getting a connection to the hypervisor, in that case using
openReadOnly function allows the code to execute as a normal user.</li> theopenReadOnly 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 informations about the domain usingvarious
various <span style="color: #E50073; background-color: #FFFFFF">methods</span> <span style="color: #E50073; background-color: #FFFFFF">methods</span>associated
associated to the virDomain class.</li> 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">Binding for Python</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="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://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">Binding for Python</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="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://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>

9
include/libvirt/libvirt.h
View File

@ -188,7 +188,7 @@ struct _virNodeInfo {
typedef virNodeInfo *virNodeInfoPtr; typedef virNodeInfo *virNodeInfoPtr;
/** /**
* VIR_UUID_STRING_BUFLEN: * VIR_UUID_BUFLEN:
* *
* This macro provides the length of the buffer required * This macro provides the length of the buffer required
* for virDomainGetUUID() * for virDomainGetUUID()
@ -231,10 +231,15 @@ int virConnectClose (virConnectPtr conn);
const char * virConnectGetType (virConnectPtr conn); const char * virConnectGetType (virConnectPtr conn);
int virConnectGetVersion (virConnectPtr conn, int virConnectGetVersion (virConnectPtr conn,
unsigned long *hvVer); unsigned long *hvVer);
int virConnectGetMaxVcpus (virConnectPtr conn, /*
* Capabilities of the connection / driver.
*/
int virConnectGetMaxVcpus (virConnectPtr conn,
const char *type); const char *type);
int virNodeGetInfo (virConnectPtr conn, int virNodeGetInfo (virConnectPtr conn,
virNodeInfoPtr info); virNodeInfoPtr info);
char * virConnectGetCapabilities (virConnectPtr conn);
/* /*
* Gather list of running domains * Gather list of running domains

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

@ -188,7 +188,7 @@ struct _virNodeInfo {
typedef virNodeInfo *virNodeInfoPtr; typedef virNodeInfo *virNodeInfoPtr;
/** /**
* VIR_UUID_STRING_BUFLEN: * VIR_UUID_BUFLEN:
* *
* This macro provides the length of the buffer required * This macro provides the length of the buffer required
* for virDomainGetUUID() * for virDomainGetUUID()
@ -231,10 +231,15 @@ int virConnectClose (virConnectPtr conn);
const char * virConnectGetType (virConnectPtr conn); const char * virConnectGetType (virConnectPtr conn);
int virConnectGetVersion (virConnectPtr conn, int virConnectGetVersion (virConnectPtr conn,
unsigned long *hvVer); unsigned long *hvVer);
int virConnectGetMaxVcpus (virConnectPtr conn, /*
* Capabilities of the connection / driver.
*/
int virConnectGetMaxVcpus (virConnectPtr conn,
const char *type); const char *type);
int virNodeGetInfo (virConnectPtr conn, int virNodeGetInfo (virConnectPtr conn,
virNodeInfoPtr info); virNodeInfoPtr info);
char * virConnectGetCapabilities (virConnectPtr conn);
/* /*
* Gather list of running domains * Gather list of running domains

3
include/libvirt/virterror.h
View File

@ -119,6 +119,7 @@ typedef enum {
VIR_ERR_XML_DETAIL, /* detail of an XML error */ VIR_ERR_XML_DETAIL, /* detail of an XML error */
VIR_ERR_INVALID_NETWORK, /* invalid network object */ VIR_ERR_INVALID_NETWORK, /* invalid network object */
VIR_ERR_NETWORK_EXIST, /* the network already exist */ VIR_ERR_NETWORK_EXIST, /* the network already exist */
VIR_ERR_SYSTEM_ERROR, /* general system call failure */
} virErrorNumber; } virErrorNumber;
/** /**
@ -133,7 +134,7 @@ typedef void (*virErrorFunc) (void *userData, virErrorPtr error);
/* /*
* Errors can be handled as asynchronous callbacks or after the routine * Errors can be handled as asynchronous callbacks or after the routine
* failed. They can also be handled globally at the library level, or * failed. They can also be handled globally at the library level, or
* at the connection level (which then has priority * at the connection level (which then has priority).
*/ */
virErrorPtr virGetLastError (void); virErrorPtr virGetLastError (void);

15
proxy/libvirt_proxy.c
View File

@ -788,9 +788,24 @@ int main(int argc, char **argv) {
proxyCloseUnixSocket(); proxyCloseUnixSocket();
exit(0); exit(0);
} }
#else /* WITHOUT_XEN */ #else /* WITHOUT_XEN */
int main(void) { int main(void) {
fprintf(stderr, "libvirt was compiled without Xen support\n"); fprintf(stderr, "libvirt was compiled without Xen support\n");
exit(1); exit(1);
} }
#endif /* WITH_XEN */ #endif /* WITH_XEN */
/*
* vim: set tabstop=4:
* vim: set shiftwidth=4:
* vim: set expandtab:
*/
/*
* Local variables:
* indent-tabs-mode: nil
* c-indent-level: 4
* c-basic-offset: 4
* tab-width: 4
* End:
*/

3
qemud/Makefile.am
View File

@ -11,7 +11,8 @@ libvirt_qemud_SOURCES = qemud.c internal.h protocol.h \
conf.c conf.h \ conf.c conf.h \
bridge.c bridge.h \ bridge.c bridge.h \
iptables.c iptables.h \ iptables.c iptables.h \
uuid.c uuid.h uuid.c uuid.h \
buf.c buf.h
#-D_XOPEN_SOURCE=600 -D_XOPEN_SOURCE_EXTENDED=1 -D_POSIX_C_SOURCE=199506L #-D_XOPEN_SOURCE=600 -D_XOPEN_SOURCE_EXTENDED=1 -D_POSIX_C_SOURCE=199506L
libvirt_qemud_CFLAGS = \ libvirt_qemud_CFLAGS = \
-I$(top_srcdir)/include -I$(top_builddir)/include $(LIBXML_CFLAGS) \ -I$(top_srcdir)/include -I$(top_builddir)/include $(LIBXML_CFLAGS) \

237
qemud/conf.c
View File

@ -46,6 +46,7 @@
#include "driver.h" #include "driver.h"
#include "iptables.h" #include "iptables.h"
#include "uuid.h" #include "uuid.h"
#include "buf.h"
/* Free all memory associated with a struct qemud_vm object */ /* Free all memory associated with a struct qemud_vm object */
void qemudFreeVMDef(struct qemud_vm_def *def) { void qemudFreeVMDef(struct qemud_vm_def *def) {
@ -122,49 +123,46 @@ qemudEnsureDir(const char *path)
return 0; return 0;
} }
struct qemu_arch_info {
const char *arch;
const char **machines;
const char *binary;
};
/* The list of possible machine types for various architectures, /* The list of possible machine types for various architectures,
as supported by QEMU - taken from 'qemu -M ?' for each arch */ as supported by QEMU - taken from 'qemu -M ?' for each arch */
static const char *arch_info_x86_machines[] = { static const char *arch_info_x86_machines[] = {
"pc", "isapc" "pc", "isapc", NULL
}; };
static const char *arch_info_mips_machines[] = { static const char *arch_info_mips_machines[] = {
"mips" "mips", NULL
}; };
static const char *arch_info_sparc_machines[] = { static const char *arch_info_sparc_machines[] = {
"sun4m" "sun4m", NULL
}; };
static const char *arch_info_ppc_machines[] = { static const char *arch_info_ppc_machines[] = {
"g3bw", "mac99", "prep" "g3bw", "mac99", "prep", NULL
}; };
/* The archicture tables for supported QEMU archs */ /* The archicture tables for supported QEMU archs */
static struct qemu_arch_info archs[] = { struct qemu_arch_info qemudArchs[] = {
{ "i686", arch_info_x86_machines, "qemu" }, /* i686 must be in position 0 */
{ "x86_64", arch_info_x86_machines, "qemu-system-x86_64" }, { "i686", 32, arch_info_x86_machines, "qemu" },
{ "mips", arch_info_mips_machines, "qemu-system-mips" }, /* x86_64 must be in position 1 */
{ "mipsel", arch_info_mips_machines, "qemu-system-mipsel" }, { "x86_64", 64, arch_info_x86_machines, "qemu-system-x86_64" },
{ "sparc", arch_info_sparc_machines, "qemu-system-sparc" }, { "mips", 32, arch_info_mips_machines, "qemu-system-mips" },
{ "ppc", arch_info_ppc_machines, "qemu-system-ppc" }, { "mipsel", 32, arch_info_mips_machines, "qemu-system-mipsel" },
{ "sparc", 32, arch_info_sparc_machines, "qemu-system-sparc" },
{ "ppc", 32, arch_info_ppc_machines, "qemu-system-ppc" },
{ NULL, -1, NULL, NULL }
}; };
/* Return the default architecture if none is explicitly requested*/ /* Return the default architecture if none is explicitly requested*/
static const char *qemudDefaultArch(void) { static const char *qemudDefaultArch(void) {
return archs[0].arch; return qemudArchs[0].arch;
} }
/* Return the default machine type for a given architecture */ /* Return the default machine type for a given architecture */
static const char *qemudDefaultMachineForArch(const char *arch) { static const char *qemudDefaultMachineForArch(const char *arch) {
int i; int i;
for (i = 0 ; i < (int)(sizeof(archs) / sizeof(struct qemu_arch_info)) ; i++) { for (i = 0; qemudArchs[i].arch; i++) {
if (!strcmp(archs[i].arch, arch)) { if (!strcmp(qemudArchs[i].arch, arch)) {
return archs[i].machines[0]; return qemudArchs[i].machines[0];
} }
} }
@ -175,9 +173,9 @@ static const char *qemudDefaultMachineForArch(const char *arch) {
static const char *qemudDefaultBinaryForArch(const char *arch) { static const char *qemudDefaultBinaryForArch(const char *arch) {
int i; int i;
for (i = 0 ; i < (int)(sizeof(archs) / sizeof(struct qemu_arch_info)) ; i++) { for (i = 0 ; qemudArchs[i].arch; i++) {
if (!strcmp(archs[i].arch, arch)) { if (!strcmp(qemudArchs[i].arch, arch)) {
return archs[i].binary; return qemudArchs[i].binary;
} }
} }
@ -2354,72 +2352,20 @@ int qemudScanConfigs(struct qemud_server *server) {
return 0; return 0;
} }
/* Simple grow-on-demand string buffer */
/* XXX re-factor to shared library */
struct qemudBuffer {
char *data;
int len;
int used;
};
static
int qemudBufferAdd(struct qemudBuffer *buf, const char *str) {
int need = strlen(str);
if ((need+1) > (buf->len-buf->used)) {
return -1;
}
memcpy(buf->data + buf->used, str, need+1);
buf->used += need;
return 0;
}
static
int qemudBufferPrintf(struct qemudBuffer *buf,
const char *format, ...) {
int size, count;
va_list locarg, argptr;
if ((format == NULL) || (buf == NULL)) {
return -1;
}
size = buf->len - buf->used - 1;
va_start(argptr, format);
va_copy(locarg, argptr);
if ((count = vsnprintf(&buf->data[buf->used],
size,
format,
locarg)) >= size) {
return -1;
}
va_end(locarg);
buf->used += count;
buf->data[buf->used] = '\0';
return 0;
}
/* Generate an XML document describing the guest's configuration */ /* Generate an XML document describing the guest's configuration */
char *qemudGenerateXML(struct qemud_server *server, char *qemudGenerateXML(struct qemud_server *server,
struct qemud_vm *vm, struct qemud_vm *vm,
struct qemud_vm_def *def, struct qemud_vm_def *def,
int live) { int live) {
struct qemudBuffer buf; bufferPtr buf = 0;
unsigned char *uuid; unsigned char *uuid;
struct qemud_vm_disk_def *disk; struct qemud_vm_disk_def *disk;
struct qemud_vm_net_def *net; struct qemud_vm_net_def *net;
const char *type = NULL; const char *type = NULL;
int n; int n;
buf.len = QEMUD_MAX_XML_LEN; buf = bufferNew (QEMUD_MAX_XML_LEN);
buf.used = 0; if (!buf)
buf.data = malloc(buf.len);
if (!buf.data)
goto no_memory; goto no_memory;
switch (def->virtType) { switch (def->virtType) {
@ -2439,50 +2385,50 @@ char *qemudGenerateXML(struct qemud_server *server,
} }
if (qemudIsActiveVM(vm) && live) { if (qemudIsActiveVM(vm) && live) {
if (qemudBufferPrintf(&buf, "<domain type='%s' id='%d'>\n", type, vm->id) < 0) if (bufferVSprintf(buf, "<domain type='%s' id='%d'>\n", type, vm->id) < 0)
goto no_memory; goto no_memory;
} else { } else {
if (qemudBufferPrintf(&buf, "<domain type='%s'>\n", type) < 0) if (bufferVSprintf(buf, "<domain type='%s'>\n", type) < 0)
goto no_memory; goto no_memory;
} }
if (qemudBufferPrintf(&buf, " <name>%s</name>\n", def->name) < 0) if (bufferVSprintf(buf, " <name>%s</name>\n", def->name) < 0)
goto no_memory; goto no_memory;
uuid = def->uuid; uuid = def->uuid;
if (qemudBufferPrintf(&buf, " <uuid>%02x%02x%02x%02x-%02x%02x-%02x%02x-%02x%02x-%02x%02x%02x%02x%02x%02x</uuid>\n", if (bufferVSprintf(buf, " <uuid>%02x%02x%02x%02x-%02x%02x-%02x%02x-%02x%02x-%02x%02x%02x%02x%02x%02x</uuid>\n",
uuid[0], uuid[1], uuid[2], uuid[3], uuid[0], uuid[1], uuid[2], uuid[3],
uuid[4], uuid[5], uuid[6], uuid[7], uuid[4], uuid[5], uuid[6], uuid[7],
uuid[8], uuid[9], uuid[10], uuid[11], uuid[8], uuid[9], uuid[10], uuid[11],
uuid[12], uuid[13], uuid[14], uuid[15]) < 0) uuid[12], uuid[13], uuid[14], uuid[15]) < 0)
goto no_memory; goto no_memory;
if (qemudBufferPrintf(&buf, " <memory>%d</memory>\n", def->maxmem) < 0) if (bufferVSprintf(buf, " <memory>%d</memory>\n", def->maxmem) < 0)
goto no_memory; goto no_memory;
if (qemudBufferPrintf(&buf, " <currentMemory>%d</currentMemory>\n", def->memory) < 0) if (bufferVSprintf(buf, " <currentMemory>%d</currentMemory>\n", def->memory) < 0)
goto no_memory; goto no_memory;
if (qemudBufferPrintf(&buf, " <vcpu>%d</vcpu>\n", def->vcpus) < 0) if (bufferVSprintf(buf, " <vcpu>%d</vcpu>\n", def->vcpus) < 0)
goto no_memory; goto no_memory;
if (qemudBufferAdd(&buf, " <os>\n") < 0) if (bufferAdd(buf, " <os>\n", -1) < 0)
goto no_memory; goto no_memory;
if (def->virtType == QEMUD_VIRT_QEMU) { if (def->virtType == QEMUD_VIRT_QEMU) {
if (qemudBufferPrintf(&buf, " <type arch='%s' machine='%s'>%s</type>\n", if (bufferVSprintf(buf, " <type arch='%s' machine='%s'>%s</type>\n",
def->os.arch, def->os.machine, def->os.type) < 0) def->os.arch, def->os.machine, def->os.type) < 0)
goto no_memory; goto no_memory;
} else { } else {
if (qemudBufferPrintf(&buf, " <type>%s</type>\n", def->os.type) < 0) if (bufferVSprintf(buf, " <type>%s</type>\n", def->os.type) < 0)
goto no_memory; goto no_memory;
} }
if (def->os.kernel[0]) if (def->os.kernel[0])
if (qemudBufferPrintf(&buf, " <kernel>%s</kernel>\n", def->os.kernel) < 0) if (bufferVSprintf(buf, " <kernel>%s</kernel>\n", def->os.kernel) < 0)
goto no_memory; goto no_memory;
if (def->os.initrd[0]) if (def->os.initrd[0])
if (qemudBufferPrintf(&buf, " <initrd>%s</initrd>\n", def->os.initrd) < 0) if (bufferVSprintf(buf, " <initrd>%s</initrd>\n", def->os.initrd) < 0)
goto no_memory; goto no_memory;
if (def->os.cmdline[0]) if (def->os.cmdline[0])
if (qemudBufferPrintf(&buf, " <cmdline>%s</cmdline>\n", def->os.cmdline) < 0) if (bufferVSprintf(buf, " <cmdline>%s</cmdline>\n", def->os.cmdline) < 0)
goto no_memory; goto no_memory;
for (n = 0 ; n < def->os.nBootDevs ; n++) { for (n = 0 ; n < def->os.nBootDevs ; n++) {
@ -2501,27 +2447,27 @@ char *qemudGenerateXML(struct qemud_server *server,
boottype = "net"; boottype = "net";
break; break;
} }
if (qemudBufferPrintf(&buf, " <boot dev='%s'/>\n", boottype) < 0) if (bufferVSprintf(buf, " <boot dev='%s'/>\n", boottype) < 0)
goto no_memory; goto no_memory;
} }
if (qemudBufferAdd(&buf, " </os>\n") < 0) if (bufferAdd(buf, " </os>\n", -1) < 0)
goto no_memory; goto no_memory;
if (def->features & QEMUD_FEATURE_ACPI) { if (def->features & QEMUD_FEATURE_ACPI) {
if (qemudBufferAdd(&buf, " <features>\n") < 0) if (bufferAdd(buf, " <features>\n", -1) < 0)
goto no_memory; goto no_memory;
if (qemudBufferAdd(&buf, " <acpi/>\n") < 0) if (bufferAdd(buf, " <acpi/>\n", -1) < 0)
goto no_memory; goto no_memory;
if (qemudBufferAdd(&buf, " </features>\n") < 0) if (bufferAdd(buf, " </features>\n", -1) < 0)
goto no_memory; goto no_memory;
} }
if (qemudBufferAdd(&buf, " <devices>\n") < 0) if (bufferAdd(buf, " <devices>\n", -1) < 0)
goto no_memory; goto no_memory;
if (qemudBufferPrintf(&buf, " <emulator>%s</emulator>\n", def->os.binary) < 0) if (bufferVSprintf(buf, " <emulator>%s</emulator>\n", def->os.binary) < 0)
goto no_memory; goto no_memory;
disk = def->disks; disk = def->disks;
@ -2539,21 +2485,21 @@ char *qemudGenerateXML(struct qemud_server *server,
"cdrom", "cdrom",
"floppy", "floppy",
}; };
if (qemudBufferPrintf(&buf, " <disk type='%s' device='%s'>\n", if (bufferVSprintf(buf, " <disk type='%s' device='%s'>\n",
types[disk->type], devices[disk->device]) < 0) types[disk->type], devices[disk->device]) < 0)
goto no_memory; goto no_memory;
if (qemudBufferPrintf(&buf, " <source %s='%s'/>\n", typeAttrs[disk->type], disk->src) < 0) if (bufferVSprintf(buf, " <source %s='%s'/>\n", typeAttrs[disk->type], disk->src) < 0)
goto no_memory; goto no_memory;
if (qemudBufferPrintf(&buf, " <target dev='%s'/>\n", disk->dst) < 0) if (bufferVSprintf(buf, " <target dev='%s'/>\n", disk->dst) < 0)
goto no_memory; goto no_memory;
if (disk->readonly) if (disk->readonly)
if (qemudBufferAdd(&buf, " <readonly/>\n") < 0) if (bufferAdd(buf, " <readonly/>\n", -1) < 0)
goto no_memory; goto no_memory;
if (qemudBufferPrintf(&buf, " </disk>\n") < 0) if (bufferVSprintf(buf, " </disk>\n") < 0)
goto no_memory; goto no_memory;
disk = disk->next; disk = disk->next;
@ -2570,42 +2516,42 @@ char *qemudGenerateXML(struct qemud_server *server,
"network", "network",
"bridge", "bridge",
}; };
if (qemudBufferPrintf(&buf, " <interface type='%s'>\n", if (bufferVSprintf(buf, " <interface type='%s'>\n",
types[net->type]) < 0) types[net->type]) < 0)
goto no_memory; goto no_memory;
if (qemudBufferPrintf(&buf, " <mac address='%02x:%02x:%02x:%02x:%02x:%02x'/>\n", if (bufferVSprintf(buf, " <mac address='%02x:%02x:%02x:%02x:%02x:%02x'/>\n",
net->mac[0], net->mac[1], net->mac[2], net->mac[0], net->mac[1], net->mac[2],
net->mac[3], net->mac[4], net->mac[5]) < 0) net->mac[3], net->mac[4], net->mac[5]) < 0)
goto no_memory; goto no_memory;
switch (net->type) { switch (net->type) {
case QEMUD_NET_NETWORK: case QEMUD_NET_NETWORK:
if (qemudBufferPrintf(&buf, " <source network='%s'/>\n", net->dst.network.name) < 0) if (bufferVSprintf(buf, " <source network='%s'/>\n", net->dst.network.name) < 0)
goto no_memory; goto no_memory;
if (net->dst.network.ifname[0] != '\0') { if (net->dst.network.ifname[0] != '\0') {
if (qemudBufferPrintf(&buf, " <target dev='%s'/>\n", net->dst.network.ifname) < 0) if (bufferVSprintf(buf, " <target dev='%s'/>\n", net->dst.network.ifname) < 0)
goto no_memory; goto no_memory;
} }
break; break;
case QEMUD_NET_ETHERNET: case QEMUD_NET_ETHERNET:
if (net->dst.ethernet.ifname[0] != '\0') { if (net->dst.ethernet.ifname[0] != '\0') {
if (qemudBufferPrintf(&buf, " <target dev='%s'/>\n", net->dst.ethernet.ifname) < 0) if (bufferVSprintf(buf, " <target dev='%s'/>\n", net->dst.ethernet.ifname) < 0)
goto no_memory; goto no_memory;
} }
if (net->dst.ethernet.script[0] != '\0') { if (net->dst.ethernet.script[0] != '\0') {
if (qemudBufferPrintf(&buf, " <script path='%s'/>\n", net->dst.ethernet.script) < 0) if (bufferVSprintf(buf, " <script path='%s'/>\n", net->dst.ethernet.script) < 0)
goto no_memory; goto no_memory;
} }
break; break;
case QEMUD_NET_BRIDGE: case QEMUD_NET_BRIDGE:
if (qemudBufferPrintf(&buf, " <source dev='%s'/>\n", net->dst.bridge.brname) < 0) if (bufferVSprintf(buf, " <source dev='%s'/>\n", net->dst.bridge.brname) < 0)
goto no_memory; goto no_memory;
if (net->dst.bridge.ifname[0] != '\0') { if (net->dst.bridge.ifname[0] != '\0') {
if (qemudBufferPrintf(&buf, " <target dev='%s'/>\n", net->dst.bridge.ifname) < 0) if (bufferVSprintf(buf, " <target dev='%s'/>\n", net->dst.bridge.ifname) < 0)
goto no_memory; goto no_memory;
} }
break; break;
@ -2614,17 +2560,17 @@ char *qemudGenerateXML(struct qemud_server *server,
case QEMUD_NET_CLIENT: case QEMUD_NET_CLIENT:
case QEMUD_NET_MCAST: case QEMUD_NET_MCAST:
if (net->dst.socket.address[0] != '\0') { if (net->dst.socket.address[0] != '\0') {
if (qemudBufferPrintf(&buf, " <source address='%s' port='%d'/>\n", if (bufferVSprintf(buf, " <source address='%s' port='%d'/>\n",
net->dst.socket.address, net->dst.socket.port) < 0) net->dst.socket.address, net->dst.socket.port) < 0)
goto no_memory; goto no_memory;
} else { } else {
if (qemudBufferPrintf(&buf, " <source port='%d'/>\n", if (bufferVSprintf(buf, " <source port='%d'/>\n",
net->dst.socket.port) < 0) net->dst.socket.port) < 0)
goto no_memory; goto no_memory;
} }
} }
if (qemudBufferPrintf(&buf, " </interface>\n") < 0) if (bufferVSprintf(buf, " </interface>\n") < 0)
goto no_memory; goto no_memory;
net = net->next; net = net->next;
@ -2632,20 +2578,20 @@ char *qemudGenerateXML(struct qemud_server *server,
switch (def->graphicsType) { switch (def->graphicsType) {
case QEMUD_GRAPHICS_VNC: case QEMUD_GRAPHICS_VNC:
if (qemudBufferAdd(&buf, " <graphics type='vnc'") < 0) if (bufferAdd(buf, " <graphics type='vnc'", -1) < 0)
goto no_memory; goto no_memory;
if (def->vncPort && if (def->vncPort &&
qemudBufferPrintf(&buf, " port='%d'", bufferVSprintf(buf, " port='%d'",
qemudIsActiveVM(vm) && live ? def->vncActivePort : def->vncPort) < 0) qemudIsActiveVM(vm) && live ? def->vncActivePort : def->vncPort) < 0)
goto no_memory; goto no_memory;
if (qemudBufferAdd(&buf, "/>\n") < 0) if (bufferAdd(buf, "/>\n", -1) < 0)
goto no_memory; goto no_memory;
break; break;
case QEMUD_GRAPHICS_SDL: case QEMUD_GRAPHICS_SDL:
if (qemudBufferAdd(&buf, " <graphics type='sdl'/>\n") < 0) if (bufferAdd(buf, " <graphics type='sdl'/>\n", -1) < 0)
goto no_memory; goto no_memory;
break; break;
@ -2657,20 +2603,19 @@ char *qemudGenerateXML(struct qemud_server *server,
if (def->graphicsType == QEMUD_GRAPHICS_VNC) { if (def->graphicsType == QEMUD_GRAPHICS_VNC) {
} }
if (qemudBufferAdd(&buf, " </devices>\n") < 0) if (bufferAdd(buf, " </devices>\n", -1) < 0)
goto no_memory; goto no_memory;
if (qemudBufferAdd(&buf, "</domain>\n") < 0) if (bufferAdd(buf, "</domain>\n", -1) < 0)
goto no_memory; goto no_memory;
return buf.data; return bufferContentAndFree (buf);
no_memory: no_memory:
qemudReportError(server, VIR_ERR_NO_MEMORY, "xml"); qemudReportError(server, VIR_ERR_NO_MEMORY, "xml");
cleanup: cleanup:
if (buf.data) if (buf) bufferFree (buf);
free(buf.data);
return NULL; return NULL;
} }
@ -2678,24 +2623,21 @@ char *qemudGenerateXML(struct qemud_server *server,
char *qemudGenerateNetworkXML(struct qemud_server *server, char *qemudGenerateNetworkXML(struct qemud_server *server,
struct qemud_network *network ATTRIBUTE_UNUSED, struct qemud_network *network ATTRIBUTE_UNUSED,
struct qemud_network_def *def) { struct qemud_network_def *def) {
struct qemudBuffer buf; bufferPtr buf = 0;
unsigned char *uuid; unsigned char *uuid;
buf.len = QEMUD_MAX_XML_LEN; buf = bufferNew (QEMUD_MAX_XML_LEN);
buf.used = 0; if (!buf)
buf.data = malloc(buf.len);
if (!buf.data)
goto no_memory; goto no_memory;
if (qemudBufferPrintf(&buf, "<network>\n") < 0) if (bufferVSprintf(buf, "<network>\n") < 0)
goto no_memory; goto no_memory;
if (qemudBufferPrintf(&buf, " <name>%s</name>\n", def->name) < 0) if (bufferVSprintf(buf, " <name>%s</name>\n", def->name) < 0)
goto no_memory; goto no_memory;
uuid = def->uuid; uuid = def->uuid;
if (qemudBufferPrintf(&buf, " <uuid>%02x%02x%02x%02x-%02x%02x-%02x%02x-%02x%02x-%02x%02x%02x%02x%02x%02x</uuid>\n", if (bufferVSprintf(buf, " <uuid>%02x%02x%02x%02x-%02x%02x-%02x%02x-%02x%02x-%02x%02x%02x%02x%02x%02x</uuid>\n",
uuid[0], uuid[1], uuid[2], uuid[3], uuid[0], uuid[1], uuid[2], uuid[3],
uuid[4], uuid[5], uuid[6], uuid[7], uuid[4], uuid[5], uuid[6], uuid[7],
uuid[8], uuid[9], uuid[10], uuid[11], uuid[8], uuid[9], uuid[10], uuid[11],
@ -2704,62 +2646,61 @@ char *qemudGenerateNetworkXML(struct qemud_server *server,
if (def->forward) { if (def->forward) {
if (def->forwardDev[0]) { if (def->forwardDev[0]) {
qemudBufferPrintf(&buf, " <forward dev='%s'/>\n", bufferVSprintf(buf, " <forward dev='%s'/>\n",
def->forwardDev); def->forwardDev);
} else { } else {
qemudBufferAdd(&buf, " <forward/>\n"); bufferAdd(buf, " <forward/>\n", -1);
} }
} }
if ((def->bridge != '\0' || def->disableSTP || def->forwardDelay) && if ((def->bridge != '\0' || def->disableSTP || def->forwardDelay) &&
qemudBufferPrintf(&buf, " <bridge name='%s' stp='%s' delay='%d' />\n", bufferVSprintf(buf, " <bridge name='%s' stp='%s' delay='%d' />\n",
def->bridge, def->bridge,
def->disableSTP ? "off" : "on", def->disableSTP ? "off" : "on",
def->forwardDelay) < 0) def->forwardDelay) < 0)
goto no_memory; goto no_memory;
if (def->ipAddress[0] || def->netmask[0]) { if (def->ipAddress[0] || def->netmask[0]) {
if (qemudBufferAdd(&buf, " <ip") < 0) if (bufferAdd(buf, " <ip", -1) < 0)
goto no_memory; goto no_memory;
if (def->ipAddress[0] && if (def->ipAddress[0] &&
qemudBufferPrintf(&buf, " address='%s'", def->ipAddress) < 0) bufferVSprintf(buf, " address='%s'", def->ipAddress) < 0)
goto no_memory; goto no_memory;
if (def->netmask[0] && if (def->netmask[0] &&
qemudBufferPrintf(&buf, " netmask='%s'", def->netmask) < 0) bufferVSprintf(buf, " netmask='%s'", def->netmask) < 0)
goto no_memory; goto no_memory;
if (qemudBufferAdd(&buf, ">\n") < 0) if (bufferAdd(buf, ">\n", -1) < 0)
goto no_memory; goto no_memory;
if (def->ranges) { if (def->ranges) {
struct qemud_dhcp_range_def *range = def->ranges; struct qemud_dhcp_range_def *range = def->ranges;
if (qemudBufferAdd(&buf, " <dhcp>\n") < 0) if (bufferAdd(buf, " <dhcp>\n", -1) < 0)
goto no_memory; goto no_memory;
while (range) { while (range) {
if (qemudBufferPrintf(&buf, " <range start='%s' end='%s' />\n", if (bufferVSprintf(buf, " <range start='%s' end='%s' />\n",
range->start, range->end) < 0) range->start, range->end) < 0)
goto no_memory; goto no_memory;
range = range->next; range = range->next;
} }
if (qemudBufferAdd(&buf, " </dhcp>\n") < 0) if (bufferAdd(buf, " </dhcp>\n", -1) < 0)
goto no_memory; goto no_memory;
} }
if (qemudBufferAdd(&buf, " </ip>\n") < 0) if (bufferAdd(buf, " </ip>\n", -1) < 0)
goto no_memory; goto no_memory;
} }
if (qemudBufferAdd(&buf, "</network>\n") < 0) if (bufferAdd(buf, "</network>\n", -1) < 0)
goto no_memory; goto no_memory;
return buf.data; return bufferContentAndFree (buf);
no_memory: no_memory:
qemudReportError(server, VIR_ERR_NO_MEMORY, "xml"); qemudReportError(server, VIR_ERR_NO_MEMORY, "xml");
if (buf.data) if (buf) bufferFree (buf);
free(buf.data);
return NULL; return NULL;
} }

8
qemud/conf.h
View File

@ -78,6 +78,14 @@ char * qemudGenerateNetworkXML (struct qemud_server *server,
struct qemud_network *network, struct qemud_network *network,
struct qemud_network_def *def); struct qemud_network_def *def);
struct qemu_arch_info {
const char *arch;
int wordsize;
const char **machines;
const char *binary;
};
extern struct qemu_arch_info qemudArchs[];
#endif #endif
/* /*

176
qemud/dispatch.c
View File

@ -23,6 +23,7 @@
#include <config.h> #include <config.h>
#include <unistd.h>
#include <limits.h> #include <limits.h>
#include <string.h> #include <string.h>
#include <stdlib.h> #include <stdlib.h>
@ -33,6 +34,8 @@
#include "internal.h" #include "internal.h"
#include "driver.h" #include "driver.h"
#include "dispatch.h" #include "dispatch.h"
#include "conf.h"
#include "buf.h"
static int qemudDispatchFailure(struct qemud_server *server ATTRIBUTE_UNUSED, static int qemudDispatchFailure(struct qemud_server *server ATTRIBUTE_UNUSED,
@ -100,6 +103,178 @@ static int qemudDispatchGetNodeInfo(struct qemud_server *server, struct qemud_cl
return 0; return 0;
} }
static int
qemudDispatchGetCapabilities (struct qemud_server *server,
struct qemud_client *client,
struct qemud_packet *in,
struct qemud_packet *out)
{
struct utsname utsname;
int i, j, r;
int have_kqemu = 0;
int have_kvm = 0;
bufferPtr xml;
int len;
if (in->header.dataSize != 0) return -1;
/* Really, this never fails - look at the man-page. */
uname (&utsname);
have_kqemu = access ("/dev/kqemu", F_OK) == 0;
have_kvm = access ("/dev/kvm", F_OK) == 0;
/* Construct the XML. */
xml = bufferNew (1024);
if (!xml) {
qemudReportError (server, VIR_ERR_NO_MEMORY, NULL);
qemudDispatchFailure (server, client, out);
return 0;
}
r = bufferVSprintf (xml,
"\
<capabilities>\n\
<host>\n\
<cpu>\n\
<arch>%s</arch>\n\
</cpu>\n\
</host>\n",
utsname.machine);
if (r == -1) {
vir_buffer_failed:
bufferFree (xml);
qemudReportError (server, VIR_ERR_NO_MEMORY, NULL);
qemudDispatchFailure (server, client, out);
return 0;
}
i = -1;
if (strcmp (utsname.machine, "i686") == 0) i = 0;
else if (strcmp (utsname.machine, "x86_64") == 0) i = 1;
if (i >= 0) {
/* For the default (PC-like) guest, qemudArchs[0] or [1]. */
r = bufferVSprintf (xml,
"\
\n\
<guest>\n\
<os_type>hvm</os_type>\n\
<arch name=\"%s\">\n\
<wordsize>%d</wordsize>\n\
<emulator>/usr/bin/%s</emulator>\n\
<domain type=\"qemu\"/>\n",
qemudArchs[i].arch,
qemudArchs[i].wordsize,
qemudArchs[i].binary);
if (r == -1) goto vir_buffer_failed;
for (j = 0; qemudArchs[i].machines[j]; ++j) {
r = bufferVSprintf (xml,
"\
<machine>%s</machine>\n",
qemudArchs[i].machines[j]);
if (r == -1) goto vir_buffer_failed;
}
if (have_kqemu) {
r = bufferAdd (xml,
"\
<domain type=\"kqemu\"/>\n", -1);
if (r == -1) goto vir_buffer_failed;
}
if (have_kvm) {
r = bufferAdd (xml,
"\
<domain type=\"kvm\">\n\
<emulator>/usr/bin/qemu-kvm</emulator>\n\
</domain>\n", -1);
if (r == -1) goto vir_buffer_failed;
}
r = bufferAdd (xml,
"\
</arch>\n\
</guest>\n", -1);
if (r == -1) goto vir_buffer_failed;
/* The "other" PC architecture needs emulation. */
i = i ^ 1;
r = bufferVSprintf (xml,
"\
\n\
<guest>\n\
<os_type>hvm</os_type>\n\
<arch name=\"%s\">\n\
<wordsize>%d</wordsize>\n\
<emulator>/usr/bin/%s</emulator>\n\
<domain type=\"qemu\"/>\n",
qemudArchs[i].arch,
qemudArchs[i].wordsize,
qemudArchs[i].binary);
if (r == -1) goto vir_buffer_failed;
for (j = 0; qemudArchs[i].machines[j]; ++j) {
r = bufferVSprintf (xml,
"\
<machine>%s</machine>\n",
qemudArchs[i].machines[j]);
if (r == -1) goto vir_buffer_failed;
}
r = bufferAdd (xml,
"\
</arch>\n\
</guest>\n", -1);
if (r == -1) goto vir_buffer_failed;
}
/* The non-PC architectures, qemudArchs[>=2]. */
for (i = 2; qemudArchs[i].arch; ++i) {
r = bufferVSprintf (xml,
"\
\n\
<guest>\n\
<os_type>hvm</os_type>\n\
<arch name=\"%s\">\n\
<wordsize>%d</wordsize>\n\
<emulator>/usr/bin/%s</emulator>\n\
<domain type=\"qemu\"/>\n",
qemudArchs[i].arch,
qemudArchs[i].wordsize,
qemudArchs[i].binary);
if (r == -1) goto vir_buffer_failed;
for (j = 0; qemudArchs[i].machines[j]; ++j) {
r = bufferVSprintf (xml,
"\
<machine>%s</machine>\n",
qemudArchs[i].machines[j]);
if (r == -1) goto vir_buffer_failed;
}
r = bufferAdd (xml,
"\
</arch>\n\
</guest>\n", -1);
if (r == -1) goto vir_buffer_failed;
}
/* Finish off. */
r = bufferAdd (xml,
"\
</capabilities>\n", -1);
if (r == -1) goto vir_buffer_failed;
/* Copy the XML into the outgoing packet, assuming it's not too large. */
len = strlen (xml->content);
if (len > QEMUD_MAX_XML_LEN) {
bufferFree (xml);
qemudReportError (server, VIR_ERR_XML_ERROR, NULL);
qemudDispatchFailure (server, client, out);
return 0;
}
out->header.type = QEMUD_PKT_GET_CAPABILITIES;
out->header.dataSize = len;
strcpy (out->data.getCapabilitiesReply.xml, xml->content);
bufferFree (xml);
return 0;
}
static int qemudDispatchListDomains(struct qemud_server *server, struct qemud_client *client, static int qemudDispatchListDomains(struct qemud_server *server, struct qemud_client *client,
struct qemud_packet *in, struct qemud_packet *out) { struct qemud_packet *in, struct qemud_packet *out) {
int i, ndomains, domains[QEMUD_MAX_NUM_DOMAINS]; int i, ndomains, domains[QEMUD_MAX_NUM_DOMAINS];
@ -854,6 +1029,7 @@ clientFunc funcsTransmitRW[QEMUD_PKT_MAX] = {
qemudDispatchDomainSetAutostart, qemudDispatchDomainSetAutostart,
qemudDispatchNetworkGetAutostart, qemudDispatchNetworkGetAutostart,
qemudDispatchNetworkSetAutostart, qemudDispatchNetworkSetAutostart,
qemudDispatchGetCapabilities,
}; };
clientFunc funcsTransmitRO[QEMUD_PKT_MAX] = { clientFunc funcsTransmitRO[QEMUD_PKT_MAX] = {

4
qemud/internal.h
View File

@ -39,8 +39,12 @@
#ifndef ATTRIBUTE_UNUSED #ifndef ATTRIBUTE_UNUSED
#define ATTRIBUTE_UNUSED __attribute__((unused)) #define ATTRIBUTE_UNUSED __attribute__((unused))
#endif #endif
#ifndef ATTRIBUTE_FORMAT
#define ATTRIBUTE_FORMAT(args...) __attribute__((__format__ (args)))
#endif
#else #else
#define ATTRIBUTE_UNUSED #define ATTRIBUTE_UNUSED
#define ATTRIBUTE_FORMAT(...)
#endif #endif
#define UUID_LEN 16 #define UUID_LEN 16

4
qemud/protocol.h
View File

@ -68,6 +68,7 @@ enum {
QEMUD_PKT_DOMAIN_SET_AUTOSTART, QEMUD_PKT_DOMAIN_SET_AUTOSTART,
QEMUD_PKT_NETWORK_GET_AUTOSTART, QEMUD_PKT_NETWORK_GET_AUTOSTART,
QEMUD_PKT_NETWORK_SET_AUTOSTART, QEMUD_PKT_NETWORK_SET_AUTOSTART,
QEMUD_PKT_GET_CAPABILITIES,
QEMUD_PKT_MAX, QEMUD_PKT_MAX,
} qemud_packet_type; } qemud_packet_type;
@ -124,6 +125,9 @@ union qemud_packet_data {
uint32_t cores; uint32_t cores;
uint32_t threads; uint32_t threads;
} getNodeInfoReply; } getNodeInfoReply;
struct {
char xml[QEMUD_MAX_XML_LEN];
} getCapabilitiesReply;
struct { struct {
int32_t numDomains; int32_t numDomains;
int32_t domains[QEMUD_MAX_NUM_DOMAINS]; int32_t domains[QEMUD_MAX_NUM_DOMAINS];

17
src/driver.h
View File

@ -48,6 +48,8 @@ typedef int
typedef int typedef int
(*virDrvNodeGetInfo) (virConnectPtr conn, (*virDrvNodeGetInfo) (virConnectPtr conn,
virNodeInfoPtr info); virNodeInfoPtr info);
typedef char *
(*virDrvGetCapabilities) (virConnectPtr conn);
typedef int typedef int
(*virDrvListDomains) (virConnectPtr conn, (*virDrvListDomains) (virConnectPtr conn,
int *ids, int *ids,
@ -164,6 +166,7 @@ struct _virDriver {
virDrvGetVersion version; virDrvGetVersion version;
virDrvGetMaxVcpus getMaxVcpus; virDrvGetMaxVcpus getMaxVcpus;
virDrvNodeGetInfo nodeGetInfo; virDrvNodeGetInfo nodeGetInfo;
virDrvGetCapabilities getCapabilities;
virDrvListDomains listDomains; virDrvListDomains listDomains;
virDrvNumOfDomains numOfDomains; virDrvNumOfDomains numOfDomains;
virDrvDomainCreateLinux domainCreateLinux; virDrvDomainCreateLinux domainCreateLinux;
@ -283,3 +286,17 @@ int virRegisterNetworkDriver(virNetworkDriverPtr);
} }
#endif /* __cplusplus */ #endif /* __cplusplus */
#endif /* __VIR_DRIVER_H__ */ #endif /* __VIR_DRIVER_H__ */
/*
* vim: set tabstop=4:
* vim: set shiftwidth=4:
* vim: set expandtab:
*/
/*
* Local variables:
* indent-tabs-mode: nil
* c-indent-level: 4
* c-basic-offset: 4
* tab-width: 4
* End:
*/

14
src/internal.h
View File

@ -239,3 +239,17 @@ int virFreeNetwork (virConnectPtr conn,
} }
#endif /* __cplusplus */ #endif /* __cplusplus */
#endif /* __VIR_INTERNAL_H__ */ #endif /* __VIR_INTERNAL_H__ */
/*
* vim: set tabstop=4:
* vim: set shiftwidth=4:
* vim: set expandtab:
*/
/*
* Local variables:
* indent-tabs-mode: nil
* c-indent-level: 4
* c-basic-offset: 4
* tab-width: 4
* End:
*/

66
src/libvirt.c
View File

@ -528,7 +528,7 @@ virConnectGetVersion(virConnectPtr conn, unsigned long *hvVer)
* @conn: pointer to the hypervisor connection * @conn: pointer to the hypervisor connection
* @type: value of the 'type' attribute in the <domain> element * @type: value of the 'type' attribute in the <domain> element
* *
* Returns the maximum number of virtual CPUs supported for a guest VM of a * Provides the maximum number of virtual CPUs supported for a guest VM of a
* specific type. The 'type' parameter here corresponds to the 'type' * specific type. The 'type' parameter here corresponds to the 'type'
* attribute in the <domain> element of the XML. * attribute in the <domain> element of the XML.
* *
@ -1711,6 +1711,36 @@ virNodeGetInfo(virConnectPtr conn, virNodeInfoPtr info) {
return(0); return(0);
} }
/**
* virConnectGetCapabilities:
* @conn: pointer to the hypervisor connection
*
* Provides capabilities of the hypervisor / driver.
*
* Returns NULL in case of error, or a pointer to an opaque
* virCapabilities structure (virCapabilitiesPtr).
* The client must free the returned string after use.
*/
char *
virConnectGetCapabilities (virConnectPtr conn)
{
int i;
if (!VIR_IS_CONNECT (conn)) {
virLibConnError (conn, VIR_ERR_INVALID_CONN, __FUNCTION__);
return NULL;
}
for (i = 0; i < conn->nb_drivers; i++) {
if (conn->drivers[i] && conn->drivers[i]->getCapabilities) {
return conn->drivers[i]->getCapabilities (conn);
}
}
virLibConnError(conn, VIR_ERR_CALL_FAILED, __FUNCTION__);
return NULL;
}
/************************************************************************ /************************************************************************
* * * *
* Handling of defined but not running domains * * Handling of defined but not running domains *
@ -1905,8 +1935,9 @@ virDomainCreate(virDomainPtr domain) {
/** /**
* virDomainGetAutostart: * virDomainGetAutostart:
* @domain: a domain object * @domain: a domain object
* @autostart: the value returned
* *
* Return a boolean value indicating whether the domain * Provides a boolean value indicating whether the domain
* configured to be automatically started when the host * configured to be automatically started when the host
* machine boots. * machine boots.
* *
@ -1939,6 +1970,7 @@ virDomainGetAutostart(virDomainPtr domain,
/** /**
* virDomainSetAutostart: * virDomainSetAutostart:
* @domain: a domain object * @domain: a domain object
* @autostart: whether the domain should be automatically started 0 or 1
* *
* Configure the domain to be automatically started * Configure the domain to be automatically started
* when the host machine boots. * when the host machine boots.
@ -2154,11 +2186,11 @@ virDomainGetVcpus(virDomainPtr domain, virVcpuInfoPtr info, int maxinfo,
* virDomainGetMaxVcpus: * virDomainGetMaxVcpus:
* @domain: pointer to domain object * @domain: pointer to domain object
* *
* Returns the maximum number of virtual CPUs supported for * Provides the maximum number of virtual CPUs supported for
* the guest VM. If the guest is inactive, this is basically * the guest VM. If the guest is inactive, this is basically
* the same as virConnectGetMaxVcpus. If the guest is running * the same as virConnectGetMaxVcpus. If the guest is running
* this will reflect the maximum number of virtual CPUs the * this will reflect the maximum number of virtual CPUs the
* guest was booted with. * guest was booted with.
* *
* Returns the maximum of virtual CPU or -1 in case of error. * Returns the maximum of virtual CPU or -1 in case of error.
*/ */
@ -2878,7 +2910,7 @@ virNetworkGetXMLDesc(virNetworkPtr network, int flags)
* virNetworkGetBridgeName: * virNetworkGetBridgeName:
* @network: a network object * @network: a network object
* *
* Return a bridge interface name to which a domain may connect * Provides a bridge interface name to which a domain may connect
* a network interface in order to join the network. * a network interface in order to join the network.
* *
* Returns a 0 terminated interface name, or NULL in case of error. * Returns a 0 terminated interface name, or NULL in case of error.
@ -2912,8 +2944,9 @@ virNetworkGetBridgeName(virNetworkPtr network)
/** /**
* virNetworkGetAutostart: * virNetworkGetAutostart:
* @network: a network object * @network: a network object
* @autostart: the value returned
* *
* Return a boolean value indicating whether the network * Provides a boolean value indicating whether the network
* configured to be automatically started when the host * configured to be automatically started when the host
* machine boots. * machine boots.
* *
@ -2946,6 +2979,7 @@ virNetworkGetAutostart(virNetworkPtr network,
/** /**
* virNetworkSetAutostart: * virNetworkSetAutostart:
* @network: a network object * @network: a network object
* @autostart: whether the network should be automatically started 0 or 1
* *
* Configure the network to be automatically started * Configure the network to be automatically started
* when the host machine boots. * when the host machine boots.
@ -2971,3 +3005,17 @@ virNetworkSetAutostart(virNetworkPtr network,
virLibConnError(network->conn, VIR_ERR_CALL_FAILED, __FUNCTION__); virLibConnError(network->conn, VIR_ERR_CALL_FAILED, __FUNCTION__);
return (-1); return (-1);
} }
/*
* vim: set tabstop=4:
* vim: set shiftwidth=4:
* vim: set expandtab:
*/
/*
* Local variables:
* indent-tabs-mode: nil
* c-indent-level: 4
* c-basic-offset: 4
* tab-width: 4
* End:
*/

1
src/libvirt_sym.version
View File

@ -53,6 +53,7 @@
virConnResetLastError; virConnResetLastError;
virDefaultErrorFunc; virDefaultErrorFunc;
virNodeGetInfo; virNodeGetInfo;
virConnectGetCapabilities;
virDomainSetVcpus; virDomainSetVcpus;
virDomainPinVcpu; virDomainPinVcpu;

15
src/proxy_internal.c
View File

@ -52,6 +52,7 @@ static virDriver xenProxyDriver = {
xenProxyGetVersion, /* version */ xenProxyGetVersion, /* version */
NULL, /* getMaxVcpus */ NULL, /* getMaxVcpus */
xenProxyNodeGetInfo, /* nodeGetInfo */ xenProxyNodeGetInfo, /* nodeGetInfo */
NULL, /* getCapabilities */
xenProxyListDomains, /* listDomains */ xenProxyListDomains, /* listDomains */
xenProxyNumOfDomains, /* numOfDomains */ xenProxyNumOfDomains, /* numOfDomains */
NULL, /* domainCreateLinux */ NULL, /* domainCreateLinux */
@ -1044,3 +1045,17 @@ xenProxyDomainGetOSType(virDomainPtr domain)
return(ostype); return(ostype);
} }
/*
* vim: set tabstop=4:
* vim: set shiftwidth=4:
* vim: set expandtab:
*/
/*
* Local variables:
* indent-tabs-mode: nil
* c-indent-level: 4
* c-basic-offset: 4
* tab-width: 4
* End:
*/

18
src/proxy_internal.h
View File

@ -78,8 +78,8 @@ struct _virProxyFullPacket {
union { union {
char str[4080]; /* extra char array */ char str[4080]; /* extra char array */
int arg[1020]; /* extra int array */ int arg[1020]; /* extra int array */
virDomainInfo dinfo; /* domain information */ virDomainInfo dinfo; /* domain information */
virNodeInfo ninfo; /* node information */ virNodeInfo ninfo; /* node information */
} extra; } extra;
}; };
typedef struct _virProxyFullPacket virProxyFullPacket; typedef struct _virProxyFullPacket virProxyFullPacket;
@ -93,3 +93,17 @@ void xenProxyRegister(void);
} }
#endif /* __cplusplus */ #endif /* __cplusplus */
#endif /* __LIBVIR_PROXY_H__ */ #endif /* __LIBVIR_PROXY_H__ */
/*
* vim: set tabstop=4:
* vim: set shiftwidth=4:
* vim: set expandtab:
*/
/*
* Local variables:
* indent-tabs-mode: nil
* c-indent-level: 4
* c-basic-offset: 4
* tab-width: 4
* End:
*/

31
src/qemu_internal.c
View File

@ -452,6 +452,31 @@ static int qemuNodeGetInfo(virConnectPtr conn,
} }
static char *
qemuGetCapabilities (virConnectPtr conn)
{
struct qemud_packet req, reply;
char *xml;
/* Punt the request across to the daemon, because the daemon
* has tables describing available architectures.
*/
req.header.type = QEMUD_PKT_GET_CAPABILITIES;
req.header.dataSize = 0;
if (qemuProcessRequest(conn, NULL, &req, &reply) < 0) {
return NULL;
}
xml = strdup (reply.data.getCapabilitiesReply.xml);
if (!xml) {
qemuError (conn, NULL, VIR_ERR_NO_MEMORY, NULL);
return NULL;
}
return xml;
}
static int qemuNumOfDomains(virConnectPtr conn) { static int qemuNumOfDomains(virConnectPtr conn) {
struct qemud_packet req, reply; struct qemud_packet req, reply;
@ -1172,6 +1197,7 @@ static virDriver qemuDriver = {
qemuGetVersion, /* version */ qemuGetVersion, /* version */
NULL, /* getMaxVcpus */ NULL, /* getMaxVcpus */
qemuNodeGetInfo, /* nodeGetInfo */ qemuNodeGetInfo, /* nodeGetInfo */
qemuGetCapabilities, /* getCapabilities */
qemuListDomains, /* listDomains */ qemuListDomains, /* listDomains */
qemuNumOfDomains, /* numOfDomains */ qemuNumOfDomains, /* numOfDomains */
qemuDomainCreateLinux, /* domainCreateLinux */ qemuDomainCreateLinux, /* domainCreateLinux */
@ -1227,6 +1253,11 @@ static virNetworkDriver qemuNetworkDriver = {
qemuNetworkSetAutostart, /* networkSetAutostart */ qemuNetworkSetAutostart, /* networkSetAutostart */
}; };
/**
* qemuRegister:
*
* Registers QEmu/KVM in libvirt driver system
*/
void qemuRegister(void) { void qemuRegister(void) {
virRegisterDriver(&qemuDriver); virRegisterDriver(&qemuDriver);
virRegisterNetworkDriver(&qemuNetworkDriver); virRegisterNetworkDriver(&qemuNetworkDriver);

49
src/test.c
View File

@ -44,6 +44,7 @@ int testGetVersion(virConnectPtr conn,
unsigned long *hvVer); unsigned long *hvVer);
int testNodeGetInfo(virConnectPtr conn, int testNodeGetInfo(virConnectPtr conn,
virNodeInfoPtr info); virNodeInfoPtr info);
char *testGetCapabilities (virConnectPtr conn);
int testNumOfDomains(virConnectPtr conn); int testNumOfDomains(virConnectPtr conn);
int testListDomains(virConnectPtr conn, int testListDomains(virConnectPtr conn,
int *ids, int *ids,
@ -97,6 +98,7 @@ static virDriver testDriver = {
testGetVersion, /* version */ testGetVersion, /* version */
NULL, /* getMaxVcpus */ NULL, /* getMaxVcpus */
testNodeGetInfo, /* nodeGetInfo */ testNodeGetInfo, /* nodeGetInfo */
testGetCapabilities, /* getCapabilities */
testListDomains, /* listDomains */ testListDomains, /* listDomains */
testNumOfDomains, /* numOfDomains */ testNumOfDomains, /* numOfDomains */
testDomainCreateLinux, /* domainCreateLinux */ testDomainCreateLinux, /* domainCreateLinux */
@ -179,8 +181,11 @@ typedef struct _testNode {
static testNode *node = NULL; static testNode *node = NULL;
static int nextDomID = 1; static int nextDomID = 1;
#define TEST_MODEL "i686"
#define TEST_MODEL_WORDSIZE "32"
static const virNodeInfo defaultNodeInfo = { static const virNodeInfo defaultNodeInfo = {
"i686", TEST_MODEL,
1024*1024*3, /* 3 GB */ 1024*1024*3, /* 3 GB */
16, 16,
1400, 1400,
@ -809,6 +814,43 @@ int testNodeGetInfo(virConnectPtr conn,
return (0); return (0);
} }
char *
testGetCapabilities (virConnectPtr conn)
{
static char caps[] = "\
<capabilities>\n\
<host>\n\
<cpu>\n\
<arch>" TEST_MODEL "</arch>\n\
<features>\n\
<pae/>\n\
<nonpae/>\n\
</features>\n\
</cpu>\n\
</host>\n\
\n\
<guest>\n\
<os_type>linux</os_type>\n\
<arch name=\"" TEST_MODEL "\">\n\
<wordsize>" TEST_MODEL_WORDSIZE "</wordsize>\n\
<domain type=\"test\"/>\n\
</arch>\n\
<features>\n\
<pae/>\n\
<nonpae/>\n\
</features>\n\
</guest>\n\
</capabilities>\n\
";
char *caps_copy = strdup (caps);
if (!caps_copy) {
testError(conn, NULL, VIR_ERR_NO_MEMORY, __FUNCTION__);
return NULL;
}
return caps_copy;
}
int testNumOfDomains(virConnectPtr conn) int testNumOfDomains(virConnectPtr conn)
{ {
int numActive = 0, i; int numActive = 0, i;
@ -1378,6 +1420,11 @@ int testDomainUndefine(virDomainPtr domain) {
} }
#endif /* WITH_TEST */ #endif /* WITH_TEST */
/*
* vim: set tabstop=4:
* vim: set shiftwidth=4:
* vim: set expandtab:
*/
/* /*
* Local variables: * Local variables:
* indent-tabs-mode: nil * indent-tabs-mode: nil

28
src/virsh.c
View File

@ -1549,6 +1549,33 @@ cmdNodeinfo(vshControl * ctl, vshCmd * cmd ATTRIBUTE_UNUSED)
return TRUE; return TRUE;
} }
/*
* "capabilities" command
*/
static vshCmdInfo info_capabilities[] = {
{"syntax", "capabilities"},
{"help", gettext_noop("capabilities")},
{"desc", gettext_noop("Returns capabilities of hypervisor/driver.")},
{NULL, NULL}
};
static int
cmdCapabilities (vshControl * ctl, vshCmd * cmd ATTRIBUTE_UNUSED)
{
char *caps;
if (!vshConnectionUsability(ctl, ctl->conn, TRUE))
return FALSE;
if ((caps = virConnectGetCapabilities (ctl->conn)) == NULL) {
vshError(ctl, FALSE, _("failed to get capabilities"));
return FALSE;
}
vshPrint (ctl, "%s\n", caps);
return TRUE;
}
/* /*
* "dumpxml" command * "dumpxml" command
*/ */
@ -2380,6 +2407,7 @@ cmdQuit(vshControl * ctl, vshCmd * cmd ATTRIBUTE_UNUSED)
*/ */
static vshCmdDef commands[] = { static vshCmdDef commands[] = {
{"autostart", cmdAutostart, opts_autostart, info_autostart}, {"autostart", cmdAutostart, opts_autostart, info_autostart},
{"capabilities", cmdCapabilities, NULL, info_capabilities},
{"connect", cmdConnect, opts_connect, info_connect}, {"connect", cmdConnect, opts_connect, info_connect},
{"console", cmdConsole, opts_console, info_console}, {"console", cmdConsole, opts_console, info_console},
{"create", cmdCreate, opts_create, info_create}, {"create", cmdCreate, opts_create, info_create},

20
src/virterror.c
View File

@ -604,6 +604,26 @@ __virErrorMsg(virErrorNumber error, const char *info)
else else
errmsg = _("network %s exists already"); errmsg = _("network %s exists already");
break; break;
case VIR_ERR_SYSTEM_ERROR:
if (info == NULL)
errmsg = _("system call error");
else
errmsg = "%s";
break;
} }
return (errmsg); return (errmsg);
} }
/*
* vim: set tabstop=4:
* vim: set shiftwidth=4:
* vim: set expandtab:
*/
/*
* Local variables:
* indent-tabs-mode: nil
* c-indent-level: 4
* c-basic-offset: 4
* tab-width: 4
* End:
*/

324
src/xen_internal.c
View File

@ -22,6 +22,9 @@
#include <sys/ioctl.h> #include <sys/ioctl.h>
#include <limits.h> #include <limits.h>
#include <stdint.h> #include <stdint.h>
#include <regex.h>
#include <errno.h>
#include <sys/utsname.h>
/* required for dom0_getdomaininfo_t */ /* required for dom0_getdomaininfo_t */
#include <xen/dom0_ops.h> #include <xen/dom0_ops.h>
@ -32,6 +35,8 @@
/* required for shutdown flags */ /* required for shutdown flags */
#include <xen/sched.h> #include <xen/sched.h>
#include "xml.h"
/* #define DEBUG */ /* #define DEBUG */
/* /*
* so far there is 2 versions of the structures usable for doing * so far there is 2 versions of the structures usable for doing
@ -72,6 +77,17 @@ static int sys_interface_version = -1;
static int dom_interface_version = -1; static int dom_interface_version = -1;
static int kb_per_pages = 0; static int kb_per_pages = 0;
/* Regular expressions used by xenHypervisorGetCapabilities, and
* compiled once by xenHypervisorInit. Note that these are POSIX.2
* extended regular expressions (regex(7)).
*/
static const char *flags_hvm_re = "^flags[[:blank:]]+:.* (vmx|svm)[[:space:]]";
static regex_t flags_hvm_rec;
static const char *flags_pae_re = "^flags[[:blank:]]+:.* pae[[:space:]]";
static regex_t flags_pae_rec;
static const char *xen_cap_re = "(xen|hvm)-[[:digit:]]+\\.[[:digit:]]+-(x86_32|x86_64|ia64)(p|be)?";
static regex_t xen_cap_rec;
/* /*
* The content of the structures for a getdomaininfolist system hypercall * The content of the structures for a getdomaininfolist system hypercall
*/ */
@ -432,6 +448,7 @@ static virDriver xenHypervisorDriver = {
xenHypervisorGetVersion, /* version */ xenHypervisorGetVersion, /* version */
xenHypervisorNumOfMaxVcpus, /* getMaxVcpus */ xenHypervisorNumOfMaxVcpus, /* getMaxVcpus */
NULL, /* nodeGetInfo */ NULL, /* nodeGetInfo */
xenHypervisorGetCapabilities, /* getCapabilities */
xenHypervisorListDomains, /* listDomains */ xenHypervisorListDomains, /* listDomains */
xenHypervisorNumOfDomains, /* numOfDomains */ xenHypervisorNumOfDomains, /* numOfDomains */
NULL, /* domainCreateLinux */ NULL, /* domainCreateLinux */
@ -470,9 +487,9 @@ static virDriver xenHypervisorDriver = {
/** /**
* virXenError: * virXenError:
* @conn: the connection if available
* @error: the error number * @error: the error number
* @info: extra information string * @info: extra information string
* @value: extra information number
* *
* Handle an error at the xend daemon interface * Handle an error at the xend daemon interface
*/ */
@ -486,7 +503,31 @@ virXenError(virErrorNumber error, const char *info, int value)
errmsg = __virErrorMsg(error, info); errmsg = __virErrorMsg(error, info);
__virRaiseError(NULL, NULL, NULL, VIR_FROM_XEN, error, VIR_ERR_ERROR, __virRaiseError(NULL, NULL, NULL, VIR_FROM_XEN, error, VIR_ERR_ERROR,
errmsg, info, NULL, value, 0, errmsg, info, value); errmsg, info, NULL, value, 0, errmsg, info);
}
/**
* virXenPerror:
* @conn: the connection (if available)
* @msg: name of system call or file (as in perror(3))
*
* Raise error from a failed system call, using errno as the source.
*/
static void
virXenPerror (virConnectPtr conn, const char *msg)
{
char *msg_s;
msg_s = malloc (strlen (msg) + 10);
if (msg_s) {
strcpy (msg_s, msg);
strcat (msg_s, ": %s");
}
__virRaiseError (conn, NULL, NULL,
VIR_FROM_XEN, VIR_ERR_SYSTEM_ERROR, VIR_ERR_ERROR,
msg, NULL, NULL, errno, 0,
msg_s ? msg_s : msg, strerror (errno));
} }
/** /**
@ -1139,7 +1180,7 @@ virXen_getvcpusinfo(int handle, int id, unsigned int vcpu, virVcpuInfoPtr ipt,
static int static int
xenHypervisorInit(void) xenHypervisorInit(void)
{ {
int fd, ret, cmd; int fd, ret, cmd, errcode;
hypercall_t hc; hypercall_t hc;
v0_hypercall_t v0_hc; v0_hypercall_t v0_hc;
xen_getdomaininfo info; xen_getdomaininfo info;
@ -1152,6 +1193,42 @@ xenHypervisorInit(void)
initialized = 1; initialized = 1;
in_init = 1; in_init = 1;
/* Compile regular expressions used by xenHypervisorGetCapabilities.
* Note that errors here are really internal errors since these
* regexps should never fail to compile.
*/
errcode = regcomp (&flags_hvm_rec, flags_hvm_re, REG_EXTENDED);
if (errcode != 0) {
char error[100];
regerror (errcode, &flags_hvm_rec, error, sizeof error);
regfree (&flags_hvm_rec);
virXenError (VIR_ERR_INTERNAL_ERROR, error, 0);
in_init = 0;
return -1;
}
errcode = regcomp (&flags_pae_rec, flags_pae_re, REG_EXTENDED);
if (errcode != 0) {
char error[100];
regerror (errcode, &flags_pae_rec, error, sizeof error);
regfree (&flags_pae_rec);
regfree (&flags_hvm_rec);
virXenError (VIR_ERR_INTERNAL_ERROR, error, 0);
in_init = 0;
return -1;
}
errcode = regcomp (&xen_cap_rec, xen_cap_re, REG_EXTENDED);
if (errcode != 0) {
char error[100];
regerror (errcode, &xen_cap_rec, error, sizeof error);
regfree (&xen_cap_rec);
regfree (&flags_pae_rec);
regfree (&flags_hvm_rec);
virXenError (VIR_ERR_INTERNAL_ERROR, error, 0);
in_init = 0;
return -1;
}
/* Xen hypervisor version detection begins. */
ret = open(XEN_HYPERVISOR_SOCKET, O_RDWR); ret = open(XEN_HYPERVISOR_SOCKET, O_RDWR);
if (ret < 0) { if (ret < 0) {
hypervisor_version = -1; hypervisor_version = -1;
@ -1360,6 +1437,242 @@ xenHypervisorGetVersion(virConnectPtr conn, unsigned long *hvVer)
return(0); return(0);
} }
/**
* xenHypervisorGetCapabilities:
* @conn: pointer to the connection block
*
* Return the capabilities of this hypervisor.
*/
char *
xenHypervisorGetCapabilities (virConnectPtr conn)
{
struct utsname utsname;
char line[1024], *str, *token;
regmatch_t subs[3];
char *saveptr;
FILE *fp;
int i, r;
char hvm_type[4] = ""; /* "vmx" or "svm" (or "" if not in CPU). */
int host_pae = 0;
const int max_guest_archs = 32;
struct {
const char *token;
const char *model;
int bits;
int hvm;
int pae;
int ia64_be;
} guest_archs[max_guest_archs];
int nr_guest_archs = 0;
virBufferPtr xml;
char *xml_str;
/* Really, this never fails - look at the man-page. */
uname (&utsname);
/* /proc/cpuinfo: flags: Intel calls HVM "vmx", AMD calls it "svm".
* It's not clear if this will work on IA64, let alone other
* architectures and non-Linux. (XXX)
*/
fp = fopen ("/proc/cpuinfo", "r");
if (fp == NULL) {
if (errno == ENOENT)
goto nocpuinfo;
virXenPerror (conn, "/proc/cpuinfo");
return NULL;
}
while (fgets (line, sizeof line, fp)) {
if (regexec (&flags_hvm_rec, line, 1, subs, 0) == 0
&& subs[0].rm_so != -1)
strncpy (hvm_type,
&line[subs[0].rm_so], subs[0].rm_eo-subs[0].rm_so+1);
else if (regexec (&flags_hvm_rec, line, 0, NULL, 0) == 0)
host_pae = 1;
}
fclose (fp);
nocpuinfo:
/* Most of the useful info is in /sys/hypervisor/properties/capabilities
* which is documented in the code in xen-unstable.hg/xen/arch/.../setup.c.
*
* It is a space-separated list of supported guest architectures.
*
* For x86:
* TYP-VER-ARCH[p]
* ^ ^ ^ ^
* | | | +-- PAE supported
* | | +------- x86_32 or x86_64
* | +----------- the version of Xen, eg. "3.0"
* +--------------- "xen" or "hvm" for para or full virt respectively
*
* For PPC this file appears to be always empty (?)
*
* For IA64:
* TYP-VER-ARCH[be]
* ^ ^ ^ ^
* | | | +-- Big-endian supported
* | | +------- always "ia64"
* | +----------- the version of Xen, eg. "3.0"
* +--------------- "xen" or "hvm" for para or full virt respectively
*/
fp = fopen ("/sys/hypervisor/properties/capabilities", "r");
if (fp == NULL) {
if (errno == ENOENT)
goto noxencaps;
virXenPerror (conn, "/sys/hypervisor/properties/capabilities");
return NULL;
}
/* Expecting one line in this file - ignore any more. */
if (!fgets (line, sizeof line, fp)) {
fclose (fp);
goto noxencaps;
}
fclose (fp);
/* Split the line into tokens. strtok_r is OK here because we "own"
* this buffer. Parse out the features from each token.
*/
for (str = line, nr_guest_archs = 0;
nr_guest_archs < max_guest_archs
&& (token = strtok_r (str, " ", &saveptr)) != NULL;
str = NULL) {
if (regexec (&xen_cap_rec, token, 3, subs, 0) == 0) {
guest_archs[nr_guest_archs].token = token;
guest_archs[nr_guest_archs].hvm =
strncmp (&token[subs[0].rm_so], "hvm", 3) == 0;
if (strncmp (&token[subs[1].rm_so], "x86_32", 6) == 0) {
guest_archs[nr_guest_archs].model = "i686";
guest_archs[nr_guest_archs].bits = 32;
}
else if (strncmp (&token[subs[1].rm_so], "x86_64", 6) == 0) {
guest_archs[nr_guest_archs].model = "x86_64";
guest_archs[nr_guest_archs].bits = 64;
}
else if (strncmp (&token[subs[1].rm_so], "ia64", 4) == 0) {
guest_archs[nr_guest_archs].model = "ia64";
guest_archs[nr_guest_archs].bits = 64;
}
else {
guest_archs[nr_guest_archs].model = ""; /* can never happen */
}
guest_archs[nr_guest_archs].pae =
guest_archs[nr_guest_archs].ia64_be = 0;
if (subs[2].rm_so != -1) {
if (strncmp (&token[subs[2].rm_so], "p", 1) == 0)
guest_archs[nr_guest_archs].pae = 1;
else if (strncmp (&token[subs[2].rm_so], "be", 2) == 0)
guest_archs[nr_guest_archs].ia64_be = 1;
}
nr_guest_archs++;
}
}
noxencaps:
/* Construct the final XML. */
xml = virBufferNew (1024);
if (!xml) return NULL;
r = virBufferVSprintf (xml,
"\
<capabilities>\n\
<host>\n\
<cpu>\n\
<arch>%s</arch>\n\
<features>\n",
utsname.machine);
if (r == -1) return NULL;
if (strcmp (hvm_type, "") != 0) {
r = virBufferVSprintf (xml,
"\
<%s/>\n",
hvm_type);
if (r == -1) {
vir_buffer_failed:
virBufferFree (xml);
return NULL;
}
}
if (host_pae) {
r = virBufferAdd (xml, "\
<pae/>\n", -1);
if (r == -1) goto vir_buffer_failed;
}
r = virBufferAdd (xml,
"\
</features>\n\
</cpu>\n\
</host>\n", -1);
if (r == -1) goto vir_buffer_failed;
for (i = 0; i < nr_guest_archs; ++i) {
r = virBufferVSprintf (xml,
"\
\n\
<!-- %s -->\n\
<guest>\n\
<os_type>%s</os_type>\n\
<arch name=\"%s\">\n\
<wordsize>%d</wordsize>\n\
<domain type=\"xen\"></domain>\n\
<emulator>/usr/lib%s/xen/bin/qemu-dm</emulator>\n",
guest_archs[i].token,
guest_archs[i].hvm ? "hvm" : "xen",
guest_archs[i].model,
guest_archs[i].bits,
guest_archs[i].bits == 64 ? "64" : "");
if (r == -1) goto vir_buffer_failed;
if (guest_archs[i].hvm) {
r = virBufferAdd (xml,
"\
<machine>pc</machine>\n\
<machine>isapc</machine>\n\
<loader>/usr/lib/xen/boot/hvmloader</loader>\n", -1);
if (r == -1) goto vir_buffer_failed;
}
r = virBufferAdd (xml,
"\
</arch>\n\
<features>", -1);
if (r == -1) goto vir_buffer_failed;
if (guest_archs[i].pae) {
r = virBufferAdd (xml,
"\
<pae/>\n\
<nonpae/>\n", -1);
if (r == -1) goto vir_buffer_failed;
}
if (guest_archs[i].ia64_be) {
r = virBufferAdd (xml,
"\
<ia64_be/>\n", -1);
if (r == -1) goto vir_buffer_failed;
}
r = virBufferAdd (xml,
"\
</features>\n\
</guest>\n", -1);
if (r == -1) goto vir_buffer_failed;
}
r = virBufferAdd (xml,
"\
</capabilities>\n", -1);
if (r == -1) goto vir_buffer_failed;
xml_str = strdup (xml->content);
if (!xml_str) {
virXenError(VIR_ERR_NO_MEMORY, "strdup", 0);
goto vir_buffer_failed;
}
virBufferFree (xml);
return xml_str;
}
/** /**
* xenHypervisorNumOfDomains: * xenHypervisorNumOfDomains:
* @conn: pointer to the connection block * @conn: pointer to the connection block
@ -1885,6 +2198,11 @@ xenHypervisorGetVcpuMax(virDomainPtr domain)
} }
#endif /* WITH_XEN */ #endif /* WITH_XEN */
/*
* vim: set tabstop=4:
* vim: set shiftwidth=4:
* vim: set expandtab:
*/
/* /*
* Local variables: * Local variables:
* indent-tabs-mode: nil * indent-tabs-mode: nil

2
src/xen_internal.h
View File

@ -22,6 +22,8 @@ int xenHypervisorOpen (virConnectPtr conn,
int xenHypervisorClose (virConnectPtr conn); int xenHypervisorClose (virConnectPtr conn);
int xenHypervisorGetVersion (virConnectPtr conn, int xenHypervisorGetVersion (virConnectPtr conn,
unsigned long *hvVer); unsigned long *hvVer);
char *
xenHypervisorGetCapabilities (virConnectPtr conn);
unsigned long unsigned long
xenHypervisorGetDomMaxMemory (virConnectPtr conn, xenHypervisorGetDomMaxMemory (virConnectPtr conn,
int id); int id);

1
src/xend_internal.c
View File

@ -72,6 +72,7 @@ static virDriver xenDaemonDriver = {
xenDaemonGetVersion, /* version */ xenDaemonGetVersion, /* version */
NULL, /* getMaxVcpus */ NULL, /* getMaxVcpus */
xenDaemonNodeGetInfo, /* nodeGetInfo */ xenDaemonNodeGetInfo, /* nodeGetInfo */
NULL, /* getCapabilities */
xenDaemonListDomains, /* listDomains */ xenDaemonListDomains, /* listDomains */
xenDaemonNumOfDomains, /* numOfDomains */ xenDaemonNumOfDomains, /* numOfDomains */
xenDaemonCreateLinux, /* domainCreateLinux */ xenDaemonCreateLinux, /* domainCreateLinux */

1
src/xm_internal.c
View File

@ -78,6 +78,7 @@ static virDriver xenXMDriver = {
NULL, /* version */ NULL, /* version */
NULL, /* getMaxVcpus */ NULL, /* getMaxVcpus */
NULL, /* nodeGetInfo */ NULL, /* nodeGetInfo */
NULL, /* getCapabilities */
NULL, /* listDomains */ NULL, /* listDomains */
NULL, /* numOfDomains */ NULL, /* numOfDomains */
NULL, /* domainCreateLinux */ NULL, /* domainCreateLinux */

1
src/xml.h
View File

@ -29,6 +29,7 @@ void virBufferFree(virBufferPtr buf);
int virBufferAdd(virBufferPtr buf, const char *str, int len); int virBufferAdd(virBufferPtr buf, const char *str, int len);
int virBufferVSprintf(virBufferPtr buf, const char *format, ...); int virBufferVSprintf(virBufferPtr buf, const char *format, ...);
int virBufferStrcat(virBufferPtr buf, ...); int virBufferStrcat(virBufferPtr buf, ...);
char *virDomainParseXMLDesc(virConnectPtr conn, const char *xmldesc, char **name, int xendConfigVersion); char *virDomainParseXMLDesc(virConnectPtr conn, const char *xmldesc, char **name, int xendConfigVersion);
unsigned char *virParseUUID(char **ptr, const char *uuid); unsigned char *virParseUUID(char **ptr, const char *uuid);
char *virParseXMLDevice(virConnectPtr conn, char *xmldesc, int hvm, int xendConfigVersion); char *virParseXMLDevice(virConnectPtr conn, char *xmldesc, int hvm, int xendConfigVersion);

1
src/xs_internal.c
View File

@ -47,6 +47,7 @@ static virDriver xenStoreDriver = {
NULL, /* version */ NULL, /* version */
NULL, /* getMaxVcpus */ NULL, /* getMaxVcpus */
NULL, /* nodeGetInfo */ NULL, /* nodeGetInfo */
NULL, /* getCapabilities */
xenStoreListDomains, /* listDomains */ xenStoreListDomains, /* listDomains */
NULL, /* numOfDomains */ NULL, /* numOfDomains */
NULL, /* domainCreateLinux */ NULL, /* domainCreateLinux */