epoll_event

epoll_event 是 Linux 内核提供的一个数据结构，用于在 epoll 机制中表示事件。epoll 是一种高效的 I/O 事件通知机制，通常用于处理大量并发连接。epoll_event 结构体定义在 <sys/epoll.h> 头文件中，主要用于传递文件描述符及其相关的事件类型。

epoll_event 结构体的定义如下：

struct epoll_event {
    uint32_t events; /* Epoll events */
    epoll_data_t data; /* User data variable */
};

下面是 epoll_event 结构体的详细解释：

1. events:

   • 类型为 uint32_t，用于存储事件的类型掩码。
   • 常见的事件类型包括：
     • EPOLLIN：表示对应的文件描述符可以读。
     • EPOLLOUT：表示对应的文件描述符可以写。
     • EPOLLRDHUP：表示对端关闭连接或者半关闭连接。
     • EPOLLPRI：表示有紧急数据可读（带外数据）。
     • EPOLLERR：表示对应的文件描述符发生错误。
     • EPOLLHUP：表示对应的文件描述符挂起事件。

2. data:

   • 类型为 epoll_data_t，这是一个联合体（union），可以用于存储用户自定义的数据，比如文件描述符或者指针等。
   • 定义如下：

     typedef union epoll_data {
         void *ptr;
         int fd;
         uint32_t u32;
         uint64_t u64;
     } epoll_data_t;
     

   • 用户可以使用 data 成员来存储与事件相关的自定义数据，如文件描述符、指针、整数等。epoll 在事件触发时会返回该数据，方便用户识别是哪一个文件描述符发生了事件。

下面是一个简单的示例，展示如何使用 epoll 及 epoll_event 结构：

cpp
#include <sys/epoll.h>
#include <unistd.h>
#include <stdio.h>

#define MAX_EVENTS 10

int main() {
    int epoll_fd = epoll_create1(0);
    if (epoll_fd == -1) {
        perror("epoll_create1");
        return 1;
    }

    struct epoll_event event;
    event.events = EPOLLIN;
    event.data.fd = STDIN_FILENO;

    if (epoll_ctl(epoll_fd, EPOLL_CTL_ADD, STDIN_FILENO, &event) == -1) {
        perror("epoll_ctl");
        close(epoll_fd);
        return 1;
    }

    struct epoll_event events[MAX_EVENTS];
    while (1) {
        int num_events = epoll_wait(epoll_fd, events, MAX_EVENTS, -1);
        if (num_events == -1) {
            perror("epoll_wait");
            close(epoll_fd);
            return 1;
        }

        for (int i = 0; i < num_events; ++i) {
            if (events[i].events & EPOLLIN) {
                char buffer[1024];
                ssize_t count = read(events[i].data.fd, buffer, sizeof(buffer));
                if (count == -1) {
                    perror("read");
                } else {
                    printf("Read %zd bytes: %.*s\n", count, (int)count, buffer);
                }
            }
        }
    }

    close(epoll_fd);
    return 0;
}

在这个示例中，我们创建了一个 epoll 实例，并将标准输入（STDIN_FILENO）添加到 epoll 监控的事件中。当标准输入有数据可读时，epoll_wait 返回事件，程序读取并打印数据。

总之，epoll_event 是 epoll 机制中的核心结构，用于描述文件描述符及其相关的事件类型，通过该结构可以实现高效的 I/O 事件通知。