]> rtime.felk.cvut.cz Git - sojka/libev.git/blob - README
Add experimental support for EPOLLPRI to the epoll backend
[sojka/libev.git] / README
1 libev is a high-performance event loop/event model with lots of features.
2 (see benchmark at http://libev.schmorp.de/bench.html)
3
4
5 ABOUT
6
7    Homepage: http://software.schmorp.de/pkg/libev
8    Mailinglist: libev@lists.schmorp.de
9                 http://lists.schmorp.de/cgi-bin/mailman/listinfo/libev
10    Library Documentation: http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod
11
12    Libev is modelled (very losely) after libevent and the Event perl
13    module, but is faster, scales better and is more correct, and also more
14    featureful. And also smaller. Yay.
15
16    Some of the specialties of libev not commonly found elsewhere are:
17    
18    - extensive and detailed, readable documentation (not doxygen garbage).
19    - fully supports fork, can detect fork in various ways and automatically
20      re-arms kernel mechanisms that do not support fork.
21    - highly optimised select, poll, epoll, kqueue and event ports backends.
22    - filesystem object (path) watching (with optional linux inotify support).
23    - wallclock-based times (using absolute time, cron-like).
24    - relative timers/timeouts (handle time jumps).
25    - fast intra-thread communication between multiple
26      event loops (with optional fast linux eventfd backend).
27    - extremely easy to embed (fully documented, no dependencies,
28      autoconf supported but optional).
29    - very small codebase, no bloated library, simple code.
30    - fully extensible by being able to plug into the event loop,
31      integrate other event loops, integrate other event loop users.
32    - very little memory use (small watchers, small event loop data).
33    - optional C++ interface allowing method and function callbacks
34      at no extra memory or runtime overhead.
35    - optional Perl interface with similar characteristics (capable
36      of running Glib/Gtk2 on libev).
37    - support for other languages (multiple C++ interfaces, D, Ruby,
38      Python) available from third-parties.
39
40    Examples of programs that embed libev: the EV perl module, node.js,
41    auditd, rxvt-unicode, gvpe (GNU Virtual Private Ethernet), the
42    Deliantra MMORPG server (http://www.deliantra.net/), Rubinius (a
43    next-generation Ruby VM), the Ebb web server, the Rev event toolkit.
44
45
46 CONTRIBUTORS
47
48    libev was written and designed by Marc Lehmann and Emanuele Giaquinta.
49
50    The following people sent in patches or made other noteworthy
51    contributions to the design (for minor patches, see the Changes
52    file. If I forgot to include you, please shout at me, it was an
53    accident):
54
55    W.C.A. Wijngaards
56    Christopher Layne
57    Chris Brody
58