1 % bup-join(1) Bup %BUP_VERSION%
2 % Avery Pennarun <apenwarr@gmail.com>
7 bup-join - concatenate files from a bup repository
11 bup join [-r *host*:*path*] [refs or hashes...]
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.
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.
23 If no refs or hashes are given on the command line, `bup
24 join` reads them from stdin instead.
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.
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 -
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 -
49 `bup-split`(1), `bup-save`(1)
53 Part of the `bup`(1) suite.