enum EPOLL_EVENTS详解

enum EPOLL_EVENTS 是 Linux 中 epoll 机制的核心定义之一，它定义了 epoll 支持的所有事件类型。每个事件类型对应一个唯一的位掩码（bitmask），通过按位或（|）可以组合多个事件类型，通过按位与（&）可以检查某个事件是否存在。

以下是对 enum EPOLL_EVENTS 中每个事件标志的详细介绍：

1. EPOLLIN

• 值：0x001（二进制：0000 0000 0000 0001）

• 含义：文件描述符可读。

• 使用场景：

  • 当文件描述符（如套接字）有数据可读时触发。

  • 例如，客户端发送数据到服务器时，服务器的套接字会触发 EPOLLIN 事件。

---

2. EPOLLPRI

• 值：0x002（二进制：0000 0000 0000 0010）

• 含义：有紧急数据可读。

• 使用场景：

  • 当文件描述符有带外数据（Out-of-Band Data，OOB）时触发。

  • 通常用于 TCP 协议的紧急数据。

---

3. EPOLLOUT

• 值：0x004（二进制：0000 0000 0000 0100）

• 含义：文件描述符可写。

• 使用场景：

  • 当文件描述符（如套接字）可以写入数据时触发。

  • 例如，当套接字的发送缓冲区有空间时，会触发 EPOLLOUT 事件。

---

4. EPOLLRDNORM

• 值：0x040（二进制：0000 0000 0100 0000）

• 含义：普通数据可读。

• 使用场景：

  • 当文件描述符有普通数据可读时触发。

  • 类似于 EPOLLIN，但更具体地表示普通数据。

---

5. EPOLLRDBAND

• 值：0x080（二进制：0000 0000 1000 0000）

• 含义：优先带数据可读。

• 使用场景：

  • 当文件描述符有优先带数据（Priority Band Data）可读时触发。

  • 通常用于流式套接字（如 TCP）。

---

6. EPOLLWRNORM

• 值：0x100（二进制：0000 0001 0000 0000）

• 含义：普通数据可写。

• 使用场景：

  • 当文件描述符可以写入普通数据时触发。

  • 类似于 EPOLLOUT，但更具体地表示普通数据。

---

7. EPOLLWRBAND

• 值：0x200（二进制：0000 0010 0000 0000）

• 含义：优先带数据可写。

• 使用场景：

  • 当文件描述符可以写入优先带数据时触发。

  • 通常用于流式套接字（如 TCP）。

---

8. EPOLLMSG

• 值：0x400（二进制：0000 0100 0000 0000）

• 含义：有消息可读。

• 使用场景：

  • 当文件描述符有消息可读时触发。

  • 通常用于特定的协议或场景。

---

9. EPOLLERR

• 值：0x008（二进制：0000 0000 0000 1000）

• 含义：文件描述符发生错误。

• 使用场景：

  • 当文件描述符发生错误时触发。

  • 例如，套接字连接断开或发生协议错误。

---

10. EPOLLHUP

• 值：0x010（二进制：0000 0000 0001 0000）

• 含义：文件描述符挂起。

• 使用场景：

  • 当文件描述符被挂起时触发。

  • 例如，对端关闭连接时，会触发 EPOLLHUP 事件。

---

11. EPOLLRDHUP

• 值：0x2000（二进制：0000 0010 0000 0000）

• 含义：对端关闭连接或半关闭。

• 使用场景：

  • 当对端关闭连接或半关闭时触发。

  • 需要内核版本 2.6.17 以上支持。

---

12. EPOLLEXCLUSIVE

• 值：1u << 28（二进制：0001 0000 0000 0000 0000 0000 0000 0000）

• 含义：独占唤醒模式。

• 使用场景：

  • 当多个线程监听同一个 epoll 实例时，只有一个线程会被唤醒。

  • 用于避免“惊群效应”（Thundering Herd Problem）。

---

13. EPOLLWAKEUP

• 值：1u << 29（二进制：0010 0000 0000 0000 0000 0000 0000 0000）

• 含义：唤醒事件。

• 使用场景：

  • 用于防止系统进入休眠状态。

  • 当事件触发时，系统会保持唤醒状态。

---

14. EPOLLONESHOT

• 值：1u << 30（二进制：0100 0000 0000 0000 0000 0000 0000 0000）

• 含义：一次性事件。

• 使用场景：

  • 当事件触发后，文件描述符会从 epoll 实例中移除。

  • 需要重新添加到 epoll 实例中才能继续监听。

---

15. EPOLLET

• 值：1u << 31（二进制：1000 0000 0000 0000 0000 0000 0000 0000）

• 含义：边缘触发模式。

• 使用场景：

  • 当文件描述符的状态发生变化时触发事件。

  • 默认是水平触发模式（Level-Triggered），边缘触发模式（Edge-Triggered）需要显式设置。

16. 组合事件类型

通过按位或（|）可以组合多个事件类型。例如：

struct epoll_event ev;
ev.events = EPOLLIN | EPOLLOUT | EPOLLET; // 监听可读、可写事件，并使用边缘触发模式

17. 检查事件类型

通过按位与（&）可以检查某个事件是否存在。例如：

if (events[i].events & EPOLLIN) {// 处理可读事件
}
if (events[i].events & EPOLLERR) {// 处理错误事件
}

18. 总结

• enum EPOLL_EVENTS 定义了 epoll 支持的所有事件类型。

• 每个事件类型对应一个唯一的位掩码，可以通过按位或组合多个事件类型，通过按位与检查某个事件是否存在。

• 常用的事件类型包括 EPOLLIN、EPOLLOUT、EPOLLERR、EPOLLHUP 和 EPOLLET。

• 通过合理使用这些事件类型，可以实现高效的事件驱动编程。