1bup-ls(1)                                                            bup-ls(1)
2
3
4

NAME

6       bup-ls - list the contents of a bup repository
7

SYNOPSIS

9       bup ls [OPTION...] <paths...>
10

DESCRIPTION

12       bup ls  lists  files  and  directories in your bup repository using the
13       same directory hierarchy as they would have with bup-fuse(1).
14
15       The top level directory contains the branch (corresponding  to  the  -n
16       option in bup save), the next level is the date of the backup, and sub‐
17       sequent levels correspond to files in the backup.
18
19       When bup ls is asked to output on a tty, and -l is  not  specified,  it
20       formats  the output in columns so it can list as much as possible in as
21       few lines as possible.  However, when -l is specified or bup  is  asked
22       to output to something other than a tty (say you pipe the output to an‐
23       other command, or you redirect it to a file), it will  print  one  file
24       name  per  line.   This makes the listing easier to parse with external
25       tools.
26
27       Note that bup ls doesn't show hidden files by default and one needs  to
28       use  the  -a option to show them.  Files are hidden when their name be‐
29       gins with a dot.  For example, on the topmost level, the special direc‐
30       tories named .commit and .tag are hidden directories.
31
32       Once  you  have identified the file you want using bup ls, you can view
33       its contents using bup join or git show.
34

OPTIONS

36       -s, --hash
37              show hash for each file/directory.
38
39       -a, --all
40              show hidden files.
41
42       -A, --almost-all
43              show hidden files, except “.” and “..”.
44
45       -d, --directory
46              show information about directories themselves, rather than their
47              contents, and don't follow symlinks.
48
49       -l     provide a detailed, long listing for each item.
50
51       -F, --classify
52              append  type indicator: dir/, symlink@, fifo|, socket=, and exe‐
53              cutable*.
54
55       --file-type
56              append type indicator: dir/, symlink@, fifo|, socket=.
57
58       --human-readable
59              print human readable file sizes (i.e. 3.9K, 4.7M).
60
61       --numeric-ids
62              display numeric IDs (user, group, etc.) rather than names.
63

EXAMPLES

65              bup ls /myserver/latest/etc/profile
66
67              bup ls -a /
68

SEE ALSO

70       bup-join(1), bup-fuse(1), bup-ftp(1), bup-save(1), git-show(1)
71

BUP

73       Part of the bup(1) suite.
74

AUTHORS

76       Avery Pennarun <apenwarr@gmail.com>.
77
78
79
80Bup 0.29.1                        2017-03-26                         bup-ls(1)
Impressum