.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "bup" "1" "2021-02-06" "Bup 0.32" ""
.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[C]bup\f[R] is a program for making backups of your files using the
git file format.
.PP
Unlike \f[C]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[C]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[C]\[ti]/.bup\f[R] location.
.SH COMMONLY USED SUBCOMMANDS
.TP
\f[B]\f[CB]bup-fsck\f[B]\f[R](1)
Check backup sets for damage and add redundancy information
.TP
\f[B]\f[CB]bup-ftp\f[B]\f[R](1)
Browse backup sets using an ftp-like client
.TP
\f[B]\f[CB]bup-fuse\f[B]\f[R](1)
Mount your backup sets as a filesystem
.TP
\f[B]\f[CB]bup-help\f[B]\f[R](1)
Print detailed help for the given command
.TP
\f[B]\f[CB]bup-index\f[B]\f[R](1)
Create or display the index of files to back up
.TP
\f[B]\f[CB]bup-on\f[B]\f[R](1)
Backup a remote machine to the local one
.TP
\f[B]\f[CB]bup-restore\f[B]\f[R](1)
Extract files from a backup set
.TP
\f[B]\f[CB]bup-save\f[B]\f[R](1)
Save files into a backup set (note: run \[lq]bup index\[rq] first)
.TP
\f[B]\f[CB]bup-web\f[B]\f[R](1)
Launch a web server to examine backup sets
.SH RARELY USED SUBCOMMANDS
.TP
\f[B]\f[CB]bup-damage\f[B]\f[R](1)
Deliberately destroy data
.TP
\f[B]\f[CB]bup-drecurse\f[B]\f[R](1)
Recursively list files in your filesystem
.TP
\f[B]\f[CB]bup-init\f[B]\f[R](1)
Initialize a bup repository
.TP
\f[B]\f[CB]bup-join\f[B]\f[R](1)
Retrieve a file backed up using \f[C]bup-split\f[R](1)
.TP
\f[B]\f[CB]bup-ls\f[B]\f[R](1)
Browse the files in your backup sets
.TP
\f[B]\f[CB]bup-margin\f[B]\f[R](1)
Determine how close your bup repository is to armageddon
.TP
\f[B]\f[CB]bup-memtest\f[B]\f[R](1)
Test bup memory usage statistics
.TP
\f[B]\f[CB]bup-midx\f[B]\f[R](1)
Index objects to speed up future backups
.TP
\f[B]\f[CB]bup-newliner\f[B]\f[R](1)
Make sure progress messages don\[cq]t overlap with output
.TP
\f[B]\f[CB]bup-random\f[B]\f[R](1)
Generate a stream of random output
.TP
\f[B]\f[CB]bup-server\f[B]\f[R](1)
The server side of the bup client-server relationship
.TP
\f[B]\f[CB]bup-split\f[B]\f[R](1)
Split a single file into its own backup set
.TP
\f[B]\f[CB]bup-tick\f[B]\f[R](1)
Wait for up to one second.
.TP
\f[B]\f[CB]bup-version\f[B]\f[R](1)
Report the version number of your copy of bup.
.SH ENVIRONMENT
.TP
\f[B]\f[CB]BUP_ASSUME_GIT_VERSION_IS_FINE\f[B]\f[R]
If set to \f[C]true\f[R], \f[C]yes\f[R], or \f[C]1\f[R], assume the
version of \f[C]git\f[R] in the path is acceptable.
.SH SEE ALSO
.PP
\f[C]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>.