bup-join(1)                 General Commands Manual                bup-join(1)

<?><?><?> (NAME)
       bup-join - <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> bup

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       bup join [-r host:path] [refs or hashes...]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> bup join <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> bup-split(1) <?><?><?>.  <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> bup <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> ref<?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> git(1) <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> commit<?>
       <?><?><?><?><?><?><?><?><?> tree <?><?> <?><?><?><?><?><?><?><?><?>
       blob.

       <?><?><?> <?><?><?> ref <?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> bup join <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (stdin)
       <?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -r, --remote=[user@]host:[path], --remote=URL
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              SSH.  <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> REMOTE OPTIONS <?><?> bup(1) <?><?>
              <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
              # <?><?><?><?><?> <?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> tree <?><?>
              TREE=$(tar -cvf - /etc | bup split -t)
              bup join $TREE | tar -tf -

              # <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>.
              # <?><?><?><?><?> mybackup~1 <?><?><?><?><?><?><?><?><?><?><?> git(1) <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              # <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> 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
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?> bup(1).

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Avery Pennarun <apenwarr@gmail.com>.

Bup 0.34+                         2026-09-01                       bup-join(1)