XHTML 1.1 spec validation and charset

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

diff --git a/include/dns.h b/include/dns.h
index 61c35b07305d5cbfb9000ef809fee28f9fc4a6c1..b0dc3636f0caf4cc189147937425ed700cbd21a1 100644 (file)
--- a/include/dns.h
+++ b/include/dns.h
@@ -18,24 +18,30 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 #ifndef _DNS_H
 #define _DNS_H
 
-#include <sys/types.h>
-#include <sys/socket.h>
-#include <netinet/in.h>
 #include <string>
+#include "inspircd_config.h"
+#include "socket.h"
+#include "base.h"
 
-struct dns_ip4list {
+struct dns_ip4list
+{
        in_addr ip;
        dns_ip4list *next;
 };
 
-class DNS
+
+/** The DNS class allows fast nonblocking resolution of hostnames
+ * and ip addresses. It is based heavily upon firedns by Ian Gulliver.
+ */
+class DNS : public Extensible
 {
 private:
-       char *result;
        in_addr *binip;
-       int t,i;
+       char* result;
+       char localbuf[1024];
+       int t;
        void dns_init();
-       unsigned int fd;
+       int myfd;
        void dns_init_2(const char* dnsserver);
        in_addr *dns_aton4(const char * const ipstring);
        char *dns_ntoa4(const in_addr * const ip);
@@ -50,14 +56,56 @@ private:
        char *dns_ntoa4_r(const in_addr * const ip);
        char *dns_getresult_r(const int fd);
 public:
+       /** The default constructor uses dns addresses read from /etc/resolv.conf.
+        * Please note that it will re-read /etc/resolv.conf for each copy of the
+        * class you instantiate, causing disk access and slow lookups if you create
+        * a lot of them. Consider passing the constructor a server address as a parameter
+        * instead.
+        */
        DNS();
-       DNS(std::string dnsserver);
+       /** This constructor accepts a dns server address. The address must be in dotted
+        * decimal form, e.g. 1.2.3.4.
+        */
+       DNS(const std::string &dnsserver);
+       /** The destructor frees all used structures.
+        */
        ~DNS();
-       bool ReverseLookup(std::string ip);
-       bool ForwardLookup(std::string host);
+       /** This method will start the reverse lookup of an ip given in dotted decimal
+        * format, e.g. 1.2.3.4, and returns true if the lookup was successfully
+        * initiated.
+        */
+       bool ReverseLookup(const std::string &ip);
+       /** This method will start the forward lookup of a hostname, e.g. www.inspircd.org,
+        * and returns true if the lookup was successfully initiated.
+        */
+       bool ForwardLookup(const std::string &host);
+       /** Used by modules to perform a dns lookup but have the socket engine poll a module, instead of the dns object directly.
+        */
+       bool ForwardLookupWithFD(const std::string &host, int &fd);
+       /** This method will return true when the lookup is completed. It uses poll internally
+        * to determine the status of the socket.
+        */
        bool HasResult();
+       /** This method will return true if the lookup's fd matches the one provided
+        */
+       bool HasResult(int fd);
+       /** This method returns the result of your query as a string, depending upon wether you
+        * called DNS::ReverseLookup() or DNS::ForwardLookup.
+        */
        std::string GetResult();
+       std::string GetResultIP();
+       /** This method returns the file handle used by the dns query socket or zero if the
+        * query is invalid for some reason, e.g. the dns server not responding.
+        */
        int GetFD();
+       void SetNS(const std::string &dnsserver);
 };
 
+/** This is the handler function for multi-threaded DNS.
+ * It cannot be a class member as pthread will not let us
+ * create a thread whos handler function is a member of
+ * a class (ugh).
+ */
+void* dns_task(void* arg);
+
 #endif