libevent源码分析(一)
分析libevent的源代码,我的想法的是先分析各种结构体,struct event_base、struct event,然后是event_base_new函数、event_new函数、event_add函数,最后分析event_base_dispatch函数。
一、各种结构体
1、event_base
1 struct event_base { 2 /** Function pointers and other data to describe this event_base's 3 * backend. */ 4 const struct eventop *evsel; 5 /** Pointer to backend-specific data. */ 6 void *evbase; 7 8 /** List of changes to tell backend about at next dispatch. Only used 9 * by the O(1) backends. */ 10 struct event_changelist changelist; 11 12 /** Function pointers used to describe the backend that this event_base 13 * uses for signals */ 14 const struct eventop *evsigsel; 15 /** Data to implement the common signal handelr code. */ 16 struct evsig_info sig; 17 18 /** Number of virtual events */ 19 int virtual_event_count; 20 /** Maximum number of virtual events active */ 21 int virtual_event_count_max; 22 /** Number of total events added to this event_base */ 23 int event_count; 24 /** Maximum number of total events added to this event_base */ 25 int event_count_max; 26 /** Number of total events active in this event_base */ 27 int event_count_active; 28 /** Maximum number of total events active in this event_base */ 29 int event_count_active_max; 30 31 /** Set if we should terminate the loop once we're done processing 32 * events. */ 33 int event_gotterm; 34 /** Set if we should terminate the loop immediately */ 35 int event_break; 36 /** Set if we should start a new instance of the loop immediately. */ 37 int event_continue; 38 39 /** The currently running priority of events */ 40 int event_running_priority; 41 42 /** Set if we're running the event_base_loop function, to prevent 43 * reentrant invocation. */ 44 int running_loop; 45 46 /** Set to the number of deferred_cbs we've made 'active' in the 47 * loop. This is a hack to prevent starvation; it would be smarter 48 * to just use event_config_set_max_dispatch_interval's max_callbacks 49 * feature */ 50 int n_deferreds_queued; 51 52 /* Active event management. */ 53 /** An array of nactivequeues queues for active event_callbacks (ones 54 * that have triggered, and whose callbacks need to be called). Low 55 * priority numbers are more important, and stall higher ones. 56 */ 57 struct evcallback_list *activequeues; 58 /** The length of the activequeues array */ 59 int nactivequeues; 60 /** A list of event_callbacks that should become active the next time 61 * we process events, but not this time. */ 62 struct evcallback_list active_later_queue; 63 64 /* common timeout logic */ 65 66 /** An array of common_timeout_list* for all of the common timeout 67 * values we know. */ 68 struct common_timeout_list **common_timeout_queues; 69 /** The number of entries used in common_timeout_queues */ 70 int n_common_timeouts; 71 /** The total size of common_timeout_queues. */ 72 int n_common_timeouts_allocated; 73 74 /** Mapping from file descriptors to enabled (added) events */ 75 struct event_io_map io; 76 77 /** Mapping from signal numbers to enabled (added) events. */ 78 struct event_signal_map sigmap; 79 80 /** Priority queue of events with timeouts. */ 81 struct min_heap timeheap; 82 83 /** Stored timeval: used to avoid calling gettimeofday/clock_gettime 84 * too often. */ 85 struct timeval tv_cache; 86 87 struct evutil_monotonic_timer monotonic_timer; 88 89 /** Difference between internal time (maybe from clock_gettime) and 90 * gettimeofday. */ 91 struct timeval tv_clock_diff; 92 /** Second in which we last updated tv_clock_diff, in monotonic time. */ 93 time_t last_updated_clock_diff; 94 95 #ifndef EVENT__DISABLE_THREAD_SUPPORT 96 /* threading support */ 97 /** The thread currently running the event_loop for this base */ 98 unsigned long th_owner_id; 99 /** A lock to prevent conflicting accesses to this event_base */ 100 void *th_base_lock; 101 /** A condition that gets signalled when we're done processing an 102 * event with waiters on it. */ 103 void *current_event_cond; 104 /** Number of threads blocking on current_event_cond. */ 105 int current_event_waiters; 106 #endif 107 /** The event whose callback is executing right now */ 108 struct event_callback *current_event; 109 110 #ifdef _WIN32 111 /** IOCP support structure, if IOCP is enabled. */ 112 struct event_iocp_port *iocp; 113 #endif 114 115 /** Flags that this base was configured with */ 116 enum event_base_config_flag flags; 117 118 struct timeval max_dispatch_time; 119 int max_dispatch_callbacks; 120 int limit_callbacks_after_prio; 121 122 /* Notify main thread to wake up break, etc. */ 123 /** True if the base already has a pending notify, and we don't need 124 * to add any more. */ 125 int is_notify_pending; 126 /** A socketpair used by some th_notify functions to wake up the main 127 * thread. */ 128 evutil_socket_t th_notify_fd[2]; 129 /** An event used by some th_notify functions to wake up the main 130 * thread. */ 131 struct event th_notify; 132 /** A function used to wake up the main thread from another thread. */ 133 int (*th_notify_fn)(struct event_base *base); 134 135 /** Saved seed for weak random number generator. Some backends use 136 * this to produce fairness among sockets. Protected by th_base_lock. */ 137 struct evutil_weakrand_state weakrand_seed; 138 139 /** List of event_onces that have not yet fired. */ 140 LIST_HEAD(once_event_list, event_once) once_events; 141 142 };
struct event_base结构体在event-internal.h文件中定义。
二、初始化函数
1、event_base_new函数
1 struct event_base * 2 event_base_new(void) 3 { 4 struct event_base *base = NULL; 5 struct event_config *cfg = event_config_new(); 6 if (cfg) { 7 base = event_base_new_with_config(cfg); 8 event_config_free(cfg); 9 } 10 return base; 11 }
(1)调用event_config_new函数分配一个struct event_config结构体。
(2)如果分配成功,就调用event_base_new_with_config(cfg)分配一个struct event_base对象指针,然后将该指针返回。
总结:所以event_base_new还是调用了event_base_new_with_config函数。所以下面接着来看event_base_new_with_config函数。
2、event_base_new_with_config函数
1 struct event_base * 2 event_base_new_with_config(const struct event_config *cfg) 3 { 4 int i; 5 struct event_base *base; 6 int should_check_environment; 7 8 #ifndef EVENT__DISABLE_DEBUG_MODE 9 event_debug_mode_too_late = 1; 10 #endif 11 12 if ((base = mm_calloc(1, sizeof(struct event_base))) == NULL) { 13 event_warn("%s: calloc", __func__); 14 return NULL; 15 } 16 17 if (cfg) 18 base->flags = cfg->flags; 19 20 should_check_environment = 21 !(cfg && (cfg->flags & EVENT_BASE_FLAG_IGNORE_ENV)); 22 23 { 24 struct timeval tmp; 25 int precise_time = 26 cfg && (cfg->flags & EVENT_BASE_FLAG_PRECISE_TIMER); 27 int flags; 28 if (should_check_environment && !precise_time) { 29 precise_time = evutil_getenv_("EVENT_PRECISE_TIMER") != NULL; 30 base->flags |= EVENT_BASE_FLAG_PRECISE_TIMER; 31 } 32 flags = precise_time ? EV_MONOT_PRECISE : 0; 33 evutil_configure_monotonic_time_(&base->monotonic_timer, flags); 34 35 gettime(base, &tmp); 36 } 37 38 min_heap_ctor_(&base->timeheap); 39 40 base->sig.ev_signal_pair[0] = -1; 41 base->sig.ev_signal_pair[1] = -1; 42 base->th_notify_fd[0] = -1; 43 base->th_notify_fd[1] = -1; 44 45 TAILQ_INIT(&base->active_later_queue); 46 47 evmap_io_initmap_(&base->io); 48 evmap_signal_initmap_(&base->sigmap); 49 event_changelist_init_(&base->changelist); 50 51 base->evbase = NULL; 52 53 if (cfg) { 54 memcpy(&base->max_dispatch_time, 55 &cfg->max_dispatch_interval, sizeof(struct timeval)); 56 base->limit_callbacks_after_prio = 57 cfg->limit_callbacks_after_prio; 58 } else { 59 base->max_dispatch_time.tv_sec = -1; 60 base->limit_callbacks_after_prio = 1; 61 } 62 if (cfg && cfg->max_dispatch_callbacks >= 0) { 63 base->max_dispatch_callbacks = cfg->max_dispatch_callbacks; 64 } else { 65 base->max_dispatch_callbacks = INT_MAX; 66 } 67 if (base->max_dispatch_callbacks == INT_MAX && 68 base->max_dispatch_time.tv_sec == -1) 69 base->limit_callbacks_after_prio = INT_MAX; 70 71 for (i = 0; eventops[i] && !base->evbase; i++) { 72 if (cfg != NULL) { 73 /* determine if this backend should be avoided */ 74 if (event_config_is_avoided_method(cfg, 75 eventops[i]->name)) 76 continue; 77 if ((eventops[i]->features & cfg->require_features) 78 != cfg->require_features) 79 continue; 80 } 81 82 /* also obey the environment variables */ 83 if (should_check_environment && 84 event_is_method_disabled(eventops[i]->name)) 85 continue; 86 87 base->evsel = eventops[i]; 88 89 base->evbase = base->evsel->init(base); 90 } 91 92 if (base->evbase == NULL) { 93 event_warnx("%s: no event mechanism available", 94 __func__); 95 base->evsel = NULL; 96 event_base_free(base); 97 return NULL; 98 } 99 100 if (evutil_getenv_("EVENT_SHOW_METHOD")) 101 event_msgx("libevent using: %s", base->evsel->name); 102 103 /* allocate a single active event queue */ 104 if (event_base_priority_init(base, 1) < 0) { 105 event_base_free(base); 106 return NULL; 107 } 108 109 /* prepare for threading */ 110 111 #if !defined(EVENT__DISABLE_THREAD_SUPPORT) && !defined(EVENT__DISABLE_DEBUG_MODE) 112 event_debug_created_threadable_ctx_ = 1; 113 #endif 114 115 #ifndef EVENT__DISABLE_THREAD_SUPPORT 116 if (EVTHREAD_LOCKING_ENABLED() && 117 (!cfg || !(cfg->flags & EVENT_BASE_FLAG_NOLOCK))) { 118 int r; 119 EVTHREAD_ALLOC_LOCK(base->th_base_lock, 0); 120 EVTHREAD_ALLOC_COND(base->current_event_cond); 121 r = evthread_make_base_notifiable(base); 122 if (r<0) { 123 event_warnx("%s: Unable to make base notifiable.", __func__); 124 event_base_free(base); 125 return NULL; 126 } 127 } 128 #endif 129 130 #ifdef _WIN32 131 if (cfg && (cfg->flags & EVENT_BASE_FLAG_STARTUP_IOCP)) 132 event_base_start_iocp_(base, cfg->n_cpus_hint); 133 #endif 134 135 return (base); 136 }
(1)调用mm_calloc函数分配一块大小为sizeof(struct event_base)的内存空间。
(2)如果形参cfg不为NULL,则将base.flags赋值为cfg->flags。
(3)第71-90行设置了实际使用的后端机制,for循环从遍历数组eventops,直到找到一个可用的后端为止,可以看一下eventops。
1 #ifdef EVENT__HAVE_EVENT_PORTS 2 extern const struct eventop evportops; 3 #endif 4 #ifdef EVENT__HAVE_SELECT 5 extern const struct eventop selectops; 6 #endif 7 #ifdef EVENT__HAVE_POLL 8 extern const struct eventop pollops; 9 #endif 10 #ifdef EVENT__HAVE_EPOLL 11 extern const struct eventop epollops; 12 #endif 13 #ifdef EVENT__HAVE_WORKING_KQUEUE 14 extern const struct eventop kqops; 15 #endif 16 #ifdef EVENT__HAVE_DEVPOLL 17 extern const struct eventop devpollops; 18 #endif 19 #ifdef _WIN32 20 extern const struct eventop win32ops; 21 #endif 22 23 /* Array of backends in order of preference. */ 24 static const struct eventop *eventops[] = { 25 #ifdef EVENT__HAVE_EVENT_PORTS 26 &evportops, 27 #endif 28 #ifdef EVENT__HAVE_WORKING_KQUEUE 29 &kqops, 30 #endif 31 #ifdef EVENT__HAVE_EPOLL 32 &epollops, 33 #endif 34 #ifdef EVENT__HAVE_DEVPOLL 35 &devpollops, 36 #endif 37 #ifdef EVENT__HAVE_POLL 38 &pollops, 39 #endif 40 #ifdef EVENT__HAVE_SELECT 41 &selectops, 42 #endif 43 #ifdef _WIN32 44 &win32ops, 45 #endif 46 NULL 47 };
从代码中可以看到,根据宏定义来决定某些后端机制是否存在,这样就可以找到运行机子上支持的一个可用的后端机制,而且需要注意,epool、pool、select的顺序,所以如果支持epoll就不会选择poll,如果支持poll就不会选择select,select机制是最后的选择。
1 /** Structure to define the backend of a given event_base. */ 2 struct eventop { 3 /** The name of this backend. */ 4 const char *name; 5 /** Function to set up an event_base to use this backend. It should 6 * create a new structure holding whatever information is needed to 7 * run the backend, and return it. The returned pointer will get 8 * stored by event_init into the event_base.evbase field. On failure, 9 * this function should return NULL. */ 10 void *(*init)(struct event_base *); 11 /** Enable reading/writing on a given fd or signal. 'events' will be 12 * the events that we're trying to enable: one or more of EV_READ, 13 * EV_WRITE, EV_SIGNAL, and EV_ET. 'old' will be those events that 14 * were enabled on this fd previously. 'fdinfo' will be a structure 15 * associated with the fd by the evmap; its size is defined by the 16 * fdinfo field below. It will be set to 0 the first time the fd is 17 * added. The function should return 0 on success and -1 on error. 18 */ 19 int (*add)(struct event_base *, evutil_socket_t fd, short old, short events, void *fdinfo); 20 /** As "add", except 'events' contains the events we mean to disable. */ 21 int (*del)(struct event_base *, evutil_socket_t fd, short old, short events, void *fdinfo); 22 /** Function to implement the core of an event loop. It must see which 23 added events are ready, and cause event_active to be called for each 24 active event (usually via event_io_active or such). It should 25 return 0 on success and -1 on error. 26 */ 27 int (*dispatch)(struct event_base *, struct timeval *); 28 /** Function to clean up and free our data from the event_base. */ 29 void (*dealloc)(struct event_base *); 30 /** Flag: set if we need to reinitialize the event base after we fork. 31 */ 32 int need_reinit; 33 /** Bit-array of supported event_method_features that this backend can 34 * provide. */ 35 enum event_method_feature features; 36 /** Length of the extra information we should record for each fd that 37 has one or more active events. This information is recorded 38 as part of the evmap entry for each fd, and passed as an argument 39 to the add and del functions above. 40 */ 41 size_t fdinfo_len; 42 };
struct eventop结构定义了后端机制的一个公共接口,至于每个后端是如何将自己的函数封装成符合这个接口的,我下面会逐个分析。
(4)然后调用init函数来初始化event_base对象。init函数的具体实现根据不同的后端机制会有所不同。
3、event_new函数
1 struct event * 2 event_new(struct event_base *base, evutil_socket_t fd, short events, void (*cb)(evutil_socket_t, short, void *), void *arg) 3 { 4 struct event *ev; 5 ev = mm_malloc(sizeof(struct event)); 6 if (ev == NULL) 7 return (NULL); 8 if (event_assign(ev, base, fd, events, cb, arg) < 0) { 9 mm_free(ev); 10 return (NULL); 11 } 12 13 return (ev); 14 }
(1)调用mm_malloc函数分配一块大小为sizeof(struct event)的内存空间。
(2)event_new的实现类似于event_base_new函数类似,分配好空间之后,调用了event_assign函数来填充结构体。
4、event_assign函数
1 int 2 event_assign(struct event *ev, struct event_base *base, evutil_socket_t fd, short events, void (*callback)(evutil_socket_t, short, void *), void *arg) 3 { 4 if (!base) 5 base = current_base; 6 if (arg == &event_self_cbarg_ptr_) 7 arg = ev; 8 9 event_debug_assert_not_added_(ev); 10 11 ev->ev_base = base; 12 13 ev->ev_callback = callback; 14 ev->ev_arg = arg; 15 ev->ev_fd = fd; 16 ev->ev_events = events; 17 ev->ev_res = 0; 18 ev->ev_flags = EVLIST_INIT; 19 ev->ev_ncalls = 0; 20 ev->ev_pncalls = NULL; 21 22 if (events & EV_SIGNAL) { 23 if ((events & (EV_READ|EV_WRITE|EV_CLOSED)) != 0) { 24 event_warnx("%s: EV_SIGNAL is not compatible with " 25 "EV_READ, EV_WRITE or EV_CLOSED", __func__); 26 return -1; 27 } 28 ev->ev_closure = EV_CLOSURE_EVENT_SIGNAL; 29 } else { 30 if (events & EV_PERSIST) { 31 evutil_timerclear(&ev->ev_io_timeout); 32 ev->ev_closure = EV_CLOSURE_EVENT_PERSIST; 33 } else { 34 ev->ev_closure = EV_CLOSURE_EVENT; 35 } 36 } 37 38 min_heap_elem_init_(ev); 39 40 if (base != NULL) { 41 /* by default, we put new events into the middle priority */ 42 ev->ev_pri = base->nactivequeues / 2; 43 } 44 45 event_debug_note_setup_(ev); 46 47 return 0; 48 }
(1)event_assign函数的主要操作是给形参struct event *ev的成员赋值,包括ev->ev_base、ev->ev_callback、ev->ev_arg、ev->ev_fd、ev->ev_events等
总结:event_new、event_assign函数会把传递进来的struct event_base* base保存在获取到的strut event结构体内部。
5、event_add函数
1 int 2 event_add(struct event *ev, const struct timeval *tv) 3 { 4 int res; 5 6 if (EVUTIL_FAILURE_CHECK(!ev->ev_base)) { 7 event_warnx("%s: event has no event_base set.", __func__); 8 return -1; 9 } 10 11 EVBASE_ACQUIRE_LOCK(ev->ev_base, th_base_lock); 12 13 res = event_add_nolock_(ev, tv, 0); 14 15 EVBASE_RELEASE_LOCK(ev->ev_base, th_base_lock); 16 17 return (res); 18 }
(1)event_add函数调用了event_add_nolock_函数进行实际的操作。
6、event_add_nolock_函数
1 /* Implementation function to add an event. Works just like event_add, 2 * except: 1) it requires that we have the lock. 2) if tv_is_absolute is set, 3 * we treat tv as an absolute time, not as an interval to add to the current 4 * time */ 5 int 6 event_add_nolock_(struct event *ev, const struct timeval *tv, 7 int tv_is_absolute) 8 { 9 struct event_base *base = ev->ev_base; 10 int res = 0; 11 int notify = 0; 12 13 EVENT_BASE_ASSERT_LOCKED(base); 14 event_debug_assert_is_setup_(ev); 15 16 event_debug(( 17 "event_add: event: %p (fd "EV_SOCK_FMT"), %s%s%s%scall %p", 18 ev, 19 EV_SOCK_ARG(ev->ev_fd), 20 ev->ev_events & EV_READ ? "EV_READ " : " ", 21 ev->ev_events & EV_WRITE ? "EV_WRITE " : " ", 22 ev->ev_events & EV_CLOSED ? "EV_CLOSED " : " ", 23 tv ? "EV_TIMEOUT " : " ", 24 ev->ev_callback)); 25 26 EVUTIL_ASSERT(!(ev->ev_flags & ~EVLIST_ALL)); 27 28 if (ev->ev_flags & EVLIST_FINALIZING) { 29 /* XXXX debug */ 30 return (-1); 31 } 32 33 /* 34 * prepare for timeout insertion further below, if we get a 35 * failure on any step, we should not change any state. 36 */ 37 if (tv != NULL && !(ev->ev_flags & EVLIST_TIMEOUT)) { 38 if (min_heap_reserve_(&base->timeheap, 39 1 + min_heap_size_(&base->timeheap)) == -1) 40 return (-1); /* ENOMEM == errno */ 41 } 42 43 /* If the main thread is currently executing a signal event's 44 * callback, and we are not the main thread, then we want to wait 45 * until the callback is done before we mess with the event, or else 46 * we can race on ev_ncalls and ev_pncalls below. */ 47 #ifndef EVENT__DISABLE_THREAD_SUPPORT 48 if (base->current_event == event_to_event_callback(ev) && 49 (ev->ev_events & EV_SIGNAL) 50 && !EVBASE_IN_THREAD(base)) { 51 ++base->current_event_waiters; 52 EVTHREAD_COND_WAIT(base->current_event_cond, base->th_base_lock); 53 } 54 #endif 55 56 if ((ev->ev_events & (EV_READ|EV_WRITE|EV_CLOSED|EV_SIGNAL)) && 57 !(ev->ev_flags & (EVLIST_INSERTED|EVLIST_ACTIVE|EVLIST_ACTIVE_LATER))) { 58 if (ev->ev_events & (EV_READ|EV_WRITE|EV_CLOSED)) 59 res = evmap_io_add_(base, ev->ev_fd, ev); 60 else if (ev->ev_events & EV_SIGNAL) 61 res = evmap_signal_add_(base, (int)ev->ev_fd, ev); 62 if (res != -1) 63 event_queue_insert_inserted(base, ev); 64 if (res == 1) { 65 /* evmap says we need to notify the main thread. */ 66 notify = 1; 67 res = 0; 68 } 69 } 70 71 /* 72 * we should change the timeout state only if the previous event 73 * addition succeeded. 74 */ 75 if (res != -1 && tv != NULL) { 76 struct timeval now; 77 int common_timeout; 78 #ifdef USE_REINSERT_TIMEOUT 79 int was_common; 80 int old_timeout_idx; 81 #endif 82 83 /* 84 * for persistent timeout events, we remember the 85 * timeout value and re-add the event. 86 * 87 * If tv_is_absolute, this was already set. 88 */ 89 if (ev->ev_closure == EV_CLOSURE_EVENT_PERSIST && !tv_is_absolute) 90 ev->ev_io_timeout = *tv; 91 92 #ifndef USE_REINSERT_TIMEOUT 93 if (ev->ev_flags & EVLIST_TIMEOUT) { 94 event_queue_remove_timeout(base, ev); 95 } 96 #endif 97 98 /* Check if it is active due to a timeout. Rescheduling 99 * this timeout before the callback can be executed 100 * removes it from the active list. */ 101 if ((ev->ev_flags & EVLIST_ACTIVE) && 102 (ev->ev_res & EV_TIMEOUT)) { 103 if (ev->ev_events & EV_SIGNAL) { 104 /* See if we are just active executing 105 * this event in a loop 106 */ 107 if (ev->ev_ncalls && ev->ev_pncalls) { 108 /* Abort loop */ 109 *ev->ev_pncalls = 0; 110 } 111 } 112 113 event_queue_remove_active(base, event_to_event_callback(ev)); 114 } 115 116 gettime(base, &now); 117 118 common_timeout = is_common_timeout(tv, base); 119 #ifdef USE_REINSERT_TIMEOUT 120 was_common = is_common_timeout(&ev->ev_timeout, base); 121 old_timeout_idx = COMMON_TIMEOUT_IDX(&ev->ev_timeout); 122 #endif 123 124 if (tv_is_absolute) { 125 ev->ev_timeout = *tv; 126 } else if (common_timeout) { 127 struct timeval tmp = *tv; 128 tmp.tv_usec &= MICROSECONDS_MASK; 129 evutil_timeradd(&now, &tmp, &ev->ev_timeout); 130 ev->ev_timeout.tv_usec |= 131 (tv->tv_usec & ~MICROSECONDS_MASK); 132 } else { 133 evutil_timeradd(&now, tv, &ev->ev_timeout); 134 } 135 136 event_debug(( 137 "event_add: event %p, timeout in %d seconds %d useconds, call %p", 138 ev, (int)tv->tv_sec, (int)tv->tv_usec, ev->ev_callback)); 139 140 #ifdef USE_REINSERT_TIMEOUT 141 event_queue_reinsert_timeout(base, ev, was_common, common_timeout, old_timeout_idx); 142 #else 143 event_queue_insert_timeout(base, ev); 144 #endif 145 146 if (common_timeout) { 147 struct common_timeout_list *ctl = 148 get_common_timeout_list(base, &ev->ev_timeout); 149 if (ev == TAILQ_FIRST(&ctl->events)) { 150 common_timeout_schedule(ctl, &now, ev); 151 } 152 } else { 153 struct event* top = NULL; 154 /* See if the earliest timeout is now earlier than it 155 * was before: if so, we will need to tell the main 156 * thread to wake up earlier than it would otherwise. 157 * We double check the timeout of the top element to 158 * handle time distortions due to system suspension. 159 */ 160 if (min_heap_elt_is_top_(ev)) 161 notify = 1; 162 else if ((top = min_heap_top_(&base->timeheap)) != NULL && 163 evutil_timercmp(&top->ev_timeout, &now, <)) 164 notify = 1; 165 } 166 } 167 168 /* if we are not in the right thread, we need to wake up the loop */ 169 if (res != -1 && notify && EVBASE_NEED_NOTIFY(base)) 170 evthread_notify_base(base); 171 172 event_debug_note_add_(ev); 173 174 return (res); 175 }
(1)
三、event_base_dispatch函数
1、event_base_dispatch函数
1 int 2 event_base_dispatch(struct event_base *event_base) 3 { 4 return (event_base_loop(event_base, 0)); 5 }
(1)可以看到,event_base_dispatch函数间接调用了 event_base_loop函数
2、event_base_loop函数
1 int 2 event_base_loop(struct event_base *base, int flags) 3 { 4 const struct eventop *evsel = base->evsel; 5 struct timeval tv; 6 struct timeval *tv_p; 7 int res, done, retval = 0; 8 9 /* Grab the lock. We will release it inside evsel.dispatch, and again 10 * as we invoke user callbacks. */ 11 EVBASE_ACQUIRE_LOCK(base, th_base_lock); 12 13 if (base->running_loop) { 14 event_warnx("%s: reentrant invocation. Only one event_base_loop" 15 " can run on each event_base at once.", __func__); 16 EVBASE_RELEASE_LOCK(base, th_base_lock); 17 return -1; 18 } 19 20 base->running_loop = 1; 21 22 clear_time_cache(base); 23 24 if (base->sig.ev_signal_added && base->sig.ev_n_signals_added) 25 evsig_set_base_(base); 26 27 done = 0; 28 29 #ifndef EVENT__DISABLE_THREAD_SUPPORT 30 base->th_owner_id = EVTHREAD_GET_ID(); 31 #endif 32 33 base->event_gotterm = base->event_break = 0; 34 35 while (!done) { 36 base->event_continue = 0; 37 base->n_deferreds_queued = 0; 38 39 /* Terminate the loop if we have been asked to */ 40 if (base->event_gotterm) { 41 break; 42 } 43 44 if (base->event_break) { 45 break; 46 } 47 48 tv_p = &tv; 49 if (!N_ACTIVE_CALLBACKS(base) && !(flags & EVLOOP_NONBLOCK)) { 50 timeout_next(base, &tv_p); 51 } else { 52 /* 53 * if we have active events, we just poll new events 54 * without waiting. 55 */ 56 evutil_timerclear(&tv); 57 } 58 59 /* If we have no events, we just exit */ 60 if (0==(flags&EVLOOP_NO_EXIT_ON_EMPTY) && 61 !event_haveevents(base) && !N_ACTIVE_CALLBACKS(base)) { 62 event_debug(("%s: no events registered.", __func__)); 63 retval = 1; 64 goto done; 65 } 66 67 event_queue_make_later_events_active(base); 68 69 clear_time_cache(base); 70 71 res = evsel->dispatch(base, tv_p); 72 73 if (res == -1) { 74 event_debug(("%s: dispatch returned unsuccessfully.", 75 __func__)); 76 retval = -1; 77 goto done; 78 } 79 80 update_time_cache(base); 81 82 timeout_process(base); 83 84 if (N_ACTIVE_CALLBACKS(base)) { 85 int n = event_process_active(base); 86 if ((flags & EVLOOP_ONCE) 87 && N_ACTIVE_CALLBACKS(base) == 0 88 && n != 0) 89 done = 1; 90 } else if (flags & EVLOOP_NONBLOCK) 91 done = 1; 92 } 93 event_debug(("%s: asked to terminate loop.", __func__)); 94 95 done: 96 clear_time_cache(base); 97 base->running_loop = 0; 98 99 EVBASE_RELEASE_LOCK(base, th_base_lock); 100 101 return (retval); 102 }
(1)event_base_loop函数的主要逻辑是就一个死循环,在循环中不断的调用由不同多路分发机制提供的后端接口。71行。
(2)调用后端接口返回后,调用event_process_active函数处理激活的事件。
3、event_process_active函数
1 /* 2 * Active events are stored in priority queues. Lower priorities are always 3 * process before higher priorities. Low priority events can starve high 4 * priority ones. 5 */ 6 7 static int 8 event_process_active(struct event_base *base) 9 { 10 /* Caller must hold th_base_lock */ 11 struct evcallback_list *activeq = NULL; 12 int i, c = 0; 13 const struct timeval *endtime; 14 struct timeval tv; 15 const int maxcb = base->max_dispatch_callbacks; 16 const int limit_after_prio = base->limit_callbacks_after_prio; 17 if (base->max_dispatch_time.tv_sec >= 0) { 18 update_time_cache(base); 19 gettime(base, &tv); 20 evutil_timeradd(&base->max_dispatch_time, &tv, &tv); 21 endtime = &tv; 22 } else { 23 endtime = NULL; 24 } 25 26 for (i = 0; i < base->nactivequeues; ++i) { 27 if (TAILQ_FIRST(&base->activequeues[i]) != NULL) { 28 base->event_running_priority = i; 29 activeq = &base->activequeues[i]; 30 if (i < limit_after_prio) 31 c = event_process_active_single_queue(base, activeq, 32 INT_MAX, NULL); 33 else 34 c = event_process_active_single_queue(base, activeq, 35 maxcb, endtime); 36 if (c < 0) { 37 goto done; 38 } else if (c > 0) 39 break; /* Processed a real event; do not 40 * consider lower-priority events */ 41 /* If we get here, all of the events we processed 42 * were internal. Continue. */ 43 } 44 } 45 46 done: 47 base->event_running_priority = -1; 48 49 return c; 50 }
(1)第26-44行,循环遍历激活的事件,然后调用event_process_active_single_queue函数。
4、event_process_active_single_queue函数
1 /* 2 Helper for event_process_active to process all the events in a single queue, 3 releasing the lock as we go. This function requires that the lock be held 4 when it's invoked. Returns -1 if we get a signal or an event_break that 5 means we should stop processing any active events now. Otherwise returns 6 the number of non-internal event_callbacks that we processed. 7 */ 8 static int 9 event_process_active_single_queue(struct event_base *base, 10 struct evcallback_list *activeq, 11 int max_to_process, const struct timeval *endtime) 12 { 13 struct event_callback *evcb; 14 int count = 0; 15 16 EVUTIL_ASSERT(activeq != NULL); 17 18 for (evcb = TAILQ_FIRST(activeq); evcb; evcb = TAILQ_FIRST(activeq)) { 19 struct event *ev=NULL; 20 if (evcb->evcb_flags & EVLIST_INIT) { 21 ev = event_callback_to_event(evcb); 22 23 if (ev->ev_events & EV_PERSIST || ev->ev_flags & EVLIST_FINALIZING) 24 event_queue_remove_active(base, evcb); 25 else 26 event_del_nolock_(ev, EVENT_DEL_NOBLOCK); 27 event_debug(( 28 "event_process_active: event: %p, %s%s%scall %p", 29 ev, 30 ev->ev_res & EV_READ ? "EV_READ " : " ", 31 ev->ev_res & EV_WRITE ? "EV_WRITE " : " ", 32 ev->ev_res & EV_CLOSED ? "EV_CLOSED " : " ", 33 ev->ev_callback)); 34 } else { 35 event_queue_remove_active(base, evcb); 36 event_debug(("event_process_active: event_callback %p, " 37 "closure %d, call %p", 38 evcb, evcb->evcb_closure, evcb->evcb_cb_union.evcb_callback)); 39 } 40 41 if (!(evcb->evcb_flags & EVLIST_INTERNAL)) 42 ++count; 43 44 45 base->current_event = evcb; 46 #ifndef EVENT__DISABLE_THREAD_SUPPORT 47 base->current_event_waiters = 0; 48 #endif 49 50 switch (evcb->evcb_closure) { 51 case EV_CLOSURE_EVENT_SIGNAL: 52 EVUTIL_ASSERT(ev != NULL); 53 event_signal_closure(base, ev); 54 break; 55 case EV_CLOSURE_EVENT_PERSIST: 56 EVUTIL_ASSERT(ev != NULL); 57 event_persist_closure(base, ev); 58 break; 59 case EV_CLOSURE_EVENT: { 60 void (*evcb_callback)(evutil_socket_t, short, void *); 61 EVUTIL_ASSERT(ev != NULL); 62 evcb_callback = *ev->ev_callback; 63 EVBASE_RELEASE_LOCK(base, th_base_lock); 64 evcb_callback(ev->ev_fd, ev->ev_res, ev->ev_arg); 65 } 66 break; 67 case EV_CLOSURE_CB_SELF: { 68 void (*evcb_selfcb)(struct event_callback *, void *) = evcb->evcb_cb_union.evcb_selfcb; 69 EVBASE_RELEASE_LOCK(base, th_base_lock); 70 evcb_selfcb(evcb, evcb->evcb_arg); 71 } 72 break; 73 case EV_CLOSURE_EVENT_FINALIZE: 74 case EV_CLOSURE_EVENT_FINALIZE_FREE: { 75 void (*evcb_evfinalize)(struct event *, void *); 76 int evcb_closure = evcb->evcb_closure; 77 EVUTIL_ASSERT(ev != NULL); 78 base->current_event = NULL; 79 evcb_evfinalize = ev->ev_evcallback.evcb_cb_union.evcb_evfinalize; 80 EVUTIL_ASSERT((evcb->evcb_flags & EVLIST_FINALIZING)); 81 EVBASE_RELEASE_LOCK(base, th_base_lock); 82 evcb_evfinalize(ev, ev->ev_arg); 83 event_debug_note_teardown_(ev); 84 if (evcb_closure == EV_CLOSURE_EVENT_FINALIZE_FREE) 85 mm_free(ev); 86 } 87 break; 88 case EV_CLOSURE_CB_FINALIZE: { 89 void (*evcb_cbfinalize)(struct event_callback *, void *) = evcb->evcb_cb_union.evcb_cbfinalize; 90 base->current_event = NULL; 91 EVUTIL_ASSERT((evcb->evcb_flags & EVLIST_FINALIZING)); 92 EVBASE_RELEASE_LOCK(base, th_base_lock); 93 evcb_cbfinalize(evcb, evcb->evcb_arg); 94 } 95 break; 96 default: 97 EVUTIL_ASSERT(0); 98 } 99 100 EVBASE_ACQUIRE_LOCK(base, th_base_lock); 101 base->current_event = NULL; 102 #ifndef EVENT__DISABLE_THREAD_SUPPORT 103 if (base->current_event_waiters) { 104 base->current_event_waiters = 0; 105 EVTHREAD_COND_BROADCAST(base->current_event_cond); 106 } 107 #endif 108 109 if (base->event_break) 110 return -1; 111 if (count >= max_to_process) 112 return count; 113 if (count && endtime) { 114 struct timeval now; 115 update_time_cache(base); 116 gettime(base, &now); 117 if (evutil_timercmp(&now, endtime, >=)) 118 return count; 119 } 120 if (base->event_continue) 121 break; 122 } 123 return count; 124 }
(1)