ares_free_data

Langue: en

Version: 5 March 2010 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

NAME

ares_free_data - Free data allocated by several c-ares functions

SYNOPSIS

 #include <ares.h>
 
 void ares_free_data(void *dataptr)
 
 cc file.c -lcares
 

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.

RETURN VALUE

The ares_free_data() 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)

AUTHOR

Yang Tse

Copyright 1998 by the Massachusetts Institute of Technology.
Copyright (C) 2004-2010 by Daniel Stenberg.