.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "bup\-join" "1" "2026\-09\-01" "Bup 0.34+"
.SH NAME
bup\-join \- concatenate files from a bup repository
.SH SYNOPSIS
bup join [\-r \f[I]host\f[R]:\f[I]path\f[R]] [refs or hashes\&...]
.SH DESCRIPTION
\f[CR]bup join\f[R] is roughly the opposite operation to
\f[CR]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[CR]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[CR]bup join\f[R]
reads them from stdin instead.
.SH OPTIONS
.TP
\-r, \-\-remote=[\f[I]user\f[R]\(at]\f[I]host\f[R]:[\f[I]path\f[R]], \-\-remote=URL
retrieve the data from the specified remote repository, by default via
SSH.
See bup(1) REMOTE OPTIONS for further information.
.SH EXAMPLES
.IP
.EX
# 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\(ti1 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\(ti1 | tar \-tf \-
.EE
.SH SEE ALSO
\f[CR]bup\-split\f[R](1), \f[CR]bup\-save\f[R](1),
\f[CR]bup\-cat\-file\f[R], \f[CR]ssh_config\f[R](5)
.SH BUP
Part of the \f[CR]bup\f[R](1) suite.
.SH AUTHORS
Avery Pennarun \c
.MT apenwarr@gmail.com
.ME \c.