1bup-meta(1)                                                        bup-meta(1)
2
3
4

NAME

6       bup-meta - create or extract a metadata archive
7

SYNOPSIS

9       bup meta --create
10              [-R] [-v] [-q] [--no-symlinks] [--no-paths] [-f file] <paths...>
11
12       bup meta --list
13              [-v] [-q] [-f file]
14
15       bup meta --extract
16              [-v] [-q] [--numeric-ids] [--no-symlinks] [-f file]
17
18       bup meta --start-extract
19              [-v] [-q] [--numeric-ids] [--no-symlinks] [-f file]
20
21       bup meta --finish-extract
22              [-v] [-q] [--numeric-ids] [-f file]
23
24       bup meta --edit
25              [--set-uid  uid  | --set-gid gid | --set-user user | --set-group
26              group | ...]  <paths...>
27

DESCRIPTION

29       bup meta creates, extracts, or otherwise manipulates metadata archives.
30       A  metadata archive contains the metadata information (timestamps, own‐
31       ership, access permissions, etc.) for a set of filesystem paths.
32
33       See bup-restore(1) for a description of the way ownership  metadata  is
34       restored.
35

OPTIONS

37       -c, --create
38              Create  a  metadata  archive for the specified paths.  Write the
39              archive to standard output unless --file is specified.
40
41       -t, --list
42              Display information about the metadata in an archive.  Read  the
43              archive from standard input unless --file is specified.
44
45       -x, --extract
46              Extract  a  metadata archive.  Conceptually, perform --start-ex‐
47              tract followed by --finish-extract.  Read the archive from stan‐
48              dard input unless --file is specified.
49
50       --start-extract
51              Build  a filesystem tree matching the paths stored in a metadata
52              archive.  By itself,  this  command  does  not  produce  a  full
53              restoration  of the metadata.  For a full restoration, this com‐
54              mand must be followed by a call to --finish-extract.  Once  this
55              command  has  finished, all of the normal files described by the
56              metadata will exist and be empty.  Restoring the data  in  those
57              files,  and  then  calling  --finish-extract  should restore the
58              original tree.  The archive will be read from standard input un‐
59              less --file is specified.
60
61       --finish-extract
62              Finish  applying  the  metadata  stored  in  an  archive  to the
63              filesystem.  Normally, this command  should  follow  a  call  to
64              --start-extract.   The  archive will be read from standard input
65              unless --file is specified.
66
67       --edit Edit metadata archives.  The result will be written to  standard
68              output unless --file is specified.
69
70       -f, --file=filename
71              Read  the metadata archive from filename or write it to filename
72              as appropriate.  If filename is “-”, then read from standard in‐
73              put or write to standard output.
74
75       -R, --recurse
76              Recursively descend into subdirectories during --create.
77
78       --xdev, --one-file-system
79              don't  cross  filesystem  boundaries  –  though  as with tar and
80              rsync, the mount points themselves will still be handled.
81
82       --numeric-ids
83              Apply numeric IDs (user, group, etc.) rather than  names  during
84              --extract or --finish-extract.
85
86       --symlinks
87              Record  symbolic  link  targets when creating an archive, or re‐
88              store symbolic links when extracting an  archive  (during  --ex‐
89              tract  or  --start-extract).  This option is enabled by default.
90              Specify --no-symlinks to disable it.
91
92       --paths
93              Record pathnames when creating an archive.  This option  is  en‐
94              abled by default.  Specify --no-paths to disable it.
95
96       --set-uid=uid
97              Set the metadata uid to the integer uid during --edit.
98
99       --set-gid=gid
100              Set the metadata gid to the integer gid during --edit.
101
102       --set-user=user
103              Set the metadata user to user during --edit.
104
105       --unset-user
106              Remove the metadata user during --edit.
107
108       --set-group=group
109              Set the metadata user to group during --edit.
110
111       --unset-group
112              Remove the metadata group during --edit.
113
114       -v, --verbose
115              Be more verbose (can be used more than once).
116
117       -q, --quiet
118              Be quiet.
119

EXAMPLES

121              # Create a metadata archive for /etc.
122              $ bup meta -cRf etc.meta /etc
123              bup: removing leading "/" from "/etc"
124
125              # Extract the etc.meta archive (files will be empty).
126              $ mkdir tmp && cd tmp
127              $ bup meta -xf ../etc.meta
128              $ ls
129              etc
130
131              # Restore /etc completely.
132              $ mkdir tmp && cd tmp
133              $ bup meta --start-extract -f ../etc.meta
134              ...fill in all regular file contents using some other tool...
135              $ bup meta --finish-extract -f ../etc.meta
136
137              # Change user/uid to root.
138              $ bup meta --edit --set-uid 0 --set-user root \
139                  src.meta > dest.meta
140

BUGS

142       Hard links are not handled yet.
143

BUP

145       Part of the bup(1) suite.
146

AUTHORS

148       Rob Browning <rlb@defaultvalue.org>.
149
150
151
152Bup 0.29.2                        2018-10-20                       bup-meta(1)
Impressum