Print this page
11622 clean up rarer mandoc lint warnings
@@ -10,12 +10,10 @@
.\" http://www.illumos.org/license/CDDL.
.TH EPOLL_CREATE 3C "April 9, 2016"
.SH NAME
epoll_create, epoll_create1 \- create an epoll instance
.SH SYNOPSIS
-
-.LP
.nf
#include <sys/epoll.h>
\fBint\fR \fBepoll_create\fR(\fBint\fR \fIsize\fR);
.fi
@@ -24,11 +22,10 @@
.nf
\fBint\fR \fBepoll_create1\fR(\fBint\fR \fIflags\fR);
.fi
.SH DESCRIPTION
-.LP
The \fBepoll_create()\fR and \fBepoll_create1()\fR functions both create an
\fBepoll\fR(5) instance that can be operated upon via \fBepoll_ctl\fR(3C),
\fBepoll_wait\fR(3C) and \fBepoll_pwait\fR(3C). \fBepoll\fR instances are
represented as file descriptors, and should be closed via \fBclose\fR(2).
@@ -47,15 +44,13 @@
Instance should be closed upon an
\fBexec\fR(2); see \fBopen\fR(2)'s description of \fBO_CLOEXEC\fR.
.RE
.SH RETURN VALUES
-.LP
Upon successful completion, 0 is returned. Otherwise, -1 is returned and errno
is set to indicate the error.
.SH ERRORS
-.LP
The \fBepoll_create()\fR and \fBepoll_create1()\fR functions will fail if:
.sp
.ne 2
.na
\fB\fBEINVAL\fR\fR
@@ -84,16 +79,13 @@
The maximum allowable number of files is currently open in the system.
.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_ctl\fR(3C), \fBepoll_wait\fR(3C), \fBepoll\fR(5)