Print this page
11622 clean up rarer mandoc lint warnings
@@ -10,12 +10,10 @@
.\" http://www.illumos.org/license/CDDL.
.TH EPOLL_WAIT 3C "Apr 17, 2014"
.SH NAME
epoll_wait, epoll_pwait \- wait for epoll events
.SH SYNOPSIS
-
-.LP
.nf
#include <sys/epoll.h>
\fBint\fR \fBepoll_wait\fR(\fBint\fR \fIepfd\fR, \fBstruct epoll_event *\fR\fIevents\fR,
\fBint\fR \fImaxevents\fR, \fBint\fR \fItimeout\fR);
@@ -27,11 +25,10 @@
\fBint\fR \fImaxevents\fR, \fBint\fR \fItimeout\fR,
\fBconst sigset_t *\fR\fIsigmask\fR);
.fi
.SH DESCRIPTION
-.LP
The \fBepoll_wait()\fR function waits for events on the \fBepoll\fR(5)
instance specified by \fIepfd\fR. The \fIevents\fR parameter must point to
an array of \fImaxevents\fR \fIepoll_event\fR structures to be
filled in with pending events. The \fItimeout\fR argument specifies the
number of milliseconds to wait for an event if none is pending. A
@@ -43,18 +40,16 @@
setting the signal mask, calling \fBepoll_wait()\fR, and restoring the
signal mask upon return, and is therefore similar to the relationship
between \fBselect\fR(3C) and \fBpselect\fR(3C).
.SH RETURN VALUES
-.LP
Upon successful completion, \fBepoll_wait()\fR and \fBepoll_pwait()\fR return
the number of events, or 0 if none was pending and \fItimeout\fR milliseconds
elapsed. If an error occurs, -1 is returned and errno is set to indicate
the error.
.SH ERRORS
-.LP
The \fBepoll_wait()\fR and \fBepoll_pwait()\fR functions will fail if:
.sp
.ne 2
.na
\fB\fBEBADF\fR\fR
@@ -91,18 +86,15 @@
is not greater than zero.
.RE
.sp
.SH NOTES
-.LP
-
The \fBepoll\fR(5) facility is implemented for purposes of offering
compatibility for Linux-borne applications; native
applications should continue to prefer using event ports via the
\fBport_create\fR(3C), \fBport_associate\fR(3C) and \fBport_get\fR(3C)
interfaces. See \fBepoll\fR(5) for compatibility details and restrictions.
.SH SEE ALSO
-.LP
\fBepoll_create\fR(3C), \fBepoll_ctl\fR(3C),
\fBport_create\fR(3C), \fBport_associate\fR(3C), \fBport_get\fR(3C),
\fBpselect\fR(3C), \fBepoll\fR(5)