iREADME - dedup - deduplicating backup program Err bitreich.org 70 hgit clone git://bitreich.org/dedup/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/dedup/ URL:git://bitreich.org/dedup/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/dedup/ bitreich.org 70 1Log /scm/dedup/log.gph bitreich.org 70 1Files /scm/dedup/files.gph bitreich.org 70 1Refs /scm/dedup/refs.gph bitreich.org 70 1Tags /scm/dedup/tag bitreich.org 70 1README /scm/dedup/file/README.gph bitreich.org 70 1LICENSE /scm/dedup/file/LICENSE.gph bitreich.org 70 i--- Err bitreich.org 70 iREADME (1519B) Err bitreich.org 70 i--- Err bitreich.org 70 i 1 What is it? Err bitreich.org 70 i 2 =========== Err bitreich.org 70 i 3 Err bitreich.org 70 i 4 dedup is a deduplicating backup program. Err bitreich.org 70 i 5 Err bitreich.org 70 i 6 Getting started Err bitreich.org 70 i 7 =============== Err bitreich.org 70 i 8 Err bitreich.org 70 i 9 To use dedup you have to first initialize a repository: Err bitreich.org 70 i 10 Err bitreich.org 70 i 11 dup-init repo Err bitreich.org 70 i 12 Err bitreich.org 70 i 13 dup-init(1) will create a storage file and an archive directory inside Err bitreich.org 70 i 14 the repository. The storage file contains all the unique blocks of Err bitreich.org 70 i 15 the repository. The archive directory contains all snapshots. Err bitreich.org 70 i 16 Err bitreich.org 70 i 17 dedup only handles a single file at a time, so using tar is advised. Err bitreich.org 70 i 18 To deduplicate a directory tree invoke dup-pack(1) as follows: Err bitreich.org 70 i 19 Err bitreich.org 70 i 20 tar -cf - ~/dir | dup-pack -r repo foo Err bitreich.org 70 i 21 Err bitreich.org 70 i 22 This will create a new snapshot called foo under repo/archive/. Err bitreich.org 70 i 23 Err bitreich.org 70 i 24 To extract the snapshot: Err bitreich.org 70 i 25 Err bitreich.org 70 i 26 dup-unpack -r repo foo | tar -xf - Err bitreich.org 70 i 27 Err bitreich.org 70 i 28 Encrypting a dedup repository Err bitreich.org 70 i 29 ============================= Err bitreich.org 70 i 30 Err bitreich.org 70 i 31 First a secret key has to be generated using dup-keygen(1). This is a Err bitreich.org 70 i 32 256-bit symmetric key. Err bitreich.org 70 i 33 Err bitreich.org 70 i 34 dup-keygen keyfile Err bitreich.org 70 i 35 Err bitreich.org 70 i 36 Initialize the repo and select XChaCha20-Poly1305 as the encryption Err bitreich.org 70 i 37 algorithm: Err bitreich.org 70 i 38 Err bitreich.org 70 i 39 dup-init -k keyfile -E XChaCha20-Poly1305 repo Err bitreich.org 70 i 40 Err bitreich.org 70 i 41 To create a snapshot named foo: Err bitreich.org 70 i 42 Err bitreich.org 70 i 43 tar -cf - ~/dir | dup-pack -k keyfile -r repo foo Err bitreich.org 70 i 44 Err bitreich.org 70 i 45 To extract the snapshot: Err bitreich.org 70 i 46 Err bitreich.org 70 i 47 dup-unpack -k keyfile -r repo foo | tar -xf - Err bitreich.org 70 i 48 Err bitreich.org 70 i 49 All tools require the -k option when operating on an encrypted dedup Err bitreich.org 70 i 50 repository. Err bitreich.org 70 i 51 Err bitreich.org 70 i 52 Portability Err bitreich.org 70 i 53 =========== Err bitreich.org 70 i 54 Err bitreich.org 70 i 55 dedup works on Linux, *BSD, macOS and possibly other UNIX-like systems. Err bitreich.org 70 i 56 Err bitreich.org 70 i 57 Dependencies Err bitreich.org 70 i 58 ============ Err bitreich.org 70 i 59 Err bitreich.org 70 i 60 - snappy Err bitreich.org 70 i 61 - liblz4 Err bitreich.org 70 i 62 - libsodium Err bitreich.org 70 i 63 Err bitreich.org 70 i 64 Contact Err bitreich.org 70 i 65 ======= Err bitreich.org 70 i 66 Err bitreich.org 70 i 67 You can reach us through irc.2f30.org/6697 at #2f30 or Err bitreich.org 70 i 68 irc.freenode.net/6697 at #bitreich-en. Err bitreich.org 70 .