By francis_hao    Aug 5,2017

 

APUE讲多路转接的章节介绍了select、pselect和poll函数。而epoll是linux内核在2.5.44引入的。在glibc 2.3.2添加了支持。

 

epoll_create – 打开一个epoll文件描述符

epoll_ctl – 控制epoll文件描述符接口

epoll_wait – 在epoll文件描述符上等待一个I/O事件

概述

#include <sys/epoll.h>
int epoll_create(int size);
int epoll_ctl(int epfd,
int op,
int fd,
struct epoll_event *event);
int epoll_wait(int epfd,
struct epoll_event *events,int maxevents,
            int timeout);

 

描述

epoll_create()

创建一个epoll(7)实例,返回指向这个实例的文件描述符,这个文件描述符会被之后的epoll函数使用,当该文件描述符不再需要的时候,应当使用close(2)关闭。当所有指向同一个epoll实例的文件描述符都被关闭后,内核会销毁该实例,释放分配的资源以复用。

参数size原本用来告诉内核要添加到epoll实例中文件描述符的数量,内核用这个参数作为一个大概的分配空间大小的指示,以存放描述事件的结构体数据。但是从内核2.6.8之后,这个参数就不再需要了,内核会动态的分配需要的空间大小。但是参数size必须依然是大于0的数,以确保新的epoll函数运行在旧的内核上时能向后兼容。

函数执行成功返回非负的文件描述符,若有错误则返回-1,而且errno被置为相应的值以指示该错误。

epoll_ctl()

这个系统调用对由文件描述符epfd指定的epoll实例执行控制操作,同时需要指定目标文件描述符fd,和对其的操作op。有效的op参数如下

op

说明

EPOLL_CTL_ADD

注册目标文件描述符fd到epoll实例,并关联事件event

EPOLL_CTL_MOD

改变关联到目标文件描述符fd的事件event

EPOLL_CTL_DEL

从epoll实例移除目标文件描述符,event被忽略,可以是NULL

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 */
};

成员events可以是以下常量的按位或集:

events

说明

EPOLLIN

关联的文件可以进行read(2)操作

EPOLLOUT

关联的文件可以进行write(2)操作

EPOLLRDHUP

(since Linux 2.6.17)

对方关闭了流套接字连接,or shut down writing half of connection。

EPOLLPRI

有紧急数据可以进行read(2)操作

EPOLLERR

在关联的文件描述上发生了错误,epoll_wait(2)总会等待这一事件,因此无需对此位置位

EPOLLHUP

关联的文件描述符挂起(Hang up)了,poll_wait(2)总会等待这一事件,因此无需对此位置位

EPOLLET

为关联的文件描述符设置边沿触发,默认的行为是电平触发(Level Triggered)

EPOLLONESHOT

(since Linux 2.6.2)

为关联的文件描述符设置单次行为,这意味着该文件描述符一旦由epoll_wait(2)返回一次事件,就会被内部失能,再不会有其他事件被报告,用户程序必须调用epoll_ctl()函数,使用EPOLL_CTL_MOD命令重新关联event

函数执行成功返回0,错误返回-1,而且errno被置为相应的值。

epoll_wait()

该系统调用等待由文件描述符epfd指定的epoll实例上的事件,由events指向的内存区域包含了准备好的事件。至多有maxevents个事件由epoll_wait()返回,该值必须大于0。timeout参数指定epoll_wait()将最多阻塞多长时间(ms)。指定-1使epoll_wait()一直等待,直到有准备好的事件,而指定0使epoll_wait()立即返回,即使没有事件准备好。

函数执行成功返回准备好的文件描述符的数量,如果在timeout时间内仍然没有文件描述符准备好则返回0,错误返回-1,而且errno被置为相应的值。

 

两点要注意:

  1. epoll_ctl(int epfd, int op, int fd, struct epoll_event *event),fd和event的fd必须同时赋值
  2. close不能使文件描述符从epoll中移除,必须使用epoll_ctl的EPOLL_CTL_DEL(此情况是已经有数据在缓存里,还未调用epoll_wait,此时先close再调用epoll_wait的情况)

 

实例

一个简单的用法:

#include <sys/epoll.h>
#include <stdio.h>
#include <string.h>
int main(void)
{
    int epoll_fd;
    int fds_num;
    char str[50]={0};
    struct epoll_event ev_in,ev_out;
    fds_num =
0;

    epoll_fd = epoll_create(2);
/*this 'size' argument is ignored*/
    if
(-1
== epoll_fd){
        perror("epoll_create");
        return
-1;
    }
    memset(&ev_in,
0,
sizeof
(ev_in));
    memset(&ev_out,
0,
sizeof
(ev_out));
    ev_in.events = EPOLLIN;
    if
(-1
== epoll_ctl(epoll_fd, EPOLL_CTL_ADD,
0,
&ev_in)){/*Register the target file descriptor 0,that is stdin*/
        perror("epoll_ctl");
        return
-1;
    }

#define TIMEOUT 20
    while(1){
        fds_num = epoll_wait(epoll_fd,
&ev_out,
5, TIMEOUT*1000);
        //fds_num = epoll_wait(epoll_fd, &ev_out, 5, -1);
        if
(-1
== fds_num){
            perror("epoll_wait");
            return
-1;
        }else
if
(0
== fds_num){
            printf("none data within %u s\n",TIMEOUT);
            return
0;
        }
        if
(
0
== ev_out.data.fd){
            if
((ev_out.events & EPOLLIN)
!=
0){
                //printf("events is %x\n",ev_out.events);
                if
(-1
== read(0, str,
50)){
                    perror("read");
                    return
-1;
                }
                printf("%s",str);
                memset(str,
0
,sizeof
(str));
            }
        }else{
            printf("%d\n",ev_out.data.fd);
        }
    }
    return
0;
}

执行结果:

程序源码在github上,可以直接clone编译测试:
epoll

 

 


本文由
刘英皓 创作,采用 知识共享 署名-非商业性使用-相同方式共享 3.0 中国大陆 许可协议进行许可。欢迎转载,请注明出处:
转载自:http://www.cnblogs.com/yinghao1991/p/7291912.html

 

 

参考

【1】man 7 epoll

【2】man epoll_create

【3】man epoll_ctl

【4】man epoll_wait

 

I/O多路转接-epoll的更多相关文章

  1. Linux下I/O多路转接之epoll(绝对经典)

    epoll 关于Linux下I/O多路转接之epoll函数,什么返回值,什么参数,我不想再多的解释,您不想移驾,我给你移来: http://blog.csdn.net/colder2008/artic ...

  2. 【Nginx】I/O多路转接之select、poll、epoll

    当需要读两个以上的I/O的时候,如果使用阻塞式的I/O,那么可能长时间的阻塞在一个描述符上面,另外的描述符虽然有数据但是不能读出来,这样实时性不能满足要求,大概的解决方案有以下几种: 1.使用多进程或 ...

  3. 高级I/O之I/O多路转接——pool、select

    当从一个描述符读,然后又写到另一个描述符时,可以在下列形式的循环中使用阻塞I/O: ) if (write(STDOUT_FILENO, buf, n) != n) err_sys("wri ...

  4. IO多路转接select和poll

    select IO多路复用的设置方法与信号的屏蔽有点相似: 信号屏蔽需要先设定一个信号集, 初始化信号集, 添加需要屏蔽的信号, 然后用sigprocmask设置 IO多路转接需要先设定一个文件描述符 ...

  5. I/O多路转接 --- UNIX环境高级编程

    I/O多路转接技术:先构造一张有关描述符的列表,然后调用一个函数,知道这些描述符中的一个已准备好进行I/O时,给函数才返回.在返回时,它告诉进程哪些描述符已准备好可以进行I/O. poll.selec ...

  6. I/O多路转接模型

    body, table{font-family: 微软雅黑; font-size: 13.5pt} table{border-collapse: collapse; border: solid gra ...

  7. Linux下I/O多路转接之select --fd_set

    fd_set 你终于还是来了,能看到这个标题进来的,我想,你一定是和我遇到了一样的问题,一样的疑惑,接下来几个小时,我一定竭尽全力,写出我想说的,希望也正是你所需要的: 关于Linux下I/O多路转接 ...

  8. UNIX环境高级编程——I/O多路转接(select、pselect和poll)

    I/O多路转接:先构造一张有关描述符的列表,然后调用一个函数,直到这些描述符中的一个已准备好进行I/O时,该函数才返回.在返回时,它告诉进程哪些描述符已准备好可以进行I/O. poll.pselect ...

  9. select函数与I/O多路转接

    select函数与I/O多路转接 相作大家都写过读写IO操作的代码,例如从socket中读取数据可以使用如下的代码: while( (n = read(socketfd, buf, BUFSIZE) ...

随机推荐

  1. 基于GTID的MySQL主从复制#从原理到配置

    GTID是一个基于原始mysql服务器生成的一个已经被成功执行的全局事务ID,它由服务器ID以及事务ID组合而成.这个全局事务ID不仅仅在原始服务器器上唯一,在所有存在主从关系 的mysql服务器上也 ...

  2. tail命令使用

    1.tail命令 命令的主要用途是将指定的文件的最后部分输出到终端,如果该文件有更新,tail会自己主动刷新. 2.tail语法 tail [ -f ] [ -c Number | -n Number ...

  3. iScroll实现下拉刷新上拉加载

    前言 初学iscroll这个控件,给我的一个感觉还是蛮不错的. 什么是iScroll:是目前最成熟的自定义滚动解决方案之一,在移动端和PC有很好的兼容性.iScroll官方提供了5个不同的版本 isc ...

  4. HyperLedger Fabric 1.4 架构(6.2)

    6.2.1 架构演进       Fabric架构经历了0.6版本到1.0版本的演进,架构上进行了重大改进,从0.6版本的结构简单演进到可扩展.多通道的设计,在架构上有了质的飞跃:从1.0版本以后,架 ...

  5. 基于vue来开发一个仿饿了么的外卖商城(一)

    一.准备工作 1.大前提:已安装好node. npm. vue. vue-cli.stylus(此项目使用stylus来编译) 2.开发软件:Google Chrome(建议安装插件vue-devto ...

  6. Educational Codeforces Round 47 (Rated for Div. 2) :D. Relatively Prime Graph

    题目链接:http://codeforces.com/contest/1009/problem/D 解题心得: 题意就是给你n个点编号1-n,要你建立m条无向边在两个互质的点之间,最后所有点形成一个连 ...

  7. Oracle错误记录

    1 SQLPlus无法登陆oracle,PLSql可以登陆,报错ORA-12560 环境变量 右击计算机属性-->高级系统设置-->高级-->环境变量-->系统变量--> ...

  8. python基础之反射、面向对象进阶

    isinstance(obj,cls)和issubclass(sub,super) isinstance(obj,cls)检查是否obj是否是类 cls 的对象,如果是返回True 1 class F ...

  9. itop-4412开发板使用第一篇-信号量的学习使用

    1. 本次基于itop-4412研究下Linux信号量的使用方法. 2. 创建信号量的函数,信号量的头文件在那个路径?编译应用程序的话,头文件有3个路径,内核源码头文件,交叉编译器头文件,ubuntu ...

  10. Use Matlab though C++

    0. Environment Windows 8.1 Pro x64 Matlab R2013a 32-bit (installed in "F:\ProgramFiles_x86\MATL ...