标签：
一.libev简介
Libev是一个事件循环：你注册感兴趣的特定事件（比如一个文件可以读取时或者发生超时时），它将管理这些事件源，将这些事件反馈给你的程序。为了实现这些，至少要在你的进程（或线程）中执行事件循环句柄控制，然后就能通过回调机制进行事件通信。你通过所谓的watchers注册感兴趣的特定事件，这些watchers都是相对较小的C语言结构体，它们通过初始化具体的事件得到，然后交由libev启动那个watcher。
Libev支持 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
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);
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);
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 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_collect_interval (struct ev_loop *loop, ev_tstamp interval);两个值均默认为0，表示尽量以最小的延迟调用 callback。但这是理想的情况，实际上，比如 select 这样低效的系统调用，由于可以一次性读取很多，所以可以适当地进行延时。通过使用比较高的延迟，但是增加每次处理的数据量，以提高 CPU 效率。
void ev_invoke_pending (struct ev_loop *loop);调用所有的 pending 的 watchers。这个除了可以在 callback 中调用（少见）之外，更多的是在重载的函数中使用。参见下一个函数
void ev_set_invoke_pending_cb (struct ev_loop *loop, void (*invoke_pending_cb(EV_P)));重载 ev_loop 调用 watchers 的函数。新的回调应调用 ev_invoke_pending。如果要恢复默认值，则置喙 ev_invoke_pending 即可。
int ev_pending_count (struct ev_loop *loop);返回当前有多少个 pending 的 watchers。
void ev_set_loop_release_cb (struct ev_loop *loop,
void (*release)(EV_P)throw(),
void (*acquire)(EV_P)throw());这是一个 lock 操作，你可以自定义 lock。其中 release 是 unlock，acquire 是 lock。release 是在 loop 挂起以等待events 之前调用，并且在开始回调之前调用 acquire。
void ev_set_userdata (struct ev_loop *loop, void *data);
void *ev_userdata (struct ev_loop *loop);设置 / 读取 loop 中的用户 data。这一点和 libevent 很不同，libevent 的参数 / 用户数据是以 event 为单位的，而 libev 的原生用户数据是以 loop 为单位的。
void ev_verify (struct ev_loop *loop);验证当前 loop 的设置。如果发现问题，则打印 error msg 并 abort()。
ps: 来自libev手册
标签：
原文地址：http://www.cnblogs.com/qigaohua/p/5883400.html
