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

FreeBSD Manual Pages

  
 
  

home | help
bup-cat-file(1)		    General Commands Manual	       bup-cat-file(1)

NAME
       bup-cat-file - extract archive content (low-level)

SYNOPSIS
       bup cat-file [--meta|--bupm] <path>

DESCRIPTION
       bup cat-file extracts content associated	with path from the archive and
       dumps  it to standard output.  If nothing special is requested, the ac-
       tual data contained by path (which must be  a  regular  file)  will  be
       dumped.

OPTIONS
       --meta retrieve	the  metadata  entry  associated with path.  Note that
	      currently	this does not return  the  raw	bytes  for  the	 entry
	      recorded	in the relevant	.bupm in the archive, but rather a de-
	      coded and	then re-encoded	version.  When that matters, it	should
	      be possible (though awkward) to use --bupm on the	parent	direc-
	      tory and then find the relevant entry in the output.

       --bupm retrieve	the  .bupm  file associated with path, which must be a
	      directory.

EXAMPLES
	      #	Retrieve the content of	somefile.
	      $	bup cat-file /foo/latest/somefile > somefile-content

	      #	Examine	the metadata associated	with something.
	      $	bup cat-file --meta /foo/latest/something | bup	meta -tvvf -

	      #	Examine	the metadata for somedir, including the	items it contains.
	      $	bup cat-file --bupm /foo/latest/somedir	| bup meta -tvvf -

SEE ALSO
       bup-join(1), bup-meta(1)

BUP
       Part of the bup(1) suite.

AUTHORS
       Rob Browning <rlb@defaultvalue.org>

Bup 0.32			  2021-01-09		       bup-cat-file(1)

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

home | help