1EPOLL_CREATE(2) Linux Programmer's Manual EPOLL_CREATE(2) 2 3 4 5NAME 6 epoll_create - open an epoll file descriptor 7 8SYNOPSIS 9 #include <sys/epoll.h> 10 11 int epoll_create(int size) 12 13DESCRIPTION 14 Open an epoll file descriptor by requesting the kernel allocate an 15 event backing store dimensioned for size descriptors. The size is not 16 the maximum size of the backing store but just a hint to the kernel 17 about how to dimension internal structures. The returned file descrip- 18 tor will be used for all the subsequent calls to the epoll interface. 19 The file descriptor returned by epoll_create(2) must be closed by using 20 close(2). 21 22RETURN VALUE 23 When successful, epoll_create(2) returns a positive integer identifying 24 the descriptor. When an error occurs, epoll_create(2) returns -1 and 25 errno is set appropriately. 26 27ERRORS 28 ENOMEM There was insufficient memory to create the kernel object. 29 30CONFORMING TO 31 epoll_create(2) is a new API introduced in Linux kernel 2.5.44. The 32 interface should be finalized by Linux kernel 2.5.66. 33 34SEE ALSO 35 epoll(4) epoll_ctl(2) epoll_wait(2) close(2) 36 37 38 39 40Linux 23 October 2002 EPOLL_CREATE(2) 41