Provided by: bup_0.22a-1_amd64 bug

NAME

       bup-join - concatenate files from a bup repository

SYNOPSIS

       bup join [-r host:path] [refs or hashes...]

DESCRIPTION

       bup join  is  roughly  the opposite operation to bup-split(1).  You can use it to retrieve
       the contents of a file from a local or remote bup repository.

       The supplied list of refs or hashes can be in any format  accepted  by  git(1),  including
       branch names, commit ids, tree ids, or blob ids.

       If  no  refs  or  hashes  are  given  on  the command line, bup join reads them from stdin
       instead.

OPTIONS

       -r, —remote=host:path
              Retrieves objects from the given remote repository instead of the local one.   path
              may be blank, in which case the default remote repository is used.

EXAMPLE


             # split and then rejoin a file using its tree id
             TREE=$(tar -cvf - /etc | bup split -t)
             bup join $TREE | tar -tf -

             # make two backups, then get the second-most-recent.
             # mybackup~1 is git(1) notation for the second most
             # recent commit on the branch named mybackup.
             tar -cvf - /etc | bup split -n mybackup
             tar -cvf - /etc | bup split -n mybackup
             bup join mybackup~1 | tar -tf -

SEE ALSO

       bup-split(1), bup-save(1)

BUP

       Part of the bup(1) suite.

AUTHORS

       Avery Pennarun <apenwarr@gmail.com>.