[Qemu-devel] [PATCH] qemu-options: add documentation for using UDP unicast network backend.

[Victor Kaplansky]

For a long time QEMU has had support for UDP unicast network
backend, but manual was missing description and usage examples.

This patch adds some more documentation and an example.

Signed-off-by: Victor Kaplansky <address@hidden>
---
 qemu-options.hx | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/qemu-options.hx b/qemu-options.hx
index 2485b94..342bb14 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -1855,6 +1855,8 @@ qemu-system-i386 linux.img \
                  -net socket,connect=127.0.0.1:1234
 @end example
 
+
+
 @item -netdev 
socket,address@hidden,address@hidden,address@hidden:@var{port}[,address@hidden
 @itemx -net 
socket[,address@hidden,address@hidden,address@hidden,address@hidden:@var{port}[,address@hidden
 
@@ -1907,6 +1909,27 @@ qemu-system-i386 linux.img \
                  -net socket,mcast=239.192.168.1:1102,localaddr=1.2.3.4
 @end example
 
address@hidden -netdev 
socket,address@hidden,address@hidden,address@hidden:@var{rport}[,address@hidden:@var{lport}]]
address@hidden -net 
socket[,address@hidden,address@hidden,address@hidden,address@hidden:@var{rport}[,address@hidden:@var{lport}]]
+
+Connect a VLAN @var{n} to a remote VLAN in another QEMU virtual
+machine using a UDP tunnel. Use lport as local port and rport as
+remote port of the tunnel. The two QEMU can be running on
+different hosts. Use @option{fd=h} to specify an already opened
+UDP socket.
+
+Example:
address@hidden
+# launch one QEMU instance
+qemu-system-i386 linux.img \
+                 -device virtio-net-pci,netdev=net0 \
+                 -netdev 
socket,id=net0,udp=127.0.0.1:4444,localaddr=127.0.0.1:5555
+# launch second QEMU instance sharing the network with the first one
+qemu-system-i386 linux.img \
+                 -device virtio-net-pci,netdev=net0 \
+                 -netdev 
socket,id=net0,udp=127.0.0.1:5555,localaddr=127.0.0.1:4444
address@hidden example
+
 @item -netdev 
l2tpv3,address@hidden,address@hidden,address@hidden,address@hidden,address@hidden,address@hidden,address@hidden,ipv6][,udp][,cookie64][,counter][,pincounter][,address@hidden,address@hidden,address@hidden
 @itemx -net 
l2tpv3[,address@hidden,address@hidden,address@hidden,address@hidden,address@hidden,address@hidden,address@hidden,address@hidden,ipv6][,udp][,cookie64][,counter][,pincounter][,address@hidden,address@hidden,address@hidden
 Connect VLAN @var{n} to L2TPv3 pseudowire. L2TPv3 (RFC3391) is a popular
-- 
--Victor