aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorbnewbold <bnewbold@robocracy.org>2016-06-03 01:49:42 -0400
committerbnewbold <bnewbold@robocracy.org>2016-06-03 01:52:13 -0400
commit782863c5b290ee5d3e7a3518a761ee2f35e5ad45 (patch)
tree613453e8c3ee6ac8ec672726d33dca777b8a9ebf
parentf68ff03d06a489114989b501e7e82cba1525f99e (diff)
downloaducp-782863c5b290ee5d3e7a3518a761ee2f35e5ad45.tar.gz
ucp-782863c5b290ee5d3e7a3518a761ee2f35e5ad45.zip
update README: UDT not UTP, etc
-rw-r--r--README.md26
1 files changed, 18 insertions, 8 deletions
diff --git a/README.md b/README.md
index fd59a5f..d161ffe 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,10 @@
-# µcp/ucp: µTP copy (very remote file transfer)
+# ucp: UDT copy (very remote file transfer)
-This is basically a clone of SSH's scp command that uses the µTP (the Micro
-Transport Protocol) over UDP instead of passing data through the TCP SSH
-connection. SSH (and TCP) is used for authentication and setup, just like
-`mosh` does; the server-side ucp process is not a daemon and is not running
-continuously.
+This is basically a clone of SSH's scp command that uses the UDT (UDP Data
+Transport) over UDP instead of passing data through the TCP SSH connection. SSH
+(and TCP) is used for authentication and setup, just like `mosh` does; the
+server-side ucp process is not a daemon and is not running continuously.
The motivation for this tool is to get better bandwidth utilization over
high-latency links with mild packet loss, while remaining well-behaved netizen.
@@ -17,10 +16,21 @@ that. There is a bunch of overhead sending small files, so if you have a lot of
those and a high-latency link you should probably `tar` things up first. There
also isn't any compression, so you might want to `gzip` that tarball.
+### Status
+
+Circa June 2016, this is very much a work in progress; see TODO. Only
+getting/sending single files will ever work.
+
+Running with crypto enabled (the default) slows things to a drag. Without
+crypto, the tool is generally at least as fast as any other transfer tool (eg,
+faster than scp, bbcp, or UTP).
+
### Dependencies
-You need the Sodium (wrapper for NaCl) library and headers installed. On Linux,
-this is, eg, libsodium-dev.
+You need the Sodium (wrapper for NaCl) and UDT libraries and headers installed.
+On Linux, this is, eg, libsodium-dev and libudt-dev. Unfortunately, the version
+of libsodium from Debian Jessie won't work, you need the Stretch or newer
+version.
Uses sodiumoxide instead of rust-crypto because there aren't online docs for
rust-crypto, and AFAIK Sodium and NaCl have been reviewed and rust-crypto has