epoll详解【epoll_create】【epoll_ctl】【epoll_wait】

0 - 前言

参考:epoll机制:epoll_create、epoll_ctl、epoll_wait、close

1 - epoll接口

epoll_create

#include <sys / epoll.h>
 
nfd = epoll_creat(max_size);

创建一个内核事件表 (也叫epoll句柄),nfd为epoll句柄(不了解句柄看下一段),参数max_size标识这个监听的数目最大有多大,从Linux 2.6.8开始,max_size参数将被忽略,但必须大于零。每个内核事件表占据一个fd。这个函数其实是在内核申请一块空间,用来存放你想关注的socket fd上是否发生以及发生了什么事件。max_size就是你在这个epoll fd上能关注的最大socket fd数。

返回值:成功时,这些系统调用将返回非负文件描述符。如果出错,则返回-1,并且将errno设置为指示错误。

句柄是一个标识符,是拿来标识对象或者项目的,它就象我们的姓名一样,每个人都会有一个

参考:epoll_create详解

epoll_ctl

#include <sys / epoll.h>
 
int epoll_ctl(int epfd,int op,int fd,struct epoll_event * event);

该系统调用对文件描述符epfd引用的epoll实例执行控制操作。它要求操作op对目标文件描述符fd执行。

函数参数:

  • epfd:由epoll_create产生的epoll句柄
  • op:要进行的的操作,比如EPOLL_CTL_ADD(注册新的fd到epfd中)、EPOLL_CTL_MOD( 修改已经注册的fd的监听事件)、EPOLL_CTL_DEL(从epfd中删除一个fd)
  • fd:需要监听的fd
  • event:指向epoll_event的指针,告诉内核需要监听什么事件

epoll_event是一个结构体,定义如下:


typedef union epoll_data {
    
    
void *ptr;
int fd;
__uint32_t u32;
__uint64_t u64;
} epoll_data_t;
 
struct epoll_event {
    
    
__uint32_t events; /* Epoll events(也就是事件) */
epoll_data_t data; /* User data variable */

epoll_event中的成员events可以是:

扫描二维码关注公众号,回复: 13230710 查看本文章
  • EPOLLIN:表示对应的文件描述符上有可读数据
  • EPOLLOUT:表示对应的文件描述符上可以写数据
  • EPOLLPRI:表示对应的文件描述符有紧急的数据可读
  • EPOLLERR:表示对应的文件描述符发生错误
  • EPOLLHUP:表示对应的文件描述符被挂断
  • EPOLLET: 将EPOLL设为边缘触发(Edge Triggered)模式,这是相对于水平触发(Level Triggered)来说的
  • EPOLLONESHOT:只监听一次事件,当监听完这次事件之后,如果还需要继续监听这个socket的话,需要再次把这个socket加入到epoll队列里

返回值:成功时,epoll_ctl()返回零。发生错误时,epoll_ctl()返回-1并正确设置了errno

参考:epoll_ctl详解

epoll_wait

#include <sys / epoll.h>
 
int epoll_wait(int epfd,struct epoll_event * events, int maxevents,int timeout);

等待文件描述符epfd引用的epoll实例上的I/O事件

函数参数:

  • epfd:由epoll_create产生的epoll句柄
  • events:从内核得到事件的集合
  • maxevents:内核这个events有多大(数组成员的个数),这个maxevents的值不能大于创建epoll_create()时的size
  • timeout:超时时间(毫秒,0会立即返回,-1将永久阻塞),当超过timeout还没有事件触发时,就超时

返回值:需要处理的事件数目,若返回0表示已超时。

epoll_wait运行的原理:等侍注册在epfd上的socket fd的事件的发生,如果发生则将发生的sokct fd和事件类型放入到events数组中。并且,将注册在epfd上的socket fd的事件类型给清空。所以如果下一个循环你还要关注这个socket fd的话,则需要用epoll_ctl(epfd,EPOLL_CTL_MOD,listenfd,&ev)来重新设置socket fd的事件类型。这时不用EPOLL_CTL_ADD,因为socket fd并未清空,只是事件类型清空。这一步非常重要。

参考:epoll_wait详解

猜你喜欢

转载自blog.csdn.net/weixin_44484715/article/details/116805385