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

DESCRIPTION

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

RETURN VALUE

52       The ares_free_data(3) function does not return a value.
53

AVAILABILITY

55       This function was first introduced in c-ares version 1.7.0.
56

SEE ALSO

58       ares_get_servers(3),  ares_parse_srv_reply(3),  ares_parse_mx_reply(3),
59       ares_parse_txt_reply(3), ares_parse_soa_reply(3)
60

AUTHOR

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