diff options
author | Stuart Stock <stuart@int08h.com> | 2018-03-10 16:09:45 -0600 |
---|---|---|
committer | Stuart Stock <stuart@int08h.com> | 2018-03-10 16:09:45 -0600 |
commit | afd7026bed14ae1f59da6e3e66fc61986bdca614 (patch) | |
tree | 0e7a3d7cc2f544a2c4ac3e2afdbdee31d59181f8 /README.md | |
parent | 6f996102f705848e45e07e9c183819ff68e89310 (diff) | |
download | roughenough-afd7026bed14ae1f59da6e3e66fc61986bdca614.zip |
Update README and Cargo with info on client; verison bump to 0.3.0
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 28 |
1 files changed, 24 insertions, 4 deletions
@@ -4,10 +4,13 @@ [![Build Status](https://travis-ci.org/int08h/roughenough.svg?branch=master)](https://travis-ci.org/int08h/roughenough) **Roughenough** is a [Roughtime](https://roughtime.googlesource.com/roughtime) secure time -synchronization server implemented in Rust. +synchronization client and server implementation in Rust. The server is functionally complete: it parses client requests and generates valid Roughtime responses. -*Some unimplemented features remain*, see [limitations](#limitations) below. +*Some unimplemented features remain*, see [server limitations](#server limitations) below. + +The client is also functionally complete and validaties the Merkle Tree in responses, if present. + Contributions are welcome. ## Links @@ -18,6 +21,22 @@ Contributions are welcome. ## Building and Running +### Using the Client to Query a Roughtime Server + +```bash +$ cargo build --release +$ target/release/client roughtime.int08h.com 2002 +Requesting time from: "roughtime.int08h.com":2002 +Recieved time from server: midpoint="Mar 10 2018 21:35:52", radius=1000000 +``` + +The client binary is `target/release/client`. After building you can copy the +binary and run on its own (no `cargo` needed) if you wish. + +```bash +$ cp target/release/server /usr/local/bin +``` + ### Starting the Server ```bash @@ -59,9 +78,9 @@ Where: Use Ctrl-C or `kill` the process. -## Limitations +## Server Limitations -Roughtime features not implemented: +Roughtime features not implemented by the server: * On-line key rotation. The server must be restarted to generate a new delegated key. * Multi-request Merkle Tree batching. For now each request gets its own response @@ -87,6 +106,7 @@ created by Adam Langley and Robert Obryk. ## Contributors * Stuart Stock, original author and current maintainer (stuart {at} int08h.com) +* Aaron Hill, client implementation (aa1ronham {at} gmail.com) ## Copyright and License Roughenough is copyright (c) 2017-2018 int08h LLC. All rights reserved. |