/usr/share/doc/bup/bup-cat-file.html is in bup-doc 0.29-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="generator" content="pandoc" />
<meta name="author" content="Rob Browning rlb@defaultvalue.org" />
<meta name="date" content="2017-04-01" />
<title>bup-cat-file(1) Bup debian/0.29-3</title>
<style type="text/css">code{white-space: pre;}</style>
</head>
<body>
<div id="header">
<h1 class="title">bup-cat-file(1) Bup debian/0.29-3</h1>
<h2 class="author">Rob Browning <a href="mailto:rlb@defaultvalue.org">rlb@defaultvalue.org</a></h2>
<h3 class="date">2017-04-01</h3>
</div>
<h1 id="name">NAME</h1>
<p>bup-cat-file - extract archive content (low-level)</p>
<h1 id="synopsis">SYNOPSIS</h1>
<p>bup cat-file [--meta|--bupm] <<em>path</em>></p>
<h1 id="description">DESCRIPTION</h1>
<p><code>bup cat-file</code> extracts content associated with <em>path</em> from the archive and dumps it to standard output. If nothing special is requested, the actual data contained by <em>path</em> (which must be a regular file) will be dumped.</p>
<h1 id="options">OPTIONS</h1>
<dl>
<dt>--meta</dt>
<dd>retrieve the metadata entry associated with <em>path</em>. 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 <code>--bupm</code> on the parent directory and then find the relevant entry in the output.
</dd>
<dt>--bupm</dt>
<dd>retrieve the .bupm file associated with <em>path</em>, which must be a directory.
</dd>
</dl>
<h1 id="examples">EXAMPLES</h1>
<pre><code># 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 -</code></pre>
<h1 id="see-also">SEE ALSO</h1>
<p><code>bup-join</code>(1), <code>bup-meta</code>(1)</p>
<h1 id="bup">BUP</h1>
<p>Part of the <code>bup</code>(1) suite.</p>
</body>
</html>
|