1/*	$NetBSD: eventlib.h,v 1.3 2009/04/12 17:07:16 christos Exp $	*/
2
3/*
4 * Copyright (C) 2004, 2005, 2008  Internet Systems Consortium, Inc. ("ISC")
5 * Copyright (C) 1995-1999, 2001, 2003  Internet Software Consortium.
6 *
7 * Permission to use, copy, modify, and/or distribute this software for any
8 * purpose with or without fee is hereby granted, provided that the above
9 * copyright notice and this permission notice appear in all copies.
10 *
11 * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
12 * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
13 * AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
14 * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
15 * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
16 * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
17 * PERFORMANCE OF THIS SOFTWARE.
18 */
19
20/* eventlib.h - exported interfaces for eventlib
21 * vix 09sep95 [initial]
22 *
23 * Id: eventlib.h,v 1.7 2008/11/14 02:36:51 marka Exp
24 */
25
26#ifndef _EVENTLIB_H
27#define _EVENTLIB_H
28
29#include <sys/types.h>
30#include <sys/uio.h>
31#include <sys/time.h>
32#include <stdio.h>
33
34#ifndef __P
35# define __EVENTLIB_P_DEFINED
36# ifdef __STDC__
37#  define __P(x) x
38# else
39#  define __P(x) ()
40# endif
41#endif
42
43/* In the absence of branded types... */
44typedef struct { void *opaque; } evConnID;
45typedef struct { void *opaque; } evFileID;
46typedef struct { void *opaque; } evStreamID;
47typedef struct { void *opaque; } evTimerID;
48typedef struct { void *opaque; } evWaitID;
49typedef struct { void *opaque; } evContext;
50typedef struct { void *opaque; } evEvent;
51
52#define	evInitID(id) ((id)->opaque = NULL)
53#define	evTestID(id) ((id).opaque != NULL)
54
55typedef void (*evConnFunc)__P((evContext, void *, int, const void *, int,
56			       const void *, int));
57typedef void (*evFileFunc)__P((evContext, void *, int, int));
58typedef	void (*evStreamFunc)__P((evContext, void *, int, int));
59typedef void (*evTimerFunc)__P((evContext, void *,
60				struct timespec, struct timespec));
61typedef	void (*evWaitFunc)__P((evContext, void *, const void *));
62
63typedef	struct { unsigned char mask[256/8]; } evByteMask;
64#define	EV_BYTEMASK_BYTE(b) ((b) / 8)
65#define	EV_BYTEMASK_MASK(b) (1 << ((b) % 8))
66#define	EV_BYTEMASK_SET(bm, b) \
67	((bm).mask[EV_BYTEMASK_BYTE(b)] |= EV_BYTEMASK_MASK(b))
68#define	EV_BYTEMASK_CLR(bm, b) \
69	((bm).mask[EV_BYTEMASK_BYTE(b)] &= ~EV_BYTEMASK_MASK(b))
70#define	EV_BYTEMASK_TST(bm, b) \
71	((bm).mask[EV_BYTEMASK_BYTE(b)] & EV_BYTEMASK_MASK(b))
72
73#define	EV_POLL		1
74#define	EV_WAIT		2
75#define	EV_NULL		4
76
77#define	EV_READ		1
78#define	EV_WRITE	2
79#define	EV_EXCEPT	4
80
81#define EV_WASNONBLOCKING 8	/* Internal library use. */
82
83/* eventlib.c */
84#define evCreate	__evCreate
85#define evSetDebug	__evSetDebug
86#define evDestroy	__evDestroy
87#define evGetNext	__evGetNext
88#define evDispatch	__evDispatch
89#define evDrop		__evDrop
90#define evMainLoop	__evMainLoop
91#define evHighestFD	__evHighestFD
92#define evGetOption	__evGetOption
93#define evSetOption	__evSetOption
94
95int  evCreate __P((evContext *));
96void evSetDebug __P((evContext, int, FILE *));
97int  evDestroy __P((evContext));
98int  evGetNext __P((evContext, evEvent *, int));
99int  evDispatch __P((evContext, evEvent));
100void evDrop __P((evContext, evEvent));
101int  evMainLoop __P((evContext));
102int  evHighestFD __P((evContext));
103int  evGetOption __P((evContext *, const char *, int *));
104int  evSetOption __P((evContext *, const char *, int));
105
106/* ev_connects.c */
107#define evListen	__evListen
108#define evConnect	__evConnect
109#define evCancelConn	__evCancelConn
110#define evHold		__evHold
111#define evUnhold	__evUnhold
112#define evTryAccept	__evTryAccept
113
114int evListen __P((evContext, int, int, evConnFunc, void *, evConnID *));
115int evConnect __P((evContext, int, const void *, int,
116		   evConnFunc, void *, evConnID *));
117int evCancelConn __P((evContext, evConnID));
118int evHold __P((evContext, evConnID));
119int evUnhold __P((evContext, evConnID));
120int evTryAccept __P((evContext, evConnID, int *));
121
122/* ev_files.c */
123#define evSelectFD	__evSelectFD
124#define evDeselectFD	__evDeselectFD
125
126int evSelectFD __P((evContext, int, int, evFileFunc, void *, evFileID *));
127int evDeselectFD __P((evContext, evFileID));
128
129/* ev_streams.c */
130#define evConsIovec	__evConsIovec
131#define evWrite		__evWrite
132#define evRead		__evRead
133#define evTimeRW	__evTimeRW
134#define evUntimeRW	__evUntimeRW
135#define	evCancelRW	__evCancelRW
136
137struct iovec evConsIovec __P((void *, size_t));
138int evWrite __P((evContext, int, const struct iovec *, int,
139		 evStreamFunc func, void *, evStreamID *));
140int evRead __P((evContext, int, const struct iovec *, int,
141		evStreamFunc func, void *, evStreamID *));
142int evTimeRW __P((evContext, evStreamID, evTimerID timer));
143int evUntimeRW __P((evContext, evStreamID));
144int evCancelRW __P((evContext, evStreamID));
145
146/* ev_timers.c */
147#define evConsTime	__evConsTime
148#define evAddTime	__evAddTime
149#define evSubTime	__evSubTime
150#define evCmpTime	__evCmpTime
151#define	evTimeSpec	__evTimeSpec
152#define	evTimeVal	__evTimeVal
153
154#define evNowTime		__evNowTime
155#define evUTCTime		__evUTCTime
156#define evLastEventTime		__evLastEventTime
157#define evSetTimer		__evSetTimer
158#define evClearTimer		__evClearTimer
159#define evConfigTimer		__evConfigTimer
160#define evResetTimer		__evResetTimer
161#define evSetIdleTimer		__evSetIdleTimer
162#define evClearIdleTimer	__evClearIdleTimer
163#define evResetIdleTimer	__evResetIdleTimer
164#define evTouchIdleTimer	__evTouchIdleTimer
165
166struct timespec evConsTime __P((time_t sec, long nsec));
167struct timespec evAddTime __P((struct timespec, struct timespec));
168struct timespec evSubTime __P((struct timespec, struct timespec));
169struct timespec evNowTime __P((void));
170struct timespec evUTCTime __P((void));
171struct timespec evLastEventTime __P((evContext));
172struct timespec evTimeSpec __P((struct timeval));
173struct timeval evTimeVal __P((struct timespec));
174int evCmpTime __P((struct timespec, struct timespec));
175int evSetTimer __P((evContext, evTimerFunc, void *, struct timespec,
176		    struct timespec, evTimerID *));
177int evClearTimer __P((evContext, evTimerID));
178int evConfigTimer __P((evContext, evTimerID, const char *param,
179		      int value));
180int evResetTimer __P((evContext, evTimerID, evTimerFunc, void *,
181		      struct timespec, struct timespec));
182int evSetIdleTimer __P((evContext, evTimerFunc, void *, struct timespec,
183			evTimerID *));
184int evClearIdleTimer __P((evContext, evTimerID));
185int evResetIdleTimer __P((evContext, evTimerID, evTimerFunc, void *,
186			  struct timespec));
187int evTouchIdleTimer __P((evContext, evTimerID));
188
189/* ev_waits.c */
190#define evWaitFor	__evWaitFor
191#define evDo		__evDo
192#define evUnwait	__evUnwait
193#define evDefer		__evDefer
194
195int evWaitFor __P((evContext, const void *, evWaitFunc, void *, evWaitID *));
196int evDo __P((evContext, const void *));
197int evUnwait __P((evContext, evWaitID));
198int evDefer __P((evContext, evWaitFunc, void *));
199
200#ifdef __EVENTLIB_P_DEFINED
201# undef __P
202#endif
203
204#endif /*_EVENTLIB_H*/
205
206/*! \file */
207