summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorStuart Stock <stuart@int08h.com>2018-03-10 16:09:45 -0600
committerStuart Stock <stuart@int08h.com>2018-03-10 16:09:45 -0600
commitafd7026bed14ae1f59da6e3e66fc61986bdca614 (patch)
tree0e7a3d7cc2f544a2c4ac3e2afdbdee31d59181f8 /README.md
parent6f996102f705848e45e07e9c183819ff68e89310 (diff)
downloadroughenough-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.md28
1 files changed, 24 insertions, 4 deletions
diff --git a/README.md b/README.md
index b4b5897..96404e6 100644
--- a/README.md
+++ b/README.md
@@ -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.