And now, just to force you to recompile the *whole* ircd.. updated headers on the...

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

diff --git a/include/dns.h b/include/dns.h
index b011a9ddbd7762bb384cc6fe4ba5745bfd1fde79..4087e2476eef2bef4f176b1d583683bfa1236df5 100644 (file)
--- a/include/dns.h
+++ b/include/dns.h
@@ -2,14 +2,11 @@
  *       | Inspire Internet Relay Chat Daemon |
  *       +------------------------------------+
  *
- *  InspIRCd is copyright (C) 2002-2006 ChatSpike-Dev.
- *                     E-mail:
- *              <brain@chatspike.net>
- *              <Craig@chatspike.net>
+ *  InspIRCd: (C) 2002-2007 InspIRCd Development Team
+ * See: http://www.inspircd.org/wiki/index.php/Credits
  *
- * Written by Craig Edwards, Craig McLure, and others.
  * This program is free but copyrighted software; see
- *          the file COPYING for details.
+ *            the file COPYING for details.
  *
  * ---------------------------------------------------
  */
@@ -48,6 +45,7 @@ using irc::sockets::insp_sockaddr;
 using irc::sockets::insp_inaddr;
 
 class InspIRCd;
+class Module;
 
 /**
  * Result status, used internally
@@ -69,7 +67,8 @@ enum ResolverError
        RESOLVER_NXDOMAIN       =       2,
        RESOLVER_NOTREADY       =       3,
        RESOLVER_BADIP          =       4,
-       RESOLVER_TIMEOUT        =       5
+       RESOLVER_TIMEOUT        =       5,
+       RESLOVER_FORCEUNLOAD    =       6
 };
 
 /**
@@ -102,6 +101,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 +146,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 +197,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 +230,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 +345,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 +379,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