% bup-save(1) Bup 0.27 % Avery Pennarun apenwarr@gmail.com % 2015-04-26
bup-save - create a new bup backup set
bup save [-r host:path] \<-t|-c|-n name> [-#] [-f indexfile] [-v] [-q] [--smaller=maxsize] \<paths...>;
bup save
saves the contents of the given files or paths
into a new backup set and optionally names that backup set.
Note that in order to refer to your backup set later (i.e. for
restoration), you must either specify --name
(the normal case), or
record the tree or commit id printed by --tree
or --commit
.
Before trying to save files using bup save
, you should
first update the index using bup index
. The reasons
for separating the two steps are described in the man page
for bup-index
(1).
By default, metadata will be saved for every path, and the metadata
for any unindexed parent directories of indexed paths will be taken
directly from the filesystem. However, if --strip
, --strip-path
,
or --graft
is specified, metadata will not be saved for the root
directory (/). See bup-restore
(1) for more information about the
handling of metadata.
~/.ssh/config
file.$BUP_DIR/bupindex
.strips the path that is given from all files and directories.
A directory /root/chroot/etc saved with "bup save -n chroot --strip /root/chroot" would be saved as /etc. Note that currently, metadata will not be saved for the root directory (/) when this option is specified.
strips the given path prefix path-prefix from all files and directories.
A directory /root/chroot/webserver saved with "bup save -n webserver --strip-path=/root/chroot" would be saved as /webserver/etc. Note that currently, metadata will not be saved for the root directory (/) when this option is specified.
a graft point old_path=new_path (can be used more than once).
A directory /root/chroot/a/etc saved with "bup save -n chroot --graft /root/chroot/a=/chroot/a" would be saved as /chroot/a/etc. Note that currently, metadata will not be saved for the root directory (/) when this option is specified.
$ 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/
bup-index
(1), bup-split
(1), bup-on
(1),
bup-restore
(1), ssh_config
(5)
Part of the bup
(1) suite.