Linux的epoll用法与数据结构data、event

epoll_create：创建一个指示epoll内核事件表的文件描述符，返回一个epfd。

//该描述符将用作其他epoll系统调用的第一个参数，其实size不起作用。
int epoll_create(int size)

epoll_ctl：操作内核事件表监控的文件描述符上的事件：注册、修改、删除。

int epoll_ctl(int epfd, int op, int fd, struct epoll_event *event)

其中，各个参数如下。

epfd：为epoll_creat的句柄；

op：表示动作，用3个宏来表示：

• EPOLL_CTL_ADD (注册新的fd到epfd)，
  

• EPOLL_CTL_MOD (修改已经注册的fd的监听事件)，
  
• EPOLL_CTL_DEL (从epfd删除一个fd)；
  

event：告诉内核需要监听的事件，event结构体定义如下：

//联合体：多种类型是为了考虑后期的拓展
typedef union epoll_data {
    void *ptr;
    int fd;//存放文件描述符
    __uint32_t u32;
    __uint64_t u64;
} epoll_data_t;

//epoll事件
struct epoll_event {
    __uint32_t events; /* Epoll events */
    epoll_data_t data; /* User data variable */
};

其中，这个void* ptr指针其实主要是为了自定义的数据结构，用处很大，但一般用不到

events描述事件类型，其中**epoll事件类型有以下几种，**他们之间可以使用|或&进行连接：

• EPOLLIN：表示对应的文件描述符可以读（包括对端SOCKET正常关闭）
  
• EPOLLOUT：表示对应的文件描述符可以写
  
• EPOLLPRI：表示对应的文件描述符有紧急的数据可读
  
• EPOLLERR：表示对应的文件描述符发生错误
  
• EPOLLHUP：表示对应的文件描述符被挂断；
  
• EPOLLET：将EPOLL设为边缘触发(Edge Triggered)模式，这是相对于水平触发(Level Triggered)而言的（默认是LT模式，不用写明）
  

• EPOLLONESHOT：只监听一次该事件，当监听完这次事件之后，如果还需要继续监听这个socket的话，需要再次把这个socket加入到EPOLL队列里
  
• EPOLLRDHUP：表示读关闭，对端关闭，不是所有的内核版本都支持；
  

epoll_wait：该函数用于等待所监控文件描述符上有事件的产生。

//返回就绪的文件描述符个数
int epoll_wait(int epfd, struct epoll_event *events, int maxevents, int timeout)

其中，

• events：用来存内核返回的事件的集合；
  
• maxevents：告之内核这个events有多大，不能大于epoll_create()时的size；
  
• timeout：是**超时时间，**指明要等待多久；
  

• 返回值：成功返回有n个文件描述符就绪，时间到时返回0，出错返回-1；
  

参考资料

（主要资料）社长本人的文章