一.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