restic-find(1)

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]      pattern is a blob-ID
24
25
26       -h, --help[=false]      help for find
27
28
29       -H, --host=[]      only consider snapshots for this host (can be speci‐
30       fied multiple times)
31
32
33       -i, --ignore-case[=false]      ignore case for pattern
34
35
36       -l, --long[=false]      use a long listing format showing size and mode
37
38
39       -N, --newest=""      newest modification date/time
40
41
42       -O, --oldest=""      oldest modification date/time
43
44
45       --pack[=false]      pattern is a pack-ID
46
47
48       --path=[]      only consider snapshots including this  (absolute)  path
49       (can be specified multiple times)
50
51
52       --show-pack-id[=false]       display  the  pack-ID  the blobs belong to
53       (with --blob or --tree)
54
55
56       -s, --snapshot=[]      snapshot id to search in (can be given  multiple
57       times)
58
59
60       --tag=[]       only  consider snapshots including tag[,tag,...] (can be
61       specified multiple times)
62
63
64       --tree[=false]      pattern is a tree-ID
65
66
67

OPTIONS INHERITED FROM PARENT COMMANDS

69       --cacert=[]      file to load root certificates from (default: use sys‐
70       tem certificates)
71
72
73       --cache-dir=""       set  the cache directory. (default: use system de‐
74       fault cache directory)
75
76
77       --cleanup-cache[=false]      auto remove old cache directories
78
79
80       --compression=auto      compression mode (only available for repository
81       format version 2), one of (auto|off|max)
82
83
84       --insecure-tls[=false]      skip TLS certificate verification when con‐
85       necting to the repository (insecure)
86
87
88       --json[=false]      set output mode to JSON for commands  that  support
89       it
90
91
92       --key-hint=""       key  ID  of  key  to try decrypting first (default:
93       $RESTIC_KEY_HINT)
94
95
96       --limit-download=0      limits downloads to a maximum  rate  in  KiB/s.
97       (default: unlimited)
98
99
100       --limit-upload=0       limits  uploads to a maximum rate in KiB/s. (de‐
101       fault: unlimited)
102
103
104       --no-cache[=false]      do not use a local cache
105
106
107       --no-lock[=false]      do not lock the repository, this allows some op‐
108       erations on read-only repositories
109
110
111       -o,  --option=[]       set extended option (key=value, can be specified
112       multiple times)
113
114
115       --pack-size=0      set target pack size in MiB, created pack files  may
116       be larger (default: $RESTIC_PACK_SIZE)
117
118
119       --password-command=""      shell command to obtain the repository pass‐
120       word from (default: $RESTIC_PASSWORD_COMMAND)
121
122
123       -p, --password-file=""      file to read the repository  password  from
124       (default: $RESTIC_PASSWORD_FILE)
125
126
127       -q, --quiet[=false]      do not output comprehensive progress report
128
129
130       -r,  --repo=""       repository  to backup to or restore from (default:
131       $RESTIC_REPOSITORY)
132
133
134       --repository-file=""      file to read  the  repository  location  from
135       (default: $RESTIC_REPOSITORY_FILE)
136
137
138       --tls-client-cert=""       path  to  a  file containing PEM encoded TLS
139       client certificate and private key
140
141
142       -v, --verbose[=0]      be verbose (specify multiple times  or  a  level
143       using --verbose=n``, max level/times is 2)
144
145
146

EXAMPLE

148              restic find config.json
149              restic find --json "*.yml" "*.json"
150              restic find --json --blob 420f620f b46ebe8a ddd38656
151              restic find --show-pack-id --blob 420f620f
152              restic find --tree 577c2bc9 f81f2e22 a62827a9
153              restic find --pack 025c1d06
154
155              EXIT STATUS
156              ===========
157
158              Exit status is 0 if the command was successful, and non-zero if there was any error.
159
160
161
162
163

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

EXAMPLE

SEE ALSO