NAME¶
bup-restore - extract files from a backup set
SYNOPSIS¶
bup restore [--outdir=
outdir] [-v] [-q]
DESCRIPTION¶
bup restore extracts files from a backup set (created with
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:
- branch
- the name of the backup set to restore from; this
corresponds to the --name (-n) option to bup save.
- revision
- 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 revisions using bup ls /branch.
- /path/to/file
- the original absolute filesystem path to the file you want
to restore. For example, /etc/passwd.
Note: if the /path/to/file is a directory, bup restore will restore that
directory as well as recursively restoring all its contents.
If /path/to/file is a directory ending in a slash (ie. /path/to/dir/),
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 this works.
OPTIONS¶
- -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.
EXAMPLE¶
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
SEE ALSO¶
bup-save(1),
bup-ftp(1),
bup-fuse(1),
bup-web(1)
BUP¶
Part of the
bup(1) suite.
AUTHORS¶
Avery Pennarun <apenwarr@gmail.com>.
