summaryrefslogtreecommitdiff
path: root/usr/src/man/man5/epoll.5
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/man/man5/epoll.5')
-rw-r--r--usr/src/man/man5/epoll.514
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)