diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index cfd3451800093ea9108414a8ed8587b1cdd63c1d..e9fcea162bf789409a310b4767690e67a43c5aa8 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -628,23 +628,45 @@ ... </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> ...
disk
disk
element is the main container for describing
- disks. The type
attribute is either "file" or "block"
+ disks. The type
attribute is either "file",
+ "block", "dir", or "network"
and refers to the underlying source for the disk. The optional
device
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".
- Since 0.0.3; "device" attribute since 0.1.4source
type
is "file", then the file
attribute
- specifies the fully-qualified path to the file holding the disk. If the disk
- type
is "block", then the dev
attribute specifies
- the path to the host device to serve as the disk. Since 0.0.3type
is "file", then the
+ the file
attribute specifies the fully-qualified
+ path to the file holding the disk. If the disk
+ type
is "block", then the dev
+ attribute specifies the path to the host device to serve as
+ the disk. If the disk type
is "network", then
+ the protocol
attribute specifies the protocol to
+ access to the requested image; possible values are "nbd",
+ "rbd", and "sheepdog". If the protocol
attribute
+ is "rbd" or "sheepdog", an additional
+ attribute name
is mandatory to specify which
+ image to be used. When the disk type
is
+ "network", the source
may have zero or
+ more host
sub-elements used to specify the hosts
+ to connect.
+ Since 0.0.3target
target
element controls the bus / device under which the
disk is exposed to the guest OS. The dev
attribute indicates
@@ -680,6 +702,33 @@
For example, it may look as <serial>WD-WMAP9A966149</serial>
.
Since 0.7.1
host
host
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.
+ Protocol | +Meaning | +Number of hosts | +
---|---|---|
nbd | +a server running nbd-server | +only one | +
rbd | +monitor servers of RBD | +one or more | +
sheepdog | +one of the sheepdog servers (default is localhost:7000) | +zero or one | +