]> arthur.barton.de Git - bup.git/blobdiff - Documentation/bup-server.md
get: adjust for python 3 and test there
[bup.git] / Documentation / bup-server.md
index a8c8a4c11d3086cd4af428f13c8de45ea2cc102b..6f25f4c29bf163e8c3281a0979f1f31402c7b4d4 100644 (file)
@@ -19,6 +19,30 @@ server` to receive the transmitted objects.
 
 There is normally no reason to run `bup server` yourself.
 
+# MODES
+
+smart
+:   In this mode, the server checks each incoming object
+    against the idx files in its repository.  If any object
+    already exists, it tells the client about the idx file
+    it was found in, allowing the client to download that
+    idx and avoid sending duplicate data.  This is
+    `bup-server`'s default mode.
+
+dumb
+:   In this mode, the server will not check its local index
+    before writing an object.  To avoid writing duplicate
+    objects, the server will tell the client to download all
+    of its `.idx` files at the start of the session.  This
+    mode is useful on low powered server hardware (ie
+    router/slow NAS).
+
+# FILES
+
+$BUP_DIR/bup-dumb-server
+:   Activate dumb server mode, as discussed above.  This file is not created by
+    default in new repositories.
+
 # SEE ALSO
 
 `bup-save`(1), `bup-split`(1)