mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-12-23 22:25:25 +00:00
ba5f3c7c8e
Change the build process & driver initialization so that the VirtualBox driver is built into libvirtd, instead of libvirt.so This change avoids the VirtualBox GPLv2-only license causing compatibility problems with libvirt.so which is under the GPLv2-or-later license. NB this change prevents use of the VirtualBox driver on the Windows platform, until such time as libvirtd can be made to work there. Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
146 lines
4.2 KiB
XML
146 lines
4.2 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<body>
|
|
<h1>VirtualBox hypervisor driver</h1>
|
|
<p>
|
|
The libvirt VirtualBox driver can manage any VirtualBox version
|
|
from version 2.2 onwards.
|
|
</p>
|
|
|
|
<h2><a name="project">Project Links</a></h2>
|
|
|
|
<ul>
|
|
<li>
|
|
The <a href="http://www.virtualbox.org/">VirtualBox</a>
|
|
hypervisor
|
|
</li>
|
|
</ul>
|
|
|
|
<h2>Connections to VirtualBox driver</h2>
|
|
|
|
<p>
|
|
The libvirt VirtualBox driver provides per-user drivers (the "session" instance).
|
|
The uri of the driver protocol is "vbox". Some example connection URIs for the driver are:
|
|
</p>
|
|
|
|
<pre>
|
|
vbox:///session (local access to per-user instance)
|
|
vbox+unix:///session (local access to per-user instance)
|
|
vbox+tcp://user@example.com/session (remote access, SASl/Kerberos)
|
|
vbox+ssh://user@example.com/session (remote access, SSH tunnelled)
|
|
</pre>
|
|
|
|
<p>
|
|
<strong>NOTE: as of libvirt 1.0.6, the VirtualBox driver will always
|
|
run inside the libvirtd daemon, instead of being built-in to the
|
|
libvirt.so library directly. This change was required due to the
|
|
fact that VirtualBox code is LGPLv2-only licensed, which is not
|
|
compatible with the libvirt.so license of LGPLv2-or-later. The
|
|
daemon will be auto-started when the first connection to VirtualBox
|
|
is requested. This change also means that it will not be possible
|
|
to use VirtualBox URIs on the Windows platform, until additional
|
|
work is completed to get the libvirtd daemon working there.</strong>
|
|
</p>
|
|
|
|
<h2><a name="xmlconfig">Example domain XML config</a></h2>
|
|
|
|
<pre>
|
|
<domain type='vbox'>
|
|
<name>vbox</name>
|
|
<uuid>4dab22b31d52d8f32516782e98ab3fa0</uuid>
|
|
|
|
<os>
|
|
<type>hvm</type>
|
|
<boot dev='cdrom'/>
|
|
<boot dev='hd'/>
|
|
<boot dev='fd'/>
|
|
<boot dev='network'/>
|
|
</os>
|
|
|
|
<memory>654321</memory>
|
|
<vcpu>1</vcpu>
|
|
|
|
<features>
|
|
<pae/>
|
|
<acpi/>
|
|
<apic/>
|
|
</features>
|
|
|
|
<devices>
|
|
<disk type='file' device='cdrom'>
|
|
<source file='/home/user/Downloads/slax-6.0.9.iso'/>
|
|
<target dev='hdc'/>
|
|
<readonly/>
|
|
</disk>
|
|
|
|
<disk type='file' device='disk'>
|
|
<source file='/home/user/tmp/vbox.vdi'/>
|
|
<target dev='hdd'/>
|
|
</disk>
|
|
|
|
<disk type='file' device='floppy'>
|
|
<source file='/home/user/tmp/WIN98C.IMG'/>
|
|
<target dev='fda'/>
|
|
</disk>
|
|
|
|
<filesystem type='mount'>
|
|
<source dir='/home/user/stuff'/>
|
|
<target dir='my-shared-folder'/>
|
|
</filesystem>
|
|
|
|
<!--BRIDGE-->
|
|
<interface type='bridge'>
|
|
<source bridge='eth0'/>
|
|
<mac address='00:16:3e:5d:c7:9e'/>
|
|
<model type='am79c973'/>
|
|
</interface>
|
|
|
|
<!--NAT-->
|
|
<interface type='user'>
|
|
<mac address='56:16:3e:5d:c7:9e'/>
|
|
<model type='82540eM'/>
|
|
</interface>
|
|
|
|
<sound model='sb16'/>
|
|
|
|
<parallel type='dev'>
|
|
<source path='/dev/pts/1'/>
|
|
<target port='0'/>
|
|
</parallel>
|
|
|
|
<parallel type='dev'>
|
|
<source path='/dev/pts/2'/>
|
|
<target port='1'/>
|
|
</parallel>
|
|
|
|
<serial type="dev">
|
|
<source path="/dev/ttyS0"/>
|
|
<target port="0"/>
|
|
</serial>
|
|
|
|
<serial type="pipe">
|
|
<source path="/tmp/serial.txt"/>
|
|
<target port="1"/>
|
|
</serial>
|
|
|
|
<hostdev mode='subsystem' type='usb'>
|
|
<source>
|
|
<vendor id='0x1234'/>
|
|
<product id='0xbeef'/>
|
|
</source>
|
|
</hostdev>
|
|
|
|
<hostdev mode='subsystem' type='usb'>
|
|
<source>
|
|
<vendor id='0x4321'/>
|
|
<product id='0xfeeb'/>
|
|
</source>
|
|
</hostdev>
|
|
</devices>
|
|
</domain>
|
|
</pre>
|
|
|
|
</body>
|
|
</html>
|