Provided by: bup_0.22a-1_amd64 bug

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