1bup-meta(1) bup-meta(1)
2
6 bup-meta - create or extract a metadata archive
7
9 bup meta --create
10 [-R] [-v] [-q] [--no-symlinks] [--no-paths] [-f file] <paths...>
11 bup meta --list
13 [-v] [-q] [-f file]
14 bup meta --extract
16 [-v] [-q] [--numeric-ids] [--no-symlinks] [-f file]
17 bup meta --start-extract
19 [-v] [-q] [--numeric-ids] [--no-symlinks] [-f file]
20 bup meta --finish-extract
22 [-v] [-q] [--numeric-ids] [-f file]
23 bup meta --edit
25 [--set-uid uid | --set-gid gid | --set-user user | --set-group
26 group | ...] <paths...>
27
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 See bup-restore(1) for a description of the way ownership metadata is
34 restored.
35
37 -c, --create
38 Create a metadata archive for the specified paths. Write the
39 archive to standard output unless --file is specified.
40 -t, --list
42 Display information about the metadata in an archive. Read the
43 archive from standard input unless --file is specified.
44 -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 --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 --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 --edit Edit metadata archives. The result will be written to standard
68 output unless --file is specified.
69 -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 -R, --recurse
76 Recursively descend into subdirectories during --create.
77 --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 --numeric-ids
83 Apply numeric IDs (user, group, etc.) rather than names during
84 --extract or --finish-extract.
85 --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 --paths
93 Record pathnames when creating an archive. This option is en‐
94 abled by default. Specify --no-paths to disable it.
95 --set-uid=uid
97 Set the metadata uid to the integer uid during --edit.
98 --set-gid=gid
100 Set the metadata gid to the integer gid during --edit.
101 --set-user=user
103 Set the metadata user to user during --edit.
104 --unset-user
106 Remove the metadata user during --edit.
107 --set-group=group
109 Set the metadata user to group during --edit.
110 --unset-group
112 Remove the metadata group during --edit.
113 -v, --verbose
115 Be more verbose (can be used more than once).
116 -q, --quiet
118 Be quiet.
119
121 # Create a metadata archive for /etc.
122 $ bup meta -cRf etc.meta /etc
123 bup: removing leading "/" from "/etc"
124 # 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 # 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 # Change user/uid to root.
138 $ bup meta --edit --set-uid 0 --set-user root \
139 src.meta > dest.meta
140
142 Hard links are not handled yet.
143
145 Part of the bup(1) suite.
146
148 Rob Browning <rlb@defaultvalue.org>.
149Bup 0.29.1 2017-03-26 bup-meta(1)