1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
/***********************************************************************
*
* event.h
*
* Abstraction of select call into "event-handling" to make programming
* easier.
*
* Copyright (C) 2001-2003 Roaring Penguin Software Inc.
*
* This program may be distributed according to the terms of the GNU
* General Public License, version 2 or (at your option) any later version.
*
* $Id$
*
***********************************************************************/
#define DEBUG_EVENT
#ifndef INCLUDE_EVENT_H
#define INCLUDE_EVENT_H 1
struct EventSelector_t;
/* Callback function */
typedef void (*EventCallbackFunc)(struct EventSelector_t *es,
int fd, unsigned int flags,
void *data);
#include "eventpriv.h"
/* Create an event selector */
extern EventSelector *Event_CreateSelector(void);
/* Destroy the event selector */
extern void Event_DestroySelector(EventSelector *es);
/* Handle one event */
extern int Event_HandleEvent(EventSelector *es);
/* Add a handler for a ready file descriptor */
extern EventHandler *Event_AddHandler(EventSelector *es,
int fd,
unsigned int flags,
EventCallbackFunc fn, void *data);
/* Add a handler for a ready file descriptor with associated timeout*/
extern EventHandler *Event_AddHandlerWithTimeout(EventSelector *es,
int fd,
unsigned int flags,
struct timeval t,
EventCallbackFunc fn,
void *data);
/* Add a timer handler */
extern EventHandler *Event_AddTimerHandler(EventSelector *es,
struct timeval t,
EventCallbackFunc fn,
void *data);
/* Delete a handler */
extern int Event_DelHandler(EventSelector *es,
EventHandler *eh);
/* Retrieve callback function from a handler */
extern EventCallbackFunc Event_GetCallback(EventHandler *eh);
/* Retrieve data field from a handler */
extern void *Event_GetData(EventHandler *eh);
/* Set callback and data to new values */
extern void Event_SetCallbackAndData(EventHandler *eh,
EventCallbackFunc fn,
void *data);
extern int Event_EnableDebugging(char const *fname);
extern void set_cloexec(int fd);
#ifdef DEBUG_EVENT
extern void Event_DebugMsg(char const *fmt, ...);
#define EVENT_DEBUG(x) Event_DebugMsg x
#else
#define EVENT_DEBUG(x) ((void) 0)
#endif
/* Flags */
#define EVENT_FLAG_READABLE 1
#define EVENT_FLAG_WRITEABLE 2
#define EVENT_FLAG_WRITABLE EVENT_FLAG_WRITEABLE
/* This is strictly a timer event */
#define EVENT_FLAG_TIMER 4
/* This is a read or write event with an associated timeout */
#define EVENT_FLAG_TIMEOUT 8
#define EVENT_TIMER_BITS (EVENT_FLAG_TIMER | EVENT_FLAG_TIMEOUT)
#endif
|
