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

NAME

6       ares_getsock - get file descriptors to wait on
7

SYNOPSIS

9       #include <ares.h>
10
11       int ares_getsock(ares_channel channel, int *socks,
12       int numsocks);
13

DESCRIPTION

15       The  ares_getsock  function retrieves the set of file descriptors which
16       the calling application should wait on for reading and/or  writing  for
17       the  processing  of  name  service  queries pending on the name service
18       channel identified by channel.  File descriptors will  be  set  in  the
19       integer  array  pointed to by socks.  numsocks is the size of the given
20       array in number of ints.
21
22       This function can only return information about up to  16  sockets.  If
23       more  are  in  use  (however  unlikely  that  is),  they are simply not
24       reported back.
25

RETURN VALUES

27       ares_getsock returns a bitmask for what actions to wait for on the dif‐
28       ferent  sockets.  The  ares.h  header  file  provides these convenience
29       macros to extract the information appropriately:
30
31       #define ARES_GETSOCK_MAXNUM 16 /* ares_getsock() can return info about
32                                         this many sockets */
33       #define ARES_GETSOCK_READABLE(bits,num) (bits & (1<< (num)))
34       #define ARES_GETSOCK_WRITABLE(bits,num) (bits & (1 << ((num) +                                          ARES_GETSOCK_MAXNUM)))
35

NOTES

37       This function was added in c-ares 1.3.1
38

SEE ALSO

40       ares_timeout(3), ares_fds(3), ares_process(3)
41
42
43
44                               22 December 2005                ARES_GETSOCK(3)
Impressum