Project

fx-tftp

0.01
No commit activity in last 3 years
No release in over 3 years
Got carried away a bit with the OOness of the whole thing, so while it won't be the fastest TFTP server it might be the most flexible, at least for pure-Ruby ones. With all the infastructure already in place adding a client should be a breeze, should anyone need it.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 5.4
~> 10.0
 Project Readme

FX-TFTP Build Status Gem Yard Docs

Description

FX-TFTP is a slightly over-OO-ed pure-Ruby implementation of plain RFC1350 TFTP server. It is very flexible and intended for hacking. Also, and more importantly, it works, contrary to other gems that are occupying space at RubyGems.

That flexibility may be useful if you're planning on massive custom TFTP-based boots, or if you're into hacking researching cheap router security. The request packets parsing has been relaxed so that it should work with TFTP clients that use some fancy extensions. I have tested the server on Linux x86_64 with Ruby 2.2.0 and on FreeBSD amd64 with Ruby 1.9.3p194, and it successfully exchanged data both ways with clients running on numerous platforms.

The included tftpd executable gives you a fully-fledged read-write TFTP server that also does logging, daemon mode and does not crap out on SIGTERM.

Quickstart

Just in case you need an easy to use tftp server... Install via Rubygems:

$ gem install fx-tftp

Then start the beast with any directory you want to serve (works for uploads and downloads as well):

$ sudo tftpd ~/router_firmwares_and_config_files/

Further options:

$ tftpd
Usage: tftpd [OPTIONS] DIR
    -V, --version                    Show version and exit
    -a, --address ADDRESS            Address to listen on (default: 0.0.0.0)
    -p, --port PORT                  Port to listen on (default: 69)
    -v, --verbose                    Enable verbose output

Hacking

Suppose we want to have a TFTP server that only supports reading, but the files served should depend on the IP block the client is connecting from:

class CustomHandler < TFTP::Handler::RWSimple
    ip = src.remote_address.ip_address.split('.')
    block = ip.slice(0, 3).join('-')
    req.filename = File.join(block, req.filename)
    log :info, "#{tag} Mapped filename to #{req.filename}"
    super(tag, req, sock, src)
  end
end

srv = TFTP::Server::Base.new(CustomHandler.new(path, :no_write => true), opts)

When you combine filename inspection and #send and #recv methods working on plain IO objects you can easily whip up things like serving dynamically built scripts/binaries/archives based on parameters passed as the requested 'filename'.

Contributing

Fell free to contributed patches using the common GitHub model (descried below). I'm also interested in cases where something doesn't work (weird platforms etc.). If you feel like it please write the client side.

  • Fork the repo
  • Checkout a new branch for your changes
  • Write code and tests, check, commit
  • Make a Pull Request

Licensing

Standard two-clause BSD license, see LICENSE.txt for details.

Copyright © 2015 - 2016 Piotr S. Staszewski