Added:

OnMeshToken
MeshSendAll(std::string text);
MeshSendCommon(userrec* user, std::string text);
MeshSendAllAlive(std::string text);
MeshSendUnicast(std::string destination, std::string text);
MeshSendAllExcept(std::string target, std::string text);
MeshCheckChan(chanrec *c,std::string servername);
MeshCheckCommon(userrec* u,std::string servername);


git-svn-id: http://svn.inspircd.org/repository/trunk/inspircd@1112 e03df62e-2008-0410-955e-edbf42e46eb7

2 files changed, 55 insertions, 2 deletions

diff --git a/include/inspircd.h b/include/inspircd.h
index 88b9eb22f..220379d57 100644
--- a/include/inspircd.h
+++ b/include/inspircd.h
@@ -170,8 +170,8 @@ void NetSendToAllAlive(char* s);
 void NetSendToOne(char* target,char* s);
 void NetSendToAllExcept(const char* target,char* s);
 void NetSendMyRoutingTable();
+bool ChanAnyOnThisServer(chanrec *c,char* servername);
+bool CommonOnThisServer(userrec* u,const char* servername);
 void DoSplit(const char* params);
 void RemoveServer(const char* name);
 void DoSync(serverrec* serv, char* tcp_host);
-
-
diff --git a/include/modules.h b/include/modules.h
index 68c74eacb..fa62c00df 100644
--- a/include/modules.h
+++ b/include/modules.h
@@ -482,6 +482,18 @@ class Module : public classbase
 	 * Return 1 to deny the topic change, or 0 to allow it.
 	 */
 	virtual int OnLocalTopicChange(userrec* user, chanrec* chan, std::string topic);
+
+	/** Called whenever an unknown token is received in a server to server link.
+	 * The token value is the unknown token -- please check that no other modules are using the token
+	 * that you use. Returning 1 supresses the 'unknown token type' error which is usually sent to
+	 * all opers with +s. The params list is a list of parameters, and if any parameters start with a
+	 * colon (:) it is treated as the whole of the last parameter, identical to how RFC messages are
+	 * handled. source is the sender of the message, and reply is what should be replied to for a unicast
+	 * message. Note that there are not many messages in the mesh protocol which require unicast
+	 * messaging. tcp_host is the server name as a string, ipaddr is its ip address in dotted decimal
+	 * notation and port is the port number it is using.
+	 */
+	virtual int OnMeshToken(char token,string_list params,serverrec* source,serverrec* reply, std::string tcp_host,std::string ipaddr,int port);
 };
 
 
@@ -875,13 +887,54 @@ class Server : public classbase
 	/** Returns true if a nick!ident@host string is correctly formatted, false if otherwise.
 	 */
 	virtual bool IsValidMask(std::string mask);
+
+	/** Sends a line of text to all connected servers.
+	 * If a server is not directly reachable, the core deals with routing the message, and will also
+	 * deal with failures transparently.
+	 */
+	virtual void MeshSendAll(std::string text);
+
+	/** This method sends a line of text to all servers who have users which share common channels with the user you provide.
+	 * For example, if user A is on server A, and they are on channels #one and #two, and user B is on server B, and also on
+	 * channel #one, but user C is on server C and on neither #one or #two, this function will cause the text to only be
+	 * sent to server B. However, if server B is only reachable via C, it will route it to C (you do not have to worry about
+	 * this routing, it is done transparently, but its good to know how things work!)
+	 */
+	virtual void MeshSendCommon(userrec* user, std::string text);
+
+	/** This function is equivalent to Server::MeshSendToAll except it will only route to servers which are directly routable.
+	 */
+	virtual void MeshSendAllAlive(std::string text);
+
+	/** This function sends a line of text directly to a server.
+	 * If the server is not directly routable at this time, the server attempts to route text through the mesh.
+	 */
+	virtual void MeshSendUnicast(std::string destination, std::string text);
+
+	/** This function sends to all servers EXCEPT the one you specify.
+	 * You should usually use this function to send messages, specifying the SENDER of your message as 'target'.
+	 * This will prevent message loops.
+	 */
+	virtual void MeshSendAllExcept(std::string target, std::string text);
+
+	/** This function is used to check if any users on channel c are on server servername.
+	 * This is used internally by PRIVMSG etc. You should not need to use it.
+	 */
+	virtual bool MeshCheckChan(chanrec *c,std::string servername);
+
+	/** This function is used to check if user u has any channels in common with users on servername.
+	 * This is used internally by Server::MeshSendCommon. You should very rarely need to use it.
+	 */
+	virtual bool MeshCheckCommon(userrec* u,std::string servername);
 };
 
+
 #define CONF_NOT_A_NUMBER	0x000010
 #define CONF_NOT_UNSIGNED	0x000080
 #define CONF_VALUE_NOT_FOUND	0x000100
 #define CONF_FILE_NOT_FOUND	0x000200
 
+
 /** Allows reading of values from configuration files
  * This class allows a module to read from either the main configuration file (inspircd.conf) or from
  * a module-specified configuration file. It may either be instantiated with one parameter or none.