X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?p=bup.git;a=blobdiff_plain;f=Documentation%2Fbup-server.md;h=6f25f4c29bf163e8c3281a0979f1f31402c7b4d4;hp=a8c8a4c11d3086cd4af428f13c8de45ea2cc102b;hb=bf67f94dd4f4096de4eee07a7dc377d6c889a016;hpb=d05d9df50c50ac944c81338a274b775b9972100f diff --git a/Documentation/bup-server.md b/Documentation/bup-server.md index a8c8a4c..6f25f4c 100644 --- a/Documentation/bup-server.md +++ b/Documentation/bup-server.md @@ -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)