1ARES_CANCEL(3)             Library Functions Manual             ARES_CANCEL(3)
2
3
4

NAME

6       ares_cancel - Cancel a resolve
7

SYNOPSIS

9       #include <ares.h>
10
11       void ares_cancel(ares_channel channel)
12

DESCRIPTION

14       The  ares_cancel(3)  function  cancels all lookups/requests made on the
15       the name service channel identified by channel.  ares_cancel(3) invokes
16       the  callbacks  for each pending query on the channel, passing a status
17       of ARES_ECANCELLED.  These calls give the callbacks a chance  to  clean
18       up any state which might have been stored in their arguments. If such a
19       callback invocation adds a new request to  the  channel,  that  request
20       will not be cancelled by the current invocation of ares_cancel(3).
21

SEE ALSO

23       ares_init(3) ares_destroy(3)
24

NOTES

26       This function was added in c-ares 1.2.0
27
28       c-ares  1.6.0  and  earlier  pass  a status of ARES_ETIMEOUT instead of
29       ARES_ECANCELLED.
30

AUTHOR

32       Dirk Manske
33
34
35
36                                 31 March 2004                  ARES_CANCEL(3)