src/vnet/dns/dns.h

   1 /*
   2  * Copyright (c) 2017 Cisco and/or its affiliates.
   3  * Licensed under the Apache License, Version 2.0 (the "License");
   4  * you may not use this file except in compliance with the License.
   5  * You may obtain a copy of the License at:
   6  *
   7  *     http://www.apache.org/licenses/LICENSE-2.0
   8  *
   9  * Unless required by applicable law or agreed to in writing, software
  10  * distributed under the License is distributed on an "AS IS" BASIS,
  11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12  * See the License for the specific language governing permissions and
  13  * limitations under the License.
  14  */
  15
  16 #ifndef included_dns_h
  17 #define included_dns_h
  18
  19 #include <vppinfra/time.h>
  20 #include <vppinfra/cache.h>
  21 #include <vppinfra/error.h>
  22
  23 #include <vppinfra/hash.h>
  24 #include <vnet/dns/dns_packet.h>
  25 #include <vnet/ip/ip.h>
  26
  27 typedef struct
  28 {
  29   u32 request_type;
  30   u32 client_index;
  31   u32 client_context;
  32   u8 is_ip6;
  33   u16 dst_port;
  34   u16 id;
  35   u16 pad;
  36   u8 dst_address[16];
  37   u8 *name;
  38 } dns_pending_request_t;
  39
  40 typedef enum
  41 {
  42   DNS_API_PENDING_NAME_TO_IP = 1,
  43   DNS_API_PENDING_IP_TO_NAME,
  44   DNS_PEER_PENDING_NAME_TO_IP,
  45   DNS_PEER_PENDING_IP_TO_NAME,
  46 } dns_pending_request_type_t;
  47
  48 typedef struct
  49 {
  50   /** flags */
  51   volatile u8 flags;
  52
  53   /** The name in "normal human being" notation, e.g. www.foobar.com */
  54   u8 *name;
  55
  56   /** For CNAME records, the "next name" to resolve */
  57   u8 *cname;
  58
  59   /** Expiration time */
  60   f64 expiration_time;
  61
  62   /** Cached dns request, for sending retries */
  63   u8 *dns_request;
  64
  65   /** Retry parameters */
  66   int retry_count;
  67   int server_rotor;
  68   int server_af;
  69   int server_fails;
  70   f64 retry_timer;
  71
  72   /** Cached dns response */
  73   u8 *dns_response;
  74
  75   /** Clients / peers awaiting responses */
  76   dns_pending_request_t *pending_requests;
  77 } dns_cache_entry_t;
  78
  79 #define DNS_CACHE_ENTRY_FLAG_VALID      (1<<0) /**< we have Actual Data */
  80 #define DNS_CACHE_ENTRY_FLAG_STATIC     (1<<1) /**< static entry */
  81 #define DNS_CACHE_ENTRY_FLAG_CNAME      (1<<2) /**< CNAME (indirect) entry */
  82
  83 #define DNS_RETRIES_PER_SERVER 3
  84
  85 #define DNS_RESOLVER_EVENT_RESOLVED     1
  86 #define DNS_RESOLVER_EVENT_PENDING      2
  87
  88
  89 typedef struct
  90 {
  91   /** Pool of cache entries */
  92   dns_cache_entry_t *entries;
  93
  94   /** Pool indices of unresolved entries */
  95   u32 *unresolved_entries;
  96
  97   /** Find cached record by name */
  98   uword *cache_entry_by_name;
  99   uword *cache_lock;
 100
 101   /** enable / disable flag */
 102   int is_enabled;
 103
 104   /** udp port registration complete */
 105   int udp_ports_registered;
 106
 107   /** upstream name servers, e.g. 8.8.8.8 */
 108   ip4_address_t *ip4_name_servers;
 109   ip6_address_t *ip6_name_servers;
 110
 111   /** config parameters */
 112   u32 name_cache_size;
 113   u32 max_ttl_in_seconds;
 114   u32 random_seed;
 115
 116   /* convenience */
 117   vlib_main_t *vlib_main;
 118   vnet_main_t *vnet_main;
 119 } dns_main_t;
 120
 121 extern dns_main_t dns_main;
 122
 123 extern vlib_node_registration_t dns46_reply_node;
 124 extern vlib_node_registration_t dns4_request_node;
 125 extern vlib_node_registration_t dns6_request_node;
 126 extern vlib_node_registration_t dns_resolver_node;
 127
 128 #define foreach_dns46_request_error                                     \
 129 _(NONE, "No error")                                                     \
 130 _(UNIMPLEMENTED, "Unimplemented")                                       \
 131 _(PROCESSED, "DNS request pkts processed")                              \
 132 _(IP_OPTIONS, "DNS pkts with ip options (dropped)")                     \
 133 _(BAD_REQUEST, "DNS pkts with serious discrepanices (dropped)")         \
 134 _(TOO_MANY_REQUESTS, "DNS pkts asking too many questions")              \
 135 _(RESOLUTION_REQUIRED, "DNS pkts pending upstream name resolution")
 136
 137 typedef enum
 138 {
 139 #define _(sym,str) DNS46_REQUEST_ERROR_##sym,
 140   foreach_dns46_request_error
 141 #undef _
 142     DNS46_REQUEST_N_ERROR,
 143 } dns46_request_error_t;
 144
 145 #define foreach_dns46_reply_error                       \
 146 _(DISABLED, "DNS pkts punted (feature disabled)")       \
 147 _(PROCESSED, "DNS reply pkts processed")                \
 148 _(NO_ELT, "No DNS pool element")                        \
 149 _(FORMAT_ERROR, "DNS format errors")                    \
 150 _(TEST_DROP, "DNS reply pkt dropped for test purposes")
 151
 152 typedef enum
 153 {
 154 #define _(sym,str) DNS46_REPLY_ERROR_##sym,
 155   foreach_dns46_reply_error
 156 #undef _
 157     DNS46_REPLY_N_ERROR,
 158 } dns46_reply_error_t;
 159
 160 void vnet_send_dns_request (dns_main_t * dm, dns_cache_entry_t * ep);
 161 int
 162 vnet_dns_cname_indirection_nolock (dns_main_t * dm, u32 ep_index, u8 * reply);
 163
 164 int vnet_dns_delete_entry_by_index_nolock (dns_main_t * dm, u32 index);
 165
 166 int
 167 vnet_dns_resolve_name (dns_main_t * dm, u8 * name, dns_pending_request_t * t,
 168                        dns_cache_entry_t ** retp);
 169
 170 void
 171 vnet_dns_send_dns6_request (dns_main_t * dm,
 172                             dns_cache_entry_t * ep, ip6_address_t * server);
 173 void
 174 vnet_dns_send_dns4_request (dns_main_t * dm,
 175                             dns_cache_entry_t * ep, ip4_address_t * server);
 176
 177 void vnet_send_dns4_reply (dns_main_t * dm, dns_pending_request_t * t,
 178                            dns_cache_entry_t * ep, vlib_buffer_t * b0);
 179
 180 void vnet_send_dns6_reply (dns_main_t * dm, dns_pending_request_t * t,
 181                            dns_cache_entry_t * ep, vlib_buffer_t * b0);
 182
 183 u8 *vnet_dns_labels_to_name (u8 * label, u8 * full_text,
 184                              u8 ** parse_from_here);
 185
 186 format_function_t format_dns_reply;
 187
 188 static inline void
 189 dns_cache_lock (dns_main_t * dm)
 190 {
 191   if (dm->cache_lock)
 192     {
 193       while (clib_atomic_test_and_set (dm->cache_lock))
 194         ;
 195     }
 196 }
 197
 198 static inline void
 199 dns_cache_unlock (dns_main_t * dm)
 200 {
 201   if (dm->cache_lock)
 202     {
 203       CLIB_MEMORY_BARRIER ();
 204       *dm->cache_lock = 0;
 205     }
 206 }
 207
 208 #endif /* included_dns_h */
 209
 210 /*
 211  * fd.io coding-style-patch-verification: ON
 212  *
 213  * Local Variables:
 214  * eval: (c-set-style "gnu")
 215  * End:
 216  */