From 205beb79e1642a92371c17b53c24c064290e5612 Mon Sep 17 00:00:00 2001 From: Reiner Herrmann Date: Sun, 3 Mar 2019 14:36:07 +0100 Subject: Add README --- README | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 README diff --git a/README b/README new file mode 100644 index 0000000..318917b --- /dev/null +++ b/README @@ -0,0 +1,63 @@ +RusTFTP + +A client and server implementation of the Trivial File Transfer Protocol, +written in Rust. + + +Currently supported: +- RFC 1350 (TFTP revision 2; except 'netascii' mode) +- RFC 2347 (Option Extension) +- RFC 2348 (Blocksize Option) +- RFC 2349 (Timeout Interval and Transfer Size Options) + + +Use cargo to build the binaries (output dir is target/release/): + $ cargo build --release + + +Client: + + $ ./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 + + +Server: + + $ ./rtftpd --help + RusTFTP + + ./rtftpd [options] + + Options: + -h, --help display usage information + -d, --directory DIRECTORY + directory to serve (default: current directory) + -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) + + +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. -- cgit v1.2.3