kgio provides non-blocking I/O methods for Ruby without raising exceptions on EAGAIN and EINPROGRESS. It is intended for use with the unicorn Rack server, but may be used by other applications (that run on Unix-like platforms).
Can avoid expensive exceptions on common EAGAIN/EINPROGRESS errors, returning :wait_readable or :wait_writable instead. These exceptions got more expensive to hit under Ruby 1.9.2 (but were fixed in Ruby 1.9.3 and later to 1.9.1 performance levels)
Returns the unwritten portion of the string on partial writes, making it ideal for buffering unwritten data.
May call any method defined to be "kgio_wait_writable" or "kgio_wait_readable" methods to allow socket/pipe objects to make custom callbacks (such as adding the file descriptor to a poll set and yielding the current Fiber).
Uses accept4 on new GNU/Linux systems to avoid unnecessary fcntl() calls
Uses MSG_DONTWAIT on GNU/Linux to further avoid unnecessary fcntl() calls
Compatible with existing Ruby IO objects and Ruby threading.
The library consists of a C extension so you'll need a Unix-like system with a C compiler and Ruby development libraries/headers. You may install it via RubyGems.org:
gem install kgio
You can get the latest source via git from the following locations (these versions may not be stable):
git://bogomips.org/kgio.git git://repo.or.cz/kgio.git (mirror)
You may browse the code from the web and download the latest snapshot tarballs here:
See the HACKING guide on how to contribute and build prerelease gems from git.
All feedback (bug reports, user/development dicussion, patches, pull requests) go to the mailing list/newsgroup. See the ISSUES document for information on the kgio mailing list
For the latest on kgio releases, you may check our NEWS page (and subscribe to our Atom feed).
We love to hear from you!
Email patches (using git send-email), pull requests (formatted using git request-pull), questions, bug reports, suggestions, etc. to us publically at:
Mail archives are available at: http://bogomips.org/kgio-public/
Please send plain-text email only and do not waste bandwidth on HTML mail, HTML mail will not be read.
Quote as little as reasonable and do not top post.
For sensitive topics, email us privately at: firstname.lastname@example.org