Home | History | Annotate | Line # | Download | only in isc
eventlib.h revision 1.1
      1 /*	$NetBSD: eventlib.h,v 1.1 2004/05/20 19:49:41 christos Exp $	*/
      2 
      3 /*
      4  * Copyright (c) 2004 by Internet Systems Consortium, Inc. ("ISC")
      5  * Copyright (c) 1995-1999 by Internet Software Consortium
      6  *
      7  * Permission to use, copy, modify, and 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
     12  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
     13  * MERCHANTABILITY AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR
     14  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
     15  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
     16  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
     17  * OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
     18  */
     19 
     20 /* eventlib.h - exported interfaces for eventlib
     21  * vix 09sep95 [initial]
     22  *
     23  * Id: eventlib.h,v 1.1.2.1.4.1 2004/03/09 08:33:31 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... */
     44 typedef struct { void *opaque; } evConnID;
     45 typedef struct { void *opaque; } evFileID;
     46 typedef struct { void *opaque; } evStreamID;
     47 typedef struct { void *opaque; } evTimerID;
     48 typedef struct { void *opaque; } evWaitID;
     49 typedef struct { void *opaque; } evContext;
     50 typedef struct { void *opaque; } evEvent;
     51 
     52 #define	evInitID(id) ((id)->opaque = NULL)
     53 #define	evTestID(id) ((id).opaque != NULL)
     54 
     55 typedef void (*evConnFunc)__P((evContext, void *, int, const void *, int,
     56 			       const void *, int));
     57 typedef void (*evFileFunc)__P((evContext, void *, int, int));
     58 typedef	void (*evStreamFunc)__P((evContext, void *, int, int));
     59 typedef void (*evTimerFunc)__P((evContext, void *,
     60 				struct timespec, struct timespec));
     61 typedef	void (*evWaitFunc)__P((evContext, void *, const void *));
     62 
     63 typedef	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 /* eventlib.c */
     82 #define evCreate	__evCreate
     83 #define evSetDebug	__evSetDebug
     84 #define evDestroy	__evDestroy
     85 #define evGetNext	__evGetNext
     86 #define evDispatch	__evDispatch
     87 #define evDrop		__evDrop
     88 #define evMainLoop	__evMainLoop
     89 #define evHighestFD	__evHighestFD
     90 #define evGetOption	__evGetOption
     91 #define evSetOption	__evSetOption
     92 
     93 int  evCreate __P((evContext *));
     94 void evSetDebug __P((evContext, int, FILE *));
     95 int  evDestroy __P((evContext));
     96 int  evGetNext __P((evContext, evEvent *, int));
     97 int  evDispatch __P((evContext, evEvent));
     98 void evDrop __P((evContext, evEvent));
     99 int  evMainLoop __P((evContext));
    100 int  evHighestFD __P((evContext));
    101 int  evGetOption __P((evContext *, const char *, int *));
    102 int  evSetOption __P((evContext *, const char *, int));
    103 
    104 /* ev_connects.c */
    105 #define evListen	__evListen
    106 #define evConnect	__evConnect
    107 #define evCancelConn	__evCancelConn
    108 #define evHold		__evHold
    109 #define evUnhold	__evUnhold
    110 #define evTryAccept	__evTryAccept
    111 
    112 int evListen __P((evContext, int, int, evConnFunc, void *, evConnID *));
    113 int evConnect __P((evContext, int, const void *, int,
    114 		   evConnFunc, void *, evConnID *));
    115 int evCancelConn __P((evContext, evConnID));
    116 int evHold __P((evContext, evConnID));
    117 int evUnhold __P((evContext, evConnID));
    118 int evTryAccept __P((evContext, evConnID, int *));
    119 
    120 /* ev_files.c */
    121 #define evSelectFD	__evSelectFD
    122 #define evDeselectFD	__evDeselectFD
    123 
    124 int evSelectFD __P((evContext, int, int, evFileFunc, void *, evFileID *));
    125 int evDeselectFD __P((evContext, evFileID));
    126 
    127 /* ev_streams.c */
    128 #define evConsIovec	__evConsIovec
    129 #define evWrite		__evWrite
    130 #define evRead		__evRead
    131 #define evTimeRW	__evTimeRW
    132 #define evUntimeRW	__evUntimeRW
    133 #define	evCancelRW	__evCancelRW
    134 
    135 struct iovec evConsIovec __P((void *, size_t));
    136 int evWrite __P((evContext, int, const struct iovec *, int,
    137 		 evStreamFunc func, void *, evStreamID *));
    138 int evRead __P((evContext, int, const struct iovec *, int,
    139 		evStreamFunc func, void *, evStreamID *));
    140 int evTimeRW __P((evContext, evStreamID, evTimerID timer));
    141 int evUntimeRW __P((evContext, evStreamID));
    142 int evCancelRW __P((evContext, evStreamID));
    143 
    144 /* ev_timers.c */
    145 #define evConsTime	__evConsTime
    146 #define evAddTime	__evAddTime
    147 #define evSubTime	__evSubTime
    148 #define evCmpTime	__evCmpTime
    149 #define	evTimeSpec	__evTimeSpec
    150 #define	evTimeVal	__evTimeVal
    151 
    152 #define evNowTime		__evNowTime
    153 #define evUTCTime		__evUTCTime
    154 #define evLastEventTime		__evLastEventTime
    155 #define evSetTimer		__evSetTimer
    156 #define evClearTimer		__evClearTimer
    157 #define evConfigTimer		__evConfigTimer
    158 #define evResetTimer		__evResetTimer
    159 #define evSetIdleTimer		__evSetIdleTimer
    160 #define evClearIdleTimer	__evClearIdleTimer
    161 #define evResetIdleTimer	__evResetIdleTimer
    162 #define evTouchIdleTimer	__evTouchIdleTimer
    163 
    164 struct timespec evConsTime __P((time_t sec, long nsec));
    165 struct timespec evAddTime __P((struct timespec, struct timespec));
    166 struct timespec evSubTime __P((struct timespec, struct timespec));
    167 struct timespec evNowTime __P((void));
    168 struct timespec evUTCTime __P((void));
    169 struct timespec evLastEventTime __P((evContext));
    170 struct timespec evTimeSpec __P((struct timeval));
    171 struct timeval evTimeVal __P((struct timespec));
    172 int evCmpTime __P((struct timespec, struct timespec));
    173 int evSetTimer __P((evContext, evTimerFunc, void *, struct timespec,
    174 		    struct timespec, evTimerID *));
    175 int evClearTimer __P((evContext, evTimerID));
    176 int evConfigTimer __P((evContext, evTimerID, const char *param,
    177 		      int value));
    178 int evResetTimer __P((evContext, evTimerID, evTimerFunc, void *,
    179 		      struct timespec, struct timespec));
    180 int evSetIdleTimer __P((evContext, evTimerFunc, void *, struct timespec,
    181 			evTimerID *));
    182 int evClearIdleTimer __P((evContext, evTimerID));
    183 int evResetIdleTimer __P((evContext, evTimerID, evTimerFunc, void *,
    184 			  struct timespec));
    185 int evTouchIdleTimer __P((evContext, evTimerID));
    186 
    187 /* ev_waits.c */
    188 #define evWaitFor	__evWaitFor
    189 #define evDo		__evDo
    190 #define evUnwait	__evUnwait
    191 #define evDefer		__evDefer
    192 
    193 int evWaitFor __P((evContext, const void *, evWaitFunc, void *, evWaitID *));
    194 int evDo __P((evContext, const void *));
    195 int evUnwait __P((evContext, evWaitID));
    196 int evDefer __P((evContext, evWaitFunc, void *));
    197 
    198 #ifdef __EVENTLIB_P_DEFINED
    199 # undef __P
    200 #endif
    201 
    202 #endif /*_EVENTLIB_H*/
    203