libuev/README.md

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

1. Create the event context with uev_ctx_create()
2. Register callbacks with uev_io_create() and uev_timer_create()
3. 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 library
• make test: Test and showcase
• make 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.