External/libvirt
1
0
Fork 0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2024-11-06 05:11:14 +00:00
Code Issues Packages Projects Releases Wiki Activity
44e522c821
libvirt/docs/FAQ.html

81 lines
6.9 KiB
HTML
Raw Normal View History

* configure.in docs/FAQ.html docs/Libxml2-Logo-90x34.gif docs/Makefile.am docs/bugs.html docs/index.html docs/intro.html docs/libvir.html docs/redhat.gif docs/site.xsl: starting to add the web site, based on libxml2 one. * src/hash.c: add a missing include Daniel
2005-12-07 09:33:00 +00:00
<?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">
* TODO: updated * python/tests/Makefile.am: fix a small PYTHONPATH bug * docs//*: fixed the xsl a bit for toc names, added doc for the python bindings, regenerated Daniel
2006-02-21 13:23:16 +00:00
<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>FAQ</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">FAQ</h1><p>Table of Contents:</p><ul><li><a href="FAQ.html#License">License(s)</a></li>
Update of the docs, daniel
2005-12-08 23:49:08 +00:00
<li><a href="FAQ.html#Installati">Installation</a></li>
<li><a href="FAQ.html#Compilatio">Compilation</a></li>
<li><a href="FAQ.html#Developer">Developer corner</a></li>
* NEWS docs/*: regenerated and updated the docs post 0.0.3 release Daniel
2006-02-10 08:43:31 +00:00
</ul><h3><a name="License" id="License">License</a>(s)</h3><ol><li><em>Licensing Terms for libvirt</em>
* docs/*.html: repair the damages made by Amaya on the content of documentation following feedback from Simon Hernandez Daniel
2007-03-22 15:17:31 +00:00
<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
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>
Update of the docs, daniel
2005-12-08 23:49:08 +00:00
</li>
* NEWS docs/*: regenerated and updated the docs post 0.0.3 release Daniel
2006-02-10 08:43:31 +00:00
<li><em>Can I embed libvirt in a proprietary application ?</em>
* docs/*.html: repair the damages made by Amaya on the content of documentation following feedback from Simon Hernandez Daniel
2007-03-22 15:17:31 +00:00
<p>Yes. The LGPL allows you to embed libvirt into a proprietary
application. It would be graceful to send-back bug fixes and improvements
as patches for possible incorporation in the main development tree. It
will decrease your maintainance costs anyway if you do so.</p>
Update of the docs, daniel
2005-12-08 23:49:08 +00:00
</li>
* docs/*.html: repair the damages made by Amaya on the content of documentation following feedback from Simon Hernandez Daniel
2007-03-22 15:17:31 +00:00
</ol><h3><a name="Installati" id="Installati">Installation</a></h3><ol><li><em>Where can I get libvirt</em> ?
* NEWS docs/*: regenerated and updated the docs post 0.0.3 release Daniel
2006-02-10 08:43:31 +00:00
<p>The original distribution comes from <a href="ftp://libvirt.org/libvirt/">ftp://libvirt.org/libvirt/</a>.</p>
Update of the docs, daniel
2005-12-08 23:49:08 +00:00
</li>
* docs/*.html: repair the damages made by Amaya on the content of documentation following feedback from Simon Hernandez Daniel
2007-03-22 15:17:31 +00:00
<li><em>I can't install the libvirt/libvirt-devel RPM packages due to
failed dependencies</em>
<p>The most generic solution is to re-fetch the latest src.rpm , and
rebuild it locally with</p>
* NEWS docs/*: regenerated and updated the docs post 0.0.3 release Daniel
2006-02-10 08:43:31 +00:00
<p><code>rpm --rebuild libvirt-xxx.src.rpm</code>.</p>
* docs/*.html: repair the damages made by Amaya on the content of documentation following feedback from Simon Hernandez Daniel
2007-03-22 15:17:31 +00:00
<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
package, providing includes, static libraries and scripts needed to build
applications with libvirt that you can install locally.</p>
* docs/*: extended the documentation Daniel
2005-12-09 13:04:05 +00:00
<p>One can also rebuild the RPMs from a tarball:</p>
<p><code>rpmbuild -ta libdir-xxx.tar.gz</code></p>
<p>Or from a configured tree with:</p>
<p><code>make rpm</code></p>
Update of the docs, daniel
2005-12-08 23:49:08 +00:00
</li>
Adding an FAQ about the ro store socket permissions, Daniel
2005-12-13 17:20:25 +00:00
<li><em>Failure to use the API for non-root users</em>
* docs/*.html: repair the damages made by Amaya on the content of documentation following feedback from Simon Hernandez Daniel
2007-03-22 15:17:31 +00:00
<p>Large parts of the API may only be accessible with root priviledges,
however the read only access to the xenstore data doesnot have to be
forbidden to user, at least for monitoring purposes. If "virsh dominfo"
fails to run as an user, change the mode of the xenstore read-only socket
with:</p>
Adding an FAQ about the ro store socket permissions, Daniel
2005-12-13 17:20:25 +00:00
<p><code>chmod 666 /var/run/xenstored/socket_ro</code></p>
* docs/*.html: repair the damages made by Amaya on the content of documentation following feedback from Simon Hernandez Daniel
2007-03-22 15:17:31 +00:00
<p>and also make sure that the Xen Daemon is running correctly with local
HTTP server enabled, this is defined in
<code>/etc/xen/xend-config.sxp</code> which need the following line to be
enabled:</p>
* NEWS docs/news.xsl: added stylesheet to generate NEWS file * docs/*: updated docs preparing for the release Daniel
2006-01-29 10:56:15 +00:00
<p><code>(xend-http-server yes)</code></p>
* docs/*.html: repair the damages made by Amaya on the content of documentation following feedback from Simon Hernandez Daniel
2007-03-22 15:17:31 +00:00
<p>If needed restart the xend daemon after making the change with the
following command run as root:</p>
* NEWS docs/news.xsl: added stylesheet to generate NEWS file * docs/*: updated docs preparing for the release Daniel
2006-01-29 10:56:15 +00:00
<p><code>service xend restart</code></p>
Adding an FAQ about the ro store socket permissions, Daniel
2005-12-13 17:20:25 +00:00
</li>
* NEWS docs/*: regenerated and updated the docs post 0.0.3 release Daniel
2006-02-10 08:43:31 +00:00
</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 libvirt follows the "standard":</p>
<p><code>gunzip -c libvirt-xxx.tar.gz | tar xvf -</code></p>
<p><code>cd libvirt-xxxx</code></p>
Update of the docs, daniel
2005-12-08 23:49:08 +00:00
<p><code>./configure --help</code></p>
<p>to see the options, then the compilation/installation proper</p>
<p><code>./configure [possible options]</code></p>
<p><code>make</code></p>
<p><code>make install</code></p>
* docs/*.html: repair the damages made by Amaya on the content of documentation following feedback from Simon Hernandez Daniel
2007-03-22 15:17:31 +00:00
<p>At that point you may have to rerun ldconfig or a similar utility to
update your list of installed shared libs.</p>
Update of the docs, daniel
2005-12-08 23:49:08 +00:00
</li>
* NEWS docs/*: regenerated and updated the docs post 0.0.3 release Daniel
2006-02-10 08:43:31 +00:00
<li><em>What other libraries are needed to compile/install libvirt ?</em>
* docs/*.html: repair the damages made by Amaya on the content of documentation following feedback from Simon Hernandez Daniel
2007-03-22 15:17:31 +00:00
<p>Libvirt requires libxenstore, which is usually provided by the xen
packages as well as the public headers to compile against libxenstore.</p>
Update of the docs, daniel
2005-12-08 23:49:08 +00:00
</li>
<li><em>I use the CVS version and there is no configure script</em>
* docs/*.html: repair the damages made by Amaya on the content of documentation following feedback from Simon Hernandez Daniel
2007-03-22 15:17:31 +00:00
<p>The configure script (and other Makefiles) are generated. Use the
autogen.sh script to regenerate the configure script and Makefiles,
like:</p>
Update of the docs, daniel
2005-12-08 23:49:08 +00:00
<p><code>./autogen.sh --prefix=/usr --disable-shared</code></p>
</li>
* docs/*.html: repair the damages made by Amaya on the content of documentation following feedback from Simon Hernandez Daniel
2007-03-22 15:17:31 +00:00
</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
pkgconfig support, which can be used directly from autoconf support or
via the pkg-config command line tool, like:</p>
* NEWS docs/*: regenerated and updated the docs post 0.0.3 release Daniel
2006-02-10 08:43:31 +00:00
<p><code>pkg-config libvirt --libs</code></p>
Update of the docs, daniel
2005-12-08 23:49:08 +00:00
</li>
Regenerated docs, Daniel
2007-04-27 15:39:20 +00:00
</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="remote.html">Remote support</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>
Reference in New Issue Copy Permalink