lib/addns/dns.h

   1 /*
   2   Linux DNS client library implementation
   3
   4   Copyright (C) 2006 Krishna Ganugapati <krishnag@centeris.com>
   5   Copyright (C) 2006 Gerald Carter <jerry@samba.org>
   6
   7      ** NOTE! The following LGPL license applies to the libaddns
   8      ** library. This does NOT imply that all of Samba is released
   9      ** under the LGPL
  10
  11   This library is free software; you can redistribute it and/or
  12   modify it under the terms of the GNU Lesser General Public
  13   License as published by the Free Software Foundation; either
  14   version 2.1 of the License, or (at your option) any later version.
  15
  16   This library is distributed in the hope that it will be useful,
  17   but WITHOUT ANY WARRANTY; without even the implied warranty of
  18   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  19   Lesser General Public License for more details.
  20
  21   You should have received a copy of the GNU Lesser General Public
  22   License along with this library; if not, see <http://www.gnu.org/licenses/>.
  23 */
  24
  25 #ifndef _DNS_H
  26 #define _DNS_H
  27
  28 #include "../replace/replace.h"
  29 #include "system/network.h"
  30 #include "system/kerberos.h"
  31 #include "system/gssapi.h"
  32
  33 /* make sure we have included the correct config.h */
  34 #ifndef NO_CONFIG_H /* for some tests */
  35 #ifndef CONFIG_H_IS_FROM_SAMBA
  36 #error "make sure you have removed all config.h files from standalone builds!"
  37 #error "the included config.h isn't from samba!"
  38 #endif
  39 #endif /* NO_CONFIG_H */
  40
  41 #include <fcntl.h>
  42 #include <time.h>
  43 #include <netdb.h>
  44
  45 #include <talloc.h>
  46
  47 #include "dnserr.h"
  48
  49
  50 #define DNS_TCP                 1
  51 #define DNS_UDP                 2
  52
  53 #define DNS_OPCODE_UPDATE       1
  54
  55 /* DNS Class Types */
  56
  57 #define DNS_CLASS_IN            1
  58 #define DNS_CLASS_ANY           255
  59 #define DNS_CLASS_NONE          254
  60
  61 /* DNS RR Types */
  62
  63 #define DNS_RR_A                1
  64
  65 #define DNS_TCP_PORT            53
  66 #define DNS_UDP_PORT            53
  67
  68 #define QTYPE_A         1
  69 #define QTYPE_NS        2
  70 #define QTYPE_MD        3
  71 #define QTYPE_CNAME     5
  72 #define QTYPE_SOA       6
  73 #define QTYPE_AAAA      28
  74 #define QTYPE_ANY       255
  75 #define QTYPE_TKEY      249
  76 #define QTYPE_TSIG      250
  77
  78 /*
  79 MF              4 a mail forwarder (Obsolete - use MX)
  80 CNAME           5 the canonical name for an alias
  81 SOA             6 marks the start of a zone of authority
  82 MB              7 a mailbox domain name (EXPERIMENTAL)
  83 MG              8 a mail group member (EXPERIMENTAL)
  84 MR              9 a mail rename domain name (EXPERIMENTAL)
  85 NULL            10 a null RR (EXPERIMENTAL)
  86 WKS             11 a well known service description
  87 PTR             12 a domain name pointer
  88 HINFO           13 host information
  89 MINFO           14 mailbox or mail list information
  90 MX              15 mail exchange
  91 TXT             16 text strings
  92 */
  93
  94 #define QR_QUERY         0x0000
  95 #define QR_RESPONSE      0x0001
  96
  97 #define OPCODE_QUERY 0x00
  98 #define OPCODE_IQUERY   0x01
  99 #define OPCODE_STATUS   0x02
 100
 101 #define AA                      1
 102
 103 #define RECURSION_DESIRED       0x01
 104
 105 #define RCODE_NOERROR          0
 106 #define RCODE_FORMATERROR      1
 107 #define RCODE_SERVER_FAILURE   2
 108 #define RCODE_NAME_ERROR       3
 109 #define RCODE_NOTIMPLEMENTED   4
 110 #define RCODE_REFUSED          5
 111
 112 #define SENDBUFFER_SIZE         65536
 113 #define RECVBUFFER_SIZE         65536
 114
 115 /*
 116  * TKEY Modes from rfc2930
 117  */
 118
 119 #define DNS_TKEY_MODE_SERVER   1
 120 #define DNS_TKEY_MODE_DH       2
 121 #define DNS_TKEY_MODE_GSSAPI   3
 122 #define DNS_TKEY_MODE_RESOLVER 4
 123 #define DNS_TKEY_MODE_DELETE   5
 124
 125
 126 #define DNS_ONE_DAY_IN_SECS     86400
 127 #define DNS_TEN_HOURS_IN_SECS   36000
 128
 129 #define SOCKET_ERROR            -1
 130 #define INVALID_SOCKET          -1
 131
 132 #define  DNS_NO_ERROR           0
 133 #define  DNS_FORMAT_ERROR       1
 134 #define  DNS_SERVER_FAILURE     2
 135 #define  DNS_NAME_ERROR         3
 136 #define  DNS_NOT_IMPLEMENTED    4
 137 #define  DNS_REFUSED            5
 138
 139 typedef long HANDLE;
 140
 141 enum dns_ServerType { DNS_SRV_ANY, DNS_SRV_WIN2000, DNS_SRV_WIN2003 };
 142
 143 struct dns_domain_label {
 144         struct dns_domain_label *next;
 145         char *label;
 146         size_t len;
 147 };
 148
 149 struct dns_domain_name {
 150         struct dns_domain_label *pLabelList;
 151 };
 152
 153 struct dns_question {
 154         struct dns_domain_name *name;
 155         uint16_t q_type;
 156         uint16_t q_class;
 157 };
 158
 159 /*
 160  * Before changing the definition of dns_zone, look
 161  * dns_marshall_update_request(), we rely on this being the same as
 162  * dns_question right now.
 163  */
 164
 165 struct dns_zone {
 166         struct dns_domain_name *name;
 167         uint16_t z_type;
 168         uint16_t z_class;
 169 };
 170
 171 struct dns_rrec {
 172         struct dns_domain_name *name;
 173         uint16_t type;
 174         uint16_t r_class;
 175         uint32_t ttl;
 176         uint16_t data_length;
 177         uint8_t *data;
 178 };
 179
 180 struct dns_tkey_record {
 181         struct dns_domain_name *algorithm;
 182         time_t inception;
 183         time_t expiration;
 184         uint16_t mode;
 185         uint16_t error;
 186         uint16_t key_length;
 187         uint8_t *key;
 188 };
 189
 190 struct dns_request {
 191         uint16_t id;
 192         uint16_t flags;
 193         uint16_t num_questions;
 194         uint16_t num_answers;
 195         uint16_t num_auths;
 196         uint16_t num_additionals;
 197         struct dns_question **questions;
 198         struct dns_rrec **answers;
 199         struct dns_rrec **auths;
 200         struct dns_rrec **additionals;
 201 };
 202
 203 /*
 204  * Before changing the definition of dns_update_request, look
 205  * dns_marshall_update_request(), we rely on this being the same as
 206  * dns_request right now.
 207  */
 208
 209 struct dns_update_request {
 210         uint16_t id;
 211         uint16_t flags;
 212         uint16_t num_zones;
 213         uint16_t num_preqs;
 214         uint16_t num_updates;
 215         uint16_t num_additionals;
 216         struct dns_zone **zones;
 217         struct dns_rrec **preqs;
 218         struct dns_rrec **updates;
 219         struct dns_rrec **additionals;
 220 };
 221
 222 struct dns_connection {
 223         int32_t hType;
 224         int s;
 225         struct sockaddr_storage RecvAddr;
 226 };
 227
 228 struct dns_buffer {
 229         uint8_t *data;
 230         size_t size;
 231         size_t offset;
 232         DNS_ERROR error;
 233 };
 234
 235 /* from dnsutils.c */
 236
 237 DNS_ERROR dns_domain_name_from_string( TALLOC_CTX *mem_ctx,
 238                                        const char *pszDomainName,
 239                                        struct dns_domain_name **presult );
 240 char *dns_generate_keyname( TALLOC_CTX *mem_ctx );
 241
 242 /* from dnsrecord.c */
 243
 244 DNS_ERROR dns_create_query( TALLOC_CTX *mem_ctx, const char *name,
 245                             uint16_t q_type, uint16_t q_class,
 246                             struct dns_request **preq );
 247 DNS_ERROR dns_create_update( TALLOC_CTX *mem_ctx, const char *name,
 248                              struct dns_update_request **preq );
 249 DNS_ERROR dns_create_probe(TALLOC_CTX *mem_ctx, const char *zone,
 250                            const char *host, int num_ips,
 251                            const struct sockaddr_storage *sslist,
 252                            struct dns_update_request **preq);
 253 DNS_ERROR dns_create_rrec(TALLOC_CTX *mem_ctx, const char *name,
 254                           uint16_t type, uint16_t r_class, uint32_t ttl,
 255                           uint16_t data_length, uint8_t *data,
 256                           struct dns_rrec **prec);
 257 DNS_ERROR dns_add_rrec(TALLOC_CTX *mem_ctx, struct dns_rrec *rec,
 258                        uint16_t *num_records, struct dns_rrec ***records);
 259 DNS_ERROR dns_create_tkey_record(TALLOC_CTX *mem_ctx, const char *keyname,
 260                                  const char *algorithm_name, time_t inception,
 261                                  time_t expiration, uint16_t mode, uint16_t error,
 262                                  uint16_t key_length, const uint8_t *key,
 263                                  struct dns_rrec **prec);
 264 DNS_ERROR dns_create_name_in_use_record(TALLOC_CTX *mem_ctx,
 265                                         const char *name,
 266                                         const struct sockaddr_storage *ip,
 267                                         struct dns_rrec **prec);
 268 DNS_ERROR dns_create_delete_record(TALLOC_CTX *mem_ctx, const char *name,
 269                                    uint16_t type, uint16_t r_class,
 270                                    struct dns_rrec **prec);
 271 DNS_ERROR dns_create_name_not_in_use_record(TALLOC_CTX *mem_ctx,
 272                                             const char *name, uint32_t type,
 273                                             struct dns_rrec **prec);
 274 DNS_ERROR dns_create_a_record(TALLOC_CTX *mem_ctx, const char *host,
 275                               uint32_t ttl, const struct sockaddr_storage *pss,
 276                               struct dns_rrec **prec);
 277 DNS_ERROR dns_create_aaaa_record(TALLOC_CTX *mem_ctx, const char *host,
 278                                  uint32_t ttl, const struct sockaddr_storage *pss,
 279                                  struct dns_rrec **prec);
 280 DNS_ERROR dns_unmarshall_tkey_record(TALLOC_CTX *mem_ctx, struct dns_rrec *rec,
 281                                      struct dns_tkey_record **ptkey);
 282 DNS_ERROR dns_create_tsig_record(TALLOC_CTX *mem_ctx, const char *keyname,
 283                                  const char *algorithm_name,
 284                                  time_t time_signed, uint16_t fudge,
 285                                  uint16_t mac_length, const uint8_t *mac,
 286                                  uint16_t original_id, uint16_t error,
 287                                  struct dns_rrec **prec);
 288 DNS_ERROR dns_add_rrec(TALLOC_CTX *mem_ctx, struct dns_rrec *rec,
 289                        uint16_t *num_records, struct dns_rrec ***records);
 290 DNS_ERROR dns_create_update_request(TALLOC_CTX *mem_ctx,
 291                                     const char *domainname,
 292                                     const char *hostname,
 293                                     const struct sockaddr_storage *ip_addr,
 294                                     size_t num_adds,
 295                                     struct dns_update_request **preq);
 296
 297 /* from dnssock.c */
 298
 299 DNS_ERROR dns_open_connection( const char *nameserver, int32_t dwType,
 300                     TALLOC_CTX *mem_ctx,
 301                     struct dns_connection **conn );
 302 DNS_ERROR dns_send(struct dns_connection *conn, const struct dns_buffer *buf);
 303 DNS_ERROR dns_receive(TALLOC_CTX *mem_ctx, struct dns_connection *conn,
 304                       struct dns_buffer **presult);
 305 DNS_ERROR dns_transaction(TALLOC_CTX *mem_ctx, struct dns_connection *conn,
 306                           const struct dns_request *req,
 307                           struct dns_request **resp);
 308 DNS_ERROR dns_update_transaction(TALLOC_CTX *mem_ctx,
 309                                  struct dns_connection *conn,
 310                                  struct dns_update_request *up_req,
 311                                  struct dns_update_request **up_resp);
 312
 313 /* from dnsmarshall.c */
 314
 315 struct dns_buffer *dns_create_buffer(TALLOC_CTX *mem_ctx);
 316 void dns_marshall_buffer(struct dns_buffer *buf, const uint8_t *data,
 317                          size_t len);
 318 void dns_marshall_uint16(struct dns_buffer *buf, uint16_t val);
 319 void dns_marshall_uint32(struct dns_buffer *buf, uint32_t val);
 320 void dns_unmarshall_buffer(struct dns_buffer *buf, uint8_t *data,
 321                            size_t len);
 322 void dns_unmarshall_uint16(struct dns_buffer *buf, uint16_t *val);
 323 void dns_unmarshall_uint32(struct dns_buffer *buf, uint32_t *val);
 324 void dns_unmarshall_domain_name(TALLOC_CTX *mem_ctx,
 325                                 struct dns_buffer *buf,
 326                                 struct dns_domain_name **pname);
 327 void dns_marshall_domain_name(struct dns_buffer *buf,
 328                               const struct dns_domain_name *name);
 329 void dns_unmarshall_domain_name(TALLOC_CTX *mem_ctx,
 330                                 struct dns_buffer *buf,
 331                                 struct dns_domain_name **pname);
 332 DNS_ERROR dns_marshall_request(TALLOC_CTX *mem_ctx,
 333                                const struct dns_request *req,
 334                                struct dns_buffer **pbuf);
 335 DNS_ERROR dns_unmarshall_request(TALLOC_CTX *mem_ctx,
 336                                  struct dns_buffer *buf,
 337                                  struct dns_request **preq);
 338 DNS_ERROR dns_marshall_update_request(TALLOC_CTX *mem_ctx,
 339                                       struct dns_update_request *update,
 340                                       struct dns_buffer **pbuf);
 341 DNS_ERROR dns_unmarshall_update_request(TALLOC_CTX *mem_ctx,
 342                                         struct dns_buffer *buf,
 343                                         struct dns_update_request **pupreq);
 344 struct dns_request *dns_update2request(struct dns_update_request *update);
 345 struct dns_update_request *dns_request2update(struct dns_request *request);
 346 uint16_t dns_response_code(uint16_t flags);
 347 const char *dns_errstr(DNS_ERROR err);
 348
 349 /* from dnsgss.c */
 350
 351 #ifdef HAVE_GSSAPI
 352
 353 void display_status( const char *msg, OM_uint32 maj_stat, OM_uint32 min_stat );
 354 DNS_ERROR dns_negotiate_sec_ctx( const char *target_realm,
 355                                  const char *servername,
 356                                  const char *keyname,
 357                                  gss_ctx_id_t *gss_ctx,
 358                                  enum dns_ServerType srv_type );
 359 DNS_ERROR dns_sign_update(struct dns_update_request *req,
 360                           gss_ctx_id_t gss_ctx,
 361                           const char *keyname,
 362                           const char *algorithmname,
 363                           time_t time_signed, uint16_t fudge);
 364
 365 #endif  /* HAVE_GSSAPI */
 366
 367 #endif  /* _DNS_H */