Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
bup-join(1)		    General Commands Manual		   bup-join(1)

NAME
       bup-join	- concatenate files from a bup repository

SYNOPSIS
       bup join	[-r host:path] [refs or	hashes...]

DESCRIPTION
       bup  join  is  roughly the opposite operation to	bup-split(1).  You can
       use it to retrieve the contents of a file from a	local  or  remote  bup
       repository.

       The  supplied  list  of refs or hashes can be in	any format accepted by
       git(1), including branch	names, commit ids, tree	ids, or	blob ids.

       If no refs or hashes are	given on the command line, bup join reads them
       from stdin instead.

OPTIONS
       -r, --remote=host:path
	      Retrieves	objects	from the given remote  repository  instead  of
	      the local	one.  path may be blank, in which case the default re-
	      mote repository is used.	The connection to the remote server is
	      made  with  SSH.	 If  you'd like	to specify which port, user or
	      private key to use for the SSH connection, we recommend you  use
	      the  ~/.ssh/config file.	Even though the	data source is remote,
	      a	local bup repository is	still required.

EXAMPLES
	      #	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 -

SEE ALSO
       bup-split(1), bup-save(1), bup-cat-file,	ssh_config(5)

BUP
       Part of the bup(1) suite.

AUTHORS
       Avery Pennarun <apenwarr@gmail.com>

Bup 0.32			  2021-01-09			   bup-join(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=bup-join&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help