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

FreeBSD Manual Pages

  
 
  

home | help 
ARES_DESTROY(3)		   Library Functions Manual	       ARES_DESTROY(3)

NAME
       ares_destroy - Destroy a	resolver channel

SYNOPSIS
       #include	<ares.h>

       void ares_destroy(ares_channel_t	*channel)

DESCRIPTION
       The  ares_destroy(3) function destroys the name service channel identi-
       fied by channel,	freeing	all memory and closing all sockets used	by the
       channel.

       ares_destroy(3) invokes the callbacks for each  pending	query  on  the
       channel,	 passing  a  status of ARES_EDESTRUCTION. These	calls give the
       callbacks a chance to clean up any state	which might have  been	stored
       in  their  arguments. A callback	must not add new requests to a channel
       being destroyed.

       There is	no ability to make this	function thread-safe.	No  additional
       calls using this	channel	may be made once this function is called.

SEE ALSO
       ares_init(3), ares_cancel(3), ares_threadsafety(3)

				7 December 2004		       ARES_DESTROY(3)

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

home | help