Skip to content

L
libvirt

openeuler / libvirt

通知 3
Star 0
Fork 0
L
libvirt
切换分支/标签
查找文件 普通视图历史永久链接Permalink
FAQ.html 6.9 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
* TODO: updated  
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 
  <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>
D
* NEWS docs/*: regenerated and updated the docs post 0.0.3 release  
Daniel Veillard 已提交
7 
</ul><h3><a name="License" id="License">License</a>(s)</h3><ol><li><em>Licensing Terms for libvirt</em>
D
* include/libvirt/libvirt.h[.in] include/libvirt/virterror.h  
Daniel Veillard 已提交
8 9 10 11 12 
    <p>libvirt is released under the <a href="http://www.opensource.org/licenses/lgpl-license.html">GNU
    LesserGeneral Public License</a>, see the file COPYING.LIB in the
    distributionfor the precise wording. The only library that libvirt
    depends upon isthe Xen store access library which is also licenced under
    the LGPL.</p>
D
Update of the docs, daniel  
Daniel Veillard 已提交
13 
  </li>
D
* NEWS docs/*: regenerated and updated the docs post 0.0.3 release  
Daniel Veillard 已提交
14 
  <li><em>Can I embed libvirt in a proprietary application ?</em>
D
* include/libvirt/libvirt.h[.in] include/libvirt/virterror.h  
Daniel Veillard 已提交
15 16 17 18 
    <p>Yes. The LGPL allows you to embed libvirt into a
    proprietaryapplication. It would be graceful to send-back bug fixes and
    improvementsas patches for possible incorporation in the main development
    tree. Itwill decrease your maintainance costs anyway if you do so.</p>
D
Update of the docs, daniel  
Daniel Veillard 已提交
19 
  </li>
D
* include/libvirt/libvirt.h[.in] include/libvirt/virterror.h  
Daniel Veillard 已提交
20 
</ol><h3><a name="Installati" id="Installati">Installation</a></h3><ol><li><em>Where can I get libvirt</em>?
D
* NEWS docs/*: regenerated and updated the docs post 0.0.3 release  
Daniel Veillard 已提交
21 
    <p>The original distribution comes from <a href="ftp://libvirt.org/libvirt/">ftp://libvirt.org/libvirt/</a>.</p>
D
Update of the docs, daniel  
Daniel Veillard 已提交
22 
  </li>
D
* include/libvirt/libvirt.h[.in] include/libvirt/virterror.h  
Daniel Veillard 已提交
23 24 25 26 
  <li><em>I can't install the libvirt/libvirt-devel RPM packages due tofailed
    dependencies</em>
    <p>The most generic solution is to re-fetch the latest src.rpm ,
    andrebuild it locally with</p>
D
* NEWS docs/*: regenerated and updated the docs post 0.0.3 release  
Daniel Veillard 已提交
27 
    <p><code>rpm --rebuild libvirt-xxx.src.rpm</code>.</p>
D
* include/libvirt/libvirt.h[.in] include/libvirt/virterror.h  
Daniel Veillard 已提交
28 29 30 31 
    <p>If everything goes well it will generate two binary rpm packages
    (oneproviding the shared libs and virsh, and the other one, the
    -develpackage, providing includes, static libraries and scripts needed to
    buildapplications with libvirt that you can install locally.</p>
D
* docs/*: extended the documentation  
Daniel Veillard 已提交
32 33 34 35 
    <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 已提交
36 
  </li>
D
Adding an FAQ about the ro store socket permissions, Daniel  
Daniel Veillard 已提交
37 
  <li><em>Failure to use the API for non-root users</em>
D
* include/libvirt/libvirt.h[.in] include/libvirt/virterror.h  
Daniel Veillard 已提交
38 39 40 41 42 
    <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 beforbidden to user, at least for monitoring purposes. If "virsh
    dominfo"fails to run as an user, change the mode of the xenstore
    read-only socketwith:</p>
D
Adding an FAQ about the ro store socket permissions, Daniel  
Daniel Veillard 已提交
43 
    <p><code>chmod 666 /var/run/xenstored/socket_ro</code></p>
D
* include/libvirt/libvirt.h[.in] include/libvirt/virterror.h  
Daniel Veillard 已提交
44 45 46 47 
    <p>and also make sure that the Xen Daemon is running correctly with
    localHTTP server enabled, this is defined
    in<code>/etc/xen/xend-config.sxp</code>which need the following line to
    beenabled:</p>
D
* NEWS docs/news.xsl: added stylesheet to generate NEWS file  
Daniel Veillard 已提交
48 
    <p><code>(xend-http-server yes)</code></p>
D
* include/libvirt/libvirt.h[.in] include/libvirt/virterror.h  
Daniel Veillard 已提交
49 50 
    <p>If needed restart the xend daemon after making the change with
    thefollowing command run as root:</p>
D
* NEWS docs/news.xsl: added stylesheet to generate NEWS file  
Daniel Veillard 已提交
51 
    <p><code>service xend restart</code></p>
D
Adding an FAQ about the ro store socket permissions, Daniel  
Daniel Veillard 已提交
52 
  </li>
D
* NEWS docs/*: regenerated and updated the docs post 0.0.3 release  
Daniel Veillard 已提交
53 54 55 56 
</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>
D
Update of the docs, daniel  
Daniel Veillard 已提交
57 58 59 60 61 
    <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>
D
* include/libvirt/libvirt.h[.in] include/libvirt/virterror.h  
Daniel Veillard 已提交
62 63 
    <p>At that point you may have to rerun ldconfig or a similar utility
    toupdate your list of installed shared libs.</p>
D
Update of the docs, daniel  
Daniel Veillard 已提交
64 
  </li>
D
* NEWS docs/*: regenerated and updated the docs post 0.0.3 release  
Daniel Veillard 已提交
65 
  <li><em>What other libraries are needed to compile/install libvirt ?</em>
D
* include/libvirt/libvirt.h[.in] include/libvirt/virterror.h  
Daniel Veillard 已提交
66 67 68 
    <p>Libvirt requires libxenstore, which is usually provided by the
    xenpackages as well as the public headers to compile against
    libxenstore.</p>
D
Update of the docs, daniel  
Daniel Veillard 已提交
69 70 
  </li>
  <li><em>I use the CVS version and there is no configure script</em>
D
* include/libvirt/libvirt.h[.in] include/libvirt/virterror.h  
Daniel Veillard 已提交
71 72 73 
    <p>The configure script (and other Makefiles) are generated. Use
    theautogen.sh script to regenerate the configure script and
    Makefiles,like:</p>
D
Update of the docs, daniel  
Daniel Veillard 已提交
74 75 
    <p><code>./autogen.sh --prefix=/usr --disable-shared</code></p>
  </li>
D
* include/libvirt/libvirt.h[.in] include/libvirt/virterror.h  
Daniel Veillard 已提交
76 77 78 79 
</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
    withpkgconfig support, which can be used directly from autoconf support
    orvia the pkg-config command line tool, like:</p>
D
* NEWS docs/*: regenerated and updated the docs post 0.0.3 release  
Daniel Veillard 已提交
80 
    <p><code>pkg-config libvirt --libs</code></p>
D
Update of the docs, daniel  
Daniel Veillard 已提交
81 
  </li>
D
* docs/*: updated the format section, augmented Networking with  
Daniel Veillard 已提交
82 
</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 Formats</a></li><li><a href="python.html">Binding for Python</a></li><li><a href="errors.html">Handling of errors</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="html/index.html">API Menu</a></li><li><a href="examples/index.html">C code examples</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></div><div class="llinks2"><h3 class="links2"><span>related links</span></h3><ul><li><a href="https://www.redhat.com/archives/libvir-list/">Mail archive</a></li><li><a href="https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora+Core&amp;component=libvirt&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=MODIFIED&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;long_desc_type=allwordssubstr">Open bugs</a></li><li><a href="http://virt-manager.et.redhat.com/">virt-manager</a></li><li><a href="http://search.cpan.org/~danberr/Sys-Virt-0.1.0/">Perl bindings</a></li><li><a href="http://www.cl.cam.ac.uk/Research/SRG/netos/xen/index.html">Xen project</a></li><li><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="12" value="Search..." /><input name="submit" type="submit" value="Go" /></form></li><li><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-90x34.gif" alt="Made with Libxml2 Logo" /></a></li></ul><p class="credits">Graphics and design by <a href="mail:dfong@redhat.com">Diana Fong</a></p></div></div><div id="bottom"><p class="p1"></p></div></div></body></html>