Poster of Linux kernelThe best gift for a Linux geek
bup-restore

bup-restore

Section: User Commands (1) Updated:
Local index Up
 

NAME

bup-restore - extract files from a backup set  

SYNOPSIS

bup restore [---outdir=outdir] [-v] [-q] <paths...>  

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>.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE
SEE ALSO
BUP
AUTHORS

This document was created by man2html, using the manual pages.
Time: 21:09:46 GMT, April 16, 2011