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

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

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       bup save [-r host:path] <-t|-c|-n name> [-#] [-f indexfile] [-v] [-q]
       [--smaller=maxsize] <paths...>;

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> bup save <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?> (<?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>)<?> <?><?><?><?> <?><?> <?><?><?><?><?> --name
       <?><?> <?><?><?><?> <?><?><?><?> (<?><?><?><?> <?><?><?><?><?>)<?>
       <?><?> <?><?><?><?><?> <?><?><?><?> (tree id) <?><?> <?><?><?><?><?>
       <?><?><?><?><?> (commit id) <?><?><?><?><?><?><?> <?><?><?><?> --tree
       <?><?> --commit <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> bup save<?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> bup index
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>.  <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> bup-index(1) <?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.  <?><?> <?><?><?>
       <?><?><?><?> <?><?><?> --strip<?> --strip-path<?> <?><?> --graft
       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> (/)
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?>.  <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> bup-restore(1)
       <?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -r, --remote=[user@]host:[path], --remote=URL
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?> SSH.  <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?> REMOTE OPTIONS <?><?> bup(1)
              <?><?><?><?><?><?> <?><?><?><?>.

       -t, --tree
              <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
              (git tree id) <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?>.

       -c, --commit
              <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> (git commit id) <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>.

       -n, --name=name
              <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?>
              <?><?><?> name <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?>.  <?><?><?> name <?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> name <?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>.
              (<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?>.)

       -d, --date=date
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?> (epoch)<?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       -f, --indexfile=indexfile
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
              $BUP_DIR/bupindex.

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

       -q, --quiet
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?>.

       --smaller=maxsize
              <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> maxsize
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> (<?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>)
              <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.  <?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?>*<?><?><?><?><?> <?><?>
              <?><?><?><?>*<?><?><?><?>*<?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> k<?> M <?><?>
              G <?><?><?><?><?><?><?> <?><?><?><?>.

       --bwlimit=bytes/sec
              <?><?><?> <?><?> bytes/sec <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.
              <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.
              <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?>*<?><?><?><?><?> <?><?>
              <?><?><?><?>*<?><?><?><?>*<?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> k<?> M <?><?>
              G <?><?><?><?><?><?><?> <?><?><?><?>.

       --strip
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              (<?><?><?> <?><?><?><?><?><?>).
              <?><?> <?><?><?><?><?><?><?><?><?> /root/chroot/etc <?><?>
              <?><?> "bup save -n chroot --strip /root/chroot" <?><?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> /etc
              <?><?><?><?><?> <?><?><?><?><?> <?><?>.  <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> (/) <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?>.

       --strip-path=path-prefix
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              path-prefix <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?>.
              <?><?> <?><?><?><?><?><?><?><?><?> /root/chroot/webserver/etc
              <?><?> <?><?> "bup save -n webserver --strip-path=/root/chroot
              /root/chroot/webserver/etc" <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> /webserver/etc
              <?><?><?><?><?> <?><?><?><?><?> <?><?>.  <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> (/) <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?>.

       --graft=old_path=new_path
              <?><?> <?><?><?><?> <?><?><?><?><?> old_path=new_path
              <?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?><?><?><?>
              <?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?>).
              <?><?> <?><?><?><?><?><?><?><?><?> /root/chroot/a/etc <?><?>
              <?><?> "bup save -n chroot --graft /root/chroot/a=/chroot/a"
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              /chroot/a/etc <?><?><?><?><?> <?><?><?><?><?> <?><?>.
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> (/) <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?>.

       -#, --compress=#
              <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> #
              <?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?><?> <?><?>
              <?> <?><?> <?><?> <?><?> <?> <?><?><?><?><?><?><?><?> <?><?><?>
              <?> <?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?>).
              <?><?><?><?><?><?><?> <?><?> <?><?><?> pack.compression <?><?>
              core.compression <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
              <?> (<?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?>)
              <?><?><?>.

<?><?><?><?><?><?><?> (SETTINGS)
       <?><?><?><?><?> bup save <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> bup.split.trees <?><?><?><?><?>
       <?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?><?><?> bup-config(5)
       <?><?> <?><?><?><?><?><?>).  <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> BUP_DIR <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> -d <?><?><?><?> bup
       save ... <?><?><?><?> -r<?> <?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> bup save -r ....

<?><?><?><?><?><?><?> (EXAMPLES)
              $ bup index -ux /etc
              Indexing: 1981, done.

              $ bup save -r myserver: -n my-pc-backup --bwlimit=50k /etc
              Reading index: 1981, done.
              Saving: 100.00% (998/998k, 1981/1981 files), done.



              $ ls /home/joe/chroot/httpd
              bin var

              $ bup index -ux /home/joe/chroot/httpd
              Indexing: 1337, done.

              $ bup save --strip -n joes-httpd-chroot /home/joe/chroot/httpd
              Reading index: 1337, done.
              Saving: 100.00% (998/998k, 1337/1337 files), done.

              $ bup ls joes-httpd-chroot/latest/
              bin/
              var/


              $ bup save --strip-path=/home/joe/chroot -n joes-chroot \
                   /home/joe/chroot/httpd
              Reading index: 1337, done.
              Saving: 100.00% (998/998k, 1337/1337 files), done.

              $ bup ls joes-chroot/latest/
              httpd/


              $ bup save --graft /home/joe/chroot/httpd=/http-chroot \
                   -n joe
                   /home/joe/chroot/httpd
              Reading index: 1337, done.
              Saving: 100.00% (998/998k, 1337/1337 files), done.

              $ bup ls joe/latest/
              http-chroot/

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       bup-index(1), bup-split(1), bup-on(1), bup-restore(1), ssh_config(5)

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

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Avery Pennarun <apenwarr@gmail.com>.

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