Documentation/bup-join.md

   1 % bup-join(1) Bup %BUP_VERSION%
   2 % Avery Pennarun <apenwarr@gmail.com>
   3 % %BUP_DATE%
   4
   5 # NAME
   6
   7 bup-join - concatenate files from a bup repository
   8
   9 # SYNOPSIS
  10
  11 bup join [-r *host*:*path*] [refs or hashes...]
  12
  13 # DESCRIPTION
  14
  15 `bup join` is roughly the opposite operation to
  16 `bup-split`(1).  You can use it to retrieve the contents of
  17 a file from a local or remote bup repository.
  18
  19 The supplied list of refs or hashes can be in any format
  20 accepted by `git`(1), including branch names, commit ids,
  21 tree ids, or blob ids.
  22
  23 If no refs or hashes are given on the command line, `bup
  24 join` reads them from stdin instead.
  25
  26 # OPTIONS
  27
  28 -r, --remote=*host*:*path*
  29 :   Retrieves objects from the given remote repository
  30     instead of the local one. *path* may be blank, in which
  31     case the default remote repository is used.
  32
  33
  34 # EXAMPLE
  35
  36     # split and then rejoin a file using its tree id
  37     TREE=$(tar -cvf - /etc | bup split -t)
  38     bup join $TREE | tar -tf -
  39
  40     # make two backups, then get the second-most-recent.
  41     # mybackup~1 is git(1) notation for the second most
  42     # recent commit on the branch named mybackup.
  43     tar -cvf - /etc | bup split -n mybackup
  44     tar -cvf - /etc | bup split -n mybackup
  45     bup join mybackup~1 | tar -tf -
  46
  47 # SEE ALSO
  48
  49 `bup-split`(1), `bup-save`(1)
  50
  51 # BUP
  52
  53 Part of the `bup`(1) suite.