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

FreeBSD Manual Pages

  
 
  

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 allo-
       cated 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 re-
	    turned 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 re-
	    turned by ares_parse_mx_reply(3), along with any additional	 stor-
	    age	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.

       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 addi-
	    tional    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+14.3.quarterly>

home | help