epoll_ctl详解

epoll_ctl，用于操作epoll函数所生成的实例。
       

#include <sys / epoll.h>

int epoll_ctl（int epfd，int op，int fd，struct epoll_event * event）;

       该系统调用对文件描述符epfd引用的epoll实例执行控制操作。它要求操作op对目标文件描述符fd执行。

       op参数的有效值为：

       EPOLL_CTL_ADD：在文件描述符epfd所引用的epoll实例上注册目标文件描述符fd，并将事件事件与内部文件链接到fd。

       EPOLL_CTL_MOD：更改与目标文件描述符fd相关联的事件事件。

       EPOLL_CTL_DEL：从epfd引用的epoll实例中删除（注销）目标文件描述符fd。该事件将被忽略，并且可以为NULL（但请参见下面的错误）。

       事件参数描述链接到文件描述符fd的对象。结构epoll_event定义为：           

typedef union epoll_data {
               无效* ptr;
               int fd;
               uint32_t u32;
               uint64_t u64;
           } epoll_data_t;

           struct epoll_event {
               uint32_t事件； / * Epoll事件* /
               epoll_data_t数据； / *用户数据变量* /

 };

events  成员变量：

可以是以下几个宏的集合：

EPOLLIN ：表示对应的文件描述符可以读（包括对端SOCKET正常关闭）；

EPOLLOUT：表示对应的文件描述符可以写；

EPOLLPRI：表示对应的文件描述符有紧急的数据可读（这里应该表示有带外数据到来）；

EPOLLERR：表示对应的文件描述符发生错误； EPOLLHUP：表示对应的文件描述符被挂断；

EPOLLET： 将EPOLL设为边缘触发(Edge Triggered)模式，这是相对于水平触发(Level Triggered)来说的。

EPOLLONESHOT：只监听一次事件，当监听完这次事件之后，如果还需要继续监听这个socket的话，需要再次把这个socket加入到EPOLL队列里。

返回值：成功时，epoll_ctl（）返回零。发生错误时，epoll_ctl（）返回-1并正确设置了errno。

错误errno：
       EBADF：epfd或fd不是有效的文件描述符。

       EEXIST：op为EPOLL_CTL_ADD，并且提供的文件描述符fd已在该epoll实例中注册。

       EINVAL：epfd不是epoll文件描述符，或者fd与epfd相同，或者此接口不支持请求的操作op。

       ENOENT：op是EPOLL_CTL_MOD或EPOLL_CTL_DEL，并且fd未在该epoll实例中注册。

       ENOMEM：没有足够的内存来处理请求的操作控制操作。

       ENOSPC：尝试在主机上注册（EPOLL_CTL_ADD）新文件描述符时遇到了/ proc / sys / fs / epoll / max_user_watches施加的限制。

       EPERM：目标文件fd不支持epoll。