qemu-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Qemu-devel] [PATCH for-2.4 5/5] Documentation: Document IRC char driver


From: Max Reitz
Subject: [Qemu-devel] [PATCH for-2.4 5/5] Documentation: Document IRC char driver
Date: Wed, 1 Apr 2015 14:09:17 +0200

With the IRC char driver being fully functional, it now needs to be
exposed to the broad audience. Adding documentation has been proven a
valuable step in this process.

Regarding the next steps, mouth-to-mouth propaganda will probably
suffice, considering that IRC is objectively the single best character
device qemu has to offer.

Signed-off-by: Max Reitz <address@hidden>
---
 qemu-options.hx | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/qemu-options.hx b/qemu-options.hx
index 319d971..e6e0cb2 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -2799,6 +2799,34 @@ or fake device.
 
 @item msmouse
 Three button serial mouse. Configure the guest to use Microsoft protocol.
+
address@hidden 
irc[,address@hidden,address@hidden,address@hidden,address@hidden,address@hidden,address@hidden,address@hidden
+Connects to the specified @var{hostname} on the given @var{port} (defaults to
+6667), using the given @var{nick}.  Alternatively, a socket file descriptor may
+be specified as @var{socket_fd}.  Once connected, the channel @var{channel} is
+joined.  A nick may be specify instead of a channel, in which case all
+communication is done through a query.
+
+TLS is enabled or disabled through the @var{ssl} option.  It is disabled by
+default.
+
+All messages are encrypted and decrypted with the selected @var{cipher}.  Valid
+options are:
address@hidden @option
address@hidden none
+No encryption
address@hidden weak
+ROT13
address@hidden strong
+Triple ROT13
address@hidden table
+
+Messages to QEMU must be prefixed with @var{nick} if communicating through a
+channel; when queried, no prefix must be used.  This prefix has to be encrypted
+if encryption is used.
+
+All output is emitted to @var{channel}.  There is no limitation for input
+sources, so anyone may query the QEMU instance and submit data.
 @end table
 ETEXI
 
-- 
2.3.4




reply via email to

[Prev in Thread] Current Thread [Next in Thread]