技术笔记:libev学习(一)

简介: 技术笔记:libev学习(一)

一.libev简介


  Libev是一个事件循环:你注册感兴趣的特定事件(比如一个文件可以读取时或者发生超时时),它将管理这些事件源,将这些事件反馈给你的程序。为了实现这些,至少要在你的进程(或线程)中执行事件循环句柄控制,然后就能通过回调机制进行事件通信。你通过所谓的watchers注册感兴趣的特定事件,这些watchers都是相对较小的C语言结构体,它们通过初始化具体的事件得到,然后交由libev启动那个watcher。


Libev支持 //代码效果参考:http://www.jhylw.com.cn/012622159.html

select,poll,Linux特有的epoll,BSD特有的kqueue以及Solaris特有的文件描述符事件端口机制(ev_io),Linux信息通知接口(ev_stat),Linux事件文件/信号文件(为了更快更完整的唤醒沉睡线程(ev_async)/信号捕捉(ev_signal))相对定时器(ev_timer),用户自定义的绝对定时器(ev_periodic),同步信号(ev_signal),进程状态改变事件(ev_child),和通过事件循环机制实现的事件观察者管理本身(ev_idle,ev_embed,ev_prepare和ev_check监控)也和文件监控(ev_stat)和有限支持的派生子进程事件(ev_fork)一样。

二.libev特点


  1.关于时间:时间类型为ev_tstamp (Libev描述时间采用一个浮点数,它来自于距离(POSIX)时期的一个(带小数)的秒数)。


  2.错误处理:Libev 知道三类错误:操作系统错误、用法错误和内部错误(bugs) 


当 libev 捕捉到无法处理的操作系统错误时(如一个系统调用返回了libev不能识别的返回值),它通过调用 ev_set_syserr_cb设定的回调函数,它假设这个回调函数可修正这个问题或者是退出。默认行为是打印一个摘要信息并调用 abort()。


当 libev 检测到用法错误(如负的时间),它会打印一条摘要信息并退出(使用 assert 机制,因此宏 NDEBUG 会关闭这种检测); 表明这里有libev调用端的编程错误需要修正。


Libev也有一些内部错误检查,也有大多数的代码错误检查。这些在正常情况下不会触发,他们表明在libev存在一个bug或者更大的错误。


3.全局函数(这些函数可以在任何时候被调用,甚至可以在初始化libev库之前调用)


ev_tstamp ev_time () //返回libev使用它时的当前时间。请注意,ev_now函数通常更快,也经常用来返回你想知道的时间戳。ev_now_update和ev_now组合在一起使用更好


ev_sleep (ev_tstamp interval) //休眠指定的时间间隔:当前线程将被阻塞直到它被中断或者给定的时间间隔已经过去。当interval <= 0.时将立即返回.基本上这是一个精度稍低的sleep()函数.Interval的值是有限制的-libev只保证休眠时间最长为一天(interval <= 86400


int ev_version_major ()


int ev_version_minor () //通过调用ev_version_major 和ev_version_minor函数,你可以找出主要的和次要的ABI链接库版本号。如果需要,你可以比较全局字段EV_VERSION_MAJOR 和 EV_VERSION_MINOR,它们表明了你的程序编译完成后的库版本。


  ev_set_allocator (void (cb)(void ptr, long size)) //这是申请或释放内存的,如果申请内存是返回0,当内存需要被分配(大小!= 0),库可能中止或采取一些潜在的破坏性的行动


例:


static void


persistent_realloc (void ptr, size_t size)


{


for (;;)


{


void newptr = realloc (ptr, size);


if (newptr)


return newptr;


sleep (60);


}


}


...


ev_set_allocator (persistent_realloc);


View Code


ev_set_syserr_cb (void (cb)(const char msg)) //设置发生回系统错误时的调函数


  例:    


static void


fatal_error (const char msg)


{


perror (msg);


abort ();


}


...


ev_set_syserr_cb (fatal_error);


View Code


  ev_feed_signal (int signum) //这个函数可以用来“模拟”一个信号接收。它是完全安全的调用这个函数在任何时间,从任何上下文,包括信号处理程序或随机线程。


  4.该库知道两种类型的循环,默认的循环(支持子进程事件)和动态创建事件循环


struct ev_loop ev_default_loop (unsigned int flags)


常用:ev_default_loop (EVBACKEND_POLL | EVBACKEND_SELECT | EVFLAG_NOENV); //限制测试程序的select、poll的后端,不允许环境设置要考虑


struct ev_loop ev_loop_new (unsigned int flags) //这个函数是线程安全的,常用方式:使用ev_loop_new创建一个时间循环在每个线程中,在主线程中使用默认事件循环。 The flags argumentis usually specified as 0 (or EVFLAG_AUTO).


flags argumentis:


EVFLAG_AUTO:默认值,常用


EVFLAG_NOENV:指定 libev 不使用LIBEV_FLAGS环境变量。常用于调试和测试


EVFLAG_FORKCHECK:与ev_loop_fork()相关,本文暂略


EVFLAG_NOINOTIFY:在ev_stat监听中不使用inotify API


EVFLAG_SIGNALFD:在ev_signal监听中使用signalfd API


EVFLAG_NOSIGMASK:使 libev 避免修改 signal mask。这样的话,你要使 signal 是非阻塞的。在未来的 libev 中,这个 mask 将会是默认值。


EVBACKEND_SELECT:通用后端


EVBACKEND_POLL:除了 Windows 之外的所有后端都可以用


EVBACKEND_EPOLL:Linux 后端


EVBACKEND_KQUEUE:大多数 BSD 的后端


EVBACKEND_DEVPOLL:Solaris 8 后端


EVBACKEND_PORT:Solaris 10 后端


ev_loop_destroy (loop) //Destroys an event loop object


   ev_loop_fork (loop)


int ev_is_default_loop (loop) //判断是否是默认事件循环,是返回ture


unsigned int ev_iteration (loop) //返回当前的 loop 的迭代数。等于 libev pool 新事件的数量(?)。这个值对应ev_prepare和ev_check调用,并在 prepare 和 check 之间增一


unsigned int ev_depth (loop) //返回ev_run()进入减去退出次数的差值


unsigned int ev_backend (struct ev_loop loop);


返回EVBACKEND_


ev_tstamp ev_now (loop)


得到当前的“event loop time”。在 callback 调用期间,这个值是不变的。


void ev_new_update (loop)


更新从ev_now()中返回的时间。不必要的话,不要使用,因为这个函数的开销相对是比较大的。


void ev_suspend (struct ev_loop loop);


void ev_resume (struct ev_loop loop);


暂停当前的 loop,使其刮起当前的所有工作。同时其 timeout 也会暂停。如果恢复后,timer 会从上一次暂停状态继续及时——这一点对于实现一些要连同时间也一起冻结的功能时,非常有用。


注意已经 resume 的loop不能再 resume,反之已经 suspend 的 loop 不能再 suspend。


bool ev_run (struct ev_loop loop, int flags);


初始化 loop 结束后,调用这个函数开始 loop。如果 flags == 0,直至 loop 没有活跃的时间或者是调用了 ev_bread 之后停止。


Loop 可以是异常使能的,你可以在 callback 中调用longjmp来终端回调并且跳出 ev_run,或者通过抛出 C++ 异常。这些不会导致 ev_depth 值减少。


EVRUN_NOWAIT会检查并且执行所有未解决的 events,但如果没有就绪的时间,ev_run 会立刻返回。EVRUN_ONCE会检查所有的 events,在至少每一个 event 都执行了一次事件迭代之后才返回。但有时候,使用ev_prepare/ev_check更好。


以下是ev_run的大致工作流程:


loop depth ++


重设ev_break状态


在首次迭代之前,调用所有 pending watchers


LOOP:


如果置了EVFLAG_FORKCHECK,则检查 fork,如果检测到 fork,则排队并调用所有的 fork watchers


排队并且调用所有 ready 的watchers


如果ev_break被调用了,则直接跳转至 FINISH


如果检测到了 fork,则分离并且重建 kernel state


使用所有未解决的变化更新 kernel state


更新ev_now的值


计算要 sleep 或 block 多久


如果指定了的话,sleep


loop iteration ++


阻塞以等待事件


排队所有未处理的I/O事件


更新ev_now的值,执行 time jump 调整


排队所有超时事件


排队所有定期事件


排队所有优先级高于 pending 事件的 idle watchers


排队所有 check watchers


按照上述顺序的逆序,调用 watchers (check watchers -> idle watchers -> 定期事件 -> 计时器超时事件 -> fd事件)。信号和 child watchers 视为 fd watchers。


如果ev_break被调用了,或者使用了EVRUN_ONCE或者EVRUN_NOWAIT,则如果没有活跃的 watchers,则 FINISH,否则 continue


FINISH:


如果是EVBREAK_ONE,则重设 ev_break 状态


loop depth --


return


void ev_break (struct ev_loop loop, how);


中断 loop。参数可以是 EVBREAK_ONE(执行完一个内部调用后返回)或EVBREAK_ALL(执行完所有)。


下一次调用 ev_run 的时候,相应的标志会清除


void ev_ref (struct //代码效果参考:http://www.jhylw.com.cn/505726521.html

ev_loop loop);

void ev_unref (struct ev_loop loop);


类似于 Objective-C 中的引用计数,只要 reference count 不为0,ev_run 函数就不会返回。


在做 start 之后要 unref;stop 之前要 ref。


void ev_set_io_collect_interval (struct ev_loop loop, ev_tstamp interval);


void ev_set_timeout_coll

相关文章
|
C++ Perl
学习C++笔记427
C++ Web 编程
67 0
|
C++
学习C++笔记414
C++ Web 编程
49 0
|
编译器 C++
学习C++笔记401
C++ 多线程
69 0
|
编译器 Linux C++
学习C++笔记391
C++ 信号处理
79 0
|
iOS开发 C++
学习C++笔记325
C++ 文件和流
79 0
|
C++
学习C++笔记310
C++ 多态
72 0
|
算法 C++
学习C++笔记312
C++ 数据抽象
72 0
|
存储 C++
学习C++笔记297
C++ 重载运算符和重载函数
75 0
|
数据安全/隐私保护 C++
学习C++笔记287
C++ 继承
73 0
|
C++
学习C++笔记286
C++ 继承
81 0