% bup-meta(1) Bup 0.27 % Rob Browning rlb@defaultvalue.org % 2015-04-26
bup-meta - create or extract a metadata archive
bup meta --create ~ [-R] [-v] [-q] [--no-symlinks] [--no-paths] [-f file] \<paths...>
bup meta --list ~ [-v] [-q] [-f file]
bup meta --extract ~ [-v] [-q] [--numeric-ids] [--no-symlinks] [-f file]
bup meta --start-extract ~ [-v] [-q] [--numeric-ids] [--no-symlinks] [-f file]
bup meta --finish-extract ~ [-v] [-q] [--numeric-ids] [-f file]
bup meta --edit ~ [--set-uid uid | --set-gid gid | --set-user user | --set-group group | ...] \<paths...>
bup meta
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.
See bup-restore
(1) for a description of the way ownership metadata
is restored.
--file
is specified.--file
is specified.--start-extract
followed by --finish-extract
. Read the archive from standard input
unless --file
is specified.--finish-extract
. 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 --finish-extract
should restore the
original tree. The archive will be read from standard input
unless --file
is specified.--start-extract
. The archive will be read from standard input
unless --file
is specified.--file
is specified.--create
.--extract
or --finish-extract
.--extract
or --start-extract
). This option is enabled by default.
Specify --no-symlinks
to disable it.--no-paths
to disable it.--edit
.--edit
.--edit
.--edit
.--edit
.--edit
.# 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
Hard links are not handled yet.
Part of the bup
(1) suite.