# SEE ALSO
-`bup-join`(1), `bup-fuse`(1), `bup-ls`(1), `bup-save`(1), `git-show`(1)
+`bup-fuse`(1), `bup-ls`(1), `bup-save`(1), `bup-restore`(1)
# BUP
# SEE ALSO
-`fuse`(7), `fusermount`(1), `bup-ls`(1), `bup-ftp`(1)
+`fuse`(7), `fusermount`(1), `bup-ls`(1), `bup-ftp`(1),
+`bup-restore`(1), `bup-web`(1)
# BUP
--- /dev/null
+% 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] <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.
# SEE ALSO
-`bup-index`(1), `bup-split`(1), `bup-on`(1)
+`bup-index`(1), `bup-split`(1), `bup-on`(1),
+`bup-restore`(1)
# BUP
# SEE ALSO
-`bup-fuse`(1), `bup-ls`(1), `bup-ftp`(1)
+`bup-fuse`(1), `bup-ls`(1), `bup-ftp`(1), `bup-restore`(1)
# BUP
: Create or display the index of files to back up
`bup-on`(1)
: Backup a remote machine to the local one
+`bup-restore`(1)
+: Extract files from a backup set
`bup-save`(1)
: Save files into a backup set (note: run "bup index" first)
`bup-web`(1)
Help with any of these problems, or others, is very welcome. Join the
mailing list (see below) if you'd like to help.
- - 'bup save' doesn't know about file metadata.
+ - 'bup save' and 'bup restore' don't know about file metadata.
That means we aren't saving file attributes, mtimes, ownership, hard
links, MacOS resource forks, etc. Clearly this needs to be improved.
- - There's no 'bup restore' yet.
-
- 'bup save' saves files in the standard git 'tree of blobs' format, so you
- could then "restore" the files using something like 'git checkout'. But
- that's a git command, not a bup command, so it's hard to explain and
- doesn't support retrieving objects from a remote bup server without first
- fetching and packing an entire (possibly huge) pack, which could be very
- slow. Also, like 'bup save', you would need extra features in order to
- properly restore file metadata. And files that bup has split into
- chunks will need to be recombined. Although there's no restore tool,
- 'bup fuse' does accomplish some of this already.
-
- 'bup index' is slower than it should be.
It's still rather fast: it can iterate through all the filenames on my
--- /dev/null
+#!/usr/bin/env python
+import sys, stat, time
+from bup import options, git, vfs
+from bup.helpers import *
+
+optspec = """
+bup restore [-C outdir] </branch/revision/path/to/dir ...>
+--
+C,outdir= change to given outdir before extracting files
+v,verbose increase log output (can be used more than once)
+q,quiet don't show progress meter
+"""
+
+total_restored = last_progress = 0
+
+
+def verbose1(s):
+ global last_progress
+ if opt.verbose >= 1:
+ print s
+ last_progress = 0
+
+
+def verbose2(s):
+ global last_progress
+ if opt.verbose >= 2:
+ print s
+ last_progress = 0
+
+
+def plog(s):
+ global last_progress
+ if opt.quiet:
+ return
+ now = time.time()
+ if now - last_progress > 0.2:
+ progress(s)
+ last_progress = now
+
+
+def do_node(top, n):
+ global total_restored
+ fullname = n.fullname(stop_at=top)
+ unlink(fullname)
+ if stat.S_ISDIR(n.mode):
+ verbose1('%s/' % fullname)
+ mkdirp(fullname)
+ elif stat.S_ISLNK(n.mode):
+ verbose2('%s@ -> %s' % (fullname, n.readlink()))
+ os.symlink(n.readlink(), fullname)
+ else:
+ verbose2(fullname)
+ outf = open(fullname, 'wb')
+ try:
+ for b in chunkyreader(n.open()):
+ outf.write(b)
+ finally:
+ outf.close()
+ total_restored += 1
+ plog('Restoring: %d\r' % total_restored)
+ for sub in n:
+ do_node(top, sub)
+
+
+handle_ctrl_c()
+
+o = options.Options('bup restore', optspec)
+(opt, flags, extra) = o.parse(sys.argv[1:])
+
+git.check_repo_or_die()
+top = vfs.RefList(None)
+
+if not extra:
+ o.fatal('must specify at least one filename to restore')
+
+if opt.outdir:
+ mkdirp(opt.outdir)
+ os.chdir(opt.outdir)
+
+ret = 0
+for d in extra:
+ path,name = os.path.split(d)
+ try:
+ n = top.lresolve(d)
+ except vfs.NodeError, e:
+ add_error(e)
+ continue
+ isdir = stat.S_ISDIR(n.mode)
+ if not name or name == '.':
+ # trailing slash: extract children to cwd
+ if not isdir:
+ add_error('%r: not a directory' % d)
+ else:
+ for sub in n:
+ do_node(n, sub)
+ else:
+ # no trailing slash: extract node and its children to cwd
+ do_node(n.parent, n)
+
+if not opt.quiet:
+ log('Restoring: %d, done.\n' % total_restored)
+
+if saved_errors:
+ log('WARNING: %d errors encountered while restoring.\n' % len(saved_errors))
+ sys.exit(1)
self._subs = None
def __cmp__(a, b):
- return cmp(a.name or None, b.name or None)
+ return cmp(a and a.name or None, b and b.name or None)
def __iter__(self):
return iter(self.subs())
- def fullname(self):
+ def fullname(self, stop_at=None):
"""Get this file's full path."""
- if self.parent:
- return os.path.join(self.parent.fullname(), self.name)
+ assert(self != stop_at) # would be the empty string; too weird
+ if self.parent and self.parent != stop_at:
+ return os.path.join(self.parent.fullname(stop_at=stop_at),
+ self.name)
else:
return self.name
help = 'Print detailed help for the given command',
index = 'Create or display the index of files to back up',
on = 'Backup a remote machine to the local one',
+ restore = 'Extract files from a backup set',
save = 'Save files into a backup set (note: run "bup index" first)',
web = 'Launch a web server to examine backup sets',
)
WVPASS [ "$n" -eq 0 ]
) || exit 1
+WVSTART "restore"
+rm -rf buprestore.tmp
+WVFAIL bup restore boink
+WVPASS bup restore -C buprestore.tmp "/master/latest/$TOP/$D"
+WVPASSEQ "$(ls buprestore.tmp)" "bupdata.tmp"
+rm -rf buprestore.tmp
+WVPASS bup restore -C buprestore.tmp "/master/latest/$TOP/$D/"
+WVPASS diff -ur $D/ buprestore.tmp/
+
WVSTART "ftp"
WVPASS bup ftp "cat /master/latest/$TOP/$D/b" >$D/b.new
WVPASS bup ftp "cat /master/latest/$TOP/$D/f" >$D/f.new
projects / bup.git / commitdiff