Print this page
11622 clean up rarer mandoc lint warnings
*** 10,21 ****
.\" 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
--- 10,19 ----
*** 24,34 ****
.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).
--- 22,31 ----
*** 47,61 ****
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
--- 44,56 ----
*** 84,99 ****
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)
--- 79,91 ----