epoll_ctl()对文件描述符epfd引用的epoll实例执行控制操作

1，头文件：

#include <sys / epoll.h>

2，函数声明：

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

3，函数说明：

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

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

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

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

结构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数据； / *用户数据变量* /
};

4，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。