/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>] <<em>paths</em>...>
</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> | ...] <<em>paths</em>...>
</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 "-", 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 "/" from "/etc"
# Extract the etc.meta archive (files will be empty).
$ mkdir tmp && cd tmp
$ bup meta -xf ../etc.meta
$ ls
etc
# Restore /etc completely.
$ mkdir tmp && 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 > 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>
|