libevent事件处理程序struct event解析

struct event

{

         //ev_next，ev_active_next和ev_signal_next都是双向链表节点指针；它们是libevent对       //不同事件类型和在不同的时期，对事件的管理时使用到的字段。

   //libevent使用双向链表保存所有注册的I/O和Signal事件，ev_next就是该I/O事件在//链表中的位置；称此链表为“已注册事件链表”；

   //同样ev_signal_next就是signal事件在signal事件链表中的位置；

   //ev_active_next：libevent将所有的激活事件放入到链表active list中，然后遍历active list执行调度，ev_active_next就指明了event在active list中的位置；

         TAILQ_ENTRY(event)ev_active_next;

         TAILQ_ENTRY(event)ev_next;

         /*for managing timeouts */

         //min_heap_idx和ev_timeout，如果是timeout事件，它们是event在小根堆中的索引//和超时值，libevent使用小根堆来管理定时事件

         union

         {

                   TAILQ_ENTRY(event)ev_next_with_common_timeout;

                   intmin_heap_idx;

         }ev_timeout_pos;

         //对于I/O事件，是绑定的文件描述符；对于signal事件，是绑定的信号；

         evutil_socket_tev_fd;

         //该事件所属的反应堆实例，这是一个event_base结构体

         structevent_base *ev_base;

         union

         {

                   /*used for io events */

                   struct             

                   {

                            TAILQ_ENTRY(event)ev_io_next;

                            structtimeval ev_timeout;

                   }ev_io;

 

                   /*used by signal events */

                   struct

                   {

                            TAILQ_ENTRY(event) ev_signal_next;

                            //事件就绪执行时，调用ev_callback的次数，通常为1；

                            shortev_ncalls;

                            /*Allows deletes in callback */

                            short*ev_pncalls;

                   }ev_signal;

         }_ev;

         //事件类型

         //I/O事件： EV_WRITE和EV_READ

         //定时事件：EV_TIMEOUT

         //信号： EV_SIGNAL

         //辅助选项：EV_PERSIST，表明是一个永久事件

         shortev_events;

         //记录了当前激活事件的类型,是读事件还是写事件等.

         shortev_res;            /* result passed toevent callback */

         //当前事件的状态，比如EVLIST_INIT

         shortev_flags;

         //优先级

         ev_uint8_tev_pri;   /* smaller numbers are higherpriority */

         ////终止方式三种:EV_CLOSURE_SIGNALEV_CLOSURE_PERSIST EV_CLOSURE_NONE

         ev_uint8_tev_closure;

         //超时值

         structtimeval ev_timeout;

         /*allows us to adopt for different types of events */

         //event的回调函数，被ev_base调用，执行事件处理程序，这是一个函数指针，原型为：void (*ev_callback)(int fd, short events, void *arg)

         void(*ev_callback)(evutil_socket_t, short, void *arg);

         //ev_arg表明可以是任意类型的数据，在设置event时指定；

         void*ev_arg;

};

 

本文重点说明ev_flags  ev_res  ev_closure这三个变量用途及生命周期。

一、ev_flags：记录了该事件的状态，包括如下几种状态

#define EVLIST_TIMEOUT    0x01 

#define EVLIST_INSERTED   0x02  事件已经插入到事件列表中。

#define EVLIST_SIGNAL        0x04

#define EVLIST_ACTIVE        0x08   事件处于激活状态

#define EVLIST_INTERNAL  0x10  ？？

#define EVLIST_INIT      0x80  事件已经初始化

1.在event_assign函数（大部分事件初始化都是在该函数中）中，

ev_flags被初始化为EVLIST_INIT。

2.在event_add_internal里调用event_queue_insert(base,ev, EVLIST_INSERTED)函数，在event_queue_insert函数中，

ev_flags被设置为EVLIST_INIT| EVLIST_INSERTED。

3. 当事件被激活时调用event_active_nolock函数，该函数内部再次调用event_queue_insert(base, ev, EVLIST_ACTIVE);

此时ev_flags被设置为EVLIST_INIT| EVLIST_INSERTED| EVLIST_ACTIVE。

4.在事件执行的时候在event_process_active_single_queue中, 调用event_queue_remove(base,ev, EVLIST_ACTIVE);

         通过ev->ev_flags&= ~queue语句,将激活状态取消,

此时ev_flags被设置为EVLIST_INIT| EVLIST_INSERTED

5.当端口结束工作时,会调用, event_del(struct event *ev)，该函数调用event_del_internal(ev)，在event_del_internal中，会将该事件从哈希表和所有的事件队列中删除。

此时ev_flags被重新设置为EVLIST_INIT

这样一个ev_flags的设置周期基本就结束了。

 

由上可见，ev_flags的作用主要是指出当前的event处于何种状态，相应的函数可以根据该状态作出判断，比如event_del_internal中可以判断该事件如果激活，则从激活队列中删除，如果是已经插入，则还要从插入队列中删除。

以上只是ev_flag的基本用途，在timeout事件中应该还有其他用途。

 

二、ev_res：记录了该事件的状态

包括如下几种状态, 记录了当前激活事件的类型,是读事件还是写事件等

1.在event_assign函数（大部分事件初始化都是在该函数中）中，

 ev_flags被初始化为0。

2.在事件激活时，调用evmap_io_active(structevent_base *base, evutil_socket_t fd, shortevents)，函数，在该函数内部，调用event_active_nolock(ev,ev->ev_events & events, 1);，该函数调用如下语句：

ev->ev_res = res;

作用：

在event_persist_closure(struct event_base *base, structevent *ev)函数或其他类似函数中，

回调函数通过如下回调函数，利用ev->ev_res值

(*ev->ev_callback)(ev->ev_fd,ev->ev_res, ev->ev_arg);

告知订阅端该事件类型。

三、ev_closure:终止方式三种

设置回调函数类型:

#define EV_CLOSURE_NONE 0

#define EV_CLOSURE_SIGNAL 1

#define EV_CLOSURE_PERSIST 2

1.在event_assign函数（大部分事件初始化都是在该函数中）中，

 // switch（event的类型）

  //EV_SIGNAL: ev->ev_closure =EV_CLOSURE_SIGNAL；

  //EV_PERSIST: ev->ev_closure =EV_CLOSURE_PERSIST；

  //其他:ev->ev_closure = EV_CLOSURE_NONE；

2.在event_process_active_single_queue(struct event_base *base,structevent_list *activeq)函数中，如下语句所示：

   switch (ev->ev_closure)

                   {caseEV_CLOSURE_SIGNAL:

                            event_signal_closure(base,ev);

                            break;

                   caseEV_CLOSURE_PERSIST:

                            event_persist_closure(base,ev);

                            break;

                   default:

                   caseEV_CLOSURE_NONE:

                            EVBASE_RELEASE_LOCK(base,th_base_lock);

                            (*ev->ev_callback)(

                                     ev->ev_fd,ev->ev_res, ev->ev_arg);

                            break;

                   }

根据ev->ev_closure的类型，调用不同的回调函数。

所以，ev->ev_closure的作用就是告诉在事件处理时调用不同的处理函数。

http://blog.youkuaiyun.com/jiayp004/article/details/14000183