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 --human-readable[=false] print sizes in human readable format
50 -l, --long[=false] use a long listing format showing size and mode
53 --path=[] only consider snapshots including this (absolute) path,
56 when snapshot ID "latest" is given (can be specified multiple times)
57 --recursive[=false] include files in subfolders of the listed di‐
60 rectories
61 --tag=[] only consider snapshots including tag[,tag,...], when
64 snapshot ID "latest" is given (can be specified multiple times)
65
69 --cacert=[] file to load root certificates from (default: use sys‐
70 tem certificates or $RESTIC_CACERT)
71 --cache-dir="" set the cache directory. (default: use system de‐
74 fault cache directory)
75 --cleanup-cache[=false] auto remove old cache directories
78 --compression=auto compression mode (only available for repository
81 format version 2), one of (auto|off|max) (default: $RESTIC_COMPRESSION)
82 --insecure-tls[=false] skip TLS certificate verification when con‐
85 necting to the repository (insecure)
86 --json[=false] set output mode to JSON for commands that support
89 it
90 --key-hint="" key ID of key to try decrypting first (default:
93 $RESTIC_KEY_HINT)
94 --limit-download=0 limits downloads to a maximum rate in KiB/s.
97 (default: unlimited)
98 --limit-upload=0 limits uploads to a maximum rate in KiB/s. (de‐
101 fault: unlimited)
102 --no-cache[=false] do not use a local cache
105 --no-lock[=false] do not lock the repository, this allows some op‐
108 erations on read-only repositories
109 -o, --option=[] set extended option (key=value, can be specified
112 multiple times)
113 --pack-size=0 set target pack size in MiB, created pack files may
116 be larger (default: $RESTIC_PACK_SIZE)
117 --password-command="" shell command to obtain the repository pass‐
120 word from (default: $RESTIC_PASSWORD_COMMAND)
121 -p, --password-file="" file to read the repository password from
124 (default: $RESTIC_PASSWORD_FILE)
125 -q, --quiet[=false] do not output comprehensive progress report
128 -r, --repo="" repository to backup to or restore from (default:
131 $RESTIC_REPOSITORY)
132 --repository-file="" file to read the repository location from
135 (default: $RESTIC_REPOSITORY_FILE)
136 --retry-lock=0s retry to lock the repository if it is already
139 locked, takes a value like 5m or 2h (default: no retries)
140 --tls-client-cert="" path to a file containing PEM encoded TLS
143 client certificate and private key (default: $RESTIC_TLS_CLIENT_CERT)
144 -v, --verbose[=0] be verbose (specify multiple times or a level
147 using --verbose=n``, max level/times is 2)
148
152 restic(1)
153generated by restic generate Jan 2017 restic backup(1)