Man page - ares_create_query(3)
Packages contains this manual
- ares_dns_rr_set_opt(3)
- ares_inet_pton(3)
- ares_set_pending_write_cb(3)
- ares_dns_rr_set_u8(3)
- ares_process_pending_write(3)
- ares_create_query(3)
- ares_dns_class_fromstr(3)
- ares_process_fd(3)
- ares_dns_write(3)
- ares_init(3)
- ares_process_fds(3)
- ares_dns_record_duplicate(3)
- ares_set_socket_configure_callback(3)
- ares_dns_rr_get_class(3)
- ares_dns_rec_type_t(3)
- ares_dns_record_query_set_type(3)
- ares_parse_txt_reply(3)
- ares_dns_record_get_flags(3)
- ares_dns_record(3)
- ares_mkquery(3)
- ares_dns_rec_type_tostr(3)
- ares_parse_naptr_reply(3)
- ares_set_sortlist(3)
- ares_dns_record_rr_add(3)
- ares_parse_uri_reply(3)
- ares_dns_record_get_id(3)
- ares_send_dnsrec(3)
- ares_gethostbyaddr(3)
- ares_gethostbyname_file(3)
- ares_parse_a_reply(3)
- ares_search(3)
- ares_strerror(3)
- ares_dns_record_query_cnt(3)
- ares_parse_soa_reply(3)
- ares_dns_datatype_t(3)
- ares_dns_rr_get_abin_cnt(3)
- ares_getaddrinfo(3)
- ares_dns_rr_set_bin(3)
- ares_reinit(3)
- ares_parse_ptr_reply(3)
- ares_tlsa_selector_t(3)
- ares_dns_rr_get_u32(3)
- ares_version(3)
- ares_dns_rr_set_u32(3)
- ares_dns_rcode_tostr(3)
- ares_set_socket_callback(3)
- ares_dns_rr_set_u16(3)
- ares_dns_record_get_opcode(3)
- ares_parse_caa_reply(3)
- ares_dns_rr_get_bin(3)
- ares_library_init_android(3)
- ares_queue_active_queries(3)
- ares_inet_ntop(3)
- ares_init_options(3)
- ares_dns_record_get_rcode(3)
- ares_dns_rr_get_name(3)
- ares_dns_rec_type_fromstr(3)
- ares_free_string(3)
- ares_save_options(3)
- ares_dns_rr_add_abin(3)
- ares_threadsafety(3)
- ares_parse_srv_reply(3)
- ares_get_servers_csv(3)
- ares_queue_wait_empty(3)
- ares_dns_rr_key_t(3)
- ares_queue(3)
- ares_dns_record_set_id(3)
- ares_dns_opt_get_name(3)
- ares_set_socket_functions(3)
- ares_dns_rr(3)
- ares_tlsa_usage_t(3)
- ares_send(3)
- ares_dns_record_rr_get_const(3)
- ares_set_local_ip6(3)
- ares_library_cleanup(3)
- ares_dns_rr_get_str(3)
- ares_dns_rr_get_abin(3)
- ares_set_servers_ports_csv(3)
- ares_dup(3)
- ares_dns_class_t(3)
- ares_dns_mapping(3)
- ares_fds(3)
- ares_free_data(3)
- ares_dns_rr_key_tostr(3)
- ares_dns_rr_get_addr6(3)
- ares_get_servers(3)
- ares_dns_rr_get_keys(3)
- ares_set_servers_ports(3)
- ares_dns_section_tostr(3)
- ares_dns_class_tostr(3)
- ares_dns_record_query_set_name(3)
- ares_search_dnsrec(3)
- ares_cancel(3)
- ares_dns_rr_del_abin(3)
- ares_expand_string(3)
- ares_dns_flags_t(3)
- ares_expand_name(3)
- ares_free_hostent(3)
- ares_dns_opt_datatype_t(3)
- ares_set_servers_csv(3)
- ares_dns_rr_get_ttl(3)
- ares_library_initialized(3)
- ares_get_servers_ports(3)
- ares_timeout(3)
- ares_dns_rr_del_opt_byid(3)
- ares_dns_rr_set_addr(3)
- ares_set_server_state_callback(3)
- ares_dns_rr_get_u8(3)
- ares_dns_section_t(3)
- ares_dns_rr_get_type(3)
- ares_dns_rr_set_addr6(3)
- ares_dns_record_rr_get(3)
- ares_dns_rr_get_opt_byid(3)
- ares_dns_record_create(3)
- ares_gethostbyname(3)
- ares_set_local_ip4(3)
- ares_dns_parse(3)
- ares_dns_record_destroy(3)
- ares_dns_opt_get_datatype(3)
- ares_freeaddrinfo(3)
- ares_dns_record_rr_del(3)
- ares_set_local_dev(3)
- ares_dns_rcode_t(3)
- ares_dns_opcode_tostr(3)
- ares_query_dnsrec(3)
- ares_dns_record_query_add(3)
- ares_dns_rr_get_opt_cnt(3)
- ares_dns_rr_get_u16(3)
- ares_parse_aaaa_reply(3)
- ares_dns_rr_get_opt(3)
- ares_getsock(3)
- ares_dns_rr_get_addr(3)
- ares_dns_record_query_get(3)
- ares_dns_rr_key_datatype(3)
- ares_opt_param_t(3)
- ares_destroy(3)
- ares_getnameinfo(3)
- ares_query(3)
- ares_tlsa_match_t(3)
- ares_library_init(3)
- ares_set_servers(3)
- ares_parse_ns_reply(3)
- ares_dns_opcode_t(3)
- ares_process(3)
- ares_dns_rr_key_to_rec_type(3)
- ares_parse_mx_reply(3)
- ares_svcb_param_t(3)
- ares_destroy_options(3)
- ares_dns_rr_set_str(3)
- ares_set_socket_functions_ex(3)
- ares_dns_record_rr_cnt(3)
apt-get install libc-ares-dev
Manual
ARES_CREATE_QUERY
NAMESYNOPSIS
DESCRIPTION
RETURN VALUES
AVAILABILITY
SEE ALSO
NAME
ares_create_query - Compose a single-question DNS query buffer
SYNOPSIS
#include <ares.h>
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
)
DESCRIPTION
This function is deprecated as of c-ares 1.22, please use ares_dns_record_create(3) instead.
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 period-separated labels optionally ending with a period; periods and backslashes within a label must be escaped with a backlash.
The parameters dnsclass and type give the class and type of the query using the values defined in <arpa/nameser.h> .
The parameter id gives a 16-bit identifier for the query.
The parameter rd should be nonzero if recursion is desired, zero if not.
The query will be placed in an allocated buffer, a pointer to which will be stored in the variable pointed to by buf , and the length of which will be stored in the variable pointed to by buflen .
It is the caller’s responsibility to free this buffer using ares_free_string(3) when it is no longer needed. The parameter max_udp_size should be nonzero to activate EDNS. Usage of ares_create_query(3) with max_udp_size set to zero is equivalent to using ares_mkquery(3) .
RETURN VALUES
ares_create_query can return any of the following values:
|
ARES_SUCCESS |
Construction of the DNS query succeeded. |
||
|
ARES_ENOTFOUND |
The query name name refers to a .onion domain name. See RFC 7686. |
||
|
ARES_EBADNAME |
The query name name could not be encoded as a domain name, either because it contained a zero-length label or because it contained a label of more than 63 characters. |
||
|
ARES_ENOMEM |
Memory was exhausted. |
AVAILABILITY
Added in c-ares 1.10.0
SEE ALSO
ares_dns_record (3), ares_expand_name (3), ares_free_string (3), ares_mkquery (3)