1restic backup(1) restic backup(1)
2
6 restic-find - Find a file, a directory or restic IDs
7
11 restic find [flags] PATTERN...
12
16 The "find" command searches for files or directories in snapshots
17 stored in the repo. It can also be used to search for restic blobs or
18 trees for troubleshooting.
19
23 --blob[=false] pattern is a blob-ID
24 -h, --help[=false] help for find
27 -H, --host=[] only consider snapshots for this host (can be speci‐
30 fied multiple times)
31 --human-readable[=false] print sizes in human readable format
34 -i, --ignore-case[=false] ignore case for pattern
37 -l, --long[=false] use a long listing format showing size and mode
40 -N, --newest="" newest modification date/time
43 -O, --oldest="" oldest modification date/time
46 --pack[=false] pattern is a pack-ID
49 --path=[] only consider snapshots including this (absolute) path
52 (can be specified multiple times)
53 --show-pack-id[=false] display the pack-ID the blobs belong to
56 (with --blob or --tree)
57 -s, --snapshot=[] snapshot id to search in (can be given multiple
60 times)
61 --tag=[] only consider snapshots including tag[,tag,...] (can be
64 specified multiple times)
65 --tree[=false] pattern is a tree-ID
68
72 --cacert=[] file to load root certificates from (default: use sys‐
73 tem certificates or $RESTIC_CACERT)
74 --cache-dir="" set the cache directory. (default: use system de‐
77 fault cache directory)
78 --cleanup-cache[=false] auto remove old cache directories
81 --compression=auto compression mode (only available for repository
84 format version 2), one of (auto|off|max) (default: $RESTIC_COMPRESSION)
85 --insecure-tls[=false] skip TLS certificate verification when con‐
88 necting to the repository (insecure)
89 --json[=false] set output mode to JSON for commands that support
92 it
93 --key-hint="" key ID of key to try decrypting first (default:
96 $RESTIC_KEY_HINT)
97 --limit-download=0 limits downloads to a maximum rate in KiB/s.
100 (default: unlimited)
101 --limit-upload=0 limits uploads to a maximum rate in KiB/s. (de‐
104 fault: unlimited)
105 --no-cache[=false] do not use a local cache
108 --no-lock[=false] do not lock the repository, this allows some op‐
111 erations on read-only repositories
112 -o, --option=[] set extended option (key=value, can be specified
115 multiple times)
116 --pack-size=0 set target pack size in MiB, created pack files may
119 be larger (default: $RESTIC_PACK_SIZE)
120 --password-command="" shell command to obtain the repository pass‐
123 word from (default: $RESTIC_PASSWORD_COMMAND)
124 -p, --password-file="" file to read the repository password from
127 (default: $RESTIC_PASSWORD_FILE)
128 -q, --quiet[=false] do not output comprehensive progress report
131 -r, --repo="" repository to backup to or restore from (default:
134 $RESTIC_REPOSITORY)
135 --repository-file="" file to read the repository location from
138 (default: $RESTIC_REPOSITORY_FILE)
139 --retry-lock=0s retry to lock the repository if it is already
142 locked, takes a value like 5m or 2h (default: no retries)
143 --tls-client-cert="" path to a file containing PEM encoded TLS
146 client certificate and private key (default: $RESTIC_TLS_CLIENT_CERT)
147 -v, --verbose[=0] be verbose (specify multiple times or a level
150 using --verbose=n``, max level/times is 2)
151
155 restic find config.json
156 restic find --json "*.yml" "*.json"
157 restic find --json --blob 420f620f b46ebe8a ddd38656
158 restic find --show-pack-id --blob 420f620f
159 restic find --tree 577c2bc9 f81f2e22 a62827a9
160 restic find --pack 025c1d06
161 EXIT STATUS
163 ===========
164 Exit status is 0 if the command was successful, and non-zero if there was any error.
166
172 restic(1)
173generated by restic generate Jan 2017 restic backup(1)