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
+
Set to either 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
+
if 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
+
if 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. +
+
+

Video devices

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 @@ + @@ -1342,6 +1343,7 @@ + @@ -1478,6 +1480,7 @@ + @@ -1500,6 +1503,36 @@ + + + + + + + + address + + + + + + + + network + + + + + + + + + + + + + +