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

RETURN VALUE

45       The ares_free_data() function does not return a value.
46

AVAILABILITY

48       This function was first introduced in c-ares version 1.7.0.
49

SEE ALSO

51       ares_get_servers(3),  ares_parse_srv_reply(3),  ares_parse_mx_reply(3),
52       ares_parse_txt_reply(3)
53

AUTHOR

55       Yang Tse
56
57       Copyright 1998 by the Massachusetts Institute of Technology.
58       Copyright (C) 2004-2010 by Daniel Stenberg.
59
60
61
62                                 5 March 2010                ARES_FREE_DATA(3)
Impressum