Blame ares_private.h

Packit 514978
#ifndef __ARES_PRIVATE_H
Packit 514978
#define __ARES_PRIVATE_H
Packit 514978
Packit 514978
Packit 514978
/* Copyright 1998 by the Massachusetts Institute of Technology.
Packit 514978
 * Copyright (C) 2004-2010 by Daniel Stenberg
Packit 514978
 *
Packit 514978
 * Permission to use, copy, modify, and distribute this
Packit 514978
 * software and its documentation for any purpose and without
Packit 514978
 * fee is hereby granted, provided that the above copyright
Packit 514978
 * notice appear in all copies and that both that copyright
Packit 514978
 * notice and this permission notice appear in supporting
Packit 514978
 * documentation, and that the name of M.I.T. not be used in
Packit 514978
 * advertising or publicity pertaining to distribution of the
Packit 514978
 * software without specific, written prior permission.
Packit 514978
 * M.I.T. makes no representations about the suitability of
Packit 514978
 * this software for any purpose.  It is provided "as is"
Packit 514978
 * without express or implied warranty.
Packit 514978
 */
Packit 514978
Packit 514978
/*
Packit 514978
 * Define WIN32 when build target is Win32 API
Packit 514978
 */
Packit 514978
Packit 514978
#if (defined(_WIN32) || defined(__WIN32__)) && !defined(WIN32)
Packit 514978
#define WIN32
Packit 514978
#endif
Packit 514978
Packit 514978
#ifdef HAVE_NETINET_IN_H
Packit 514978
#include <netinet/in.h>
Packit 514978
#endif
Packit 514978
Packit 514978
#ifdef WATT32
Packit 514978
#include <tcp.h>
Packit 514978
#include <sys/ioctl.h>
Packit 514978
#define writev(s,v,c)     writev_s(s,v,c)
Packit 514978
#define HAVE_WRITEV 1
Packit 514978
#endif
Packit 514978
Packit 514978
#define DEFAULT_TIMEOUT         5000 /* milliseconds */
Packit 514978
#define DEFAULT_TRIES           4
Packit 514978
#ifndef INADDR_NONE
Packit 514978
#define INADDR_NONE 0xffffffff
Packit 514978
#endif
Packit 514978
Packit 514978
#ifdef CARES_EXPOSE_STATICS
Packit 514978
/* Make some internal functions visible for testing */
Packit 514978
#define STATIC_TESTABLE
Packit 514978
#else
Packit 514978
#define STATIC_TESTABLE static
Packit 514978
#endif
Packit 514978
Packit 514978
#if defined(WIN32) && !defined(WATT32)
Packit 514978
Packit 514978
#define WIN_NS_9X      "System\\CurrentControlSet\\Services\\VxD\\MSTCP"
Packit 514978
#define WIN_NS_NT_KEY  "System\\CurrentControlSet\\Services\\Tcpip\\Parameters"
Packit 514978
#define WIN_DNSCLIENT  "Software\\Policies\\Microsoft\\System\\DNSClient"
Packit 514978
#define NAMESERVER     "NameServer"
Packit 514978
#define DHCPNAMESERVER "DhcpNameServer"
Packit 514978
#define DATABASEPATH   "DatabasePath"
Packit 514978
#define WIN_PATH_HOSTS  "\\hosts"
Packit 514978
#define SEARCHLIST_KEY "SearchList"
Packit 514978
#define PRIMARYDNSSUFFIX_KEY "PrimaryDNSSuffix"
Packit 514978
#define INTERFACES_KEY "Interfaces"
Packit 514978
#define DOMAIN_KEY     "Domain"
Packit 514978
#define DHCPDOMAIN_KEY "DhcpDomain"
Packit 514978
Packit 514978
#elif defined(WATT32)
Packit 514978
Packit 514978
#define PATH_RESOLV_CONF "/dev/ENV/etc/resolv.conf"
Packit 514978
Packit 514978
#elif defined(NETWARE)
Packit 514978
Packit 514978
#define PATH_RESOLV_CONF "sys:/etc/resolv.cfg"
Packit 514978
#define PATH_HOSTS              "sys:/etc/hosts"
Packit 514978
Packit 514978
#elif defined(__riscos__)
Packit 514978
Packit 514978
#define PATH_HOSTS             "InetDBase:Hosts"
Packit 514978
Packit 514978
#else
Packit 514978
Packit 514978
#define PATH_RESOLV_CONF        "/etc/resolv.conf"
Packit 514978
#ifdef ETC_INET
Packit 514978
#define PATH_HOSTS              "/etc/inet/hosts"
Packit 514978
#else
Packit 514978
#define PATH_HOSTS              "/etc/hosts"
Packit 514978
#endif
Packit 514978
Packit 514978
#endif
Packit 514978
Packit 514978
#define ARES_ID_KEY_LEN 31
Packit 514978
Packit 514978
#include "ares_ipv6.h"
Packit 514978
#include "ares_llist.h"
Packit 514978
Packit 514978
#ifndef HAVE_GETENV
Packit 514978
#  include "ares_getenv.h"
Packit 514978
#  define getenv(ptr) ares_getenv(ptr)
Packit 514978
#endif
Packit 514978
Packit 514978
#include "ares_strdup.h"
Packit 514978
Packit 514978
#ifndef HAVE_STRCASECMP
Packit 514978
#  include "ares_strcasecmp.h"
Packit 514978
#  define strcasecmp(p1,p2) ares_strcasecmp(p1,p2)
Packit 514978
#endif
Packit 514978
Packit 514978
#ifndef HAVE_STRNCASECMP
Packit 514978
#  include "ares_strcasecmp.h"
Packit 514978
#  define strncasecmp(p1,p2,n) ares_strncasecmp(p1,p2,n)
Packit 514978
#endif
Packit 514978
Packit 514978
#ifndef HAVE_WRITEV
Packit 514978
#  include "ares_writev.h"
Packit 514978
#  define writev(s,ptr,cnt) ares_writev(s,ptr,cnt)
Packit 514978
#endif
Packit 514978
Packit 514978
/********* EDNS defines section ******/
Packit 514978
#define EDNSPACKETSZ   1280  /* Reasonable UDP payload size, as suggested
Packit 514978
                                in RFC2671 */
Packit 514978
#define MAXENDSSZ      4096  /* Maximum (local) limit for edns packet size */
Packit 514978
#define EDNSFIXEDSZ    11    /* Size of EDNS header */
Packit 514978
/********* EDNS defines section ******/
Packit 514978
Packit 514978
struct ares_addr {
Packit 514978
  int family;
Packit 514978
  union {
Packit 514978
    struct in_addr       addr4;
Packit 514978
    struct ares_in6_addr addr6;
Packit 514978
  } addr;
Packit 514978
  int udp_port;  /* stored in network order */
Packit 514978
  int tcp_port;  /* stored in network order */
Packit 514978
};
Packit 514978
#define addrV4 addr.addr4
Packit 514978
#define addrV6 addr.addr6
Packit 514978
Packit 514978
struct query;
Packit 514978
Packit 514978
struct send_request {
Packit 514978
  /* Remaining data to send */
Packit 514978
  const unsigned char *data;
Packit 514978
  size_t len;
Packit 514978
Packit 514978
  /* The query for which we're sending this data */
Packit 514978
  struct query* owner_query;
Packit 514978
  /* The buffer we're using, if we have our own copy of the packet */
Packit 514978
  unsigned char *data_storage;
Packit 514978
Packit 514978
  /* Next request in queue */
Packit 514978
  struct send_request *next;
Packit 514978
};
Packit 514978
Packit 514978
struct server_state {
Packit 514978
  struct ares_addr addr;
Packit 514978
  ares_socket_t udp_socket;
Packit 514978
  ares_socket_t tcp_socket;
Packit 514978
Packit 514978
  /* Mini-buffer for reading the length word */
Packit 514978
  unsigned char tcp_lenbuf[2];
Packit 514978
  int tcp_lenbuf_pos;
Packit 514978
  int tcp_length;
Packit 514978
Packit 514978
  /* Buffer for reading actual TCP data */
Packit 514978
  unsigned char *tcp_buffer;
Packit 514978
  int tcp_buffer_pos;
Packit 514978
Packit 514978
  /* TCP output queue */
Packit 514978
  struct send_request *qhead;
Packit 514978
  struct send_request *qtail;
Packit 514978
Packit 514978
  /* Which incarnation of this connection is this? We don't want to
Packit 514978
   * retransmit requests into the very same socket, but if the server
Packit 514978
   * closes on us and we re-open the connection, then we do want to
Packit 514978
   * re-send. */
Packit 514978
  int tcp_connection_generation;
Packit 514978
Packit 514978
  /* Circular, doubly-linked list of outstanding queries to this server */
Packit 514978
  struct list_node queries_to_server;
Packit 514978
Packit 514978
  /* Link back to owning channel */
Packit 514978
  ares_channel channel;
Packit 514978
Packit 514978
  /* Is this server broken? We mark connections as broken when a
Packit 514978
   * request that is queued for sending times out.
Packit 514978
   */
Packit 514978
  int is_broken;
Packit 514978
};
Packit 514978
Packit 514978
/* State to represent a DNS query */
Packit 514978
struct query {
Packit 514978
  /* Query ID from qbuf, for faster lookup, and current timeout */
Packit 514978
  unsigned short qid;
Packit 514978
  struct timeval timeout;
Packit 514978
Packit 514978
  /*
Packit 514978
   * Links for the doubly-linked lists in which we insert a query.
Packit 514978
   * These circular, doubly-linked lists that are hash-bucketed based
Packit 514978
   * the attributes we care about, help making most important
Packit 514978
   * operations O(1).
Packit 514978
   */
Packit 514978
  struct list_node queries_by_qid;    /* hopefully in same cache line as qid */
Packit 514978
  struct list_node queries_by_timeout;
Packit 514978
  struct list_node queries_to_server;
Packit 514978
  struct list_node all_queries;
Packit 514978
Packit 514978
  /* Query buf with length at beginning, for TCP transmission */
Packit 514978
  unsigned char *tcpbuf;
Packit 514978
  int tcplen;
Packit 514978
Packit 514978
  /* Arguments passed to ares_send() (qbuf points into tcpbuf) */
Packit 514978
  const unsigned char *qbuf;
Packit 514978
  int qlen;
Packit 514978
  ares_callback callback;
Packit 514978
  void *arg;
Packit 514978
Packit 514978
  /* Query status */
Packit 514978
  int try_count; /* Number of times we tried this query already. */
Packit 514978
  int server; /* Server this query has last been sent to. */
Packit 514978
  struct query_server_info *server_info;   /* per-server state */
Packit 514978
  int using_tcp;
Packit 514978
  int error_status;
Packit 514978
  int timeouts; /* number of timeouts we saw for this request */
Packit 514978
};
Packit 514978
Packit 514978
/* Per-server state for a query */
Packit 514978
struct query_server_info {
Packit 514978
  int skip_server;  /* should we skip server, due to errors, etc? */
Packit 514978
  int tcp_connection_generation;  /* into which TCP connection did we send? */
Packit 514978
};
Packit 514978
Packit 514978
/* An IP address pattern; matches an IP address X if X & mask == addr */
Packit 514978
#define PATTERN_MASK 0x1
Packit 514978
#define PATTERN_CIDR 0x2
Packit 514978
Packit 514978
struct apattern {
Packit 514978
  union
Packit 514978
  {
Packit 514978
    struct in_addr       addr4;
Packit 514978
    struct ares_in6_addr addr6;
Packit 514978
  } addr;
Packit 514978
  union
Packit 514978
  {
Packit 514978
    struct in_addr       addr4;
Packit 514978
    struct ares_in6_addr addr6;
Packit 514978
    unsigned short       bits;
Packit 514978
  } mask;
Packit 514978
  int family;
Packit 514978
  unsigned short type;
Packit 514978
};
Packit 514978
Packit 514978
typedef struct rc4_key
Packit 514978
{
Packit 514978
  unsigned char state[256];
Packit 514978
  unsigned char x;
Packit 514978
  unsigned char y;
Packit 514978
} rc4_key;
Packit 514978
Packit 514978
struct ares_channeldata {
Packit 514978
  /* Configuration data */
Packit 514978
  int flags;
Packit 514978
  int timeout; /* in milliseconds */
Packit 514978
  int tries;
Packit 514978
  int ndots;
Packit 514978
  int rotate; /* if true, all servers specified are used */
Packit 514978
  int udp_port; /* stored in network order */
Packit 514978
  int tcp_port; /* stored in network order */
Packit 514978
  int socket_send_buffer_size;
Packit 514978
  int socket_receive_buffer_size;
Packit 514978
  char **domains;
Packit 514978
  int ndomains;
Packit 514978
  struct apattern *sortlist;
Packit 514978
  int nsort;
Packit 514978
  char *lookups;
Packit 514978
  int ednspsz;
Packit 514978
Packit 514978
  /* For binding to local devices and/or IP addresses.  Leave
Packit 514978
   * them null/zero for no binding.
Packit 514978
   */
Packit 514978
  char local_dev_name[32];
Packit 514978
  unsigned int local_ip4;
Packit 514978
  unsigned char local_ip6[16];
Packit 514978
Packit 514978
  int optmask; /* the option bitfield passed in at init time */
Packit 514978
Packit 514978
  /* Server addresses and communications state */
Packit 514978
  struct server_state *servers;
Packit 514978
  int nservers;
Packit 514978
Packit 514978
  /* ID to use for next query */
Packit 514978
  unsigned short next_id;
Packit 514978
  /* key to use when generating new ids */
Packit 514978
  rc4_key id_key;
Packit 514978
Packit 514978
  /* Generation number to use for the next TCP socket open/close */
Packit 514978
  int tcp_connection_generation;
Packit 514978
Packit 514978
  /* The time at which we last called process_timeouts(). Uses integer seconds
Packit 514978
     just to draw the line somewhere. */
Packit 514978
  time_t last_timeout_processed;
Packit 514978
Packit 514978
  /* Last server we sent a query to. */
Packit 514978
  int last_server;
Packit 514978
Packit 514978
  /* Circular, doubly-linked list of queries, bucketed various ways.... */
Packit 514978
  /* All active queries in a single list: */
Packit 514978
  struct list_node all_queries;
Packit 514978
  /* Queries bucketed by qid, for quickly dispatching DNS responses: */
Packit 514978
#define ARES_QID_TABLE_SIZE 2048
Packit 514978
  struct list_node queries_by_qid[ARES_QID_TABLE_SIZE];
Packit 514978
  /* Queries bucketed by timeout, for quickly handling timeouts: */
Packit 514978
#define ARES_TIMEOUT_TABLE_SIZE 1024
Packit 514978
  struct list_node queries_by_timeout[ARES_TIMEOUT_TABLE_SIZE];
Packit 514978
Packit 514978
  ares_sock_state_cb sock_state_cb;
Packit 514978
  void *sock_state_cb_data;
Packit 514978
Packit 514978
  ares_sock_create_callback sock_create_cb;
Packit 514978
  void *sock_create_cb_data;
Packit 514978
Packit 514978
  ares_sock_config_callback sock_config_cb;
Packit 514978
  void *sock_config_cb_data;
Packit 514978
Packit 514978
  const struct ares_socket_functions * sock_funcs;
Packit 514978
  void *sock_func_cb_data;
Packit 514978
};
Packit 514978
Packit 514978
/* Memory management functions */
Packit 514978
extern void *(*ares_malloc)(size_t size);
Packit 514978
extern void *(*ares_realloc)(void *ptr, size_t size);
Packit 514978
extern void (*ares_free)(void *ptr);
Packit 514978
Packit 514978
/* return true if now is exactly check time or later */
Packit 514978
int ares__timedout(struct timeval *now,
Packit 514978
                   struct timeval *check);
Packit 514978
Packit 514978
void ares__send_query(ares_channel channel, struct query *query,
Packit 514978
                      struct timeval *now);
Packit 514978
void ares__close_sockets(ares_channel channel, struct server_state *server);
Packit 514978
int ares__get_hostent(FILE *fp, int family, struct hostent **host);
Packit 514978
int ares__read_line(FILE *fp, char **buf, size_t *bufsize);
Packit 514978
void ares__free_query(struct query *query);
Packit 514978
unsigned short ares__generate_new_id(rc4_key* key);
Packit 514978
struct timeval ares__tvnow(void);
Packit 514978
int ares__expand_name_for_response(const unsigned char *encoded,
Packit 514978
                                   const unsigned char *abuf, int alen,
Packit 514978
                                   char **s, long *enclen);
Packit 514978
void ares__init_servers_state(ares_channel channel);
Packit 514978
void ares__destroy_servers_state(ares_channel channel);
Packit 514978
#if 0 /* Not used */
Packit 514978
long ares__tvdiff(struct timeval t1, struct timeval t2);
Packit 514978
#endif
Packit 514978
Packit 514978
void ares__socket_close(ares_channel, ares_socket_t);
Packit 514978
Packit 514978
#define ARES_SWAP_BYTE(a,b) \
Packit 514978
  { unsigned char swapByte = *(a);  *(a) = *(b);  *(b) = swapByte; }
Packit 514978
Packit 514978
#define SOCK_STATE_CALLBACK(c, s, r, w)                                 \
Packit 514978
  do {                                                                  \
Packit 514978
    if ((c)->sock_state_cb)                                             \
Packit 514978
      (c)->sock_state_cb((c)->sock_state_cb_data, (s), (r), (w));       \
Packit 514978
  } WHILE_FALSE
Packit 514978
Packit 514978
#ifdef CURLDEBUG
Packit 514978
/* This is low-level hard-hacking memory leak tracking and similar. Using the
Packit 514978
   libcurl lowlevel code from within library is ugly and only works when
Packit 514978
   c-ares is built and linked with a similarly curldebug-enabled libcurl,
Packit 514978
   but we do this anyway for convenience. */
Packit 514978
#define HEADER_CURL_SETUP_ONCE_H
Packit 514978
#include "../lib/memdebug.h"
Packit 514978
#endif
Packit 514978
Packit 514978
#endif /* __ARES_PRIVATE_H */