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 |
|
#1305 in Network programming
1,373 downloads per month
Used in 2 crates
68KB
1.5K
SLoC
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. Checktftpd-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
Dependencies
~6–19MB
~223K SLoC