Documentation/bup-import-duplicity.md

   1 % bup-import-duplicity(1) Bup %BUP_VERSION%
   2 % Zoran Zaric <zz@zoranzaric.de>, Rob Browning <rlb@defaultvalue.org>
   3 % %BUP_DATE%
   4
   5 # NAME
   6
   7 bup-import-duplicity - import duplicity backups
   8
   9 # SYNOPSIS
  10
  11 bup import-duplicity [-n] \<source-url\> \<save-name\>
  12
  13 # DESCRIPTION
  14
  15 `bup import-duplicity` imports all of the duplicity backups at
  16 `source-url` into `bup` via `bup save -n save-name`.  The bup saves
  17 will have the same timestamps (via `bup save --date`) as the original
  18 backups.
  19
  20 Because this command operates by restoring each duplicity backup to a
  21 temporary directory, the extent to which the metadata is preserved
  22 will depend on the characteristics of the underlying filesystem,
  23 whether or not you run `import-duplicity` as root (or under
  24 `fakeroot`(1)), etc.
  25
  26 Note that this command will use [`mkdtemp`][mkdtemp] to create
  27 temporary directories, which means that it should respect any
  28 `TEMPDIR`, `TEMP`, or `TMP` environment variable settings.  Make sure
  29 that the relevant filesystem has enough space for the largest
  30 duplicity backup being imported.
  31
  32 Since all invocations of duplicity use a temporary `--archive-dir`,
  33 `import-duplicity` should not affect ~/.cache/duplicity.
  34
  35 # OPTIONS
  36
  37 -n,--dry-run
  38 :   don't do anything; just print out what would be done
  39
  40 # EXAMPLES
  41
  42     $ bup import-duplicity file:///duplicity/src/ legacy-duplicity
  43
  44 # BUP
  45
  46 Part of the `bup`(1) suite.
  47
  48 [mkdtemp]: https://docs.python.org/2/library/tempfile.html#tempfile.mkdtemp