Event Poll epoll 详解

由于poll()和select()的局限，2.6内核引入了event poll(epoll)机制。虽然稍微复杂，但是epoll解决了它们共有的基本性能问题，并增加了一些新的特性。

poll()和select()每次调用都需要所有被监听的文件描述符。内核必须遍历所有被监视的文件描述符。当这个表变得很大时，成千上百的文件描述符，每次调用时的遍历就成为了明显的瓶颈。

1、创建一个新的epoll实例

使用epoll_create()或者epoll_cerate1()创建一个epoll上下文。这里epoll_cerate1()是epoll_cerate()的扩展版本。

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

调用成功后,epoll_create()创建一个epoll实例，返回与该实例关联的文件描述符。这个文件描述符和真正的文件没有关系，仅仅是为了后续调用使用epoll而创建的。size参数告诉内核需要监听的文件描述符数目，但不是最大值。传递一个适当的近似值会带来性能的提升，但不需要给出确切的数字。出错时，返回-1，设置errno为下列值之一：

EINVAL   size不是正数

ENFILE    系统达到打开文件数的上限

ENOMEN    没有足够内存完成该次操作。

标准调用如下：

int epfd;
epfd = epoll_create (100); 
if (epfd <0 )
	perror("epoll_create");

epoll_create返回的文件描述符需要用close()关闭。

2、控制 epoll

epoll_ctl 可以向指定的epoll上下文加入或删除文件描述符：

#include <sys/epoll.h>
int epoll_ctl (int epfd, int op, int fd, struct epoll_event *event);

头文件<sys/epoll.h>中定义了epoll event结构体

struct epoll_event {
	_u32 events;
	union {
	void * ptr;
	int fd;
	_u32 u32;
	_u64 u64;
	}data;
};

epoll_ctl()成功调用将关联epoll实例和epfd。参数op指定对fd要进行的操作。event参数描述epoll更具体的行为

以下是参数op的有效值：

EPOLL_CTL_ADD 把fd指定的文件添加到epfd指定的epoll实例监听集中，监听event中定义的事件。

EPOLL_CTL_DEL 把fd指定的文件从epfd指定的epoll监听集中删除。

EPOLL_CTL_MOD 使用event改变在已有fd上的监听行为。

epoll_event结构体中的event参数列出了在给定文件描述符上监听的事件。多个事件可以使用位或运算同时指定。以下是有效值：

EPOLLERR 文件出错。即使不设置这个标志，这个事件也是被监听的。

EPOLLET 使用边沿触发。默认是水平触发。

EPOLLHUP 文件被挂起。即使不设置这个标志，这个事件也是被监听的。

EPOLLIN 文件未阻塞，可读。

EPOLLONESHOT 在一次事件产生被处理之后，文件不在被监听。必须不再被监听。必须使用EPOLL_CTL_MOD指定新的事件，以便重新监听文件。

EPOLLOUT 文件未阻塞，可写。

EPOLLPRI 高优先级的带外数据可读。

event_poll中的data字段由用户使用。确认监听事件后，data会被返回给用户。通常将event.data.fd设定为fd，这样就可以知道那个文件描述符触发事件。

成功后，epoll_ctl()返回0.失败返回-1，并设置errno为下列值：

EBADF epfd不是一个有效的epoll实例，或者fd不是有效文件描述符。

EEXIST op为EPOLL_CTL_ADD，但是fd已经与epfd关联。

EINVAL epfd不是一个epoll实例，epfd和fd相同，或者op无效。

ENOENT op是EPOLL_CTL_MOD或者是EPOLL_CTL_DEL，但是fd没有与epfd关联。

ENOMEN 没有足够内存完成进程的请求。

EPERM fd不支持epoll。

在epfd实例中加入一个fd指定的监听文件，使用如下代码：

struct epoll_event event;
int ret;
event.data.fd = fd;/*return the fd to us later*/
event.events = EPOLLIN|EPOLLOUT  ;
ret = epoll_ctl (epfd,EPOLL_CTL_MOD,fd,&event);
if (ret)
	perror ("epoll_ctl");

修改epfd实例中的fd上的一个监听事件,可以使用如下代码:

struct epoll_event event;
int ret;
event.data.fd = fd;/*return the fd to us later*/
event.events = EPOLLIN ;
ret = epoll_ctl (epfd,EPOLL_CTL_MOD,fd,&event);
if (ret)
	perror ("epoll_ctl");

删除一个fd监听事件,可以使用如下代码:

struct epoll_event event;
int ret;
event.data.fd = fd;/*return the fd to us later*/
event.events = EPOLLIN ;
ret = epoll_ctl (epfd,EPOLL_CTL_DEL,fd,&event);
if (ret)
	perror ("epoll_ctl");

3、等待Epoll事件

epoll_wait()等待给定epoll实例关联的文件描述符上的事件：

#include <sys/epoll.h>
int epoll_wait (int epfd, struct epoll_event * 
	* events, int maxevents, int timeout);

对epoll_wait()的调用等待epoll实例epfd中的文件fd上的事件，时限为timeout毫秒。成功返回，struct epoll_event *events指向包含epoll_event结构体（该结构体描述了每个事件）的内存，且最多可以有maxevents

个事件。这样可以根据events结构体来确定哪些fd触发了事件，从而做出相应的处理。返回值是事件数，出错返回-1，并将errno设置为以下值

EBADF epfd是无效文件描述符

EFAULT 进程对events指向的内存无写权限

EINTR 系统调用在完成前被信号中断

EINVAL epfd不是有效的epoll实例，或者maxevents小于等于0

如果timeout 为0.即使没有事件发生，调用也立即发生，此时调用返回0.如果timeout为-1，调用将一直等待到有事件发生。

当调用epoll_wait()返回，epoll_event结构体中的events数组描述了一次等待发生的事件，最多返回maxevents个事件。data字段包含了用户在调用epoll_ctl前的设置，

如文件的句柄，用来区分那个文件所发生的事件。

一个完整的epoll_wait()例子如下：

#define MAX_EVENTS   64
struct epoll_event * events = NULL;
int nr_events, i, epfd;
events = malloc (sizeof(struct epoll_event) * MAX_EVENTS);
if (! events ){
	perror("malloc");
	exit(-1);
}
nr_events = epoll_wait (epfd,events,MAX_EVENTS,-1);
if (nr_events < 0){
	perror("epoll_wait");
	free(events);
	exit (-1);
}
for (int i=0; i<nr_eventsl i++)
	printf("event = %d on fd = %d 
",
		events[i].events,events[i].data.fd); 

4、边沿触发时间和水平触发事件

EPOLL事件有两种模型 Level Triggered (LT) 和 Edge Triggered (ET)：

LT(level triggered，水平触发模式)是缺省的工作方式，并且同时支持 block 和 non-block socket。在这种做法中，内核告诉你一个文件描述符是否就绪了，然后你可以对这个就绪的fd进行IO操作。如果你不作任何操作，内核还是会继续通知你的，所以，这种模式编程出错误可能性要小一点。

ET(edge-triggered，边缘触发模式)是高速工作方式，只支持no-block socket。在这种模式下，当描述符从未就绪变为就绪时，内核通过epoll告诉你。然后它会假设你知道文件描述符已经就绪，并且不会再为那个文件描述符发送更多的就绪通知，等到下次有新的数据进来的时候才会再次出发就绪事件。

5、man epoll 中的实例

setnonblocking()函数将socket文件设置为非阻塞，因为使用的是ET模式。do_use_fd()是对此文件做出一定的处理，如读写等。

#define MAX_EVENTS 10
struct epoll_event ev, events[MAX_EVENTS];
int listen_sock, conn_sock, nfds, epollfd;

/* Set up listening socket, 'listen_sock' (socket(),
    bind(), listen()) */

epollfd = epoll_create(10);
if (epollfd == -1) {
    perror("epoll_create");
    exit(EXIT_FAILURE);
}

ev.events = EPOLLIN;
ev.data.fd = listen_sock;
if (epoll_ctl(epollfd, EPOLL_CTL_ADD, listen_sock, &ev) == -1) {
    perror("epoll_ctl: listen_sock");
    exit(EXIT_FAILURE);
}

for (;;) {
    nfds = epoll_wait(epollfd, events, MAX_EVENTS, -1);
    if (nfds == -1) {
        perror("epoll_pwait");
        exit(EXIT_FAILURE);
    }

    for (n = 0; n < nfds; ++n) {
        if (events[n].data.fd == listen_sock) {
            conn_sock = accept(listen_sock,
                            (struct sockaddr *) &local, &addrlen);
            if (conn_sock == -1) {
                perror("accept");
                exit(EXIT_FAILURE);
            }
            setnonblocking(conn_sock);
            ev.events = EPOLLIN | EPOLLET;
            ev.data.fd = conn_sock;
            if (epoll_ctl(epollfd, EPOLL_CTL_ADD, conn_sock,
                        &ev) == -1) {
                perror("epoll_ctl: conn_sock");
                exit(EXIT_FAILURE);
            }
        } else {
            do_use_fd(events[n].data.fd);
        }
    }
}