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 including this (absolute) path,
53 when snapshot ID "latest" is given (can be specified multiple times)
54 --recursive[=false] include files in subfolders of the listed di‐
57 rectories
58 --tag=[] only consider snapshots including tag[,tag,...], when
61 snapshot ID "latest" is given (can be specified multiple times)
62
66 --cacert=[] file to load root certificates from (default: use sys‐
67 tem certificates)
68 --cache-dir="" set the cache directory. (default: use system de‐
71 fault cache directory)
72 --cleanup-cache[=false] auto remove old cache directories
75 --compression=auto compression mode (only available for repository
78 format version 2), one of (auto|off|max)
79 --insecure-tls[=false] skip TLS certificate verification when con‐
82 necting to the repository (insecure)
83 --json[=false] set output mode to JSON for commands that support
86 it
87 --key-hint="" key ID of key to try decrypting first (default:
90 $RESTIC_KEY_HINT)
91 --limit-download=0 limits downloads to a maximum rate in KiB/s.
94 (default: unlimited)
95 --limit-upload=0 limits uploads to a maximum rate in KiB/s. (de‐
98 fault: unlimited)
99 --no-cache[=false] do not use a local cache
102 --no-lock[=false] do not lock the repository, this allows some op‐
105 erations on read-only repositories
106 -o, --option=[] set extended option (key=value, can be specified
109 multiple times)
110 --pack-size=0 set target pack size in MiB, created pack files may
113 be larger (default: $RESTIC_PACK_SIZE)
114 --password-command="" shell command to obtain the repository pass‐
117 word from (default: $RESTIC_PASSWORD_COMMAND)
118 -p, --password-file="" file to read the repository password from
121 (default: $RESTIC_PASSWORD_FILE)
122 -q, --quiet[=false] do not output comprehensive progress report
125 -r, --repo="" repository to backup to or restore from (default:
128 $RESTIC_REPOSITORY)
129 --repository-file="" file to read the repository location from
132 (default: $RESTIC_REPOSITORY_FILE)
133 --tls-client-cert="" path to a file containing PEM encoded TLS
136 client certificate and private key
137 -v, --verbose[=0] be verbose (specify multiple times or a level
140 using --verbose=n``, max level/times is 2)
141
145 restic(1)
146generated by restic generate Jan 2017 restic backup(1)