https://github.com/reinerh/rtftp

A rusty client/server for the Trivial File Transfer Protocol
https://github.com/reinerh/rtftp

rust tftp tftp-client tftp-server

Last synced: 2 months ago
JSON representation

A rusty client/server for the Trivial File Transfer Protocol

• Host: GitHub
• URL: https://github.com/reinerh/rtftp
• Owner: reinerh
• License: gpl-3.0
• Created: 2019-03-03T16:56:49.000Z (almost 6 years ago)
• Default Branch: trunk
• Last Pushed: 2023-04-19T21:46:34.000Z (over 1 year ago)
• Last Synced: 2024-09-16T05:58:24.209Z (4 months ago)
• Topics: rust, tftp, tftp-client, tftp-server
• Language: Rust
• Homepage:
• Size: 111 KB
• Stars: 11
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES
  • License: COPYING

Awesome Lists containing this project

README

        
# RusTFTP

A client and server implementation of the Trivial File Transfer Protocol,

written in Rust.

[![Crates.io](https://img.shields.io/crates/v/rtftp.svg)](https://crates.io/crates/rtftp)

Currently supported:

* RFC 1350 (TFTP revision 2)

* RFC 2347 (Option Extension)

* RFC 2348 (Blocksize Option)

* RFC 2349 (Timeout Interval and Transfer Size Options)

Non-standard options:

* blksize2: block size as a power of 2

* utimeout: timeout in microseconds

Use cargo to build the binaries (output dir is `target/release/`):

```bash

cargo build --release

```

To directly download, compile and install the binaries:

```bash

cargo install rtftp

```

## Usage

### Client

```bash

$ ./rtftpc --help

RusTFTP

./rtftpc [options] [:port]

Options:

    -h, --help          display usage information

    -g, --get FILE      download file from remote server

    -p, --put FILE      upload file to remote server

    -b, --blksize SIZE  negotiate a different block size (default: 1428)

    -n, --netascii      use netascii mode (instead of octet)

```

### Server

```bash

$ ./rtftpd --help

RusTFTP

./rtftpd [options] [directory]

Options:

    -h, --help          display usage information

    -p, --port PORT     port to listen on (default: 69)

    -u, --uid UID       user id to run as (default: 65534)

    -g, --gid GID       group id to run as (default: 65534)

    -r, --read-only     allow only reading/downloading of files (RRQ)

    -w, --write-only    allow only writing/uploading of files (WRQ)

    -t, --threads N     number of worker threads (default: 2)

```

## Notes

As the block number is two bytes long, the number of blocks is limited

to 65535 (with the first block starting at 1).

To support the transfer of files larger than 65535 blocks, it will wrap around

after reaching the maximum and start at 0 again, which is not defined in the

standard.

## License

This program is free software: you can redistribute it and/or modify

it under the terms of the GNU General Public License as published by

the Free Software Foundation, either version 3 of the License, or

(at your option) any later version.