epoll详解【epoll_create】【epoll_ctl】【epoll_wait】

0 - 前言

参考：epoll机制:epoll_create、epoll_ctl、epoll_wait、close

1 - epoll接口

epoll_create

#include <sys / epoll.h>
 
nfd = epoll_creat(max_size);

创建一个内核事件表 （也叫epoll句柄），nfd为epoll句柄（不了解句柄看下一段），参数max_size标识这个监听的数目最大有多大，从Linux 2.6.8开始，max_size参数将被忽略，但必须大于零。每个内核事件表占据一个fd。这个函数其实是在内核申请一块空间，用来存放你想关注的socket fd上是否发生以及发生了什么事件。max_size就是你在这个epoll fd上能关注的最大socket fd数。

返回值：成功时，这些系统调用将返回非负文件描述符。如果出错，则返回-1，并且将errno设置为指示错误。

句柄是一个标识符，是拿来标识对象或者项目的，它就象我们的姓名一样，每个人都会有一个

参考：epoll_create详解

epoll_ctl

#include <sys / epoll.h>
 
int epoll_ctl（int epfd，int op，int fd，struct epoll_event * event）;

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

函数参数：

• epfd：由epoll_create产生的epoll句柄
• op：要进行的的操作，比如EPOLL_CTL_ADD（注册新的fd到epfd中）、EPOLL_CTL_MOD（ 修改已经注册的fd的监听事件）、EPOLL_CTL_DEL（从epfd中删除一个fd）
• fd：需要监听的fd
• event：指向epoll_event的指针，告诉内核需要监听什么事件

epoll_event是一个结构体，定义如下：

typedef union epoll_data {
void *ptr;
int fd;
__uint32_t u32;
__uint64_t u64;
} epoll_data_t;
 
struct epoll_event {
__uint32_t events; /* Epoll events（也就是事件) */
epoll_data_t data; /* User data variable */

epoll_event中的成员events可以是：

• EPOLLIN：表示对应的文件描述符上有可读数据
• EPOLLOUT：表示对应的文件描述符上可以写数据
• EPOLLPRI：表示对应的文件描述符有紧急的数据可读
• EPOLLERR：表示对应的文件描述符发生错误
• EPOLLHUP：表示对应的文件描述符被挂断
• EPOLLET： 将EPOLL设为边缘触发(Edge Triggered)模式，这是相对于水平触发(Level Triggered)来说的
• EPOLLONESHOT：只监听一次事件，当监听完这次事件之后，如果还需要继续监听这个socket的话，需要再次把这个socket加入到epoll队列里

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

参考：epoll_ctl详解

epoll_wait

#include <sys / epoll.h>
 
int epoll_wait（int epfd，struct epoll_event * events， int maxevents，int timeout）;

等待文件描述符epfd引用的epoll实例上的I/O事件

函数参数：

• epfd：由epoll_create产生的epoll句柄
• events：从内核得到事件的集合
• maxevents：内核这个events有多大(数组成员的个数),这个maxevents的值不能大于创建epoll_create()时的size
• timeout：超时时间（毫秒，0会立即返回，-1将永久阻塞），当超过timeout还没有事件触发时，就超时

返回值：需要处理的事件数目，若返回0表示已超时。

epoll_wait运行的原理：等侍注册在epfd上的socket fd的事件的发生，如果发生则将发生的sokct fd和事件类型放入到events数组中。并且，将注册在epfd上的socket fd的事件类型给清空。所以如果下一个循环你还要关注这个socket fd的话，则需要用epoll_ctl(epfd,EPOLL_CTL_MOD,listenfd,&ev)来重新设置socket fd的事件类型。这时不用EPOLL_CTL_ADD,因为socket fd并未清空，只是事件类型清空。这一步非常重要。

参考：epoll_wait详解