% bup-restore(1) Bup %BUP_VERSION% % Avery Pennarun email@example.com % %BUP_DATE%
bup-restore - extract files from a backup set
bup restore [--outdir=outdir] [-v] [-q]
bup restore extracts files from a backup set (created
bup-save(1)) to the local filesystem.
The specified paths are of the form /branch/revision/path/to/file. The components of the path are as follows:
: the name of the backup set to restore from; this
corresponds to the --name (-n) option to
: the revision of the backup set to restore. The
revision latest is always the most recent
backup on the given branch. You can discover other
bup ls /branch.
: the original absolute filesystem path to the file you
want to restore. For example,
Note: if the /path/to/file is a directory,
will restore that directory as well as recursively
restoring all its contents.
If /path/to/file is a directory ending in a slash (ie.
bup restore will restore the children of
that directory directly to the current directory (or the
--outdir). If the directory does not end in a slash,
the children will be restored to a subdirectory of the
current directory. See the EXAMPLES section to see how
-C, --outdir=outdir : create and change to directory outdir before extracting the files.
-v, --verbose : increase log output. Given once, prints every directory as it is restored; given twice, prints every file and directory.
-q, --quiet : don't show the progress meter. Normally, is stderr is a tty, a progress display is printed that shows the total number of files restored.
Create a simple test backup set:
$ bup index -u /etc $ bup save -n mybackup /etc/passwd /etc/profile
Restore just one file:
$ bup restore /mybackup/latest/etc/passwd Restoring: 1, done. $ ls -l passwd -rw-r--r-- 1 apenwarr apenwarr 1478 2010-09-08 03:06 passwd
Restore the whole directory (no trailing slash):
$ bup restore -C test1 /mybackup/latest/etc Restoring: 3, done. $ find test1 test1 test1/etc test1/etc/passwd test1/etc/profile
Restore the whole directory (trailing slash):
$ bup restore -C test2 /mybackup/latest/etc/ Restoring: 2, done. $ find test2 test2 test2/passwd test2/profile
Part of the