.\" Automatically generated by Pandoc 3.1.3 .\" .\" Define V font for inline verbatim, using C font in formats .\" that render this, and otherwise B font. .ie "\f[CB]x\f[]"x" \{\ . ftr V B . ftr VI BI . ftr VB B . ftr VBI BI .\} .el \{\ . ftr V CR . ftr VI CI . ftr VB CB . ftr VBI CBI .\} .TH "bup-join" "1" "0.33.3" "Bup 0.33.3" "" .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[V]bup join\f[R] is roughly the opposite operation to \f[V]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[V]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[V]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[V]\[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[V]bup-split\f[R](1), \f[V]bup-save\f[R](1), \f[V]bup-cat-file\f[R], \f[V]ssh_config\f[R](5) .SH BUP .PP Part of the \f[V]bup\f[R](1) suite. .SH AUTHORS Avery Pennarun .