async-tftp

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

```rust use asynctftp::server::TftpServerBuilder; use asynctftp::Result;

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

Add in Cargo.toml:

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:

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

$ cargo run --example tftpd-targz Listening on: 0.0.0.0:6969 ^C ```

License

MIT