1restic backup(1) restic backup(1)
2
6 restic-ls - List files in a snapshot
7
11 restic ls [flags] snapshotID [dir...]
12
16 The "ls" command lists files and directories in a snapshot.
17 The special snapshot ID "latest" can be used to list files and directo‐
20 ries of the latest snapshot in the repository. The --host flag can be
21 used in conjunction to select the latest snapshot originating from a
22 certain host only.
23 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
36 Exit status is 0 if the command was successful, and non-zero if there
37 was any error.
38
42 -h, --help[=false] help for ls
43 -H, --host=[] only consider snapshots for this host, when snapshot
46 ID "latest" is given (can be specified multiple times)
47 -l, --long[=false] use a long listing format showing size and mode
50 --path=[] only consider snapshots which include this (absolute)
53 path, when snapshot ID "latest" is given (can be specified multiple
54 times)
55 --recursive[=false] include files in subfolders of the listed di‐
58 rectories
59 --tag=[] only consider snapshots which include this taglist, when
62 snapshot ID "latest" is given (can be specified multiple times)
63
67 --cacert=[] file to load root certificates from (default: use sys‐
68 tem certificates)
69 --cache-dir="" set the cache directory. (default: use system de‐
72 fault cache directory)
73 --cleanup-cache[=false] auto remove old cache directories
76 --compression=auto compression mode (only available for repository
79 format version 2), one of (auto|off|max)
80 --insecure-tls[=false] skip TLS certificate verification when con‐
83 necting to the repository (insecure)
84 --json[=false] set output mode to JSON for commands that support
87 it
88 --key-hint="" key ID of key to try decrypting first (default:
91 $RESTIC_KEY_HINT)
92 --limit-download=0 limits downloads to a maximum rate in KiB/s.
95 (default: unlimited)
96 --limit-upload=0 limits uploads to a maximum rate in KiB/s. (de‐
99 fault: unlimited)
100 --no-cache[=false] do not use a local cache
103 --no-lock[=false] do not lock the repository, this allows some op‐
106 erations on read-only repositories
107 -o, --option=[] set extended option (key=value, can be specified
110 multiple times)
111 --pack-size=0 set target pack size in MiB, created pack files may
114 be larger (default: $RESTIC_PACK_SIZE)
115 --password-command="" shell command to obtain the repository pass‐
118 word from (default: $RESTIC_PASSWORD_COMMAND)
119 -p, --password-file="" file to read the repository password from
122 (default: $RESTIC_PASSWORD_FILE)
123 -q, --quiet[=false] do not output comprehensive progress report
126 -r, --repo="" repository to backup to or restore from (default:
129 $RESTIC_REPOSITORY)
130 --repository-file="" file to read the repository location from
133 (default: $RESTIC_REPOSITORY_FILE)
134 --tls-client-cert="" path to a file containing PEM encoded TLS
137 client certificate and private key
138 -v, --verbose[=0] be verbose (specify multiple times or a level
141 using --verbose=n, max level/times is 3)
142
146 restic(1)
147generated by restic generate Jan 2017 restic backup(1)