src/lib/ares_data.h

   1
   2 /* Copyright (C) 2009-2013 by Daniel Stenberg
   3  *
   4  * Permission to use, copy, modify, and distribute this
   5  * software and its documentation for any purpose and without
   6  * fee is hereby granted, provided that the above copyright
   7  * notice appear in all copies and that both that copyright
   8  * notice and this permission notice appear in supporting
   9  * documentation, and that the name of M.I.T. not be used in
  10  * advertising or publicity pertaining to distribution of the
  11  * software without specific, written prior permission.
  12  * M.I.T. makes no representations about the suitability of
  13  * this software for any purpose.  It is provided "as is"
  14  * without express or implied warranty.
  15  */
  16
  17 typedef enum {
  18   ARES_DATATYPE_UNKNOWN = 1,  /* unknown data type     - introduced in 1.7.0 */
  19   ARES_DATATYPE_SRV_REPLY,    /* struct ares_srv_reply - introduced in 1.7.0 */
  20   ARES_DATATYPE_TXT_REPLY,    /* struct ares_txt_reply - introduced in 1.7.0 */
  21   ARES_DATATYPE_TXT_EXT,      /* struct ares_txt_ext   - introduced in 1.11.0 */
  22   ARES_DATATYPE_ADDR_NODE,    /* struct ares_addr_node - introduced in 1.7.1 */
  23   ARES_DATATYPE_MX_REPLY,    /* struct ares_mx_reply   - introduced in 1.7.2 */
  24   ARES_DATATYPE_NAPTR_REPLY,/* struct ares_naptr_reply - introduced in 1.7.6 */
  25   ARES_DATATYPE_SOA_REPLY,    /* struct ares_soa_reply - introduced in 1.9.0 */
  26   ARES_DATATYPE_URI_REPLY,      /* struct ares_uri_reply */
  27 #if 0
  28   ARES_DATATYPE_ADDR6TTL,     /* struct ares_addrttl   */
  29   ARES_DATATYPE_ADDRTTL,      /* struct ares_addr6ttl  */
  30   ARES_DATATYPE_HOSTENT,      /* struct hostent        */
  31   ARES_DATATYPE_OPTIONS,      /* struct ares_options   */
  32 #endif
  33   ARES_DATATYPE_ADDR_PORT_NODE, /* struct ares_addr_port_node - introduced in 1.11.0 */
  34   ARES_DATATYPE_CAA_REPLY,    /* struct ares_caa_reply   - introduced in 1.17 */
  35   ARES_DATATYPE_LAST          /* not used              - introduced in 1.7.0 */
  36 } ares_datatype;
  37
  38 #define ARES_DATATYPE_MARK 0xbead
  39
  40 /*
  41  * ares_data struct definition is internal to c-ares and shall not
  42  * be exposed by the public API in order to allow future changes
  43  * and extensions to it without breaking ABI.  This will be used
  44  * internally by c-ares as the container of multiple types of data
  45  * dynamically allocated for which a reference will be returned
  46  * to the calling application.
  47  *
  48  * c-ares API functions returning a pointer to c-ares internally
  49  * allocated data will actually be returning an interior pointer
  50  * into this ares_data struct.
  51  *
  52  * All this is 'invisible' to the calling application, the only
  53  * requirement is that this kind of data must be free'ed by the
  54  * calling application using ares_free_data() with the pointer
  55  * it has received from a previous c-ares function call.
  56  */
  57
  58 struct ares_data {
  59   ares_datatype type;  /* Actual data type identifier. */
  60   unsigned int  mark;  /* Private ares_data signature. */
  61   union {
  62     struct ares_txt_reply    txt_reply;
  63     struct ares_txt_ext      txt_ext;
  64     struct ares_srv_reply    srv_reply;
  65     struct ares_addr_node    addr_node;
  66     struct ares_addr_port_node  addr_port_node;
  67     struct ares_mx_reply     mx_reply;
  68     struct ares_naptr_reply  naptr_reply;
  69     struct ares_soa_reply    soa_reply;
  70     struct ares_caa_reply    caa_reply;
  71     struct ares_uri_reply    uri_reply;
  72   } data;
  73 };
  74
  75 void *ares_malloc_data(ares_datatype type);
  76