External/libvirt
1
0
Fork 0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2025-02-01 09:25:18 +00:00
Code Issues Packages Projects Releases Wiki Activity

Whitespace cleanup for pre-tags on the website

Browse Source
This commit is contained in:
Matthias Bolte 2009-11-14 00:09:20 +01:00
parent 448b92c05e
commit afec7cf1ff
10 changed files with 237 additions and 245 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
docs/drvone.html.in
View File

@ -27,12 +27,13 @@ tools and VM description files.</p>
<p>The Uri of the driver protocol is "one". Some example <p>The Uri of the driver protocol is "one". Some example
connection Uris for the driver are: connection Uris for the driver are:
</p> </p>
<pre> one:/// (local access) <pre>
one+unix:/// (local access) one:/// (local access)
one://example.com/ (remote access) one+unix:/// (local access)
one+tcp://example.com/ (remote access, SASl/Kerberos) one://example.com/ (remote access)
one+ssh://user@example.com/ (remote access, SSH tunnelled) one+tcp://example.com/ (remote access, SASl/Kerberos)
</pre> one+ssh://user@example.com/ (remote access, SSH tunnelled)
</pre>
<h2> <h2>
<a name="xmlconfig"></a>Example domain XML config</h2> <a name="xmlconfig"></a>Example domain XML config</h2>
<p>There are some limitations on the XML attributes that may be <p>There are some limitations on the XML attributes that may be
@ -42,7 +43,8 @@ driver:</p>
<h3>Paravirtualized guest direct kernel boot <h3>Paravirtualized guest direct kernel boot
</h3> </h3>
<pre> &lt;domain type='one'&gt; <pre>
&lt;domain type='one'&gt;
&lt;name&gt;vm01&lt;/name&gt; &lt;name&gt;vm01&lt;/name&gt;
&lt;memory&gt;32768&lt;/memory&gt; &lt;memory&gt;32768&lt;/memory&gt;
&lt;vcpu&gt;1&lt;/vcpu&gt; &lt;vcpu&gt;1&lt;/vcpu&gt;
@ -56,7 +58,6 @@ driver:</p>
&lt;/os&gt; &lt;/os&gt;
&lt;devices&gt; &lt;devices&gt;
&lt;disk type='file' device='disk'&gt; &lt;disk type='file' device='disk'&gt;
&lt;source file='/images/sgehosts/01/disk.img'/&gt; &lt;source file='/images/sgehosts/01/disk.img'/&gt;
&lt;target dev='sda1'/&gt; &lt;target dev='sda1'/&gt;
@ -85,8 +86,8 @@ driver:</p>
&lt;source network='onenetwork'/&gt; &lt;source network='onenetwork'/&gt;
&lt;/interface&gt; &lt;/interface&gt;
&lt;/devices&gt; &lt;/devices&gt;
&lt;/domain&gt; &lt;/domain&gt;
</pre> </pre>
<p> <p>
<b>Note:</b> The "&lt;interface type='network'&gt;" will <b>Note:</b> The "&lt;interface type='network'&gt;" will
attach the interface to a previously configured network (named attach the interface to a previously configured network (named

22
docs/drvopenvz.html.in
View File

@ -19,13 +19,13 @@
the libvirt driver are: the libvirt driver are:
</p> </p>
<pre> <pre>
openvz:///system (local access) openvz:///system (local access)
openvz+unix:///system (local access) openvz+unix:///system (local access)
openvz://example.com/system (remote access, TLS/x509) openvz://example.com/system (remote access, TLS/x509)
openvz+tcp://example.com/system (remote access, SASl/Kerberos) openvz+tcp://example.com/system (remote access, SASl/Kerberos)
openvz+ssh://root@example.com/system (remote access, SSH tunnelled) openvz+ssh://root@example.com/system (remote access, SSH tunnelled)
</pre> </pre>
<h2>Notes on bridged networking</h2> <h2>Notes on bridged networking</h2>
@ -60,10 +60,10 @@
must be created containing must be created containing
</p> </p>
<pre> <pre>
#!/bin/bash #!/bin/bash
EXTERNAL_SCRIPT="/usr/sbin/vznetaddbr" EXTERNAL_SCRIPT="/usr/sbin/vznetaddbr"
</pre> </pre>
<p> <p>
The host OS is now ready to allow bridging of guest containers, which The host OS is now ready to allow bridging of guest containers, which
@ -83,7 +83,7 @@ EXTERNAL_SCRIPT="/usr/sbin/vznetaddbr"
matches the templates known to OpenVZ tools. matches the templates known to OpenVZ tools.
</p> </p>
<pre> <pre>
&lt;domain type='openvz' id='104'&gt; &lt;domain type='openvz' id='104'&gt;
&lt;name&gt;104&lt;/name&gt; &lt;name&gt;104&lt;/name&gt;
&lt;uuid&gt;86c12009-e591-a159-6e9f-91d18b85ef78&lt;/uuid&gt; &lt;uuid&gt;86c12009-e591-a159-6e9f-91d18b85ef78&lt;/uuid&gt;
@ -104,7 +104,7 @@ EXTERNAL_SCRIPT="/usr/sbin/vznetaddbr"
&lt;/interface&gt; &lt;/interface&gt;
&lt;/devices&gt; &lt;/devices&gt;
&lt;/domain&gt; &lt;/domain&gt;
</pre> </pre>
</body> </body>
</html> </html>

46
docs/drvqemu.html.in
View File

@ -43,16 +43,16 @@
is "qemu". Some example conection URIs for the libvirt driver are: is "qemu". Some example conection URIs for the libvirt driver are:
</p> </p>
<pre> <pre>
qemu:///session (local access to per-user instance) qemu:///session (local access to per-user instance)
qemu+unix:///session (local access to per-user instance) qemu+unix:///session (local access to per-user instance)
qemu:///system (local access to system instance) qemu:///system (local access to system instance)
qemu+unix:///system (local access to system instance) qemu+unix:///system (local access to system instance)
qemu://example.com/system (remote access, TLS/x509) qemu://example.com/system (remote access, TLS/x509)
qemu+tcp://example.com/system (remote access, SASl/Kerberos) qemu+tcp://example.com/system (remote access, SASl/Kerberos)
qemu+ssh://root@example.com/system (remote access, SSH tunnelled) qemu+ssh://root@example.com/system (remote access, SSH tunnelled)
</pre> </pre>
<h2><a name="security">Driver security architecture</a></h2> <h2><a name="security">Driver security architecture</a></h2>
@ -167,7 +167,7 @@
parent directories parent directories
</p> </p>
<pre> <pre>
chmod o+x /path/to/directory chmod o+x /path/to/directory
</pre> </pre>
<p> <p>
In particular note that if using the "system" instance In particular note that if using the "system" instance
@ -383,12 +383,12 @@
The list of shared devices a guest is allowed access to is The list of shared devices a guest is allowed access to is
</p> </p>
<pre> <pre>
/dev/null, /dev/full, /dev/zero, /dev/null, /dev/full, /dev/zero,
/dev/random, /dev/urandom, /dev/random, /dev/urandom,
/dev/ptmx, /dev/kvm, /dev/kqemu, /dev/ptmx, /dev/kvm, /dev/kqemu,
/dev/rtc, /dev/hpet, /dev/net/tun /dev/rtc, /dev/hpet, /dev/net/tun
</pre> </pre>
<p> <p>
In the event of unanticipated needs arising, this can be customized In the event of unanticipated needs arising, this can be customized
@ -397,10 +397,10 @@
should be run as root, prior to starting libvirtd should be run as root, prior to starting libvirtd
</p> </p>
<pre> <pre>
mkdir /dev/cgroup mkdir /dev/cgroup
mount -t cgroup none /dev/cgroup -o devices mount -t cgroup none /dev/cgroup -o devices
</pre> </pre>
<p> <p>
libvirt will then place each virtual machine in a cgroup at libvirt will then place each virtual machine in a cgroup at
@ -430,6 +430,7 @@ LOGNAME=test /usr/bin/qemu -S -M pc -m 214 -smp 1 \
/dev/HostVG/QEMUGuest1 -net none -serial none \ /dev/HostVG/QEMUGuest1 -net none -serial none \
-parallel none -usb -parallel none -usb
EOF EOF
$ virsh domxml-from-native qemu-argv demo.args $ virsh domxml-from-native qemu-argv demo.args
&lt;domain type='qemu'&gt; &lt;domain type='qemu'&gt;
&lt;uuid&gt;00000000-0000-0000-0000-000000000000&lt;/uuid&gt; &lt;uuid&gt;00000000-0000-0000-0000-000000000000&lt;/uuid&gt;
@ -452,7 +453,7 @@ $ virsh domxml-from-native qemu-argv demo.args
&lt;/disk&gt; &lt;/disk&gt;
&lt;/devices&gt; &lt;/devices&gt;
&lt;/domain&gt; &lt;/domain&gt;
</pre> </pre>
<p>NB, don't include the literral \ in the args, put everything on one line</p> <p>NB, don't include the literral \ in the args, put everything on one line</p>
@ -488,6 +489,7 @@ $ virsh domxml-from-native qemu-argv demo.args
&lt;/devices&gt; &lt;/devices&gt;
&lt;/domain&gt; &lt;/domain&gt;
EOF EOF
$ virsh domxml-to-native qemu-argv demo.xml $ virsh domxml-to-native qemu-argv demo.xml
LC_ALL=C PATH=/usr/bin:/bin HOME=/home/test \ LC_ALL=C PATH=/usr/bin:/bin HOME=/home/test \
USER=test LOGNAME=test /usr/bin/qemu -S -M pc \ USER=test LOGNAME=test /usr/bin/qemu -S -M pc \
@ -495,7 +497,7 @@ $ virsh domxml-to-native qemu-argv demo.xml
-monitor pty -no-acpi -boot c -drive \ -monitor pty -no-acpi -boot c -drive \
file=/dev/HostVG/QEMUGuest1,if=ide,index=0 -net none \ file=/dev/HostVG/QEMUGuest1,if=ide,index=0 -net none \
-serial none -parallel none -usb -serial none -parallel none -usb
</pre> </pre>
<h2><a name="xmlconfig">Example domain XML config</a></h2> <h2><a name="xmlconfig">Example domain XML config</a></h2>

16
docs/drvtest.html.in
View File

@ -12,14 +12,14 @@
for the libvirt driver are: for the libvirt driver are:
</p> </p>
<pre> <pre>
test:///default (local access, default config) test:///default (local access, default config)
test:///path/to/driver/config.xml (local access, custom config) test:///path/to/driver/config.xml (local access, custom config)
test+unix:///default (local access, default config, via daemon) test+unix:///default (local access, default config, via daemon)
test://example.com/default (remote access, TLS/x509) test://example.com/default (remote access, TLS/x509)
test+tcp://example.com/default (remote access, SASl/Kerberos) test+tcp://example.com/default (remote access, SASl/Kerberos)
test+ssh://root@example.com/default (remote access, SSH tunnelled) test+ssh://root@example.com/default (remote access, SSH tunnelled)
</pre> </pre>
</body> </body>
</html> </html>

22
docs/drvuml.html.in
View File

@ -24,16 +24,16 @@
URIs are URIs are
</p> </p>
<pre> <pre>
uml:///session (local access to per-user instance) uml:///session (local access to per-user instance)
uml+unix:///session (local access to per-user instance) uml+unix:///session (local access to per-user instance)
uml:///system (local access to system instance) uml:///system (local access to system instance)
uml+unix:///system (local access to system instance) uml+unix:///system (local access to system instance)
uml://example.com/system (remote access, TLS/x509) uml://example.com/system (remote access, TLS/x509)
uml+tcp://example.com/system (remote access, SASl/Kerberos) uml+tcp://example.com/system (remote access, SASl/Kerberos)
uml+ssh://root@example.com/system (remote access, SSH tunnelled) uml+ssh://root@example.com/system (remote access, SSH tunnelled)
</pre> </pre>
<h2>Example XML configuration</h2> <h2>Example XML configuration</h2>
@ -58,7 +58,7 @@
thus accessible with "virsh console" or equivalent tools thus accessible with "virsh console" or equivalent tools
</p> </p>
<pre> <pre>
&lt;domain type='uml'&gt; &lt;domain type='uml'&gt;
&lt;name&gt;demo&lt;/name&gt; &lt;name&gt;demo&lt;/name&gt;
&lt;uuid&gt;b4433fc2-a22e-ffb3-0a3d-9c173b395800&lt;/uuid&gt; &lt;uuid&gt;b4433fc2-a22e-ffb3-0a3d-9c173b395800&lt;/uuid&gt;
@ -77,6 +77,6 @@
&lt;console type='pty'/&gt; &lt;console type='pty'/&gt;
&lt;/devices&gt; &lt;/devices&gt;
&lt;/domain&gt; &lt;/domain&gt;
</pre> </pre>
</body> </body>
</html> </html>

22
docs/drvvbox.html.in
View File

@ -13,17 +13,17 @@
The uri of the driver protocol is "vbox". Some example connection URIs for the driver are: The uri of the driver protocol is "vbox". Some example connection URIs for the driver are:
</p> </p>
<pre> <pre>
vbox:///session (local access to per-user instance) vbox:///session (local access to per-user instance)
vbox+unix:///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+tcp://user@example.com/session (remote access, SASl/Kerberos)
vbox+ssh://user@example.com/session (remote access, SSH tunnelled) vbox+ssh://user@example.com/session (remote access, SSH tunnelled)
</pre> </pre>
<h2><a name="xmlconfig">Example domain XML config</a></h2> <h2><a name="xmlconfig">Example domain XML config</a></h2>
<pre> <pre>
&lt;domain type='vbox'&gt; &lt;domain type='vbox'&gt;
&lt;name&gt;vbox&lt;/name&gt; &lt;name&gt;vbox&lt;/name&gt;
&lt;uuid&gt;4dab22b31d52d8f32516782e98ab3fa0&lt;/uuid&gt; &lt;uuid&gt;4dab22b31d52d8f32516782e98ab3fa0&lt;/uuid&gt;
@ -109,11 +109,9 @@
&lt;product id='0xfeeb'/&gt; &lt;product id='0xfeeb'/&gt;
&lt;/source&gt; &lt;/source&gt;
&lt;/hostdev&gt; &lt;/hostdev&gt;
&lt;/devices&gt; &lt;/devices&gt;
&lt;/domain&gt;
&lt;/domain&gt; </pre>
</pre>
</body> </body>
</html> </html>

22
docs/drvxen.html.in
View File

@ -54,13 +54,13 @@
the libvirt driver are: the libvirt driver are:
</p> </p>
<pre> <pre>
xen:/// (local access, direct) xen:/// (local access, direct)
xen+unix:/// (local access, via daemon) xen+unix:/// (local access, via daemon)
xen://example.com/ (remote access, TLS/x509) xen://example.com/ (remote access, TLS/x509)
xen+tcp://example.com/ (remote access, SASl/Kerberos) xen+tcp://example.com/ (remote access, SASl/Kerberos)
xen+ssh://root@example.com/ (remote access, SSH tunnelled) xen+ssh://root@example.com/ (remote access, SSH tunnelled)
</pre> </pre>
<h2><a name="imex">Import and export of libvirt domain XML configs</a></h2> <h2><a name="imex">Import and export of libvirt domain XML configs</a></h2>
@ -114,8 +114,7 @@
&lt;input type='mouse' bus='xen'/&gt; &lt;input type='mouse' bus='xen'/&gt;
&lt;graphics type='vnc' port='-1' autoport='yes' listen='0.0.0.0'/&gt; &lt;graphics type='vnc' port='-1' autoport='yes' listen='0.0.0.0'/&gt;
&lt;/devices&gt; &lt;/devices&gt;
&lt;/domain&gt; &lt;/domain&gt;</pre>
</pre>
<h3><a name="xmlexport">Converting from domain XML to XM config files</a></h3> <h3><a name="xmlexport">Converting from domain XML to XM config files</a></h3>
@ -125,7 +124,7 @@
format. format.
</p> </p>
<pre># virsh -c xen:/// domxml-to-native xen-xm rhel5pv.xml <pre>$ virsh -c xen:/// domxml-to-native xen-xm rhel5pv.xml
name = "rhel5pv" name = "rhel5pv"
uuid = "8f07fe28-753f-2729-d76d-bdbd892f949a" uuid = "8f07fe28-753f-2729-d76d-bdbd892f949a"
maxmem = 2500 maxmem = 2500
@ -143,8 +142,7 @@ vnc = 1
vncunused = 1 vncunused = 1
vnclisten = "0.0.0.0" vnclisten = "0.0.0.0"
disk = [ "tap:aio:/var/lib/xen/images/rhel5pv.img,xvda,w", "tap:qcow:/root/qcow1-xen.img,xvdd,w" ] disk = [ "tap:aio:/var/lib/xen/images/rhel5pv.img,xvda,w", "tap:qcow:/root/qcow1-xen.img,xvdd,w" ]
vif = [ "mac=00:16:3e:60:36:ba,bridge=virbr0,script=vif-bridge,vifname=vif5.0" ] vif = [ "mac=00:16:3e:60:36:ba,bridge=virbr0,script=vif-bridge,vifname=vif5.0" ]</pre>
</pre>
<h2><a name="xmlconfig">Example domain XML config</a></h2> <h2><a name="xmlconfig">Example domain XML config</a></h2>

3
docs/formatdomain.html.in
View File

@ -750,8 +750,7 @@ qemu-kvm -net nic,model=? /dev/null
&lt;video type='vga' nvram='8192' heads='1'&gt; &lt;video type='vga' nvram='8192' heads='1'&gt;
&lt;acceleration accel3d='yes' accel3d='yes' /&gt; &lt;acceleration accel3d='yes' accel3d='yes' /&gt;
&lt;/video&gt; &lt;/video&gt;
... ...</pre>
</pre>
<dl> <dl>
<dt><code>video</code></dt> <dt><code>video</code></dt>

18
docs/storage.html.in
View File

@ -45,8 +45,7 @@ libvirt.
&lt;target&gt; &lt;target&gt;
&lt;path&gt;/var/lib/virt/images&lt;/path&gt; &lt;path&gt;/var/lib/virt/images&lt;/path&gt;
&lt;/target&gt; &lt;/target&gt;
&lt;/pool&gt; &lt;/pool&gt;</pre>
</pre>
<h3>Valid pool format types</h3> <h3>Valid pool format types</h3>
<p> <p>
@ -101,8 +100,7 @@ libvirt.
&lt;target&gt; &lt;target&gt;
&lt;path&gt;/var/lib/virt/images&lt;/path&gt; &lt;path&gt;/var/lib/virt/images&lt;/path&gt;
&lt;/target&gt; &lt;/target&gt;
&lt;/pool&gt; &lt;/pool&gt;</pre>
</pre>
<h3>Valid pool format types</h3> <h3>Valid pool format types</h3>
<p> <p>
@ -172,8 +170,7 @@ libvirt.
&lt;target&gt; &lt;target&gt;
&lt;path&gt;/var/lib/virt/images&lt;/path&gt; &lt;path&gt;/var/lib/virt/images&lt;/path&gt;
&lt;/target&gt; &lt;/target&gt;
&lt;/pool&gt; &lt;/pool&gt;</pre>
</pre>
<h3>Valid pool format types</h3> <h3>Valid pool format types</h3>
<p> <p>
@ -215,8 +212,7 @@ libvirt.
&lt;target&gt; &lt;target&gt;
&lt;path&gt;/dev/HostVG&lt;/path&gt; &lt;path&gt;/dev/HostVG&lt;/path&gt;
&lt;/target&gt; &lt;/target&gt;
&lt;/pool&gt; &lt;/pool&gt;</pre>
</pre>
<h3>Valid pool format types</h3> <h3>Valid pool format types</h3>
<p> <p>
@ -248,8 +244,7 @@ libvirt.
&lt;target&gt; &lt;target&gt;
&lt;path&gt;/dev&lt;/path&gt; &lt;path&gt;/dev&lt;/path&gt;
&lt;/target&gt; &lt;/target&gt;
&lt;/pool&gt; &lt;/pool&gt;</pre>
</pre>
<h3>Valid pool format types</h3> <h3>Valid pool format types</h3>
<p> <p>
@ -338,8 +333,7 @@ libvirt.
&lt;target&gt; &lt;target&gt;
&lt;path&gt;/dev/disk/by-path&lt;/path&gt; &lt;path&gt;/dev/disk/by-path&lt;/path&gt;
&lt;/target&gt; &lt;/target&gt;
&lt;/pool&gt; &lt;/pool&gt;</pre>
</pre>
<h3>Valid pool format types</h3> <h3>Valid pool format types</h3>
<p> <p>