summaryrefslogtreecommitdiffstats
path: root/man2/epoll_create.2
diff options
context:
space:
mode:
Diffstat (limited to 'man2/epoll_create.2')
-rw-r--r--man2/epoll_create.245
1 files changed, 23 insertions, 22 deletions
diff --git a/man2/epoll_create.2 b/man2/epoll_create.2
index 5591e88df..8d2c0be40 100644
--- a/man2/epoll_create.2
+++ b/man2/epoll_create.2
@@ -8,7 +8,7 @@
.\" Modified 2005-04-04 by Marko Kohtala <marko.kohtala@gmail.com>
.\" 2008-10-10, mtk: add description of epoll_create1()
.\"
-.TH epoll_create 2 2022-12-04 "Linux man-pages 6.03"
+.TH epoll_create 2 2023-07-16 "Linux man-pages 6.05.01"
.SH NAME
epoll_create, epoll_create1 \- open an epoll file descriptor
.SH LIBRARY
@@ -28,7 +28,7 @@ creates a new
instance.
Since Linux 2.6.8, the
.I size
-argument is ignored, but must be greater than zero; see NOTES.
+argument is ignored, but must be greater than zero; see HISTORY.
.PP
.BR epoll_create ()
returns a file descriptor referring to the new epoll instance.
@@ -83,14 +83,6 @@ Invalid value specified in
.IR flags .
.TP
.B EMFILE
-The per-user limit on the number of epoll instances imposed by
-.I /proc/sys/fs/epoll/max_user_instances
-was encountered.
-See
-.BR epoll (7)
-for further details.
-.TP
-.B EMFILE
The per-process limit on the number of open file descriptors has been reached.
.TP
.B ENFILE
@@ -98,22 +90,20 @@ The system-wide limit on the total number of open files has been reached.
.TP
.B ENOMEM
There was insufficient memory to create the kernel object.
-.SH VERSIONS
+.SH STANDARDS
+Linux.
+.SH HISTORY
+.TP
.BR epoll_create ()
-was added in Linux 2.6.
-Library support is provided in glibc 2.3.2.
-.PP
+Linux 2.6,
+glibc 2.3.2.
.\" To be precise: kernel 2.5.44.
.\" The interface should be finalized by Linux kernel 2.5.66.
+.TP
.BR epoll_create1 ()
-was added in Linux 2.6.27.
-Library support is provided in glibc 2.9.
-.SH STANDARDS
-.BR epoll_create ()
-and
-.BR epoll_create1 ()
-are Linux-specific.
-.SH NOTES
+Linux 2.6.27,
+glibc 2.9.
+.PP
In the initial
.BR epoll_create ()
implementation, the
@@ -136,6 +126,17 @@ must still be greater than zero,
in order to ensure backward compatibility when new
.B epoll
applications are run on older kernels.
+.PP
+Prior to Linux 2.6.29,
+.\" commit 9df04e1f25effde823a600e755b51475d438f56b
+a
+.I /proc/sys/fs/epoll/max_user_instances
+kernel parameter limited live epolls for each real user ID,
+and caused
+.BR epoll_create ()
+to fail with
+.B EMFILE
+on overrun.
.SH SEE ALSO
.BR close (2),
.BR epoll_ctl (2),