From: Eric Wong <normalperson-rMlxZR9MS24@public.gmane.org>
Subject: [ANN] socket_dontwait - socket methods using MSG_DONTWAIT and more
Date: Tue, 3 Aug 2010 09:18:47 +0000 [thread overview]
Message-ID: <20100803091847.GC3255@dcvr.yhbt.net> (raw)
This library is a drop-in replacement that reimplements several IO
methods with replacements using MSG_DONTWAIT for BasicSocket. This
allows us to avoid unnecessary system calls and GVL bouncing.
Reports of performance differences with and without this library loaded
would be greatly appreciated! Feel free to email me privately if you're
shy, too. HTML mail will be mercilessly deleted :P
The rest of the README below:
We've reimplemented the +readpartial+, +read_nonblock+,
+write_nonblock+, +read+ and +write+ instance methods normally inherited
from the IO class directly into BasicSocket with socket-specific system
calls and flags.
This library is only intended for Ruby 1.9 and will not build with other
versions of Ruby. This only supports operating systems with the
non-POSIX MSG_DONTWAIT flag for send(2) and recv(2) syscalls.
This library is considered EXPERIMENTAL. If successful, we'll see about
getting them integrated into the standard Ruby socket library.
* Avoid use of fcntl(2) to set O_NONBLOCK in favor of MSG_DONTWAIT when
using non-blocking I/O. We _unset_ O_NONBLOCK if we need to block
and release the GVL instead of relying on select(2).
* Avoids select(2) entirely in favor of blocking I/O when the
GVL is released. This allows using file descriptor numbers higher
than 1023 without overflowing select(2) buffers.
* BasicSocket#read uses recv(2) with MSG_WAITALL to avoid extra system
calls for larger reads.
* Thread and signal-safe, releases the GVL for all blocking operations
and retries if system calls are interrupted.
* Includes a 1.9.1-specific workaround to preserve errno after reacquiring
the GVL. This is
in newer versions of Ruby.
* Falls back to line-buffered IO if needed (not recommended).
* We ignore taint/$SAFE checks, we'll support it if there's demand,
but we doubt there is...
* Does not support 1.9 encoding filters. 1.9 defaults all sockets to
Encoding::BINARY anyways, so this should not be noticeable to code
that leaves socket encodings untouched.
* Does not support write buffering in userspace. Ruby defaults all
sockets to "IO#sync = true", anyways so this does not affect code
that leaves the default setting untouched.
* Avoid using line-buffered IO on sockets (IO#gets, IO#each_line),
nearly all of the features of this library are cancelled out when
the line-buffering fallback is used.
If you're using a packaged Ruby distribution, make sure you have a C
compiler and the matching Ruby development libraries and headers.
You need Ruby 1.9 to install socket_dontwait. Previous versions of
Ruby will NOT be supported.
If you use RubyGems:
gem install socket_dontwait
Otherwise grab the latest tarball from:
Unpack it, and run "ruby setup.rb"
You can get the latest source via git from the following locations:
You may browse the code from the web and download the latest snapshot
* http://git.bogomips.org/cgit/socket_dontwait.git (cgit)
* http://repo.or.cz/w/socket_dontwait.git (gitweb)
Inline patches (from "git format-patch") to the mailing list are
preferred because they allow code review and comments in the reply to
We will adhere to mostly the same conventions for patch submissions as
git itself. See the Documentation/SubmittingPatches document
distributed with git on on patch submission guidelines to follow. Just
don't email the git mailing list or maintainer with socket_dontwait
== Contact/Bug Reports/Feedback/Patches/Pull-Requests
This was originally created for the Rainbows! project (but may be used by
others), so we'll reuse their mailing list at
Rainbows! mailing list - rainbows-talk-GrnCvJ7WPxnNLxjTenLetw@public.gmane.org
Do not quote signatures (like this one) or top post when replying
next reply other threads:[~2010-08-03 9:22 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-08-03 9:18 Eric Wong [this message]
[not found] ` <20100803091847.GC3255-yBiyF41qdooeIZ0/mPfg9Q@public.gmane.org>
2010-08-09 22:44 ` Eric Wong
[not found] ` <20100809224401.GA12996-yBiyF41qdooeIZ0/mPfg9Q@public.gmane.org>
2010-09-27 21:23 ` [PATCH (socket_dontwait)] README: update with support status Eric Wong
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
List information: https://yhbt.net/rainbows/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this inbox:
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).