Skip to content

L
libvirt

openeuler / libvirt

通知 3
Star 0
Fork 0
L
libvirt
切换分支/标签
查找文件 普通视图历史永久链接Permalink
FAQ.html 6.2 KB
Newer Older
D
* configure.in docs/FAQ.html docs/Libxml2-Logo-90x34.gif  
Daniel Veillard 已提交
1 2 
<?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">
D
* //* : renamed the project libvirt , this affects all makefiles,  
Daniel Veillard 已提交
3 
<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>
D
Update of the docs, daniel  
Daniel Veillard 已提交
4 5 6 7 
  <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>
</ul><h3><a name="License" id="License">License</a>(s)</h3><ol><li><em>Licensing Terms for libvir</em>
D
* docs/*: extended the documentation  
Daniel Veillard 已提交
8 9 10 11 
    <p>libvir 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 libvir depends upon is the
    Xen store access library which is also licenced under the LGPL.</p>
D
Update of the docs, daniel  
Daniel Veillard 已提交
12 13 
  </li>
  <li><em>Can I embed libvir in a proprietary application ?</em>
D
* docs/*: extended the documentation  
Daniel Veillard 已提交
14 15 16 17 
    <p>Yes. The LGPL allows you to embed libvir 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>
D
Update of the docs, daniel  
Daniel Veillard 已提交
18 19 
  </li>
</ol><h3><a name="Installati" id="Installati">Installation</a></h3><ol><li><em>Where can I get libvir</em> ?
D
* docs/*: extended the documentation  
Daniel Veillard 已提交
20 
    <p>The original distribution comes from <a href="ftp://libvir.org/libvir/">ftp://libvir.org/libvir/</a>.</p>
D
Update of the docs, daniel  
Daniel Veillard 已提交
21 22 23 24 25 26 27 
  </li>
  <li><em>I can't install the libvir/libvir-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>
    <p><code>rpm --rebuild libvir-xxx.src.rpm</code>.</p>
    <p>If everything goes well it will generate two binary rpm packages (one
D
* docs/*: extended the documentation  
Daniel Veillard 已提交
28 
    providing the shared libs and virsh, and the other one, the -devel
D
Update of the docs, daniel  
Daniel Veillard 已提交
29 30 
    package, providing includes, static libraries and scripts needed to build
    applications with libvir that you can install locally.</p>
D
* docs/*: extended the documentation  
Daniel Veillard 已提交
31 32 33 34 
    <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>
D
Update of the docs, daniel  
Daniel Veillard 已提交
35 
  </li>
D
Adding an FAQ about the ro store socket permissions, Daniel  
Daniel Veillard 已提交
36 
  <li><em>Failure to use the API for non-root users</em>
D
* doc/*: augment and try to complete the doc in its current state  
Daniel Veillard 已提交
37 38 
    <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
D
fixing an error pointed by sct, Daniel  
Daniel Veillard 已提交
39 
    forbidden to user, at least for monitoring purposes. If "virsh dinfo"
D
* doc/*: augment and try to complete the doc in its current state  
Daniel Veillard 已提交
40 41 
    fails to run as an user, change the mode of the xenstore read-only socket
    with:</p>
D
Adding an FAQ about the ro store socket permissions, Daniel  
Daniel Veillard 已提交
42 
    <p><code>chmod 666 /var/run/xenstored/socket_ro</code></p>
D
* NEWS docs/news.xsl: added stylesheet to generate NEWS file  
Daniel Veillard 已提交
43 44 45 46 47 48 49 50 
    <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>
    <p><code>(xend-http-server yes)</code></p>
    <p>If needed restart the xend daemon after making the change with the
    following command run as root:</p>
    <p><code>service xend restart</code></p>
D
Adding an FAQ about the ro store socket permissions, Daniel  
Daniel Veillard 已提交
51 
  </li>
D
Update of the docs, daniel  
Daniel Veillard 已提交
52 53 54 55 56 57 58 59 60 61 62 63 64 65 
</ol><h3><a name="Compilatio" id="Compilatio">Compilation</a></h3><ol><li><em>What is the process to compile libvir ?</em>
    <p>As most UNIX libraries libvir follows the "standard":</p>
    <p><code>gunzip -c libvir-xxx.tar.gz | tar xvf -</code></p>
    <p><code>cd libvir-xxxx</code></p>
    <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>
    <p>At that point you may have to rerun ldconfig or a similar utility to
    update your list of installed shared libs.</p>
  </li>
  <li><em>What other libraries are needed to compile/install libvir ?</em>
    <p>Libvir requires libxenstore, which is usually provided by the xen
D
* docs/*: extended the documentation  
Daniel Veillard 已提交
66 
    packages as well as the public headers to compile against libxenstore.</p>
D
Update of the docs, daniel  
Daniel Veillard 已提交
67 68 69 70 71 72 73 74 
  </li>
  <li><em>I use the CVS version and there is no configure script</em>
    <p>The configure script (and other Makefiles) are generated. Use the
    autogen.sh script to regenerate the configure script and Makefiles,
    like:</p>
    <p><code>./autogen.sh --prefix=/usr --disable-shared</code></p>
  </li>
</ol><h3><a name="Developer" id="Developer">Developer</a> corner</h3><ol><li><em>Troubles compiling or linking programs using libvir</em>
D
* docs/*: extended the documentation  
Daniel Veillard 已提交
75 76 77 78 
    <p>To simplify the process of reusing the library, libvir comes with
    pkgconfig support, which can be used directly from autoconf support or
    via the pkg-config command line tool, like:</p>
    <p><code>pkg-config libvir --libs</code></p>
D
Update of the docs, daniel  
Daniel Veillard 已提交
79 
  </li>
D
* docs/site.xsl docs/*.html: credits to Diana Fong for graphics  
Daniel Veillard 已提交
80 
</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>