diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index 50c11c3949..7d2ba8a09d 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -2043,9 +2043,14 @@ qemu-kvm -net nic,model=? /dev/null ... <devices> <graphics type='sdl' display=':0.0'/> - <graphics type='vnc' port='5904'/> + <graphics type='vnc' port='5904'> + <listen type='address' address='1.2.3.4'/> + </graphics> <graphics type='rdp' autoport='yes' multiUser='yes' /> <graphics type='desktop' fullscreen='yes'/> + <graphics type='spice'> + <listen type='network' network='rednet'/> + </graphics> </devices> ... @@ -2191,6 +2196,54 @@ qemu-kvm -net nic,model=? /dev/null +
+ Rather than putting the address information used to set up the
+ listening socket for graphics types vnc
+ and spice
in
+ the <graphics>
listen
attribute,
+ a separate subelement of <graphics>
,
+ called <listen>
can be specified (see the
+ examples above)since
+ 0.9.4. <listen>
accepts the following
+ attributes:
+
type
address
+ or network
. This tells whether this listen
+ element is specifying the address to be used directly, or by
+ naming a network (which will then be used to determine an
+ appropriate address for listening).
+ address
type='address'
, the address
+ attribute will contain either an IP address or hostname (which
+ will be resolved to an IP address via a DNS query) to listen
+ on. In the "live" XML of a running domain, this attribute will
+ be set to the IP address used for listening, even
+ if type='network'
.
+ network
type='network'
, the network
+ attribute will contain the name of a network in libvirt's list
+ of configured networks. The named network configuration will
+ be examined to determine an appropriate listen address. For
+ example, if the network has an IPv4 address in its
+ configuration (e.g. if it has a forward type
+ of route
, nat
, or no forward type
+ (isolated)), the first IPv4 address listed in the network's
+ configuration will be used. If the network is describing a
+ host bridge, the first IPv4 address associated with that
+ bridge device will be used, and if the network is describing
+ one of the 'direct' (macvtap) modes, the first IPv4 address of
+ the first forward dev will be used.
+
A video device.
diff --git a/docs/schemas/domain.rng b/docs/schemas/domain.rng
index aa4ce69419..6ccbeed271 100644
--- a/docs/schemas/domain.rng
+++ b/docs/schemas/domain.rng
@@ -1289,6 +1289,7 @@
+