2 Unix SMB/CIFS implementation.
4 generalised event loop handling
8 Copyright (C) Stefan Metzmacher 2005
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 3 of the License, or
13 (at your option) any later version.
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program. If not, see <http://www.gnu.org/licenses/>.
26 int (*context_init)(struct event_context *ev);
28 /* fd_event functions */
29 struct fd_event *(*add_fd)(struct event_context *ev,
31 int fd, uint16_t flags,
32 event_fd_handler_t handler,
34 uint16_t (*get_fd_flags)(struct fd_event *fde);
35 void (*set_fd_flags)(struct fd_event *fde, uint16_t flags);
37 /* timed_event functions */
38 struct timed_event *(*add_timed)(struct event_context *ev,
40 struct timeval next_event,
41 event_timed_handler_t handler,
43 /* disk aio event functions */
44 struct aio_event *(*add_aio)(struct event_context *ev,
47 event_aio_handler_t handler,
49 /* signal functions */
50 struct signal_event *(*add_signal)(struct event_context *ev,
52 int signum, int sa_flags,
53 event_signal_handler_t handler,
57 int (*loop_once)(struct event_context *ev);
58 int (*loop_wait)(struct event_context *ev);
62 struct fd_event *prev, *next;
63 struct event_context *event_ctx;
65 uint16_t flags; /* see EVENT_FD_* flags */
66 event_fd_handler_t handler;
67 /* this is private for the specific handler */
69 /* this is private for the events_ops implementation */
70 uint16_t additional_flags;
71 void *additional_data;
75 struct timed_event *prev, *next;
76 struct event_context *event_ctx;
77 struct timeval next_event;
78 event_timed_handler_t handler;
79 /* this is private for the specific handler */
81 /* this is private for the events_ops implementation */
82 void *additional_data;
86 struct signal_event *prev, *next;
87 struct event_context *event_ctx;
88 event_signal_handler_t handler;
95 enum ev_debug_level {EV_DEBUG_FATAL, EV_DEBUG_ERROR,
96 EV_DEBUG_WARNING, EV_DEBUG_TRACE};
99 void (*debug)(void *context, enum ev_debug_level level,
100 const char *fmt, va_list ap) PRINTF_ATTRIBUTE(3,0);
104 int ev_set_debug(struct event_context *ev,
105 void (*debug)(void *context, enum ev_debug_level level,
106 const char *fmt, va_list ap),
108 int ev_set_debug_stderr(struct event_context *ev);
109 void ev_debug(struct event_context *ev, enum ev_debug_level level, const char *fmt, ...);
111 /* aio event is private to the aio backend */
114 struct event_context {
115 /* the specific events implementation */
116 const struct event_ops *ops;
118 /* list of timed events - used by common code */
119 struct timed_event *timed_events;
121 /* this is private for the events_ops implementation */
122 void *additional_data;
124 /* number of signal event handlers */
125 int num_signal_handlers;
127 /* pipe hack used with signal handlers */
128 struct fd_event *pipe_fde;
130 /* debugging operations */
131 struct ev_debug_ops debug_ops;
135 bool event_register_backend(const char *name, const struct event_ops *ops);
137 bool ev_timeval_is_zero(const struct timeval *tv);
138 struct timed_event *common_event_add_timed(struct event_context *, TALLOC_CTX *,
139 struct timeval, event_timed_handler_t, void *);
140 struct timeval common_event_loop_timer_delay(struct event_context *);
142 struct signal_event *common_event_add_signal(struct event_context *ev,
146 event_signal_handler_t handler,
148 int common_event_check_signal(struct event_context *ev);
151 bool events_standard_init(void);
152 bool events_select_init(void);
153 #if HAVE_EVENTS_EPOLL
154 bool events_epoll_init(void);
157 bool events_aio_init(void);