bup(1) General Commands Manual bup(1)NAME
bup - Backup program using rolling checksums and git file formats
SYNOPSIS
bup [global options...] <command> [options...]
DESCRIPTION
bup is a program for making backups of your files using the git file format.
Unlike git(1) itself, bup is optimized for handling huge data sets including individual very large files (such a virtual machine images).
However, once a backup set is created, it can still be accessed using git tools.
The individual bup subcommands appear in their own man pages.
GLOBAL OPTIONS --version
print bup's version number. Equivalent to bup-version(1)-d, --bup-dir=BUP_DIR
use the given BUP_DIR parameter as the bup repository location, instead of reading it from the $BUP_DIR environment variable or
using the default ~/.bup location.
COMMONLY USED SUBCOMMANDS bup-fsck(1)
Check backup sets for damage and add redundancy information
bup-ftp(1)
Browse backup sets using an ftp-like client
bup-fuse(1)
Mount your backup sets as a filesystem
bup-help(1)
Print detailed help for the given command
bup-index(1)
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)
Launch a web server to examine backup sets
RARELY USED SUBCOMMANDS bup-damage(1)
Deliberately destroy data
bup-drecurse(1)
Recursively list files in your filesystem
bup-init(1)
Initialize a bup repository
bup-join(1)
Retrieve a file backed up using bup-split(1)bup-ls(1)
Browse the files in your backup sets
bup-margin(1)
Determine how close your bup repository is to armageddon
bup-memtest(1)
Test bup memory usage statistics
bup-midx(1)
Index objects to speed up future backups
bup-newliner(1)
Make sure progress messages don't overlap with output
bup-random(1)
Generate a stream of random output
bup-server(1)
The server side of the bup client-server relationship
bup-split(1)
Split a single file into its own backup set
bup-tick(1)
Wait for up to one second.
bup-version(1)
Report the version number of your copy of bup.
SEE ALSO git(1) and the README file from the bup distribution.
The home of bup is at <http://github.com/apenwarr/bup/>.
AUTHORS
Avery Pennarun <apenwarr@gmail.com>.
Bup unknown-bup(1)
Check Out this Related Man Page
bup-restore(1) General Commands Manual bup-restore(1)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 dis-
cover 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>.
Bup unknown-bup-restore(1)