bup-join(1) bup-join(1)
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 reposi-
tory.
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. The connection to the remote server is made
with SSH. If you’d like to specify which port, user or private
key to use for the SSH connection, we recommend you use the
~/.ssh/config file. Even though the data source is remote, a lo-
cal bup repository is still required.
EXAMPLES
# 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-cat-file, ssh_config(5)
BUP
Part of the bup(1) suite.
AUTHORS
Avery Pennarun ]8;;mailto:apenwarr@gmail.com\apenwarr@gmail.com]8;;\
Bup 0.33.7 2025-01-11 bup-join(1)
Generated by dwww version 1.16 on Sat Oct 3 05:36:29 CEST 2026.