event: Timer and I/O Event Manager library

Introduction

event library is a simple C-language library (module) implementing a single threading core that allows a process to wait for multiple I/O and/or timer events. The module should work on a reasonable *nix system and uses several "advanced" event monitoring mechanism (like Linux epoll, FreeBSD kqueue and Solaris /dev/poll) as well as traditional poll() and select() mechanisms, whichever are available on a given platform. The library is somewhat similar to several others, like

libevent by Niels Provos (this is apparently most close alternative)
liboop by Dan Egnor
libio by Dan Bernstein

and others. This module tries to be simplest and fastest but yet easy to use. The module is used in proxycheck the open proxy checker.

There is no fancy installation procedure (yet), the module consists of 3 files - event.h (header file to use when compiling other programs), event.c - main source code, and event.3 the manual page describes module functionality in great details. The manpage is also available in html format.

The module is ready to use autoconf-style macros during compilation. The following preprocessor directives are recognized:

HAVE_EPOLL - epoll(4) is available
HAVE_KQUEUE - kqueue(2) is available
HAVE_DEVPOLL - devpool (poll(7d)) interface is available
HAVE_POLL - poll(2) interface is available
HAVE_SYS_SELECT_H - the <sys/select.h> include file is present
HAVE_CONFIG_H - include <config.h> to get other HAVE_* defines

In order to compile the event.o module, specify one or several symbols above (as appropriate for your system; or use autoconf tests) on command line, that's basically all.

License

event module is a free software, it may be used and distributed in terms of LGPL version 2 or later.

Download

Download it right here.

This module is written by Michael Tokarev. You may reach me via email at mjt(at)corpit(dot)ru.
Page last modified: Sat, 29 May 2004 18:58:34 +0400 by mjt.

Return to my software page.