ares_fds(3) [debian man page]

ARES_FDS(3)						     Library Functions Manual						       ARES_FDS(3)

NAME

       ares_fds - Get file descriptors to select on for name service

SYNOPSIS

       #include <ares.h>

       int ares_fds(ares_channel channel, fd_set *read_fds,
       fd_set *write_fds)

DESCRIPTION

       The  ares_fds function retrieves the set of file descriptors which the calling application should select on for reading and writing for the
       processing of name service queries pending on the name service channel identified by channel.  File descriptors will be	set  in  the  file
       descriptor  sets  pointed  to by read_fds and write_fds as appropriate.	File descriptors already set in read_fds and write_fds will remain
       set; initialization of the file descriptor sets (using FD_ZERO) is the responsibility of the caller.

RETURN VALUES

       ares_fds returns one greater than the number of the highest socket set in either read_fds or write_fds.	If no queries are active, ares_fds
       will return 0.

SEE ALSO

       ares_timeout(3), ares_process(3)

AUTHOR

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

								   23 July 1998 						       ARES_FDS(3)

ARES_GETSOCK(3) 					     Library Functions Manual						   ARES_GETSOCK(3)

NAME

       ares_getsock - get socket descriptors to wait on

SYNOPSIS

       #include <ares.h>

       int ares_getsock(ares_channel channel, ares_socket_t *socks,
       int numsocks);

DESCRIPTION

       The  ares_getsock  function retrieves the set of socket descriptors which the calling application should wait on for reading and/or writing
       for the processing of name service queries pending on the name service channel identified by channel.  Socket descriptors will  be  set	in
       the socket descriptor array pointed to by socks.  numsocks is the size of the given array in number of ints.

       This  function  can  only  return  information  about  up to 16 sockets. If more are in use (however unlikely that is), they are simply not
       reported back.

RETURN VALUES

       ares_getsock returns a bitmask for what actions to wait for on the different sockets. The ares.h header	file  provides	these  convenience
       macros to extract the information appropriately:

       #define ARES_GETSOCK_MAXNUM 16 /* ares_getsock() can return info about
					 this many sockets */
       #define ARES_GETSOCK_READABLE(bits,num) (bits & (1<< (num)))
       #define ARES_GETSOCK_WRITABLE(bits,num) (bits & (1 << ((num) +					       ARES_GETSOCK_MAXNUM)))

NOTES

       This function was added in c-ares 1.3.1

SEE ALSO

       ares_timeout(3), ares_fds(3), ares_process(3)

								   11 March 2010						   ARES_GETSOCK(3)