External/libvirt
1
0
Fork 0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2024-12-22 13:45:38 +00:00
Code Issues Packages Projects Releases Wiki Activity

* NEWS docs/*: regenerated and updated the docs post 0.0.3 release

Browse Source 
Daniel
This commit is contained in:
Daniel Veillard 2006-02-10 08:43:31 +00:00
parent 0b2869fb84
commit f2fec34604
11 changed files with 108 additions and 88 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
ChangeLog
View File

@ -1,3 +1,7 @@
Fri Feb 10 09:42:45 CET 2006 Daniel Veillard <veillard@redhat.com>
* NEWS docs/*: regenerated and updated the docs post 0.0.3 release
Fri Feb 10 09:39:23 CET 2006 Daniel Veillard <veillard@redhat.com> Fri Feb 10 09:39:23 CET 2006 Daniel Veillard <veillard@redhat.com>
* autogen.sh configure.in: fixed snapshot autogeneration, had to * autogen.sh configure.in: fixed snapshot autogeneration, had to

6
NEWS
View File

@ -5,6 +5,12 @@
http://libvirt.org/news.html http://libvirt.org/news.html
Releases Releases
0.0.3: Feb 9 2006:
- Switch name from from 'libvir' to libvirt
- Starting infrastructure to add code examples
- Update of python bindings for completeness
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 for

38
docs/FAQ.html
View File

@ -4,30 +4,30 @@
<li><a href="FAQ.html#Installati">Installation</a></li> <li><a href="FAQ.html#Installati">Installation</a></li>
<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 libvir</em> </ul><h3><a name="License" id="License">License</a>(s)</h3><ol><li><em>Licensing Terms for libvirt</em>
<p>libvir 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 Lesser
General Public License</a>, see the file COPYING.LIB in the distribution General Public License</a>, see the file COPYING.LIB in the distribution
for the precise wording. The only library that libvir depends upon is the for the precise wording. The only library that libvirt depends upon is the
Xen store access library which is also licenced under the LGPL.</p> Xen store access library which is also licenced under the LGPL.</p>
</li> </li>
<li><em>Can I embed libvir in a proprietary application ?</em> <li><em>Can I embed libvirt in a proprietary application ?</em>
<p>Yes. The LGPL allows you to embed libvir into a proprietary <p>Yes. The LGPL allows you to embed libvirt into a proprietary
application. It would be graceful to send-back bug fixes and improvements application. It would be graceful to send-back bug fixes and improvements
as patches for possible incorporation in the main development tree. It as patches for possible incorporation in the main development tree. It
will decrease your maintainance costs anyway if you do so.</p> will 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 libvir</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://libvir.org/libvir/">ftp://libvir.org/libvir/</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 libvir/libvir-devel RPM packages due to failed <li><em>I can't install the libvirt/libvirt-devel RPM packages due to 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 , and
rebuild it locally with</p> rebuild it locally with</p>
<p><code>rpm --rebuild libvir-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 (one
providing the shared libs and virsh, and the other one, the -devel providing the shared libs and virsh, and the other one, the -devel
package, providing includes, static libraries and scripts needed to build package, providing includes, static libraries and scripts needed to build
applications with libvir that you can install locally.</p> applications 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>
@ -49,10 +49,10 @@
following command run as root:</p> following 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 libvir ?</em> </ol><h3><a name="Compilatio" id="Compilatio">Compilation</a></h3><ol><li><em>What is the process to compile libvirt ?</em>
<p>As most UNIX libraries libvir follows the "standard":</p> <p>As most UNIX libraries libvirt follows the "standard":</p>
<p><code>gunzip -c libvir-xxx.tar.gz | tar xvf -</code></p> <p><code>gunzip -c libvirt-xxx.tar.gz | tar xvf -</code></p>
<p><code>cd libvir-xxxx</code></p> <p><code>cd libvirt-xxxx</code></p>
<p><code>./configure --help</code></p> <p><code>./configure --help</code></p>
<p>to see the options, then the compilation/installation proper</p> <p>to see the options, then the compilation/installation proper</p>
<p><code>./configure [possible options]</code></p> <p><code>./configure [possible options]</code></p>
@ -61,7 +61,7 @@
<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 to
update your list of installed shared libs.</p> update your list of installed shared libs.</p>
</li> </li>
<li><em>What other libraries are needed to compile/install libvir ?</em> <li><em>What other libraries are needed to compile/install libvirt ?</em>
<p>Libvir requires libxenstore, which is usually provided by the xen <p>Libvir requires libxenstore, which is usually provided by the xen
packages as well as the public headers to compile against libxenstore.</p> packages as well as the public headers to compile against libxenstore.</p>
</li> </li>
@ -71,10 +71,10 @@
like:</p> 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 libvir</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, libvir comes with <p>To simplify the process of reusing the library, libvirt comes with
pkgconfig support, which can be used directly from autoconf support or pkgconfig support, which can be used directly from autoconf support or
via the pkg-config command line tool, like:</p> via the pkg-config command line tool, like:</p>
<p><code>pkg-config libvir --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">libvir architecture</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a style="font-weight:bold" href="html/index.html">API Menu</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="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="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a style="font-weight:bold" href="html/index.html">API Menu</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="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>

8
docs/architecture.html
View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /><link rel="stylesheet" type="text/css" href="libvirt.css" /><link rel="SHORTCUT ICON" href="/32favicon.png" /><title>libvir architecture</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">libvir architecture</h1><h3>This is Xen specific since this is the only hypervisor supported at 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>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><h3>This is Xen specific since this is the only hypervisor supported at the
moment</h3><p>When running in a Xen environment, programs using libvir have to execute moment</h3><p>When running in a Xen environment, programs using libvirt have to execute
in "Domain 0", which is the primary Linux OS loaded on the machine. That OS in "Domain 0", which is the primary Linux OS loaded on the machine. That OS
kernel provides most if not all of the actual drivers used by the set of kernel provides most if not all of the actual drivers used by the set of
domains. It also runs the Xen Store, a database of informations shared by the domains. It also runs the Xen Store, a database of informations shared by the
@ -18,10 +18,10 @@ the Xen infrastructure:</p><ul><li>a connection to the Xen Daemon though an HTTP
</ul><p>The library will usually interract with the Xen daemon for any operation </ul><p>The library will usually interract with the Xen daemon for any operation
changing the state of the system, but for performance and accuracy reasons changing the state of the system, but for performance and accuracy reasons
may talk directly to the hypervisor when gathering state informations at may talk directly to the hypervisor when gathering state informations at
least when possible (i.e. when the running program using libvir has root least when possible (i.e. when the running program using libvirt has root
priviledge access).</p><p>If it runs without root access virConnectOpenReadOnly() should be used to priviledge access).</p><p>If it runs without root access virConnectOpenReadOnly() should be used to
connect to initialize the library. It will try to open the read-only socket connect to initialize the library. It will try to open the read-only socket
<code>/var/run/xenstored/socket_ro</code> to connect to the Xen Store and <code>/var/run/xenstored/socket_ro</code> to connect to the Xen Store and
also try to use the RPC to the Xen daemon. In this case use of hypervisor also try to use the RPC to the Xen daemon. In this case use of hypervisor
calls and write to the Xen Store will not be possible, restraining the amount calls and write to the Xen Store will not be possible, restraining the amount
of APIs available and slowing down information gathering about domains.</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">libvir architecture</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a style="font-weight:bold" href="html/index.html">API Menu</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="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> of APIs available and slowing down information gathering about domains.</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="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a style="font-weight:bold" href="html/index.html">API Menu</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="http://www.cl.cam.ac.uk/Research/SRG/netos/xen/index.html">Xen project</a></li><li><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="12" value="Search..." /><input name="submit" type="submit" value="Go" /></form></li><li><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-90x34.gif" alt="Made with Libxml2 Logo" /></a></li></ul><p class="credits">Graphics and design by <a href="mail:dfong@redhat.com">Diana Fong</a></p></div></div><div id="bottom"><p class="p1"></p></div></div></body></html>

6
docs/bugs.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>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 libvir, <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,
with an <a href="https://www.redhat.com/archives/libvir-list/">on-line with an <a href="https://www.redhat.com/archives/libvir-list/">on-line
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> 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>
page and follow the instructions. Patches with explanations and provided as page and follow the instructions. Patches with explanations and provided as
attachments are really appreciated and will be discussed on the mailing list. attachments are really appreciated and will be discussed on the mailing list.
If possible generate the patches by using cvs diff -u in a CVS checkout.</p><p>We expect to use <a href="https://bugzilla.redhat.com/">Red Hat If possible generate the patches by using cvs diff -u in a CVS checkout.</p><p>We expect to use <a href="https://bugzilla.redhat.com/">Red Hat
Bugzilla</a> to track bugs for libvir, though there isn't a libvir software Bugzilla</a> to track bugs for libvirt, though there isn't a libvirt software
module defined yet, in the meantime use the mailing-list, 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">libvir architecture</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a style="font-weight:bold" href="html/index.html">API Menu</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="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> module defined yet, in the meantime use the mailing-list, 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="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a style="font-weight:bold" href="html/index.html">API Menu</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="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>

10
docs/downloads.html
View File

@ -1,9 +1,9 @@
<?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 libvir can be found on the <a href="ftp://libvir.org/libvir/">libvir.org</a> server ( <a href="http://libvir.org/sources/">HTTP</a>, <a href="ftp://libvir.org/libvir/">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 released
versions as well as <a href="http://libvir.org/sources/libvir-cvs-snapshot.tar.gz">snapshot versions as well as <a href="http://libvirt.org/sources/libvirt-cvs-snapshot.tar.gz">snapshot
tarballs</a> updated from CVS head every hour</p><p>Anonymous <a href="http://ximbiot.com/cvs/cvshome/docs/">CVS</a> is also tarballs</a> updated from CVS head every hour</p><p>Anonymous <a href="http://ximbiot.com/cvs/cvshome/docs/">CVS</a> is also
available, first register onto the server:</p><p><code>cvs -d :pserver:anoncvs@libvir.org:2401/data/cvs login</code></p><p>it will request a password, enter <strong>anoncvs</strong>. Then you can 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
checkout the development tree with:</p><p><code>cvs -d :pserver:anoncvs@libvir.org:2401/data/cvs co libvir</code></p><p>Use ./autogen.sh to configure the local checkout, then <code>make</code> checkout the development tree with:</p><p><code>cvs -d :pserver:anoncvs@libvirt.org:2401/data/cvs co libvirt</code></p><p>Use ./autogen.sh to configure the local checkout, then <code>make</code>
and <code>make install</code>, as usual. All normal cvs commands are now and <code>make install</code>, as usual. All normal cvs commands are now
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">libvir architecture</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a style="font-weight:bold" href="html/index.html">API Menu</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="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> 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="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a style="font-weight:bold" href="html/index.html">API Menu</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="http://www.cl.cam.ac.uk/Research/SRG/netos/xen/index.html">Xen project</a></li><li><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="12" value="Search..." /><input name="submit" type="submit" value="Go" /></form></li><li><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-90x34.gif" alt="Made with Libxml2 Logo" /></a></li></ul><p class="credits">Graphics and design by <a href="mail:dfong@redhat.com">Diana Fong</a></p></div></div><div id="bottom"><p class="p1"></p></div></div></body></html>

4
docs/index.html
View File

@ -14,7 +14,7 @@
<p class="p1"></p> <p class="p1"></p>
</div> </div>
<div id="content"> <div id="content">
<h3>what is <span class="style1">libvir?</span></h3> <h3>what is <span class="style1">libvirt?</span></h3>
<p>Libvir is a C toolkit to interract with the virtualization capabilities of <p>Libvir is a C toolkit to interract with the virtualization capabilities of
recent versions of Linux (and other OSes). It is free software available recent versions of Linux (and other OSes). It is free software available
under the <a href="http://www.opensource.org/licenses/lgpl-license.html">GNU under the <a href="http://www.opensource.org/licenses/lgpl-license.html">GNU
@ -41,7 +41,7 @@ mechanisms if needed.</p>
<a href="intro.html">Introduction</a> <a href="intro.html">Introduction</a>
</li> </li>
<li> <li>
<a href="architecture.html">libvir architecture</a> <a href="architecture.html">libvirt architecture</a>
</li> </li>
<li> <li>
<a href="downloads.html">Downloads</a> <a href="downloads.html">Downloads</a>

18
docs/intro.html
View File

@ -1,30 +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>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>Libvir 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>Libvir is a C toolkit to interact with the virtualization capabilities of
recent versions of Linux (and other OSes), but libvir won't try to provide recent versions of Linux (and other OSes), but libvirt won't try to provide
all possible interfaces for interacting with the virtualization features.</p><p>To avoid ambiguity about the terms used here here are the definitions for all possible interfaces for interacting with the virtualization features.</p><p>To avoid ambiguity about the terms used here here are the definitions for
some of the specific concepts used in libvir documentation:</p><ul><li>a <strong>node</strong> is a single physical machine</li> some of the specific concepts used in libvirt documentation:</p><ul><li>a <strong>node</strong> is a single physical machine</li>
<li>an <strong>hypervisor</strong> is a layer of software allowing to <li>an <strong>hypervisor</strong> is a layer of software allowing to
virtualize a node in a set of virtual machines with possibly different virtualize a node in a set of virtual machines with possibly different
configurations than the node itself</li> configurations than the node itself</li>
<li>a <strong>domain</strong> is an instance of an operating system running <li>a <strong>domain</strong> is an instance of an operating system running
on a virtualized machine provided by the hypervisor</li> on a virtualized machine provided by the hypervisor</li>
</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 libvir: to provide the lowest possible </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
generic and stable layer to manage domains on a node.</p><p>This implies the following:</p><ul><li>the API should not be targetted to a single virtualization environment generic and stable layer to manage domains on a node.</p><p>This implies the following:</p><ul><li>the API should not be targetted to a single virtualization environment
though Xen is the current default, which also means that some very though Xen is the current default, which also means that some very
specific capabilities which are not generic enough may not be provided as specific capabilities which are not generic enough may not be provided as
libvir APIs</li> libvirt APIs</li>
<li>the API should allow to do efficiently and cleanly all the operations <li>the API should allow to do efficiently and cleanly all the operations
needed to manage domains on a node</li> needed to manage domains on a node</li>
<li>the API will not try to provide hight level multi-nodes management <li>the API will not try to provide hight level multi-nodes management
features like load balancing, though they could be implemented on top of features like load balancing, though they could be implemented on top of
libvir</li> libvirt</li>
<li>stability of the API is a big concern, libvir should isolate <li>stability of the API is a big concern, libvirt should isolate
applications from the frequent changes expected at the lower level of the applications from the frequent changes expected at the lower level of the
virtualization framework</li> virtualization framework</li>
</ul><p>So libvir should be a building block for higher level management tools and </ul><p>So libvirt should be a building block for higher level management tools and
for applications focusing on virtualization of a single node (the only for applications focusing on virtualization of a single node (the only
exception being domain migration between node capabilities which may need to exception being domain migration between node capabilities which may need to
be added at the libvir level). Where possible libvir should be extendable to be added at the libvirt level). Where possible libvirt should be extendable to
be able to provide the same API for remote nodes, however this is not the be able to provide the same API for remote nodes, however this is not the
case at the moment, the code currently handle only local node accesses.</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">libvir architecture</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a style="font-weight:bold" href="html/index.html">API Menu</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="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> case at the moment, the code currently handle only local node accesses.</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="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a style="font-weight:bold" href="html/index.html">API Menu</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="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>

89
docs/libvir.html
View File

@ -10,9 +10,9 @@
<h1>Note: this is the flat content of the <a href="index.html">web <h1>Note: this is the flat content of the <a href="index.html">web
site</a></h1> site</a></h1>
<h1 style="text-align: center">libvir</h1> <h1 style="text-align: center">libvirt</h1>
<h3>what is <span class="style1">libvir?</span></h3> <h3>what is <span class="style1">libvirt?</span></h3>
<p>Libvir is a C toolkit to interract with the virtualization capabilities of <p>Libvir is a C toolkit to interract with the virtualization capabilities of
recent versions of Linux (and other OSes). It is free software available recent versions of Linux (and other OSes). It is free software available
@ -29,10 +29,17 @@ mechanisms if needed.</p>
<h2><a name="News">Releases</a></h2> <h2><a name="News">Releases</a></h2>
<p>Here is the list of official releases, however since it is early on in the <p>Here is the list of official releases, however since it is early on in the
development of libvir, it is preferable when possible to just use the <a 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 href="downloads.html">CVS version or snapshot</a>, contact the mailing list
and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progresses.</p> and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progresses.</p>
<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>Update of python bindings for completeness</li>
</ul>
<h3>0.0.2: Jan 29 2006</h3> <h3>0.0.2: Jan 29 2006</h3>
<ul> <ul>
<li>Update of the documentation, web site redesign (Diana Fong)</li> <li>Update of the documentation, web site redesign (Diana Fong)</li>
@ -54,11 +61,11 @@ and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progresses.</p>
<h2><a name="Introducti">Introduction</a></h2> <h2><a name="Introducti">Introduction</a></h2>
<p>Libvir is a C toolkit to interact with the virtualization capabilities of <p>Libvir is a C toolkit to interact with the virtualization capabilities of
recent versions of Linux (and other OSes), but libvir won't try to provide recent versions of Linux (and other OSes), but libvirt won't try to provide
all possible interfaces for interacting with the virtualization features.</p> all possible interfaces for interacting with the virtualization features.</p>
<p>To avoid ambiguity about the terms used here here are the definitions for <p>To avoid ambiguity about the terms used here here are the definitions for
some of the specific concepts used in libvir documentation:</p> some of the specific concepts used in libvirt documentation:</p>
<ul> <ul>
<li>a <strong>node</strong> is a single physical machine</li> <li>a <strong>node</strong> is a single physical machine</li>
<li>an <strong>hypervisor</strong> is a layer of software allowing to <li>an <strong>hypervisor</strong> is a layer of software allowing to
@ -71,7 +78,7 @@ some of the specific concepts used in libvir documentation:</p>
<p style="text-align: center"><img <p style="text-align: center"><img
alt="Hypervisor and domains running on a node" src="node.gif"></p> alt="Hypervisor and domains running on a node" src="node.gif"></p>
<p>Now we can define the goal of libvir: to provide the lowest possible <p>Now we can define the goal of libvirt: to provide the lowest possible
generic and stable layer to manage domains on a node.</p> generic and stable layer to manage domains on a node.</p>
<p>This implies the following:</p> <p>This implies the following:</p>
@ -79,30 +86,30 @@ generic and stable layer to manage domains on a node.</p>
<li>the API should not be targetted to a single virtualization environment <li>the API should not be targetted to a single virtualization environment
though Xen is the current default, which also means that some very though Xen is the current default, which also means that some very
specific capabilities which are not generic enough may not be provided as specific capabilities which are not generic enough may not be provided as
libvir APIs</li> libvirt APIs</li>
<li>the API should allow to do efficiently and cleanly all the operations <li>the API should allow to do efficiently and cleanly all the operations
needed to manage domains on a node</li> needed to manage domains on a node</li>
<li>the API will not try to provide hight level multi-nodes management <li>the API will not try to provide hight level multi-nodes management
features like load balancing, though they could be implemented on top of features like load balancing, though they could be implemented on top of
libvir</li> libvirt</li>
<li>stability of the API is a big concern, libvir should isolate <li>stability of the API is a big concern, libvirt should isolate
applications from the frequent changes expected at the lower level of the applications from the frequent changes expected at the lower level of the
virtualization framework</li> virtualization framework</li>
</ul> </ul>
<p>So libvir should be a building block for higher level management tools and <p>So libvirt should be a building block for higher level management tools and
for applications focusing on virtualization of a single node (the only for applications focusing on virtualization of a single node (the only
exception being domain migration between node capabilities which may need to exception being domain migration between node capabilities which may need to
be added at the libvir level). Where possible libvir should be extendable to be added at the libvirt level). Where possible libvirt should be extendable to
be able to provide the same API for remote nodes, however this is not the be able to provide the same API for remote nodes, however this is not the
case at the moment, the code currently handle only local node accesses.</p> case at the moment, the code currently handle only local node accesses.</p>
<h2><a name="architecture">libvir architecture</a></h2> <h2><a name="architecture">libvirt architecture</a></h2>
<h3>This is Xen specific since this is the only hypervisor supported at the <h3>This is Xen specific since this is the only hypervisor supported at the
moment</h3> moment</h3>
<p>When running in a Xen environment, programs using libvir have to execute <p>When running in a Xen environment, programs using libvirt have to execute
in "Domain 0", which is the primary Linux OS loaded on the machine. That OS in "Domain 0", which is the primary Linux OS loaded on the machine. That OS
kernel provides most if not all of the actual drivers used by the set of kernel provides most if not all of the actual drivers used by the set of
domains. It also runs the Xen Store, a database of informations shared by the domains. It also runs the Xen Store, a database of informations shared by the
@ -126,7 +133,7 @@ the Xen infrastructure:</p>
<p>The library will usually interract with the Xen daemon for any operation <p>The library will usually interract with the Xen daemon for any operation
changing the state of the system, but for performance and accuracy reasons changing the state of the system, but for performance and accuracy reasons
may talk directly to the hypervisor when gathering state informations at may talk directly to the hypervisor when gathering state informations at
least when possible (i.e. when the running program using libvir has root least when possible (i.e. when the running program using libvirt has root
priviledge access).</p> priviledge access).</p>
<p>If it runs without root access virConnectOpenReadOnly() should be used to <p>If it runs without root access virConnectOpenReadOnly() should be used to
@ -138,23 +145,23 @@ of APIs available and slowing down information gathering about domains.</p>
<h2><a name="Downloads">Downloads</a></h2> <h2><a name="Downloads">Downloads</a></h2>
<p>The latest versions of libvir can be found on the <a <p>The latest versions of libvirt can be found on the <a
href="ftp://libvir.org/libvir/">libvir.org</a> server ( <a href="ftp://libvirt.org/libvirt/">libvirt.org</a> server ( <a
href="http://libvir.org/sources/">HTTP</a>, <a href="http://libvirt.org/sources/">HTTP</a>, <a
href="ftp://libvir.org/libvir/">FTP</a>). You will find there the released href="ftp://libvirt.org/libvirt/">FTP</a>). You will find there the released
versions as well as <a versions as well as <a
href="http://libvir.org/sources/libvir-cvs-snapshot.tar.gz">snapshot href="http://libvirt.org/sources/libvirt-cvs-snapshot.tar.gz">snapshot
tarballs</a> updated from CVS head every hour</p> tarballs</a> updated from CVS head every hour</p>
<p>Anonymous <a href="http://ximbiot.com/cvs/cvshome/docs/">CVS</a> is also <p>Anonymous <a href="http://ximbiot.com/cvs/cvshome/docs/">CVS</a> is also
available, first register onto the server:</p> available, first register onto the server:</p>
<p><code>cvs -d :pserver:anoncvs@libvir.org:2401/data/cvs login</code></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 <p>it will request a password, enter <strong>anoncvs</strong>. Then you can
checkout the development tree with:</p> checkout the development tree with:</p>
<p><code>cvs -d :pserver:anoncvs@libvir.org:2401/data/cvs co libvir</code></p> <p><code>cvs -d :pserver:anoncvs@libvirt.org:2401/data/cvs co libvirt</code></p>
<p>Use ./autogen.sh to configure the local checkout, then <code>make</code> <p>Use ./autogen.sh to configure the local checkout, then <code>make</code>
and <code>make install</code>, as usual. All normal cvs commands are now and <code>make install</code>, as usual. All normal cvs commands are now
@ -172,15 +179,15 @@ available except commiting to the base.</p>
<h3><a name="License">License</a>(s)</h3> <h3><a name="License">License</a>(s)</h3>
<ol> <ol>
<li><em>Licensing Terms for libvir</em> <li><em>Licensing Terms for libvirt</em>
<p>libvir is released under the <a <p>libvirt is released under the <a
href="http://www.opensource.org/licenses/lgpl-license.html">GNU Lesser href="http://www.opensource.org/licenses/lgpl-license.html">GNU Lesser
General Public License</a>, see the file COPYING.LIB in the distribution General Public License</a>, see the file COPYING.LIB in the distribution
for the precise wording. The only library that libvir depends upon is the for the precise wording. The only library that libvirt depends upon is the
Xen store access library which is also licenced under the LGPL.</p> Xen store access library which is also licenced under the LGPL.</p>
</li> </li>
<li><em>Can I embed libvir in a proprietary application ?</em> <li><em>Can I embed libvirt in a proprietary application ?</em>
<p>Yes. The LGPL allows you to embed libvir into a proprietary <p>Yes. The LGPL allows you to embed libvirt into a proprietary
application. It would be graceful to send-back bug fixes and improvements application. It would be graceful to send-back bug fixes and improvements
as patches for possible incorporation in the main development tree. It as patches for possible incorporation in the main development tree. It
will decrease your maintainance costs anyway if you do so.</p> will decrease your maintainance costs anyway if you do so.</p>
@ -189,19 +196,19 @@ available except commiting to the base.</p>
<h3><a name="Installati">Installation</a></h3> <h3><a name="Installati">Installation</a></h3>
<ol> <ol>
<li><em>Where can I get libvir</em> ? <li><em>Where can I get libvirt</em> ?
<p>The original distribution comes from <a <p>The original distribution comes from <a
href="ftp://libvir.org/libvir/">ftp://libvir.org/libvir/</a>.</p> href="ftp://libvirt.org/libvirt/">ftp://libvirt.org/libvirt/</a>.</p>
</li> </li>
<li><em>I can't install the libvir/libvir-devel RPM packages due to failed <li><em>I can't install the libvirt/libvirt-devel RPM packages due to 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 , and
rebuild it locally with</p> rebuild it locally with</p>
<p><code>rpm --rebuild libvir-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 (one
providing the shared libs and virsh, and the other one, the -devel providing the shared libs and virsh, and the other one, the -devel
package, providing includes, static libraries and scripts needed to build package, providing includes, static libraries and scripts needed to build
applications with libvir that you can install locally.</p> applications 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>
@ -227,10 +234,10 @@ available except commiting to the base.</p>
<h3><a name="Compilatio">Compilation</a></h3> <h3><a name="Compilatio">Compilation</a></h3>
<ol> <ol>
<li><em>What is the process to compile libvir ?</em> <li><em>What is the process to compile libvirt ?</em>
<p>As most UNIX libraries libvir follows the "standard":</p> <p>As most UNIX libraries libvirt follows the "standard":</p>
<p><code>gunzip -c libvir-xxx.tar.gz | tar xvf -</code></p> <p><code>gunzip -c libvirt-xxx.tar.gz | tar xvf -</code></p>
<p><code>cd libvir-xxxx</code></p> <p><code>cd libvirt-xxxx</code></p>
<p><code>./configure --help</code></p> <p><code>./configure --help</code></p>
<p>to see the options, then the compilation/installation proper</p> <p>to see the options, then the compilation/installation proper</p>
<p><code>./configure [possible options]</code></p> <p><code>./configure [possible options]</code></p>
@ -239,7 +246,7 @@ available except commiting to the base.</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 to
update your list of installed shared libs.</p> update your list of installed shared libs.</p>
</li> </li>
<li><em>What other libraries are needed to compile/install libvir ?</em> <li><em>What other libraries are needed to compile/install libvirt ?</em>
<p>Libvir requires libxenstore, which is usually provided by the xen <p>Libvir requires libxenstore, which is usually provided by the xen
packages as well as the public headers to compile against libxenstore.</p> packages as well as the public headers to compile against libxenstore.</p>
</li> </li>
@ -253,18 +260,18 @@ available except commiting to the base.</p>
<h3><a name="Developer">Developer</a> corner</h3> <h3><a name="Developer">Developer</a> corner</h3>
<ol> <ol>
<li><em>Troubles compiling or linking programs using libvir</em> <li><em>Troubles compiling or linking programs using libvirt</em>
<p>To simplify the process of reusing the library, libvir comes with <p>To simplify the process of reusing the library, libvirt comes with
pkgconfig support, which can be used directly from autoconf support or pkgconfig support, which can be used directly from autoconf support or
via the pkg-config command line tool, like:</p> via the pkg-config command line tool, like:</p>
<p><code>pkg-config libvir --libs</code></p> <p><code>pkg-config libvirt --libs</code></p>
</li> </li>
</ol> </ol>
<h2><a name="Reporting">Reporting bugs and getting help</a></h2> <h2><a name="Reporting">Reporting bugs and getting help</a></h2>
<p>There is a mailing-list <a <p>There is a mailing-list <a
href="mailto:libvir-list@redhat.com">libvir-list@redhat.com</a> for libvir, href="mailto:libvir-list@redhat.com">libvir-list@redhat.com</a> for libvirt,
with an <a href="https://www.redhat.com/archives/libvir-list/">on-line with an <a href="https://www.redhat.com/archives/libvir-list/">on-line
archive</a>. Please subscribe to this list before posting by visiting the <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> href="https://www.redhat.com/mailman/listinfo/libvir-list">associated Web</a>
@ -273,7 +280,7 @@ attachments are really appreciated and will be discussed on the mailing list.
If possible generate the patches by using cvs diff -u in a CVS checkout.</p> If possible generate the patches by using cvs diff -u in a CVS checkout.</p>
<p>We expect to use <a href="https://bugzilla.redhat.com/">Red Hat <p>We expect to use <a href="https://bugzilla.redhat.com/">Red Hat
Bugzilla</a> to track bugs for libvir, though there isn't a libvir software Bugzilla</a> to track bugs for libvirt, though there isn't a libvirt software
module defined yet, in the meantime use the mailing-list, thanks !.</p> module defined yet, in the meantime use the mailing-list, thanks !.</p>
</body> </body>
</html> </html>

4
docs/libvirt.css
View File

@ -38,7 +38,7 @@ img
#pageHeader #pageHeader
{ {
position: absolute; position: absolute;
background: url(libvirHeader.png) center no-repeat; background: url(libvirtHeader.png) center no-repeat;
top: 30px; top: 30px;
height: 76px; height: 76px;
width: 766px; width: 766px;
@ -70,7 +70,7 @@ img
{ {
font-size: 11px; font-size: 11px;
height: 300px; height: 300px;
background: url(libvirLogo.png) center no-repeat; background: url(libvirtLogo.png) center no-repeat;
margin: 0; margin: 0;
width: 766px; width: 766px;
} }

9
docs/news.html
View File

@ -1,8 +1,11 @@
<?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 the
development of libvir, it is preferable when possible to just use the <a href="downloads.html">CVS version or snapshot</a>, contact the mailing list 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
and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progresses.</p><h3>0.0.2: Jan 29 2006</h3><ul><li>Update of the documentation, web site redesign (Diana Fong)</li> and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progresses.</p><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>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>
<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 for
most operations</li> most operations</li>
<li>Adding Save and Restore APIs</li> <li>Adding Save and Restore APIs</li>
@ -12,4 +15,4 @@ and check the <a href="ChangeLog.html">ChangeLog</a> to gauge progresses.</p><h3
</ul><h3>0.0.1: Dec 19 2005</h3><ul><li>First release</li> </ul><h3>0.0.1: Dec 19 2005</h3><ul><li>First release</li>
<li>Basic management of existing Xen domains</li> <li>Basic management of existing Xen domains</li>
<li>Minimal autogenerated Python bindings</li> <li>Minimal autogenerated Python bindings</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">libvir architecture</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a style="font-weight:bold" href="html/index.html">API Menu</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="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="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a style="font-weight:bold" href="html/index.html">API Menu</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="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>