bup-meta(1)                 General Commands Manual                bup-meta(1)

<?><?><?> (NAME)
       bup-meta - <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (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 <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> (metadata) <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       (<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>) <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       bup-restore(1) <?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -c, --create
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> path<?><?><?> <?><?><?><?><?><?><?><?>.
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> --file
              <?><?><?><?> <?><?><?> <?><?><?><?>.

       -t, --list
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?>.  <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> --file <?><?><?><?> <?><?><?> <?><?><?><?>.

       -x, --extract
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>.  <?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> --start-extract <?> <?><?><?> --finish-extract
              <?><?> <?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> --file
              <?><?><?><?> <?><?><?> <?><?><?><?>.

       --start-extract
              <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?> --finish-extract <?><?><?><?><?><?><?><?>
              <?><?><?>.  <?><?> <?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?>.  <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?>
              <?><?><?> <?><?><?><?><?><?><?><?> --finish-extract <?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?>.  <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?> --file <?><?><?><?> <?><?><?>
              <?><?><?><?>.

       --finish-extract
              <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?>.  <?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?> --start-extract <?><?><?><?> <?><?><?>.
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?> --file <?><?><?><?> <?><?><?>
              <?><?><?><?>.

       --edit <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>.  <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?> --file <?><?><?><?> <?><?><?>
              <?><?><?><?>.

       -f, --file=filename
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> filename <?><?> <?><?><?><?><?> <?><?> <?><?> filename
              <?><?> <?><?><?> <?><?><?><?>.  <?><?><?> filename
              <?><?><?><?><?> "-" <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?>.

       -R, --recurse
              <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> --create.

       --xdev, --one-file-system
              <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> - <?><?><?><?><?> <?><?><?><?><?><?> tar
              <?> rsync<?> <?><?><?> <?><?><?><?> <?><?><?><?><?> (mount
              points) <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>.

       --numeric-ids
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              (<?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>) <?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> --extract <?><?> --finish-extract.

       --symlinks
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> (<?><?>
              <?><?><?><?> --extract <?><?> --start-extract).  <?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?>.  <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?> --no-symlinks <?><?> <?><?><?><?>
              <?><?><?><?>.

       --paths
              <?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?>.  <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?> --no-paths <?><?> <?><?><?><?> <?><?><?><?>.

       --set-uid=uid
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (uid)
              <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> uid <?><?>
              <?><?><?> --edit.

       --set-gid=gid
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> (gid)
              <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> gid <?><?>
              <?><?><?> --edit.

       --set-user=user
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              user <?><?> <?><?><?> --edit.

       --unset-user
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
              --edit.

       --set-group=group
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> group
              <?><?> <?><?><?> --edit.

       --unset-group
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
              --edit.

       -v, --verbose
              <?><?><?><?><?><?> <?><?><?><?><?> (<?><?><?><?><?><?><?><?>
              <?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?>).

       -q, --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) <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?> BUP
       <?><?><?><?> <?><?> <?><?><?><?><?><?> bup(1).

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Rob Browning <rlb@defaultvalue.org>.

Bup 0.34+                         2026-09-01                       bup-meta(1)