resolv/resolv-internal.h

   1 /* libresolv interfaces for internal use across glibc.
   2    Copyright (C) 2016-2017 Free Software Foundation, Inc.
   3    This file is part of the GNU C Library.
   4
   5    The GNU C Library is free software; you can redistribute it and/or
   6    modify it under the terms of the GNU Lesser General Public
   7    License as published by the Free Software Foundation; either
   8    version 2.1 of the License, or (at your option) any later version.
   9
  10    The GNU C Library is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13    Lesser General Public License for more details.
  14
  15    You should have received a copy of the GNU Lesser General Public
  16    License along with the GNU C Library; if not, see
  17    <http://www.gnu.org/licenses/>.  */
  18
  19 #ifndef _RESOLV_INTERNAL_H
  20 #define _RESOLV_INTERNAL_H 1
  21
  22 #include <resolv.h>
  23 #include <stdbool.h>
  24
  25 /* Resolver flags.  Used for _flags in struct __res_state.  */
  26 #define RES_F_VC        0x00000001 /* Socket is TCP.  */
  27 #define RES_F_CONN      0x00000002 /* Socket is connected.  */
  28 #define RES_F_EDNS0ERR  0x00000004 /* EDNS0 caused errors.  */
  29
  30
  31 /* Internal version of RES_USE_INET6 which does not trigger a
  32    deprecation warning.  */
  33 #define DEPRECATED_RES_USE_INET6 0x00002000
  34
  35 static inline bool
  36 res_use_inet6 (void)
  37 {
  38   return _res.options & DEPRECATED_RES_USE_INET6;
  39 }
  40
  41 enum
  42   {
  43     /* The advertized EDNS buffer size.  The value 1200 is derived
  44        from the IPv6 minimum MTU (1280 bytes) minus some arbitrary
  45        space for tunneling overhead.  If the DNS server does not react
  46        to ICMP Fragmentation Needed But DF Set messages, this should
  47        avoid all UDP fragments on current networks.  Avoiding UDP
  48        fragments is desirable because it prevents fragmentation-based
  49        spoofing attacks because the randomness in a DNS packet is
  50        concentrated in the first fragment (with the headers) and does
  51        not protect subsequent fragments.  */
  52     RESOLV_EDNS_BUFFER_SIZE = 1200,
  53   };
  54
  55 struct resolv_context;
  56
  57 /* Internal function for implementing res_nmkquery and res_mkquery.
  58    Also used by __res_context_query.  */
  59 int __res_context_mkquery (struct resolv_context *, int op, const char *dname,
  60                            int class, int type, const unsigned char *data,
  61                            unsigned char *buf, int buflen) attribute_hidden;
  62
  63 /* Main resolver query function for use within glibc.  */
  64 int __res_context_search (struct resolv_context *, const char *, int, int,
  65                           unsigned char *, int, unsigned char **,
  66                           unsigned char **, int *, int *, int *);
  67 libresolv_hidden_proto (__res_context_search)
  68
  69 /* Main resolver query function for use within glibc.  */
  70 int __res_context_query (struct resolv_context *, const char *, int, int,
  71                          unsigned char *, int, unsigned char **,
  72                          unsigned char **, int *, int *, int *);
  73 libresolv_hidden_proto (__res_context_query)
  74
  75 /* Internal function used to implement the query and search
  76    functions.  */
  77 int __res_context_send (struct resolv_context *, const unsigned char *, int,
  78                         const unsigned char *, int, unsigned char *,
  79                         int, unsigned char **, unsigned char **,
  80                         int *, int *, int *) attribute_hidden;
  81
  82 /* Internal function similar to res_hostalias.  */
  83 const char *__res_context_hostalias (struct resolv_context *,
  84                                      const char *, char *, size_t);
  85 libresolv_hidden_proto (__res_context_hostalias);
  86
  87 /* Add an OPT record to a DNS query.  */
  88 int __res_nopt (struct resolv_context *, int n0,
  89                 unsigned char *buf, int buflen, int anslen) attribute_hidden;
  90
  91 /* Convert from presentation format (which usually means ASCII
  92    printable) to network format (which is usually some kind of binary
  93    format).  The input is in the range [SRC, SRC + SRCLEN).  The
  94    output is written to DST (which has to be 4 or 16 bytes long,
  95    depending on AF).  Return 0 for invalid input, 1 for success, -1
  96    for an invalid address family.  */
  97 int __inet_pton_length (int af, const char *src, size_t srclen, void *);
  98 libc_hidden_proto (__inet_pton_length)
  99
 100 #endif  /* _RESOLV_INTERNAL_H */