]> git.llucax.com Git - software/libev.git/blob - event.h
loop_ref constructor don't throw anything if EV_MULTIPLICITY is false.
[software/libev.git] / event.h
1 /*
2  * libevent compatibility header, only core events supported
3  *
4  * Copyright (c) 2007 Marc Alexander Lehmann <libev@schmorp.de>
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without modifica-
8  * tion, are permitted provided that the following conditions are met:
9  * 
10  *   1.  Redistributions of source code must retain the above copyright notice,
11  *       this list of conditions and the following disclaimer.
12  * 
13  *   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  * 
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  *
28  * 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  */
39
40 #ifndef EVENT_H__
41 #define EVENT_H__
42
43 #ifdef EV_H
44 # include EV_H
45 #else
46 # include "ev.h"
47 #endif
48
49 #ifdef __cplusplus
50 extern "C" {
51 #endif
52
53 struct event_base;
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 struct event
63 {
64   /* libev watchers we map onto */
65   union {
66     struct ev_io io;
67     struct ev_signal sig;
68   } iosig;
69   struct ev_timer to;
70
71   /* compatibility slots */
72   struct event_base *ev_base;
73   void (*ev_callback)(int, short, void *arg);
74   void *ev_arg;
75   int ev_fd;
76   int ev_pri;
77   int ev_res;
78   int ev_flags;
79   short ev_events;
80 };
81
82 #define EV_PERSIST                 0x10
83
84 #define EVENT_SIGNAL(ev)           ((int) (ev)->ev_fd)
85 #define EVENT_FD(ev)               ((int) (ev)->ev_fd)
86
87 #define event_initialized(ev)      ((ev)->ev_flags & EVLIST_INIT)
88
89 #define evtimer_add(ev,tv)         event_add (ev, tv)
90 #define evtimer_set(ev,cb,data)    event_set (ev, -1, 0, cb, data)
91 #define evtimer_del(ev)            event_del (ev)
92 #define evtimer_pending(ev,tv)     event_pending (ev, EV_TIMEOUT, tv)
93 #define evtimer_initialized(ev)    event_initialized (ev)
94
95 #define timeout_add(ev,tv)         evtimer_add (ev, tv)
96 #define timeout_set(ev,cb,data)    evtimer_set (ev, cb, data)
97 #define timeout_del(ev)            evtimer_del (ev)
98 #define timeout_pending(ev,tv)     evtimer_pending (ev, tv)
99 #define timeout_initialized(ev)    evtimer_initialized (ev)
100
101 #define signal_add(ev,tv)          event_add (ev, tv)
102 #define signal_set(ev,sig,cb,data) event_set (ev, sig, EV_SIGNAL | EV_PERSIST, cb, data)
103 #define signal_del(ev)             event_del (ev)
104 #define signal_pending(ev,tv)      event_pending (ev, EV_SIGNAL, tv)
105 #define signal_initialized(ev)     event_initialized (ev)
106
107 const char *event_get_version (void);
108 const char *event_get_method (void);
109
110 void *event_init (void);
111 void event_base_free (struct event_base *base);
112
113 #define EVLOOP_ONCE      EVLOOP_ONESHOT
114 int event_loop (int);
115 int event_loopexit (struct timeval *tv);
116 int event_dispatch (void);
117
118 #define _EVENT_LOG_DEBUG 0
119 #define _EVENT_LOG_MSG   1
120 #define _EVENT_LOG_WARN  2
121 #define _EVENT_LOG_ERR   3
122 typedef void (*event_log_cb)(int severity, const char *msg);
123 void event_set_log_callback(event_log_cb cb);
124
125 void event_set (struct event *ev, int fd, short events, void (*cb)(int, short, void *), void *arg);
126 int event_once (int fd, short events, void (*cb)(int, short, void *), void *arg, struct timeval *tv);
127
128 int event_add (struct event *ev, struct timeval *tv);
129 int event_del (struct event *ev);
130 void event_active (struct event *ev, int res, short ncalls); /* ncalls is being ignored */
131
132 int event_pending (struct event *ev, short, struct timeval *tv);
133
134 int event_priority_init (int npri);
135 int event_priority_set (struct event *ev, int pri);
136
137 int event_base_set (struct event_base *base, struct event *ev);
138 int event_base_loop (struct event_base *base, int);
139 int event_base_loopexit (struct event_base *base, struct timeval *tv);
140 int event_base_dispatch (struct event_base *base);
141 int event_base_once (struct event_base *base, int fd, short events, void (*cb)(int, short, void *), void *arg, struct timeval *tv);
142 int event_base_priority_init (struct event_base *base, int fd);
143
144 /* next line is different in the libevent+libev version */
145 /*libevent-include*/
146
147 #ifdef __cplusplus
148 }
149 #endif
150
151 #endif
152