ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/libev/Changes
Revision: 1.243
Committed: Mon Dec 19 20:15:28 2011 UTC (12 years, 4 months ago) by root
Branch: MAIN
Changes since 1.242: +1 -0 lines
Log Message:
*** empty log message ***

File Contents

# User Rev Content
1 root 1.14 Revision history for libev, a high-performance and full-featured event loop.
2 root 1.1
3 root 1.227 TODO: ev_loop_wakeup
4 root 1.225
5 root 1.236 TODO: EV_NO_THREADS/NO_SMP and/or EV_USE_PTHREADS or so. also document.
6 root 1.237 TODO: #define EV_API_DECL static? ev_default_loop_ptr?
7 root 1.240 TODO: EV_STANDALONE == NO_HASSEL (do not use clock_gettime in ev_standalone)
8     TODO: memory fences for clang
9 root 1.243 TODO: fix repeat=0 in http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#Be_smart_about_timeouts
10 root 1.233 4.10
11 root 1.234 - fix a race where the workaround against the epoll fork bugs
12     caused signals to not be handled anymore.
13 root 1.229 - correct backend_fudge for most backends, and implement a windows
14     specific workaround to avoid looping because we call both
15     select and Sleep, both with different time resolutions.
16 root 1.230 - document range and guarantees of ev_sleep.
17 root 1.231 - document reasonable ranges for periodics interval and offset.
18     - rename backend_fudge to backend_mintime to avoid future confusion :)
19 root 1.225 - change the default periodic reschedule function to hopefully be more
20 root 1.226 exact and correct even in corner cases or in the far future.
21 root 1.225 - do not rely on -lm anymore: use it when available but use our
22 root 1.230 own floor () if it is missing. This should make it easier to embed,
23     as no external libraries are required.
24 root 1.232 - strategically import macros from libecb and mark rarely-used functions
25 sf-exg 1.239 as cache-cold (saving almost 2k code size on typical amd64 setups).
26 root 1.237 - add Symbols.ev and Symbols.event files, that were missing.
27 root 1.242 - fix backend_mintime value for epoll (was 1/1024, is 1/1000 now).
28 root 1.225
29 root 1.224 4.04 Wed Feb 16 09:01:51 CET 2011
30     - fix two problems in the native win32 backend, where reuse of fd's
31     with different underlying handles caused handles not to be removed
32     or added to the select set (analyzed and tested by Bert Belder).
33 root 1.221 - do no rely on ceil() in ev_e?poll.c.
34 root 1.222 - backport libev to HP-UX versions before 11 v3.
35 root 1.223 - configure did not detect nanosleep and clock_gettime properly when
36     they are available in the libc (as opposed to -lrt).
37 root 1.221
38 root 1.219 4.03 Tue Jan 11 14:37:25 CET 2011
39 root 1.217 - officially support polling files with all backends.
40 root 1.212 - support files, /dev/zero etc. the same way as select in the epoll
41     backend, by generating events on our own.
42 root 1.217 - ports backend: work around solaris bug 6874410 and many related ones
43     (EINTR, maybe more), with no performance loss (note that the solaris
44     bug report is actually wrong, reality is far more bizarre and broken
45     than that).
46 root 1.209 - define EV_READ/EV_WRITE as macros in event.h, as some programs use
47     #ifdef to test for them.
48 root 1.213 - new (experimental) function: ev_feed_signal.
49     - new (to become default) EVFLAG_NOSIGMASK flag.
50     - new EVBACKEND_MASK symbol.
51 root 1.220 - updated COMMON IDIOMS SECTION.
52 root 1.209
53 root 1.207 4.01 Fri Nov 5 21:51:29 CET 2010
54 root 1.205 - automake fucked it up, apparently, --add-missing -f is not quite enough
55 root 1.206 to make it update its files, so 4.00 didn't install ev++.h and
56     event.h on make install. grrr.
57     - ev_loop(count|depth) didn't return anything (Robin Haberkorn).
58 root 1.203 - change EV_UNDEF to 0xffffffff to silence some overzealous compilers.
59 root 1.204 - use "(libev) " prefix for all libev error messages now.
60 root 1.203
61 root 1.202 4.00 Mon Oct 25 12:32:12 CEST 2010
62 root 1.171 - "PORTING FROM LIBEV 3.X TO 4.X" (in ev.pod) is recommended reading.
63 root 1.161 - ev_embed_stop did not correctly stop the watcher (very good
64     testcase by Vladimir Timofeev).
65 sf-exg 1.191 - ev_run will now always update the current loop time - it erroneously
66 root 1.187 didn't when idle watchers were active, causing timers not to fire.
67 root 1.179 - fix a bug where a timeout of zero caused the timer not to fire
68     in the libevent emulation (testcase by Péter Szabó).
69 root 1.164 - applied win32 fixes by Michael Lenaghan (also James Mansion).
70 root 1.166 - replace EV_MINIMAL by EV_FEATURES.
71 root 1.178 - prefer EPOLL_CTL_ADD over EPOLL_CTL_MOD in some more cases, as it
72     seems the former is *much* faster than the latter.
73 root 1.197 - linux kernel version detection (for inotify bug workarounds)
74     did not work properly.
75 root 1.185 - reduce the number of spurious wake-ups with the ports backend.
76 root 1.158 - remove dependency on sys/queue.h on freebsd (patch by Vanilla Hsu).
77 root 1.186 - do async init within ev_async_start, not ev_async_set, which avoids
78     an API quirk where the set function must be called in the C++ API
79     even when there is nothing to set.
80 root 1.174 - add (undocumented) EV_ENABLE when adding events with kqueue,
81 root 1.175 this might help with OS X, which seems to need it despite documenting
82     not to need it (helpfully pointed out by Tilghman Lesher).
83 root 1.176 - do not use poll by default on freebsd, it's broken (what isn't
84     on freebsd...).
85 root 1.195 - allow to embed epoll on kernels >= 2.6.32.
86 root 1.159 - configure now prepends -O3, not appends it, so one can still
87     override it.
88 root 1.190 - ev.pod: greatly expanded the portability section, added a porting
89     section, a description of watcher states and made lots of minor fixes.
90 root 1.160 - disable poll backend on AIX, the poll header spams the namespace
91     and it's not worth working around dead platforms (reported
92     and analyzed by Aivars Kalvans).
93 root 1.162 - improve header file compatibility of the standalone eventfd code
94     in an obscure case.
95 root 1.163 - implement EV_AVOID_STDIO option.
96     - do not use sscanf to parse linux version number (smaller, faster,
97     no sscanf dependency).
98 root 1.164 - new EV_CHILD_ENABLE and EV_SIGNAL_ENABLE configurable settings.
99 sf-exg 1.172 - update libev.m4 HAVE_CLOCK_SYSCALL test for newer glibcs.
100 root 1.165 - add section on accept() problems to the manpage.
101 root 1.168 - rename EV_TIMEOUT to EV_TIMER.
102 root 1.190 - rename ev_loop_count/depth/verify/loop/unloop.
103 root 1.197 - remove ev_default_destroy and ev_default_fork.
104 root 1.168 - switch to two-digit minor version.
105 root 1.180 - work around an apparent gentoo compiler bug.
106 root 1.181 - define _DARWIN_UNLIMITED_SELECT. just so.
107 root 1.188 - use enum instead of #define for most constants.
108     - improve compatibility to older C++ compilers.
109 root 1.193 - (experimental) ev_run/ev_default_loop/ev_break/ev_loop_new have now
110     default arguments when compiled as C++.
111 root 1.196 - enable automake dependency tracking.
112 root 1.197 - ev_loop_new no longer leaks memory when loop creation failed.
113 root 1.198 - new ev_cleanup watcher type.
114 root 1.157
115 root 1.156 3.9 Thu Dec 31 07:59:59 CET 2009
116 root 1.155 - signalfd is no longer used by default and has to be requested
117     explicitly - this means that easy to catch bugs become hard to
118     catch race conditions, but the users have spoken.
119     - point out the unspecified signal mask in the documentation, and
120     that this is a race condition regardless of EV_SIGNALFD.
121 root 1.142 - backport inotify code to C89.
122 root 1.148 - inotify file descriptors could leak into child processes.
123 sf-exg 1.241 - ev_stat watchers could keep an erroneous extra ref on the loop,
124 root 1.151 preventing exit when unregistering all watchers (testcases
125 root 1.150 provided by ry@tinyclouds.org).
126 root 1.143 - implement EV_WIN32_HANDLE_TO_FD and EV_WIN32_CLOSE_FD configuration
127 root 1.145 symbols to make it easier for apps to do their own fd management.
128 root 1.144 - support EV_IDLE_ENABLE being disabled in ev++.h
129     (patch by Didier Spezia).
130 root 1.147 - take advantage of inotify_init1, if available, to set cloexec/nonblock
131     on fd creation, to avoid races.
132 root 1.150 - the signal handling pipe wasn't always initialised under windows
133     (analysed by lekma).
134 root 1.146 - changed minimum glibc requirement from glibc 2.9 to 2.7, for
135     signalfd.
136 root 1.152 - add missing string.h include (Denis F. Latypoff).
137 root 1.153 - only replace ev_stat.prev when we detect an actual difference,
138     so prev is (almost) always different to attr. this might
139 sf-exg 1.191 have caused the problems with 04_stat.t.
140 root 1.154 - add ev::timer->remaining () method to C++ API.
141 root 1.142
142 root 1.141 3.8 Sun Aug 9 14:30:45 CEST 2009
143 root 1.133 - incompatible change: do not necessarily reset signal handler
144     to SIG_DFL when a sighandler is stopped.
145 root 1.135 - ev_default_destroy did not properly free or zero some members,
146 sf-exg 1.191 potentially causing crashes and memory corruption on repeated
147 root 1.134 ev_default_destroy/ev_default_loop calls.
148 root 1.133 - take advantage of signalfd on GNU/Linux systems.
149     - document that the signal mask might be in an unspecified
150     state when using libev's signal handling.
151 root 1.136 - take advantage of some GNU/Linux calls to set cloexec/nonblock
152     on fd creation, to avoid race conditions.
153 root 1.132
154 root 1.131 3.7 Fri Jul 17 16:36:32 CEST 2009
155 root 1.128 - ev_unloop and ev_loop wrongly used a global variable to exit loops,
156     instead of using a per-loop variable (bug caught by accident...).
157     - the ev_set_io_collect_interval interpretation has changed.
158     - add new functionality: ev_set_userdata, ev_userdata,
159 root 1.126 ev_set_invoke_pending_cb, ev_set_loop_release_cb,
160 root 1.132 ev_invoke_pending, ev_pending_count, together with a long example
161     about thread locking.
162 root 1.128 - add ev_timer_remaining (as requested by Denis F. Latypoff).
163     - add ev_loop_depth.
164 root 1.124 - calling ev_unloop in fork/prepare watchers will no longer poll
165     for new events.
166 root 1.115 - Denis F. Latypoff corrected many typos in example code snippets.
167     - honor autoconf detection of EV_USE_CLOCK_SYSCALL, also double-
168     check that the syscall number is available before trying to
169     use it (reported by ry@tinyclouds).
170 root 1.117 - use GetSystemTimeAsFileTime instead of _timeb on windows, for
171 root 1.116 slightly higher accuracy.
172 root 1.122 - properly declare ev_loop_verify and ev_now_update even when
173     !EV_MULTIPLICITY.
174 root 1.121 - do not compile in any priority code when EV_MAXPRI == EV_MINPRI.
175 root 1.123 - support EV_MINIMAL==2 for a reduced API.
176 root 1.125 - actually 0-initialise struct sigaction when installing signals.
177 root 1.127 - add section on hibernate and stopped processes to ev_timer docs.
178 root 1.115
179 root 1.113 3.6 Tue Apr 28 02:49:30 CEST 2009
180 root 1.107 - multiple timers becoming ready within an event loop iteration
181     will be invoked in the "correct" order now.
182 root 1.105 - do not leave the event loop early just because we have no active
183     watchers, fixing a problem when embedding a kqueue loop
184     that has active kernel events but no registered watchers
185     (reported by blacksand blacksand).
186 root 1.102 - correctly zero the idx values for arrays, so destroying and
187     reinitialising the default loop actually works (patch by
188     Malek Hadj-Ali).
189 root 1.108 - implement ev_suspend and ev_resume.
190 root 1.106 - new EV_CUSTOM revents flag for use by applications.
191 sf-exg 1.241 - add documentation section about priorities.
192 root 1.109 - add a glossary to the dcoumentation.
193 root 1.111 - extend the ev_fork description slightly.
194 root 1.112 - optimize a jump out of call_pending.
195 root 1.102
196 root 1.101 3.53 Sun Feb 15 02:38:20 CET 2009
197     - fix a bug in event pipe creation on win32 that would cause a
198     failed assertion on event loop creation (patch by Malek Hadj-Ali).
199 root 1.100 - probe for CLOCK_REALTIME support at runtime as well and fall
200     back to gettimeofday if there is an error, to support older
201     operating systems with newer header files/libraries.
202     - prefer gettimeofday over clock_gettime with USE_CLOCK_SYSCALL
203     (default most everywhere), otherwise not.
204    
205 root 1.99 3.52 Wed Jan 7 21:43:02 CET 2009
206 root 1.97 - fix compilation of select backend in fd_set mode when NFDBITS is
207     missing (to get it to compile on QNX, reported by Rodrigo Campos).
208     - better select-nfds handling when select backend is in fd_set mode.
209     - diagnose fd_set overruns when select backend is in fd_set mode.
210     - due to a thinko, instead of disabling everything but
211     select on the borked OS X platform, everything but select was
212     allowed (reported by Emanuele Giaquinta).
213 root 1.95 - actually verify that local and remote port are matching in
214     libev's socketpair emulation, which makes denial-of-service
215     attacks harder (but not impossible - it's windows). Make sure
216 root 1.96 it even works under vista, which thinks that getpeer/sockname
217     should return fantasy port numbers.
218 root 1.100 - include "libev" in all assertion messages for potentially
219 root 1.97 clearer diagnostics.
220 root 1.98 - event_get_version (libevent compatibility) returned
221     a useless string instead of the expected version string
222     (patch by W.C.A. Wijngaards).
223 root 1.95
224 root 1.94 3.51 Wed Dec 24 23:00:11 CET 2008
225 root 1.91 - fix a bug where an inotify watcher was added twice, causing
226 root 1.92 freezes on hash collisions (reported and analysed by Graham Leggett).
227 root 1.87 - new config symbol, EV_USE_CLOCK_SYSCALL, to make libev use
228     a direct syscall - slower, but no dependency on librt et al.
229 root 1.88 - assume negative return values != -1 signals success of port_getn
230     (http://cvs.epicsol.org/cgi/viewcvs.cgi/epic5/source/newio.c?rev=1.52)
231     (no known failure reports, but it doesn't hurt).
232 root 1.93 - fork detection in ev_embed now stops and restarts the watcher
233     automatically.
234 root 1.89 - EXPERIMENTAL: default the method to operator () in ev++.h,
235     to make it nicer to use functors (requested by Benedek László).
236     - fixed const object callbacks in ev++.h.
237 root 1.90 - replaced loop_ref argument of watcher.set (loop) by a direct
238     ev_loop * in ev++.h, to avoid clashes with functor patch.
239 root 1.91 - do not try to watch the empty string via inotify.
240 root 1.92 - inotify watchers could be leaked under certain circumstances.
241     - OS X 10.5 is actually even more broken than earlier versions,
242     so fall back to select on that piece of garbage.
243 root 1.93 - fixed some weirdness in the ev_embed documentation.
244 root 1.87
245 root 1.86 3.49 Wed Nov 19 11:26:53 CET 2008
246 root 1.83 - ev_stat watchers will now use inotify as a mere hint on
247     kernels <2.6.25, or if the filesystem is not in the
248     "known to be good" list.
249 root 1.84 - better mingw32 compatibility (it's not as borked as native win32)
250     (analysed by Roger Pack).
251 root 1.85 - include stdio.h in the example program, as too many people are
252     confused by the weird C language otherwise. I guess the next thing
253     I get told is that the "..." ellipses in the examples don't compile
254     with their C compiler.
255 root 1.83
256 root 1.80 3.48 Thu Oct 30 09:02:37 CET 2008
257 root 1.71 - further optimise away the EPOLL_CTL_ADD/MOD combo in the epoll
258     backend by assuming the kernel event mask hasn't changed if
259     ADD fails with EEXIST.
260 root 1.75 - work around spurious event notification bugs in epoll by using
261 root 1.77 a 32-bit generation counter. recreate kernel state if we receive
262 root 1.78 spurious notifications or unwanted events. this is very costly,
263     but I didn't come up with this horrible design.
264 root 1.71 - use memset to initialise most arrays now and do away with the
265     init functions.
266 root 1.72 - expand time-out strategies into a "Be smart about timeouts" section.
267     - drop the "struct" from all ev_watcher declarations in the
268 root 1.73 documentation and did other clarifications (yeah, it was a mistake
269     to have a struct AND a function called ev_loop).
270 root 1.74 - fix a bug where ev_default would not initialise the default
271     loop again after it was destroyed with ev_default_destroy.
272 root 1.79 - rename syserr to ev_syserr to avoid name clashes when embedding,
273     do similar changes for event.c.
274 root 1.71
275 root 1.69 3.45 Tue Oct 21 21:59:26 CEST 2008
276 root 1.67 - disable inotify usage on linux <2.6.25, as it is broken
277     (reported by Yoann Vandoorselaere).
278 sf-exg 1.191 - ev_stat erroneously would try to add inotify watchers
279 root 1.68 even when inotify wasn't available (this should only
280 root 1.67 have a performance impact).
281 root 1.65 - ev_once now passes both timeout and io to the callback if both
282     occur concurrently, instead of giving timeouts precedence.
283 root 1.66 - disable EV_USE_INOTIFY when sys/inotify.h is too old.
284 root 1.65
285 root 1.62 3.44 Mon Sep 29 05:18:39 CEST 2008
286     - embed watchers now automatically invoke ev_loop_fork on the
287     embedded loop when the parent loop forks.
288 root 1.58 - new function: ev_now_update (loop).
289 root 1.57 - verify_watcher was not marked static.
290 root 1.59 - improve the "associating..." manpage section.
291 root 1.60 - documentation tweaks here and there.
292 root 1.57
293 root 1.56 3.43 Sun Jul 6 05:34:41 CEST 2008
294 root 1.54 - include more include files on windows to get struct _stati64
295 root 1.56 (reported by Chris Hulbert, but doesn't quite fix his issue).
296 root 1.53 - add missing #include <io.h> in ev.c on windows (reported by
297     Matt Tolton).
298    
299 root 1.52 3.42 Tue Jun 17 12:12:07 CEST 2008
300 root 1.50 - work around yet another windows bug: FD_SET actually adds fd's
301     multiple times to the fd_*SET*, despite official MSN docs claiming
302 root 1.51 otherwise. Reported and well-analysed by Matt Tolton.
303     - define NFDBITS to 0 when EV_SELECT_IS_WINSOCKET to make it compile
304 root 1.48 (reported any analysed by Chris Hulbert).
305 root 1.49 - fix a bug in ev_ebadf (this function is only used to catch
306     programming errors in the libev user). reported by Matt Tolton.
307     - fix a bug in fd_intern on win32 (could lead to compile errors
308     under some circumstances, but would work correctly if it compiles).
309     reported by Matt Tolton.
310 root 1.50 - (try to) work around missing lstat on windows.
311 root 1.45 - pass in the write fd set as except fd set under windows. windows
312 root 1.46 is so uncontrollably lame that it requires this. this means that
313     switching off oobinline is not supported (but tcp/ip doesn't
314     have oob, so that would be stupid anyways.
315 root 1.47 - use posix module symbol to auto-detect monotonic clock presence
316     and some other default values.
317 root 1.45
318 root 1.44 3.41 Fri May 23 18:42:54 CEST 2008
319 root 1.46 - work around an obscure bug in winsocket select: if you
320 root 1.40 provide only empty fd sets then select returns WSAEINVAL. how sucky.
321 root 1.41 - improve timer scheduling stability and reduce use of time_epsilon.
322 root 1.36 - use 1-based 2-heap for EV_MINIMAL, simplifies code, reduces
323     codesize and makes for better cache-efficiency.
324     - use 3-based 4-heap for !EV_MINIMAL. this makes better use
325     of cpu cache lines and gives better growth behaviour than
326     2-based heaps.
327 root 1.38 - cache timestamp within heap for !EV_MINIMAL, to avoid random
328     memory accesses.
329     - document/add EV_USE_4HEAP and EV_HEAP_CACHE_AT.
330 root 1.33 - fix a potential aliasing issue in ev_timer_again.
331 root 1.35 - add/document ev_periodic_at, retract direct access to ->at.
332     - improve ev_stat docs.
333     - add portability requirements section.
334 root 1.39 - fix manpage headers etc.
335 root 1.40 - normalise WSA error codes to lower range on windows.
336 root 1.43 - add consistency check code that can be called automatically
337     or on demand to check for internal structures (ev_loop_verify).
338 root 1.31
339 root 1.30 3.31 Wed Apr 16 20:45:04 CEST 2008
340     - added last minute fix for ev_poll.c by Brandon Black.
341 root 1.29
342 root 1.28 3.3 Wed Apr 16 19:04:10 CEST 2008
343 root 1.23 - event_base_loopexit should return 0 on success
344     (W.C.A. Wijngaards).
345 root 1.20 - added linux eventfd support.
346     - try to autodetect epoll and inotify support
347     by libc header version if not using autoconf.
348 root 1.21 - new symbols: EV_DEFAULT_UC and EV_DEFAULT_UC_.
349     - declare functions defined in ev.h as inline if
350     C99 or gcc are available.
351     - enable inlining with gcc versions 2 and 3.
352 root 1.25 - work around broken poll implementations potentially
353     not clearing revents field in ev_poll (Brandon Black)
354     (no such systems are known at this time).
355 root 1.23 - work around a bug in realloc on openbsd and darwin,
356 sf-exg 1.191 also makes the erroneous valgrind complaints
357 root 1.23 go away (noted by various people).
358 root 1.26 - fix ev_async_pending, add c++ wrapper for ev_async
359 sf-exg 1.191 (based on patch sent by Johannes Deisenhofer).
360 root 1.26 - add sensible set method to ev::embed.
361 root 1.27 - made integer constants type int in ev.h.
362 root 1.20
363 root 1.19 3.2 Wed Apr 2 17:11:19 CEST 2008
364 root 1.15 - fix a 64 bit overflow issue in the select backend,
365     by using fd_mask instead of int for the mask.
366 root 1.16 - rename internal sighandler to avoid clash with very old perls.
367 root 1.18 - entering ev_loop will not clear the ONESHOT or NONBLOCKING
368     flags of any outer loops anymore.
369 root 1.17 - add ev_async_pending.
370 root 1.15
371 root 1.14 3.1 Thu Mar 13 13:45:22 CET 2008
372 root 1.12 - implement ev_async watchers.
373 root 1.10 - only initialise signal pipe on demand.
374     - make use of sig_atomic_t configurable.
375 root 1.14 - improved documentation.
376 root 1.10
377 root 1.9 3.0 Mon Jan 28 13:14:47 CET 2008
378 root 1.6 - API/ABI bump to version 3.0.
379 root 1.4 - ev++.h includes "ev.h" by default now, not <ev.h>.
380     - slightly improved documentation.
381 root 1.5 - speed up signal detection after a fork.
382 root 1.6 - only optionally return trace status changed in ev_child
383     watchers.
384 root 1.8 - experimental (and undocumented) loop wrappers for ev++.h.
385 root 1.4
386 root 1.2 2.01 Tue Dec 25 08:04:41 CET 2007
387 root 1.3 - separate Changes file.
388 root 1.2 - fix ev_path_set => ev_stat_set typo.
389     - remove event_compat.h from the libev tarball.
390     - change how include files are found.
391     - doc updates.
392     - update licenses, explicitly allow for GPL relicensing.
393    
394     2.0 Sat Dec 22 17:47:03 CET 2007
395     - new ev_sleep, ev_set_(io|timeout)_collect_interval.
396     - removed epoll from embeddable fd set.
397     - fix embed watchers.
398     - renamed ev_embed.loop to other.
399     - added exported Symbol tables.
400     - undefine member wrapper macros at the end of ev.c.
401     - respect EV_H in ev++.h.
402    
403     1.86 Tue Dec 18 02:36:57 CET 2007
404     - fix memleak on loop destroy (not relevant for perl).
405    
406     1.85 Fri Dec 14 20:32:40 CET 2007
407     - fix some aliasing issues w.r.t. timers and periodics
408     (not relevant for perl).
409    
410     (for historic versions refer to EV/Changes, found in the Perl interface)
411    
412 root 1.1 0.1 Wed Oct 31 21:31:48 CET 2007
413     - original version; hacked together in <24h.
414