This file is indexed.

/usr/share/doc/bup/bup-meta.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
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
<!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-meta(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-meta(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-meta - create or extract a metadata archive</p>
<h1 id="synopsis">SYNOPSIS</h1>
<dl>
<dt>bup meta --create</dt>
<dd>[-R] [-v] [-q] [--no-symlinks] [--no-paths] [-f <em>file</em>] &lt;<em>paths</em>...&gt;
</dd>
<dt>bup meta --list</dt>
<dd>[-v] [-q] [-f <em>file</em>]
</dd>
<dt>bup meta --extract</dt>
<dd>[-v] [-q] [--numeric-ids] [--no-symlinks] [-f <em>file</em>]
</dd>
<dt>bup meta --start-extract</dt>
<dd>[-v] [-q] [--numeric-ids] [--no-symlinks] [-f <em>file</em>]
</dd>
<dt>bup meta --finish-extract</dt>
<dd>[-v] [-q] [--numeric-ids] [-f <em>file</em>]
</dd>
<dt>bup meta --edit</dt>
<dd>[--set-uid <em>uid</em> | --set-gid <em>gid</em> | --set-user <em>user</em> | --set-group <em>group</em> | ...] &lt;<em>paths</em>...&gt;
</dd>
</dl>
<h1 id="description">DESCRIPTION</h1>
<p><code>bup meta</code> creates, extracts, or otherwise manipulates metadata archives. A metadata archive contains the metadata information (timestamps, ownership, access permissions, etc.) for a set of filesystem paths.</p>
<p>See <code>bup-restore</code>(1) for a description of the way ownership metadata is restored.</p>
<h1 id="options">OPTIONS</h1>
<dl>
<dt>-c, --create</dt>
<dd>Create a metadata archive for the specified <em>path</em>s. Write the archive to standard output unless <code>--file</code> is specified.
</dd>
<dt>-t, --list</dt>
<dd>Display information about the metadata in an archive. Read the archive from standard input unless <code>--file</code> is specified.
</dd>
<dt>-x, --extract</dt>
<dd>Extract a metadata archive. Conceptually, perform <code>--start-extract</code> followed by <code>--finish-extract</code>. Read the archive from standard input unless <code>--file</code> is specified.
</dd>
<dt>--start-extract</dt>
<dd>Build a filesystem tree matching the paths stored in a metadata archive. By itself, this command does not produce a full restoration of the metadata. For a full restoration, this command must be followed by a call to <code>--finish-extract</code>. Once this command has finished, all of the normal files described by the metadata will exist and be empty. Restoring the data in those files, and then calling <code>--finish-extract</code> should restore the original tree. The archive will be read from standard input unless <code>--file</code> is specified.
</dd>
<dt>--finish-extract</dt>
<dd>Finish applying the metadata stored in an archive to the filesystem. Normally, this command should follow a call to <code>--start-extract</code>. The archive will be read from standard input unless <code>--file</code> is specified.
</dd>
<dt>--edit</dt>
<dd>Edit metadata archives. The result will be written to standard output unless <code>--file</code> is specified.
</dd>
<dt>-f, --file=<em>filename</em></dt>
<dd>Read the metadata archive from <em>filename</em> or write it to <em>filename</em> as appropriate. If <em>filename</em> is &quot;-&quot;, then read from standard input or write to standard output.
</dd>
<dt>-R, --recurse</dt>
<dd>Recursively descend into subdirectories during <code>--create</code>.
</dd>
<dt>--xdev, --one-file-system</dt>
<dd>don't cross filesystem boundaries -- though as with tar and rsync, the mount points themselves will still be handled.
</dd>
<dt>--numeric-ids</dt>
<dd>Apply numeric IDs (user, group, etc.) rather than names during <code>--extract</code> or <code>--finish-extract</code>.
</dd>
<dt>--symlinks</dt>
<dd>Record symbolic link targets when creating an archive, or restore symbolic links when extracting an archive (during <code>--extract</code> or <code>--start-extract</code>). This option is enabled by default. Specify <code>--no-symlinks</code> to disable it.
</dd>
<dt>--paths</dt>
<dd>Record pathnames when creating an archive. This option is enabled by default. Specify <code>--no-paths</code> to disable it.
</dd>
<dt>--set-uid=<em>uid</em></dt>
<dd>Set the metadata uid to the integer <em>uid</em> during <code>--edit</code>.
</dd>
<dt>--set-gid=<em>gid</em></dt>
<dd>Set the metadata gid to the integer <em>gid</em> during <code>--edit</code>.
</dd>
<dt>--set-user=<em>user</em></dt>
<dd>Set the metadata user to <em>user</em> during <code>--edit</code>.
</dd>
<dt>--unset-user</dt>
<dd>Remove the metadata user during <code>--edit</code>.
</dd>
<dt>--set-group=<em>group</em></dt>
<dd>Set the metadata user to <em>group</em> during <code>--edit</code>.
</dd>
<dt>--unset-group</dt>
<dd>Remove the metadata group during <code>--edit</code>.
</dd>
<dt>-v, --verbose</dt>
<dd>Be more verbose (can be used more than once).
</dd>
<dt>-q, --quiet</dt>
<dd>Be quiet.
</dd>
</dl>
<h1 id="examples">EXAMPLES</h1>
<pre><code># Create a metadata archive for /etc.
$ bup meta -cRf etc.meta /etc
bup: removing leading &quot;/&quot; from &quot;/etc&quot;

# Extract the etc.meta archive (files will be empty).
$ mkdir tmp &amp;&amp; cd tmp
$ bup meta -xf ../etc.meta
$ ls
etc

# Restore /etc completely.
$ mkdir tmp &amp;&amp; cd tmp
$ bup meta --start-extract -f ../etc.meta
...fill in all regular file contents using some other tool...
$ bup meta --finish-extract -f ../etc.meta

# Change user/uid to root.
$ bup meta --edit --set-uid 0 --set-user root \
    src.meta &gt; dest.meta</code></pre>
<h1 id="bugs">BUGS</h1>
<p>Hard links are not handled yet.</p>
<h1 id="bup">BUP</h1>
<p>Part of the <code>bup</code>(1) suite.</p>
</body>
</html>