libev/event.h

/*
 * libevent compatibility header, only core events supported
 *
 * Copyright (c) 2007,2008,2010,2012 Marc Alexander Lehmann <libev@schmorp.de>
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without modifica-
 * tion, are permitted provided that the following conditions are met:
 *
 *   1.  Redistributions of source code must retain the above copyright notice,
 *       this list of conditions and the following disclaimer.
 *
 *   2.  Redistributions in binary form must reproduce the above copyright
 *       notice, this list of conditions and the following disclaimer in the
 *       documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MER-
 * CHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO
 * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPE-
 * CIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTH-
 * ERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 * OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * Alternatively, the contents of this file may be used under the terms of
 * the GNU General Public License ("GPL") version 2 or any later version,
 * in which case the provisions of the GPL are applicable instead of
 * the above. If you wish to allow the use of your version of this file
 * only under the terms of the GPL and not to allow others to use your
 * version of this file under the BSD license, indicate your decision
 * by deleting the provisions above and replace them with the notice
 * and other provisions required by the GPL. If you do not delete the
 * provisions above, a recipient may use your version of this file under
 * either the BSD or the GPL.
 */

#ifndef EVENT_H_
#define EVENT_H_

#ifdef EV_H
# include EV_H
#else
# include "ev.h"
#endif

#ifndef EVLOOP_NONBLOCK
# define EVLOOP_NONBLOCK EVRUN_NOWAIT
#endif
#ifndef EVLOOP_ONESHOT
# define EVLOOP_ONESHOT EVRUN_ONCE
#endif
#ifndef EV_TIMEOUT
# define EV_TIMEOUT EV_TIMER
#endif

#ifdef __cplusplus
extern "C" {
#endif

/* we need sys/time.h for struct timeval only */
#if !defined (WIN32) || defined (__MINGW32__)
# include <time.h> /* mingw seems to need this, for whatever reason */
# include <sys/time.h>
#endif

struct event_base;

#define EVLIST_TIMEOUT  0x01
#define EVLIST_INSERTED 0x02
#define EVLIST_SIGNAL   0x04
#define EVLIST_ACTIVE   0x08
#define EVLIST_INTERNAL 0x10
#define EVLIST_INIT     0x80

typedef void (*event_callback_fn)(int, short, void *);

struct event
{
  /* libev watchers we map onto */
  union {
    struct ev_io io;
    struct ev_signal sig;
  } iosig;
  struct ev_timer to;

  /* compatibility slots */
  struct event_base *ev_base;
  event_callback_fn ev_callback;
  void *ev_arg;
  int ev_fd;
  int ev_pri;
  int ev_res;
  int ev_flags;
  short ev_events;
};

event_callback_fn event_get_callback (const struct event *ev);

#define EV_READ                    EV_READ
#define EV_WRITE                   EV_WRITE
#define EV_PERSIST                 0x10
#define EV_ET                      0x20 /* nop */

#define EVENT_SIGNAL(ev)           ((int) (ev)->ev_fd)
#define EVENT_FD(ev)               ((int) (ev)->ev_fd)

#define event_initialized(ev)      ((ev)->ev_flags & EVLIST_INIT)

#define evtimer_add(ev,tv)         event_add (ev, tv)
#define evtimer_set(ev,cb,data)    event_set (ev, -1, 0, cb, data)
#define evtimer_del(ev)            event_del (ev)
#define evtimer_pending(ev,tv)     event_pending (ev, EV_TIMEOUT, tv)
#define evtimer_initialized(ev)    event_initialized (ev)

#define timeout_add(ev,tv)         evtimer_add (ev, tv)
#define timeout_set(ev,cb,data)    evtimer_set (ev, cb, data)
#define timeout_del(ev)            evtimer_del (ev)
#define timeout_pending(ev,tv)     evtimer_pending (ev, tv)
#define timeout_initialized(ev)    evtimer_initialized (ev)

#define signal_add(ev,tv)          event_add (ev, tv)
#define signal_set(ev,sig,cb,data) event_set (ev, sig, EV_SIGNAL | EV_PERSIST, cb, data)
#define signal_del(ev)             event_del (ev)
#define signal_pending(ev,tv)      event_pending (ev, EV_SIGNAL, tv)
#define signal_initialized(ev)     event_initialized (ev)

const char *event_get_version (void);
const char *event_get_method (void);

void *event_init (void);
void event_base_free (struct event_base *base);

#define EVLOOP_ONCE      EVLOOP_ONESHOT
int event_loop (int);
int event_loopexit (struct timeval *tv);
int event_dispatch (void);

#define _EVENT_LOG_DEBUG 0
#define _EVENT_LOG_MSG   1
#define _EVENT_LOG_WARN  2
#define _EVENT_LOG_ERR   3
typedef void (*event_log_cb)(int severity, const char *msg);
void event_set_log_callback(event_log_cb cb);

void event_set (struct event *ev, int fd, short events, void (*cb)(int, short, void *), void *arg);
int event_once (int fd, short events, void (*cb)(int, short, void *), void *arg, struct timeval *tv);

int event_add (struct event *ev, struct timeval *tv);
int event_del (struct event *ev);
void event_active (struct event *ev, int res, short ncalls); /* ncalls is being ignored */

int event_pending (struct event *ev, short, struct timeval *tv);

int event_priority_init (int npri);
int event_priority_set (struct event *ev, int pri);

struct event_base *event_base_new (void);
const char *event_base_get_method (const struct event_base *);
int event_base_set (struct event_base *base, struct event *ev);
int event_base_loop (struct event_base *base, int);
int event_base_loopexit (struct event_base *base, struct timeval *tv);
int event_base_dispatch (struct event_base *base);
int event_base_once (struct event_base *base, int fd, short events, void (*cb)(int, short, void *), void *arg, struct timeval *tv);
int event_base_priority_init (struct event_base *base, int fd);

/* next line is different in the libevent+libev version */
/*libevent-include*/

#ifdef __cplusplus
}
#endif

#endif

Revision:	1.26
Committed:	Mon Apr 2 23:15:27 2012 UTC (12 years, 1 month ago) by root
Content type:	text/plain
Branch:	MAIN
CVS Tags:	EV-rel-4_28, EV-rel-4_29, EV-rel-4_27, EV-rel-4_22, rel-4_33, rel-4_23, rel-4_22, rel-4_20, rel-4_27, rel-4_25, rel-4_24, rxvt-unicode-rel-9_16, EV-rel-4_31, EV-rel-4_30, rel-4_31, rel-4_15, rel-4_18, rel-4_19, HEAD
Changes since 1.25:	+5 -4 lines
Log Message:	* empty log message *
#	User	Rev	Content
1	root	1.1	/*
2			* libevent compatibility header, only core events supported
3			*
4	root	1.25	* Copyright (c) 2007,2008,2010,2012 Marc Alexander Lehmann <libev@schmorp.de>
5	root	1.1	* All rights reserved.
6			*
7	root	1.17	* Redistribution and use in source and binary forms, with or without modifica-
8			* tion, are permitted provided that the following conditions are met:
9	root	1.24	*
10	root	1.17	* 1. Redistributions of source code must retain the above copyright notice,
11			* this list of conditions and the following disclaimer.
12	root	1.24	*
13	root	1.17	* 2. Redistributions in binary form must reproduce the above copyright
14			* notice, this list of conditions and the following disclaimer in the
15			* documentation and/or other materials provided with the distribution.
16	root	1.24	*
17	root	1.17	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
18			* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MER-
19			* CHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
20			* EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPE-
21			* CIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
22			* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
23			* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
24			* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTH-
25			* ERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
26			* OF THE POSSIBILITY OF SUCH DAMAGE.
27	root	1.1	*
28	root	1.17	* Alternatively, the contents of this file may be used under the terms of
29			* the GNU General Public License ("GPL") version 2 or any later version,
30			* in which case the provisions of the GPL are applicable instead of
31			* the above. If you wish to allow the use of your version of this file
32			* only under the terms of the GPL and not to allow others to use your
33			* version of this file under the BSD license, indicate your decision
34			* by deleting the provisions above and replace them with the notice
35			* and other provisions required by the GPL. If you do not delete the
36			* provisions above, a recipient may use your version of this file under
37			* either the BSD or the GPL.
38	root	1.1	*/
39	root	1.17
40	root	1.20	#ifndef EVENT_H_
41			#define EVENT_H_
42	root	1.1
43	root	1.14	#ifdef EV_H
44			# include EV_H
45			#else
46	root	1.17	# include "ev.h"
47	root	1.14	#endif
48	root	1.6
49	root	1.22	#ifndef EVLOOP_NONBLOCK
50			# define EVLOOP_NONBLOCK EVRUN_NOWAIT
51			#endif
52			#ifndef EVLOOP_ONESHOT
53			# define EVLOOP_ONESHOT EVRUN_ONCE
54			#endif
55	root	1.21	#ifndef EV_TIMEOUT
56			# define EV_TIMEOUT EV_TIMER
57			#endif
58
59	root	1.1	#ifdef __cplusplus
60			extern "C" {
61			#endif
62
63	root	1.19	/* we need sys/time.h for struct timeval only */
64			#if !defined (WIN32) \|\| defined (__MINGW32__)
65			# include <time.h> /* mingw seems to need this, for whatever reason */
66			# include <sys/time.h>
67			#endif
68
69	root	1.14	struct event_base;
70
71	root	1.16	#define EVLIST_TIMEOUT 0x01
72			#define EVLIST_INSERTED 0x02
73			#define EVLIST_SIGNAL 0x04
74			#define EVLIST_ACTIVE 0x08
75			#define EVLIST_INTERNAL 0x10
76			#define EVLIST_INIT 0x80
77
78	root	1.26	typedef void (event_callback_fn)(int, short, void );
79
80	root	1.1	struct event
81	root	1.4	{
82	root	1.5	/* libev watchers we map onto */
83	root	1.4	union {
84			struct ev_io io;
85			struct ev_signal sig;
86			} iosig;
87	root	1.1	struct ev_timer to;
88
89	root	1.4	/* compatibility slots */
90	root	1.1	struct event_base *ev_base;
91	root	1.26	event_callback_fn ev_callback;
92	root	1.2	void *ev_arg;
93	root	1.1	int ev_fd;
94			int ev_pri;
95			int ev_res;
96	root	1.16	int ev_flags;
97	root	1.2	short ev_events;
98	root	1.1	};
99
100	root	1.26	event_callback_fn event_get_callback (const struct event *ev);
101
102	root	1.23	#define EV_READ EV_READ
103			#define EV_WRITE EV_WRITE
104	root	1.1	#define EV_PERSIST 0x10
105	root	1.25	#define EV_ET 0x20 /* nop */
106	root	1.1
107			#define EVENT_SIGNAL(ev) ((int) (ev)->ev_fd)
108			#define EVENT_FD(ev) ((int) (ev)->ev_fd)
109
110	root	1.16	#define event_initialized(ev) ((ev)->ev_flags & EVLIST_INIT)
111	root	1.1
112			#define evtimer_add(ev,tv) event_add (ev, tv)
113			#define evtimer_set(ev,cb,data) event_set (ev, -1, 0, cb, data)
114			#define evtimer_del(ev) event_del (ev)
115			#define evtimer_pending(ev,tv) event_pending (ev, EV_TIMEOUT, tv)
116			#define evtimer_initialized(ev) event_initialized (ev)
117
118			#define timeout_add(ev,tv) evtimer_add (ev, tv)
119			#define timeout_set(ev,cb,data) evtimer_set (ev, cb, data)
120			#define timeout_del(ev) evtimer_del (ev)
121			#define timeout_pending(ev,tv) evtimer_pending (ev, tv)
122			#define timeout_initialized(ev) evtimer_initialized (ev)
123
124			#define signal_add(ev,tv) event_add (ev, tv)
125			#define signal_set(ev,sig,cb,data) event_set (ev, sig, EV_SIGNAL \| EV_PERSIST, cb, data)
126			#define signal_del(ev) event_del (ev)
127			#define signal_pending(ev,tv) event_pending (ev, EV_SIGNAL, tv)
128			#define signal_initialized(ev) event_initialized (ev)
129
130			const char *event_get_version (void);
131			const char *event_get_method (void);
132
133			void *event_init (void);
134			void event_base_free (struct event_base *base);
135
136			#define EVLOOP_ONCE EVLOOP_ONESHOT
137			int event_loop (int);
138			int event_loopexit (struct timeval *tv);
139			int event_dispatch (void);
140
141			#define _EVENT_LOG_DEBUG 0
142			#define _EVENT_LOG_MSG 1
143			#define _EVENT_LOG_WARN 2
144			#define _EVENT_LOG_ERR 3
145			typedef void (event_log_cb)(int severity, const char msg);
146			void event_set_log_callback(event_log_cb cb);
147
148			void event_set (struct event ev, int fd, short events, void (cb)(int, short, void ), void arg);
149			int event_once (int fd, short events, void (cb)(int, short, void ), void arg, struct timeval tv);
150
151			int event_add (struct event ev, struct timeval tv);
152			int event_del (struct event *ev);
153	root	1.12	void event_active (struct event ev, int res, short ncalls); / ncalls is being ignored */
154	root	1.1
155			int event_pending (struct event ev, short, struct timeval tv);
156
157			int event_priority_init (int npri);
158			int event_priority_set (struct event *ev, int pri);
159
160	root	1.25	struct event_base *event_base_new (void);
161			const char event_base_get_method (const struct event_base );
162	root	1.1	int event_base_set (struct event_base base, struct event ev);
163			int event_base_loop (struct event_base *base, int);
164			int event_base_loopexit (struct event_base base, struct timeval tv);
165			int event_base_dispatch (struct event_base *base);
166			int event_base_once (struct event_base base, int fd, short events, void (cb)(int, short, void ), void arg, struct timeval *tv);
167			int event_base_priority_init (struct event_base *base, int fd);
168
169	root	1.17	/* next line is different in the libevent+libev version */
170			/libevent-include/
171	root	1.6
172			#ifdef __cplusplus
173			}
174			#endif
175
176	root	1.1	#endif
177	root	1.5