bup-restore

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

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLE

SEE ALSO

BUP

AUTHORS