From 2348cf20e71b292b7c93ea756ee6799f65ab151f Mon Sep 17 00:00:00 2001
From: =?utf8?q?Guido=20G=C3=BCnther?= <agx@sigxcpu.org>
Date: Fri, 24 Jul 2009 22:16:51 +0200
Subject: [PATCH] document tcp listen and raw wire option

---
 docs/formatdomain.html.in | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index 191b03e541..eb1278413d 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -858,13 +858,45 @@ qemu-kvm -net nic,model=? /dev/null
 
     <p>
       The character device acts as a TCP client connecting to a
-      remote server, or as a server waiting for a client connection.
+      remote server.
     </p>
 
     <pre>
       ...
       &lt;serial type="tcp"&gt;
         &lt;source mode="connect" host="0.0.0.0" service="2445"/&gt;
+        &lt;protocol type="raw"/&gt;
+        &lt;target port="1"/&gt;
+      &lt;/serial&gt;
+      ...</pre>
+
+    <p>
+      Or as a TCP server waiting for a client connection.
+    </p>
+
+    <pre>
+      ...
+      &lt;serial type="tcp"&gt;
+        &lt;source mode="bind" host="127.0.0.1" service="2445"/&gt;
+        &lt;protocol type="raw"/&gt;
+        &lt;target port="1"/&gt;
+      &lt;/serial&gt;
+      ...</pre>
+
+    <p>
+      Alternatively you can use telnet instead of raw TCP.
+    <p>
+
+    <pre>
+      ...
+      &lt;serial type="tcp"&gt;
+        &lt;source mode="connect" host="0.0.0.0" service="2445"/&gt;
+        &lt;protocol type="telnet"/&gt;
+        &lt;target port="1"/&gt;
+      &lt;/serial&gt;
+      ...
+      &lt;serial type="tcp"&gt;
+        &lt;source mode="bind" host="127.0.0.1" service="2445"/&gt;
         &lt;protocol type="telnet"/&gt;
         &lt;target port="1"/&gt;
       &lt;/serial&gt;
-- 
2.47.2