CPU Usage percent in stats z! yay!

[user/henk/code/inspircd.git] / include / dns.h

diff --git a/include/dns.h b/include/dns.h
index b011a9ddbd7762bb384cc6fe4ba5745bfd1fde79..3295e29e370081a8b794cb7399da809395f41323 100644 (file)
--- a/include/dns.h
+++ b/include/dns.h
@@ -48,6 +48,7 @@ using irc::sockets::insp_sockaddr;
 using irc::sockets::insp_inaddr;
 
 class InspIRCd;
+class Module;
 
 /**
  * Result status, used internally
@@ -69,7 +70,8 @@ enum ResolverError
        RESOLVER_NXDOMAIN       =       2,
        RESOLVER_NOTREADY       =       3,
        RESOLVER_BADIP          =       4,
-       RESOLVER_TIMEOUT        =       5
+       RESOLVER_TIMEOUT        =       5,
+       RESLOVER_FORCEUNLOAD    =       6
 };
 
 /**
@@ -102,6 +104,7 @@ typedef requestlist::iterator requestlist_iter;
  */
 enum QueryType
 {
+       DNS_QUERY_NONE  = 0,      /* Uninitialized Query */
        DNS_QUERY_A     = 1,      /* 'A' record: an ipv4 address */
        DNS_QUERY_CNAME = 5,      /* 'CNAME' record: An alias */
        DNS_QUERY_PTR   = 12,     /* 'PTR' record: a hostname */
@@ -146,6 +149,10 @@ class Resolver : public Extensible
         * Pointer to creator
         */
        InspIRCd* ServerInstance;
+       /**
+        * Pointer to creator module (if any, or NULL)
+        */
+       Module* Creator;
        /**
         * The input data, either a host or an IP address
         */
@@ -193,8 +200,14 @@ class Resolver : public Extensible
         * event a lookup could not be allocated, or a similar hard error occurs such as
         * the network being down. This will also be thrown if an invalid IP address is
         * passed when resolving a 'PTR' record.
+        *
+        * NOTE: If you are instantiating your DNS lookup from a module, you should set the
+        * value of creator to point at your Module class. This way if your module is unloaded
+        * whilst lookups are in progress, they can be safely removed and your module will not
+        * crash the server.
         */
-       Resolver(InspIRCd* Instance, const std::string &source, QueryType qt);
+       Resolver(InspIRCd* Instance, const std::string &source, QueryType qt, Module* creator = NULL);
+
        /**
         * The default destructor does nothing.
         */
@@ -220,6 +233,11 @@ class Resolver : public Extensible
         * this method will return -1.
         */
        int GetId();
+
+       /**
+        * Returns the creator module, or NULL
+        */
+       Module* GetCreator();
 };
 
 /** DNS is a singleton class used by the core to dispatch dns
@@ -330,7 +348,7 @@ class DNS : public EventHandler
         * Handle a SocketEngine read event
         * Inherited from EventHandler
         */
-       void HandleEvent(EventType et);
+       void HandleEvent(EventType et, int errornum = 0);
 
        /**
         * Add a Resolver* to the list of active classes
@@ -364,6 +382,13 @@ class DNS : public EventHandler
         * Turn an in6_addr into a .ip6.arpa domain
         */
        static void MakeIP6Int(char* query, const in6_addr *ip);
+
+       /**
+        * Clean out all dns resolvers owned by a particular
+        * module, to make unloading a module safe if there
+        * are dns requests currently in progress.
+        */
+       void CleanResolvers(Module* module);
 };
 
 #endif