Spaces:
Sleeping
Sleeping
/* Copyright 1998 by the Massachusetts Institute of Technology. | |
* Copyright (C) 2007-2013 by Daniel Stenberg | |
* | |
* Permission to use, copy, modify, and distribute this | |
* software and its documentation for any purpose and without | |
* fee is hereby granted, provided that the above copyright | |
* notice appear in all copies and that both that copyright | |
* notice and this permission notice appear in supporting | |
* documentation, and that the name of M.I.T. not be used in | |
* advertising or publicity pertaining to distribution of the | |
* software without specific, written prior permission. | |
* M.I.T. makes no representations about the suitability of | |
* this software for any purpose. It is provided "as is" | |
* without express or implied warranty. | |
*/ | |
/* | |
* Define WIN32 when build target is Win32 API | |
*/ | |
/* HP-UX systems version 9, 10 and 11 lack sys/select.h and so does oldish | |
libc5-based Linux systems. Only include it on system that are known to | |
require it! */ | |
/* To aid with linking against a static c-ares build, lets tell the microsoft | |
* compiler to pull in needed dependencies */ | |
extern "C" { | |
/* | |
** c-ares external API function linkage decorations. | |
*/ | |
/* Server error codes (ARES_ENODATA indicates no relevant answer) */ | |
/* Locally generated error codes */ | |
/* ares_getnameinfo error codes */ | |
/* ares_getaddrinfo error codes */ | |
/* Uninitialized library error code */ | |
/* ares_library_init error codes */ | |
/* More error codes */ | |
/* More ares_getaddrinfo error codes */ | |
/* Flag values */ | |
/* Option mask values */ | |
/* Nameinfo flag values */ | |
/* Reserved for future use */ | |
/* Addrinfo flag values */ | |
/* Reserved for future use */ | |
/* c-ares library initialization flag values */ | |
/* | |
* Typedef our socket type | |
*/ | |
typedef SOCKET ares_socket_t; | |
typedef int ares_socket_t; | |
typedef void (*ares_sock_state_cb)(void *data, | |
ares_socket_t socket_fd, | |
int readable, | |
int writable); | |
struct apattern; | |
/* NOTE about the ares_options struct to users and developers. | |
This struct will remain looking like this. It will not be extended nor | |
shrunk in future releases, but all new options will be set by ares_set_*() | |
options instead of with the ares_init_options() function. | |
Eventually (in a galaxy far far away), all options will be settable by | |
ares_set_*() options and the ares_init_options() function will become | |
deprecated. | |
When new options are added to c-ares, they are not added to this | |
struct. And they are not "saved" with the ares_save_options() function but | |
instead we encourage the use of the ares_dup() function. Needless to say, | |
if you add config options to c-ares you need to make sure ares_dup() | |
duplicates this new option. | |
*/ | |
struct ares_options { | |
int flags; | |
int timeout; /* in seconds or milliseconds, depending on options */ | |
int tries; | |
int ndots; | |
unsigned short udp_port; | |
unsigned short tcp_port; | |
int socket_send_buffer_size; | |
int socket_receive_buffer_size; | |
struct in_addr *servers; | |
int nservers; | |
char **domains; | |
int ndomains; | |
char *lookups; | |
ares_sock_state_cb sock_state_cb; | |
void *sock_state_cb_data; | |
struct apattern *sortlist; | |
int nsort; | |
int ednspsz; | |
char *resolvconf_path; | |
char *hosts_path; | |
}; | |
struct hostent; | |
struct timeval; | |
struct sockaddr; | |
struct ares_channeldata; | |
struct ares_addrinfo; | |
struct ares_addrinfo_hints; | |
typedef struct ares_channeldata *ares_channel; | |
typedef void (*ares_callback)(void *arg, | |
int status, | |
int timeouts, | |
unsigned char *abuf, | |
int alen); | |
typedef void (*ares_host_callback)(void *arg, | |
int status, | |
int timeouts, | |
struct hostent *hostent); | |
typedef void (*ares_nameinfo_callback)(void *arg, | |
int status, | |
int timeouts, | |
char *node, | |
char *service); | |
typedef int (*ares_sock_create_callback)(ares_socket_t socket_fd, | |
int type, | |
void *data); | |
typedef int (*ares_sock_config_callback)(ares_socket_t socket_fd, | |
int type, | |
void *data); | |
typedef void (*ares_addrinfo_callback)(void *arg, | |
int status, | |
int timeouts, | |
struct ares_addrinfo *res); | |
CARES_EXTERN int ares_library_init(int flags); | |
CARES_EXTERN int ares_library_init_mem(int flags, | |
void *(*amalloc)(size_t size), | |
void (*afree)(void *ptr), | |
void *(*arealloc)(void *ptr, size_t size)); | |
CARES_EXTERN void ares_library_init_jvm(JavaVM *jvm); | |
CARES_EXTERN int ares_library_init_android(jobject connectivity_manager); | |
CARES_EXTERN int ares_library_android_initialized(void); | |
CARES_EXTERN int ares_library_initialized(void); | |
CARES_EXTERN void ares_library_cleanup(void); | |
CARES_EXTERN const char *ares_version(int *version); | |
CARES_EXTERN int ares_init(ares_channel *channelptr); | |
CARES_EXTERN int ares_init_options(ares_channel *channelptr, | |
struct ares_options *options, | |
int optmask); | |
CARES_EXTERN int ares_save_options(ares_channel channel, | |
struct ares_options *options, | |
int *optmask); | |
CARES_EXTERN void ares_destroy_options(struct ares_options *options); | |
CARES_EXTERN int ares_dup(ares_channel *dest, | |
ares_channel src); | |
CARES_EXTERN void ares_destroy(ares_channel channel); | |
CARES_EXTERN void ares_cancel(ares_channel channel); | |
/* These next 3 configure local binding for the out-going socket | |
* connection. Use these to specify source IP and/or network device | |
* on multi-homed systems. | |
*/ | |
CARES_EXTERN void ares_set_local_ip4(ares_channel channel, unsigned int local_ip); | |
/* local_ip6 should be 16 bytes in length */ | |
CARES_EXTERN void ares_set_local_ip6(ares_channel channel, | |
const unsigned char* local_ip6); | |
/* local_dev_name should be null terminated. */ | |
CARES_EXTERN void ares_set_local_dev(ares_channel channel, | |
const char* local_dev_name); | |
CARES_EXTERN void ares_set_socket_callback(ares_channel channel, | |
ares_sock_create_callback callback, | |
void *user_data); | |
CARES_EXTERN void ares_set_socket_configure_callback(ares_channel channel, | |
ares_sock_config_callback callback, | |
void *user_data); | |
CARES_EXTERN int ares_set_sortlist(ares_channel channel, | |
const char *sortstr); | |
CARES_EXTERN void ares_getaddrinfo(ares_channel channel, | |
const char* node, | |
const char* service, | |
const struct ares_addrinfo_hints* hints, | |
ares_addrinfo_callback callback, | |
void* arg); | |
CARES_EXTERN void ares_freeaddrinfo(struct ares_addrinfo* ai); | |
/* | |
* Virtual function set to have user-managed socket IO. | |
* Note that all functions need to be defined, and when | |
* set, the library will not do any bind nor set any | |
* socket options, assuming the client handles these | |
* through either socket creation or the | |
* ares_sock_config_callback call. | |
*/ | |
struct iovec; | |
struct ares_socket_functions { | |
ares_socket_t(*asocket)(int, int, int, void *); | |
int(*aclose)(ares_socket_t, void *); | |
int(*aconnect)(ares_socket_t, const struct sockaddr *, ares_socklen_t, void *); | |
ares_ssize_t(*arecvfrom)(ares_socket_t, void *, size_t, int, struct sockaddr *, ares_socklen_t *, void *); | |
ares_ssize_t(*asendv)(ares_socket_t, const struct iovec *, int, void *); | |
}; | |
CARES_EXTERN void ares_set_socket_functions(ares_channel channel, | |
const struct ares_socket_functions * funcs, | |
void *user_data); | |
CARES_EXTERN void ares_send(ares_channel channel, | |
const unsigned char *qbuf, | |
int qlen, | |
ares_callback callback, | |
void *arg); | |
CARES_EXTERN void ares_query(ares_channel channel, | |
const char *name, | |
int dnsclass, | |
int type, | |
ares_callback callback, | |
void *arg); | |
CARES_EXTERN void ares_search(ares_channel channel, | |
const char *name, | |
int dnsclass, | |
int type, | |
ares_callback callback, | |
void *arg); | |
CARES_EXTERN void ares_gethostbyname(ares_channel channel, | |
const char *name, | |
int family, | |
ares_host_callback callback, | |
void *arg); | |
CARES_EXTERN int ares_gethostbyname_file(ares_channel channel, | |
const char *name, | |
int family, | |
struct hostent **host); | |
CARES_EXTERN void ares_gethostbyaddr(ares_channel channel, | |
const void *addr, | |
int addrlen, | |
int family, | |
ares_host_callback callback, | |
void *arg); | |
CARES_EXTERN void ares_getnameinfo(ares_channel channel, | |
const struct sockaddr *sa, | |
ares_socklen_t salen, | |
int flags, | |
ares_nameinfo_callback callback, | |
void *arg); | |
CARES_EXTERN int ares_fds(ares_channel channel, | |
fd_set *read_fds, | |
fd_set *write_fds); | |
CARES_EXTERN int ares_getsock(ares_channel channel, | |
ares_socket_t *socks, | |
int numsocks); | |
CARES_EXTERN struct timeval *ares_timeout(ares_channel channel, | |
struct timeval *maxtv, | |
struct timeval *tv); | |
CARES_EXTERN void ares_process(ares_channel channel, | |
fd_set *read_fds, | |
fd_set *write_fds); | |
CARES_EXTERN void ares_process_fd(ares_channel channel, | |
ares_socket_t read_fd, | |
ares_socket_t write_fd); | |
CARES_EXTERN int ares_create_query(const char *name, | |
int dnsclass, | |
int type, | |
unsigned short id, | |
int rd, | |
unsigned char **buf, | |
int *buflen, | |
int max_udp_size); | |
CARES_EXTERN int ares_mkquery(const char *name, | |
int dnsclass, | |
int type, | |
unsigned short id, | |
int rd, | |
unsigned char **buf, | |
int *buflen); | |
CARES_EXTERN int ares_expand_name(const unsigned char *encoded, | |
const unsigned char *abuf, | |
int alen, | |
char **s, | |
long *enclen); | |
CARES_EXTERN int ares_expand_string(const unsigned char *encoded, | |
const unsigned char *abuf, | |
int alen, | |
unsigned char **s, | |
long *enclen); | |
/* | |
* NOTE: before c-ares 1.7.0 we would most often use the system in6_addr | |
* struct below when ares itself was built, but many apps would use this | |
* private version since the header checked a HAVE_* define for it. Starting | |
* with 1.7.0 we always declare and use our own to stop relying on the | |
* system's one. | |
*/ | |
struct ares_in6_addr { | |
union { | |
unsigned char _S6_u8[16]; | |
} _S6_un; | |
}; | |
struct ares_addrttl { | |
struct in_addr ipaddr; | |
int ttl; | |
}; | |
struct ares_addr6ttl { | |
struct ares_in6_addr ip6addr; | |
int ttl; | |
}; | |
struct ares_caa_reply { | |
struct ares_caa_reply *next; | |
int critical; | |
unsigned char *property; | |
size_t plength; /* plength excludes null termination */ | |
unsigned char *value; | |
size_t length; /* length excludes null termination */ | |
}; | |
struct ares_srv_reply { | |
struct ares_srv_reply *next; | |
char *host; | |
unsigned short priority; | |
unsigned short weight; | |
unsigned short port; | |
}; | |
struct ares_mx_reply { | |
struct ares_mx_reply *next; | |
char *host; | |
unsigned short priority; | |
}; | |
struct ares_txt_reply { | |
struct ares_txt_reply *next; | |
unsigned char *txt; | |
size_t length; /* length excludes null termination */ | |
}; | |
/* NOTE: This structure is a superset of ares_txt_reply | |
*/ | |
struct ares_txt_ext { | |
struct ares_txt_ext *next; | |
unsigned char *txt; | |
size_t length; | |
/* 1 - if start of new record | |
* 0 - if a chunk in the same record */ | |
unsigned char record_start; | |
}; | |
struct ares_naptr_reply { | |
struct ares_naptr_reply *next; | |
unsigned char *flags; | |
unsigned char *service; | |
unsigned char *regexp; | |
char *replacement; | |
unsigned short order; | |
unsigned short preference; | |
}; | |
struct ares_soa_reply { | |
char *nsname; | |
char *hostmaster; | |
unsigned int serial; | |
unsigned int refresh; | |
unsigned int retry; | |
unsigned int expire; | |
unsigned int minttl; | |
}; | |
struct ares_uri_reply { | |
struct ares_uri_reply *next; | |
unsigned short priority; | |
unsigned short weight; | |
char *uri; | |
int ttl; | |
}; | |
/* | |
* Similar to addrinfo, but with extra ttl and missing canonname. | |
*/ | |
struct ares_addrinfo_node { | |
int ai_ttl; | |
int ai_flags; | |
int ai_family; | |
int ai_socktype; | |
int ai_protocol; | |
ares_socklen_t ai_addrlen; | |
struct sockaddr *ai_addr; | |
struct ares_addrinfo_node *ai_next; | |
}; | |
/* | |
* alias - label of the resource record. | |
* name - value (canonical name) of the resource record. | |
* See RFC2181 10.1.1. CNAME terminology. | |
*/ | |
struct ares_addrinfo_cname { | |
int ttl; | |
char *alias; | |
char *name; | |
struct ares_addrinfo_cname *next; | |
}; | |
struct ares_addrinfo { | |
struct ares_addrinfo_cname *cnames; | |
struct ares_addrinfo_node *nodes; | |
char *name; | |
}; | |
struct ares_addrinfo_hints { | |
int ai_flags; | |
int ai_family; | |
int ai_socktype; | |
int ai_protocol; | |
}; | |
/* | |
** Parse the buffer, starting at *abuf and of length alen bytes, previously | |
** obtained from an ares_search call. Put the results in *host, if nonnull. | |
** Also, if addrttls is nonnull, put up to *naddrttls IPv4 addresses along with | |
** their TTLs in that array, and set *naddrttls to the number of addresses | |
** so written. | |
*/ | |
CARES_EXTERN int ares_parse_a_reply(const unsigned char *abuf, | |
int alen, | |
struct hostent **host, | |
struct ares_addrttl *addrttls, | |
int *naddrttls); | |
CARES_EXTERN int ares_parse_aaaa_reply(const unsigned char *abuf, | |
int alen, | |
struct hostent **host, | |
struct ares_addr6ttl *addrttls, | |
int *naddrttls); | |
CARES_EXTERN int ares_parse_caa_reply(const unsigned char* abuf, | |
int alen, | |
struct ares_caa_reply** caa_out); | |
CARES_EXTERN int ares_parse_ptr_reply(const unsigned char *abuf, | |
int alen, | |
const void *addr, | |
int addrlen, | |
int family, | |
struct hostent **host); | |
CARES_EXTERN int ares_parse_ns_reply(const unsigned char *abuf, | |
int alen, | |
struct hostent **host); | |
CARES_EXTERN int ares_parse_srv_reply(const unsigned char* abuf, | |
int alen, | |
struct ares_srv_reply** srv_out); | |
CARES_EXTERN int ares_parse_mx_reply(const unsigned char* abuf, | |
int alen, | |
struct ares_mx_reply** mx_out); | |
CARES_EXTERN int ares_parse_txt_reply(const unsigned char* abuf, | |
int alen, | |
struct ares_txt_reply** txt_out); | |
CARES_EXTERN int ares_parse_txt_reply_ext(const unsigned char* abuf, | |
int alen, | |
struct ares_txt_ext** txt_out); | |
CARES_EXTERN int ares_parse_naptr_reply(const unsigned char* abuf, | |
int alen, | |
struct ares_naptr_reply** naptr_out); | |
CARES_EXTERN int ares_parse_soa_reply(const unsigned char* abuf, | |
int alen, | |
struct ares_soa_reply** soa_out); | |
CARES_EXTERN int ares_parse_uri_reply(const unsigned char* abuf, | |
int alen, | |
struct ares_uri_reply** uri_out); | |
CARES_EXTERN void ares_free_string(void *str); | |
CARES_EXTERN void ares_free_hostent(struct hostent *host); | |
CARES_EXTERN void ares_free_data(void *dataptr); | |
CARES_EXTERN const char *ares_strerror(int code); | |
struct ares_addr_node { | |
struct ares_addr_node *next; | |
int family; | |
union { | |
struct in_addr addr4; | |
struct ares_in6_addr addr6; | |
} addr; | |
}; | |
struct ares_addr_port_node { | |
struct ares_addr_port_node *next; | |
int family; | |
union { | |
struct in_addr addr4; | |
struct ares_in6_addr addr6; | |
} addr; | |
int udp_port; | |
int tcp_port; | |
}; | |
CARES_EXTERN int ares_set_servers(ares_channel channel, | |
struct ares_addr_node *servers); | |
CARES_EXTERN int ares_set_servers_ports(ares_channel channel, | |
struct ares_addr_port_node *servers); | |
/* Incomming string format: host[:port][,host[:port]]... */ | |
CARES_EXTERN int ares_set_servers_csv(ares_channel channel, | |
const char* servers); | |
CARES_EXTERN int ares_set_servers_ports_csv(ares_channel channel, | |
const char* servers); | |
CARES_EXTERN int ares_get_servers(ares_channel channel, | |
struct ares_addr_node **servers); | |
CARES_EXTERN int ares_get_servers_ports(ares_channel channel, | |
struct ares_addr_port_node **servers); | |
CARES_EXTERN const char *ares_inet_ntop(int af, const void *src, char *dst, | |
ares_socklen_t size); | |
CARES_EXTERN int ares_inet_pton(int af, const char *src, void *dst); | |
} | |