Documentation/bup.1.md

   1 % bup(1) Bup %BUP_VERSION%
   2 % Avery Pennarun <apenwarr@gmail.com>
   3 % %BUP_DATE%
   4
   5 # NAME
   6
   7 bup - Backup program using rolling checksums and git file formats
   8
   9 # SYNOPSIS
  10
  11 bup \<command\> [options...]
  12
  13 # DESCRIPTION
  14
  15 `bup` is a program for making backups of your files using
  16 the git file format.
  17
  18 Unlike `git`(1) itself, bup is
  19 optimized for handling huge data sets including individual
  20 very large files (such a virtual machine images).  However,
  21 once a backup set is created, it can still be accessed
  22 using git tools.
  23
  24 The individual bup subcommands appear in their own man
  25 pages.
  26
  27 # COMMONLY USED SUBCOMMANDS
  28
  29 `bup-fsck`(1)
  30 :   Check backup sets for damage and add redundancy information
  31 `bup-ftp`(1)
  32 :   Browse backup sets using an ftp-like client
  33 `bup-fuse`(1)
  34 :   Mount your backup sets as a filesystem
  35 `bup-help`(1)
  36 :   Print detailed help for the given command
  37 `bup-index`(1)
  38 :   Create or display the index of files to back up
  39 `bup-join`(1)
  40 :   Retrieve a file backed up using `bup-split`(1)
  41 `bup-ls`(1)
  42 :   Browse the files in your backup sets
  43 `bup-midx`(1)
  44 :   Index objects to speed up future backups
  45 `bup-save`(1)
  46 :   Save files into a backup set (note: run "bup index" first)
  47 `bup-split`(1)
  48 :   Split a single file into its own backup set
  49
  50 # RARELY USED SUBCOMMANDS
  51
  52 `bup-damage`(1)
  53 :   Deliberately destroy data
  54 `bup-drecurse`(1)
  55 :   Recursively list files in your filesystem
  56 `bup-init`(1)
  57 :   Initialize a bup repository
  58 `bup-margin`(1)
  59 :   Determine how close your bup repository is to armageddon
  60 `bup-memtest`(1)
  61 :   Test bup memory usage statistics
  62 `bup-newliner`(1)
  63 :   Make sure progress messages don't overlap with output
  64 `bup-random`(1)
  65 :   Generate a stream of random output
  66 `bup-server`(1)
  67 :   The server side of the bup client-server relationship
  68 `bup-tick`(1)
  69 :   Wait for up to one second.
  70
  71 # SEE ALSO
  72
  73 `git`(1) and the *README* file from the bup distribution.
  74
  75 The home of bup is at <http://github.com/apenwarr/bup/>.