Documentation/bup-ls.md

   1 % bup-ls(1) Bup %BUP_VERSION%
   2 % Avery Pennarun <apenwarr@gmail.com>
   3 % %BUP_DATE%
   4
   5 # NAME
   6
   7 bup-ls - list the contents of a bup repository
   8
   9 # SYNOPSIS
  10
  11 bup ls [-s] <paths...>
  12
  13 # DESCRIPTION
  14
  15 `bup ls` lists files and directories in your bup repository
  16 using the same directory hierarchy as they would have with
  17 `bup-fuse`(1).
  18
  19 The top level directory is the branch (corresponding to
  20 the `-n` option in `bup save`), the next level is the date
  21 of the backup, and subsequent levels correspond to files in
  22 the backup.
  23
  24 Once you have identified the file you want using `bup ls`,
  25 you can view its contents using `bup join` or `git show`.
  26
  27 # OPTIONS
  28
  29 -s, --hash
  30 :   show hash for each file/directory.
  31
  32
  33 # EXAMPLE
  34
  35     bup ls /myserver/latest/etc/profile
  36
  37 # SEE ALSO
  38
  39 `bup-join`(1), `bup-fuse`(1), `bup-ftp`(1), `bup-save`(1), `git-show`(1)
  40
  41 # BUP
  42
  43 Part of the `bup`(1) suite.