FreeBSD Manual Pages
bup-meta(1) General Commands Manual bup-meta(1) NAME bup-meta - create or extract a metadata archive SYNOPSIS 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...> DESCRIPTION bup meta creates, extracts, or otherwise manipulates metadata archives. A metadata archive contains the metadata information (timestamps, own- ership, access permissions, etc.) for a set of filesystem paths. See bup-restore(1) for a description of the way ownership metadata is restored. OPTIONS -c, --create Create a metadata archive for the specified paths. Write the archive to standard output unless --file is specified. -t, --list Display information about the metadata in an archive. Read the archive from standard input unless --file is specified. -x, --extract Extract a metadata archive. Conceptually, perform --start-ex- tract followed by --finish-extract. Read the archive from stan- dard input unless --file is specified. --start-extract 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 com- mand must be followed by a call to --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 un- less --file is specified. --finish-extract Finish applying the metadata stored in an archive to the filesystem. Normally, this command should follow a call to --start-extract. The archive will be read from standard input unless --file is specified. --edit Edit metadata archives. The result will be written to standard output unless --file is specified. -f, --file=filename Read the metadata archive from filename or write it to filename as appropriate. If filename is "-", then read from standard in- put or write to standard output. -R, --recurse Recursively descend into subdirectories during --create. --xdev, --one-file-system don't cross filesystem boundaries - though as with tar and rsync, the mount points themselves will still be handled. --numeric-ids Apply numeric IDs (user, group, etc.) rather than names during --extract or --finish-extract. --symlinks Record symbolic link targets when creating an archive, or re- store symbolic links when extracting an archive (during --ex- tract or --start-extract). This option is enabled by default. Specify --no-symlinks to disable it. --paths Record pathnames when creating an archive. This option is en- abled by default. Specify --no-paths to disable it. --set-uid=uid Set the metadata uid to the integer uid during --edit. --set-gid=gid Set the metadata gid to the integer gid during --edit. --set-user=user Set the metadata user to user during --edit. --unset-user Remove the metadata user during --edit. --set-group=group Set the metadata user to group during --edit. --unset-group Remove the metadata group during --edit. -v, --verbose Be more verbose (can be used more than once). -q, --quiet Be quiet. EXAMPLES # 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 BUGS Hard links are not handled yet. BUP Part of the bup(1) suite. AUTHORS Rob Browning <rlb@defaultvalue.org> Bup 0.32 2021-01-09 bup-meta(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | BUGS | BUP | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=bup-meta&sektion=1&manpath=FreeBSD+Ports+15.0>