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  function cancels all lookups/requests made on the the
15       name service channel identified by channel.   ares_cancel  invokes  the
16       callbacks  for  each  pending query on the channel, passing a status of
17       ARES_ECANCELLED.  These calls give the callbacks a chance to  clean  up
18       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.
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)