RubyGems - kgio - Versions diffs - 2.1.1 → 2.2.0 - Mend

kgio 2.1.1 → 2.2.0

Files changed (29) hide show

data/.gitignore +1 -0
data/.manifest +11 -2
data/.wrongdoc.yml +4 -0
data/ChangeLog +810 -531
data/GIT-VERSION-FILE +1 -1
data/GIT-VERSION-GEN +1 -1
data/GNUmakefile +4 -147
data/LATEST +25 -0
data/NEWS +49 -9
data/README +2 -2
data/Rakefile +2 -2
data/ext/kgio/accept.c +64 -20
data/ext/kgio/{missing/ancient_ruby.h → ancient_ruby.h} +0 -0
data/ext/kgio/autopush.c +203 -0
data/ext/kgio/connect.c +29 -14
data/ext/kgio/extconf.rb +13 -2
data/ext/kgio/kgio.h +7 -1
data/ext/kgio/kgio_ext.c +1 -0
data/ext/kgio/{missing/accept4.h → missing_accept4.h} +0 -0
data/ext/kgio/read_write.c +58 -3
data/kgio.gemspec +2 -1
data/pkg.mk +168 -0
data/test/lib_read_write.rb +10 -2
data/test/test_autopush.rb +165 -0
data/test/test_kgio_addr.rb +19 -0
data/test/test_no_dns_on_tcp_connect.rb +13 -0
data/test/test_singleton_read_write.rb +21 -0
data/test/test_tcp6_client_read_server_write.rb +23 -0
metadata +41 -12

data/ChangeLog CHANGED Viewed

@@ -1,532 +1,811 @@
-ChangeLog from git://git.bogomips.org/kgio.git ()
+ChangeLog from http://bogomips.org/kgio.git
-    commit f093312ad1ed336363f352991b6b99d96f7aed1d
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Thu Nov 18 17:16:53 2010 -0800
-        kgio 2.0.0 - major internal API changes
-        (no code changes from 2.0.0pre1)
-        This release should make Kgio easier and more consistent
-        to use across a variety of libraries/applications.
-        The global Kgio.wait_*able(=) accessor methods are gone in favor
-        of having default kgio_wait_readable and kgio_wait_writable
-        methods added to all Kgio-using classes.  Sub-classes may (and
-        are encouraged to) redefine these if needed.
-        Eric Wong (7):
-            expand Kgio::*#kgio_read! documentation
-            prefer symbolic names for waiting read/writability
-            EOFError message matches Ruby's
-            README: Gemcutter => RubyGems.org
-            update documentation with mailing list info
-            add default kgio_wait_*able methods
-            switch entirely to kgio_wait_*able methods
-    commit edfa7e60de5556b6abc9febe6a21e12dadbafd0b
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Thu Nov 18 15:42:27 2010 -0800
-        Rakefile: list prerelease tags as well
-        Since we do prerelease nowadays before real ones.
-    commit d78a2075bdb0a30bf0064d2857011c330cc0d09e
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Thu Nov 18 15:38:12 2010 -0800
-        move website to bogomips.org
-        This project is useful enough for others and to stand alone
-        without needing to be associated with Unicorn.
-    commit 28070c522aff233eadb7e167f8d4e8122cd0bb47
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Thu Nov 18 15:15:40 2010 -0800
-        kgio 2.0.0pre1 - major internal API changes
-        This release should make Kgio easier and more consistent
-        to use across a variety of libraries/applications.
-        The global Kgio.wait_*able(=) accessor methods are gone in favor
-        of having default kgio_wait_readable and kgio_wait_writable
-        methods added to all Kgio-using classes.  Sub-classes may (and
-        are encouraged to) redefine these if needed.
-        Eric Wong (7):
-              expand Kgio::*#kgio_read! documentation
-              prefer symbolic names for waiting read/writability
-              EOFError message matches Ruby's
-              README: Gemcutter => RubyGems.org
-              update documentation with mailing list info
-              add default kgio_wait_*able methods
-              switch entirely to kgio_wait_*able methods
-    commit c69955e64648ab6a3471a54f7885a320428682f9
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Thu Nov 18 14:37:05 2010 -0800
-        switch entirely to kgio_wait_*able methods
-        This removes the global Kgio.wait_*able accesors and requires
-        each class to define (or fall back to) the Kgio::DefaultWaiters
-        methods.
-    commit f1b497e601ed2acb54f75dc989d0a5ec7afebca0
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Thu Nov 18 13:38:32 2010 -0800
-        add default kgio_wait_*able methods
-        It makes it easier for people to use certain overrides without
-        killing other methods.  This is the first step in fixing
-        problems people were having with dalli 0.11.1+ while running
-        Unicorn.
-    commit 827ad6b4fba768a5cac8fb4e83fbbf61cf7a3194
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Mon Nov 15 10:33:55 2010 -0800
-        update documentation with mailing list info
-        We're a real project, apparently, so it can have its
-        own mailing list.
-    commit fd88eae588c1e715dcaf3a1a000391cc13481e02
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Mon Nov 15 10:22:49 2010 -0800
-        README: Gemcutter => RubyGems.org
-        That's the new name for it and it's official
-    commit 8615a3f9554df0fd7f7f088cd49cf1e3be49de9f
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Fri Nov 12 20:25:50 2010 -0800
-        EOFError message matches Ruby's
-        This makes messages appear less different than Ruby
-        when using kgio_read!
-        Requested-by: Mike Perham
-    commit 2772ed8bfe108b66b7493bc5cb0c40ddeb1ca57d
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Fri Nov 5 09:01:08 2010 +0800
-        prefer symbolic names for waiting read/writability
-        There's no point in using constants that point to symbols
-        instead of just the symbols themselves.
-    commit bf3b507791403811bece9dff915ca10757bca519
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Thu Oct 28 21:02:31 2010 +0000
-        expand Kgio::*#kgio_read! documentation
-        If the author can forget why it was written, so can
-        the rest of the world.
-    commit f4d08a07a02393cca5ddd1277acc4f95c83307ff
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Fri Oct 8 14:55:16 2010 -0700
-        kgio 1.3.1 - fix zero-length reads
-        kgio_read and kgio_tryread will now return an empty string when
-        a length of zero is specified instead of nil (which would signal
-        an EOF).  This emulates the behavior of IO#read, IO#readpartial,
-        IO#sysread, IO#read_nonblock in core Ruby for consistency.
-    commit d225ede82d820d045bd7cfb826f444cf6601577c
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Fri Oct 8 02:53:38 2010 -0700
-        return empty string on length=0
-        This matches behavior of all the core Ruby methods.
-    commit e4599227f0da0f652cbcb52838e631d7384dcd0d
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Thu Oct 7 20:02:40 2010 -0700
-        kgio 1.3.0 - bug and usability fixes
-        * make Kgio::WaitWritable and Kgio::WaitReadable symbols
-        * trywrite: fix stupid off-by-one error causing corrupt writes
-          on retries
-    commit f5fc35221d37141b0f72278c7b969211410e94c0
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Thu Oct 7 20:00:09 2010 -0700
-        tests: don't trust what I think I know about Ruby
-        case/when and === didn't actually work as I expected
-        them to.
-    commit 2152188f41bf2a5067e84a4404b48b2282a9dd55
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Thu Oct 7 19:56:57 2010 -0700
-        trywrite: fix stupid off-by-one error causing corrupt writes
-        Oops!
-    commit c448ad898ecb7f354a32a320294da4727fc9af52
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Thu Oct 7 19:55:49 2010 -0700
-        make WaitWritable and WaitReadable symbols
-        This makes them easier to compare with === when used
-        in case/when statements in Ruby
-    commit 49f0b98c69f1f0bf637953d0bfc96b764f00ab9b
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Thu Oct 7 07:15:49 2010 +0000
-        kgio 1.2.1 - doc and *BSD workarounds
-        This fixes our accept4() wrapper which did not work as expected
-        on some *BSD-based systems due to fcntl(fd, F_GETFL) returning
-        false information.  Linux 2.6+ users are unnaffected, including
-        those without accept4().
-        Also some RDoc fixes.
-    commit 03344bb763f5269afe7fafd56a47270719c7ef9e
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Thu Oct 7 07:14:07 2010 +0000
-        doc: fix RDoc generation
-        Oops, completely broken by the splitting of the code.
-    commit 637317eb479525dca543eda7a8977410bc43b832
-    Author: Eric Wong <e+07380@yhbt.net>
-    Date:   Wed Oct 6 14:08:35 2010 -0700
-        accept4: workaround (P)OS X bug w/O_NONBLOCK
-        Apparently fcntl(fd, F_GETFL) can return falsely return the
-        O_NONBLOCK flag without actually having it set in the kernel.
-        This is totally broken on the part of the OS.
-    commit ca76c75f8a24d0cd6828fe16ca3790a277b35f8d
-    Author: Eric Wong <e+07380@yhbt.net>
-    Date:   Wed Oct 6 14:06:27 2010 -0700
-        build: pick on on modified extension files
-        We build more than one file nowadays.
-    commit 65f96b7750616bc210397c16eea40961e578a788
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Wed Oct 6 11:51:04 2010 -0700
-        doc: fix typo in Kgio.accept_cloexec= doc
-        oops...
-    commit 414dd17f1009c571e2d7657721271756e3d4dd8e
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Tue Oct 5 16:09:40 2010 -0700
-        kgio 1.2.0 - cleanups and minor improvements
-        The C extension is now split into several files for
-        ease-of-maintenance.
-        Slightly more common, client-triggerable exceptions (EOFError,
-        Errno::EPIPE, Errno::ECONNRESET) are now less expensive as they
-        are generated without backtraces.
-    commit e085bb9600b190692beb5efc85656ebf127ae08c
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Tue Oct 5 15:45:16 2010 -0700
-        generate empty backtraces for EPIPE and ECONNRESET
-        Malicious clients may disconnect during big writes to cause
-        EPIPE and ECONNRESET exceptions.  Generating backtraces can be
-        expensive with Ruby, so mitigate the DoS vector by lowering the
-        cost of generating an exception.
-    commit b168cc894037620cab82fa82f3ab37a3aab81570
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Tue Oct 5 15:26:57 2010 -0700
-        add kgio_read! methods which may raise EOFError
-        Except EOFError is gently raised to not include a huge
-        backtrace.  Large backtraces can be a performance problem on
-        busy servers that malicious clients may exploit to deny service.
-    commit 870ada92db7071c7982913e508ac35b97d6e8761
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Tue Oct 5 11:45:02 2010 -0700
-        GNUmakefile: use portable tar invocation
-        We've been spoiled by GNU tar.
-    commit 2a6115a89d5c95428bd6c3e0bc10e5a3a4c3c3be
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Wed Sep 29 18:25:58 2010 -0700
-        refactor and split into separate files
-        Making the code easier to read and navigate.  This also
-        frees us from having to use the stupid A4_ prefix for
-        accept4(2) flags since it conflicts with the socket(2)
-        ones.
-    commit 8fe89997453d6c530c3f5e08bc9c1da40a621248
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Wed Sep 29 17:13:21 2010 -0700
-        Make kgio_trywrite more aggressive with retrying
-        Partial writes can be retried until completely denied with
-        EAGAIN.  Often times, it is beneficial to retry immediately
-        after a partial write because the kernel may allocate more
-        buffers or the reader can drain the buffers.
-        This helps the caller avoid crossing the Ruby <-> C boundary
-        more than necessary.
-    commit 39c851e595970a2349a8a39878afd94a3324e102
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Tue Sep 28 18:16:53 2010 -0700
-        kgio 1.1.0 - flexible accept methods
-        * an alternate class now be returned by accept/tryaccept
-          by setting "Kgio.accept_class ="
-    commit 911f6ab306aff1e24c9c570eeae33923fa1b99d9
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Tue Sep 28 18:04:51 2010 -0700
-        alternate classes may be returned by accept/tryaccept
-        These can be useful for avoiding wrapper objects and
-        also allows users to more easily try different things
-        without stepping on others' toe^H^H^Hclasses.
-    commit 526b4bd48a20a34ef5959fdc4aa580d5f9199652
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Mon Sep 27 19:59:34 2010 -0700
-        kgio 1.0.1 - compatibility fixes
-        * add compatibility for ancient Rubies (1.8.6)
-        * linux: fix accept4() support for newer Linux
-    commit 20cbc0355104470fb433dd13e87a5d5c7e888ab1
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Tue Sep 28 02:56:41 2010 +0000
-        linux: fix accept4() support for newer Linux
-        Oops :x  Tested on Debian sid.
-    commit 24f1d168eb0937f0586c45b266bcd208431f0107
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Mon Sep 27 18:06:34 2010 -0700
-        add compatibility for ancient Rubies
-        This is tested on Ruby 1.8.6-p114, but may work
-        for 1.8.5, too.  Ugh, people ought to upgrade.
-    commit e4d204c86e9420023ba3e4d8dbeb6b3fea8d6cf7
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Tue Sep 28 00:27:44 2010 +0000
-        kgio 1.0.0 - initial release
-        Documentation and release infrastructure updates
-        and such...
-    commit 8984b9556a3493570fbb4f747fce712d58f2cdd8
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Tue Sep 28 00:07:43 2010 +0000
-        doc: TODO update
-    commit 2c64a1fc07d3b9a80d112e3b0e2baa7ec29c2f47
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Tue Sep 28 00:03:39 2010 +0000
-        read/write: account for buffer changes during wait
-        It's possible for applications to modify the buffer during
-        reads and writes, so make a best effort to account for those.
-    commit f2ea9918655e8ee0576bee2950d16485031fc361
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Mon Sep 27 23:59:59 2010 +0000
-        tests: fix broken monster trywrite test
-        Oops, use random data so it's easier to detect this.
-    commit 7abc0eb3dd804c2e65660b7dd9c828df0e03b80a
-    Author: Eric Wong <e+absinthe@yhbt.net>
-    Date:   Mon Sep 27 15:09:44 2010 -0700
-        test_tcp*read_write: use blocking kgio_accept in setup
-        Some OSes (FreeBSD 7.0) do not seem to setup
-         connections as quickly.
-    commit 95d2eae6a4da34c504427af6ae0ab4c8c70c0ce5
-    Author: Eric Wong <e+absinthe@yhbt.net>
-    Date:   Mon Sep 27 15:09:43 2010 -0700
-        set blocking flag before blocking IO#read
-        Some older Rubies may not behave correctly otherwise
-    commit 0806cac89f9d0e169b6c1e4da68c1ad66daa23ae
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Mon Sep 27 23:16:53 2010 +0000
-        tess: ensure buffer is cleared on failures
-        No need to leak data.
-    commit 50b86bf23063f3e6c3777b39c9464f73ccfd6ef5
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Mon Sep 27 22:55:52 2010 +0000
-        more documentation
-        Somebody's gotta do it...
-    commit 5123d66fe0b2dad67539a20fe5b91f5b9afd814a
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Mon Sep 27 16:56:13 2010 +0000
-        avoid initiating syscalls before rb_io_wait_*
-        Some Ruby implementations (Rubinius) may call lseek
-        and clobber the intended errno when looking up the
-        open file, causing rb_io_wait_* functions to fail.
-    commit 6c818b0b6f76ef733679bcea1024142b4ef3ce00
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Mon Sep 27 01:13:30 2010 +0000
-        add kgio_tryaccept, kgio_accept _really_ blocks
-        We'll stick with the "try" prefix if we're going to be
-        non-blocking.  kgio_accept will favor a blocking accept() call
-        where it's possible to release the GVL, allowing it to avoid
-        thundering herd problems.  Otherwise it'll use thread-safe
-        blocking under Ruby 1.8.
-    commit f81cb3c05a0eb46ec61ceb295b51ead16e6a0da4
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Mon Sep 27 00:57:14 2010 +0000
-        use SOCK_NONBLOCK for socket(2) if possible
-        This saves us a relatively expensive fcntl() system call.
-    commit 87cf3ce6185b9138032a5af53cecae98f8c93564
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Mon Sep 27 00:24:50 2010 +0000
-        connect: no do not leak descriptors on failure
-        We cannot raise exceptions and expect GC to clean up
-        after us until we've created an actual IO object.
-    commit 6fbde1518578dd1b828efcecaf2caf893bddc110
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Mon Sep 27 00:11:43 2010 +0000
-        "start" singleton methods for non-blocking connect
-        These initiate (but do not wait for) non-blocking connects.
-    commit fdfecc6d815bab8dfc1d8ad6758a66d44ab51e31
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Sun Sep 26 07:51:12 2010 +0000
-        introduce kgio_try* methods
-        Avoid altering behavior based on globals that
-        Kgio.wait_{read,writ}able stored in, since that's too confusing.
-        The non-try variants are closer to the normal IO read/write
-        methods, except they can be more easily plugged into alternate
-        reactors and event frameworks.
-    commit d8ee79e1e5c6e6908009213324db25cf41c583ce
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Sat Sep 25 17:55:07 2010 +0000
-        kgio_read returns nil on EOF
-        Just like IO#read
-    commit af03e4471de3d3b91eec16e26e93a84d4a717116
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Sat Sep 25 17:47:13 2010 +0000
-        split out reusable bits into separate headers
-        No point in cluttering up the meat of our code.
-    commit db53263856d864ba6273e6cac73011f699509d71
-    Author: Eric Wong <e+absinthe@yhbt.net>
-    Date:   Sat Sep 25 01:36:13 2010 -0700
-        only use MSG_DONTWAIT under Linux
-        MSG_DONTWAIT is less consistently implemented/supported on other
-        platforms on stream sockets, so fallback to fcntl() + read()/write()
-        for stream sockets.  This also fixes our previously broken support
-        of non-MSG_DONTWAIT systems.
-    commit a82dc40c2a509c4ab692da34b572693f243fbfae
-    Author: Eric Wong <e+absinthe@yhbt.net>
-    Date:   Sat Sep 25 01:36:12 2010 -0700
-        write/send may fail with ECONNRESET
-        Tested on FreeBSD 7.0
-    commit 0c60192621303f5e4ebd46d43a058de48126bc8a
-    Author: Eric Wong <e+absinthe@yhbt.net>
-    Date:   Sat Sep 25 01:36:11 2010 -0700
-        fix missing netinet/in.h include
-        This is needed for FreeBSD 7.0, at least.
-    commit 0beb82437f4ab0b8422e225080b234361092315e
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Sat Sep 25 08:15:13 2010 +0000
-        beef up the test suite
-        We need to test server <-> client interaction
-        more thoroughly since some systems don't implement
-        everything right.
-    commit 460e6b025896dee64b39d194d4c1a536129654de
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Thu Sep 23 22:56:44 2010 +0000
-        initial commit + release
-        everything shou^Wmight be working...
+   commit 75a7da2bd757617995f5492df1205e4a3459618b
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Feb 3 18:46:21 2011 -0800
+       kgio 2.2.0 - kinder, gentler I/O for the Internets
+       * sockets accept()ed by a TCP_NOPUSH/TCP_CORK listener
+         automatically flush on kgio_*read calls if there is pending
+         data.  "Kgio.autopush = false" disables this globally,
+         and Kgio::Socket also get "kgio_autopush=" to enable/disable
+         on a per-object individual basis.
+       * ECONNRESET exceptions get empty backtraces for kgio_*read.
+         There's nothing a programmer can do about these, so there's
+         no point in going through the expensive backtrace generation
+         process.
+       * Kgio.try* singleton methods added for working with non-Kgio
+         enhanced objects.  No more needing to use Object#extend
+         and blowing away your method cache to make existing I/O
+         objects kinder and gentler.
+       * IPv6 support should be complete, systems without a native
+         getaddrinfo(3) are now unsupported (and will remain so
+         unless somebody complains).
+       There should be no other backwards-incompatible changes other
+       than requiring getaddrinfo(3) and friends for IPv6 support.
+   commit c8fb5aa33262a455997ff6a57659a8d125f36d66
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Feb 3 14:28:11 2011 -0800
+       add SocketMethods#kgio_addr!
+       This refreshes (or sets) the @kgio_addr ivar for sockets
+       that didn't go through kgio_accept or kgio_tryaccept.
+   commit cff0dd2f73acc73f721b2a589af9e37baedd2489
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Wed Feb 2 13:56:31 2011 -0800
+       fix typos in ipv6 test case
+       Oops, RTFE :P
+   commit 17abe6ce8f01810022b948c71de0026b4ac89597
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Wed Feb 2 21:33:28 2011 +0000
+       add proper IPv6 support
+       No extra #ifdefs, we just won't support old systems without
+       getaddrinfo() and friends anymore.  I doubt anybody still has
+       them...
+   commit 879f2f0ee9133f34ec3e24141bdb4936e3408d3a
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Tue Feb 1 14:00:07 2011 -0800
+       avoid re-interning if GCC is not used (or under 1.8)
+       Needless calls to rb_intern are wasteful in even semi-frequently
+       used code.
+   commit 499f158c74b7c455dca08fc30be88cb699ee24c6
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Tue Feb 1 13:58:20 2011 -0800
+       kgio_*read: empty backtrace for ECONNRESET
+       There's nothing a programmer can do about ECONNRESET
+       so just make the exception cheaper to raise so it
+       can still be logged.
+   commit 36f69750cd69cbf892580da04be6675e23d92f6f
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Mon Jan 31 18:39:31 2011 -0800
+       add singleton methods for non-Kgio objects
+       This allows people to more easily use Kgio in existing apps.
+   commit 37e50a9a5fcd45242373379c0dc61ebf8ff609af
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Mon Jan 31 18:27:24 2011 -0800
+       autopush: enable accessors for client sockets
+       Might as well allow clients to efficiently handle
+       TCP_CORK/TCP_NOPUSH, too.
+   commit d4773fc63a847119004c17a1b8803a815f99d98a
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Mon Jan 31 17:34:07 2011 -0800
+       autopush: enable this by default
+       TCP_CORK (and presuably TCP_NOPUSH) aren't remotely useful in
+       Rainbows! without this and there's almost no overhead for MRI,
+       either.
+   commit 8a1fc65c88dee174940735bb46074c72ac47ce61
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Mon Jan 31 17:05:48 2011 -0800
+       autopush: optimize away ivar usage under MRI
+       We know that all versions of MRI have a small RFile structure
+       that is allocated in the same object slots as other Ruby types
+       and also zeroed on allocation.
+       This optimization enables us to fall back to using ivars in
+       case MRI changes or if we're used on other Rubies.
+   commit 6479b6d3934b8930910e0057f516aa019dd7a8c7
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Mon Jan 31 15:18:33 2011 -0800
+       autopush: enable for TCP_NOPUSH under FreeBSD
+       Hopefully it works for people who use TCP_NOPUSH...
+   commit 15744a90cda72e9007914cd2a78b0b2949193479
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Mon Jan 31 13:58:53 2011 -0800
+       autopush: simplify implementation and just use ivars
+       Duh...
+   commit 313d2bb8d37dbc5602e464def90b3e7fa9f60924
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Mon Jan 31 13:03:02 2011 -0800
+       rename nopush_smart to autopush
+       This is probably a better name for it, libautocork is a nice
+       name even though we won't use it directly.
+   commit 910f6f3df099c04fcd55bd6b20785cce69cb36ae
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Jan 27 19:43:39 2011 -0800
+       preliminary implementation of "smart_nopush"
+       It only supports TCP_CORK under Linux right now.
+       We use a very basic strategy to use TCP_CORK semantics optimally
+       in most TCP servers:  On corked sockets, we will uncork on recv()
+       if there was a previous send().  Otherwise we do not fiddle
+       with TCP_CORK at all.
+       Under Linux, we can rely on TCP_CORK being inherited in an
+       accept()-ed client socket so we can avoid syscalls for each
+       accept()-ed client if we already know the accept() socket corks.
+       This module does NOTHING for client TCP sockets, we only deal
+       with accept()-ed sockets right now.
+   commit ec91ac3d8c8d9236ba0cd01794c9c4a3ee3f7eeb
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Jan 27 14:11:16 2011 -0800
+       revamp packaging makefile, update URLs
+       More common code that's still GNU make is better for my
+       sanity.  Also, bogomips.org went on a URL diet recently.
+   commit f6c79438ed195bb706903d104cce850bfbfbac41
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Tue Jan 18 15:52:25 2011 -0800
+       add tests for empty writes, too
+       There could be some platforms that dislike it...
+   commit 9c81cc3fd8d2b3dce68d69d8e0c56a4c5d89ebf0
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Jan 13 14:46:02 2011 -0800
+       Makefile: remove non-existent target reference
+       Oops
+   commit fb8104e1f2a5d1cdcb99a19b6a4bdabf0b1c2643
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sat Dec 25 18:06:47 2010 -0800
+       kgio 2.1.1 - one small Rubinius fix
+       We now avoid errno side-effects in kgio_wait_*able methods.
+       This affects Rubinius, but may affect other Ruby platforms
+       (particularly those that use stdio) as well.
+   commit 6ab4331f8137e949ab57f014f96ff3918a315044
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sat Dec 25 18:02:16 2010 -0800
+       avoid errno side-effects in kgio_wait_*able
+       Retrieving the file descriptor may have side-effects on
+       certain Ruby implementations (e.g. Rubinius), so ensure
+       our errno is preserved before calling rb_io_wait_*able().
+   commit 3a0323b642ee054319a5e64ffe28e089bbd013e4
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sun Dec 26 01:08:58 2010 +0000
+       gemspec: point folks to the public mailing list
+       It's more useful that way.
+   commit 9d5c9e6c9975cb5c10e7384aed9ed22ae0ee57c8
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sun Dec 26 01:02:00 2010 +0000
+       kgio 2.1.0 - accept improvements and fixes
+       kgio_accept and kgio_tryaccept now take an optional argument
+       to override the default Kgio::Socket class that is returned.
+       These methods also fall back to using regular accept() if
+       kgio was built on a system with accept4() and later run on
+       a system without accept4().
+   commit dcd5eff7dd5d5861b67667f48424979be9bcabc8
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sun Dec 26 00:21:25 2010 +0000
+       quiet down some harmless compiler warnings
+       Less noise means we'll notice real bugs sooner.
+   commit 5280f35f131d88f90afffff0e10f7900530728aa
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Sat Dec 25 23:00:05 2010 +0000
+       accept4: fall back to regular accept() on ENOSYS
+       kgio may occasionally be built on a system with accept4()
+       and then deployed on one without it.   Handle this case
+       gracefully since it unfortunately happens on production systems.
+   commit b859c4a12905cbd71d19cde2aaa9f88ec0374cc5
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Sat Dec 25 22:44:53 2010 +0000
+       accept methods may take an optional argument
+       This is preferred as we no longer have to rely on a global
+       constant.
+   commit ef069ece624906b3946248421620d8458bcef605
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Fri Dec 24 09:21:19 2010 +0000
+       Rakefile: fix RAA license
+       Oops, we were never Ruby licensed.
+   commit 472240687caf3f113a3ff408729f8205c475d7d5
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Fri Dec 24 09:20:40 2010 +0000
+       doc: use wrongdoc for documentation
+       wrongdoc factors out a bunch of common code from this
+       project into its own and removes JavaScript from RDoc
+       to boot.
+   commit 64bbc95d2192fb621b763c1c4d1ae32940c1a5ac
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Wed Dec 22 12:12:18 2010 -0800
+       fix errors in RDoc
+       Noticed-by: Iñaki Baz Castillo
+   commit f093312ad1ed336363f352991b6b99d96f7aed1d
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Nov 18 17:16:53 2010 -0800
+       kgio 2.0.0 - major internal API changes
+       (no code changes from 2.0.0pre1)
+       This release should make Kgio easier and more consistent
+       to use across a variety of libraries/applications.
+       The global Kgio.wait_*able(=) accessor methods are gone in favor
+       of having default kgio_wait_readable and kgio_wait_writable
+       methods added to all Kgio-using classes.  Sub-classes may (and
+       are encouraged to) redefine these if needed.
+       Eric Wong (7):
+           expand Kgio::*#kgio_read! documentation
+           prefer symbolic names for waiting read/writability
+           EOFError message matches Ruby's
+           README: Gemcutter => RubyGems.org
+           update documentation with mailing list info
+           add default kgio_wait_*able methods
+           switch entirely to kgio_wait_*able methods
+   commit edfa7e60de5556b6abc9febe6a21e12dadbafd0b
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Nov 18 15:42:27 2010 -0800
+       Rakefile: list prerelease tags as well
+       Since we do prerelease nowadays before real ones.
+   commit d78a2075bdb0a30bf0064d2857011c330cc0d09e
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Nov 18 15:38:12 2010 -0800
+       move website to bogomips.org
+       This project is useful enough for others and to stand alone
+       without needing to be associated with Unicorn.
+   commit 28070c522aff233eadb7e167f8d4e8122cd0bb47
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Nov 18 15:15:40 2010 -0800
+       kgio 2.0.0pre1 - major internal API changes
+       This release should make Kgio easier and more consistent
+       to use across a variety of libraries/applications.
+       The global Kgio.wait_*able(=) accessor methods are gone in favor
+       of having default kgio_wait_readable and kgio_wait_writable
+       methods added to all Kgio-using classes.  Sub-classes may (and
+       are encouraged to) redefine these if needed.
+       Eric Wong (7):
+             expand Kgio::*#kgio_read! documentation
+             prefer symbolic names for waiting read/writability
+             EOFError message matches Ruby's
+             README: Gemcutter => RubyGems.org
+             update documentation with mailing list info
+             add default kgio_wait_*able methods
+             switch entirely to kgio_wait_*able methods
+   commit c69955e64648ab6a3471a54f7885a320428682f9
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Thu Nov 18 14:37:05 2010 -0800
+       switch entirely to kgio_wait_*able methods
+       This removes the global Kgio.wait_*able accesors and requires
+       each class to define (or fall back to) the Kgio::DefaultWaiters
+       methods.
+   commit f1b497e601ed2acb54f75dc989d0a5ec7afebca0
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Thu Nov 18 13:38:32 2010 -0800
+       add default kgio_wait_*able methods
+       It makes it easier for people to use certain overrides without
+       killing other methods.  This is the first step in fixing
+       problems people were having with dalli 0.11.1+ while running
+       Unicorn.
+   commit 827ad6b4fba768a5cac8fb4e83fbbf61cf7a3194
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Mon Nov 15 10:33:55 2010 -0800
+       update documentation with mailing list info
+       We're a real project, apparently, so it can have its
+       own mailing list.
+   commit fd88eae588c1e715dcaf3a1a000391cc13481e02
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Mon Nov 15 10:22:49 2010 -0800
+       README: Gemcutter => RubyGems.org
+       That's the new name for it and it's official
+   commit 8615a3f9554df0fd7f7f088cd49cf1e3be49de9f
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Fri Nov 12 20:25:50 2010 -0800
+       EOFError message matches Ruby's
+       This makes messages appear less different than Ruby
+       when using kgio_read!
+       Requested-by: Mike Perham
+   commit 2772ed8bfe108b66b7493bc5cb0c40ddeb1ca57d
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Fri Nov 5 09:01:08 2010 +0800
+       prefer symbolic names for waiting read/writability
+       There's no point in using constants that point to symbols
+       instead of just the symbols themselves.
+   commit bf3b507791403811bece9dff915ca10757bca519
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Thu Oct 28 21:02:31 2010 +0000
+       expand Kgio::*#kgio_read! documentation
+       If the author can forget why it was written, so can
+       the rest of the world.
+   commit f4d08a07a02393cca5ddd1277acc4f95c83307ff
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Fri Oct 8 14:55:16 2010 -0700
+       kgio 1.3.1 - fix zero-length reads
+       kgio_read and kgio_tryread will now return an empty string when
+       a length of zero is specified instead of nil (which would signal
+       an EOF).  This emulates the behavior of IO#read, IO#readpartial,
+       IO#sysread, IO#read_nonblock in core Ruby for consistency.
+   commit d225ede82d820d045bd7cfb826f444cf6601577c
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Fri Oct 8 02:53:38 2010 -0700
+       return empty string on length=0
+       This matches behavior of all the core Ruby methods.
+   commit e4599227f0da0f652cbcb52838e631d7384dcd0d
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Thu Oct 7 20:02:40 2010 -0700
+       kgio 1.3.0 - bug and usability fixes
+       * make Kgio::WaitWritable and Kgio::WaitReadable symbols
+       * trywrite: fix stupid off-by-one error causing corrupt writes
+         on retries
+   commit f5fc35221d37141b0f72278c7b969211410e94c0
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Thu Oct 7 20:00:09 2010 -0700
+       tests: don't trust what I think I know about Ruby
+       case/when and === didn't actually work as I expected
+       them to.
+   commit 2152188f41bf2a5067e84a4404b48b2282a9dd55
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Thu Oct 7 19:56:57 2010 -0700
+       trywrite: fix stupid off-by-one error causing corrupt writes
+       Oops!
+   commit c448ad898ecb7f354a32a320294da4727fc9af52
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Thu Oct 7 19:55:49 2010 -0700
+       make WaitWritable and WaitReadable symbols
+       This makes them easier to compare with === when used
+       in case/when statements in Ruby
+   commit 49f0b98c69f1f0bf637953d0bfc96b764f00ab9b
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Thu Oct 7 07:15:49 2010 +0000
+       kgio 1.2.1 - doc and *BSD workarounds
+       This fixes our accept4() wrapper which did not work as expected
+       on some *BSD-based systems due to fcntl(fd, F_GETFL) returning
+       false information.  Linux 2.6+ users are unnaffected, including
+       those without accept4().
+       Also some RDoc fixes.
+   commit 03344bb763f5269afe7fafd56a47270719c7ef9e
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Thu Oct 7 07:14:07 2010 +0000
+       doc: fix RDoc generation
+       Oops, completely broken by the splitting of the code.
+   commit 637317eb479525dca543eda7a8977410bc43b832
+   Author: Eric Wong <e+07380@yhbt.net>
+   Date:   Wed Oct 6 14:08:35 2010 -0700
+       accept4: workaround (P)OS X bug w/O_NONBLOCK
+       Apparently fcntl(fd, F_GETFL) can return falsely return the
+       O_NONBLOCK flag without actually having it set in the kernel.
+       This is totally broken on the part of the OS.
+   commit ca76c75f8a24d0cd6828fe16ca3790a277b35f8d
+   Author: Eric Wong <e+07380@yhbt.net>
+   Date:   Wed Oct 6 14:06:27 2010 -0700
+       build: pick on on modified extension files
+       We build more than one file nowadays.
+   commit 65f96b7750616bc210397c16eea40961e578a788
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Wed Oct 6 11:51:04 2010 -0700
+       doc: fix typo in Kgio.accept_cloexec= doc
+       oops...
+   commit 414dd17f1009c571e2d7657721271756e3d4dd8e
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Tue Oct 5 16:09:40 2010 -0700
+       kgio 1.2.0 - cleanups and minor improvements
+       The C extension is now split into several files for
+       ease-of-maintenance.
+       Slightly more common, client-triggerable exceptions (EOFError,
+       Errno::EPIPE, Errno::ECONNRESET) are now less expensive as they
+       are generated without backtraces.
+   commit e085bb9600b190692beb5efc85656ebf127ae08c
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Tue Oct 5 15:45:16 2010 -0700
+       generate empty backtraces for EPIPE and ECONNRESET
+       Malicious clients may disconnect during big writes to cause
+       EPIPE and ECONNRESET exceptions.  Generating backtraces can be
+       expensive with Ruby, so mitigate the DoS vector by lowering the
+       cost of generating an exception.
+   commit b168cc894037620cab82fa82f3ab37a3aab81570
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Tue Oct 5 15:26:57 2010 -0700
+       add kgio_read! methods which may raise EOFError
+       Except EOFError is gently raised to not include a huge
+       backtrace.  Large backtraces can be a performance problem on
+       busy servers that malicious clients may exploit to deny service.
+   commit 870ada92db7071c7982913e508ac35b97d6e8761
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Tue Oct 5 11:45:02 2010 -0700
+       GNUmakefile: use portable tar invocation
+       We've been spoiled by GNU tar.
+   commit 2a6115a89d5c95428bd6c3e0bc10e5a3a4c3c3be
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Wed Sep 29 18:25:58 2010 -0700
+       refactor and split into separate files
+       Making the code easier to read and navigate.  This also
+       frees us from having to use the stupid A4_ prefix for
+       accept4(2) flags since it conflicts with the socket(2)
+       ones.
+   commit 8fe89997453d6c530c3f5e08bc9c1da40a621248
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Wed Sep 29 17:13:21 2010 -0700
+       Make kgio_trywrite more aggressive with retrying
+       Partial writes can be retried until completely denied with
+       EAGAIN.  Often times, it is beneficial to retry immediately
+       after a partial write because the kernel may allocate more
+       buffers or the reader can drain the buffers.
+       This helps the caller avoid crossing the Ruby <-> C boundary
+       more than necessary.
+   commit 39c851e595970a2349a8a39878afd94a3324e102
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Tue Sep 28 18:16:53 2010 -0700
+       kgio 1.1.0 - flexible accept methods
+       * an alternate class now be returned by accept/tryaccept
+         by setting "Kgio.accept_class ="
+   commit 911f6ab306aff1e24c9c570eeae33923fa1b99d9
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Tue Sep 28 18:04:51 2010 -0700
+       alternate classes may be returned by accept/tryaccept
+       These can be useful for avoiding wrapper objects and
+       also allows users to more easily try different things
+       without stepping on others' toe^H^H^Hclasses.
+   commit 526b4bd48a20a34ef5959fdc4aa580d5f9199652
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Mon Sep 27 19:59:34 2010 -0700
+       kgio 1.0.1 - compatibility fixes
+       * add compatibility for ancient Rubies (1.8.6)
+       * linux: fix accept4() support for newer Linux
+   commit 20cbc0355104470fb433dd13e87a5d5c7e888ab1
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Tue Sep 28 02:56:41 2010 +0000
+       linux: fix accept4() support for newer Linux
+       Oops :x  Tested on Debian sid.
+   commit 24f1d168eb0937f0586c45b266bcd208431f0107
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Mon Sep 27 18:06:34 2010 -0700
+       add compatibility for ancient Rubies
+       This is tested on Ruby 1.8.6-p114, but may work
+       for 1.8.5, too.  Ugh, people ought to upgrade.
+   commit e4d204c86e9420023ba3e4d8dbeb6b3fea8d6cf7
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Tue Sep 28 00:27:44 2010 +0000
+       kgio 1.0.0 - initial release
+       Documentation and release infrastructure updates
+       and such...
+   commit 8984b9556a3493570fbb4f747fce712d58f2cdd8
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Tue Sep 28 00:07:43 2010 +0000
+       doc: TODO update
+   commit 2c64a1fc07d3b9a80d112e3b0e2baa7ec29c2f47
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Tue Sep 28 00:03:39 2010 +0000
+       read/write: account for buffer changes during wait
+       It's possible for applications to modify the buffer during
+       reads and writes, so make a best effort to account for those.
+   commit f2ea9918655e8ee0576bee2950d16485031fc361
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Mon Sep 27 23:59:59 2010 +0000
+       tests: fix broken monster trywrite test
+       Oops, use random data so it's easier to detect this.
+   commit 7abc0eb3dd804c2e65660b7dd9c828df0e03b80a
+   Author: Eric Wong <e+absinthe@yhbt.net>
+   Date:   Mon Sep 27 15:09:44 2010 -0700
+       test_tcp*read_write: use blocking kgio_accept in setup
+       Some OSes (FreeBSD 7.0) do not seem to setup
+        connections as quickly.
+   commit 95d2eae6a4da34c504427af6ae0ab4c8c70c0ce5
+   Author: Eric Wong <e+absinthe@yhbt.net>
+   Date:   Mon Sep 27 15:09:43 2010 -0700
+       set blocking flag before blocking IO#read
+       Some older Rubies may not behave correctly otherwise
+   commit 0806cac89f9d0e169b6c1e4da68c1ad66daa23ae
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Mon Sep 27 23:16:53 2010 +0000
+       tess: ensure buffer is cleared on failures
+       No need to leak data.
+   commit 50b86bf23063f3e6c3777b39c9464f73ccfd6ef5
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Mon Sep 27 22:55:52 2010 +0000
+       more documentation
+       Somebody's gotta do it...
+   commit 5123d66fe0b2dad67539a20fe5b91f5b9afd814a
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Mon Sep 27 16:56:13 2010 +0000
+       avoid initiating syscalls before rb_io_wait_*
+       Some Ruby implementations (Rubinius) may call lseek
+       and clobber the intended errno when looking up the
+       open file, causing rb_io_wait_* functions to fail.
+   commit 6c818b0b6f76ef733679bcea1024142b4ef3ce00
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Mon Sep 27 01:13:30 2010 +0000
+       add kgio_tryaccept, kgio_accept _really_ blocks
+       We'll stick with the "try" prefix if we're going to be
+       non-blocking.  kgio_accept will favor a blocking accept() call
+       where it's possible to release the GVL, allowing it to avoid
+       thundering herd problems.  Otherwise it'll use thread-safe
+       blocking under Ruby 1.8.
+   commit f81cb3c05a0eb46ec61ceb295b51ead16e6a0da4
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Mon Sep 27 00:57:14 2010 +0000
+       use SOCK_NONBLOCK for socket(2) if possible
+       This saves us a relatively expensive fcntl() system call.
+   commit 87cf3ce6185b9138032a5af53cecae98f8c93564
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Mon Sep 27 00:24:50 2010 +0000
+       connect: no do not leak descriptors on failure
+       We cannot raise exceptions and expect GC to clean up
+       after us until we've created an actual IO object.
+   commit 6fbde1518578dd1b828efcecaf2caf893bddc110
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Mon Sep 27 00:11:43 2010 +0000
+       "start" singleton methods for non-blocking connect
+       These initiate (but do not wait for) non-blocking connects.
+   commit fdfecc6d815bab8dfc1d8ad6758a66d44ab51e31
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Sun Sep 26 07:51:12 2010 +0000
+       introduce kgio_try* methods
+       Avoid altering behavior based on globals that
+       Kgio.wait_{read,writ}able stored in, since that's too confusing.
+       The non-try variants are closer to the normal IO read/write
+       methods, except they can be more easily plugged into alternate
+       reactors and event frameworks.
+   commit d8ee79e1e5c6e6908009213324db25cf41c583ce
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Sat Sep 25 17:55:07 2010 +0000
+       kgio_read returns nil on EOF
+       Just like IO#read
+   commit af03e4471de3d3b91eec16e26e93a84d4a717116
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Sat Sep 25 17:47:13 2010 +0000
+       split out reusable bits into separate headers
+       No point in cluttering up the meat of our code.
+   commit db53263856d864ba6273e6cac73011f699509d71
+   Author: Eric Wong <e+absinthe@yhbt.net>
+   Date:   Sat Sep 25 01:36:13 2010 -0700
+       only use MSG_DONTWAIT under Linux
+       MSG_DONTWAIT is less consistently implemented/supported on other
+       platforms on stream sockets, so fallback to fcntl() + read()/write()
+       for stream sockets.  This also fixes our previously broken support
+       of non-MSG_DONTWAIT systems.
+   commit a82dc40c2a509c4ab692da34b572693f243fbfae
+   Author: Eric Wong <e+absinthe@yhbt.net>
+   Date:   Sat Sep 25 01:36:12 2010 -0700
+       write/send may fail with ECONNRESET
+       Tested on FreeBSD 7.0
+   commit 0c60192621303f5e4ebd46d43a058de48126bc8a
+   Author: Eric Wong <e+absinthe@yhbt.net>
+   Date:   Sat Sep 25 01:36:11 2010 -0700
+       fix missing netinet/in.h include
+       This is needed for FreeBSD 7.0, at least.
+   commit 0beb82437f4ab0b8422e225080b234361092315e
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Sat Sep 25 08:15:13 2010 +0000
+       beef up the test suite
+       We need to test server <-> client interaction
+       more thoroughly since some systems don't implement
+       everything right.
+   commit 460e6b025896dee64b39d194d4c1a536129654de
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Thu Sep 23 22:56:44 2010 +0000
+       initial commit + release
+       everything shou^Wmight be working...