repo: ngircd
action: commit
revision: 
path_from: 
revision_from: 07f241ff6d3afee88d6c6b3e2ed1e195c0367c91:
path_to: 
revision_to: 

commit 07f241ff6d3afee88d6c6b3e2ed1e195c0367c91
Author: Alexander Barton 
Date:   Wed Dec 29 14:10:18 2010 +0100

    Enhance documentation for the WEBIRC command

diff --git a/doc/Protocol.txt b/doc/Protocol.txt

--- a/doc/Protocol.txt
+++ b/doc/Protocol.txt
@@ -161,3 +161,17 @@ and therefore can't be omitted. The parameter  must be ignored when
 a channel has no user limit (the parameter  doesn't list the "l"
 channel mode). In this case  should be "0".

+
+II.4 Update webchat/proxy client information
+
+     Command: WEBIRC
+  Parameters:    
+     Used by: unregistered clients only
+
+The WEBIRC command is used by some Web-to-IRC gateways to set the correct
+user name and host name of users instead of their own. It must be the very
+first command sent to the server, even before USER and NICK commands!
+
+The  must be set in the server configuration file to prevent
+unauthorized clients to fake their identity; it is an arbitrary string.
+
diff --git a/src/ngircd/irc-login.c b/src/ngircd/irc-login.c

--- a/src/ngircd/irc-login.c
+++ b/src/ngircd/irc-login.c
@@ -596,8 +596,14 @@ IRC_SERVICE(CLIENT *Client, REQUEST *Req)


 /**
- * Handler for the IRC command "WEBIRC".
- * Syntax: WEBIRC    
+ * Handler for the IRC "WEBIRC" command.
+ *
+ * See doc/Protocol.txt, section II.4:
+ * "Update webchat/proxy client information".
+ *
+ * @param Client	The client from which this command has been received.
+ * @param Req		Request structure with prefix and all parameters.
+ * @returns		CONNECTED or DISCONNECTED.
  */
 GLOBAL bool
 IRC_WEBIRC(CLIENT *Client, REQUEST *Req)

-----END OF PAGE-----