<?xml version="1.0" encoding="ISO-8859-1"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <!-- This file is autogenerated from drvvbox.html.in Do not edit this file. Changes will be lost. --> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /> <link rel="stylesheet" type="text/css" href="main.css" /> <link rel="SHORTCUT ICON" href="32favicon.png" /> <title>libvirt: VirtualBox hypervisor driver</title> <meta name="description" content="libvirt, virtualization, virtualization API" /> </head> <body> <div id="header"> <div id="headerLogo"></div> <div id="headerSearch"> <form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><div> <input id="query" name="query" type="text" size="12" value="" /> <input id="submit" name="submit" type="submit" value="Search" /> </div></form> </div> </div> <div id="body"> <div id="menu"> <ul class="l0"><li> <div> <a title="Front page of the libvirt website" class="inactive" href="index.html">Home</a> </div> </li><li> <div> <a title="Details of new features and bugs fixed in each release" class="inactive" href="news.html">News</a> </div> </li><li> <div> <a title="Get the latest source releases, binary builds and get access to the source repository" class="inactive" href="downloads.html">Downloads</a> </div> </li><li> <div> <a title="Information for users, administrators and developers" class="active" href="docs.html">Documentation</a> <ul class="l1"><li> <div> <a title="Information about deploying and using libvirt" class="inactive" href="deployment.html">Deployment</a> </div> </li><li> <div> <a title="Overview of the logical subsystems in the libvirt API" class="inactive" href="intro.html">Architecture</a> </div> </li><li> <div> <a title="Description of the XML formats used in libvirt" class="inactive" href="format.html">XML format</a> </div> </li><li> <div> <a title="Hypervisor specific driver information" class="active" href="drivers.html">Drivers</a> <ul class="l2"><li> <div> <a title="Driver the Xen hypervisor" class="inactive" href="drvxen.html">Xen</a> </div> </li><li> <div> <a title="Driver for QEMU, KQEMU, KVM and Xenner" class="inactive" href="drvqemu.html">QEMU / KVM</a> </div> </li><li> <div> <a title="Driver for the Linux native container API" class="inactive" href="drvlxc.html">Linux Container</a> </div> </li><li> <div> <a title="Psuedo-driver simulating APIs in memory for test suites" class="inactive" href="drvtest.html">Test</a> </div> </li><li> <div> <a title="Driver providing secure remote to the libvirt APIs" class="inactive" href="drvremote.html">Remote</a> </div> </li><li> <div> <a title="Driver for the OpenVZ container technology" class="inactive" href="drvopenvz.html">OpenVZ</a> </div> </li><li> <div> <a title="Driver for the User Mode Linux technology" class="inactive" href="drvuml.html">UML</a> </div> </li><li> <div> <a title="Driver for the storage management APIs" class="inactive" href="storage.html">Storage</a> </div> </li><li> <div> <span class="active">VirtualBox</span> </div> </li></ul> </div> </li><li> <div> <a title="Reference manual for the C public API" class="inactive" href="html/index.html">API reference</a> </div> </li><li> <div> <a title="Bindings of the libvirt API for other languages" class="inactive" href="bindings.html">Language bindings</a> </div> </li></ul> </div> </li><li> <div> <a title="User contributed content" class="inactive" href="http://wiki.libvirt.org">Wiki</a> </div> </li><li> <div> <a title="Frequently asked questions" class="inactive" href="FAQ.html">FAQ</a> </div> </li><li> <div> <a title="How and where to report bugs and request features" class="inactive" href="bugs.html">Bug reports</a> </div> </li><li> <div> <a title="How to contact the developers via email and IRC" class="inactive" href="contact.html">Contact</a> </div> </li><li> <div> <a title="Miscellaneous links of interest related to libvirt" class="inactive" href="relatedlinks.html">Related Links</a> </div> </li><li> <div> <a title="Overview of all content on the website" class="inactive" href="sitemap.html">Sitemap</a> </div> </li></ul> </div> <div id="content"> <h1>VirtualBox hypervisor driver</h1> <p> The libvirt VirtualBox driver can manage any VirtualBox version from version 2.2 onwards. </p> <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" id="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> <!--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> </div> </div> <div id="footer"> <p id="sponsor"> Sponsored by:<br /><a href="http://et.redhat.com/"><img src="et.png" alt="Project sponsored by Red Hat Emerging Technology" /></a></p> </div> </body> </html>