`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
-f, \--indexfile=*indexfile*
: use a different index filename instead of
- `~/.bup/bupindex`.
+ `$BUP_DIR/bupindex`.
-v, \--verbose
: increase verbosity (can be used more than once). With
over large ones (like virtual machine images) which
take longer. Then you can back up the large files
less frequently. Use a suffix like k, M, or G to
- specify multiples of 1024, 1024*1024, 1024*1024*1024
+ specify multiples of 1024, 1024\*1024, 1024\*1024\*1024
respectively.
\--bwlimit=*bytes/sec*
to the server. This is good for making your backups
not suck up all your network bandwidth. Use a suffix
like k, M, or G to specify multiples of 1024,
- 1024*1024, 1024*1024*1024 respectively.
+ 1024\*1024, 1024\*1024\*1024 respectively.
\--strip
: strips the path that is given from all files and directories.
: strips the given path prefix *path-prefix* from all
files and directories.
- A directory */root/chroots/webserver* saved with "bup save -n
- webserver \--strip-path=/root/chroots" would be saved as
- */webserver/etc*. Note that currently, metadata will not be saved
- for the root directory (*/*) when this option is specified.
+ A directory */root/chroot/webserver/etc* saved with "bup save -n
+ webserver \--strip-path=/root/chroot /root/chroot/webserver/etc"
+ would be saved as */webserver/etc*. Note that currently, metadata
+ will not be saved for the root directory (*/*) when this option is
+ specified.
\--graft=*old_path*=*new_path*
: a graft point *old_path*=*new_path* (can be used more than
once).
- A directory */root/chroot/a/etc* saved with "bup save -n chroots
- \--graft /root/chroot/a/etc=/chroots/a" would be saved as
- */chroots/a/etc*. Note that currently, metadata will not be saved
+ 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.
-*#*, \--compress=*#*
is 1 (fast, loose compression)
-# EXAMPLE
-
+# EXAMPLES
$ bup index -ux /etc
Indexing: 1981, done.
- $ ls /home/joe/chroots/httpd
+ $ ls /home/joe/chroot/httpd
bin var
- $ bup index -ux /home/joe/chroots/httpd
+ $ bup index -ux /home/joe/chroot/httpd
Indexing: 1337, done.
- $ bup save --strip -n joes-httpd-chroot /home/joe/chroots/httpd
+ $ bup save --strip -n joes-httpd-chroot /home/joe/chroot/httpd
Reading index: 1337, done.
Saving: 100.00% (998/998k, 1337/1337 files), done.
var/
- $ bup save --strip-path=/home/joe/chroots -n joes-chroots \
- /home/joe/chroots/httpd
+ $ 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-chroots/latest/
+ $ bup ls joes-chroot/latest/
httpd/
- $ bup save --graft /home/joe/chroots/httpd=/http-chroot \
+ $ bup save --graft /home/joe/chroot/httpd=/http-chroot \
-n joe
- /home/joe/chroots/httpd
+ /home/joe/chroot/httpd
Reading index: 1337, done.
Saving: 100.00% (998/998k, 1337/1337 files), done.