--- AnyEvent/Changes 2009/08/16 16:54:51 1.337 +++ AnyEvent/Changes 2011/11/16 20:04:05 1.519 @@ -1,5 +1,341 @@ Revision history for Perl extension AnyEvent. +TODO: document TCP_*** constants +TODO: add debug/trace logging to some modules + + - Tk cannot create windows when tainted unless you set a title, so + set a dummy title for AnyEvent's dummy mainwindow. How dummy. + - escape any nonprintable/nonascii characters when stringifying + backtraces. + - log the reason loading an interface module fails to load at level debug. + +6.1 Tue Oct 4 19:44:30 CEST 2011 + - INCOMPATIBLE CHANGE: the default log level is now "4" (error + and above), and some messages inside AnyEvent have been elevated + to higher log levels to print by default. + - AnyEvent::log, unlike AnyEvent::Log::log, did not always exit on fatal. + - work around yet another signal race bug, newly introduced by POE. My + how that module sucks. + - add google public ipv6 dns as fallback servers, so AE::DNS can finally + support ipv6-only operation even with defaults (also use ::1 instead + of 127.0.0.1). + - give better guidelines on how to chose a logging level. + - AnyEvent::Log can now cap (limit) log message priority by context. + - AE::log will now save and restore $! and $@, so callers don't have to. + - AE::Strict now checks that registered fds are still valid at regular + intervals. + - skip frequently called 'require' calls if the module appears loaded. + - increase signal latency test timer considerably for poor little osx, + which can't be bothered with basic posix functionality such as signal + delivery. + - mention some debugging aids in the tutorial. + - new env variable PERL_ANYEVENT_MAX_SIGNAL_LATENCY. + - private (%namespace) log contexts in PERL_ANYEVENT_LOG now have the name + of the context as title. + - AnyEvent::Strict would not restore read-write access to $_ when a callback + died - this is a user bug, but since AE::Strict exists to help dbeugging... + - detect the extremely evil IO::Async::Loop::AnyEvent module and refuse + to work with it - the author is well aware of the issues but refuses + to fix them. This extreme step has been taken because the module actively + attacks the goals of AnyEvent and makes it harder for module authors to use + AnyEvent. + +6.02 Fri Aug 26 20:08:31 CEST 2011 + - log_to_syslog now accepts facility strings. + - log_to_syslog would not allow facilities - "$facility|$level" + *literally* means that string. sheesh. + - the CPAN parser got confused and thought we provide Sys::Syslog, try + to work around. + - renamed AnyEvent::Impl::FLTK2 to FLTK. + +6.01 Fri Aug 26 07:04:11 CEST 2011 + - 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 + /etc/hosts 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. + - suppress the idiotic warning inside POE by patching the POE::Kernel + run flags instead of asking the user to jump through contortions. + - add Task::Weaken as dependency (as recommends only at this time). + - replace PF_UNSPEC by 0, for good old minix. + +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 @@ -74,7 +410,7 @@ 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 - (analyzed by elmex). + (analysed by elmex). 4.88 Tue Jul 28 04:04:37 CEST 2009 - re-bless the handle into a dummy package after calling @@ -306,14 +642,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) -