C / C++ / 系统课时

使用 epoll 管理连接

使用 epoll 管理连接

epoll 适合在单线程或少量 I/O 线程中同时管理大量文件描述符。本课用一个可运行的管道示例串起 epoll_create1、epoll_ctl 与 epoll_wait,重点掌握“注册关注事件、等待就绪、按返回事件分发处理”的完整闭环。

学习目标

  • 能创建 epoll 实例,并用 epoll_ctl 添加、修改和删除文件描述符。
  • 能根据 epoll_wait 返回的事件集合进行分发,而不是遍历全部连接。
  • 能正确处理 EPOLLIN、EPOLLHUP、EPOLLERR 等常见事件。

epoll 的管理模型

epoll 维护的是一组“需要关注的文件描述符及其事件”。程序先创建一个 epoll 实例,再通过 epoll_ctl 把 socket、管道等 fd 注册进去;随后 epoll_wait 只返回当前已经就绪的项,事件循环据此调用对应处理逻辑。

epoll 注册与事件分发流程

三个核心接口职责不同:epoll_create1(EPOLL_CLOEXEC) 创建实例;epoll_ctl 维护关注集合;epoll_wait 获取就绪事件。生产代码通常把连接 fd 放进 ev.data.fd 或 ev.data.ptr,从而在事件返回后定位连接上下文。

用一个可运行示例完成注册与分发

下面创建两条管道,把两个读端都注册到同一个 epoll 实例,然后分别写入数据。epoll_wait 返回时,程序只遍历实际就绪的事件。

c
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/epoll.h>
#include <unistd.h>

#define MAX_EVENTS 8

static void die(const char *msg) {
    perror(msg);
    exit(EXIT_FAILURE);
}

int main(void) {
    int epfd = epoll_create1(EPOLL_CLOEXEC);
    if (epfd == -1) die("epoll_create1");

    int p1[2], p2[2];
    if (pipe(p1) == -1 || pipe(p2) == -1) die("pipe");

    // 两个读端都关注可读事件,并把 fd 自身作为事件上下文保存。
    int read_fds[] = {p1[0], p2[0]};
    for (size_t i = 0; i < 2; ++i) {
        struct epoll_event ev = {0};
        ev.events = EPOLLIN;
        ev.data.fd = read_fds[i];
        if (epoll_ctl(epfd, EPOLL_CTL_ADD, read_fds[i], &ev) == -1) {
            die("epoll_ctl ADD");
        }
    }

    if (write(p1[1], "alpha", 5) != 5) die("write p1");
    if (write(p2[1], "beta", 4) != 4) die("write p2");

    struct epoll_event events[MAX_EVENTS];
    int n = epoll_wait(epfd, events, MAX_EVENTS, 1000);
    if (n == -1) die("epoll_wait");

    for (int i = 0; i < n; ++i) {
        int fd = events[i].data.fd;

        // 错误与挂断通常应优先处理,避免继续把异常连接当正常数据读。
        if (events[i].events & (EPOLLERR | EPOLLHUP)) {
            fprintf(stderr, "fd=%d error-or-hup\n", fd);
            continue;
        }

        if (events[i].events & EPOLLIN) {
            char buf[32];
            ssize_t nr = read(fd, buf, sizeof(buf) - 1);
            if (nr == -1) die("read");
            buf[nr] = '\0';
            printf("fd=%d data=%s\n", fd, buf);
        }
    }

    if (epoll_ctl(epfd, EPOLL_CTL_DEL, p1[0], NULL) == -1) die("DEL p1");
    if (epoll_ctl(epfd, EPOLL_CTL_DEL, p2[0], NULL) == -1) die("DEL p2");

    close(p1[0]); close(p1[1]);
    close(p2[0]); close(p2[1]);
    close(epfd);
    return 0;
}

保存为 epoll_demo.c 后编译并运行:

bash
gcc -Wall -Wextra -O2 epoll_demo.c -o epoll_demo
./epoll_demo

预期输出:

text
fd=<ID> data=alpha
fd=<ID> data=beta

两个 fd 的具体数值由进程当前打开文件决定,因此用 <ID> 表示;两行的先后顺序也可能不同,因为 epoll_wait 不承诺按注册顺序返回事件。

正确使用 epoll_ctl

EPOLL_CTL_ADD 用于首次注册,重复添加同一 fd 会失败并返回 EEXIST;需要修改关注事件时使用 EPOLL_CTL_MOD;不再管理连接时使用 EPOLL_CTL_DEL。连接关闭后仍应同步清理应用层的连接对象,避免把已复用的 fd 误认成旧连接。

在真实服务器中,最常见的变化是按需启用 EPOLLOUT。只有发送缓冲区写满且确实还有待发送数据时,才把 EPOLLOUT 加入关注集合;待缓冲数据写完后再移除。若始终监听可写事件,socket 大多数时间都处于“可写”状态,事件循环会被无意义地反复唤醒。

事件循环的边界处理

epoll_wait 返回 -1 时要检查 errno。如果被信号中断且 errno == EINTR,通常应重新等待;其他错误再按故障处理。返回 0 表示超时,不是错误,可用于执行定时任务、空闲连接清理或退出检查。

处理连接事件时,应把 EPOLLERR、EPOLLHUP 与正常读写事件一起考虑。对于 socket,即使同时出现 EPOLLIN 与挂断,也可能仍有最后一批数据可读;具体策略取决于协议。稳定的事件循环应做到:只处理本轮返回的就绪项,处理后更新关注集合,并在连接生命周期结束时释放对应资源。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 epoll 管理连接

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

登录哪都通