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  actual  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 decoded and then re-encoded version.  When that matters, it
              should be possible (though awkward) to use --bupm on the parent directory 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>.