.\" Automatically generated by Pandoc 1.17.2
.\"
.TH "bup\-join" "1" "2017\-04\-01" "Bup debian/0.29\-3" ""
.hy
.SH NAME
.PP
bup\-join \- concatenate files from a bup repository
.SH SYNOPSIS
.PP
bup join [\-r \f[I]host\f[]:\f[I]path\f[]] [refs or hashes...]
.SH DESCRIPTION
.PP
\f[C]bup\ join\f[] is roughly the opposite operation to
\f[C]bup\-split\f[](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[](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[]
reads them from stdin instead.
.SH OPTIONS
.TP
.B \-r, \-\-remote=\f[I]host\f[]:\f[I]path\f[]
Retrieves objects from the given remote repository instead of the local
one.
\f[I]path\f[] may be blank, in which case the default remote repository
is used.
The connection to the remote server is made with SSH.
If you\[aq]d like to specify which port, user or private key to use for
the SSH connection, we recommend you use the \f[C]~/.ssh/config\f[]
file.
Even though the data source is remote, a local bup repository is still
required.
.RS
.RE
.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~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\ \-
\f[]
.fi
.SH SEE ALSO
.PP
\f[C]bup\-split\f[](1), \f[C]bup\-save\f[](1), \f[C]bup\-cat\-file\f[],
\f[C]ssh_config\f[](5)
.SH BUP
.PP
Part of the \f[C]bup\f[](1) suite.
.SH AUTHORS
Avery Pennarun <apenwarr@gmail.com>.