contrib/bind-9.2.4rc7/lib/bind/include/isc/eventlib.h

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