epoll
是 Linux 下多路复用 I/O 接口 select/poll 的增强版本,它能显著提高程序在大量并发连接中只有少量活跃的情况下的系统 CPU 利用率。epoll
通过一组函数来实现其功能,其中最主要的三个函数是:epoll_create()
, epoll_ctl()
, 和 epoll_wait()
。下面分别介绍这三个函数:
1. epoll_create(int size)
- 功能:创建一个新的 epoll 实例。该函数返回一个文件描述符,这个文件描述符将用于后续的
epoll_ctl()
和epoll_wait()
调用。 - 参数:
size
是提示内核这个 epoll 实例将要监听的文件描述符的数量。然而,这个参数在 Linux 2.6.8 之后的版本中被忽略,因为内核会动态调整大小。 - 返回值:成功时,返回一个新的文件描述符;失败时,返回 -1 并设置 errno 以指示错误。
2. epoll_ctl(int epfd, int op, int fd, struct epoll_event *event)
- 功能:用于控制 epoll 实例上的某个文件描述符的行为。可以添加新的文件描述符到 epoll 实例中监听,修改已存在的文件描述符的监听方式,或者从 epoll 实例中删除某个文件描述符。
- 参数:
epfd
:由epoll_create()
返回的 epoll 文件描述符。op
:操作类型,常见的有三个值:EPOLL_CTL_ADD
(添加),EPOLL_CTL_MOD
(修改),EPOLL_CTL_DEL
(删除)。fd
:需要操作的目标文件描述符。event
:指向epoll_event
结构的指针,该结构定义了fd
上感兴趣的事件类型(如读就绪、写就绪等)以及一个关联的数据项(通常用于在epoll_wait()
返回时识别是哪个文件描述符发生了事件)。
- 返回值:成功时返回 0;失败时返回 -1 并设置 errno 以指示错误。
3. epoll_wait(int epfd, struct epoll_event *events, int maxevents, int timeout)
- 功能:等待在 epoll 实例上注册的文件描述符上的事件发生。这个函数会阻塞调用者,直到有事件发生或者超时发生。
- 参数:
epfd
:由epoll_create()
返回的 epoll 文件描述符。events
:指向epoll_event
数组的指针,用于存储返回的事件。maxevents
:events
数组的大小,即本次调用最多返回的事件数量。timeout
:等待事件发生的时间,单位为毫秒。如果timeout
为 -1,则epoll_wait()
会无限期地等待,直到有事件发生;如果timeout
为 0,则epoll_wait()
会立即返回,不阻塞调用者。
- 返回值:成功时返回发生事件的数量,可能为 0(表示超时但无事件发生);失败时返回 -1 并设置 errno 以指示错误。
这三个函数共同构成了 epoll
高效处理大量并发连接的基础。