.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "bup-join" "1" "2021-02-06" "Bup 0.32" ""
.hy
.SH NAME
.PP
bup-join - concatenate files from a bup repository
.SH SYNOPSIS
.PP
bup join [-r \f[I]host\f[R]:\f[I]path\f[R]] [refs or hashes\&...]
.SH DESCRIPTION
.PP
\f[C]bup join\f[R] is roughly the opposite operation to
\f[C]bup-split\f[R](1).
You can use it to retrieve the contents of a file from a local or remote
bup repository.
.PP
The supplied list of refs or hashes can be in any format accepted by
\f[C]git\f[R](1), including branch names, commit ids, tree ids, or blob
ids.
.PP
If no refs or hashes are given on the command line, \f[C]bup join\f[R]
reads them from stdin instead.
.SH OPTIONS
.TP
-r, --remote=\f[I]host\f[R]:\f[I]path\f[R]
Retrieves objects from the given remote repository instead of the local
one.
\f[I]path\f[R] may be blank, in which case the default remote repository
is used.
The connection to the remote server is made with SSH.
If you\[cq]d like to specify which port, user or private key to use for
the SSH connection, we recommend you use the \f[C]\[ti]/.ssh/config\f[R]
file.
Even though the data source is remote, a local bup repository is still
required.
.SH EXAMPLES
.IP
.nf
\f[C]
# 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\[ti]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\[ti]1 | tar -tf -
\f[R]
.fi
.SH SEE ALSO
.PP
\f[C]bup-split\f[R](1), \f[C]bup-save\f[R](1), \f[C]bup-cat-file\f[R],
\f[C]ssh_config\f[R](5)
.SH BUP
.PP
Part of the \f[C]bup\f[R](1) suite.
.SH AUTHORS
Avery Pennarun <apenwarr@gmail.com>.