Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

file 108 lines (74 sloc) 2.66 kb

% bup-restore(1) Bup %BUP_VERSION% % Avery Pennarun apenwarr@gmail.com % %BUP_DATE%

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.

Something went wrong with that request. Please try again.