]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - src/modules/m_spanningtree/treeserver.h
Revert automated conversion by Special, as it (unfortunately) neglects some details...
[user/henk/code/inspircd.git] / src / modules / m_spanningtree / treeserver.h
index 716369f5be822364c86131a0dc918dbe937b1f0c..874f78750e50279e221fb7d52b7447ab7c271444 100644 (file)
@@ -1,3 +1,16 @@
+/*       +------------------------------------+
+ *       | Inspire Internet Relay Chat Daemon |
+ *       +------------------------------------+
+ *
+ *  InspIRCd: (C) 2002-2008 InspIRCd Development Team
+ * See: http://www.inspircd.org/wiki/index.php/Credits
+ *
+ * This program is free but copyrighted software; see
+ *            the file COPYING for details.
+ *
+ * ---------------------------------------------------
+ */
+
 #ifndef __TREESERVER_H__
 #define __TREESERVER_H__
 
@@ -24,31 +37,42 @@ class TreeServer : public classbase
        irc::string ServerName;                 /* Server's name */
        std::string ServerDesc;                 /* Server's description */
        std::string VersionString;              /* Version string or empty string */
-       int UserCount;                          /* Not used in this version */
-       int OperCount;                          /* Not used in this version */
+       unsigned int ServerUserCount;           /* How many users are on this server? [note: doesn't care about +i] */
+       unsigned int ServerOperCount;           /* How many opers are on this server? */
        TreeSocket* Socket;                     /* For directly connected servers this points at the socket object */
        time_t NextPing;                        /* After this time, the server should be PINGed*/
        bool LastPingWasGood;                   /* True if the server responded to the last PING with a PONG */
        SpanningTreeUtilities* Utils;           /* Utility class */
+       std::string sid;                        /* Server ID */
+       bool DupError;                          /* True if the server ID is duplicated (!) */
+
+       /** Set server ID
+        * @param id Server ID
+        * @throws CoreException on duplicate ID
+        */
+       void SetID(const std::string &id);
 
  public:
 
+       bool Warned;                            /* True if we've warned opers about high latency on this server */
+       bool bursting;                          /* whether or not this server is bursting */
+       
        /** We don't use this constructor. Its a dummy, and won't cause any insertion
         * of the TreeServer into the hash_map. See below for the two we DO use.
         */
-       TreeServer(SpanningTreeUtilities* Util, InspIRCd* Instance);
+       TreeServer(SpanningTreeUtilities* Util, InspIRCd* Instance, const std::string &id);
 
        /** We use this constructor only to create the 'root' item, Utils->TreeRoot, which
         * represents our own server. Therefore, it has no route, no parent, and
         * no socket associated with it. Its version string is our own local version.
         */
-       TreeServer(SpanningTreeUtilities* Util, InspIRCd* Instance, std::string Name, std::string Desc);
+       TreeServer(SpanningTreeUtilities* Util, InspIRCd* Instance, std::string Name, std::string Desc, const std::string &id);
        
        /** When we create a new server, we call this constructor to initialize it.
         * This constructor initializes the server's Route and Parent, and sets up
         * its ping counters so that it will be pinged one minute from now.
         */
-       TreeServer(SpanningTreeUtilities* Util, InspIRCd* Instance, std::string Name, std::string Desc, TreeServer* Above, TreeSocket* Sock);
+       TreeServer(SpanningTreeUtilities* Util, InspIRCd* Instance, std::string Name, std::string Desc, const std::string &id, TreeServer* Above, TreeSocket* Sock, bool Hide);
 
        int QuitUsers(const std::string &reason);
 
@@ -64,27 +88,100 @@ class TreeServer : public classbase
         */
        void DelHashEntry();
 
-       /** These accessors etc should be pretty self-
-        * explanitory.
+       /** Get route.
+        * The 'route' is defined as the locally-
+        * connected server which can be used to reach this server.
         */
        TreeServer* GetRoute();
+
+       /** Get server name
+        */
        std::string GetName();
+
+       /** Get server description (GECOS)
+        */
        std::string GetDesc();
+
+       /** Get server version string
+        */
        std::string GetVersion();
+
+       /** Set time we are next due to ping this server
+        */
        void SetNextPingTime(time_t t);
+
+       /** Get the time we are next due to ping this server
+        */
        time_t NextPingTime();
+
+       /** Last ping time in microseconds, used to calculate round trip time
+        */
+       unsigned long LastPingMsec;
+
+       /** Round trip time of last ping
+        */
+       unsigned long rtt;
+       
+       /** When we recieved BURST from this server, used to calculate total burst time at ENDBURST.
+        */
+       unsigned long StartBurst;
+
+       /** True if this server is hidden
+        */
+       bool Hidden;
+
+       /** True if the server answered their last ping
+        */
        bool AnsweredLastPing();
+
+       /** Set the server as responding to its last ping
+        */
        void SetPingFlag();
-       int GetUserCount();
-       void AddUserCount();
-       void DelUserCount();
-       int GetOperCount();
+
+       /** Get the number of users on this server.
+        */
+       unsigned int GetUserCount();
+
+       /** Increment or decrement the user count by diff.
+        */
+       void SetUserCount(int diff);
+
+       /** Gets the numbers of opers on this server.
+        */
+       unsigned int GetOperCount();
+
+       /** Increment or decrement the oper count by diff.
+        */
+       void SetOperCount(int diff);
+
+       /** Get the TreeSocket pointer for local servers.
+        * For remote servers, this returns NULL.
+        */
        TreeSocket* GetSocket();
+
+       /** Get the parent server.
+        * For the root node, this returns NULL.
+        */
        TreeServer* GetParent();
+
+       /** Set the server version string
+        */
        void SetVersion(const std::string &Version);
+
+       /** Return number of child servers
+        */
        unsigned int ChildCount();
+
+       /** Return a child server indexed 0..n
+        */
        TreeServer* GetChild(unsigned int n);
+
+       /** Add a child server
+        */
        void AddChild(TreeServer* Child);
+
+       /** Delete a child server, return false if it didn't exist.
+        */
        bool DelChild(TreeServer* Child);
 
        /** Removes child nodes of this node, and of that node, etc etc.
@@ -93,6 +190,20 @@ class TreeServer : public classbase
         */
        bool Tidy();
 
+       /** Get server ID
+        */
+       std::string& GetID();
+
+       /** True on duplicate server ID (server not usable)
+        */
+       bool DuplicateID();
+
+       /** Marks a server as having finished bursting and performs appropriate actions.
+        */
+       void FinishBurst();
+
+       /** Destructor
+        */
        ~TreeServer();
 
 };