--- AnyEvent/Changes 2009/06/22 11:57:05 1.242 +++ AnyEvent/Changes 2011/08/25 01:29:11 1.488 @@ -1,12 +1,505 @@ Revision history for Perl extension AnyEvent. -TODO: document ->loop, and maybe one_event. -TODO: iolae.pl +TODO: document TCP_*** constants + +TODO: AnyEvent::Log +TODO: ae::log examples +TODO: consolide slogging, e.g AnyEvent::Debug +TODO: /etc/hosts, for resolve_sockaddr? +6.01 + - INCOMPATIBLE CHANGE: AnyEvent::DNS resource records now include + the TTL as fourth element - this affects ->resolve, ->request + and ->dns_unpack indirectly. Convenience functions such as + AnyEvent::DNS::{a,txt,mx,srv} are not affected, neither is + AnyEvent::Socket. + - INCOMPATIBLE CHANGE: backend authors now should not implement + one_event or loop, but instead the AnyEvent::CondVar::_wait and _poll + methods. + - INCOMPATIBLE CHANGE: verbosity levels have been redefined, see + AnyEvent (PERL_ANYEVENT_VERBOSE) and AnyEvent::Log for details. + - DEPRECIATION: please change + "use AnyEvent::Impl::Perl" to "use AnyEvent::Loop" and + "AnyEvent::Impl::Perl::loop" to "AnyEvent::Loop::run" + in your programs, for future compatibility. + - *blush* idle watcher emulation was borked. + - AnyEvent::Strict now checks the AE::xxx functions as well. + - querying too long domain names would barf deep inside AnyEvent::DNS - since + this is hard to avoid for applications, AnyEvent:.DNS::request now checks for + for too long domain names explicitly and passes an undef to the callback + instead (reported by James Bromberger). + - make AnyEvent::Util more robust against EINTR (analyzed by Andrew Suffield). + - new functions: AnyEvent::postpone, AnyEvent::log. + - new module: AnyEvent::Log, for simple logging needs. + - new env variable, PERL_ANYEVENT_LOG, for fine-grained logging config. + - new env variable, PERL_ANYEVENT_DEBUG_SHELL, to automatically start + a debug shell. + - new env variable, PERL_ANYEVENT_DEBUG_WRAP, to automatically enable + watcher instrumentation/wrapping (see AnyEvent::Debug::wrap). + - new env variable, PERL_ANYEVENT_HOSTS, to override the place where + F can be found. + - an empty PERL_ANYEVENT_RESOLV_CONF now selects the default + configuration. + - env variables can now be specified using AE_xyz instead of + PERL_ANYEVENT_xyz, subject to some rules. + - lots of new AnyEvent::Debug functionality. + - AnyEvent::Strict now checks for modifications $_ by the callback + (by setting it to readonly while executing the callback, if possible). + - IO::Async sometimes cancels the wrong timer when you call cancel_timer. + Invest extra overhead to work around this peculiar behaviour. + - split the pure perl backend into a loop module and an impl + module (AnyEvent::Loop and AnyEvent::Impl::Perl). + - some read types (regex, netstring, json, storable) could + errornously keep an AE::Handle object alive on their own + (reported by Mohammad Toossi). + - AnyEvent::Socket::resolve_sockaddr and all functions using it now + supports /etc/hosts overrides. + - add more workarounds around child watcher bugs in IO::Async + and (newly introduced) in POE. + - use glib child watchers and try to work around its limitations, + if possible (based on a patch by Kevin Ryde). + - add support for FLTK (fltk2), via AnyEvent::Impl::FLTK2. + - many read types in AnyEvent::Handle would malfunction during + transitions to TLS because of a "delete $self->{rbuf}". + (reported by Gerald Galster). + - improve condvar blocking wait performance (probably only noticable + with faster backends), also make it easier for event loops that + do not support blocking waits. + - PERL_ANYEVENT_MODEL now also allows full module names, although + the usefulness of this feature is not yet clear. + - add tests for all supported event loops, conditional on PERL_ANYEVENT_LOOP_TESTS. + - add t/80_ssltext.t. + - no longer use AUTOLOAD for the initial loading (for no very good reason). + - tcp_server now tries to unlink unix domain sockets when it gets destroyed. + - do not run event loop detection multiple times when programs call their cached + copies of AnyEvent::detect. + - parse_hostport now accepts absolute paths als unix domain sockets. + - add Task::Weaken as dependency (as recommends only at this time). + +6.0 (not officially released, but was on CPAN for about 15 minutes :/) + +5.34 Thu May 12 09:59:41 CEST 2011 + - AE::TLS didn't support both cert_file and key at the same time, + due to some copy&paste bug (reported and analyzed by vti). + - improve AE::Handle timeout documentation slightly. + +5.33 Mon Feb 7 21:51:41 CET 2011 + - never appeared on CPAN, for unknown reasons. + - AnyEvent::Handle on_connect_error - do not try to destroy a handle + object when it's already gone (analyzed by Ryan Bullock). + - update idna algorithm(s) to UTS#46 version 6.0.0. + - preserve trailing dot in idn_to_ascii - testsuite says to preserve, + uts46 says it's an error, and testsuite makes more sense. + - remove leading dots in idn_to_ascii - testsuite says to remove, + uts46 says it's an error, and testsuite makes more sense. + - fixed a bug in idn ignored character processing. + - passes the uts46 6.0.0 testsuite except for three cases which + apparently are bugs in the testsuite itself. + - passes the uts46 6.0.1 testsuite except for eleven cases which + apparently are bugs in the testsuite itself. + +5.31 Sun Jan 23 11:49:19 CET 2011 + - work around a POE bug where POE would first poll for new events and + invoke handlers BEFORE handling the message queue. + - fix parsing of "domain" statement in resolv.conf (Johannes Plunien). + - stop_read now does just that in TLS mode. see its + documentation for caveats. + - update to common::sense 3.4 warning set (some warnings in perl impose + an arbitrary 32kb limit on regex matches, which affects + AnyEvent::Handle). + - AE::Handle had a broken rbuf_max method and missing wbuf_max method. + - new experimental AE::Handle::resettls method. + +5.3 Fri Dec 31 05:48:13 CET 2010 + - major IOAsync patch by Paul Evans - 0.33 is required, as the major + issues with IO::Async have been solved in that version, including + the availabilty of a default loop! + - implement new wbuf_max parameter for AnyEvent::Handle. + - added Cocoa::EventLoop backend by Daisuke Murase. + - the default testsuite now honors PERL_ANYEVENT_MODEL (Paul Evans). + - clarify handle on_prepare documentation. + - set CLOEXEC flag on parent-side fd's in AnyEvent::Util::run_cmd, + to avoid leaking them to any child processes. + - try to force files into the arch-dependend lib directory, for the + half-"turly obsessive compulsive person"(s) that depend on it. + +5.29 Sun Dec 5 10:49:21 CET 2010 + - convert EV backend to EV 4.00 API (so better upgrade EV too). + - AE::Handle: implement dynamic read_size adjustment, add + max_read_size parameter, reduce default read_size to 2048. + - add some FAQ entries for servers and/or on_eof vs. on_error. + - work around OS bugs (cygwin again) when lingering in AE::Handle. + - reduce memory usage slightly when connect was used in AE::Handle. + - wrok around more segfaults in Tk. + - document tls_ctx => undef as valid. + - detect WNOHANG value at compiletime. + - include some probably linux-only support for building AnyEvent + as part of the perl core. + - improve compatibility of t/08_idna.t to perl 5.8. + - make AnyEvent::Strict truly optional (in case somebody builds a + minimal perl...). + +5.28 Wed Oct 13 04:14:23 CEST 2010 + - due to a glitch, AnyEvent's internal getprotobyname wasn't + actually used in tcp_server. + - implement AnyEvent::CondVar->new method, which was documented but + missing. + - support autoloading of read types in unshift_read. + - AnyEvent::Strict: do the test for invalid fh arguments differently, + resulting in more informative error messages. + - new AnyEvent::FAQ manpage. + - clarify that you can actually call push_read etc. in on_read. + - put keys and certs in /tmp, not into the current directory, + and document this in the SECURITY CONSIDERATIONS sections + of AnyEvent::TLS. + - support ";" as resolv.conf comment character in AnyEvent::DNS, as + requested by Ron Isaacson. + - document $AnyEvent::DNS::RESOLVER variable. + - incorporated major typo patches by Abhijit Menon-Sen. + - AnyEvent::Handle now croaks when negative timeouts are passed. + - add a shitload of TCP_xxx sockopt name constants to AnyEvent::Util, + undocumented, but who knows when they might come in handy. + +5.271 Tue Jun 8 12:05:46 CEST 2010 + - backport to perl 5.8.x. + +5.27 Sun Jun 6 12:12:05 CEST 2010 + - postpone differently in AnyEvent::Socket now, as + when not, canceling the connection attempt might fail + (found by Felix Antonius Wilhelm Ostmann). + - explicitly check for non-stream sockets in AE::Handle, too many + clueless people fell into the trap of this somehow working. + - simplified and reworked the "OTHER MODULES" section. + - better/more condvar examples. + +5.261 Wed Apr 28 16:13:36 CEST 2010 + - AF_INET6 was not properly used from Socket6 during configuration + time (found by Andy Grundman). + +5.26 Mon Apr 12 04:49:35 CEST 2010 + - don't generate spurious readyness notifications when select + returns EINTR in the pure perl backend (analysed and testcase + by Bas Denissen). + - give same examples in SYNOPSIS sections of AnyEvent and AE. + - provider faster implementations for AE::time/now/now_update for + EV and Perl backends. + - provide faster AE::cv and AE::time implementations for all + backends. + - no longer support lower/mixed-case signal names (this was + never documented nor universally supported). + - some more memory ยต-optimisations, and somewhat less messy + code to cope with both AnyEvent and AE APIs. + +5.251 Sat Mar 13 00:58:21 CET 2010 + - make test failed if it was run before make install on perl <= + 5.8.8, and older versions of perl make our live very difficult, + so write constants.pl during Makefile.PL time. + +5.25 Sat Mar 13 00:23:14 CET 2010 + - fix a race condition in AnyEvent::Handle that would cause + a "bio_read: unsupported method" error (in _another_ + ssl connection) after user code threw an exception. + - added AnyEvent::Handle->destroyed method. + - speed up AnyEvent::Socket::format_address and ::format_ipv6. + - the AnyEvent::Util::fh_nonblocking function worked only + by lucky accident on win32. + - smaller and faster AnyEvent::Util::fh_nonblocking. + - when the (required!) Time::HiRes module is missing, AnyEvent + did not fall back to built-in time properly. + - do not load Fcntl at runtime, saving memory and loading time. + - precompile a number of constants and use them instead of runtime + detection and eval. + - free detection code after detection and similar memory optimisations. + - Perl backend timer interval best effort drift has been improved + (same algorithm as EV). + - update unicode idna mapping table. + +5.24 Tue Jan 5 11:39:43 CET 2010 + - cygwin never reports errors from failed connects. 1.5 just gives + you continous readyness and EAGAIN, 1.7 is even more broken and + just hangs. work around both issues in a cygwin-specific hack. + - improve idle watcher documentation slightly. + +5.23 Sun Dec 20 23:48:00 CET 2009 + - support IDNs in resolve_sockaddr, and therefore in tcp_connect. + - implement punycode_encode/decode, idn_nameprep, + idn_to_ascii and idn_to_unicode operations in AnyEvent::Util. + - provide $AE::VERSION. + - removed traces of "no strict 'refs'". + +5.22 Sat Dec 5 03:51:13 CET 2009 + - downgrade-or-fail in AnyEvent::Handle::push_write, to + diagnose encoding failures earlier and more succinctly. + (this works around bugs in perl, throwing away encoding info + when passing scalar data to extensions). + - add more examples to AnyEvent::Socket manpage. + - upgrade internal warning set to the same as common::sense 2.03. + - use pack "n/a*" for pre-5.8.9 perl compatibility in AnyEvent::DNS + (John Beppu). + - AnyEvent::Socket::inet_aton now properly supports ipv6, as documented. + - add google public dns servers to fallback server set and make sure + we load-balance properly between the three sets. also add all + fallback dns servers, not just a random one, to each dns config. + +5.21 Thu Nov 19 02:48:47 CET 2009 + - fix a problem where socket constants were called with parameters + (spotted by David Friedland). + - fork_call never use'd POSIX (reported by Daisuke Maki). + - improve perl 5.6 compatibility further (but it still won't work + unless you rip out everything but the core). + - prefer Net::DNS::Resolver over ipconfig, if installed, on win32. + uses 10MB of RAM, but doesn't open a console window. *sigh*. + +5.202 Wed Oct 14 22:35:44 CEST 2009 + - AnyEvent::DNS would unexpectedly clobber $_ under windows + (analysed by Matthias Waldorf). + - AnyEvent::Handle::run_cmd can now pass the PID of the + newly-created process, which is much less useful than it might + sound (based on patch by Yann Kerherve). + +5.201 Tue Sep 29 12:09:25 CEST 2009 + - AnyEvent:Handle::on_starttls/on_stoptls methods were broken + (reported by Torsten Foertsch). + - common::sense 2.0 could cause tcp_server to throw an exception + (analysed by elmex). + +5.2 Mon Sep 14 07:04:49 CEST 2009 + - INCOMPATIBLE CHANGE: do no longer support register_read_type + and register_write_type in AnyEvent::Handle, instead support + package names (the facility was mostly abused). + - implement "packagename-as-read/write type" support in + AnyEvent::Handle. + - AnyEvent::Handle: new options "keepalive" and "oobinline". + - oobinline set by default to avoid security issues. + - the pure-perl event loop backend wrongly detected times() fallback + support (spotted by Pavel Boldin). + +5.12 Tue Sep 1 20:26:50 CEST 2009 + - be more lenient when parsing resolv.conf files, as some people + use hashmarks as comment indicator inside directives (reported + by Michael S. Fischer). + - use same set of warnings as common::sense 2.0. + - fix a potential 32 bit overflow issue due to perl having problems + with large hex constants in the Perl backend. + - do not use the slower 5.6 version fo the enc_name code in AnyEvent::DNS + by default. + - fix some prototypes. + - (optionally) require Async::Interrupt 1.02. + - replace opendns fallbacks by verizon/level3 public dns servers. + +5.112 Fri Aug 21 13:59:04 CEST 2009 + - AnyEvent::Handle could cause hard crashes in Net::SSLeay when + using starttls with an illegal/uncreatable tls context. + - port to broken win32 perls. + +5.111 Sun Aug 16 18:44:36 CEST 2009 + - perl errornously requires sockaddr_un structures returned by the + kernel to have a specific length. work around this bug by padding + sockaddr_un structures (found to fail on OS X, as perl only uses + the correct code for GNU/Linux, but likely to fail on other + OSes as well). + +5.11 Wed Aug 12 17:49:37 CEST 2009 + - fixed a bug in run_cmd with input from filename. + - create a json coder object when none is given in write direction + to reduce dependency on JSON. + +5.1 Tue Aug 11 03:17:32 CEST 2009 + - tcp_connect now reports the correct error in $!, not an unrelated + one (was broken since 4.91). + - AE::Handle did not properly clear rtimeout/wtimeout watchers + when retrying a tcp_connect. + - new functions: AnyEvent::Util::run_cmd and close_all_fds_except. + - fixed wrong documentation in AE::Socket. + +5.01 Mon Aug 10 03:16:32 CEST 2009 + - last release broke EV child watchers :/. + +5.0 Sun Aug 9 17:32:09 CEST 2009 + - officially introduce and document the AE API. + - lowering the timeout at runtime did not have immediate effect + in AnyEvent::Handle. + - AE::Handle now has separate and independent read and write timeout + settings. + - probe for Guard module when AnyEvent::Util is loaded, not at + runtime (Event doesn't like eval "use" from callbacks, and it avoids + exporting the probe function). + - Impl::IOAsync's io watchers did not use the filehandle emulation + code to work around it's watcher limits. + - work around IO::Async's problems with overloaded objects. + - try to disable wearnings inside IO::Async, it's just too buggy. + - do no longer use Event by default, only EV or Perl, Event is too buggy. + - hackishly provide fast AE:: interface when EV or Perl is the backend. + - inherit VERSION from AnyEvent::VERSION in most modules. + +4.91 Thu Aug 6 15:42:45 CEST 2009 + - AE::Handle::starttls could get out of sync when the read buffer + already contains some TLS handshake. + - AE::Handle did not properly free the TLS session, causing bigger + memory leaks in Net::SSLeay than expected (reported by toaster). + - AE::Socket::tcp_connect will now artificially delay invoking + the callback to avoid returning after invoking the callback. + - convert many internal watcher uses to AE API. + +4.9 Sat Aug 1 11:07:01 CEST 2009 + - Glib silently fails when registering a timeout with + a negative value, so avoid that. + - call condvar callback immediately when it is set + after the condition is already signalled. + - check rbuf_max condition only after trying to consume + data. + - normalise signal numbers to names when using the ae's + signal handling, but do not document this (yet). + - pure perl signal emulation did not properly set nonblocking + mode on the signal pipe on win32 (this is unlikely to have caused + any issues). + - new module: AnyEvent::Debug. + - AnyEvent::Strict now checks that a signal was specified + by name (not name or number). + - reduce memory footprint in typical cases by ~50kb by + only compiling signal code when necessary. + - add AnyEvent::Handle->rbuf_max. + - grab the AE namespace for future new API, implement stubs for + said future/alternative API. + - new function: AnyEvent::Socket::format_hostport. + +4.881 Tue Jul 28 12:51:53 CEST 2009 + - work around a bug in local in pre-5.10 perls, causing + AnyEvent::Handle to recurse when it should not + (analysed by elmex). + +4.88 Tue Jul 28 04:04:37 CEST 2009 + - re-bless the handle into a dummy package after calling + AnyEvent::Handle::destroy, so the user does not need to check + for errors after every push_write etc. + - do not attempt to run t/02_signals.t on obviously broken + platforms. + +4.87 Sun Jul 26 02:06:16 CEST 2009 + - do not attempt to linger when there is no longer a valid fh. + - enforce tls mode to be either accept or connect, do not simply + segfault in Net::SSLeay. + - AnyEvent::Handle can now call tcp_connect itself (new parameters + connect, on_prepare, on_connect and on_connect_error). Updated + tutorial accordingly. + - add AnyEvent::Impl::Irssi backend. + +4.86 Mon Jul 20 23:52:29 CEST 2009 + - since the verbose warning is not enough, explicitly document + that versions before 1.33 of Net::SSLeay are not secure. + - work around signal handling races in Event and (...) Event::Lib. + - try to align signal-race timer to full-second boundaries. + - work around Tk not liking negative timeouts. + - don't complain of different grades of environmental unfriendlyness + in IO::Async. + +4.85 Sat Jul 18 06:16:14 CEST 2009 + - nail the signal race problem in perl once and for all + (see $AnyEvent::MAX_SIGNAL_LATENCY). + - take advantage of Async::Interrupt if it is available. + - load Time::HiRes and Guard modules on demand only. + - add optional/recommended modules section to AnyEvent + documentation. + - reduce memory usage considerably (and reduce startup penalty) + by not using "strict", "warnings" and "overload" modules. + - work around buggy windows/openbsd perls and provide EBADMSG + and EPROTO ourselves when missing. + - improve perl 5.6 compatibility of the core event loop. + - made Net::SSLeay version 1.33 a soft requirement. + +4.83 Fri Jul 17 16:56:26 CEST 2009 + - implement AnyEvent::Socket::getprotobyname. + - AnyEvent::CondVar's will now detect recursive blocking + waits and will croak, as too many people fall into + this trap. + - AnyEvent::Handle will now call ->destroy on itself after + executing the on_error callback, instead of doing some + half-baked internal shutdown, for fatal errors. + - clarify on_eof behaviour w.r.t. the read queue and + on_read callbacks. + - ignore some possible spurious wake-ups in tcp_connect. + +4.82 Sat Jul 11 00:34:55 CEST 2009 + - POE and Event backends didn't accept some callable objects as + callbacks. + - use Config module instead of POSIX module to detect signal names + in AnyEvent::Strict and AnyEvent::Impl::EventLib, as the POSIX + module doesn't even have all POSIX signals :/. + - use more workarounds around the many refcnt/corruption bugs in + Event::Lib. + - work around a race condition in perl's select, causing t/03_child.t + to rarely fail. + +4.81 Thu Jul 9 10:30:30 CEST 2009 + - AnyEvent::Handle didn't properly diagnose write errors + (it expected -1 from syswrite, how lame... :). + - support file descriptors in addition to file handles + in AnyEvent->io. + - new env variables: PERL_ANYEVENT_RESOLV_CONF, + PERL_ANYEVENT_MAX_OUTSTANDING_DNS, PERL_ANYEVENT_CA_FILE + and PERL_ANYEVENT_CA_PATH. + - provide a sensible synopsis section for AnyEvent::TLS. + - add a "supported backends" section to the manpage. + - added simple io watcher test to testsuite, using a + portable_socketpair. + - tried to improve the stability of the Event::Lib backend, + YMMV. + +4.8 Mon Jul 6 23:45:16 CEST 2009 + - AnyEvent::DNS did not properly follow CNAME records with + uppercase targets. + - AnyEvent::DNS would errornously return AAAA records + with v4 mapped addresses (a faulty record) as ipv4 addresses, + causing AnyEvent::Socket to throw an exception. + - added new module AnyEvent::TLS for easier SSL/TLS context + creation, with many options including hostname verification, + secure default configuration, lots of documentation and, + predefined diffie-hellman keys for perfect forward security + and much more. get it while it's still fresh! + - use AnyEvent::TLS in AnyEvent::Handle for context management. + - load AnyEvent::Handle only on demand in AnyEvent::DNS, + so AnyEvent::Socket users have smaller memory footprint + in the common case. + - add AnyEvent::Handle->push_shutdown method. + - add an additional error message parameter to AnyEvent::Handle's + on_error callback (for TLS, $! is still available). + - add AnyEvent::Handle on_starttls/on_stoptls callbacks. + - make AnyEvent::Handle more robust against early conenction + failures (during new), and return C in that case + from the constructor. + - AnyEvent::Handle will now try to load only JSON::XS first, + then fall back to JSON. + - format_ipv4/format_ipv6 are now exported by default, for symmetry, + and because it was documented that way. + +4.451 Fri Jul 3 00:28:58 CEST 2009 + - do not clear rbuf when shutting down an AnyEvent::Handle + object - doing so breaks AnyEvent::HTTP. + +4.45 Mon Jun 29 22:59:26 CEST 2009 + - a write error could cause AnyEvent::Handle to create + an I/O watcher with an undefined $fh. + - special-case mapped ipv4 addresses in both + AnyEvent::Socket::format_address and parse_address, + to treat them just like ipv4 addresses. + - updated and overhauled the AnyEvent::Intro doc. + - implement AnyEvent::Socket::format_ipv4/ipv6. + - slightly speed up portable_pipe/socketpair. + - expand condvar begin/end documentation. + +4.42 Fri Jun 26 08:32:18 CEST 2009 + - preliminary and neccesarily incomplete support for IO::Async. + - reset SIGCHLD to DEFAULT when AnyEvent is loaded, in + case it was set to IGNORE, to ensure we can catch child statuses + even when the calling env acts stupidly. + - updated benchmarks with IO::Async, which performs very well. + +4.412 Wed Jun 24 01:35:57 CEST 2009 - support an "untaint" attribute for AnyEvent::DNS and set it on the default resolver. - implement and document AnyEvent::Impl::Perl::loop. - remove all anyevent-env variables from %ENV when running in tainted mode. + - mention and extend the IO::Lambda benchmark. 4.411 Sun Jun 7 18:48:02 CEST 2009 - do not try to use F_SETFD on windows. @@ -104,14 +597,14 @@ unless one has been installed already. - warn about not loaidng AnyEvent::Impl::POE early enough (patch by Adam Rosenstein). - - fixed a great number of bugs and corner cases in AnyEvent::Handle: + - fixed a great number of bugs and corner cases in AnyEvent::Handle. - fix a bug in where in SSL connect mode, the client would first wait for some data by the server and - otherwise hang. (reported and analyzed in an absolutely + otherwise hang. (reported and analysed in an absolutely exemplary manner by Adam Rosenstein). - fix a bug in where SSL EOF would not be treated as stream EOF, putting the connection into a hung state. - (reported and analyzed in an absolutely exemplary manner by Adam + (reported and analysed in an absolutely exemplary manner by Adam Rosenstein). - fix a potential segfault when the TLS context would go missing in a read callback (e.g. due to stoptls) -