epoll_create和epoll_create1

Posted 2022-11-23 jfcat

名字

       epoll_create epoll_create1 - 创建epoll文件描述符

摘要

       #include <sys/epoll.h>
       int epoll_create(int size);       

       int epoll_create1(int flags);

描述

       epoll_create（）

       创建一个新的epoll实例。从Linux 2.6.8开始，size参数被忽略，但必须大于零； 看下面的注意事项。

        epoll_create（）

        返回一个指向新创建的epoll实例的文件描述符。 这个文件描述符用于所有后续调用epoll的所有接口。 当不再需要文件描述符             时，使用close关闭。 当所有指向这个epoll实例的文件描述符都关闭时，内核销毁实例并释放关联的重用资源。

      epoll_create1()

     如果flags为0，epoll_create1（）和删除了过时size参数的epoll_create（）相同。
    如果flags中包含以下值就有不同的表现：
    EPOLL_CLOEXEC
    在文件描述符上面设置执行时关闭（FD_CLOEXEC）标志描述符。
    具体请参考open中对O_CLOEXEC标志的描述。

返回值

    成功时，返回一个非负文件描述符。
    发生错误时，返回-1，并且将errno设置为指示错误

errno错误

    EINVAL  size不是正数。
    EINVAL  在epoll_create1（）的flags标志中包含无效值。
    EMFILE  达到了用户对epoll设置的最大实例数限制，在/proc/sys/fs/epoll/max_user_instances具体查看
    EMFILE  达到了进程中文件描述符的最大限制
    ENFILE  达到了系统范围内对打开文件总数的限制
    ENOMEM  没有足够的内存来创建内核对象。

版本
    epoll_create（）在2.6版中添加到内核中。glibc库从版本2.3.2开始提供了支持。
    epoll_create1（）在2.6.27版中添加到内核中。glibc库从2.9版开始提供了支持

标准参考
    epoll_create（）是Linux独有的
   
注意事项
最初epoll_create（）的参数size告诉内核添加到epoll实例的文件描述符个数，内核根据这个参数分配最初的描述事件结构体的空间，（如果有必要，内核会分配超过size的空间）
现在size不再需要了（内核动态的分配描述事件需要的空间），但是size必须要设置大于0的值，是为了新的应用能运行在旧的内核上。