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

OPTIONS INHERITED FROM PARENT COMMANDS

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

EXAMPLE

152              restic find config.json
153              restic find --json "*.yml" "*.json"
154              restic find --json --blob 420f620f b46ebe8a ddd38656
155              restic find --show-pack-id --blob 420f620f
156              restic find --tree 577c2bc9 f81f2e22 a62827a9
157              restic find --pack 025c1d06
158
159
160
161

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

EXAMPLE

SEE ALSO