Ruby Forum Ruby > [ANN] ruby-sendfile 0.9.1

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 toby@cbcg.net.

--
Toby DiPasquale

On Mon, 27 Mar 2006, Toby DiPasquale wrote:

> 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

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/