Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

ares_destroy (3)

Name

ares_destroy - Destroy a resolver channel

Synopsis

#include <ares.h>

void ares_destroy(ares_channel channel)

Description

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 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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/libcares |
       +---------------+------------------+
       |Stability      | Volatile         |
       +---------------+------------------+

SEE ALSO
       ares_init(3), ares_cancel(3)

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



NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source    was   downloaded   from    https://c-ares.haxx.se/download/c-
       ares-1.17.2.tar.gz.

       Further information about this software can be found on the open source
       community website at https://c-ares.haxx.se/.



                                7 December 2004                ARES_DESTROY(3)