diff options
Diffstat (limited to 'usr/src/man/man5/epoll.5')
| -rw-r--r-- | usr/src/man/man5/epoll.5 | 14 |
1 files changed, 6 insertions, 8 deletions
diff --git a/usr/src/man/man5/epoll.5 b/usr/src/man/man5/epoll.5 index bba13e15d2..94314861d9 100644 --- a/usr/src/man/man5/epoll.5 +++ b/usr/src/man/man5/epoll.5 @@ -10,7 +10,7 @@ .\" http://www.illumos.org/license/CDDL. .TH EPOLL 5 "Apr 17, 2014" .SH NAME -epoll \- Linux-compatible I/O event notification facility +epoll \- Linux-compatible I/O event notification facility .SH SYNOPSIS .LP @@ -22,7 +22,7 @@ epoll \- Linux-compatible I/O event notification facility .sp .LP -\fBepoll\fR is a facility for efficient event-oriented I/O that has a +\fBepoll\fR is a facility for efficient event-oriented I/O that has a similar model to \fBpoll\fR(2), but does not necessitate rescanning a set of file descriptors to wait for an event. \fBepoll\fR is of Linux origins, and this facility is designed to be binary-compatible with @@ -70,7 +70,6 @@ to waiting for events. .RE .sp -.LP .SH NOTES .sp .LP @@ -79,14 +78,14 @@ The \fBepoll\fR facility is implemented for purposes of offering compatibility to and portability of Linux-borne applications; native applications should continue to prefer using event ports via the \fBport_create\fR(3C), -\fBport_associate\fR(3C) and \fBport_getn\fR(3C) interfaces. +\fBport_associate\fR(3C) and \fBport_getn\fR(3C) interfaces. In particular, use of \fBepoll\fR in a multithreaded environment is fraught with peril; even when using \fBEPOLLONESHOT\fR for one-shot events, there are race conditions with respect to \fBclose\fR(2) that are unresolvable. (For more details, see the aborted effort in Linux to resolve this via the proposed \fBEPOLL_CTL_DISABLE\fR operation.) -The event port facility -- like the BSD kqueue facility that inspired it -- +The event port facility -- like the BSD kqueue facility that inspired it -- is designed to deal with such issues via explicit event source dissociation. While a best effort has been made to mimic the Linux semantics, there @@ -100,16 +99,15 @@ any events generated in the child on the implicitly duplicated file descriptor will continue to be delivered to the parent -- despite the fact that the parent itself no longer has any notion of the file description! This \fBepoll\fR facility refuses to honor -these semantics; closing the \fBEPOLL_CTL_ADD\fR'd file descriptor +these semantics; closing the \fBEPOLL_CTL_ADD\fR'd file descriptor will always result in no further events being generated for that event description. -.RE .SH SEE ALSO .sp .LP \fBepoll_create\fR(3C), \fBepoll_create1\fR(3C), \fBepoll_ctl\fR(3C), \fBepoll_wait\fR(3C), \fBepoll_pwait\fR(3C), \fBport_create\fR(3C), \fBport_associate\fR(3C), \fBport_dissociate\fR(3C), -\fBport_get\fR(3C), +\fBport_get\fR(3C), \fBpselect\fR(3C) |
