include/rfc1035.h

   1 /*
   2  * $Id$
   3  *
   4  * AUTHOR: Duane Wessels
   5  *
   6  * SQUID Web Proxy Cache          http://www.squid-cache.org/
   7  * ----------------------------------------------------------
   8  *
   9  *  Squid is the result of efforts by numerous individuals from
  10  *  the Internet community; see the CONTRIBUTORS file for full
  11  *  details.   Many organizations have provided support for Squid's
  12  *  development; see the SPONSORS file for full details.  Squid is
  13  *  Copyrighted (C) 2001 by the Regents of the University of
  14  *  California; see the COPYRIGHT file for full details.  Squid
  15  *  incorporates software developed and/or copyrighted by other
  16  *  sources; see the CREDITS file for full details.
  17  *
  18  *  This program is free software; you can redistribute it and/or modify
  19  *  it under the terms of the GNU General Public License as published by
  20  *  the Free Software Foundation; either version 2 of the License, or
  21  *  (at your option) any later version.
  22  *
  23  *  This program is distributed in the hope that it will be useful,
  24  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  25  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  26  *  GNU General Public License for more details.
  27  *
  28  *  You should have received a copy of the GNU General Public License
  29  *  along with this program; if not, write to the Free Software
  30  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
  31  *
  32  */
  33 #ifndef SQUID_RFC1035_H
  34 #define SQUID_RFC1035_H
  35
  36 #if HAVE_SYS_TYPES_H
  37 #include <sys/types.h>
  38 #endif
  39 #if HAVE_NETINET_IN_H
  40 #include <netinet/in.h>
  41 #endif
  42 #if HAVE_ARPA_INET_H
  43 #include <arpa/inet.h>
  44 #endif
  45
  46 #include "rfc2181.h"
  47
  48 /**
  49  \par RFC 1035 Section 3.1:
  50  *  To simplify implementations, the total length of a domain name (i.e.,
  51  *  label octets and label length octets) is restricted to 255 octets or
  52  *  less.
  53  *\par
  54  *  Clarified by RFC 2181 Section 11. (RFC2181_MAXHOSTNAMELEN)
  55  */
  56 #define RFC1035_MAXHOSTNAMESZ RFC2181_MAXHOSTNAMELEN
  57
  58 #define RFC1035_DEFAULT_PACKET_SZ 512
  59
  60 typedef struct _rfc1035_rr rfc1035_rr;
  61 struct _rfc1035_rr {
  62     char name[RFC1035_MAXHOSTNAMESZ];
  63     unsigned short type;
  64     unsigned short _class;
  65     unsigned int ttl;
  66     unsigned short rdlength;
  67     char *rdata;
  68 };
  69
  70 typedef struct _rfc1035_query rfc1035_query;
  71 struct _rfc1035_query {
  72     char name[RFC1035_MAXHOSTNAMESZ];
  73     unsigned short qtype;
  74     unsigned short qclass;
  75 };
  76
  77 typedef struct _rfc1035_message rfc1035_message;
  78 struct _rfc1035_message {
  79     unsigned short id;
  80     unsigned int qr:1;
  81     unsigned int opcode:4;
  82     unsigned int aa:1;
  83     unsigned int tc:1;
  84     unsigned int rd:1;
  85     unsigned int ra:1;
  86     unsigned int rcode:4;
  87     unsigned short qdcount;
  88     unsigned short ancount;
  89     unsigned short nscount;
  90     unsigned short arcount;
  91     rfc1035_query *query;
  92     rfc1035_rr *answer;
  93 };
  94
  95 SQUIDCEXTERN ssize_t rfc1035BuildAQuery(const char *hostname,
  96                                         char *buf,
  97                                         size_t sz,
  98                                         unsigned short qid,
  99                                         rfc1035_query * query,
 100                                         ssize_t edns_sz);
 101 SQUIDCEXTERN ssize_t rfc1035BuildPTRQuery(const struct in_addr,
 102         char *buf,
 103         size_t sz,
 104         unsigned short qid,
 105         rfc1035_query * query,
 106         ssize_t edns_sz);
 107 SQUIDCEXTERN void rfc1035SetQueryID(char *, unsigned short qid);
 108 SQUIDCEXTERN int rfc1035MessageUnpack(const char *buf,
 109                                       size_t sz,
 110                                       rfc1035_message ** answer);
 111 SQUIDCEXTERN int rfc1035QueryCompare(const rfc1035_query *, const rfc1035_query *);
 112 SQUIDCEXTERN void rfc1035RRDestroy(rfc1035_rr ** rr, int n);
 113 SQUIDCEXTERN void rfc1035MessageDestroy(rfc1035_message ** message);
 114 SQUIDCEXTERN const char * rfc1035ErrorMessage(int n);
 115
 116 #define RFC1035_TYPE_A 1
 117 #define RFC1035_TYPE_CNAME 5
 118 #define RFC1035_TYPE_PTR 12
 119 #define RFC1035_CLASS_IN 1
 120
 121 /* Child Library RFC3596 Depends on some otherwise internal functions */
 122 SQUIDCEXTERN int rfc1035HeaderPack(char *buf,
 123                                    size_t sz,
 124                                    rfc1035_message * hdr);
 125 SQUIDCEXTERN int rfc1035HeaderUnpack(const char *buf,
 126                                      size_t sz,
 127                                      unsigned int *off,
 128                                      rfc1035_message * h);
 129 SQUIDCEXTERN int rfc1035QuestionPack(char *buf,
 130                                      size_t sz,
 131                                      const char *name,
 132                                      const unsigned short type,
 133                                      const unsigned short _class);
 134 SQUIDCEXTERN int rfc1035RRPack(char *buf, size_t sz, const rfc1035_rr * RR);
 135
 136 #endif /* SQUID_RFC1035_H */