Open an epoll
file descriptor by requesting the kernel to allocate an event
backing store dimensioned for size descriptors. The
size is not the
maximum size of the backing store but just a hint to the
kernel about how to dimension internal structures. The
returned file descriptor will be used for all the subsequent
calls to the epoll
interface. The file descriptor returned by epoll_create() must be closed by using
close(2).
RETURN VALUE
When successful, epoll_create() returns a non-negative
integer identifying the descriptor. When an error occurs,
epoll_create() returns −1
and errno is set
appropriately.
ERRORS
EINVAL
size is not
positive.
ENFILE
The system limit on the total number of open files
has been reached.
ENOMEM
There was insufficient memory to create the kernel
object.
CONFORMING TO
epoll_create() is
Linux-specific, and was introduced in kernel 2.5.44.
This page is part of release 2.79 of the Linux man-pages project. A
description of the project, and information about reporting
bugs, can be found at
http://www.kernel.org/doc/man-pages/.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Davide Libenzi <davidel@xmailserver.org>
Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com>
Modified 2005-04-04 by Marko Kohtala <marko.kohtala@gmail.com>