--- libev/ev.h 2007/11/17 02:29:06 1.61 +++ libev/ev.h 2007/11/24 06:23:27 1.65 @@ -71,18 +71,19 @@ #endif /* eventmask, revents, events... */ -#define EV_UNDEF -1 /* guaranteed to be invalid */ -#define EV_NONE 0x00 -#define EV_READ 0x01 /* io only */ -#define EV_WRITE 0x02 /* io only */ -#define EV_TIMEOUT 0x000100 /* timer only */ -#define EV_PERIODIC 0x000200 /* periodic timer only */ -#define EV_SIGNAL 0x000400 /* signal only */ -#define EV_IDLE 0x000800 /* idle only */ -#define EV_CHECK 0x001000 /* check only */ -#define EV_PREPARE 0x002000 /* prepare only */ -#define EV_CHILD 0x004000 /* child/pid only */ -#define EV_ERROR 0x800000 /* sent when an error occurs */ +#define EV_UNDEF -1L /* guaranteed to be invalid */ +#define EV_NONE 0x00L +#define EV_READ 0x01L /* io only */ +#define EV_WRITE 0x02L /* io only */ +#define EV_TIMEOUT 0x000100L /* timer only */ +#define EV_PERIODIC 0x000200L /* periodic timer only */ +#define EV_SIGNAL 0x000400L /* signal only */ +#define EV_IDLE 0x000800L /* idle only */ +#define EV_CHECK 0x001000L /* check only */ +#define EV_PREPARE 0x002000L /* prepare only */ +#define EV_CHILD 0x004000L /* child/pid only */ +#define EV_EMBED 0x008000L /* embedded event loop */ +#define EV_ERROR 0x800000L /* sent when an error occurs */ /* can be used to add custom fields to all watchers, while losing binary compatibility */ #ifndef EV_COMMON @@ -215,6 +216,18 @@ int rstatus; /* rw, holds the exit status, use the macros from sys/wait.h */ }; +#if EV_MULTIPLICITY +/* used to embed an event loop inside another */ +/* the callback gets invoked when the event loop has handled events, and can be 0 */ +struct ev_embed +{ + EV_WATCHER (ev_embed) + + struct ev_io io; /* private */ + struct ev_loop *loop; /* ro */ +}; +#endif + /* the presence of this union forces similar struct layout */ union ev_any_watcher { @@ -229,27 +242,30 @@ struct ev_check check; struct ev_signal signal; struct ev_child child; + struct ev_embed embed; }; /* bits for ev_default_loop and ev_loop_new */ /* the default */ -#define EVFLAG_AUTO 0x00000000 /* not quite a mask */ - -/* method bits to be ored together */ -#define EVMETHOD_SELECT 0x00000001 /* about anywhere */ -#define EVMETHOD_POLL 0x00000002 /* !win */ -#define EVMETHOD_EPOLL 0x00000004 /* linux */ -#define EVMETHOD_KQUEUE 0x00000008 /* bsd */ -#define EVMETHOD_DEVPOLL 0x00000010 /* solaris 8 */ /* NYI */ -#define EVMETHOD_PORT 0x00000020 /* solaris 10 */ - +#define EVFLAG_AUTO 0x00000000UL /* not quite a mask */ /* flag bits */ -#define EVFLAG_NOENV 0x01000000 /* do NOT consult environment */ +#define EVFLAG_NOENV 0x01000000UL /* do NOT consult environment */ +/* method bits to be ored together */ +#define EVBACKEND_SELECT 0x00000001UL /* about anywhere */ +#define EVBACKEND_POLL 0x00000002UL /* !win */ +#define EVBACKEND_EPOLL 0x00000004UL /* linux */ +#define EVBACKEND_KQUEUE 0x00000008UL /* bsd */ +#define EVBACKEND_DEVPOLL 0x00000010UL /* solaris 8 */ /* NYI */ +#define EVBACKEND_PORT 0x00000020UL /* solaris 10 */ #if EV_PROTOTYPES int ev_version_major (void); int ev_version_minor (void); +unsigned int ev_supported_backends (void); +unsigned int ev_recommended_backends (void); +unsigned int ev_embeddable_backends (void); + ev_tstamp ev_time (void); /* Sets the allocation function to use, works like realloc. @@ -308,11 +324,12 @@ /* you can actually call it at any time, anywhere :) */ void ev_default_fork (void); -unsigned int ev_method (EV_P); +unsigned int ev_backend (EV_P); #endif #define EVLOOP_NONBLOCK 1 /* do not block/wait */ #define EVLOOP_ONESHOT 2 /* block *once* only */ +#define EVUNLOOP_CANCEL 0 /* undo unloop */ #define EVUNLOOP_ONE 1 /* unloop once */ #define EVUNLOOP_ALL 2 /* unloop all loops */ @@ -350,6 +367,7 @@ #define ev_prepare_set(ev) /* nop, yes, this is a serious in-joke */ #define ev_check_set(ev) /* nop, yes, this is a serious in-joke */ #define ev_child_set(ev,pid_) do { (ev)->pid = (pid_); } while (0) +#define ev_embed_set(ev,loop_) do { (ev)->loop = (loop_); } while (0) #define ev_io_init(ev,cb,fd,events) do { ev_init ((ev), (cb)); ev_io_set ((ev),(fd),(events)); } while (0) #define ev_timer_init(ev,cb,after,repeat) do { ev_init ((ev), (cb)); ev_timer_set ((ev),(after),(repeat)); } while (0) @@ -359,6 +377,7 @@ #define ev_prepare_init(ev,cb) do { ev_init ((ev), (cb)); ev_prepare_set ((ev)); } while (0) #define ev_check_init(ev,cb) do { ev_init ((ev), (cb)); ev_check_set ((ev)); } while (0) #define ev_child_init(ev,cb,pid) do { ev_init ((ev), (cb)); ev_child_set ((ev),(pid)); } while (0) +#define ev_embed_init(ev,cb,loop) do { ev_init ((ev), (cb)); ev_embed_set ((ev),(loop)); } while (0) #define ev_is_pending(ev) (0 + ((struct ev_watcher *)(void *)(ev))->pending) /* ro, true when watcher is waiting for callback invocation */ #define ev_is_active(ev) (0 + ((struct ev_watcher *)(void *)(ev))->active) /* ro, true when the watcher has been started */ @@ -411,6 +430,13 @@ /* only supported in the default loop */ void ev_child_start (EV_P_ struct ev_child *w); void ev_child_stop (EV_P_ struct ev_child *w); + +# if EV_MULTIPLICITY +/* only supported when loop to be embedded is in fact embeddable */ +void ev_embed_start (EV_P_ struct ev_embed *w); +void ev_embed_stop (EV_P_ struct ev_embed *w); +# endif + #endif #ifdef __cplusplus