mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-12-23 06:05:27 +00:00
f2f9742d4d
The rule generating the HTML docs passing the --html flag to xsltproc. This makes it use the legacy HTML parser, which either ignores or tries to fix all sorts of broken XML tags. There's no reason why we should be writing broken XML in the first place, so removing --html and adding the XHTML doctype to all files forces us to create good XML. This adds the XHTML doc type and fixes many, many XML tag problems it exposes. Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
134 lines
3.5 KiB
XML
134 lines
3.5 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>
|
|
|
|
<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>
|