Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

ares_fds (3)

Name

ares_fds - return file descriptors to select on

Synopsis

#include <ares.h>

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

Description

ARES_FDS(3)                Library Functions Manual                ARES_FDS(3)



NAME
       ares_fds - return file descriptors to select on

SYNOPSIS
       #include <ares.h>

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

DESCRIPTION
       The  ares_fds(3)  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(3)  returns a value that is one greater than the number of the
       highest socket set in either read_fds or write_fds.  If no queries  are
       active, ares_fds(3) returns 0.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/libcares |
       +---------------+------------------+
       |Stability      | Volatile         |
       +---------------+------------------+

SEE ALSO
       ares_timeout(3), ares_process(3)

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



NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source    was   downloaded   from    https://c-ares.haxx.se/download/c-
       ares-1.17.2.tar.gz.

       Further information about this software can be found on the open source
       community website at https://c-ares.haxx.se/.



                                 23 July 1998                      ARES_FDS(3)