eventfd是Linux内核提供的轻量级事件通知机制，本质为8字节原子计数器，无内存拷贝、无锁、支持epoll，比pipe少fd、比condition_variable少锁开销，仅传递信号不传数据。
eventfd 是什么，为什么它比 pipe 或 condition_variable 更轻量
eventfd 是 Linux 内核提供的一个专用事件通知机制，本质是一个 8 字节的无符号整数计数器（uint64_t），通过文件描述符暴露给用户空间。它不涉及内存拷贝、不分配缓冲区、不触发上下文切换（除非阻塞读写），比 pipe 少两个 fd、比 std::condition_variable 少锁和条件变量对象开销，天然支持 epoll 等 I/O 多路复用。
关键点在于：它只传递“有事件”这个信号（或带计数的批量信号），不传数据；所有操作原子（内核保证 read/write 对 8 字节计数器的读写是原子的），因此上层可完全避免加锁。
常见误用：试图用 eventfd 传递结构体或字符串——它做不到，也无需做到。
创建与基本读写：注意非阻塞 + EAGAIN 和 CLOEXEC
创建 eventfd 时必须显式指定 EFD_CLOEXEC | EFD_NONBLOCK，否则 fork 后子进程可能意外继承 fd，或在无事件时 read 阻塞线程（破坏“无锁唤醒”的初衷）。
-
int efd = eventfd(0, EFD_CLOEXEC | EFD_NONBLOCK);—— 初始值为 0，非阻塞、自动 close-on-exec - 写事件：
uint64_t val = 1; write(efd, &val, sizeof(val));—— 即使 val=1，也必须传完整 8 字节 - 读事件：
uint64_t val; ssize_t n = read(efd, &val, sizeof(val));—— 成功时 n == 8，val 是被消费的计数值；若返回 -1 且errno == EAGAIN，说明当前无事件 - 不要忽略
write的返回值：当计数器溢出（> 2⁶⁴−1）时会失败，但一般只用于信号通知，极少写入大值
跨线程唤醒：主线程 epoll_wait，工作线程 write，注意内存序无关
eventfd 的计数器更新由内核原子完成，用户空间无需任何 std::atomic 或内存屏障。只要 fd 在线程间正确共享（如全局变量、成员变量、通过参数传递），就能安全使用。
典型模式：
- 主线程（IO 线程）将
efd加入epoll：用epoll_ctl(epfd, EPOLL_CTL_ADD, efd, &ev)，监听EPOLLIN - 工作线程调用
write(efd, &val, sizeof(val))发送唤醒信号；即使主线程正在epoll_wait中休眠，也会立即返回 - 主线程从
epoll_wait返回后，必须read(efd, &val, ...)清空计数器（否则下次epoll_wait会立刻再次返回） - 不需要互斥访问
efd：多个工作线程并发write是安全的，计数器会累加；主线程单次read会一次性读走全部计数
常见陷阱：忘记 read 导致 busy-loop，以及多线程 close 竞态
最常踩的坑是只 write 不 read。一旦写入，eventfd 计数器 > 0，epoll_wait 每次都会返回就绪，主线程陷入空转，CPU 占用飙高。
另一个隐蔽问题是：多个线程可能同时决定关闭 eventfd（比如线程退出时清理资源）。close(efd) 是引用计数的，但若一个线程刚 close 完，另一个线程立刻 write，会触发 Bad file descriptor 错误。
- 解决方案：统一由创建者（或生命周期管理者）负责
close，其他线程只读写；或用std::shared_ptr包装 fd 和销毁逻辑 - 调试技巧：用
strace -e trace=eventfd2,read,write,close,epoll_wait观察 fd 行为，确认是否漏 read 或重复 close - 注意：Windows 不支持 eventfd，跨平台项目需封装抽象层（例如用
pipe+epoll/IOCP 模拟）
真正难的是设计好事件语义——比如一次 write 代表“有新任务”，还是“有 N 个任务”，这决定了工作线程要不要批量写入、主线程要不要循环 read 直到 EAGAIN。这些逻辑不在 eventfd 里，但在它之上必须想清楚。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
