Documentation/bup-ls.1.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 in the same layout as they would appear with `bup-fuse`(1).
  17
  18 The top level directory is the branch (corresponding to
  19 the `-n` option in `bup save`), the next level is the date
  20 of the backup, and subsequent levels correspond to files in
  21 the backup.
  22
  23 Once you have identified the file you want using `bup ls`,
  24 you can view its contents using `bup join` or `git show`.
  25
  26 # OPTIONS
  27
  28 -s, --hash
  29 :   show hash for each file/directory.
  30
  31
  32 # EXAMPLE
  33
  34     bup ls /myserver/1999-01-01/etc/profile
  35
  36 # SEE ALSO
  37
  38 `bup-join`(1), `bup-fuse`(1), `bup-save`(1), `git-show`(1)
  39
  40 # BUP
  41
  42 Part of the `bup`(1) suite.