ares_timeout(3) [centos man page]

ARES_TIMEOUT(3) 					     Library Functions Manual						   ARES_TIMEOUT(3)

NAME

       ares_timeout - return maximum time to wait

SYNOPSIS

       #include <ares.h>

       struct timeval *ares_timeout(ares_channel channel,
       struct timeval *maxtv, struct timeval *tv)

DESCRIPTION

       The ares_timeout function determines the maximum time for which the caller should wait before invoking ares_process(3) to process timeouts.
       The parameter maxtv specifies a existing maximum timeout, or NULL if the caller does not wish to apply a maximum timeout.  The parameter tv
       must point to a writable buffer of type struct timeval.	It is valid for maxtv and tv to have the same value.

       If  no queries have timeouts pending sooner than the given maximum timeout, ares_timeout returns the value of maxtv; otherwise ares_timeout
       stores the appropriate timeout value into the buffer pointed to by tv and returns the value of tv.

SEE ALSO

       ares_fds(3), ares_process(3)

AUTHOR

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

								   25 July 1998 						   ARES_TIMEOUT(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)