| 1 |
Revision history for libev, a high-performance and full-featured event loop. |
| 2 |
|
| 3 |
TODO: include ev_xyz_start in each example? |
| 4 |
TODO: which supports signals and child events |
| 5 |
TODO: pointer races |
| 6 |
TODO: ev_default_destroy, ev_default_fork |
| 7 |
- "PORTING FROM LIBEV 3.X TO 4.X" (in ev.pod) is recommended reading. |
| 8 |
- ev_embed_stop did not correctly stop the watcher (very good |
| 9 |
testcase by Vladimir Timofeev). |
| 10 |
- ev_run will now always update the current loop time - it erroneously |
| 11 |
didn't when idle watchers were active, causing timers not to fire. |
| 12 |
- fix a bug where a timeout of zero caused the timer not to fire |
| 13 |
in the libevent emulation (testcase by Péter Szabó). |
| 14 |
- applied win32 fixes by Michael Lenaghan (also James Mansion). |
| 15 |
- replace EV_MINIMAL by EV_FEATURES. |
| 16 |
- prefer EPOLL_CTL_ADD over EPOLL_CTL_MOD in some more cases, as it |
| 17 |
seems the former is *much* faster than the latter. |
| 18 |
- linux kernel version detection (for inotify bug workarounds) |
| 19 |
did not work properly. |
| 20 |
- reduce the number of spurious wake-ups with the ports backend. |
| 21 |
- remove dependency on sys/queue.h on freebsd (patch by Vanilla Hsu). |
| 22 |
- do async init within ev_async_start, not ev_async_set, which avoids |
| 23 |
an API quirk where the set function must be called in the C++ API |
| 24 |
even when there is nothing to set. |
| 25 |
- add (undocumented) EV_ENABLE when adding events with kqueue, |
| 26 |
this might help with OS X, which seems to need it despite documenting |
| 27 |
not to need it (helpfully pointed out by Tilghman Lesher). |
| 28 |
- do not use poll by default on freebsd, it's broken (what isn't |
| 29 |
on freebsd...). |
| 30 |
- allow to embed epoll on kernels >= 2.6.32. |
| 31 |
- configure now prepends -O3, not appends it, so one can still |
| 32 |
override it. |
| 33 |
- ev.pod: greatly expanded the portability section, added a porting |
| 34 |
section, a description of watcher states and made lots of minor fixes. |
| 35 |
- disable poll backend on AIX, the poll header spams the namespace |
| 36 |
and it's not worth working around dead platforms (reported |
| 37 |
and analyzed by Aivars Kalvans). |
| 38 |
- improve header file compatibility of the standalone eventfd code |
| 39 |
in an obscure case. |
| 40 |
- implement EV_AVOID_STDIO option. |
| 41 |
- do not use sscanf to parse linux version number (smaller, faster, |
| 42 |
no sscanf dependency). |
| 43 |
- new EV_CHILD_ENABLE and EV_SIGNAL_ENABLE configurable settings. |
| 44 |
- update libev.m4 HAVE_CLOCK_SYSCALL test for newer glibcs. |
| 45 |
- add section on accept() problems to the manpage. |
| 46 |
- rename EV_TIMEOUT to EV_TIMER. |
| 47 |
- rename ev_loop_count/depth/verify/loop/unloop. |
| 48 |
- remove ev_default_destroy and ev_default_fork. |
| 49 |
- switch to two-digit minor version. |
| 50 |
- work around an apparent gentoo compiler bug. |
| 51 |
- define _DARWIN_UNLIMITED_SELECT. just so. |
| 52 |
- use enum instead of #define for most constants. |
| 53 |
- improve compatibility to older C++ compilers. |
| 54 |
- (experimental) ev_run/ev_default_loop/ev_break/ev_loop_new have now |
| 55 |
default arguments when compiled as C++. |
| 56 |
- enable automake dependency tracking. |
| 57 |
- ev_loop_new no longer leaks memory when loop creation failed. |
| 58 |
|
| 59 |
3.9 Thu Dec 31 07:59:59 CET 2009 |
| 60 |
- signalfd is no longer used by default and has to be requested |
| 61 |
explicitly - this means that easy to catch bugs become hard to |
| 62 |
catch race conditions, but the users have spoken. |
| 63 |
- point out the unspecified signal mask in the documentation, and |
| 64 |
that this is a race condition regardless of EV_SIGNALFD. |
| 65 |
- backport inotify code to C89. |
| 66 |
- inotify file descriptors could leak into child processes. |
| 67 |
- ev_stat watchers could keep an errornous extra ref on the loop, |
| 68 |
preventing exit when unregistering all watchers (testcases |
| 69 |
provided by ry@tinyclouds.org). |
| 70 |
- implement EV_WIN32_HANDLE_TO_FD and EV_WIN32_CLOSE_FD configuration |
| 71 |
symbols to make it easier for apps to do their own fd management. |
| 72 |
- support EV_IDLE_ENABLE being disabled in ev++.h |
| 73 |
(patch by Didier Spezia). |
| 74 |
- take advantage of inotify_init1, if available, to set cloexec/nonblock |
| 75 |
on fd creation, to avoid races. |
| 76 |
- the signal handling pipe wasn't always initialised under windows |
| 77 |
(analysed by lekma). |
| 78 |
- changed minimum glibc requirement from glibc 2.9 to 2.7, for |
| 79 |
signalfd. |
| 80 |
- add missing string.h include (Denis F. Latypoff). |
| 81 |
- only replace ev_stat.prev when we detect an actual difference, |
| 82 |
so prev is (almost) always different to attr. this might |
| 83 |
have caused the problems with 04_stat.t. |
| 84 |
- add ev::timer->remaining () method to C++ API. |
| 85 |
|
| 86 |
3.8 Sun Aug 9 14:30:45 CEST 2009 |
| 87 |
- incompatible change: do not necessarily reset signal handler |
| 88 |
to SIG_DFL when a sighandler is stopped. |
| 89 |
- ev_default_destroy did not properly free or zero some members, |
| 90 |
potentially causing crashes and memory corruption on repeated |
| 91 |
ev_default_destroy/ev_default_loop calls. |
| 92 |
- take advantage of signalfd on GNU/Linux systems. |
| 93 |
- document that the signal mask might be in an unspecified |
| 94 |
state when using libev's signal handling. |
| 95 |
- take advantage of some GNU/Linux calls to set cloexec/nonblock |
| 96 |
on fd creation, to avoid race conditions. |
| 97 |
|
| 98 |
3.7 Fri Jul 17 16:36:32 CEST 2009 |
| 99 |
- ev_unloop and ev_loop wrongly used a global variable to exit loops, |
| 100 |
instead of using a per-loop variable (bug caught by accident...). |
| 101 |
- the ev_set_io_collect_interval interpretation has changed. |
| 102 |
- add new functionality: ev_set_userdata, ev_userdata, |
| 103 |
ev_set_invoke_pending_cb, ev_set_loop_release_cb, |
| 104 |
ev_invoke_pending, ev_pending_count, together with a long example |
| 105 |
about thread locking. |
| 106 |
- add ev_timer_remaining (as requested by Denis F. Latypoff). |
| 107 |
- add ev_loop_depth. |
| 108 |
- calling ev_unloop in fork/prepare watchers will no longer poll |
| 109 |
for new events. |
| 110 |
- Denis F. Latypoff corrected many typos in example code snippets. |
| 111 |
- honor autoconf detection of EV_USE_CLOCK_SYSCALL, also double- |
| 112 |
check that the syscall number is available before trying to |
| 113 |
use it (reported by ry@tinyclouds). |
| 114 |
- use GetSystemTimeAsFileTime instead of _timeb on windows, for |
| 115 |
slightly higher accuracy. |
| 116 |
- properly declare ev_loop_verify and ev_now_update even when |
| 117 |
!EV_MULTIPLICITY. |
| 118 |
- do not compile in any priority code when EV_MAXPRI == EV_MINPRI. |
| 119 |
- support EV_MINIMAL==2 for a reduced API. |
| 120 |
- actually 0-initialise struct sigaction when installing signals. |
| 121 |
- add section on hibernate and stopped processes to ev_timer docs. |
| 122 |
|
| 123 |
3.6 Tue Apr 28 02:49:30 CEST 2009 |
| 124 |
- multiple timers becoming ready within an event loop iteration |
| 125 |
will be invoked in the "correct" order now. |
| 126 |
- do not leave the event loop early just because we have no active |
| 127 |
watchers, fixing a problem when embedding a kqueue loop |
| 128 |
that has active kernel events but no registered watchers |
| 129 |
(reported by blacksand blacksand). |
| 130 |
- correctly zero the idx values for arrays, so destroying and |
| 131 |
reinitialising the default loop actually works (patch by |
| 132 |
Malek Hadj-Ali). |
| 133 |
- implement ev_suspend and ev_resume. |
| 134 |
- new EV_CUSTOM revents flag for use by applications. |
| 135 |
- add documentation section about priorites. |
| 136 |
- add a glossary to the dcoumentation. |
| 137 |
- extend the ev_fork description slightly. |
| 138 |
- optimize a jump out of call_pending. |
| 139 |
|
| 140 |
3.53 Sun Feb 15 02:38:20 CET 2009 |
| 141 |
- fix a bug in event pipe creation on win32 that would cause a |
| 142 |
failed assertion on event loop creation (patch by Malek Hadj-Ali). |
| 143 |
- probe for CLOCK_REALTIME support at runtime as well and fall |
| 144 |
back to gettimeofday if there is an error, to support older |
| 145 |
operating systems with newer header files/libraries. |
| 146 |
- prefer gettimeofday over clock_gettime with USE_CLOCK_SYSCALL |
| 147 |
(default most everywhere), otherwise not. |
| 148 |
|
| 149 |
3.52 Wed Jan 7 21:43:02 CET 2009 |
| 150 |
- fix compilation of select backend in fd_set mode when NFDBITS is |
| 151 |
missing (to get it to compile on QNX, reported by Rodrigo Campos). |
| 152 |
- better select-nfds handling when select backend is in fd_set mode. |
| 153 |
- diagnose fd_set overruns when select backend is in fd_set mode. |
| 154 |
- due to a thinko, instead of disabling everything but |
| 155 |
select on the borked OS X platform, everything but select was |
| 156 |
allowed (reported by Emanuele Giaquinta). |
| 157 |
- actually verify that local and remote port are matching in |
| 158 |
libev's socketpair emulation, which makes denial-of-service |
| 159 |
attacks harder (but not impossible - it's windows). Make sure |
| 160 |
it even works under vista, which thinks that getpeer/sockname |
| 161 |
should return fantasy port numbers. |
| 162 |
- include "libev" in all assertion messages for potentially |
| 163 |
clearer diagnostics. |
| 164 |
- event_get_version (libevent compatibility) returned |
| 165 |
a useless string instead of the expected version string |
| 166 |
(patch by W.C.A. Wijngaards). |
| 167 |
|
| 168 |
3.51 Wed Dec 24 23:00:11 CET 2008 |
| 169 |
- fix a bug where an inotify watcher was added twice, causing |
| 170 |
freezes on hash collisions (reported and analysed by Graham Leggett). |
| 171 |
- new config symbol, EV_USE_CLOCK_SYSCALL, to make libev use |
| 172 |
a direct syscall - slower, but no dependency on librt et al. |
| 173 |
- assume negative return values != -1 signals success of port_getn |
| 174 |
(http://cvs.epicsol.org/cgi/viewcvs.cgi/epic5/source/newio.c?rev=1.52) |
| 175 |
(no known failure reports, but it doesn't hurt). |
| 176 |
- fork detection in ev_embed now stops and restarts the watcher |
| 177 |
automatically. |
| 178 |
- EXPERIMENTAL: default the method to operator () in ev++.h, |
| 179 |
to make it nicer to use functors (requested by Benedek László). |
| 180 |
- fixed const object callbacks in ev++.h. |
| 181 |
- replaced loop_ref argument of watcher.set (loop) by a direct |
| 182 |
ev_loop * in ev++.h, to avoid clashes with functor patch. |
| 183 |
- do not try to watch the empty string via inotify. |
| 184 |
- inotify watchers could be leaked under certain circumstances. |
| 185 |
- OS X 10.5 is actually even more broken than earlier versions, |
| 186 |
so fall back to select on that piece of garbage. |
| 187 |
- fixed some weirdness in the ev_embed documentation. |
| 188 |
|
| 189 |
3.49 Wed Nov 19 11:26:53 CET 2008 |
| 190 |
- ev_stat watchers will now use inotify as a mere hint on |
| 191 |
kernels <2.6.25, or if the filesystem is not in the |
| 192 |
"known to be good" list. |
| 193 |
- better mingw32 compatibility (it's not as borked as native win32) |
| 194 |
(analysed by Roger Pack). |
| 195 |
- include stdio.h in the example program, as too many people are |
| 196 |
confused by the weird C language otherwise. I guess the next thing |
| 197 |
I get told is that the "..." ellipses in the examples don't compile |
| 198 |
with their C compiler. |
| 199 |
|
| 200 |
3.48 Thu Oct 30 09:02:37 CET 2008 |
| 201 |
- further optimise away the EPOLL_CTL_ADD/MOD combo in the epoll |
| 202 |
backend by assuming the kernel event mask hasn't changed if |
| 203 |
ADD fails with EEXIST. |
| 204 |
- work around spurious event notification bugs in epoll by using |
| 205 |
a 32-bit generation counter. recreate kernel state if we receive |
| 206 |
spurious notifications or unwanted events. this is very costly, |
| 207 |
but I didn't come up with this horrible design. |
| 208 |
- use memset to initialise most arrays now and do away with the |
| 209 |
init functions. |
| 210 |
- expand time-out strategies into a "Be smart about timeouts" section. |
| 211 |
- drop the "struct" from all ev_watcher declarations in the |
| 212 |
documentation and did other clarifications (yeah, it was a mistake |
| 213 |
to have a struct AND a function called ev_loop). |
| 214 |
- fix a bug where ev_default would not initialise the default |
| 215 |
loop again after it was destroyed with ev_default_destroy. |
| 216 |
- rename syserr to ev_syserr to avoid name clashes when embedding, |
| 217 |
do similar changes for event.c. |
| 218 |
|
| 219 |
3.45 Tue Oct 21 21:59:26 CEST 2008 |
| 220 |
- disable inotify usage on linux <2.6.25, as it is broken |
| 221 |
(reported by Yoann Vandoorselaere). |
| 222 |
- ev_stat erroneously would try to add inotify watchers |
| 223 |
even when inotify wasn't available (this should only |
| 224 |
have a performance impact). |
| 225 |
- ev_once now passes both timeout and io to the callback if both |
| 226 |
occur concurrently, instead of giving timeouts precedence. |
| 227 |
- disable EV_USE_INOTIFY when sys/inotify.h is too old. |
| 228 |
|
| 229 |
3.44 Mon Sep 29 05:18:39 CEST 2008 |
| 230 |
- embed watchers now automatically invoke ev_loop_fork on the |
| 231 |
embedded loop when the parent loop forks. |
| 232 |
- new function: ev_now_update (loop). |
| 233 |
- verify_watcher was not marked static. |
| 234 |
- improve the "associating..." manpage section. |
| 235 |
- documentation tweaks here and there. |
| 236 |
|
| 237 |
3.43 Sun Jul 6 05:34:41 CEST 2008 |
| 238 |
- include more include files on windows to get struct _stati64 |
| 239 |
(reported by Chris Hulbert, but doesn't quite fix his issue). |
| 240 |
- add missing #include <io.h> in ev.c on windows (reported by |
| 241 |
Matt Tolton). |
| 242 |
|
| 243 |
3.42 Tue Jun 17 12:12:07 CEST 2008 |
| 244 |
- work around yet another windows bug: FD_SET actually adds fd's |
| 245 |
multiple times to the fd_*SET*, despite official MSN docs claiming |
| 246 |
otherwise. Reported and well-analysed by Matt Tolton. |
| 247 |
- define NFDBITS to 0 when EV_SELECT_IS_WINSOCKET to make it compile |
| 248 |
(reported any analysed by Chris Hulbert). |
| 249 |
- fix a bug in ev_ebadf (this function is only used to catch |
| 250 |
programming errors in the libev user). reported by Matt Tolton. |
| 251 |
- fix a bug in fd_intern on win32 (could lead to compile errors |
| 252 |
under some circumstances, but would work correctly if it compiles). |
| 253 |
reported by Matt Tolton. |
| 254 |
- (try to) work around missing lstat on windows. |
| 255 |
- pass in the write fd set as except fd set under windows. windows |
| 256 |
is so uncontrollably lame that it requires this. this means that |
| 257 |
switching off oobinline is not supported (but tcp/ip doesn't |
| 258 |
have oob, so that would be stupid anyways. |
| 259 |
- use posix module symbol to auto-detect monotonic clock presence |
| 260 |
and some other default values. |
| 261 |
|
| 262 |
3.41 Fri May 23 18:42:54 CEST 2008 |
| 263 |
- work around an obscure bug in winsocket select: if you |
| 264 |
provide only empty fd sets then select returns WSAEINVAL. how sucky. |
| 265 |
- improve timer scheduling stability and reduce use of time_epsilon. |
| 266 |
- use 1-based 2-heap for EV_MINIMAL, simplifies code, reduces |
| 267 |
codesize and makes for better cache-efficiency. |
| 268 |
- use 3-based 4-heap for !EV_MINIMAL. this makes better use |
| 269 |
of cpu cache lines and gives better growth behaviour than |
| 270 |
2-based heaps. |
| 271 |
- cache timestamp within heap for !EV_MINIMAL, to avoid random |
| 272 |
memory accesses. |
| 273 |
- document/add EV_USE_4HEAP and EV_HEAP_CACHE_AT. |
| 274 |
- fix a potential aliasing issue in ev_timer_again. |
| 275 |
- add/document ev_periodic_at, retract direct access to ->at. |
| 276 |
- improve ev_stat docs. |
| 277 |
- add portability requirements section. |
| 278 |
- fix manpage headers etc. |
| 279 |
- normalise WSA error codes to lower range on windows. |
| 280 |
- add consistency check code that can be called automatically |
| 281 |
or on demand to check for internal structures (ev_loop_verify). |
| 282 |
|
| 283 |
3.31 Wed Apr 16 20:45:04 CEST 2008 |
| 284 |
- added last minute fix for ev_poll.c by Brandon Black. |
| 285 |
|
| 286 |
3.3 Wed Apr 16 19:04:10 CEST 2008 |
| 287 |
- event_base_loopexit should return 0 on success |
| 288 |
(W.C.A. Wijngaards). |
| 289 |
- added linux eventfd support. |
| 290 |
- try to autodetect epoll and inotify support |
| 291 |
by libc header version if not using autoconf. |
| 292 |
- new symbols: EV_DEFAULT_UC and EV_DEFAULT_UC_. |
| 293 |
- declare functions defined in ev.h as inline if |
| 294 |
C99 or gcc are available. |
| 295 |
- enable inlining with gcc versions 2 and 3. |
| 296 |
- work around broken poll implementations potentially |
| 297 |
not clearing revents field in ev_poll (Brandon Black) |
| 298 |
(no such systems are known at this time). |
| 299 |
- work around a bug in realloc on openbsd and darwin, |
| 300 |
also makes the erroneous valgrind complaints |
| 301 |
go away (noted by various people). |
| 302 |
- fix ev_async_pending, add c++ wrapper for ev_async |
| 303 |
(based on patch sent by Johannes Deisenhofer). |
| 304 |
- add sensible set method to ev::embed. |
| 305 |
- made integer constants type int in ev.h. |
| 306 |
|
| 307 |
3.2 Wed Apr 2 17:11:19 CEST 2008 |
| 308 |
- fix a 64 bit overflow issue in the select backend, |
| 309 |
by using fd_mask instead of int for the mask. |
| 310 |
- rename internal sighandler to avoid clash with very old perls. |
| 311 |
- entering ev_loop will not clear the ONESHOT or NONBLOCKING |
| 312 |
flags of any outer loops anymore. |
| 313 |
- add ev_async_pending. |
| 314 |
|
| 315 |
3.1 Thu Mar 13 13:45:22 CET 2008 |
| 316 |
- implement ev_async watchers. |
| 317 |
- only initialise signal pipe on demand. |
| 318 |
- make use of sig_atomic_t configurable. |
| 319 |
- improved documentation. |
| 320 |
|
| 321 |
3.0 Mon Jan 28 13:14:47 CET 2008 |
| 322 |
- API/ABI bump to version 3.0. |
| 323 |
- ev++.h includes "ev.h" by default now, not <ev.h>. |
| 324 |
- slightly improved documentation. |
| 325 |
- speed up signal detection after a fork. |
| 326 |
- only optionally return trace status changed in ev_child |
| 327 |
watchers. |
| 328 |
- experimental (and undocumented) loop wrappers for ev++.h. |
| 329 |
|
| 330 |
2.01 Tue Dec 25 08:04:41 CET 2007 |
| 331 |
- separate Changes file. |
| 332 |
- fix ev_path_set => ev_stat_set typo. |
| 333 |
- remove event_compat.h from the libev tarball. |
| 334 |
- change how include files are found. |
| 335 |
- doc updates. |
| 336 |
- update licenses, explicitly allow for GPL relicensing. |
| 337 |
|
| 338 |
2.0 Sat Dec 22 17:47:03 CET 2007 |
| 339 |
- new ev_sleep, ev_set_(io|timeout)_collect_interval. |
| 340 |
- removed epoll from embeddable fd set. |
| 341 |
- fix embed watchers. |
| 342 |
- renamed ev_embed.loop to other. |
| 343 |
- added exported Symbol tables. |
| 344 |
- undefine member wrapper macros at the end of ev.c. |
| 345 |
- respect EV_H in ev++.h. |
| 346 |
|
| 347 |
1.86 Tue Dec 18 02:36:57 CET 2007 |
| 348 |
- fix memleak on loop destroy (not relevant for perl). |
| 349 |
|
| 350 |
1.85 Fri Dec 14 20:32:40 CET 2007 |
| 351 |
- fix some aliasing issues w.r.t. timers and periodics |
| 352 |
(not relevant for perl). |
| 353 |
|
| 354 |
(for historic versions refer to EV/Changes, found in the Perl interface) |
| 355 |
|
| 356 |
0.1 Wed Oct 31 21:31:48 CET 2007 |
| 357 |
- original version; hacked together in <24h. |
| 358 |
|
