~ubuntu-branches/ubuntu/saucy/libvirt/saucy

3.6.2 by Guido Günther
* Upload to unstable
1
<?xml version="1.0" encoding="UTF-8"?>
3.6.1 by Guido Günther, Laurent Léonard
[ Laurent Léonard ]
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
1.1.12 by Guido Günther
Import upstream version 0.6.3
3
<html xmlns="http://www.w3.org/1999/xhtml">
4
<!--
5
        This file is autogenerated from drvvbox.html.in
6
        Do not edit this file. Changes will be lost.
7
      -->
8
  <head>
3.6.2 by Guido Günther
* Upload to unstable
9
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
1.1.12 by Guido Günther
Import upstream version 0.6.3
10
    <link rel="stylesheet" type="text/css" href="main.css" />
11
    <link rel="SHORTCUT ICON" href="32favicon.png" />
12
    <title>libvirt: VirtualBox hypervisor driver</title>
13
    <meta name="description" content="libvirt, virtualization, virtualization API" />
14
  </head>
15
  <body>
16
    <div id="header">
17
      <div id="headerLogo"></div>
18
      <div id="headerSearch">
19
        <form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><div>
20
            <input id="query" name="query" type="text" size="12" value="" />
21
            <input id="submit" name="submit" type="submit" value="Search" />
22
          </div></form>
23
      </div>
24
    </div>
25
    <div id="body">
26
      <div id="menu">
27
        <ul class="l0"><li>
28
            <div>
29
              <a title="Front page of the libvirt website" class="inactive" href="index.html">Home</a>
30
            </div>
31
          </li><li>
32
            <div>
33
              <a title="Details of new features and bugs fixed in each release" class="inactive" href="news.html">News</a>
34
            </div>
35
          </li><li>
36
            <div>
3.4.25 by Laurent Léonard, Guido Günther, Laurent Léonard
[ Guido Günther ]
37
              <a title="Applications known to use libvirt" class="inactive" href="apps.html">Applications</a>
38
            </div>
39
          </li><li>
40
            <div>
1.1.12 by Guido Günther
Import upstream version 0.6.3
41
              <a title="Get the latest source releases, binary builds and get access to the source repository" class="inactive" href="downloads.html">Downloads</a>
42
            </div>
43
          </li><li>
44
            <div>
45
              <a title="Information for users, administrators and developers" class="active" href="docs.html">Documentation</a>
46
              <ul class="l1"><li>
47
                  <div>
3.4.23 by Guido Günther, Laurent Léonard, Guido Günther
[ Laurent Léonard ]
48
                    <a title="How to compile libvirt" class="inactive" href="compiling.html">Compiling</a>
49
                  </div>
50
                </li><li>
51
                  <div>
1.1.12 by Guido Günther
Import upstream version 0.6.3
52
                    <a title="Information about deploying and using libvirt" class="inactive" href="deployment.html">Deployment</a>
53
                  </div>
54
                </li><li>
55
                  <div>
56
                    <a title="Overview of the logical subsystems in the libvirt API" class="inactive" href="intro.html">Architecture</a>
57
                  </div>
58
                </li><li>
59
                  <div>
60
                    <a title="Description of the XML formats used in libvirt" class="inactive" href="format.html">XML format</a>
61
                  </div>
62
                </li><li>
63
                  <div>
64
                    <a title="Hypervisor specific driver information" class="active" href="drivers.html">Drivers</a>
65
                    <ul class="l2"><li>
66
                        <div>
67
                          <a title="Driver the Xen hypervisor" class="inactive" href="drvxen.html">Xen</a>
68
                        </div>
69
                      </li><li>
70
                        <div>
71
                          <a title="Driver for QEMU, KQEMU, KVM and Xenner" class="inactive" href="drvqemu.html">QEMU / KVM</a>
72
                        </div>
73
                      </li><li>
74
                        <div>
75
                          <a title="Driver for the Linux native container API" class="inactive" href="drvlxc.html">Linux Container</a>
76
                        </div>
77
                      </li><li>
78
                        <div>
3.4.11 by Laurent Léonard
* [0229557] Imported Upstream version 0.7.6
79
                          <a title="Pseudo-driver simulating APIs in memory for test suites" class="inactive" href="drvtest.html">Test</a>
1.1.12 by Guido Günther
Import upstream version 0.6.3
80
                        </div>
81
                      </li><li>
82
                        <div>
83
                          <a title="Driver providing secure remote to the libvirt APIs" class="inactive" href="drvremote.html">Remote</a>
84
                        </div>
85
                      </li><li>
86
                        <div>
87
                          <a title="Driver for the OpenVZ container technology" class="inactive" href="drvopenvz.html">OpenVZ</a>
88
                        </div>
89
                      </li><li>
90
                        <div>
91
                          <a title="Driver for the User Mode Linux technology" class="inactive" href="drvuml.html">UML</a>
92
                        </div>
93
                      </li><li>
94
                        <div>
95
                          <a title="Driver for the storage management APIs" class="inactive" href="storage.html">Storage</a>
96
                        </div>
97
                      </li><li>
98
                        <div>
99
                          <span class="active">VirtualBox</span>
100
                        </div>
1.1.13 by Guido Günther
Import upstream version 0.6.5
101
                      </li><li>
102
                        <div>
3.6.1 by Guido Günther, Laurent Léonard
[ Laurent Léonard ]
103
                          <a title="Driver for VMware ESX" class="inactive" href="drvesx.html">VMware ESX</a>
104
                        </div>
3.4.23 by Guido Günther, Laurent Léonard, Guido Günther
[ Laurent Léonard ]
105
                      </li><li>
106
                        <div>
107
                          <a title="Driver for VMware Workstation / Player" class="inactive" href="drvvmware.html">VMware Workstation / Player</a>
108
                        </div>
3.4.44 by Guido Günther
* [828e4e3] New upstream version 0.9.6
109
                      </li><li>
110
                        <div>
111
                          <a title="Driver for Microsoft Hyper-V" class="inactive" href="drvhyperv.html">Microsoft Hyper-V</a>
112
                        </div>
1.2.18 by Chuck Short
Import upstream version 1.0.5
113
                      </li><li>
114
                        <div>
115
                          <a title="Driver for IBM PowerVM" class="inactive" href="drvphyp.html">IBM PowerVM</a>
116
                        </div>
117
                      </li><li>
118
                        <div>
119
                          <a title="Driver for Parallels Cloud Server" class="inactive" href="drvparallels.html">Parallels</a>
120
                        </div>
1.1.12 by Guido Günther
Import upstream version 0.6.3
121
                      </li></ul>
122
                  </div>
123
                </li><li>
124
                  <div>
125
                    <a title="Reference manual for the C public API" class="inactive" href="html/index.html">API reference</a>
126
                  </div>
127
                </li><li>
128
                  <div>
129
                    <a title="Bindings of the libvirt API for other languages" class="inactive" href="bindings.html">Language bindings</a>
130
                  </div>
1.1.13 by Guido Günther
Import upstream version 0.6.5
131
                </li><li>
132
                  <div>
133
                    <a title="Working on the internals of libvirt API, driver and daemon code" class="inactive" href="internals.html">Internals</a>
134
                  </div>
1.2.7 by Serge Hallyn
Import upstream version 0.8.5
135
                </li><li>
136
                  <div>
137
                    <a title="A guide and reference for developing with libvirt" class="inactive" href="devguide.html">Development Guide</a>
138
                  </div>
3.4.23 by Guido Günther, Laurent Léonard, Guido Günther
[ Laurent Léonard ]
139
                </li><li>
140
                  <div>
141
                    <a title="Command reference for virsh" class="inactive" href="virshcmdref.html">Virsh Commands</a>
142
                  </div>
1.1.12 by Guido Günther
Import upstream version 0.6.3
143
                </li></ul>
144
            </div>
145
          </li><li>
146
            <div>
147
              <a title="User contributed content" class="inactive" href="http://wiki.libvirt.org">Wiki</a>
148
            </div>
149
          </li><li>
150
            <div>
3.4.18 by Laurent Léonard, Guido Günther, Laurent Léonard
[ Guido Günther ]
151
              <a title="Frequently asked questions" class="inactive" href="http://wiki.libvirt.org/page/FAQ">FAQ</a>
1.1.12 by Guido Günther
Import upstream version 0.6.3
152
            </div>
153
          </li><li>
154
            <div>
155
              <a title="How and where to report bugs and request features" class="inactive" href="bugs.html">Bug reports</a>
156
            </div>
157
          </li><li>
158
            <div>
159
              <a title="How to contact the developers via email and IRC" class="inactive" href="contact.html">Contact</a>
160
            </div>
161
          </li><li>
162
            <div>
3.4.32 by Guido Günther
* [c6187ec] New upstream version 0.9.2
163
              <a title="Available test suites for libvirt" class="inactive" href="testsuites.html">Test suites</a>
164
            </div>
165
          </li><li>
166
            <div>
1.1.12 by Guido Günther
Import upstream version 0.6.3
167
              <a title="Miscellaneous links of interest related to libvirt" class="inactive" href="relatedlinks.html">Related Links</a>
168
            </div>
169
          </li><li>
170
            <div>
171
              <a title="Overview of all content on the website" class="inactive" href="sitemap.html">Sitemap</a>
172
            </div>
173
          </li></ul>
174
      </div>
175
      <div id="content">
176
        <h1>VirtualBox hypervisor driver</h1>
177
        <p>
178
        The libvirt VirtualBox driver can manage any VirtualBox version
179
        from version 2.2 onwards.
180
    </p>
3.4.43 by Guido Günther, Philipp Hahn, c9a080d
[ Philipp Hahn ]
181
        <h2>
182
          <a name="project" id="project">Project Links</a>
183
        </h2>
184
        <ul><li>
185
        The <a href="http://www.virtualbox.org/">VirtualBox</a>
186
        hypervisor
187
      </li></ul>
1.1.12 by Guido Günther
Import upstream version 0.6.3
188
        <h2>Connections to VirtualBox driver</h2>
189
        <p>
190
    The libvirt VirtualBox driver provides per-user drivers (the "session" instance).
191
    The uri of the driver protocol is "vbox". Some example connection URIs for the driver are:
192
    </p>
193
        <pre>
3.6.1 by Guido Günther, Laurent Léonard
[ Laurent Léonard ]
194
vbox:///session                      (local access to per-user instance)
195
vbox+unix:///session                 (local access to per-user instance)
196
vbox+tcp://user@example.com/session  (remote access, SASl/Kerberos)
197
vbox+ssh://user@example.com/session  (remote access, SSH tunnelled)
198
</pre>
1.1.12 by Guido Günther
Import upstream version 0.6.3
199
        <h2>
200
          <a name="xmlconfig" id="xmlconfig">Example domain XML config</a>
201
        </h2>
202
        <pre>
3.6.1 by Guido Günther, Laurent Léonard
[ Laurent Léonard ]
203
&lt;domain type='vbox'&gt;
204
  &lt;name&gt;vbox&lt;/name&gt;
205
  &lt;uuid&gt;4dab22b31d52d8f32516782e98ab3fa0&lt;/uuid&gt;
206
207
  &lt;os&gt;
208
    &lt;type&gt;hvm&lt;/type&gt;
209
    &lt;boot dev='cdrom'/&gt;
210
    &lt;boot dev='hd'/&gt;
211
    &lt;boot dev='fd'/&gt;
212
    &lt;boot dev='network'/&gt;
213
  &lt;/os&gt;
214
215
  &lt;memory&gt;654321&lt;/memory&gt;
216
  &lt;vcpu&gt;1&lt;/vcpu&gt;
217
218
  &lt;features&gt;
219
    &lt;pae/&gt;
220
    &lt;acpi/&gt;
221
    &lt;apic/&gt;
222
  &lt;/features&gt;
223
224
  &lt;devices&gt;
225
    &lt;disk type='file' device='cdrom'&gt;
226
      &lt;source file='/home/user/Downloads/slax-6.0.9.iso'/&gt;
227
      &lt;target dev='hdc'/&gt;
228
      &lt;readonly/&gt;
229
    &lt;/disk&gt;
230
231
    &lt;disk type='file' device='disk'&gt;
232
      &lt;source file='/home/user/tmp/vbox.vdi'/&gt;
233
      &lt;target dev='hdd'/&gt;
234
    &lt;/disk&gt;
235
236
    &lt;disk type='file' device='floppy'&gt;
237
      &lt;source file='/home/user/tmp/WIN98C.IMG'/&gt;
238
      &lt;target dev='fda'/&gt;
239
    &lt;/disk&gt;
240
3.4.46 by Guido Günther
* [b0bdb13] Enable numa support. (Closes: #648323)
241
    &lt;filesystem type='mount'&gt;
242
      &lt;source dir='/home/user/stuff'/&gt;
243
      &lt;target dir='my-shared-folder'/&gt;
244
    &lt;/filesystem&gt;
245
3.6.1 by Guido Günther, Laurent Léonard
[ Laurent Léonard ]
246
    &lt;!--BRIDGE--&gt;
247
    &lt;interface type='bridge'&gt;
248
      &lt;source bridge='eth0'/&gt;
249
      &lt;mac address='00:16:3e:5d:c7:9e'/&gt;
250
      &lt;model type='am79c973'/&gt;
251
    &lt;/interface&gt;
252
253
    &lt;!--NAT--&gt;
254
    &lt;interface type='user'&gt;
255
      &lt;mac address='56:16:3e:5d:c7:9e'/&gt;
256
      &lt;model type='82540eM'/&gt;
257
    &lt;/interface&gt;
258
259
    &lt;sound model='sb16'/&gt;
260
261
    &lt;parallel type='dev'&gt;
262
      &lt;source path='/dev/pts/1'/&gt;
263
      &lt;target port='0'/&gt;
264
    &lt;/parallel&gt;
265
266
    &lt;parallel type='dev'&gt;
267
      &lt;source path='/dev/pts/2'/&gt;
268
      &lt;target port='1'/&gt;
269
    &lt;/parallel&gt;
270
271
    &lt;serial type="dev"&gt;
272
      &lt;source path="/dev/ttyS0"/&gt;
273
      &lt;target port="0"/&gt;
274
    &lt;/serial&gt;
275
276
    &lt;serial type="pipe"&gt;
277
      &lt;source path="/tmp/serial.txt"/&gt;
278
      &lt;target port="1"/&gt;
279
    &lt;/serial&gt;
280
281
    &lt;hostdev mode='subsystem' type='usb'&gt;
282
      &lt;source&gt;
283
        &lt;vendor id='0x1234'/&gt;
284
        &lt;product id='0xbeef'/&gt;
285
      &lt;/source&gt;
286
    &lt;/hostdev&gt;
287
288
    &lt;hostdev mode='subsystem' type='usb'&gt;
289
      &lt;source&gt;
290
        &lt;vendor id='0x4321'/&gt;
291
        &lt;product id='0xfeeb'/&gt;
292
      &lt;/source&gt;
293
    &lt;/hostdev&gt;
294
  &lt;/devices&gt;
295
&lt;/domain&gt;
296
</pre>
1.1.12 by Guido Günther
Import upstream version 0.6.3
297
      </div>
298
    </div>
299
    <div id="footer">
300
      <p id="sponsor">
301
	    Sponsored by:<br /><a href="http://et.redhat.com/"><img src="et.png" alt="Project sponsored by Red Hat Emerging Technology" /></a></p>
302
    </div>
303
  </body>
304
</html>