Package c-ares-devel

Development files for c-ares

http://c-ares.haxx.se/

This package contains the header files and libraries needed to
compile applications or shared objects that use c-ares.

Library Functions (Section 3)
ares_cancel
The ares_cancel(3) function cancels all lookups/requests made on the the name service channel identified by channel. ares_cancel(3) invokes the callbacks for...
ares_create_query
The ares_create_query(3) function composes a DNS query with a single question. The parameter name gives the query name as a NUL-terminated C string of...
ares_destroy
The ares_destroy(3) function destroys the name service channel identified by channel, freeing all memory and closing all sockets used by the channel...
ares_destroy_options
The ares_destroy_options(3) function destroys the options struct identified by Ioptions, freeing all memory allocated by ares_save_options(3).
ares_dup
The ares_dup(3) function duplicates an existing communications channel for name service lookups. If it returns successfully, ares_dup(3) will set the variable...
ares_expand_name
The ares_expand_name function converts a DNS-encoded domain name to a dot-separated C string. The argument encoded gives the beginning of the encoded domain...
ares_expand_string
The ares_expand_string function converts a length encoded string to a NUL-terminated C string. The argument encoded gives the beginning of the encoded string...
ares_fds
The ares_fds function retrieves the set of file descriptors which the calling application should select on for reading and writing for the processing of name...
ares_free_data
The ares_free_data(3) function frees one or more data structures allocated and returned by several c-ares functions. Specifically the data returned by the...
ares_free_hostent
The ares_free_hostent function frees a struct hostent allocated by one of the functions ares_parse_a_reply(3), ares_parse_aaaa_reply(3), or...
ares_free_string
The ares_free_string(3) function frees a string allocated by an ares function.
ares_gethostbyaddr
The ares_gethostbyaddr function initiates a host query by address on the name service channel identified by channel. The parameters addr and addrlen give the...
ares_gethostbyname
The ares_gethostbyname function initiates a host query by name on the name service channel identified by channel. The parameter name gives the hostname as a...
ares_gethostbyname_file
The ares_gethostbyname_file function performs a host lookup by name against the system's hosts file (or equivalent local hostname database). The channel...
ares_getnameinfo
The ares_getnameinfo function is defined for protocol-independent address translation. The function is a combination of ares_gethostbyaddr(3) and...
ares_get_servers
The ares_get_servers(3) function retrieves name servers configuration from the channel data identified by channel, as a linked list of ares_addr_node structs...
ares_getsock
The ares_getsock function retrieves the set of socket descriptors which the calling application should wait on for reading and/or writing for the processing of...
ares_inet_ntop
This is a portable version with the identical functionality of the commonly available inet_ntop. The ares_inet_ntop() function converts a numeric address into a...
ares_inet_pton
This is a portable version with the identical functionality of the commonly available inet_pton. The ares_inet_pton() function converts the address in its...
ares_init
The ares_init(3) function initializes a communications channel for name service lookups. If it returns successfully, ares_init(3) will set the variable pointed...
ares_init_options
The ares_init_options(3) function initializes a communications channel for name service lookups. If it returns successfully, ares_init_options(3) will set the...
ares_library_cleanup
The ares_library_cleanup function uninitializes the c-ares library, freeing all resources previously acquired by ares_library_init(3) when the library was...
ares_library_init
The ares_library_init function performs initializations internally required by the c-ares library that must take place before any other function provided by...
ares_mkquery
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...
ares_parse_aaaa_reply
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 parameters...
ares_parse_a_reply
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 parameters abuf and...
ares_parse_mx_reply
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...
ares_parse_naptr_reply
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...
ares_parse_ns_reply
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 the...
ares_parse_ptr_reply
The ares_parse_ptr_reply function parses the response to a query of type PTR into a struct hostent. The parameters abuf and alen give the contents of the...
ares_parse_soa_reply
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...
ares_parse_srv_reply
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...
ares_parse_txt_reply
The ares_parse_txt_reply (ares_parse_txt_reply_ext) function parses the response to a query of type TXT into a linked list (one element per sub-string) of...
ares_process
The ares_process(3) function handles input/output events and timeouts associated with queries pending on the name service channel identified by channel. The...
ares_query
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...
ares_save_options
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...
ares_search
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...
ares_send
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 should...
ares_set_local_dev
The ares_set_local_dev function causes all future sockets to be bound to this device with SO_BINDTODEVICE. This forces communications to go over a certain...
ares_set_local_ip4
The ares_set_local_ip4 function sets the IP address for outbound requests. This allows users to specify outbound interfaces when used on multi-homed systems.
ares_set_local_ip6
The ares_set_local_ip6 function sets the IPv6 address for outbound IPv6 requests. This allows users to specify outbound interfaces when used on multi-homed...
ares_set_servers
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_set_servers_csv
The ares_set_servers_csv and ares_set_servers_ports_csvfunctions set the list of DNS servers that ARES will query. The format of the servers option is...
ares_set_socket_callback
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...
ares_set_socket_configure_callback
This function sets a callback in the given ares channel handle. This callback function will be invoked after the socket has been created, but before it has been...
ares_set_sortlist
The ares_set_sortlist(3) function initializes an address sortlist configuration for the channel data identified by channel, so that addresses returned by...
ares_strerror
The ares_strerror function gets the description of the ares library error code code, returning the result as a NUL-terminated C string.
ares_timeout
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...
ares_version
The ares_version function gets the library version as a string and optionally as an integer stored in the version, argument. If you pass a NULL, no integer is...