ARES_FREE_DATA(3) Introduction to Library Functions ARES_FREE_DATA(3)
NAME
ares_free_data - Free data allocated by several c-ares functions
SYNOPSIS
#include <ares.h>
void ares_free_data(void *
dataptr)
DESCRIPTION
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 following list of functions must be deallocated
using this function.
ares_get_servers(3) When used to free the data returned by
ares_get_servers(3) this
will free the whole linked list of ares_addr_node structures
returned by
ares_get_servers(3).
ares_parse_srv_reply(3) When used to free the data returned by
ares_parse_srv_reply(3) this will free the whole linked list of ares_srv_reply
structures returned by
ares_parse_srv_reply(3), along with any
additional storage associated with those structures.
ares_parse_mx_reply(3) When used to free the data returned by
ares_parse_mx_reply(3) this will free the whole linked list of ares_mx_reply structures
returned by
ares_parse_mx_reply(3), along with any additional
storage associated with those structures.
ares_parse_txt_reply(3) When used to free the data returned by
ares_parse_txt_reply(3) this will free the whole linked list of ares_txt_reply
structures returned by
ares_parse_txt_reply(3), along with any
additional storage associated with those structures.
ares_parse_soa_reply(3) When used to free the data returned by
ares_parse_soa_reply(3) this will free the ares_soa_reply structure, along with any
additional storage associated with those structure.
ares_parse_uri_reply(3) When used to free the data returned by
ares_parse_uri_reply(3) this will free list of ares_uri_reply
structures, along with any additional storage associated with
those structure.
RETURN VALUE
The
ares_free_data(3) function does not return a value.
AVAILABILITY
This function was first introduced in c-ares version 1.7.0.
SEE ALSO
ares_get_servers(3),
ares_parse_srv_reply(3),
ares_parse_mx_reply(3),
ares_parse_txt_reply(3),
ares_parse_soa_reply(3) 5 March 2010 ARES_FREE_DATA(3)
