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 在 Reactor 中的等待与分派流程

epoll 报告的是“当前条件是否成立”,而不是“某件事曾发生一次”。水平触发模式下,只要接收缓冲区仍有数据,EPOLLIN 就可以继续被报告;如果一直关注 EPOLLOUT,大多数空闲连接也会因为可写而不断唤醒事件循环。

封装创建、注册与等待

下面给出一个最小可运行的 Epoll 封装。它支持新增、修改、删除兴趣集合,并在 epoll_wait 被 EINTR 打断时重新等待。示例使用 socketpair 构造本地全双工连接,先发送数据触发可读事件,再关闭对端写方向观察半关闭事件。

cpp
#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]);
}

预期输出:

text
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。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 epoll 等待就绪事件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通