1bup-join(1)                                                        bup-join(1)
2
3
4

NAME

6       bup-join - concatenate files from a bup repository
7

SYNOPSIS

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

DESCRIPTION

12       bup join  is  roughly  the opposite operation to bup-split(1).  You can
13       use it to retrieve the contents of a file from a local  or  remote  bup
14       repository.
15
16       The  supplied  list  of refs or hashes can be in any format accepted by
17       git(1), including branch names, commit ids, tree ids, or blob ids.
18
19       If no refs or hashes are given on the command line, bup join reads them
20       from stdin instead.
21

OPTIONS

23       -r, --remote=host:path
24              Retrieves  objects  from  the given remote repository instead of
25              the local one.  path may be blank, in which case the default re‐
26              mote repository is used.  The connection to the remote server is
27              made with SSH.  If you'd like to specify  which  port,  user  or
28              private  key to use for the SSH connection, we recommend you use
29              the ~/.ssh/config file.  Even though the data source is  remote,
30              a local bup repository is still required.
31

EXAMPLES

33              # split and then rejoin a file using its tree id
34              TREE=$(tar -cvf - /etc | bup split -t)
35              bup join $TREE | tar -tf -
36
37              # make two backups, then get the second-most-recent.
38              # mybackup~1 is git(1) notation for the second most
39              # recent commit on the branch named mybackup.
40              tar -cvf - /etc | bup split -n mybackup
41              tar -cvf - /etc | bup split -n mybackup
42              bup join mybackup~1 | tar -tf -
43

SEE ALSO

45       bup-split(1), bup-save(1), bup-cat-file, ssh_config(5)
46

BUP

48       Part of the bup(1) suite.
49

AUTHORS

51       Avery Pennarun <apenwarr@gmail.com>.
52
53
54
55Bup 0.29.1                        2017-03-26                       bup-join(1)
Impressum