1ARES_FREE_DATA(3)          Library Functions Manual          ARES_FREE_DATA(3)
2
3
4

NAME

6       ares_free_data - Free data allocated by several c-ares functions
7

SYNOPSIS

9       #include <ares.h>
10
11       void ares_free_data(void *dataptr)
12
13       cc file.c -lcares
14

DESCRIPTION

16       The  ares_free_data(3) function frees one or more data structures allo‐
17       cated and returned by several c-ares functions. Specifically  the  data
18       returned  by  the following list of functions must be deallocated using
19       this function.
20
21       ares_get_servers(3)
22            When used to free the data returned  by  ares_get_servers(3)  this
23            will  free  the  whole  linked  list  of ares_addr_node structures
24            returned by ares_get_servers(3).
25
26       ares_parse_srv_reply(3)
27            When used to free the  data  returned  by  ares_parse_srv_reply(3)
28            this  will free the whole linked list of ares_srv_reply structures
29            returned by ares_parse_srv_reply(3),  along  with  any  additional
30            storage associated with those structures.
31
32       ares_parse_mx_reply(3)
33            When used to free the data returned by ares_parse_mx_reply(3) this
34            will free  the  whole  linked  list  of  ares_mx_reply  structures
35            returned  by  ares_parse_mx_reply(3),  along  with  any additional
36            storage associated with those structures.
37
38       ares_parse_txt_reply(3)
39            When used to free the  data  returned  by  ares_parse_txt_reply(3)
40            this  will free the whole linked list of ares_txt_reply structures
41            returned by ares_parse_txt_reply(3),  along  with  any  additional
42            storage associated with those structures.
43
44       ares_parse_soa_reply(3)
45            When  used  to  free  the data returned by ares_parse_soa_reply(3)
46            this will free the ares_soa_reply structure, along with any  addi‐
47            tional storage associated with those structure.
48

RETURN VALUE

50       The ares_free_data() function does not return a value.
51

AVAILABILITY

53       This function was first introduced in c-ares version 1.7.0.
54

SEE ALSO

56       ares_get_servers(3),  ares_parse_srv_reply(3),  ares_parse_mx_reply(3),
57       ares_parse_txt_reply(3), ares_parse_soa_reply(3)
58

AUTHOR

60       Yang Tse
61
62       Copyright 1998 by the Massachusetts Institute of Technology.
63       Copyright (C) 2004-2010 by Daniel Stenberg.
64
65
66
67                                 5 March 2010                ARES_FREE_DATA(3)
Impressum