NAME ares_timeout – return maximum time to wait SYNOPSIS #include <ares.h> struct timeval *ares_timeout(ares_channel channel, DESCRIPTION The ares_timeout function determines the maximum time for which the caller should wait before invoking ares_process(3) to process timeouts. The parameter maxtv specifies a existing maximum timeout, or NULL if the caller does not wish to apply a maximum…
NAME ares_strerror – Get the description of an ares library error code SYNOPSIS #include <ares.h> const char *ares_strerror(int code) DESCRIPTION The ares_strerror function gets the description of the ares library error code code, returning the result as a NUL-terminated C string. NOTES This function is not compatible with ares, it takes a different set of…
NAME ares_set_socket_callback – Set a socket creation callback SYNOPSIS #include <ares.h> void ares_set_socket_callback(ares_channel channel, ares_sock_create_callback callback, void *userdata) cc file.c – lcares DESCRIPTION This function sets a callback in the given ares channel handle. This callback function will be invoked after the socket has been created, and connected to the remote server. The callback must…
NAME ares_set_servers – Initialize an ares_channel name servers configuration SYNOPSIS #include <ares.h> int ares_set_servers(ares_channel channel, struct ares_addr_node *servers) DESCRIPTION The ares_set_servers(3) function initializes name servers configuration for the channel data identified by channel, from a servers pointer to a linked list of ares_addr_node structs holding name servers address data. The name server linked list pointer…
NAME ares_send – Initiate a DNS query SYNOPSIS #include <ares.h> typedef void (*ares_callback)(void *arg, int status, void ares_send(ares_channel channel, const unsigned char *qbuf, int qlen, ares_callback callback, void *arg) DESCRIPTION The ares_send function initiates a DNS query on the name service channel identified by channel. The parameters qbuf and qlen give the DNS query, which…
NAME ares_search – Initiate a DNS query with domain search SYNOPSIS #include <ares.h> typedef void (*ares_callback)(void *arg, int status, void ares_search(ares_channel channel, const char *name, int dnsclass, int type, ares_callback callback, DESCRIPTION The ares_search function initiates a series of single-question DNS queries on the name service channel identified by channel, using the channel’s search domains…
NAME ares_save_options – Save configuration values obtained from initialized ares_channel SYNOPSIS #include <ares.h> int ares_save_options(ares_channel channel, struct ares_options *options, int *optmask) DESCRIPTION The ares_save_options(3) function saves the channel data identified by channel, into the options struct identified by options, and saves the mask of options which are set to the integer pointer (passed by reference)…
NAME ares_query – Initiate a single-question DNS query SYNOPSIS #include <ares.h> typedef void (*ares_callback)(void *arg, int status, void ares_query(ares_channel channel, const char *name, int dnsclass, int type, ares_callback callback, DESCRIPTION The ares_query function initiates a single-question DNS query on the name service channel identified by channel. The parameter name gives the query name as a…
NAME ares_process – Process events for name resolution SYNOPSIS #include <ares.h> void ares_process(ares_channel channel, fd_set *read_fds, void ares_process_fd(ares_channel channel, ares_socket_t read_fd, DESCRIPTION The ares_process(3) function handles input/output events and timeouts associated with queries pending on the name service channel identified by channel. The file descriptor sets pointed to by read_fds and write_fds should have file…
NAME ares_parse_txt_reply – Parse a reply to a DNS query of type TXT SYNOPSIS #include <ares.h> int ares_parse_txt_reply(const unsigned char *abuf, int alen, struct ares_txt_reply **txt_out); DESCRIPTION The ares_parse_txt_reply function parses the response to a query of type TXT into a linked list (one element per sub-string) of struct ares_txt_reply The parameters abuf and alen…
NAME ares_parse_srv_reply – Parse a reply to a DNS query of type SRV SYNOPSIS #include <ares.h> int ares_parse_srv_reply(const unsigned char *abuf, int alen, struct ares_srv_reply **srv_out); DESCRIPTION The ares_parse_srv_reply function parses the response to a query of type SRV into a linked list of struct ares_srv_reply The parameters abuf and alen give the contents of…
NAME ares_parse_soa_reply – Parse a reply to a DNS query of type SOA SYNOPSIS #include <ares.h> int ares_parse_soa_reply(const unsigned char* abuf, int alen, DESCRIPTION The ares_parse_soa_reply function parses the response to a query of type SOA into a struct ares_soa_reply. The parameters abuf and alen give the contents of the response. The result is stored…
NAME ares_parse_ptr_reply – Parse a reply to a DNS query of type PTR into a hostent SYNOPSIS #include <ares.h> int ares_parse_ptr_reply(const unsigned char *abuf, int alen, const void *addr, int addrlen, int family, DESCRIPTION The ares_parse_ptr_reply function parses the response to a query of type PTR into a struct hostent. The parameters abuf and alen…
NAME ares_parse_ns_reply – Parse a reply to a DNS query of type NS into a hostent SYNOPSIS #include <ares.h> int ares_parse_ns_reply(const unsigned char *abuf, int alen, struct hostent **host); DESCRIPTION The ares_parse_ns_reply function parses the response to a query of type NS into a struct hostent. The parameters abuf and alen give the contents of…
NAME ares_parse_naptr_reply – Parse a reply to a DNS query of type NAPTR SYNOPSIS #include <ares.h> int ares_parse_naptr_reply(const unsigned char *abuf, int alen, struct ares_naptr_reply **naptr_out); DESCRIPTION The ares_parse_naptr_reply function parses the response to a query of type NAPTR into a linked list of struct ares_naptr_reply The parameters abuf and alen give the contents of…
NAME ares_parse_mx_reply – Parse a reply to a DNS query of type MX SYNOPSIS #include <ares.h> int ares_parse_mx_reply(const unsigned char *abuf, int alen, struct ares_mx_reply **mx_out); DESCRIPTION The ares_parse_mx_reply function parses the response to a query of type MX into a linked list of struct ares_mx_reply The parameters abuf and alen give the contents of…
NAME ares_parse_aaaa_reply – Parse a reply to a DNS query of type AAAA SYNOPSIS #include <ares.h> int ares_parse_aaaa_reply(const unsigned char *abuf, int alen, struct hostent **host, struct ares_addr6ttl *addrttls, int *naddrttls); DESCRIPTION The ares_parse_aaaa_reply function parses the response to a query of type AAAA into a struct hostent and/or an array of struct ares_addr6ttl. The…
NAME ares_parse_a_reply – Parse a reply to a DNS query of type A SYNOPSIS #include <ares.h> int ares_parse_a_reply(const unsigned char *abuf, int alen, struct hostent **host, struct ares_addrttl *addrttls, int *naddrttls); DESCRIPTION The ares_parse_a_reply function parses the response to a query of type A into a struct hostent and/or an array of struct ares_addrttls. The…
NAME ares_mkquery – Compose a single-question DNS query buffer SYNOPSIS #include <ares.h> int ares_mkquery(const char *name, int dnsclass, int type, DESCRIPTION Deprecated function. See ares_create_query(3) instead! The ares_mkquery function composes a DNS query with a single question. The parameter name gives the query name as a NUL-terminated C string of period-separated labels optionally ending with…
NAME ares_library_init – c-ares library initialization SYNOPSIS #include <ares.h> int ares_library_init(int flags) cc file.c – lcares DESCRIPTION The ares_library_init function performs initializations internally required by the c-ares library that must take place before any other function provided by c-ares can be used in a program. This function must be called at least once within the…