2013-05-03 14:25:37 +00:00
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
2008-04-23 17:08:31 +00:00
|
|
|
<body>
|
|
|
|
|
<h1>Sitemap</h1>
|
|
|
|
|
|
|
|
|
|
<div id="sitemap">
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="index.html">Home</a>
|
|
|
|
|
<span>Front page of the libvirt website</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="news.html">News</a>
|
|
|
|
|
<span>Details of new features and bugs fixed in each release</span>
|
2012-05-06 17:50:22 +00:00
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="http://wiki.libvirt.org/page/Maintenance_Releases">Maintenance Releases</a>
|
|
|
|
|
<span>Details about libvirt maintenance releases</span>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
2008-04-23 17:08:31 +00:00
|
|
|
<ul>
|
|
|
|
|
<li>
|
2010-10-22 05:50:27 +00:00
|
|
|
<a href="http://libvirt.org/git/?p=libvirt.git;a=log">Git log</a>
|
2012-05-06 17:50:22 +00:00
|
|
|
<span>Latest commit messages from the source repository</span>
|
2008-04-23 17:08:31 +00:00
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
</li>
|
2011-01-20 06:17:41 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="apps.html">Applications</a>
|
|
|
|
|
<span>Applications known to use libvirt</span>
|
|
|
|
|
</li>
|
2008-04-23 17:08:31 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="downloads.html">Downloads</a>
|
|
|
|
|
<span>Get the latest source releases, binary builds and get access to the source repository</span>
|
2010-12-21 09:38:37 +00:00
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="windows.html">Windows</a>
|
|
|
|
|
<span>Downloads for Windows</span>
|
|
|
|
|
</li>
|
2011-01-26 05:00:33 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="bindings.html">Language bindings</a>
|
|
|
|
|
<span>Bindings of the libvirt API for languages other than C</span>
|
|
|
|
|
</li>
|
2010-12-21 09:38:37 +00:00
|
|
|
</ul>
|
2008-04-23 17:08:31 +00:00
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="docs.html">Documentation</a>
|
|
|
|
|
<span>Information for users, administrators and developers</span>
|
|
|
|
|
<ul>
|
2010-12-21 09:38:37 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="compiling.html">Compiling</a>
|
|
|
|
|
<span>How to compile libvirt</span>
|
|
|
|
|
</li>
|
2008-04-23 17:08:31 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="deployment.html">Deployment</a>
|
|
|
|
|
<span>Information about deploying and using libvirt</span>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="uri.html">URI format</a>
|
|
|
|
|
<span>The URI formats used for connecting to libvirt</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="remote.html">Remote access</a>
|
|
|
|
|
<span>Enable remote access over TCP</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="auth.html">Authentication</a>
|
|
|
|
|
<span>Configure authentication for the libvirt daemon</span>
|
|
|
|
|
</li>
|
2013-08-08 10:51:01 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="acl.html">Access control</a>
|
|
|
|
|
<span>Configure access control libvirt APIs</span>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="aclpolkit.html">Polkit access control</a>
|
|
|
|
|
<span>Using polkit for API access control</span>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
</li>
|
Add documentation about migration.
This adds a page documenting many aspects of migration:
- The types of migration (managed direct, p2p, unmanaged direct)
- Data transports (native, tunnelled)
- Migration URIs
- Config file handling
- Example scenarios
* libvirt.css: Rules for data tables and diagrams
* Makefile.am: Include extra png/fig files
* migration-managed-direct.fig, migration-managed-direct.png,
migration-managed-direct.png, migration-managed-p2p.png,
migration-native.fig, migration-native.png,
migration-tunnel.fig, migration-tunnel.png,
migration-unmanaged-direct.fig, migration-unmanaged-direct.png:
Diagrams of migration
* migration.html.in, sitemap.html.in: New migration doc
2009-10-02 16:53:51 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="migration.html">Migration</a>
|
|
|
|
|
<span>Migrating guests between machines</span>
|
|
|
|
|
</li>
|
2008-04-23 17:08:31 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="windows.html">Windows port</a>
|
|
|
|
|
<span>Access the libvirt daemon from a native Windows client</span>
|
|
|
|
|
</li>
|
2008-12-23 13:47:10 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="logging.html">Logging</a>
|
|
|
|
|
<span>The library and the daemon logging support</span>
|
|
|
|
|
</li>
|
2013-11-29 16:23:42 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="auditlog.html">Audit log</a>
|
|
|
|
|
<span>Audit trail logs for host operations</span>
|
|
|
|
|
</li>
|
2010-07-10 12:47:00 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="firewall.html">Firewall</a>
|
|
|
|
|
<span>Firewall and network filter configuration</span>
|
|
|
|
|
</li>
|
2011-06-24 12:50:08 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="locking.html">Disk locking</a>
|
|
|
|
|
<span>Ensuring exclusive guest access to disks</span>
|
2015-02-13 17:02:44 +00:00
|
|
|
<ul>
|
2015-02-16 11:58:32 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="locking-lockd.html">virtlockd</a>
|
|
|
|
|
<span>virtlockd lock manager plugin</span>
|
|
|
|
|
</li>
|
2015-02-13 17:02:44 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="locking-sanlock.html">Sanlock</a>
|
|
|
|
|
<span>Sanlock lock manager plugin</span>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
2011-06-24 12:50:08 +00:00
|
|
|
</li>
|
2013-05-03 15:58:26 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="cgroups.html">CGroups</a>
|
|
|
|
|
<span>Control groups integration</span>
|
|
|
|
|
</li>
|
2010-04-12 15:13:32 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="hooks.html">Hooks</a>
|
|
|
|
|
<span>Hooks for system specific management</span>
|
|
|
|
|
</li>
|
2016-03-29 11:19:56 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="nss.html">NSS module</a>
|
|
|
|
|
<span>Enable domain host name translation to IP addresses</span>
|
|
|
|
|
</li>
|
2008-04-23 17:08:31 +00:00
|
|
|
</ul>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="intro.html">Architecture</a>
|
|
|
|
|
<span>Overview of the logical subsystems in the libvirt API</span>
|
|
|
|
|
<ul>
|
2009-04-02 12:01:11 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="goals.html">Goals</a>
|
|
|
|
|
<span>Terminology and goals of libvirt API</span>
|
|
|
|
|
</li>
|
2009-04-15 20:42:50 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="api.html">API concepts</a>
|
|
|
|
|
<span>The libvirt API concepts</span>
|
|
|
|
|
</li>
|
2008-04-23 17:08:31 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="archdomain.html">Domains</a>
|
|
|
|
|
<span>Managing virtual machines</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="archnetwork.html">Network</a>
|
|
|
|
|
<span>Providing isolated networks and NAT based network connectivity</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="archstorage.html">Storage</a>
|
|
|
|
|
<span>Managing storage pools and volumes</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="archnode.html">Node Devices</a>
|
|
|
|
|
<span>Enumerating host node devices</span>
|
|
|
|
|
</li>
|
2013-10-14 17:05:19 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="secureusage.html">Secure usage</a>
|
|
|
|
|
<span>Secure usage of the libvirt APIs</span>
|
|
|
|
|
</li>
|
2008-04-23 17:08:31 +00:00
|
|
|
</ul>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="format.html">XML format</a>
|
|
|
|
|
<span>Description of the XML formats used in libvirt</span>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="formatdomain.html">Domains</a>
|
|
|
|
|
<span>The domain XML format</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="formatnetwork.html">Networks</a>
|
|
|
|
|
<span>The virtual network XML format</span>
|
2011-01-15 13:47:11 +00:00
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="formatnwfilter.html">Network Filtering</a>
|
|
|
|
|
<span>Network filter XML format</span>
|
2008-04-23 17:08:31 +00:00
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="formatstorage.html">Storage</a>
|
|
|
|
|
<span>The storage pool and volume XML format</span>
|
|
|
|
|
</li>
|
2009-08-19 19:50:10 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="formatstorageencryption.html">Storage Encryption</a>
|
|
|
|
|
<span>Storage volume encryption XML format</span>
|
|
|
|
|
</li>
|
2008-04-23 17:08:31 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="formatcaps.html">Capabilities</a>
|
|
|
|
|
<span>The driver capabilities XML format</span>
|
2014-06-25 11:24:53 +00:00
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="formatdomaincaps.html">Domain capabilities</a>
|
|
|
|
|
<span>The domain capabilities XML format</span>
|
2008-04-23 17:08:31 +00:00
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="formatnode.html">Node Devices</a>
|
|
|
|
|
<span>The host device XML format</span>
|
|
|
|
|
</li>
|
2009-07-28 00:39:48 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="formatsecret.html">Secrets</a>
|
|
|
|
|
<span>The secret XML format</span>
|
|
|
|
|
</li>
|
2010-04-05 17:27:41 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="formatsnapshot.html">Snapshots</a>
|
|
|
|
|
<span>The snapshot XML format</span>
|
|
|
|
|
</li>
|
2008-04-23 17:08:31 +00:00
|
|
|
</ul>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="drivers.html">Drivers</a>
|
|
|
|
|
<span>Hypervisor specific driver information</span>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="drvxen.html">Xen</a>
|
|
|
|
|
<span>Driver the Xen hypervisor</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="drvqemu.html">QEMU / KVM</a>
|
|
|
|
|
<span>Driver for QEMU, KQEMU, KVM and Xenner</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="drvlxc.html">Linux Container</a>
|
|
|
|
|
<span>Driver for the Linux native container API</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="drvtest.html">Test</a>
|
2010-01-25 14:58:40 +00:00
|
|
|
<span>Pseudo-driver simulating APIs in memory for test suites</span>
|
2008-04-23 17:08:31 +00:00
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="drvremote.html">Remote</a>
|
|
|
|
|
<span>Driver providing secure remote to the libvirt APIs</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="drvopenvz.html">OpenVZ</a>
|
|
|
|
|
<span>Driver for the OpenVZ container technology</span>
|
|
|
|
|
</li>
|
2008-11-19 16:58:23 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="drvuml.html">UML</a>
|
|
|
|
|
<span>Driver for the User Mode Linux technology</span>
|
|
|
|
|
</li>
|
2008-04-23 17:08:31 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="storage.html">Storage</a>
|
|
|
|
|
<span>Driver for the storage management APIs</span>
|
|
|
|
|
</li>
|
2009-04-21 12:24:14 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="drvvbox.html">VirtualBox</a>
|
|
|
|
|
<span>Driver for VirtualBox</span>
|
|
|
|
|
</li>
|
2009-11-13 21:43:10 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="drvesx.html">VMware ESX</a>
|
|
|
|
|
<span>Driver for VMware ESX</span>
|
|
|
|
|
</li>
|
2010-12-23 15:56:11 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="drvvmware.html">VMware Workstation / Player</a>
|
|
|
|
|
<span>Driver for VMware Workstation / Player</span>
|
|
|
|
|
</li>
|
2011-07-13 15:13:42 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="drvhyperv.html">Microsoft Hyper-V</a>
|
|
|
|
|
<span>Driver for Microsoft Hyper-V</span>
|
|
|
|
|
</li>
|
2013-02-14 15:06:58 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="drvphyp.html">IBM PowerVM</a>
|
|
|
|
|
<span>Driver for IBM PowerVM</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
2015-08-21 21:43:48 +00:00
|
|
|
<a href="drvvirtuozzo.html">Virtuozzo</a>
|
|
|
|
|
<span>Driver for Virtuozzo</span>
|
2013-02-14 15:06:58 +00:00
|
|
|
</li>
|
2014-03-01 09:04:56 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="drvbhyve.html">Bhyve</a>
|
|
|
|
|
<span>Driver for bhyve</span>
|
|
|
|
|
</li>
|
2008-04-23 17:08:31 +00:00
|
|
|
</ul>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="html/index.html">API reference</a>
|
|
|
|
|
<span>Reference manual for the C public API</span>
|
|
|
|
|
<!-- This is the desired new style API breakdown
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="apiconn.html">Connection</a>
|
|
|
|
|
<span>API reference for virConnectPtr objects</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="apidomain.html">Domain</a>
|
|
|
|
|
<span>API reference for virDomainPtr objects</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="apierror.html">Error</a>
|
|
|
|
|
<span>API reference for virErrorPtr objects</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="apinetwork.html">Network</a>
|
|
|
|
|
<span>API reference for virNetworkPtr objects</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="apistorage.html">Storage</a>
|
|
|
|
|
<span>API reference for virStoragePoolptr and virStorageVolPtr objects</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="apinode.html">Node Device</a>
|
|
|
|
|
<span>API reference for virNodeDevicePtr objects</span>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
-->
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
2014-11-11 16:28:26 +00:00
|
|
|
<a href="html/libvirt-libvirt-domain.html">Domain</a>
|
|
|
|
|
<span>domain APIs for the libvirt library</span>
|
2008-04-23 17:08:31 +00:00
|
|
|
</li>
|
|
|
|
|
<li>
|
2014-11-11 16:28:26 +00:00
|
|
|
<a href="html/libvirt-libvirt-domain-snapshot.html">Domain snapshot</a>
|
|
|
|
|
<span>domain snapshot APIs for the libvirt library</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="html/libvirt-virterror.html">Error</a>
|
|
|
|
|
<span>error handling APIs for the libvirt library</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="html/libvirt-libvirt-event.html">Event</a>
|
|
|
|
|
<span>event APIs for the libvirt library</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="html/libvirt-libvirt-host.html">Host</a>
|
|
|
|
|
<span>host APIs for the libvirt library</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="html/libvirt-libvirt-interface.html">Interface</a>
|
|
|
|
|
<span>interface APIs for the libvirt library</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="html/libvirt-libvirt-network.html">Network</a>
|
|
|
|
|
<span>network APIs for the libvirt library</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="html/libvirt-libvirt-nodedev.html">Node device</a>
|
|
|
|
|
<span>node device APIs for the libvirt library</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="html/libvirt-libvirt-nwfilter.html">Network filter</a>
|
|
|
|
|
<span>network filter APIs for the libvirt library</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="html/libvirt-libvirt-secret.html">Secret</a>
|
|
|
|
|
<span>secret APIs for the libvirt library</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="html/libvirt-libvirt-storage.html">Storage</a>
|
|
|
|
|
<span>storage APIs for the libvirt library</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="html/libvirt-libvirt-stream.html">Stream</a>
|
|
|
|
|
<span>stream APIs for the libvirt library</span>
|
2008-04-23 17:08:31 +00:00
|
|
|
</li>
|
2009-11-06 15:04:19 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="hvsupport.html">Driver support</a>
|
|
|
|
|
<span>matrix of API support per hypervisor per release</span>
|
|
|
|
|
</li>
|
2008-04-23 17:08:31 +00:00
|
|
|
</ul>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="bindings.html">Language bindings</a>
|
|
|
|
|
<span>Bindings of the libvirt API for other languages</span>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="python.html">Python</a>
|
|
|
|
|
<span>overview of the python API bindings</span>
|
|
|
|
|
</li>
|
2008-07-22 09:52:31 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="java.html">Java</a>
|
|
|
|
|
<span>overview of the Java API bindings</span>
|
|
|
|
|
</li>
|
2010-10-19 19:48:40 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="csharp.html">C#</a>
|
|
|
|
|
<span>overview of the C# API bindings</span>
|
|
|
|
|
</li>
|
2011-02-09 01:43:09 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="php.html">PHP</a>
|
|
|
|
|
<span>overview of the PHP API bindings</span>
|
|
|
|
|
</li>
|
2008-04-23 17:08:31 +00:00
|
|
|
</ul>
|
|
|
|
|
</li>
|
2009-06-09 11:42:41 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="internals.html">Internals</a>
|
|
|
|
|
<span>Working on the internals of libvirt API, driver and daemon code</span>
|
|
|
|
|
<ul>
|
2009-11-06 15:04:19 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="hacking.html">Contributor guidelines</a>
|
|
|
|
|
<span>General hacking guidelines for contributors</span>
|
|
|
|
|
</li>
|
2009-06-09 11:42:41 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="api_extension.html">API extensions</a>
|
|
|
|
|
<span>Adding new public libvirt APIs</span>
|
|
|
|
|
</li>
|
2010-05-25 13:14:46 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="internals/command.html">Spawning commands</a>
|
|
|
|
|
<span>Spawning commands from libvirt driver code</span>
|
|
|
|
|
</li>
|
2011-08-11 15:11:31 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="internals/rpc.html">RPC protocol & APIs</a>
|
|
|
|
|
<span>RPC protocol information and API / dispatch guide</span>
|
|
|
|
|
</li>
|
2010-11-22 16:44:13 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="internals/locking.html">Lock managers</a>
|
|
|
|
|
<span>Use lock managers to protect disk content</span>
|
|
|
|
|
</li>
|
Introduce new OOM testing support
The previous OOM testing support would re-run the entire "main"
method each iteration, failing a different malloc each time.
When a test suite has 'n' allocations, the number of repeats
requires is (n * (n + 1) ) / 2. This gets very large, very
quickly.
This new OOM testing support instead integrates at the
virtTestRun level, so each individual test case gets repeated,
instead of the entire test suite. This means the values of
'n' are orders of magnitude smaller.
The simple usage is
$ VIR_TEST_OOM=1 ./qemuxml2argvtest
...
29) QEMU XML-2-ARGV clock-utc ... OK
Test OOM for nalloc=36 .................................... OK
30) QEMU XML-2-ARGV clock-localtime ... OK
Test OOM for nalloc=36 .................................... OK
31) QEMU XML-2-ARGV clock-france ... OK
Test OOM for nalloc=38 ...................................... OK
...
the second lines reports how many mallocs have to be failed, and thus
how many repeats of the test will be run.
If it crashes, then running under valgrind will often show the problem
$ VIR_TEST_OOM=1 ../run valgrind ./qemuxml2argvtest
When debugging problems it is also helpful to select an individual
test case
$ VIR_TEST_RANGE=30 VIR_TEST_OOM=1 ../run valgrind ./qemuxml2argvtest
When things get really tricky, it is possible to request that just
specific allocs are failed. eg to fail allocs 5 -> 12, use
$ VIR_TEST_RANGE=30 VIR_TEST_OOM=1:5-12 ../run valgrind ./qemuxml2argvtest
In the worse case, you might want to know the stack trace of the
alloc which was failed then VIR_TEST_OOM_TRACE can be set. If it
is set to 1 then it will only print if it thinks a mistake happened.
This is often not reliable, so setting it to 2 will make it print
the stack trace for every alloc that is failed.
$ VIR_TEST_OOM_TRACE=2 VIR_TEST_RANGE=30 VIR_TEST_OOM=1:5-5 ../run valgrind ./qemuxml2argvtest
30) QEMU XML-2-ARGV clock-localtime ... OK
Test OOM for nalloc=36 !virAllocN
/home/berrange/src/virt/libvirt/src/util/viralloc.c:180
virHashCreateFull
/home/berrange/src/virt/libvirt/src/util/virhash.c:144
virDomainDefParseXML
/home/berrange/src/virt/libvirt/src/conf/domain_conf.c:11745
virDomainDefParseNode
/home/berrange/src/virt/libvirt/src/conf/domain_conf.c:12646
virDomainDefParse
/home/berrange/src/virt/libvirt/src/conf/domain_conf.c:12590
testCompareXMLToArgvFiles
/home/berrange/src/virt/libvirt/tests/qemuxml2argvtest.c:106
virtTestRun
/home/berrange/src/virt/libvirt/tests/testutils.c:250
mymain
/home/berrange/src/virt/libvirt/tests/qemuxml2argvtest.c:418 (discriminator 2)
virtTestMain
/home/berrange/src/virt/libvirt/tests/testutils.c:750
??
??:0
_start
??:?
FAILED
Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2013-09-23 13:21:52 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="internals/oomtesting.html">Out of memory testing</a>
|
|
|
|
|
<span>Simulating OOM conditions in the test suite</span>
|
|
|
|
|
</li>
|
2009-06-09 11:42:41 +00:00
|
|
|
</ul>
|
|
|
|
|
</li>
|
2010-09-10 09:26:05 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="devguide.html">Development Guide</a>
|
|
|
|
|
<span>A guide and reference for developing with libvirt</span>
|
|
|
|
|
</li>
|
2010-11-12 16:40:38 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="virshcmdref.html">Virsh Commands</a>
|
|
|
|
|
<span>Command reference for virsh</span>
|
|
|
|
|
</li>
|
2014-02-03 18:24:49 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="governance.html">Governance</a>
|
|
|
|
|
<span>Project governance and code of conduct</span>
|
|
|
|
|
</li>
|
2008-04-23 17:08:31 +00:00
|
|
|
</ul>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="http://wiki.libvirt.org">Wiki</a>
|
|
|
|
|
<span>User contributed content</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
2010-07-26 14:32:42 +00:00
|
|
|
<a href="http://wiki.libvirt.org/page/FAQ">FAQ</a>
|
2008-04-23 17:08:31 +00:00
|
|
|
<span>Frequently asked questions</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="bugs.html">Bug reports</a>
|
|
|
|
|
<span>How and where to report bugs and request features</span>
|
2010-09-21 15:40:32 +00:00
|
|
|
<ul>
|
Document security reporting & handling process
Historically security issues in libvirt have been primarily
triaged & fixed by the Red Hat libvirt members & Red Hat
security team, who then usually notify other vendors via
appropriate channels. There have been a number of times
when vendors have not been properly notified ahead of
announcement. It has also disadvantaged community members
who have to backport fixes to releases for which there are
no current libvirt stable branches.
To address this, we want to make the libvirt security process
entirely community focused / driven. To this end I have setup
a new email address "libvirt-security@redhat.com" for end
users to report bugs which have (possible) security implications.
This email addr is backed by an invitation only, private
archive, mailing list. The intent is for the list membership
to comprise a subset of the libvirt core team, along with any
vendor security team engineers who wish to participate in a
responsible disclosure process for libvirt. Members of the
list will be responsible for analysing the problem to determine
if a security issue exists and then issue fixes for all current
official stable branches & git master.
I am proposing the following libvirt core team people as
members of the security team / list (all cc'd):
Daniel Berrange (Red Hat)
Eric Blake (Red Hat)
Jiri Denemar (Red Hat)
Daniel Veillard (Red Hat)
Jim Fehlig (SUSE)
Doug Goldstein (Gentoo)
Guido Günther (Debian)
We don't have anyone from Ubuntu on the libvirt core team.
Serge Hallyn is the most frequent submitter of patches from
Ubuntu in recent history, so I'd like to invite him to join.
Alternatively, Serge, feel free to suggest someone else to
represent Ubuntu's interests.
If any other vendors/distros have security people who are
responsible for dealing with libvirt security issues, and
want to join to get early disclosure of issues, they can
suggest people. Existing security team members will vet /
approve such requests to ensure they are genuine.
Anyone on the team / list will be **required** to honour any
embargo period agreed between members for non-public issues
that are reported. The aim will be to have a maximum 2 week
embargo period in the common case, extendable to 1 month if
there is sufficient justification made. If anyone feels they
are unable to follow such an embargo process for whatever
reason, please decline membership of the security list/team.
The patch which follows puts up some docs on the website
about all of this....
Document how to report security bugs and the process that
will be used for addressing them.
Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2013-06-04 10:06:01 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="securityprocess.html">Security Process</a>
|
|
|
|
|
<span>Security bug reporting and resolution process</span>
|
|
|
|
|
</li>
|
2010-09-21 15:40:32 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="todo.html">Todo list</a>
|
|
|
|
|
<span>Main feature request list</span>
|
|
|
|
|
</li>
|
2012-04-13 14:52:03 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="pending.html">Pending patches</a>
|
|
|
|
|
<span>Pending patches awaiting reviews and integration</span>
|
|
|
|
|
</li>
|
2010-09-21 15:40:32 +00:00
|
|
|
</ul>
|
2008-04-23 17:08:31 +00:00
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="contact.html">Contact</a>
|
|
|
|
|
<span>How to contact the developers via email and IRC</span>
|
|
|
|
|
</li>
|
2011-05-11 11:18:38 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="testsuites.html">Test suites</a>
|
|
|
|
|
<span>Available test suites for libvirt</span>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="testtck.html">TCK test suite</a>
|
|
|
|
|
<span>Virtualization functional test suite in Perl</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="testapi.html">Libvirt-test-API</a>
|
|
|
|
|
<span>Libvirt functional API test suite in Python</span>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
</li>
|
2008-04-23 17:08:31 +00:00
|
|
|
<li>
|
|
|
|
|
<a href="relatedlinks.html">Related Links</a>
|
|
|
|
|
<span>Miscellaneous links of interest related to libvirt</span>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="sitemap.html">Sitemap</a>
|
|
|
|
|
<span>Overview of all content on the website</span>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
</div>
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
