bup man page

bup — Backup program using rolling checksums and git file formats


bup [global options...] <command> [options...]


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

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

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

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


Avery Pennarun <apenwarr@gmail.com>.

Referenced By

bup-bloom(1), bup-cat-file(1), bup-daemon(1), bup-damage(1), bup-drecurse(1), bup-fsck(1), bup-ftp(1), bup-fuse(1), bup-help(1), bup-import-duplicity(1), bup-import-rdiff-backup(1), bup-import-rsnapshot(1), bup-index(1), bup-init(1), bup-join(1), bup-ls(1), bup-margin(1), bup-memtest(1), bup-meta(1), bup-midx(1), bup-mux(1), bup-newliner(1), bup-on(1), bup-random(1), bup-restore(1), bup-save(1), bup-server(1), bup-split(1), bup-tag(1), bup-tick(1), bup-web(1).

Explore man page connections for bup(1).

Bup 2015-04-26