docs/drvvbox.html.in


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131

<html>
    <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>
&lt;domain type='vbox'&gt;
  &lt;name&gt;vbox&lt;/name&gt;
  &lt;uuid&gt;4dab22b31d52d8f32516782e98ab3fa0&lt;/uuid&gt;

  &lt;os&gt;
    &lt;type&gt;hvm&lt;/type&gt;
    &lt;boot dev='cdrom'/&gt;
    &lt;boot dev='hd'/&gt;
    &lt;boot dev='fd'/&gt;
    &lt;boot dev='network'/&gt;
  &lt;/os&gt;

  &lt;memory&gt;654321&lt;/memory&gt;
  &lt;vcpu&gt;1&lt;/vcpu&gt;

  &lt;features&gt;
    &lt;pae/&gt;
    &lt;acpi/&gt;
    &lt;apic/&gt;
  &lt;/features&gt;

  &lt;devices&gt;
    &lt;disk type='file' device='cdrom'&gt;
      &lt;source file='/home/user/Downloads/slax-6.0.9.iso'/&gt;
      &lt;target dev='hdc'/&gt;
      &lt;readonly/&gt;
    &lt;/disk&gt;

    &lt;disk type='file' device='disk'&gt;
      &lt;source file='/home/user/tmp/vbox.vdi'/&gt;
      &lt;target dev='hdd'/&gt;
    &lt;/disk&gt;

    &lt;disk type='file' device='floppy'&gt;
      &lt;source file='/home/user/tmp/WIN98C.IMG'/&gt;
      &lt;target dev='fda'/&gt;
    &lt;/disk&gt;

    &lt;filesystem type='mount'&gt;
      &lt;source dir='/home/user/stuff'/&gt;
      &lt;target dir='my-shared-folder'/&gt;
    &lt;/filesystem&gt;

    &lt;!--BRIDGE--&gt;
    &lt;interface type='bridge'&gt;
      &lt;source bridge='eth0'/&gt;
      &lt;mac address='00:16:3e:5d:c7:9e'/&gt;
      &lt;model type='am79c973'/&gt;
    &lt;/interface&gt;

    &lt;!--NAT--&gt;
    &lt;interface type='user'&gt;
      &lt;mac address='56:16:3e:5d:c7:9e'/&gt;
      &lt;model type='82540eM'/&gt;
    &lt;/interface&gt;

    &lt;sound model='sb16'/&gt;

    &lt;parallel type='dev'&gt;
      &lt;source path='/dev/pts/1'/&gt;
      &lt;target port='0'/&gt;
    &lt;/parallel&gt;

    &lt;parallel type='dev'&gt;
      &lt;source path='/dev/pts/2'/&gt;
      &lt;target port='1'/&gt;
    &lt;/parallel&gt;

    &lt;serial type="dev"&gt;
      &lt;source path="/dev/ttyS0"/&gt;
      &lt;target port="0"/&gt;
    &lt;/serial&gt;

    &lt;serial type="pipe"&gt;
      &lt;source path="/tmp/serial.txt"/&gt;
      &lt;target port="1"/&gt;
    &lt;/serial&gt;

    &lt;hostdev mode='subsystem' type='usb'&gt;
      &lt;source&gt;
        &lt;vendor id='0x1234'/&gt;
        &lt;product id='0xbeef'/&gt;
      &lt;/source&gt;
    &lt;/hostdev&gt;

    &lt;hostdev mode='subsystem' type='usb'&gt;
      &lt;source&gt;
        &lt;vendor id='0x4321'/&gt;
        &lt;product id='0xfeeb'/&gt;
      &lt;/source&gt;
    &lt;/hostdev&gt;
  &lt;/devices&gt;
&lt;/domain&gt;
</pre>

    </body>
</html>