libevent/include/event2/event_struct.h

   1 /*
   2  * Copyright (c) 2000-2007 Niels Provos <provos@citi.umich.edu>
   3  * Copyright (c) 2007-2010 Niels Provos and Nick Mathewson
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  * 3. The name of the author may not be used to endorse or promote products
  14  *    derived from this software without specific prior written permission.
  15  *
  16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  17  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  18  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  19  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  20  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  21  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  22  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  23  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  25  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  26  */
  27 #ifndef _EVENT2_EVENT_STRUCT_H_
  28 #define _EVENT2_EVENT_STRUCT_H_
  29
  30 /** @file event_struct.h
  31
  32   Structures used by event.h.  Using these structures directly may harm
  33   forward compatibility: be careful!
  34
  35  */
  36
  37 #ifdef __cplusplus
  38 extern "C" {
  39 #endif
  40
  41 #include <event2/event-config.h>
  42 #ifdef _EVENT_HAVE_SYS_TYPES_H
  43 #include <sys/types.h>
  44 #endif
  45 #ifdef _EVENT_HAVE_SYS_TIME_H
  46 #include <sys/time.h>
  47 #endif
  48
  49 /* For int types. */
  50 #include <event2/util.h>
  51
  52 /* For evkeyvalq */
  53 #include <event2/keyvalq_struct.h>
  54
  55 #define EVLIST_TIMEOUT  0x01
  56 #define EVLIST_INSERTED 0x02
  57 #define EVLIST_SIGNAL   0x04
  58 #define EVLIST_ACTIVE   0x08
  59 #define EVLIST_INTERNAL 0x10
  60 #define EVLIST_INIT     0x80
  61
  62 /* EVLIST_X_ Private space: 0x1000-0xf000 */
  63 #define EVLIST_ALL      (0xf000 | 0x9f)
  64
  65 /* Fix so that people don't have to run with <sys/queue.h> */
  66 #ifndef TAILQ_ENTRY
  67 #define _EVENT_DEFINED_TQENTRY
  68 #define TAILQ_ENTRY(type)                                               \
  69 struct {                                                                \
  70         struct type *tqe_next;  /* next element */                      \
  71         struct type **tqe_prev; /* address of previous next element */  \
  72 }
  73 #endif /* !TAILQ_ENTRY */
  74
  75 #ifndef TAILQ_HEAD
  76 #define _EVENT_DEFINED_TQHEAD
  77 #define TAILQ_HEAD(name, type)                  \
  78 struct name {                                   \
  79         struct type *tqh_first;                 \
  80         struct type **tqh_last;                 \
  81 }
  82 #endif
  83
  84 struct event_base;
  85 struct event {
  86         TAILQ_ENTRY(event) ev_active_next;
  87         TAILQ_ENTRY(event) ev_next;
  88         /* for managing timeouts */
  89         union {
  90                 TAILQ_ENTRY(event) ev_next_with_common_timeout;
  91                 int min_heap_idx;
  92         } ev_timeout_pos;
  93         evutil_socket_t ev_fd;
  94
  95         struct event_base *ev_base;
  96
  97         union {
  98                 /* used for io events */
  99                 struct {
 100                         TAILQ_ENTRY(event) ev_io_next;
 101                         struct timeval ev_timeout;
 102                 } ev_io;
 103
 104                 /* used by signal events */
 105                 struct {
 106                         TAILQ_ENTRY(event) ev_signal_next;
 107                         short ev_ncalls;
 108                         /* Allows deletes in callback */
 109                         short *ev_pncalls;
 110                 } ev_signal;
 111         } _ev;
 112
 113         short ev_events;
 114         short ev_res;           /* result passed to event callback */
 115         short ev_flags;
 116         ev_uint8_t ev_pri;      /* smaller numbers are higher priority */
 117         ev_uint8_t ev_closure;
 118         struct timeval ev_timeout;
 119
 120         /* allows us to adopt for different types of events */
 121         void (*ev_callback)(evutil_socket_t, short, void *arg);
 122         void *ev_arg;
 123 };
 124
 125 TAILQ_HEAD (event_list, event);
 126
 127 #ifdef _EVENT_DEFINED_TQENTRY
 128 #undef TAILQ_ENTRY
 129 #endif
 130
 131 #ifdef _EVENT_DEFINED_TQHEAD
 132 #undef TAILQ_HEAD
 133 #endif
 134
 135 #ifdef __cplusplus
 136 }
 137 #endif
 138
 139 #endif /* _EVENT2_EVENT_STRUCT_H_ */