1bup-cat-file(1)                                                bup-cat-file(1)
2
3
4

NAME

6       bup-cat-file - extract archive content (low-level)
7

SYNOPSIS

9       bup cat-file [–meta|–bupm] <path>
10

DESCRIPTION

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

OPTIONS

18       --meta retrieve the metadata entry associated  with  path.   Note  that
19              currently  this  does  not  return  the  raw bytes for the entry
20              recorded in the relevant .bupm in the archive, but rather a  de‐
21              coded and then re-encoded version.  When that matters, it should
22              be possible (though awkward) to use --bupm on the parent  direc‐
23              tory and then find the relevant entry in the output.
24
25       --bupm retrieve  the  .bupm  file associated with path, which must be a
26              directory.
27

EXAMPLES

29              # Retrieve the content of somefile.
30              $ bup cat-file /foo/latest/somefile > somefile-content
31
32              # Examine the metadata associated with something.
33              $ bup cat-file --meta /foo/latest/something | bup meta -tvvf -
34
35              # Examine the metadata for somedir, including the items it contains.
36              $ bup cat-file --bupm /foo/latest/somedir | bup meta -tvvf -
37

SEE ALSO

39       bup-join(1), bup-meta(1)
40

BUP

42       Part of the bup(1) suite.
43

AUTHORS

45       Rob Browning <rlb@defaultvalue.org>.
46
47
48
49Bup 0.29.1                        2017-03-26                   bup-cat-file(1)