[ANN] ruby-sendfile 0.9.1

[Toby DiPasquale]

As promised, I've updated ruby-sendfile to make it more "1.0". There is
a source tarball and gem up on Rubyforge, whichever you prefer. I've
also added unit tests to make sure that full and partial sends work on
both blocking and non-blocking sockets on all supported OSs (everything
that has a recognizable sendfile(2)). Unlike socket_sendfile,
ruby-sendfile can send a partial file with the optional offset and byte
count parameters (see below).

All tests pass on Linux (tested on x86 and AMD64, both 2.6.x) and
FreeBSD (tested on 5.3-RELEASE), and ruby-sendfile will truly be 1.0
when the tests pass on Solaris. They should pass right now, but I don't
have a box to test them on.

P.S. Eric: now _these_ are tests ;-)

[Changelog]

- Improved interface with non-blocking sockets
- Added unit tests for blocking sends
- Added unit tests for nonblocking sends
- Added README
- Packaged in a RubyGem

[README]

= Ruby sendfile(2) Interface

This module allows Ruby programs to access their OS's native
sendfile(2) system call from any IO object. Your kernel must
export a recognized signature for the sendfile(2) system call
to use this module. Currently, that includes Linux, Solaris
and FreeBSD.

== Installation

Download and install the latest package from the rubyforge.org
RubyGems repository.

gem install sendfile --remote
gem check sendfile --test

If the tests all pass, you're ready to start using sendfile.

Or, if you don't have rubygems installed, you can install by
hand by downloading the tarball:

tar xzvf ruby-sendfile-<latest>.tar.gz
cd ruby-sendfile-<latest>/ext
ruby extconf.rb
make
sudo make install

== Usage

Here's a small example of a use of IO#sendfile.

require 'socket'
require 'rubygems'
require 'sendfile'

s = TCPSocket.new 'yourdomain.com', 5000
File.open 'somefile.txt' { |f| s.sendfile f }
s.close

See the test scripts for more examples on how to use this
module.

== Contact Information

This project's homepage is:

http://rubyforge.org/projects/ruby-sendfile

Thereupon are forums for discussing issues
can be found for working out any issues you may have with this
module. In the last case, you can email questions or patches
to (e-mail address removed).

 

[ara.t.howard]

As promised, I've updated ruby-sendfile to make it more "1.0". There is
a source tarball and gem up on Rubyforge, whichever you prefer. I've
also added unit tests to make sure that full and partial sends work on
both blocking and non-blocking sockets on all supported OSs (everything
that has a recognizable sendfile(2)). Unlike socket_sendfile,
ruby-sendfile can send a partial file with the optional offset and byte
count parameters (see below).

All tests pass on Linux (tested on x86 and AMD64, both 2.6.x) and
FreeBSD (tested on 5.3-RELEASE), and ruby-sendfile will truly be 1.0
when the tests pass on Solaris. They should pass right now, but I don't
have a box to test them on.

i can test on solaris... but not till monday. thanks alot for this work!

-a

 

[Zed Shaw]

Toby,

You are calling a "rv_sys_fail" function in sendfile.c instead of
rb_sys_fail. Otherwise seems to work great. I'll be adding this as a
dynamic require for Mongrel so if folks have it installed it will be used in
the DirHandler.

Zed A. Shaw
http://www.zedshaw.com/

 

[Amit Tomar]

Toby,

You are calling a "rv_sys_fail" function in sendfile.c instead of
rb_sys_fail. Otherwise seems to work great. I'll be adding this as a
dynamic require for Mongrel so if folks have it installed it will be
used in
the DirHandler.

Zed A. Shaw
http://www.zedshaw.com/

will it be useful for large file download ???

 

[Brian Candler]

will it be useful for large file download ???

You are re-opening a four-and-a-half year old thread ???

If you want to know what sendfile does, have a look at the sendfile(2)
manpage. Basically, it allows a process to tell the kernel to copy data
between two open file descriptors (like a file and a socket), without
having to slurp the data from kernel into userland and back into kernel
again.