nginx源码初读(8)–让烦恼从main开始ngx

nginx中的事件模块是一个很重要的模块,但这里作为初读,我们只简单看一下ngx_event的数据结构,至于模块和机制,留作之后再分析。

下面是结构体ngx_event_t的代码:

typedefstruct ngx_event_s ngx_event_t;
struct ngx_event_s {
void *data;
/* 事件上下文数据,通常data都是指向ngx_connection_t连接对象。
* 开启文件异步i/o时,它可能会指向ngx_event_aio_t结构体。
* … ngx_int_t ngx_handle_write_event(ngx_event_t *wev, size_t lowat) {
ngx_connection_t *c;
if (lowat) {
c = wev->data; // 在这里event的data就指向了connection_t,直接用指针获取
if (ngx_send_lowat(c, lowat) == ngx_error) {
return ngx_error;
}
}…} …
unsigned write:1;
/* 标志位,为1时表示事件是可写的。通常它表示对应的tcp连接可写,也就是连接处于可以发送网络包的状态。*/unsigned accept:1;
/* 标志位,为1时表示为此事件可以建立新的连接。通常在ngx_cycle_t中的listening动态数组中,
每一个监听对象ngx_listening_t,对应的读事件中的accept标志位才会是1。*/unsigned instance:1;
/* used to detect the stale events in kqueue, rtsig, and epoll
* 这个标志位用于区分当前事件是否过期,它仅仅是给事件驱动模块使用的,而事件消费模块可不用关心。
* 为什么需要这个标志位呢?当开始处理一批事件时,处理前面的事件可能会关闭一些连接,
而这些连接有可能影响这批事件中还未处理到的后面的事件,这时可通过instance来避免处理后面的过期事件。
*/unsigned active:1;
/* the event was passed or would be passed to a kernel;
* in aio mode – operation was posted.
* 标志位,为1表示当前事件是活跃的,为0表示事件是不活跃的。
* 这个状态对应着事件驱动模块处理方式的不同。例如,在添加事件,删除事件和处理事件时,
active标志位的不同都会对应着不同的处理方式。在使用事件时,一般不会直接改变active标志位。
* … if (!rev->delayed) {
if (rev->active && !rev->ready) {
ngx_add_timer(rev, p->read_timeout);
} else if (rev->timer_set) {
ngx_del_timer(rev);
}
} …
*/unsigned disabled:1;
/* 标志位,为1表示禁用事件,仅在kqueue或者rtsig事件驱动模块中有效,对于epoll事件驱动模块则没有意义。
* … if (c->read->active || c->read->disabled) {
ngx_del_event(c->read, ngx_read_event, ngx_close_event);
} … // 位于close_connection函数中
*/ /
unsigned ready:1;
/* the ready event; in aio mode 0 means that no operation can be posted
* 标志位,为1表示当前事件准备就绪,也就是说,允许这个事件的handler处理这个事件。
* 在http框架中,经常会检查事件的ready标志位,以确定是否可以接收请求或者发送相应。
* … if (rev->ready) {
if (ngx_use_accept_mutex) {
ngx_post_event(rev, &ngx_posted_events);
return;
}
rev->handler(rev);
return;
} …
*/unsigned oneshot:1;
/* 该标志位仅对kqueue,eventport等模块有意义,而对于linux上的epoll事件驱动模块则是无意义的。*/unsigned complete:1;
/* aio operation is complete
* 用于异步aio事件的处理 */unsigned eof:1;
unsigned error:1;
/* 标志位,eof表示当前处理的字符流已经结束,error表示事件处理过程出错了。
* … flags = (rev->eof || rev->error) ? ngx_close_event : 0; …
*/unsigned timedout:1;
/* 标志位,为1表示这个事件超时,用以提示handler做超时处理,它与timer_set都用了定时器
* … if (wev->timedout) {
wev->timedout = 0;
ngx_http_perl_handle_request(r);
return;
} …
*/unsigned timer_set:1;
/* 标志位,为1表示这个事件存在于定时器中
* … if (!ngx_cleaner_event.timer_set) {
ngx_add_timer(&ngx_cleaner_event, 30000);
ngx_cleaner_event.timer_set = 1;
} …
*/unsigned delayed:1;
/* 标志位,delayed为1表示需要延迟处理这个事件,它仅用于限速功能 */unsigned deferred_accept:1;
/* 标志位,为1表示延迟建立tcp连接,也就是tcp三次握手后并不建立连接,而是等到真正收到数据包后才建连接 */unsigned pending_eof:1;
/* the pending eof reported by kqueue, epoll or in aio chain operation
* 标志位,为1表示等待字符流结束,它只与kqueue和aio事件驱动机制有关 */unsigned posted:1;
#if (ngx_win32)/* setsockopt(so_update_accept_context) was successful */unsigned accept_context_updated:1;
#endif// 下面这部分都是因不同事件管理机制而不同的,先不看了#if (ngx_have_kqueue)unsigned kq_vnode:1;
/* the pending errno reported by kqueue */int kq_errno;
#endif/*
* kqueue only:
* accept: number of sockets that wait to be accepted
* read: bytes to read when event is ready
* or lowat when event is set with ngx_lowat_event flag
* write: available space in buffer when event is ready
* or lowat when event is set with ngx_lowat_event flag
*
* iocp: todo
*
* otherwise:
* accept: 1 if accept many, 0 otherwise
*/#if (ngx_have_kqueue) || (ngx_have_iocp)int available;
#elseunsigned available:1;
#endif ngx_event_handler_pt handler;
/* 这个事件发生时的处理方法,每个事件处理模块都会重新实现它 */#if (ngx_have_aio)// win下的一种事件驱动模型#if (ngx_have_iocp)
ngx_event_ovlp_t ovlp;
#else // 在linux中定义的aio结构体 struct aiocb aiocb;
#endif#endif ngx_uint_t index;
/* epoll 事件驱动方式不使用index */ ngx_log_t *log;
/* 记录当前event的log对象 */ ngx_rbtree_node_t timer;
/* 定时器节点,用于定时器红黑树中 *//* the posted queue */
ngx_queue_t queue;
unsigned closed:1;
/* to test on worker exit */unsigned channel:1;
unsigned resolver:1;
unsigned cancelable:1;
#if 0/* the threads support *//*
* the event thread context, we store it here
* if $(cc) does not understand __thread declaration
* and pthread_getspecific() is too costly
*/void *thr_ctx;
#if (ngx_event_t_padding)/* event should not cross cache line in smp */ uint32_t padding[ngx_event_t_padding];
#endif#endif
};

我们再看一下event.h里一个数据结构:

typedefstruct {
ngx_int_t (*add)(ngx_event_t *ev, ngx_int_t event, ngx_uint_t flags);
ngx_int_t (*del)(ngx_event_t *ev, ngx_int_t event, ngx_uint_t flags);
/* 添加/移出事件方法,负责把事件添加/移出到操作系统提供的事件驱动机制(如epoll,kqueue等)中,
这样在事件发生之后,将可以/无法调用下面的process_envets时获取这个事件。*/ ngx_int_t (*enable)(ngx_event_t *ev, ngx_int_t event, ngx_uint_t flags);
ngx_int_t (*disable)(ngx_event_t *ev, ngx_int_t event, ngx_uint_t flags);
/* 启用/禁用一个事件,目前事件框架不会调用,大部分事件驱动模块对该方法的实现都与add/del完全一致 */ ngx_int_t (*add_conn)(ngx_connection_t *c);
ngx_int_t (*del_conn)(ngx_connection_t *c, ngx_uint_t flags);
/* 向事件驱动机制中添加/移除一个新的连接,这意味着连接上的读写事件都添加到/移出事件驱动机制中了 */ ngx_int_t (*process_events)(ngx_cycle_t *cycle, ngx_msec_t timer,
ngx_uint_t flags);
/* 在正常的工作循环中,将通过调用process_events方法来处理事件。
* 这个方法仅在ngx_process_events_and_timers方法中调用,它是处理分发事件的核心。*/ ngx_int_t (*init)(ngx_cycle_t *cycle, ngx_msec_t timer);
void (*done)(ngx_cycle_t *cycle);
/* 初始化和退出事件驱动模块的方法 */
} ngx_event_actions_t;
extern ngx_event_actions_t ngx_event_actions;

作为nginx中比较重要的一个驱动,event当然是很复杂的,第一遍看反正怎么也不容易懂,后续刨析了nginx的各种机制和流程应该就很容易懂了,先放过它,继续往下看。

贴个链接:https://segmentfault.com/a/1190000002715203

‘).addclass(‘pre-numbering’).hide();
$(this).addclass(‘has-numbering’).parent().append($numbering);
for (i = 1; i

Posted in 未分类