include/arpa/nameser.h

   1 /*-
   2  * SPDX-License-Identifier: (ISC AND BSD-3-Clause)
   3  *
   4  * Portions Copyright (C) 2004, 2005, 2008, 2009  Internet Systems Consortium, Inc. ("ISC")
   5  * Portions Copyright (C) 1996-2003  Internet Software Consortium.
   6  *
   7  * Permission to use, copy, modify, and/or distribute this software for any
   8  * purpose with or without fee is hereby granted, provided that the above
   9  * copyright notice and this permission notice appear in all copies.
  10  *
  11  * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
  12  * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  13  * AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  14  * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  15  * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  16  * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  17  * PERFORMANCE OF THIS SOFTWARE.
  18  */
  19
  20 /*-
  21  * Copyright (c) 1983, 1989, 1993
  22  *    The Regents of the University of California.  All rights reserved.
  23  *
  24  * Redistribution and use in source and binary forms, with or without
  25  * modification, are permitted provided that the following conditions
  26  * are met:
  27  * 1. Redistributions of source code must retain the above copyright
  28  *    notice, this list of conditions and the following disclaimer.
  29  * 2. Redistributions in binary form must reproduce the above copyright
  30  *    notice, this list of conditions and the following disclaimer in the
  31  *    documentation and/or other materials provided with the distribution.
  32  * 3. Neither the name of the University nor the names of its contributors
  33  *    may be used to endorse or promote products derived from this software
  34  *    without specific prior written permission.
  35  *
  36  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  37  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  38  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  39  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  40  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  41  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  42  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  43  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  44  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  45  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  46  * SUCH DAMAGE.
  47  */
  48
  49 /*
  50  *      $Id: nameser.h,v 1.16 2009/03/03 01:52:48 each Exp $
  51  * $FreeBSD$
  52  */
  53
  54 #ifndef _ARPA_NAMESER_H_
  55 #define _ARPA_NAMESER_H_
  56
  57 /*! \file */
  58
  59 #define BIND_4_COMPAT
  60
  61 #include <sys/param.h>
  62 #include <sys/types.h>
  63 #include <sys/cdefs.h>
  64
  65 /*%
  66  * Revision information.  This is the release date in YYYYMMDD format.
  67  * It can change every day so the right thing to do with it is use it
  68  * in preprocessor commands such as "#if (__NAMESER > 19931104)".  Do not
  69  * compare for equality; rather, use it to determine whether your libbind.a
  70  * contains a new enough lib/nameser/ to support the feature you need.
  71  */
  72
  73 #define __NAMESER       20090302        /*%< New interface version stamp. */
  74 /*
  75  * Define constants based on RFC0883, RFC1034, RFC 1035
  76  */
  77 #define NS_PACKETSZ     512     /*%< default UDP packet size */
  78 #define NS_MAXDNAME     1025    /*%< maximum domain name (presentation format)*/
  79 #define NS_MAXMSG       65535   /*%< maximum message size */
  80 #define NS_MAXCDNAME    255     /*%< maximum compressed domain name */
  81 #define NS_MAXLABEL     63      /*%< maximum length of domain label */
  82 #define NS_MAXLABELS    128     /*%< theoretical max #/labels per domain name */
  83 #define NS_MAXNNAME     256     /*%< maximum uncompressed (binary) domain name*/
  84 #define NS_MAXPADDR     (sizeof "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff")
  85 #define NS_HFIXEDSZ     12      /*%< #/bytes of fixed data in header */
  86 #define NS_QFIXEDSZ     4       /*%< #/bytes of fixed data in query */
  87 #define NS_RRFIXEDSZ    10      /*%< #/bytes of fixed data in r record */
  88 #define NS_INT32SZ      4       /*%< #/bytes of data in a u_int32_t */
  89 #define NS_INT16SZ      2       /*%< #/bytes of data in a u_int16_t */
  90 #define NS_INT8SZ       1       /*%< #/bytes of data in a u_int8_t */
  91 #define NS_INADDRSZ     4       /*%< IPv4 T_A */
  92 #define NS_IN6ADDRSZ    16      /*%< IPv6 T_AAAA */
  93 #define NS_CMPRSFLGS    0xc0    /*%< Flag bits indicating name compression. */
  94 #define NS_DEFAULTPORT  53      /*%< For both TCP and UDP. */
  95 /*
  96  * These can be expanded with synonyms, just keep ns_parse.c:ns_parserecord()
  97  * in synch with it.
  98  */
  99 typedef enum __ns_sect {
 100         ns_s_qd = 0,            /*%< Query: Question. */
 101         ns_s_zn = 0,            /*%< Update: Zone. */
 102         ns_s_an = 1,            /*%< Query: Answer. */
 103         ns_s_pr = 1,            /*%< Update: Prerequisites. */
 104         ns_s_ns = 2,            /*%< Query: Name servers. */
 105         ns_s_ud = 2,            /*%< Update: Update. */
 106         ns_s_ar = 3,            /*%< Query|Update: Additional records. */
 107         ns_s_max = 4
 108 } ns_sect;
 109
 110 /*%
 111  * Network name (compressed or not) type.  Equivalent to a pointer when used
 112  * in a function prototype.  Can be const'd.
 113  */
 114 typedef u_char ns_nname[NS_MAXNNAME];
 115 typedef const u_char *ns_nname_ct;
 116 typedef u_char *ns_nname_t;
 117
 118 struct ns_namemap { ns_nname_ct base; int len; };
 119 typedef struct ns_namemap *ns_namemap_t;
 120 typedef const struct ns_namemap *ns_namemap_ct;
 121
 122 /*%
 123  * This is a message handle.  It is caller allocated and has no dynamic data.
 124  * This structure is intended to be opaque to all but ns_parse.c, thus the
 125  * leading _'s on the member names.  Use the accessor functions, not the _'s.
 126  */
 127 typedef struct __ns_msg {
 128         const u_char    *_msg, *_eom;
 129         u_int16_t       _id, _flags, _counts[ns_s_max];
 130         const u_char    *_sections[ns_s_max];
 131         ns_sect         _sect;
 132         int             _rrnum;
 133         const u_char    *_msg_ptr;
 134 } ns_msg;
 135
 136 /* Private data structure - do not use from outside library. */
 137 struct _ns_flagdata {  int mask, shift;  };
 138 extern struct _ns_flagdata _ns_flagdata[];
 139
 140 /* Accessor macros - this is part of the public interface. */
 141
 142 #define ns_msg_id(handle) ((handle)._id + 0)
 143 #define ns_msg_base(handle) ((handle)._msg + 0)
 144 #define ns_msg_end(handle) ((handle)._eom + 0)
 145 #define ns_msg_size(handle) ((handle)._eom - (handle)._msg)
 146 #define ns_msg_count(handle, section) ((handle)._counts[section] + 0)
 147
 148 /*%
 149  * This is a parsed record.  It is caller allocated and has no dynamic data.
 150  */
 151 typedef struct __ns_rr {
 152         char            name[NS_MAXDNAME];
 153         u_int16_t       type;
 154         u_int16_t       rr_class;
 155         u_int32_t       ttl;
 156         u_int16_t       rdlength;
 157         const u_char *  rdata;
 158 } ns_rr;
 159
 160 /*
 161  * Same thing, but using uncompressed network binary names, and real C types.
 162  */
 163 typedef struct __ns_rr2 {
 164         ns_nname        nname;
 165         size_t          nnamel;
 166         int             type;
 167         int             rr_class;
 168         u_int           ttl;
 169         int             rdlength;
 170         const u_char *  rdata;
 171 } ns_rr2;
 172
 173 /* Accessor macros - this is part of the public interface. */
 174 #define ns_rr_name(rr)  (((rr).name[0] != '\0') ? (rr).name : ".")
 175 #define ns_rr_nname(rr) ((const ns_nname_t)(rr).nname)
 176 #define ns_rr_nnamel(rr) ((rr).nnamel + 0)
 177 #define ns_rr_type(rr)  ((ns_type)((rr).type + 0))
 178 #define ns_rr_class(rr) ((ns_class)((rr).rr_class + 0))
 179 #define ns_rr_ttl(rr)   ((rr).ttl + 0)
 180 #define ns_rr_rdlen(rr) ((rr).rdlength + 0)
 181 #define ns_rr_rdata(rr) ((rr).rdata + 0)
 182
 183 /*%
 184  * These don't have to be in the same order as in the packet flags word,
 185  * and they can even overlap in some cases, but they will need to be kept
 186  * in synch with ns_parse.c:ns_flagdata[].
 187  */
 188 typedef enum __ns_flag {
 189         ns_f_qr,                /*%< Question/Response. */
 190         ns_f_opcode,            /*%< Operation code. */
 191         ns_f_aa,                /*%< Authoritative Answer. */
 192         ns_f_tc,                /*%< Truncation occurred. */
 193         ns_f_rd,                /*%< Recursion Desired. */
 194         ns_f_ra,                /*%< Recursion Available. */
 195         ns_f_z,                 /*%< MBZ. */
 196         ns_f_ad,                /*%< Authentic Data (DNSSEC). */
 197         ns_f_cd,                /*%< Checking Disabled (DNSSEC). */
 198         ns_f_rcode,             /*%< Response code. */
 199         ns_f_max
 200 } ns_flag;
 201
 202 /*%
 203  * Currently defined opcodes.
 204  */
 205 typedef enum __ns_opcode {
 206         ns_o_query = 0,         /*%< Standard query. */
 207         ns_o_iquery = 1,        /*%< Inverse query (deprecated/unsupported). */
 208         ns_o_status = 2,        /*%< Name server status query (unsupported). */
 209                                 /* Opcode 3 is undefined/reserved. */
 210         ns_o_notify = 4,        /*%< Zone change notification. */
 211         ns_o_update = 5,        /*%< Zone update message. */
 212         ns_o_max = 6
 213 } ns_opcode;
 214
 215 /*%
 216  * Currently defined response codes.
 217  */
 218 typedef enum __ns_rcode {
 219         ns_r_noerror = 0,       /*%< No error occurred. */
 220         ns_r_formerr = 1,       /*%< Format error. */
 221         ns_r_servfail = 2,      /*%< Server failure. */
 222         ns_r_nxdomain = 3,      /*%< Name error. */
 223         ns_r_notimpl = 4,       /*%< Unimplemented. */
 224         ns_r_refused = 5,       /*%< Operation refused. */
 225         /* these are for BIND_UPDATE */
 226         ns_r_yxdomain = 6,      /*%< Name exists */
 227         ns_r_yxrrset = 7,       /*%< RRset exists */
 228         ns_r_nxrrset = 8,       /*%< RRset does not exist */
 229         ns_r_notauth = 9,       /*%< Not authoritative for zone */
 230         ns_r_notzone = 10,      /*%< Zone of record different from zone section */
 231         ns_r_max = 11,
 232         /* The following are EDNS extended rcodes */
 233         ns_r_badvers = 16,
 234         /* The following are TSIG errors */
 235         ns_r_badsig = 16,
 236         ns_r_badkey = 17,
 237         ns_r_badtime = 18
 238 } ns_rcode;
 239
 240 /* BIND_UPDATE */
 241 typedef enum __ns_update_operation {
 242         ns_uop_delete = 0,
 243         ns_uop_add = 1,
 244         ns_uop_max = 2
 245 } ns_update_operation;
 246
 247 /*%
 248  * This structure is used for TSIG authenticated messages
 249  */
 250 struct ns_tsig_key {
 251         char name[NS_MAXDNAME], alg[NS_MAXDNAME];
 252         unsigned char *data;
 253         int len;
 254 };
 255 typedef struct ns_tsig_key ns_tsig_key;
 256
 257 /*%
 258  * This structure is used for TSIG authenticated TCP messages
 259  */
 260 struct ns_tcp_tsig_state {
 261         int counter;
 262         struct dst_key *key;
 263         void *ctx;
 264         unsigned char sig[NS_PACKETSZ];
 265         int siglen;
 266 };
 267 typedef struct ns_tcp_tsig_state ns_tcp_tsig_state;
 268
 269 #define NS_TSIG_FUDGE 300
 270 #define NS_TSIG_TCP_COUNT 100
 271 #define NS_TSIG_ALG_HMAC_MD5 "HMAC-MD5.SIG-ALG.REG.INT"
 272
 273 #define NS_TSIG_ERROR_NO_TSIG -10
 274 #define NS_TSIG_ERROR_NO_SPACE -11
 275 #define NS_TSIG_ERROR_FORMERR -12
 276
 277 /*%
 278  * Currently defined type values for resources and queries.
 279  */
 280 typedef enum __ns_type {
 281         ns_t_invalid = 0,       /*%< Cookie. */
 282         ns_t_a = 1,             /*%< Host address. */
 283         ns_t_ns = 2,            /*%< Authoritative server. */
 284         ns_t_md = 3,            /*%< Mail destination. */
 285         ns_t_mf = 4,            /*%< Mail forwarder. */
 286         ns_t_cname = 5,         /*%< Canonical name. */
 287         ns_t_soa = 6,           /*%< Start of authority zone. */
 288         ns_t_mb = 7,            /*%< Mailbox domain name. */
 289         ns_t_mg = 8,            /*%< Mail group member. */
 290         ns_t_mr = 9,            /*%< Mail rename name. */
 291         ns_t_null = 10,         /*%< Null resource record. */
 292         ns_t_wks = 11,          /*%< Well known service. */
 293         ns_t_ptr = 12,          /*%< Domain name pointer. */
 294         ns_t_hinfo = 13,        /*%< Host information. */
 295         ns_t_minfo = 14,        /*%< Mailbox information. */
 296         ns_t_mx = 15,           /*%< Mail routing information. */
 297         ns_t_txt = 16,          /*%< Text strings. */
 298         ns_t_rp = 17,           /*%< Responsible person. */
 299         ns_t_afsdb = 18,        /*%< AFS cell database. */
 300         ns_t_x25 = 19,          /*%< X_25 calling address. */
 301         ns_t_isdn = 20,         /*%< ISDN calling address. */
 302         ns_t_rt = 21,           /*%< Router. */
 303         ns_t_nsap = 22,         /*%< NSAP address. */
 304         ns_t_nsap_ptr = 23,     /*%< Reverse NSAP lookup (deprecated). */
 305         ns_t_sig = 24,          /*%< Security signature. */
 306         ns_t_key = 25,          /*%< Security key. */
 307         ns_t_px = 26,           /*%< X.400 mail mapping. */
 308         ns_t_gpos = 27,         /*%< Geographical position (withdrawn). */
 309         ns_t_aaaa = 28,         /*%< IPv6 Address. */
 310         ns_t_loc = 29,          /*%< Location Information. */
 311         ns_t_nxt = 30,          /*%< Next domain (security). */
 312         ns_t_eid = 31,          /*%< Endpoint identifier. */
 313         ns_t_nimloc = 32,       /*%< Nimrod Locator. */
 314         ns_t_srv = 33,          /*%< Server Selection. */
 315         ns_t_atma = 34,         /*%< ATM Address */
 316         ns_t_naptr = 35,        /*%< Naming Authority PoinTeR */
 317         ns_t_kx = 36,           /*%< Key Exchange */
 318         ns_t_cert = 37,         /*%< Certification record */
 319         ns_t_a6 = 38,           /*%< IPv6 address (experimental) */
 320         ns_t_dname = 39,        /*%< Non-terminal DNAME */
 321         ns_t_sink = 40,         /*%< Kitchen sink (experimentatl) */
 322         ns_t_opt = 41,          /*%< EDNS0 option (meta-RR) */
 323         ns_t_apl = 42,          /*%< Address prefix list (RFC3123) */
 324         ns_t_ds = 43,           /*%< Delegation Signer */
 325         ns_t_sshfp = 44,        /*%< SSH Fingerprint */
 326         ns_t_ipseckey = 45,     /*%< IPSEC Key */
 327         ns_t_rrsig = 46,        /*%< RRset Signature */
 328         ns_t_nsec = 47,         /*%< Negative security */
 329         ns_t_dnskey = 48,       /*%< DNS Key */
 330         ns_t_dhcid = 49,        /*%< Dynamic host configuratin identifier */
 331         ns_t_nsec3 = 50,        /*%< Negative security type 3 */
 332         ns_t_nsec3param = 51,   /*%< Negative security type 3 parameters */
 333         ns_t_hip = 55,          /*%< Host Identity Protocol */
 334         ns_t_spf = 99,          /*%< Sender Policy Framework */
 335         ns_t_tkey = 249,        /*%< Transaction key */
 336         ns_t_tsig = 250,        /*%< Transaction signature. */
 337         ns_t_ixfr = 251,        /*%< Incremental zone transfer. */
 338         ns_t_axfr = 252,        /*%< Transfer zone of authority. */
 339         ns_t_mailb = 253,       /*%< Transfer mailbox records. */
 340         ns_t_maila = 254,       /*%< Transfer mail agent records. */
 341         ns_t_any = 255,         /*%< Wildcard match. */
 342         ns_t_zxfr = 256,        /*%< BIND-specific, nonstandard. */
 343         ns_t_dlv = 32769,       /*%< DNSSEC look-aside validatation. */
 344         ns_t_max = 65536
 345 } ns_type;
 346
 347 /* Exclusively a QTYPE? (not also an RTYPE) */
 348 #define ns_t_qt_p(t) (ns_t_xfr_p(t) || (t) == ns_t_any || \
 349                       (t) == ns_t_mailb || (t) == ns_t_maila)
 350 /* Some kind of meta-RR? (not a QTYPE, but also not an RTYPE) */
 351 #define ns_t_mrr_p(t) ((t) == ns_t_tsig || (t) == ns_t_opt)
 352 /* Exclusively an RTYPE? (not also a QTYPE or a meta-RR) */
 353 #define ns_t_rr_p(t) (!ns_t_qt_p(t) && !ns_t_mrr_p(t))
 354 #define ns_t_udp_p(t) ((t) != ns_t_axfr && (t) != ns_t_zxfr)
 355 #define ns_t_xfr_p(t) ((t) == ns_t_axfr || (t) == ns_t_ixfr || \
 356                        (t) == ns_t_zxfr)
 357
 358 /*%
 359  * Values for class field
 360  */
 361 typedef enum __ns_class {
 362         ns_c_invalid = 0,       /*%< Cookie. */
 363         ns_c_in = 1,            /*%< Internet. */
 364         ns_c_2 = 2,             /*%< unallocated/unsupported. */
 365         ns_c_chaos = 3,         /*%< MIT Chaos-net. */
 366         ns_c_hs = 4,            /*%< MIT Hesiod. */
 367         /* Query class values which do not appear in resource records */
 368         ns_c_none = 254,        /*%< for prereq. sections in update requests */
 369         ns_c_any = 255,         /*%< Wildcard match. */
 370         ns_c_max = 65536
 371 } ns_class;
 372
 373 /* DNSSEC constants. */
 374
 375 typedef enum __ns_key_types {
 376         ns_kt_rsa = 1,          /*%< key type RSA/MD5 */
 377         ns_kt_dh  = 2,          /*%< Diffie Hellman */
 378         ns_kt_dsa = 3,          /*%< Digital Signature Standard (MANDATORY) */
 379         ns_kt_private = 254     /*%< Private key type starts with OID */
 380 } ns_key_types;
 381
 382 typedef enum __ns_cert_types {
 383         cert_t_pkix = 1,        /*%< PKIX (X.509v3) */
 384         cert_t_spki = 2,        /*%< SPKI */
 385         cert_t_pgp  = 3,        /*%< PGP */
 386         cert_t_url  = 253,      /*%< URL private type */
 387         cert_t_oid  = 254       /*%< OID private type */
 388 } ns_cert_types;
 389
 390 /* Flags field of the KEY RR rdata. */
 391 #define NS_KEY_TYPEMASK         0xC000  /*%< Mask for "type" bits */
 392 #define NS_KEY_TYPE_AUTH_CONF   0x0000  /*%< Key usable for both */
 393 #define NS_KEY_TYPE_CONF_ONLY   0x8000  /*%< Key usable for confidentiality */
 394 #define NS_KEY_TYPE_AUTH_ONLY   0x4000  /*%< Key usable for authentication */
 395 #define NS_KEY_TYPE_NO_KEY      0xC000  /*%< No key usable for either; no key */
 396 /* The type bits can also be interpreted independently, as single bits: */
 397 #define NS_KEY_NO_AUTH          0x8000  /*%< Key unusable for authentication */
 398 #define NS_KEY_NO_CONF          0x4000  /*%< Key unusable for confidentiality */
 399 #define NS_KEY_RESERVED2        0x2000  /* Security is *mandatory* if bit=0 */
 400 #define NS_KEY_EXTENDED_FLAGS   0x1000  /*%< reserved - must be zero */
 401 #define NS_KEY_RESERVED4        0x0800  /*%< reserved - must be zero */
 402 #define NS_KEY_RESERVED5        0x0400  /*%< reserved - must be zero */
 403 #define NS_KEY_NAME_TYPE        0x0300  /*%< these bits determine the type */
 404 #define NS_KEY_NAME_USER        0x0000  /*%< key is assoc. with user */
 405 #define NS_KEY_NAME_ENTITY      0x0200  /*%< key is assoc. with entity eg host */
 406 #define NS_KEY_NAME_ZONE        0x0100  /*%< key is zone key */
 407 #define NS_KEY_NAME_RESERVED    0x0300  /*%< reserved meaning */
 408 #define NS_KEY_RESERVED8        0x0080  /*%< reserved - must be zero */
 409 #define NS_KEY_RESERVED9        0x0040  /*%< reserved - must be zero */
 410 #define NS_KEY_RESERVED10       0x0020  /*%< reserved - must be zero */
 411 #define NS_KEY_RESERVED11       0x0010  /*%< reserved - must be zero */
 412 #define NS_KEY_SIGNATORYMASK    0x000F  /*%< key can sign RR's of same name */
 413 #define NS_KEY_RESERVED_BITMASK ( NS_KEY_RESERVED2 | \
 414                                   NS_KEY_RESERVED4 | \
 415                                   NS_KEY_RESERVED5 | \
 416                                   NS_KEY_RESERVED8 | \
 417                                   NS_KEY_RESERVED9 | \
 418                                   NS_KEY_RESERVED10 | \
 419                                   NS_KEY_RESERVED11 )
 420 #define NS_KEY_RESERVED_BITMASK2 0xFFFF /*%< no bits defined here */
 421 /* The Algorithm field of the KEY and SIG RR's is an integer, {1..254} */
 422 #define NS_ALG_MD5RSA           1       /*%< MD5 with RSA */
 423 #define NS_ALG_DH               2       /*%< Diffie Hellman KEY */
 424 #define NS_ALG_DSA              3       /*%< DSA KEY */
 425 #define NS_ALG_DSS              NS_ALG_DSA
 426 #define NS_ALG_EXPIRE_ONLY      253     /*%< No alg, no security */
 427 #define NS_ALG_PRIVATE_OID      254     /*%< Key begins with OID giving alg */
 428 /* Protocol values  */
 429 /* value 0 is reserved */
 430 #define NS_KEY_PROT_TLS         1
 431 #define NS_KEY_PROT_EMAIL       2
 432 #define NS_KEY_PROT_DNSSEC      3
 433 #define NS_KEY_PROT_IPSEC       4
 434 #define NS_KEY_PROT_ANY         255
 435
 436 /* Signatures */
 437 #define NS_MD5RSA_MIN_BITS       512    /*%< Size of a mod or exp in bits */
 438 #define NS_MD5RSA_MAX_BITS      4096
 439         /* Total of binary mod and exp */
 440 #define NS_MD5RSA_MAX_BYTES     ((NS_MD5RSA_MAX_BITS+7/8)*2+3)
 441         /* Max length of text sig block */
 442 #define NS_MD5RSA_MAX_BASE64    (((NS_MD5RSA_MAX_BYTES+2)/3)*4)
 443 #define NS_MD5RSA_MIN_SIZE      ((NS_MD5RSA_MIN_BITS+7)/8)
 444 #define NS_MD5RSA_MAX_SIZE      ((NS_MD5RSA_MAX_BITS+7)/8)
 445
 446 #define NS_DSA_SIG_SIZE         41
 447 #define NS_DSA_MIN_SIZE         213
 448 #define NS_DSA_MAX_BYTES        405
 449
 450 /* Offsets into SIG record rdata to find various values */
 451 #define NS_SIG_TYPE     0       /*%< Type flags */
 452 #define NS_SIG_ALG      2       /*%< Algorithm */
 453 #define NS_SIG_LABELS   3       /*%< How many labels in name */
 454 #define NS_SIG_OTTL     4       /*%< Original TTL */
 455 #define NS_SIG_EXPIR    8       /*%< Expiration time */
 456 #define NS_SIG_SIGNED   12      /*%< Signature time */
 457 #define NS_SIG_FOOT     16      /*%< Key footprint */
 458 #define NS_SIG_SIGNER   18      /*%< Domain name of who signed it */
 459 /* How RR types are represented as bit-flags in NXT records */
 460 #define NS_NXT_BITS 8
 461 #define NS_NXT_BIT_SET(  n,p) (p[(n)/NS_NXT_BITS] |=  (0x80>>((n)%NS_NXT_BITS)))
 462 #define NS_NXT_BIT_CLEAR(n,p) (p[(n)/NS_NXT_BITS] &= ~(0x80>>((n)%NS_NXT_BITS)))
 463 #define NS_NXT_BIT_ISSET(n,p) (p[(n)/NS_NXT_BITS] &   (0x80>>((n)%NS_NXT_BITS)))
 464 #define NS_NXT_MAX 127
 465
 466 /*%
 467  * EDNS0 extended flags and option codes, host order.
 468  */
 469 #define NS_OPT_DNSSEC_OK        0x8000U
 470 #define NS_OPT_NSID             3
 471
 472 /*%
 473  * Inline versions of get/put short/long.  Pointer is advanced.
 474  */
 475 #define NS_GET16(s, cp) do { \
 476         register const u_char *t_cp = (const u_char *)(cp); \
 477         (s) = ((u_int16_t)t_cp[0] << 8) \
 478             | ((u_int16_t)t_cp[1]) \
 479             ; \
 480         (cp) += NS_INT16SZ; \
 481 } while (0)
 482
 483 #define NS_GET32(l, cp) do { \
 484         register const u_char *t_cp = (const u_char *)(cp); \
 485         (l) = ((u_int32_t)t_cp[0] << 24) \
 486             | ((u_int32_t)t_cp[1] << 16) \
 487             | ((u_int32_t)t_cp[2] << 8) \
 488             | ((u_int32_t)t_cp[3]) \
 489             ; \
 490         (cp) += NS_INT32SZ; \
 491 } while (0)
 492
 493 #define NS_PUT16(s, cp) do { \
 494         register u_int16_t t_s = (u_int16_t)(s); \
 495         register u_char *t_cp = (u_char *)(cp); \
 496         *t_cp++ = t_s >> 8; \
 497         *t_cp   = t_s; \
 498         (cp) += NS_INT16SZ; \
 499 } while (0)
 500
 501 #define NS_PUT32(l, cp) do { \
 502         register u_int32_t t_l = (u_int32_t)(l); \
 503         register u_char *t_cp = (u_char *)(cp); \
 504         *t_cp++ = t_l >> 24; \
 505         *t_cp++ = t_l >> 16; \
 506         *t_cp++ = t_l >> 8; \
 507         *t_cp   = t_l; \
 508         (cp) += NS_INT32SZ; \
 509 } while (0)
 510
 511 /*%
 512  * ANSI C identifier hiding for bind's lib/nameser.
 513  */
 514 #define ns_msg_getflag          __ns_msg_getflag
 515 #define ns_get16                __ns_get16
 516 #define ns_get32                __ns_get32
 517 #define ns_put16                __ns_put16
 518 #define ns_put32                __ns_put32
 519 #define ns_initparse            __ns_initparse
 520 #define ns_skiprr               __ns_skiprr
 521 #define ns_parserr              __ns_parserr
 522 #define ns_parserr2             __ns_parserr2
 523 #define ns_sprintrr             __ns_sprintrr
 524 #define ns_sprintrrf            __ns_sprintrrf
 525 #define ns_format_ttl           __ns_format_ttl
 526 #define ns_parse_ttl            __ns_parse_ttl
 527 #if 0
 528 #define ns_datetosecs           __ns_datetosecs
 529 #endif
 530 #define ns_name_ntol            __ns_name_ntol
 531 #define ns_name_ntop            __ns_name_ntop
 532 #define ns_name_pton            __ns_name_pton
 533 #define ns_name_pton2           __ns_name_pton2
 534 #define ns_name_unpack          __ns_name_unpack
 535 #define ns_name_unpack2         __ns_name_unpack2
 536 #define ns_name_pack            __ns_name_pack
 537 #define ns_name_compress        __ns_name_compress
 538 #define ns_name_uncompress      __ns_name_uncompress
 539 #define ns_name_skip            __ns_name_skip
 540 #define ns_name_rollback        __ns_name_rollback
 541 #define ns_name_length          __ns_name_length
 542 #define ns_name_eq              __ns_name_eq
 543 #define ns_name_owned           __ns_name_owned
 544 #define ns_name_map             __ns_name_map
 545 #define ns_name_labels          __ns_name_labels
 546 #if 0
 547 #define ns_sign                 __ns_sign
 548 #define ns_sign2                __ns_sign2
 549 #define ns_sign_tcp             __ns_sign_tcp
 550 #define ns_sign_tcp2            __ns_sign_tcp2
 551 #define ns_sign_tcp_init        __ns_sign_tcp_init
 552 #define ns_find_tsig            __ns_find_tsig
 553 #define ns_verify               __ns_verify
 554 #define ns_verify_tcp           __ns_verify_tcp
 555 #define ns_verify_tcp_init      __ns_verify_tcp_init
 556 #endif
 557 #define ns_samedomain           __ns_samedomain
 558 #if 0
 559 #define ns_subdomain            __ns_subdomain
 560 #endif
 561 #define ns_makecanon            __ns_makecanon
 562 #define ns_samename             __ns_samename
 563
 564 __BEGIN_DECLS
 565 int             ns_msg_getflag(ns_msg, int);
 566 u_int           ns_get16(const u_char *);
 567 u_long          ns_get32(const u_char *);
 568 void            ns_put16(u_int, u_char *);
 569 void            ns_put32(u_long, u_char *);
 570 int             ns_initparse(const u_char *, int, ns_msg *);
 571 int             ns_skiprr(const u_char *, const u_char *, ns_sect, int);
 572 int             ns_parserr(ns_msg *, ns_sect, int, ns_rr *);
 573 int             ns_parserr2(ns_msg *, ns_sect, int, ns_rr2 *);
 574 int             ns_sprintrr(const ns_msg *, const ns_rr *,
 575                             const char *, const char *, char *, size_t);
 576 int             ns_sprintrrf(const u_char *, size_t, const char *,
 577                              ns_class, ns_type, u_long, const u_char *,
 578                              size_t, const char *, const char *,
 579                              char *, size_t);
 580 int             ns_format_ttl(u_long, char *, size_t);
 581 int             ns_parse_ttl(const char *, u_long *);
 582 #if 0
 583 u_int32_t       ns_datetosecs(const char *cp, int *errp);
 584 #endif
 585 int             ns_name_ntol(const u_char *, u_char *, size_t);
 586 int             ns_name_ntop(const u_char *, char *, size_t);
 587 int             ns_name_pton(const char *, u_char *, size_t);
 588 int             ns_name_pton2(const char *, u_char *, size_t, size_t *);
 589 int             ns_name_unpack(const u_char *, const u_char *,
 590                                const u_char *, u_char *, size_t);
 591 int             ns_name_unpack2(const u_char *, const u_char *,
 592                                 const u_char *, u_char *, size_t,
 593                                 size_t *);
 594 int             ns_name_pack(const u_char *, u_char *, int,
 595                              const u_char **, const u_char **);
 596 int             ns_name_uncompress(const u_char *, const u_char *,
 597                                    const u_char *, char *, size_t);
 598 int             ns_name_compress(const char *, u_char *, size_t,
 599                                  const u_char **, const u_char **);
 600 int             ns_name_skip(const u_char **, const u_char *);
 601 void            ns_name_rollback(const u_char *, const u_char **,
 602                                  const u_char **);
 603 ssize_t         ns_name_length(ns_nname_ct, size_t);
 604 int             ns_name_eq(ns_nname_ct, size_t, ns_nname_ct, size_t);
 605 int             ns_name_owned(ns_namemap_ct, int, ns_namemap_ct, int);
 606 int             ns_name_map(ns_nname_ct, size_t, ns_namemap_t, int);
 607 int             ns_name_labels(ns_nname_ct, size_t);
 608 #if 0
 609 int             ns_sign(u_char *, int *, int, int, void *,
 610                         const u_char *, int, u_char *, int *, time_t);
 611 int             ns_sign2(u_char *, int *, int, int, void *,
 612                          const u_char *, int, u_char *, int *, time_t,
 613                          u_char **, u_char **);
 614 int             ns_sign_tcp(u_char *, int *, int, int,
 615                             ns_tcp_tsig_state *, int);
 616 int             ns_sign_tcp2(u_char *, int *, int, int,
 617                              ns_tcp_tsig_state *, int,
 618                              u_char **, u_char **);
 619 int             ns_sign_tcp_init(void *, const u_char *, int,
 620                                  ns_tcp_tsig_state *);
 621 u_char          *ns_find_tsig(u_char *, u_char *);
 622 int             ns_verify(u_char *, int *, void *,
 623                           const u_char *, int, u_char *, int *,
 624                           time_t *, int);
 625 int             ns_verify_tcp(u_char *, int *, ns_tcp_tsig_state *, int);
 626 int             ns_verify_tcp_init(void *, const u_char *, int,
 627                                    ns_tcp_tsig_state *);
 628 #endif
 629 int             ns_samedomain(const char *, const char *);
 630 #if 0
 631 int             ns_subdomain(const char *, const char *);
 632 #endif
 633 int             ns_makecanon(const char *, char *, size_t);
 634 int             ns_samename(const char *, const char *);
 635 __END_DECLS
 636
 637 #ifdef BIND_4_COMPAT
 638 #include <arpa/nameser_compat.h>
 639 #endif
 640
 641 #endif /* !_ARPA_NAMESER_H_ */
 642 /*! \file */