#include <poll.h> int poll(struct pollfd fds, nfds_t nfds, int timeout); int ppoll(struct pollfd *restrict fds, nfds_t nfds, const struct timespec *restrict tsp, const sigset_t *restrict sigmask);
The ppoll() function behaves identically to poll(), except as follows:
The fds argument specifies the file descriptors to be examined and the events of interest for each file descriptor. It is a pointer to an array with one member for each open file descriptor of interest. The array's members are pollfd structures, which contain the following members:
int fd; /* file descriptor */ short events; /* requested events */ short revents; /* returned events */
The fd member specifies an open file descriptor and the events and revents members are bitmasks constructed by a logical OR operation of any combination of the following event flags:
If the value fd is less than 0, events is ignored and revents is set to 0 in that entry on return from poll() and ppoll().
The results of the poll() or ppoll() query are stored in the revents member in the pollfd structure. Bits are set in the revents bitmask to indicate which of the requested events are true. If none are true, none of the specified bits are set in revents when either the poll() or ppoll() call returns. The event flags POLLHUP, POLLERR, and POLLNVAL are always set in revents if the conditions they indicate are true; this occurs even though these flags were not present in events.
If none of the defined events have occurred on any selected file descriptor, poll() and ppoll() wait at least timeout milliseconds for an event to occur on any of the selected file descriptors. On a computer where millisecond timing accuracy is not available, timeout is rounded up to the nearest legal value available on that system. If the value timeout is 0, poll() returns immediately. If the value of timeout is −1, poll() blocks until a requested event occurs or until the call is interrupted. If the value of tsp is NULL, then ppoll() blocks until a requested event occurs or until the call is interrupted. The poll() and ppoll() functions are not affected by the O_NDELAY and O_NONBLOCK flags.
The poll() and ppoll() functions support regular files, terminal and pseudo-terminal devices, streams-based files, FIFOs, pipes, and sockets. The behavior of poll() and ppoll() on elements of fds that refer to other types of file is unspecified.
A file descriptor for a socket that is listening for connections will indicate that it is ready for reading, once connections are available. A file descriptor for a socket that is connecting asynchronously will indicate that it is ready for writing, once a connection has been established.
Regular files always poll() and ppoll() TRUE for reading and writing.
|ATTRIBUTE TYPE||ATTRIBUTE VALUE|
STREAMS Programming Guide
|August 23, 2001||OmniOS|