Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
ARES_FREE_DATA(3)	    Library Functions Manual	       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  associ-
	  ated 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 associ-
	  ated 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  associ-
	  ated 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ares_free_data&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help