Signed-off-by: MORITA Kazutaka <[email protected]>
---
docs/formatdomain.html.in | 49 ++++++++++++++++++++++++++++++++++++++++++--
1 files changed, 46 insertions(+), 3 deletions(-)
diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index cfd3451..86c2d0d 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -628,23 +628,39 @@
...
</serial>
</disk>
+ ...
+ <disk type='network'>
+ <driver name="qemu" type="raw"/>
+ <source protocol="sheepdog" name="image_name">
+ <host name="hostname" port="7000">
+ </source>
+ <target dev="hdb" bus="ide"/>
+ </disk>
</devices>
...</pre>
<dl>
<dt><code>disk</code></dt>
<dd>The <code>disk</code> element is the main container for describing
- disks. The <code>type</code> attribute is either "file" or "block"
+ disks. The <code>type</code> attribute is either "file", "block",
"dir", or "network"
and refers to the underlying source for the disk. The optional
<code>device</code> attribute indicates how the disk is to be exposed
to the guest OS. Possible values for this attribute are "floppy",
"disk"
and "cdrom", defaulting to "disk".
- <span class="since">Since 0.0.3; "device" attribute since
0.1.4</span></dd>
+ <span class="since">Since 0.0.3; "device" attribute since 0.1.4;
+ "network" attribute value since after 0.8.6 (QEMU and KVM
only)</span></dd>
<dt><code>source</code></dt>
<dd>If the disk <code>type</code> is "file", then the <code>file</code>
attribute
specifies the fully-qualified path to the file holding the disk. If
the disk
<code>type</code> is "block", then the <code>dev</code> attribute
specifies
- the path to the host device to serve as the disk. <span
class="since">Since 0.0.3</span></dd>
+ the path to the host device to serve as the disk. If the disk
<code>type</code>
+ is "network", then the <code>protocol</code> attribute specifies the
protocol
+ to access to the requested image; possible values are "nbd", "rbd",
and "sheepdog".
+ If the <code>protocol</code> attribute is "rbd" or "sheepdog", an
additional
+ attribute <code>name</code> is mandatory to specify which image to be
used.
+ When the disk <code>type</code> is "network", the <code>source</code>
may have
+ zero or more <code>host</code> sub-elements used to specify the hosts
to connect.
+ <span class="since">Since 0.0.3</span></dd>
<dt><code>target</code></dt>
<dd>The <code>target</code> element controls the bus / device under
which the
disk is exposed to the guest OS. The <code>dev</code> attribute
indicates
@@ -680,6 +696,33 @@
For example, it may look as
<code><serial>WD-WMAP9A966149</serial></code>.
<span class="since">Since 0.7.1</span>
</dd>
+ <dt><code>host</code></dt>
+ <dd>The <code>host</code> element has two attributes "name" and "port",
+ which specify the hostname and the port number. The meaning of this
+ element and the number of the elements depend on the protocol
attribute.
+ <table class="top_table">
+ <tr>
+ <th> Protocol </th>
+ <th> Meaning </th>
+ <th> Number of hosts </th>
+ </tr>
+ <tr>
+ <td> nbd </td>
+ <td> a server running nbd-server </td>
+ <td> only one </td>
+ </tr>
+ <tr>
+ <td> rbd </td>
+ <td> monitor servers of RBD </td>
+ <td> one or more </td>
+ </tr>
+ <tr>
+ <td> sheepdog </td>
+ <td> one of the sheepdog servers (default is localhost:7000) </td>
+ <td> zero or one </td>
+ </tr>
+ </table>
+ </dd>
</dl>
<h4><a name="elementsUSB">USB and PCI devices</a></h4>
--
1.7.1
--
libvir-list mailing list
[email protected]
https://www.redhat.com/mailman/listinfo/libvir-list
