Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

ares_process(3) [centos man page]

ARES_PROCESS(3) 					     Library Functions Manual						   ARES_PROCESS(3)

NAME
ares_process - Process events for name resolution SYNOPSIS
#include <ares.h> void ares_process(ares_channel channel, fd_set *read_fds, fd_set *write_fds) void ares_process_fd(ares_channel channel, ares_socket_t read_fd, ares_socket_t write_fd) DESCRIPTION
The ares_process(3) function handles input/output events and timeouts associated with queries pending on the name service channel identi- fied by channel. The file descriptor sets pointed to by read_fds and write_fds should have file descriptors set in them according to whether the file descriptors specified by ares_fds(3) are ready for reading and writing. (The easiest way to determine this information is to invoke select with a timeout no greater than the timeout given by ares_timeout(3) ). The ares_process function will invoke callbacks for pending queries if they complete successfully or fail. ares_process_fd(3) works the same way but acts and operates only on the specific file descriptors (sockets) you pass in to the function. Use ARES_SOCKET_BAD for "no action". This function is of course provided to allow users of c-ares to void select() in their applications and within c-ares. EXAMPLE The following code fragment waits for all pending queries on a channel to complete: int nfds, count; fd_set readers, writers; struct timeval tv, *tvp; while (1) { FD_ZERO(&readers); FD_ZERO(&writers); nfds = ares_fds(channel, &readers, &writers); if (nfds == 0) break; tvp = ares_timeout(channel, NULL, &tv); count = select(nfds, &readers, &writers, NULL, tvp); ares_process(channel, &readers, &writers); } SEE ALSO
ares_fds(3), ares_timeout(3) AUTHOR
Greg Hudson, MIT Information Systems Copyright 1998 by the Massachusetts Institute of Technology. 25 July 1998 ARES_PROCESS(3)

Check Out this Related Man Page

ARES_PROCESS(3) 					     Library Functions Manual						   ARES_PROCESS(3)

NAME
ares_process - Process events for name resolution SYNOPSIS
#include <ares.h> void ares_process(ares_channel channel, fd_set *read_fds, fd_set *write_fds) void ares_process_fd(ares_channel channel, ares_socket_t read_fd, ares_socket_t write_fd) DESCRIPTION
The ares_process(3) function handles input/output events and timeouts associated with queries pending on the name service channel identi- fied by channel. The file descriptor sets pointed to by read_fds and write_fds should have file descriptors set in them according to whether the file descriptors specified by ares_fds(3) are ready for reading and writing. (The easiest way to determine this information is to invoke select with a timeout no greater than the timeout given by ares_timeout(3) ). The ares_process function will invoke callbacks for pending queries if they complete successfully or fail. ares_process_fd(3) works the same way but acts and operates only on the specific file descriptors (sockets) you pass in to the function. Use ARES_SOCKET_BAD for "no action". This function is of course provided to allow users of c-ares to void select() in their applications and within c-ares. EXAMPLE The following code fragment waits for all pending queries on a channel to complete: int nfds, count; fd_set readers, writers; struct timeval tv, *tvp; while (1) { FD_ZERO(&readers); FD_ZERO(&writers); nfds = ares_fds(channel, &readers, &writers); if (nfds == 0) break; tvp = ares_timeout(channel, NULL, &tv); count = select(nfds, &readers, &writers, NULL, tvp); ares_process(channel, &readers, &writers); } SEE ALSO
ares_fds(3), ares_timeout(3) AUTHOR
Greg Hudson, MIT Information Systems Copyright 1998 by the Massachusetts Institute of Technology. 25 July 1998 ARES_PROCESS(3)
Man Page