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

NAME

6       restic-find - Find a file, a directory or restic IDs
7
8
9

SYNOPSIS

11       restic find [flags] PATTERN...
12
13
14

DESCRIPTION

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
20
21

OPTIONS

23       --blob[=false]
24           pattern is a blob-ID
25
26
27       -h, --help[=false]
28           help for find
29
30
31       -H, --host=[]
32           only consider snapshots for this host, when no snapshot ID is given
33       (can be specified multiple times)
34
35
36       -i, --ignore-case[=false]
37           ignore case for pattern
38
39
40       -l, --long[=false]
41           use a long listing format showing size and mode
42
43
44       -N, --newest=""
45           newest modification date/time
46
47
48       -O, --oldest=""
49           oldest modification date/time
50
51
52       --pack[=false]
53           pattern is a pack-ID
54
55
56       --path=[]
57           only consider snapshots which include this (absolute) path, when no
58       snapshot-ID is given
59
60
61       --show-pack-id[=false]
62           display the pack-ID the blobs belong to (with --blob or --tree)
63
64
65       -s, --snapshot=[]
66           snapshot id to search in (can be given multiple times)
67
68
69       --tag=[]
70           only consider snapshots which include this taglist, when no
71       snapshot-ID is given
72
73
74       --tree[=false]
75           pattern is a tree-ID
76
77
78

OPTIONS INHERITED FROM PARENT COMMANDS

80       --cacert=[]
81           file to load root certificates from (default: use system
82       certificates)
83
84
85       --cache-dir=""
86           set the cache directory. (default: use system default cache
87       directory)
88
89
90       --cleanup-cache[=false]
91           auto remove old cache directories
92
93
94       --json[=false]
95           set output mode to JSON for commands that support it
96
97
98       --key-hint=""
99           key ID of key to try decrypting first (default: $RESTIC_KEY_HINT)
100
101
102       --limit-download=0
103           limits downloads to a maximum rate in KiB/s. (default: unlimited)
104
105
106       --limit-upload=0
107           limits uploads to a maximum rate in KiB/s. (default: unlimited)
108
109
110       --no-cache[=false]
111           do not use a local cache
112
113
114       --no-lock[=false]
115           do not lock the repository, this allows some operations on
116       read-only repositories
117
118
119       -o, --option=[]
120           set extended option (key=value, can be specified multiple times)
121
122
123       --password-command=""
124           shell command to obtain the repository password from (default:
125       $RESTIC_PASSWORD_COMMAND)
126
127
128       -p, --password-file=""
129           file to read the repository password from (default:
130       $RESTIC_PASSWORD_FILE)
131
132
133       -q, --quiet[=false]
134           do not output comprehensive progress report
135
136
137       -r, --repo=""
138           repository to backup to or restore from (default:
139       $RESTIC_REPOSITORY)
140
141
142       --repository-file=""
143           file to read the repository location from (default:
144       $RESTIC_REPOSITORY_FILE)
145
146
147       --tls-client-cert=""
148           path to a file containing PEM encoded TLS client certificate and
149       private key
150
151
152       -v, --verbose[=0]
153           be verbose (specify multiple times or a level using --verbose=n,
154       max level/times is 3)
155
156
157

EXAMPLE

159              restic find config.json
160              restic find --json "*.yml" "*.json"
161              restic find --json --blob 420f620f b46ebe8a ddd38656
162              restic find --show-pack-id --blob 420f620f
163              restic find --tree 577c2bc9 f81f2e22 a62827a9
164              restic find --pack 025c1d06
165
166              EXIT STATUS
167              ===========
168
169              Exit status is 0 if the command was successful, and non-zero if there was any error.
170
171
172
173
174

SEE ALSO

176       restic(1)
177
178
179
180generated by `restic generate`     Jan 2017                   restic backup(1)
Impressum