12 releases

0.3.6 Dec 16, 2022
0.3.5 Jan 28, 2021
0.3.4 Dec 12, 2020
0.3.3 Sep 14, 2020
0.0.1 Nov 14, 2019

#1305 in Network programming

Download history 182/week @ 2024-06-10 133/week @ 2024-06-17 218/week @ 2024-06-24 95/week @ 2024-07-01 117/week @ 2024-07-08 191/week @ 2024-07-15 207/week @ 2024-07-22 172/week @ 2024-07-29 145/week @ 2024-08-05 177/week @ 2024-08-12 246/week @ 2024-08-19 582/week @ 2024-08-26 308/week @ 2024-09-02 331/week @ 2024-09-09 247/week @ 2024-09-16 473/week @ 2024-09-23

1,373 downloads per month
Used in 2 crates

MIT license

68KB
1.5K SLoC

async-tftp

license crates.io docs

Executor agnostic async TFTP implementation, written with smol building blocks. Currently it implements only server side.

The following RFCs are implemented:

  • RFC 1350 - The TFTP Protocol (Revision 2).
  • RFC 2347 - TFTP Option Extension.
  • RFC 2348 - TFTP Blocksize Option.
  • RFC 2349 - TFTP Timeout Interval and Transfer Size Options.

Features:

  • Async implementation.
  • Works with any runtime/executor.
  • Serve read (RRQ) and write (WRQ) requests.
  • Unlimited transfer file size (block number roll-over).
  • You can set non-standard reply timeout. This is useful for faster file transfer in unstable environments.
  • You can set block size limit. This is useful if you are accessing client through a VPN.
  • You can implement your own Handler for more advance cases than just serving a directory. Check tftpd-targz.rs for an example.

Example

use async_tftp::server::TftpServerBuilder;
use async_tftp::Result;

fn main() -> Result<()> {
    smol::block_on(async { // or any other runtime/executor
        let tftpd = TftpServerBuilder::with_dir_ro(".")?.build().await?;
        tftpd.serve().await?;
        Ok(())
    })
}

Add in Cargo.toml:

[dependencies]
smol = "1" # or any other runtime/executor
async-tftp = "0.3"

Running examples with cargo

There are some examples included with this crate. You can run them from a source checkout with cargo:

$ cargo run --example tftpd-dir
TFTP directory: ...
Listening on: 0.0.0.0:6969
^C

$ cargo run --example tftpd-targz <archive-path>
Listening on: 0.0.0.0:6969
^C

License

MIT

Dependencies

~6–19MB
~223K SLoC