.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "bup" "1" "0.33.2" "Bup 0.33.2" ""
.hy
.SH NAME
.PP
bup - Backup program using rolling checksums and git file formats
.SH SYNOPSIS
.PP
bup [global options\&...]
<command> [options\&...]
.SH DESCRIPTION
.PP
\f[V]bup\f[R] is a program for making backups of your files using the
git file format.
.PP
Unlike \f[V]git\f[R](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.
.PP
The individual bup subcommands appear in their own man pages.
.SH GLOBAL OPTIONS
.TP
--version
print bup\[cq]s version number.
Equivalent to \f[V]bup-version\f[R](1)
.TP
-d, --bup-dir=\f[I]BUP_DIR\f[R]
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 \f[V]\[ti]/.bup\f[R] location.
.SH COMMONLY USED SUBCOMMANDS
.TP
\f[V]bup-fsck\f[R](1)
Check backup sets for damage and add redundancy information
.TP
\f[V]bup-ftp\f[R](1)
Browse backup sets using an ftp-like client
.TP
\f[V]bup-fuse\f[R](1)
Mount your backup sets as a filesystem
.TP
\f[V]bup-help\f[R](1)
Print detailed help for the given command
.TP
\f[V]bup-index\f[R](1)
Create or display the index of files to back up
.TP
\f[V]bup-on\f[R](1)
Backup a remote machine to the local one
.TP
\f[V]bup-restore\f[R](1)
Extract files from a backup set
.TP
\f[V]bup-save\f[R](1)
Save files into a backup set (note: run \[lq]bup index\[rq] first)
.TP
\f[V]bup-web\f[R](1)
Launch a web server to examine backup sets
.SH RARELY USED SUBCOMMANDS
.TP
\f[V]bup-damage\f[R](1)
Deliberately destroy data
.TP
\f[V]bup-drecurse\f[R](1)
Recursively list files in your filesystem
.TP
\f[V]bup-init\f[R](1)
Initialize a bup repository
.TP
\f[V]bup-join\f[R](1)
Retrieve a file backed up using \f[V]bup-split\f[R](1)
.TP
\f[V]bup-ls\f[R](1)
Browse the files in your backup sets
.TP
\f[V]bup-margin\f[R](1)
Determine how close your bup repository is to armageddon
.TP
\f[V]bup-memtest\f[R](1)
Test bup memory usage statistics
.TP
\f[V]bup-midx\f[R](1)
Index objects to speed up future backups
.TP
\f[V]bup-newliner\f[R](1)
Make sure progress messages don\[cq]t overlap with output
.TP
\f[V]bup-random\f[R](1)
Generate a stream of random output
.TP
\f[V]bup-server\f[R](1)
The server side of the bup client-server relationship
.TP
\f[V]bup-split\f[R](1)
Split a single file into its own backup set
.TP
\f[V]bup-tick\f[R](1)
Wait for up to one second.
.TP
\f[V]bup-version\f[R](1)
Report the version number of your copy of bup.
.SH ENVIRONMENT
.TP
\f[V]BUP_ASSUME_GIT_VERSION_IS_FINE\f[R]
If set to \f[V]true\f[R], \f[V]yes\f[R], or \f[V]1\f[R], assume the
version of \f[V]git\f[R] in the path is acceptable.
.SH SEE ALSO
.PP
\f[V]git\f[R](1) and the \f[I]README\f[R] file from the bup
distribution.
.PP
The home of bup is at <http://github.com/bup/bup/>.
.SH AUTHORS
Avery Pennarun <apenwarr@gmail.com>.