noble (3) ares_destroy.3.gz

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 identified 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)

AUTHOR

       Greg Hudson, MIT Information Systems
       Copyright 1998 by the Massachusetts Institute of Technology.

                                                 7 December 2004                                 ARES_DESTROY(3)