ares_destroy(3)

ARES_DESTROY(3)        C LIBRARY FUNCTIONS        ARES_DESTROY(3)

NAME

     ares_destroy - Destroy a resolver channel

SYNOPSIS

     #include <ares.h>

     void ares_destroy(ares_channel channel)

DESCRIPTION

     The ares_destroy(3) function destroys the name service chan-
     nel  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.

SEE ALSO

     ares_init(3), ares_cancel(3)

AUTHOR

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

                  Last change: 7 December 2004                  1