bup-cat-file(1) 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 cur-
rently 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 possi-
ble (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 di-
rectory.
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 ]8;;mailto:rlb@defaultvalue.org\rlb@defaultvalue.org]8;;\
Bup 0.33.7 2025-01-11 bup-cat-file(1)
Generated by dwww version 1.16 on Sat Oct 3 06:47:27 CEST 2026.