include/dns.h

   1 /*
   2 dns.h - dns library declarations based on firedns Copyright (C) 2002 Ian Gulliver
   3
   4 This program is free software; you can redistribute it and/or modify
   5 it under the terms of version 2 of the GNU General Public License as
   6 published by the Free Software Foundation.
   7
   8 This program is distributed in the hope that it will be useful,
   9 but WITHOUT ANY WARRANTY; without even the implied warranty of
  10 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  11 GNU General Public License for more details.
  12
  13 You should have received a copy of the GNU General Public License
  14 along with this program; if not, write to the Free Software
  15 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  16 */
  17
  18 #ifndef _DNS_H
  19 #define _DNS_H
  20
  21 #include <sys/types.h>
  22 #include <sys/socket.h>
  23 #include <netinet/in.h>
  24 #include <string>
  25
  26 struct dns_ip4list {
  27         in_addr ip;
  28         dns_ip4list *next;
  29 };
  30
  31
  32 /** The DNS class allows fast nonblocking resolution of hostnames
  33  * and ip addresses. It is based heavily upon firedns by Ian Gulliver.
  34  */
  35 class DNS
  36 {
  37 private:
  38         in_addr *binip;
  39         char* result;
  40         int t;
  41         void dns_init();
  42         int fd;
  43         void dns_init_2(const char* dnsserver);
  44         in_addr *dns_aton4(const char * const ipstring);
  45         char *dns_ntoa4(const in_addr * const ip);
  46         int dns_getip4(const char * const name);
  47         int dns_getip4list(const char * const name);
  48         int dns_getname4(const in_addr * const ip);
  49         char *dns_getresult(const int fd);
  50         in_addr *dns_aton4_s(const char * const ipstring, in_addr * const ip);
  51         char *dns_ntoa4_s(const in_addr * const ip, char * const result);
  52         char *dns_getresult_s(const int fd, char * const result);
  53         in_addr *dns_aton4_r(const char * const ipstring);
  54         char *dns_ntoa4_r(const in_addr * const ip);
  55         char *dns_getresult_r(const int fd);
  56 public:
  57         /** The default constructor uses dns addresses read from /etc/resolv.conf.
  58          * Please note that it will re-read /etc/resolv.conf for each copy of the
  59          * class you instantiate, causing disk access and slow lookups if you create
  60          * a lot of them. Consider passing the constructor a server address as a parameter
  61          * instead.
  62          */
  63         DNS();
  64         /** This constructor accepts a dns server address. The address must be in dotted
  65          * decimal form, e.g. 1.2.3.4.
  66          */
  67         DNS(std::string dnsserver);
  68         /** The destructor frees all used structures.
  69          */
  70         ~DNS();
  71         /** This method will start the reverse lookup of an ip given in dotted decimal
  72          * format, e.g. 1.2.3.4, and returns true if the lookup was successfully
  73          * initiated.
  74          */
  75         bool ReverseLookup(std::string ip);
  76         /** This method will start the forward lookup of a hostname, e.g. www.inspircd.org,
  77          * and returns true if the lookup was successfully initiated.
  78          */
  79         bool ForwardLookup(std::string host);
  80         /** This method will return true when the lookup is completed. It uses poll internally
  81          * to determine the status of the socket.
  82          */
  83         bool HasResult();
  84         /** This method returns the result of your query as a string, depending upon wether you
  85          * called DNS::ReverseLookup() or DNS::ForwardLookup.
  86          */
  87         std::string GetResult();
  88         /** This method returns the file handle used by the dns query socket or zero if the
  89          * query is invalid for some reason, e.g. the dns server not responding.
  90          */
  91         int GetFD();
  92         void SetNS(std::string dnsserver);
  93 };
  94
  95 #endif