Man page - ares_get_servers(3)
Packages contas this manual
- ares_mkquery(3)
- ares_dns_class_fromstr(3)
- ares_dns_parse(3)
- ares_dns_opt_get_datatype(3)
- ares_parse_srv_reply(3)
- ares_parse_caa_reply(3)
- ares_get_servers_csv(3)
- ares_dns_rr_get_abin_cnt(3)
- ares_freeaddrinfo(3)
- ares_dns_opcode_tostr(3)
- ares_dns_record_rr_get_const(3)
- ares_process_fd(3)
- ares_dns_rr_get_type(3)
- ares_tlsa_match_t(3)
- ares_timeout(3)
- ares_dns_rec_type_fromstr(3)
- ares_fds(3)
- ares_dns_datatype_t(3)
- ares_dns_record_get_flags(3)
- ares_cancel(3)
- ares_queue_active_queries(3)
- ares_dns_rr(3)
- ares_expand_string(3)
- ares_dns_mapping(3)
- ares_dns_rr_set_u8(3)
- ares_set_servers_csv(3)
- ares_dns_rr_get_opt_cnt(3)
- ares_dns_rr_set_addr6(3)
- ares_parse_a_reply(3)
- ares_free_hostent(3)
- ares_dns_rr_key_to_rec_type(3)
- ares_dns_record_get_id(3)
- ares_dns_record_get_opcode(3)
- ares_library_init_android(3)
- ares_dns_rr_get_abin(3)
- ares_dns_rr_key_datatype(3)
- ares_parse_ptr_reply(3)
- ares_dns_rr_get_class(3)
- ares_set_socket_configure_callback(3)
- ares_dns_rr_add_abin(3)
- ares_save_options(3)
- ares_dns_rr_get_ttl(3)
- ares_dns_rr_set_u32(3)
- ares_set_servers_ports_csv(3)
- ares_dns_rec_type_tostr(3)
- ares_dns_rr_get_addr(3)
- ares_dns_record_rr_del(3)
- ares_parse_ns_reply(3)
- ares_send(3)
- ares_inet_pton(3)
- ares_gethostbyname(3)
- ares_opt_param_t(3)
- ares_strerror(3)
- ares_dns_opcode_t(3)
- ares_library_init(3)
- ares_dns_rr_key_t(3)
- ares_dns_rr_del_opt_byid(3)
- ares_set_local_ip6(3)
- ares_dns_rr_get_addr6(3)
- ares_create_query(3)
- ares_destroy_options(3)
- ares_dns_section_t(3)
- ares_library_initialized(3)
- ares_dns_record_query_get(3)
- ares_gethostbyaddr(3)
- ares_version(3)
- ares_expand_name(3)
- ares_get_servers_ports(3)
- ares_dns_record_query_cnt(3)
- ares_dns_record_query_set_type(3)
- ares_process_pending_write(3)
- ares_parse_mx_reply(3)
- ares_init(3)
- ares_set_socket_functions_ex(3)
- ares_dns_record(3)
- ares_queue(3)
- ares_dns_rcode_t(3)
- ares_dns_write(3)
- ares_dns_rr_get_u16(3)
- ares_dns_record_rr_add(3)
- ares_get_servers(3)
- ares_queue_wait_empty(3)
- ares_svcb_param_t(3)
- ares_dns_rr_get_opt_byid(3)
- ares_init_options(3)
- ares_reinit(3)
- ares_dns_rr_set_opt(3)
- ares_set_local_dev(3)
- ares_dns_record_query_add(3)
- ares_set_server_state_callback(3)
- ares_dns_rr_set_bin(3)
- ares_dns_rr_del_abin(3)
- ares_dns_rr_get_bin(3)
- ares_dns_rr_set_addr(3)
- ares_set_servers(3)
- ares_search(3)
- ares_dns_opt_datatype_t(3)
- ares_dns_record_get_rcode(3)
- ares_dns_rr_get_u32(3)
- ares_dns_class_t(3)
- ares_dns_record_duplicate(3)
- ares_dns_rr_set_str(3)
- ares_send_dnsrec(3)
- ares_dns_class_tostr(3)
- ares_dns_rr_get_name(3)
- ares_destroy(3)
- ares_parse_aaaa_reply(3)
- ares_parse_soa_reply(3)
- ares_set_pending_write_cb(3)
- ares_dns_record_rr_cnt(3)
- ares_set_socket_callback(3)
- ares_parse_naptr_reply(3)
- ares_dns_flags_t(3)
- ares_dns_record_rr_get(3)
- ares_getsock(3)
- ares_free_string(3)
- ares_process(3)
- ares_dns_rr_get_opt(3)
- ares_dns_record_create(3)
- ares_dns_rr_get_u8(3)
- ares_threadsafety(3)
- ares_dns_rec_type_t(3)
- ares_query(3)
- ares_dns_rr_get_keys(3)
- ares_library_cleanup(3)
- ares_dup(3)
- ares_dns_opt_get_name(3)
- ares_tlsa_selector_t(3)
- ares_search_dnsrec(3)
- ares_dns_record_destroy(3)
- ares_dns_rcode_tostr(3)
- ares_parse_txt_reply(3)
- ares_getaddrinfo(3)
- ares_gethostbyname_file(3)
- ares_dns_record_set_id(3)
- ares_query_dnsrec(3)
- ares_dns_rr_set_u16(3)
- ares_tlsa_usage_t(3)
- ares_process_fds(3)
- ares_set_sortlist(3)
- ares_getnameinfo(3)
- ares_dns_rr_get_str(3)
- ares_set_servers_ports(3)
- ares_inet_ntop(3)
- ares_parse_uri_reply(3)
- ares_free_data(3)
- ares_dns_section_tostr(3)
- ares_set_local_ip4(3)
- ares_dns_record_query_set_name(3)
- ares_set_socket_functions(3)
- ares_dns_rr_key_tostr(3)
apt-get install libc-ares-dev
Manual
| ARES_GET_SERVERS(3) | Library Functions Manual | ARES_GET_SERVERS(3) |
NAME
ares_get_servers, ares_get_servers_ports - Retrieve name servers from an initialized ares_channel (deprecated)
SYNOPSIS
#include <ares.h> int ares_get_servers(const ares_channel_t *channel,
struct ares_addr_node **servers) int ares_get_servers_ports(const ares_channel_t *channel,
struct ares_addr_port_node **servers)
DESCRIPTION
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 storing a pointer to the first node at the address specified by servers.
The ares_get_servers_ports(3) function also retrieves any per-server port information that may have been previously configured, returning a linked list of ares_addr_port structures.
Function caller may traverse the returned name server linked list, or may use it directly as suitable input for the ares_set_servers(3) / ares_set_servers_ports(3) functions, but shall not shrink or extend the list on its own.
Each node of the name server linked list is stored in memory dynamically allocated and managed by c-ares. It is the caller's responsibility to free the resulting linked list, using ares_free_data(3) , once the caller does not need it any longer.
This function is capable of handling IPv4 and IPv6 name server addresses simultaneously, rendering ares_save_options(3) with optmask ARES_OPT_SERVERS functionally obsolete except for IPv4-only name server usage.
RETURN VALUES
This function may return any of the following values:
- ARES_SUCCESS
- The name servers configuration was successfully retrieved
- ARES_ENOMEM
- The memory was exhausted
- ARES_ENODATA
- The channel data identified by channel was invalid.
SEE ALSO
ares_set_servers(3), ares_init_options(3), ares_save_options(3)
AVAILABILITY
ares_get_servers(3) was added in c-ares 1.7.1; ares_get_servers_ports(3) was added in c-ares 1.11.0.
NOTES
As of c-ares 1.24, these functions are deprecated due to their lack of ability to store the entire server configuration. Use ares_get_servers_csv(3).
| 5 March 2010 |