• 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 };
    View Code

    从代码中可以看到,根据宏定义来决定某些后端机制是否存在,这样就可以找到运行机子上支持的一个可用的后端机制,而且需要注意,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 };
    View Code

    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)

  • 相关阅读:
    computed的用法
    地址列表展开功能/默认选中功能
    简易编辑器
    用vue做todolist
    用vue做的购物车结算的功能
    如果数据返回没有那个字段,怎么加上去?
    vue中全局filter和局部filter怎么用?
    editorconfig
    eslint 配置
    react typescript 单元测试
  • 原文地址:https://www.cnblogs.com/lit10050528/p/5698770.html
Copyright © 2020-2023  润新知