epoll_create — open an epoll file descriptor
#include <sys/epoll.h>
int
epoll_create( |
int | size) ; |
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).
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.
size
is not
positive.
The system limit on the total number of open files has been reached.
There was insufficient memory to create the kernel object.
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/.
epoll by Davide Libenzi ( efficient event notification retrieval ) Copyright (C) 2003 Davide Libenzi 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 <davidelxmailserver.org> Modified 2004-06-17 by Michael Kerrisk <mtk.manpagesgmail.com> Modified 2005-04-04 by Marko Kohtala <marko.kohtalagmail.com> |