C / C++ / 系统课时
用 epoll 等待就绪事件
用 epoll 等待就绪事件
Reactor 的核心循环不是主动轮询每个连接,而是把文件描述符交给 epoll,阻塞等待内核返回已经就绪的 fd。本节封装创建、注册和等待接口,并在水平触发模式下正确识别可读、可写、错误与挂断事件。
学习目标
- 使用
epoll_create1、epoll_ctl和epoll_wait管理监听集合 - 正确解释
EPOLLIN、EPOLLOUT、EPOLLERR、EPOLLHUP与EPOLLRDHUP - 理解水平触发下未处理完的条件为什么会再次产生就绪通知
epoll 在 Reactor 中的位置
Reactor 通常维护“fd 到 Channel”的关联。Channel 表示某个 fd 关注哪些事件,Poller 把兴趣集合提交给 epoll;epoll_wait 返回就绪事件后,EventLoop 根据 fd 找回对应 Channel,再调用读取、写入、错误或关闭处理逻辑。

epoll 报告的是“当前条件是否成立”,而不是“某件事曾发生一次”。水平触发模式下,只要接收缓冲区仍有数据,EPOLLIN 就可以继续被报告;如果一直关注 EPOLLOUT,大多数空闲连接也会因为可写而不断唤醒事件循环。
封装创建、注册与等待
下面给出一个最小可运行的 Epoll 封装。它支持新增、修改、删除兴趣集合,并在 epoll_wait 被 EINTR 打断时重新等待。示例使用 socketpair 构造本地全双工连接,先发送数据触发可读事件,再关闭对端写方向观察半关闭事件。
#include <sys/epoll.h>
#include <sys/socket.h>
#include <unistd.h>
#include <cerrno>
#include <cstring>
#include <iostream>
#include <stdexcept>
#include <vector>
class Epoll {
public:
Epoll() {
fd_ = ::epoll_create1(EPOLL_CLOEXEC);
if (fd_ < 0) {
throw std::runtime_error(std::strerror(errno));
}
}
~Epoll() {
if (fd_ >= 0) {
::close(fd_);
}
}
void add(int fd, uint32_t events) {
update(EPOLL_CTL_ADD, fd, events);
}
void modify(int fd, uint32_t events) {
update(EPOLL_CTL_MOD, fd, events);
}
void remove(int fd) {
if (::epoll_ctl(fd_, EPOLL_CTL_DEL, fd, nullptr) < 0) {
throw std::runtime_error(std::strerror(errno));
}
}
int wait(std::vector<epoll_event>& events, int timeout_ms) {
int n;
do {
n = ::epoll_wait(fd_, events.data(),
static_cast<int>(events.size()), timeout_ms);
} while (n < 0 && errno == EINTR);
if (n < 0) {
throw std::runtime_error(std::strerror(errno));
}
return n;
}
private:
void update(int operation, int fd, uint32_t events) {
epoll_event ev{};
ev.events = events;
ev.data.fd = fd;
if (::epoll_ctl(fd_, operation, fd, &ev) < 0) {
throw std::runtime_error(std::strerror(errno));
}
}
int fd_{-1};
};
void print_flags(uint32_t events) {
std::cout
<< "readable=" << static_cast<bool>(events & EPOLLIN)
<< " writable=" << static_cast<bool>(events & EPOLLOUT)
<< " error=" << static_cast<bool>(events & EPOLLERR)
<< " hangup=" << static_cast<bool>(events & (EPOLLHUP | EPOLLRDHUP))
<< "\n";
}
int main() {
int sv[2];
if (::socketpair(AF_UNIX, SOCK_STREAM | SOCK_NONBLOCK | SOCK_CLOEXEC,
0, sv) < 0) {
throw std::runtime_error(std::strerror(errno));
}
Epoll epoll;
epoll.add(sv[0], EPOLLIN | EPOLLRDHUP);
const char payload[] = "hello";
if (::send(sv[1], payload, sizeof(payload) - 1, 0) < 0) {
throw std::runtime_error(std::strerror(errno));
}
std::vector<epoll_event> events(8);
int n = epoll.wait(events, 1000);
if (n > 0) {
print_flags(events[0].events);
char buffer[32];
const ssize_t received = ::recv(sv[0], buffer, sizeof(buffer), 0);
std::cout << "received=" << received << "\n";
}
::shutdown(sv[1], SHUT_WR);
n = epoll.wait(events, 1000);
if (n > 0) {
print_flags(events[0].events);
}
epoll.remove(sv[0]);
::close(sv[0]);
::close(sv[1]);
}预期输出:
readable=1 writable=0 error=0 hangup=0
received=5
readable=1 writable=0 error=0 hangup=1不同 Linux 内核可能同时返回其他兼容事件位,但第一次等待应能观察到可读事件,关闭对端写方向后应能观察到挂断语义。示例中的 1000 毫秒超时只为避免测试永久阻塞,真实 EventLoop 通常会结合定时器系统动态计算等待时间。
正确解释就绪事件
EPOLLIN 表示当前执行读取操作不会因为“完全没有数据”而阻塞。在非阻塞 socket 中,生产代码通常循环读取,直到 recv 返回 EAGAIN 或 EWOULDBLOCK。水平触发即使一次没有读完也不会永久丢失通知,但未消费的数据会让该 fd 很快再次被报告。
EPOLLOUT 表示发送缓冲区当前存在可用空间。它不应该永久注册:多数正常连接绝大部分时间都处于可写状态,持续监听会让 EventLoop 被大量无意义事件唤醒。常见策略是输出缓冲区出现积压时才增加 EPOLLOUT,数据全部写完后立即通过 EPOLL_CTL_MOD 取消关注。
EPOLLERR 和 EPOLLHUP 不能被普通读写分支覆盖掉。遇到 EPOLLERR 时,可通过 getsockopt(fd, SOL_SOCKET, SO_ERROR, ...) 获取挂起错误;EPOLLRDHUP 则常用于感知对端关闭写方向。挂断和可读可能同时出现,因为内核接收缓冲区里仍可能留有最后一批数据。
验证水平触发行为
水平触发的判断标准是“就绪条件是否仍成立”。如果接收缓冲区有 5 字节,而回调只读取 2 字节,剩余数据仍让 socket 保持可读,所以紧接着再次调用 epoll_wait 时还能得到 EPOLLIN。
可以把前面示例的 recv 缓冲区缩小到 2 字节,并在第一次读取后立即再次执行 epoll_wait。预期仍会取得同一个 fd 的可读事件,直到剩余数据被消费完毕。这个特性降低了初版 Reactor 的实现难度,但也意味着处理不充分的连接可能频繁占用事件循环。
可写事件的验证方向相反:只有真正存在尚未发送的数据时才注册 EPOLLOUT。写缓冲区清空后调用 modify 移除该标志,下一轮事件循环就不应因为“普通可写”持续唤醒。
当 Epoll 只负责兴趣集合和原始事件,Channel 负责解释事件,Connection 负责连接状态与实际 I/O 时,Reactor 的职责边界就清晰了:Poller 不处理业务连接状态,连接对象也不需要直接散落调用 epoll_ctl。