从零实现加密隧道(三):epoll 用法

int epoll_create(int size);

  • 作用:创建一个 epoll 的句柄。
  • 参数:size 用来告诉内核监听的数目大小,内核会根据 size 的大小去申请对应的内存。
  • 返回值:成功则返回新的 epoll 对象的文件描述符,这个文件描述符用于后续的 epoll 操作。如果不需要使用这个描述符,使用 close 关闭。失败返回 -1 。

int epoll_create1(int flags);

  • 作用:创建一个 epoll 的句柄。
  • 参数:flags的值是 0,epoll_create1()等同于epoll_create()。但是不再根据 size 大小申请内存。而是动态申请内存。flasg 还可以使用其他值。
  • 返回值:成功返回文件描述符。失败返回 -1 。

int epoll_ctl(int epfd, int op, int fd, struct epoll_event *event);

  • 作用:事件注册函数。我个人的理解就是将要监测的目标 fd 添加进 epfd 中。
  • 参数:epfd 是 epoll_create 的返回值。op:添加事件的类型选项。fd:目标文件描述符(需要监听的目标)。event 告诉内核需要监听什么事。
  • 返回值:成功返回 0 ,失败返回 -1 。

op 宏(添加事件的类型选项)有以下几种:

EPOLL_CTL_ADD:在 epfd 中注册新的 fd ,对这个 fd 要监听的是 event。
EPOLL_CTL_MOD:改变已注册到 epfd 的 fd 的监听事件。即改成新的 event。
EPOLL_CTL_DEL:从指定的 epfd 中 删除 fd 文件描述符。在这种模式中 event 是被忽略的,并且为可以等于 NULL 。

struct epoll_event(需要监听的事)结构如下:

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

events 宏有以下几种,可以取他们的并:

EPOLLIN :表示对应的文件描述符执行读时;
EPOLLOUT:表示对应的文件描述符执行写时;
EPOLLPRI:表示对应的文件描述符有紧急的数据可读(这里应该表示有带外数据到来);
EPOLLERR:表示对应的文件描述符发生错误;
EPOLLHUP:表示对应的文件描述符被挂断;
EPOLLET: 将EPOLL设为边缘触发(Edge Triggered)模式,这是相对于水平触发(Level Triggered)来说的。
EPOLLONESHOT:只监听一次事件,当监听完这次事件之后,如果还需要继续监听这个socket的话,需要再次把这个socket加入到EPOLL队列里

epoll_data 的结构如下:

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

一般用法是这样的:

struct epoll_event e;
e.data.fd = socket_fd;
e.events = EPOLLIN | EPOLLOUT;
epoll_ctl(events_fd, EPOLL_CTL_MOD, socket_fd, &e);

int epoll_wait(int epfd, struct epoll_event *events, int maxevents, int timeout);

  • 作用:等待 epfd 中的事件。类似于select()调用。
  • 参数:events 用来从内核得到事件的集合。maxevents 告知内核有多少个 events,必须要大于0。timeout 是用来制定epoll_wait 会阻塞多少毫秒的。

关于 events 的用法一般是这样的:

struct epoll_event events[100000]; // 一个数组
// num 告知用户有多少个事件被监听到,并且这些事件放在 events 数组里了
int num = epoll_wait(epfd, events, 100000, 0); 

// 循环查看 num 个事件
for (int i = 0; i < num; ++i) {
    if (events[i].events & (EPOLLIN | EPOLLPRI)) {
        // 表示对应的文件描述符执行读;即,events[i].data.fd 执行读
        // ...
    } else if (events[i].events & EPOLLOUT) {
        // 表示对应的文件描述符执行写;即,events[i].data.fd 执行写
        // ...
    } else{
        // ...
    }
}

参考:
https://www.jianshu.com/p/ee381d365a29

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值