1restic backup(1)                                              restic backup(1)
2
3
4

NAME

6       restic-ls - List files in a snapshot
7
8
9

SYNOPSIS

11       restic ls [flags] [snapshotID] [dir...]
12
13
14

DESCRIPTION

16       The "ls" command lists files and directories in a snapshot.
17
18
19       The special snapshot ID "latest" can be used to list files and
20       directories of the latest snapshot in the repository. The --host flag
21       can be used in conjunction to select the latest snapshot originating
22       from a certain host only.
23
24
25       File listings can optionally be filtered by directories. Any positional
26       arguments after the snapshot ID are interpreted as absolute directory
27       paths, and only files inside those directories will be listed. If the
28       --recursive flag is used, then the filter will allow traversing into
29       matching directories' subfolders.  Any directory paths specified must
30       be absolute (starting with a path separator); paths use the forward
31       slash '/' as separator.
32
33
34

OPTIONS

36       -h, --help[=false]
37           help for ls
38
39
40       -H, --host=""
41           only consider snapshots for this host, when no snapshot ID is given
42
43
44       -l, --long[=false]
45           use a long listing format showing size and mode
46
47
48       --path=[]
49           only consider snapshots which include this (absolute) path, when no
50       snapshot ID is given
51
52
53       --recursive[=false]
54           include files in subfolders of the listed directories
55
56
57       --tag=[]
58           only consider snapshots which include this taglist, when no
59       snapshot ID is given
60
61
62

OPTIONS INHERITED FROM PARENT COMMANDS

64       --cacert=[]
65           file to load root certificates from (default: use system
66       certificates)
67
68
69       --cache-dir=""
70           set the cache directory. (default: use system default cache
71       directory)
72
73
74       --cleanup-cache[=false]
75           auto remove old cache directories
76
77
78       --json[=false]
79           set output mode to JSON for commands that support it
80
81
82       --key-hint=""
83           key ID of key to try decrypting first (default: $RESTIC_KEY_HINT)
84
85
86       --limit-download=0
87           limits downloads to a maximum rate in KiB/s. (default: unlimited)
88
89
90       --limit-upload=0
91           limits uploads to a maximum rate in KiB/s. (default: unlimited)
92
93
94       --no-cache[=false]
95           do not use a local cache
96
97
98       --no-lock[=false]
99           do not lock the repo, this allows some operations on read-only
100       repos
101
102
103       -o, --option=[]
104           set extended option (key=value, can be specified multiple times)
105
106
107       --password-command=""
108           specify a shell command to obtain a password (default:
109       $RESTIC_PASSWORD_COMMAND)
110
111
112       -p, --password-file=""
113           read the repository password from a file (default:
114       $RESTIC_PASSWORD_FILE)
115
116
117       -q, --quiet[=false]
118           do not output comprehensive progress report
119
120
121       -r, --repo=""
122           repository to backup to or restore from (default:
123       $RESTIC_REPOSITORY)
124
125
126       --tls-client-cert=""
127           path to a file containing PEM encoded TLS client certificate and
128       private key
129
130
131       -v, --verbose[=0]
132           be verbose (specify --verbose multiple times or level n)
133
134
135

SEE ALSO

137       restic(1)
138
139
140
141generated by `restic generate`     Jan 2017                   restic backup(1)