Skip to content

L
libvirt

openeuler / libvirt

通知 3
Star 0
Fork 0
L
libvirt

体验新版 GitCode，发现更多精彩内容 >>

提交 49c50366 编写于 作者: R Richard W.M. Jones
浏览文件
操作

Documentation cleanups. 

        * docs/bindings.html.in: Clean up the bindings page, and add
          C# and Java.
        * docs/windows.html.in: Remove old bogus information and add
          placeholder.
上级 0aac8c94
隐藏空白更改
内联 并排
Showing with 85 addition and 432 deletion
ChangeLog
浏览文件 @ 49c50366
Thu Sep 18 09:55:00 BST 2008 Richard W.M. Jones <rjones@redhat.com>
Documentation cleanups.
* docs/bindings.html.in: Clean up the bindings page, and add
C# and Java.
* docs/windows.html.in: Remove old bogus information and add
placeholder.
Thu Sep 18 09:52:00 BST 2008 Daniel P. Berrange <berrange@redhat.com> Thu Sep 18 09:52:00 BST 2008 Daniel P. Berrange <berrange@redhat.com>
* src/qemu_driver.c, configure.in, libvirt.spec.in: Remove * src/qemu_driver.c, configure.in, libvirt.spec.in: Remove
......
docs/bindings.html
浏览文件 @ 49c50366
...@@ -103,14 +103,18 @@ ...@@ -103,14 +103,18 @@
<div id="content"> <div id="content">
<h1>Bindings for other languages</h1> <h1>Bindings for other languages</h1>
<p>Libvirt comes with bindings to support other languages than <p>Libvirt comes with bindings to support other languages than
pure C. First the headers embeds the necessary declarations to pure <strong>C</strong>. First the headers embeds the necessary declarations to
allow direct acces from C++ code, but also we have bindings for allow direct acces from <strong>C++</strong> code, but also we have bindings for
higher level kind of languages:</p> higher level kind of languages:</p>
<ul><li>Python: Libvirt comes with direct support for the Python language <ul><li><strong>Python</strong>: Libvirt comes with direct support for the Python language
(just make sure you installed the libvirt-python package if not (just make sure you installed the libvirt-python package if not
compiling from sources). See below for more information about compiling from sources). See below for more information about
using libvirt with python</li><li>Perl: Daniel Berrange provides <a href="http://search.cpan.org/dist/Sys-Virt/">bindings for using libvirt with python</li><li><strong>Perl</strong>: Daniel Berrange provides <a href="http://search.cpan.org/dist/Sys-Virt/">bindings for
Perl</a>.</li><li>OCaml: Richard Jones supplies <a href="http://libvirt.org/ocaml/">bindings for OCaml</a>.</li><li>Ruby: David Lutterkort provides <a href="http://libvirt.org/ruby/">bindings for Ruby</a>.</li></ul> Perl</a>.</li><li><strong>OCaml</strong>: Richard Jones supplies <a href="http://libvirt.org/ocaml/">bindings for OCaml</a>.</li><li><strong>Ruby</strong>: David Lutterkort provides <a href="http://libvirt.org/ruby/">bindings for Ruby</a>.</li><li><strong>Java</strong>: Daniel Veillard maintains <a href="java.html">Java bindings</a>.</li><li><strong>C#</strong>: Richard Jones wrote about <a href="https://www.redhat.com/archives/libvir-list/2008-September/msg00283.html">calling libvirt from C# on the mailing list</a>.</li></ul>
<p>For information on using libvirt on <strong>Windows</strong>
<a href="windows.html">please see the Windows
support page</a>.
</p>
<p>Support, requests or help for libvirt bindings are welcome on <p>Support, requests or help for libvirt bindings are welcome on
the <a href="https://www.redhat.com/mailman/listinfo/libvir-list/">mailing the <a href="https://www.redhat.com/mailman/listinfo/libvir-list/">mailing
list</a>, as usual try to provide enough background information list</a>, as usual try to provide enough background information
......
docs/bindings.html.in
浏览文件 @ 49c50366
...@@ -2,19 +2,25 @@ ...@@ -2,19 +2,25 @@
<body> <body>
<h1 >Bindings for other languages</h1> <h1 >Bindings for other languages</h1>
<p>Libvirt comes with bindings to support other languages than <p>Libvirt comes with bindings to support other languages than
pure C. First the headers embeds the necessary declarations to pure <strong>C</strong>. First the headers embeds the necessary declarations to
allow direct acces from C++ code, but also we have bindings for allow direct access from <strong>C++</strong> code, but also we have bindings for
higher level kind of languages:</p> higher level kind of languages:</p>
<ul> <ul>
<li>Python: Libvirt comes with direct support for the Python language <li><strong>Python</strong>: Libvirt comes with direct support for the Python language
(just make sure you installed the libvirt-python package if not (just make sure you installed the libvirt-python package if not
compiling from sources). See below for more information about compiling from sources). See below for more information about
using libvirt with python</li> using libvirt with python</li>
<li>Perl: Daniel Berrange provides <a href="http://search.cpan.org/dist/Sys-Virt/">bindings for <li><strong>Perl</strong>: Daniel Berrange provides <a href="http://search.cpan.org/dist/Sys-Virt/">bindings for
Perl</a>.</li> Perl</a>.</li>
<li>OCaml: Richard Jones supplies <a href="http://libvirt.org/ocaml/">bindings for OCaml</a>.</li> <li><strong>OCaml</strong>: Richard Jones supplies <a href="http://libvirt.org/ocaml/">bindings for OCaml</a>.</li>
<li>Ruby: David Lutterkort provides <a href="http://libvirt.org/ruby/">bindings for Ruby</a>.</li> <li><strong>Ruby</strong>: David Lutterkort provides <a href="http://libvirt.org/ruby/">bindings for Ruby</a>.</li>
<li><strong>Java</strong>: Daniel Veillard maintains <a href="java.html">Java bindings</a>.</li>
<li><strong>C#</strong>: Richard Jones wrote about <a href="https://www.redhat.com/archives/libvir-list/2008-September/msg00283.html">calling libvirt from C# on the mailing list</a>.</li>
</ul> </ul>
<p>For information on using libvirt on <strong>Windows</strong>
<a href="windows.html">please see the Windows
support page</a>.
</p>
<p>Support, requests or help for libvirt bindings are welcome on <p>Support, requests or help for libvirt bindings are welcome on
the <a href="https://www.redhat.com/mailman/listinfo/libvir-list/">mailing the <a href="https://www.redhat.com/mailman/listinfo/libvir-list/">mailing
list</a>, as usual try to provide enough background information list</a>, as usual try to provide enough background information
......
docs/windows.html
浏览文件 @ 49c50366
...@@ -111,201 +111,35 @@ ...@@ -111,201 +111,35 @@
<div id="content"> <div id="content">
<h1>Windows support</h1> <h1>Windows support</h1>
<p> <p>
Instructions for compiling and installing libvirt on Windows. Libvirt can be compiled on Windows
</p> using the free <a href="http://www.mingw.org/">MinGW compiler</a>.
<ul><li> You can also cross-compile to a Windows target
<a href="#Windows_binaries">Binaries</a> from a Fedora machine using the packages available
</li><li> <a href="http://hg.et.redhat.com/misc/fedora-mingw--devel/">from
<a href="#Windows_compiling">Compiling from source</a> the Fedora MinGW project</a>
</li></ul> (which includes a working libvirt specfile).
<h3> </p>
<a name="Windows_binaries" id="Windows_binaries">Binaries</a>
</h3>
<p> <p>
Binaries will be available from Libvirt can only be built as a client on Windows
<a href="ftp://libvirt.org/libvirt/win32">the download area</a> allowing remote access to systems libvirt servers.
(but we don't have binaries at the moment). Configure libvirt like this:
</p> </p>
<h3>
<a name="Windows_compiling" id="Windows_compiling">Compiling from source</a>
</h3>
<p>
These are the steps to compile libvirt and the other
tools from source on Windows.
</p>
<p>
You will need:
</p>
<ol><li> MS Windows. Microsoft makes free (as beer) versions
of some of its operating systems available to
<a href="http://msdn.microsoft.com/">MSDN subscribers</a>.
We used Windows 2008 Server for testing, virtualized under
Linux using KVM-53 (earlier versions of KVM and QEMU won't
run recent versions of Windows because of lack of full ACPI
support, so make sure you have the latest KVM).
</li><li><a href="http://www.cygwin.com/">Cygwin</a>'s
<a href="http://www.cygwin.com/setup.exe">setup.exe</a>.
</li><li> A large amount of free disk space to install Cygwin.
Make sure you have 10 GB free to install most Cygwin packages,
although if you pare down the list of dependencies you may
get away with much less. </li><li> A network connection for Windows, since Cygwin downloads packages
from the net as it installs. </li><li>
<a href="http://www.libvirt.org/downloads.html">Libvirt
latest version from CVS</a>
</li><li> The latest source patch from
<a href="ftp://libvirt.org/libvirt/win32">the download area</a>. </li><li> A version of Cygwin sunrpc, patched to support building
<code>librpc.dll</code>.
A patch and a binary package are available from
<a href="ftp://libvirt.org/libvirt/win32">the download area</a>. </li></ol>
<p>
These are the steps to take to compile libvirt from
source on Windows:
</p>
<ol><li>
<p>Run Cygwin
<a href="http://www.cygwin.com/setup.exe">setup.exe</a>.
When it starts up it will show a dialog like this:
</p>
<img src="windows-cygwin-1.png" width="504" height="388" alt="Cygwin Net Release Setup Program" /></li><li>
<p>Step through the setup program accepting defaults
or making choices as appropriate, until you get to the
screen for selecting packages:</p>
<img src="windows-cygwin-2.png" width="505" height="388" alt="Cygwin Select Packages screen" /><p>
The user interface here is very confusing. You have to
click the "recycling icon" as shown by the arrow:
</p>
<img src="windows-cygwin-3.png" width="298" height="200" alt="Cygwin Recycling Icon" /><p>
which takes the package (and all packages in the subtree)
through several states such as "Install", "Reinstall", "Keep",
"Skip", "Uninstall", etc.
</p>
</li><li>
<p>You can install "All" (everything) or better select
just the groups and packages needed. Select the following
groups and packages for installation:
</p>
<table><tr><th valign="top" align="right"> Groups </th><td>
Archive <br />
Base <br />
Devel <br />
Editors <br />
Mingw <br />
Perl <br />
Python <br />
Shells <br /></td></tr><tr><th valign="top" align="right"> Packages </th><td>
openssh <br />
sunrpc &#8805; 4.0-4 (see below) <br /></td></tr></table></li><li>
<p> Once Cygwin has finished installing, start a Cygwin bash shell
(either click on the desktop icon or look for Cygwin bash shell
in the Start menu). </p>
<p> The very first time you start the Cygwin bash shell, you may
find you need to run the <code>mkpasswd</code> and <code>mkgroup</code>
commands in order to create <code>/etc/passwd</code> and
<code>/etc/group</code> files from Windows users. If this
is needed then a message is printed in the shell.
Note that you need to do this as Windows Administrator. </p>
</li><li>
<p> Install Cygwin sunrpc &#8805; 4.0-4 package, patched to include
<code>librpc.dll</code>.
To do this, first check to see whether <code>/usr/lib/librpc.dll</code>
exists. If it does, you're good to go and can skip to the next
step. </p>
<p>
If you don't have this file, either install the binary package
<a href="ftp://libvirt.org/libvirt/win32/sunrpc-4.0-4.tar.bz2">sunrpc-4.0-4.tar.bz2</a> (just unpack it, as Administrator, in the Cygwin root directory).
Or you can download the
<a href="ftp://libvirt.org/libvirt/win32/sunrpc-4.0-dll.patch">source patch</a>
and apply it by hand to the Cygwin sunrpc package (eg. using
cygport).
</p>
</li><li>
<p>
Check out
<a href="http://www.libvirt.org/downloads.html">Libvirt from CVS</a> and
<a href="ftp://libvirt.org/libvirt/win32">apply the latest Windows patch</a>
to the source.
</p>
</li><li>
<p> Configure libvirt by doing: </p>
<pre>
autoreconf
./configure --without-xen --without-qemu
</pre>
<p> (The autoreconf step is probably optional). </p>
<p> The configure step will tell you if you have all the
required parts installed. If something is missing you
will need to go back through Cygwin setup and install it.
</p>
</li><li>
<p> Rebuild the XDR structures: </p>
<pre>
rm qemud/remote_protocol.[ch] qemud/remote_dispatch_*.h
make -C qemud remote_protocol.c
</pre>
</li><li>
<p> Build: </p>
<pre>
make
</pre>
<p> If this step is not successful, you should post a full
report <i>including complete messages</i> to
<a href="http://www.redhat.com/mailman/listinfo/libvir-list">the
libvirt mailing list</a>.
</p>
</li><li>
<p> Test it. If you have access to a remote machine
running Xen or QEMU/KVM, and the libvirt daemon (<code>libvirtd</code>)
then you should be able to connect to it and display
domains using, eg:
</p>
<pre>
src/virsh.exe <a href="http://libvirt.org/uri.html">-c qemu://remote/system</a> list --all
</pre>
<p>
Please read more about <a href="http://libvirt.org/remote.html">remote
support</a> before sending bug reports, to make sure that
any problems are really Windows and not just with remote
configuration / security.
</p>
</li><li>
<p>
You may want to install the library and programs by doing:
</p>
<pre>
make install
</pre>
</li><li>
<p>
The above steps should also build and install Python modules.
However for reasons which I don't fully understand, Python won't
look in the
non-standard <code>/usr/local/lib/python*/site-packages/</code>
directory by default so you may need to set the environment
variable PYTHONPATH:
</p>
<pre>
export PYTHONPATH=/usr/local/lib/python2.5/site-packages
</pre>
<p>
(Change the version number to your version of Python). You
can test Python support from the command line:
</p>
<pre> <pre>
python ./configure \
&gt;&gt;&gt; import libvirt --without-sasl \
&gt;&gt;&gt; conn = libvirt.open ("test:///default") --without-avahi \
&gt;&gt;&gt; conn.listDomainsID () --without-polkit \
[1] --without-python \
&gt;&gt;&gt; dom = conn.lookupByID (1) --without-xen \
&gt;&gt;&gt; dom.XMLDesc (0) --without-qemu \
"&lt;domain type='test' id='1'&gt; ..." --without-lxc \
--without-openvz \
--without-libvirtd
</pre> </pre>
<p> <p>
The most common failure will be with <code>import libvirt</code> We intend to supply Windows binaries on this page
which usually indicates that either <code>PYTHONPATH</code> is later, but at the moment you have to compile from source.
wrong or a DLL cannot be loaded. </p>
</p>
</li></ol>
</div> </div>
</div> </div>
<div id="footer"> <div id="footer">
......
docs/windows.html.in
浏览文件 @ 49c50366
...@@ -2,238 +2,39 @@ ...@@ -2,238 +2,39 @@
<html> <html>
<body> <body>
<h1 >Windows support</h1> <h1 >Windows support</h1>
<p> <p>
Instructions for compiling and installing libvirt on Windows. Libvirt can be compiled on Windows
</p> using the free <a href="http://www.mingw.org/">MinGW compiler</a>.
<ul> You can also cross-compile to a Windows target
<li> from a Fedora machine using the packages available
<a href="#Windows_binaries">Binaries</a> <a href="http://hg.et.redhat.com/misc/fedora-mingw--devel/">from
</li> the Fedora MinGW project</a>
<li> (which includes a working libvirt specfile).
<a href="#Windows_compiling">Compiling from source</a> </p>
</li>
</ul>
<h3>
<a name="Windows_binaries" id="Windows_binaries">Binaries</a>
</h3>
<p> <p>
Binaries will be available from Libvirt can only be built as a client on Windows
<a href="ftp://libvirt.org/libvirt/win32">the download area</a> allowing remote access to systems libvirt servers.
(but we don't have binaries at the moment). Configure libvirt like this:
</p> </p>
<h3>
<a name="Windows_compiling" id="Windows_compiling">Compiling from source</a> <pre>
</h3> ./configure \
<p> --without-sasl \
These are the steps to compile libvirt and the other --without-avahi \
tools from source on Windows. --without-polkit \
</p> --without-python \
<p> --without-xen \
You will need: --without-qemu \
</p> --without-lxc \
<ol> --without-openvz \
<li> MS Windows. Microsoft makes free (as beer) versions --without-libvirtd
of some of its operating systems available to
<a href="http://msdn.microsoft.com/">MSDN subscribers</a>.
We used Windows 2008 Server for testing, virtualized under
Linux using KVM-53 (earlier versions of KVM and QEMU won't
run recent versions of Windows because of lack of full ACPI
support, so make sure you have the latest KVM).
</li>
<li><a href="http://www.cygwin.com/">Cygwin</a>'s
<a href="http://www.cygwin.com/setup.exe">setup.exe</a>.
</li>
<li> A large amount of free disk space to install Cygwin.
Make sure you have 10 GB free to install most Cygwin packages,
although if you pare down the list of dependencies you may
get away with much less. </li>
<li> A network connection for Windows, since Cygwin downloads packages
from the net as it installs. </li>
<li>
<a href="http://www.libvirt.org/downloads.html">Libvirt
latest version from CVS</a>
</li>
<li> The latest source patch from
<a href="ftp://libvirt.org/libvirt/win32">the download area</a>. </li>
<li> A version of Cygwin sunrpc, patched to support building
<code>librpc.dll</code>.
A patch and a binary package are available from
<a href="ftp://libvirt.org/libvirt/win32">the download area</a>. </li>
</ol>
<p>
These are the steps to take to compile libvirt from
source on Windows:
</p>
<ol>
<li>
<p>Run Cygwin
<a href="http://www.cygwin.com/setup.exe">setup.exe</a>.
When it starts up it will show a dialog like this:
</p>
<img src="windows-cygwin-1.png" width="504" height="388" alt="Cygwin Net Release Setup Program"/>
</li>
<li>
<p>Step through the setup program accepting defaults
or making choices as appropriate, until you get to the
screen for selecting packages:</p>
<img src="windows-cygwin-2.png" width="505" height="388" alt="Cygwin Select Packages screen"/>
<p>
The user interface here is very confusing. You have to
click the "recycling icon" as shown by the arrow:
</p>
<img src="windows-cygwin-3.png" width="298" height="200" alt="Cygwin Recycling Icon"/>
<p>
which takes the package (and all packages in the subtree)
through several states such as "Install", "Reinstall", "Keep",
"Skip", "Uninstall", etc.
</p>
</li>
<li>
<p>You can install "All" (everything) or better select
just the groups and packages needed. Select the following
groups and packages for installation:
</p>
<table>
<tr>
<th valign="top" align="right"> Groups </th>
<td>
Archive <br/>
Base <br/>
Devel <br/>
Editors <br/>
Mingw <br/>
Perl <br/>
Python <br/>
Shells <br/></td>
</tr>
<tr>
<th valign="top" align="right"> Packages </th>
<td>
openssh <br/>
sunrpc &#x2265; 4.0-4 (see below) <br/></td>
</tr>
</table>
</li>
<li>
<p> Once Cygwin has finished installing, start a Cygwin bash shell
(either click on the desktop icon or look for Cygwin bash shell
in the Start menu). </p>
<p> The very first time you start the Cygwin bash shell, you may
find you need to run the <code>mkpasswd</code> and <code>mkgroup</code>
commands in order to create <code>/etc/passwd</code> and
<code>/etc/group</code> files from Windows users. If this
is needed then a message is printed in the shell.
Note that you need to do this as Windows Administrator. </p>
</li>
<li>
<p> Install Cygwin sunrpc &#x2265; 4.0-4 package, patched to include
<code>librpc.dll</code>.
To do this, first check to see whether <code>/usr/lib/librpc.dll</code>
exists. If it does, you're good to go and can skip to the next
step. </p>
<p>
If you don't have this file, either install the binary package
<a href="ftp://libvirt.org/libvirt/win32/sunrpc-4.0-4.tar.bz2">sunrpc-4.0-4.tar.bz2</a> (just unpack it, as Administrator, in the Cygwin root directory).
Or you can download the
<a href="ftp://libvirt.org/libvirt/win32/sunrpc-4.0-dll.patch">source patch</a>
and apply it by hand to the Cygwin sunrpc package (eg. using
cygport).
</p>
</li>
<li>
<p>
Check out
<a href="http://www.libvirt.org/downloads.html">Libvirt from CVS</a> and
<a href="ftp://libvirt.org/libvirt/win32">apply the latest Windows patch</a>
to the source.
</p>
</li>
<li>
<p> Configure libvirt by doing: </p>
<pre>
autoreconf
./configure --without-xen --without-qemu
</pre>
<p> (The autoreconf step is probably optional). </p>
<p> The configure step will tell you if you have all the
required parts installed. If something is missing you
will need to go back through Cygwin setup and install it.
</p>
</li>
<li>
<p> Rebuild the XDR structures: </p>
<pre>
rm qemud/remote_protocol.[ch] qemud/remote_dispatch_*.h
make -C qemud remote_protocol.c
</pre>
</li>
<li>
<p> Build: </p>
<pre>
make
</pre> </pre>
<p> If this step is not successful, you should post a full
report <i>including complete messages</i> to <p>
<a href="http://www.redhat.com/mailman/listinfo/libvir-list">the We intend to supply Windows binaries on this page
libvirt mailing list</a>. later, but at the moment you have to compile from source.
</p> </p>
</li>
<li>
<p> Test it. If you have access to a remote machine
running Xen or QEMU/KVM, and the libvirt daemon (<code>libvirtd</code>)
then you should be able to connect to it and display
domains using, eg:
</p>
<pre>
src/virsh.exe <a href="http://libvirt.org/uri.html">-c qemu://remote/system</a> list --all
</pre>
<p>
Please read more about <a href="http://libvirt.org/remote.html">remote
support</a> before sending bug reports, to make sure that
any problems are really Windows and not just with remote
configuration / security.
</p>
</li>
<li>
<p>
You may want to install the library and programs by doing:
</p>
<pre>
make install
</pre>
</li>
<li>
<p>
The above steps should also build and install Python modules.
However for reasons which I don't fully understand, Python won't
look in the
non-standard <code>/usr/local/lib/python*/site-packages/</code>
directory by default so you may need to set the environment
variable PYTHONPATH:
</p>
<pre>
export PYTHONPATH=/usr/local/lib/python2.5/site-packages
</pre>
<p>
(Change the version number to your version of Python). You
can test Python support from the command line:
</p>
<pre>
python
&gt;&gt;&gt; import libvirt
&gt;&gt;&gt; conn = libvirt.open ("test:///default")
&gt;&gt;&gt; conn.listDomainsID ()
[1]
&gt;&gt;&gt; dom = conn.lookupByID (1)
&gt;&gt;&gt; dom.XMLDesc (0)
"&lt;domain type='test' id='1'&gt; ..."
</pre>
<p>
The most common failure will be with <code>import libvirt</code>
which usually indicates that either <code>PYTHONPATH</code> is
wrong or a DLL cannot be loaded.
</p>
</li>
</ol>
</body> </body>
</html> </html>
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或