event的回调函数定义及event结构和event_base结构中各个成员的描述

libevent实现了网络IO,timer,signal的事件触发机制. 可以很方便的应用于event-driven服务器中,作为其底层事件处理模块. 比较成功的案

例有 memcache(分布式缓存), PLB(负载均衡器)等.

1. 回调函数定义
void (*ev_callback)(int, short, void *arg);

这个回调函数的参数的意思为:
参数1: 表示触发事件的文件句柄,比如一个socket对象.
参数2: 表示事件发生的结果,可能是超时、可读、可写.
参数3: 表示传递给事件的参数.

2. event的结构描述
struct event {
TAILQ_ENTRY (event) ev_next; /*增加下一个事件*/
TAILQ_ENTRY (event) ev_active_next; /*增加下一个活动事件*/
TAILQ_ENTRY (event) ev_signal_next; /*增加下一个信号*/
unsigned int min_heap_idx; /* for managing timeouts 表示该event保存在min_heap数组中的索引*/

struct event_base *ev_base; /* 一个全局变量,管理着事件，如事件总数，事件列表*/

int ev_fd; /*文件描述符,比如一个socket*/
short ev_events; /*该事件的触发信号,如EV_READ|EV_WRITE
short ev_ncalls; /*触发该事件后的调用次数*/
short *ev_pncalls; /* Allows deletes in callback */

struct timeval ev_timeout; //用来保存事件的超时时间

int ev_pri; /* smaller numbers are higher priority */

void (*ev_callback)(int, short, void *arg); /*事件的回调函数*/
void *ev_arg; /*回调函数的参数*/

int ev_res; /* result passed to event callback */
/*事件的使用过程定义,
1. 初始化(EVLIST_INIT,在event_set中设置)
2. 加入到事件列表(EVLIST_INSERTED,在event_add中设置，
如果使用event_add时指定超时事件,则同时使用EVLIST_TIMEOUT标志把该事件加入到超时事件列表)
3. 事件活动(EVLIST_ACTIVE,在event_active中设置)
*/

int ev_flags;
};

3. event_base 的结构描述

event_base 定义在event-internal.h文件中

struct event_base {
const struct eventop *evsel; //表示选择的事件引擎，可能为:epoll, poll, select
void *evbase; //全局对象
int event_count; /* counts number of total events */
int event_count_active; /* counts number of active events */

int event_gotterm; /* Set to terminate loop */
int event_break; /* Set to terminate loop immediately */

/* active event management */
struct event_list **activequeues;
int nactivequeues;

/* signal handling info */
struct evsignal_info sig;

struct event_list eventqueue;
struct timeval event_tv; //系统的当前时间

struct min_heap timeheap; //用来检测事件是否超时的堆栈

struct timeval tv_cache; //与event::ev_timeout进行比较,确定事件是否超时
};