Joachim Nilsson
499cbd2032
This is a major refactor of the original design by Flemming Madsen. It converts the library timers from poll() to timerfd, which at the same time also unifies the file and timer watchers into one design. The idea is to also add signalfd to the mix later on. Also a couple of hundred kilobytes smaller, although size a secondary goal. The primary goal is to further simplify the internal design and to continuously strive to employ modern APIs. Signed-off-by: Joachim Nilsson <troglobit@gmail.com>
libuev - Micro event loop library
The libuev library is a small event library in the style of the venerable Xt(3) event loop.
Basically an event context is created and handlers for timers and I/O stream events can be registered with this context.
After initial setup, the typical application will enter the event loop that will only return at program termination.
The C API
The typical application will do the following steps
- Create the event context with
uev_ctx_create() - Register callbacks with
uev_io_create()anduev_timer_create() - Enter the event loop with uev_run()
Note: Make sure to use non-blocking stream I/O!
Build & Install
The library is built and developed for GNU/Linux systems, as such it may use GNU GCC and GNU Make specific features, but may also work with other UNIX systems as well.
make all: The librarymake test: Test and showcasemake install: Honors $prefix and $DESTDIR environment variables
Warning
Please be advised, libuev is not thread safe! It is primarily intended for use-cases where the engineed wants to avoid the use of threads.
However, if you insist on trying to use libuev with threads, the uev_t
structure needs mutex protection against simultaneous access.