tftp-server

A TFTP server implementation in Rust

Building and running the server

In order to build the server, run cargo build --example server.

By default, the server will choose a random open port and serve files from the current directory ./:

$ ./target/debug/examples/server
Server created at address: V4(127.0.0.1:61204)

In this example, the port number picked was 61204.

You can also specify the port number and directory using the -p and -d flags. The --help flag shows all available flags that can be used.

$ ./target/debug/examples/server -p 61204 -d ./files
Server created at address V4(127.0.0.1:61204)

If the port is already taken or there is an error using the port, the server will panic with an IoError.

$ ./target/debug/examples/server -p 20
thread 'main' panicked at 'Error creating server: IoError(Os { code: 13, kind: PermissionDenied, message: "Permission denied" })', src/libcore/result.rs:1165:5
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace.

You can also run the server with logging enabled. To do this add RUST_LOG=tftp_server=info before the command. For example:

$ RUST_LOG=tftp_server=info ./target/debug/examples/server

This will run the server with logging enabled so that you can inspect the program's behavior.

Testing

In order to run the tests you can just run cargo test. However if you want to show the program's output during the test, you have to turn on logging. To run tests with logging enabled run:

$ RUST_LOG=tftp_server=info cargo test