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, when no snap‐
30       shot ID is given (can be specified 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 which  include  this  (absolute)
49       path, when no snapshot-ID is given
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 which include this taglist, when
61       no snapshot-ID is given
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       --json[=false]      set output mode to JSON for commands  that  support
81       it
82
83
84       --key-hint=""       key  ID  of  key  to try decrypting first (default:
85       $RESTIC_KEY_HINT)
86
87
88       --limit-download=0      limits downloads to a maximum  rate  in  KiB/s.
89       (default: unlimited)
90
91
92       --limit-upload=0       limits  uploads to a maximum rate in KiB/s. (de‐
93       fault: unlimited)
94
95
96       --no-cache[=false]      do not use a local cache
97
98
99       --no-lock[=false]      do not lock the repository, this allows some op‐
100       erations on read-only repositories
101
102
103       -o,  --option=[]       set extended option (key=value, can be specified
104       multiple times)
105
106
107       --password-command=""      shell command to obtain the repository pass‐
108       word from (default: $RESTIC_PASSWORD_COMMAND)
109
110
111       -p,  --password-file=""       file to read the repository password from
112       (default: $RESTIC_PASSWORD_FILE)
113
114
115       -q, --quiet[=false]      do not output comprehensive progress report
116
117
118       -r, --repo=""      repository to backup to or  restore  from  (default:
119       $RESTIC_REPOSITORY)
120
121
122       --repository-file=""       file  to  read  the repository location from
123       (default: $RESTIC_REPOSITORY_FILE)
124
125
126       --tls-client-cert=""      path to a file  containing  PEM  encoded  TLS
127       client certificate and private key
128
129
130       -v,  --verbose[=0]       be  verbose (specify multiple times or a level
131       using --verbose=n, max level/times is 3)
132
133
134

EXAMPLE

136              restic find config.json
137              restic find --json "*.yml" "*.json"
138              restic find --json --blob 420f620f b46ebe8a ddd38656
139              restic find --show-pack-id --blob 420f620f
140              restic find --tree 577c2bc9 f81f2e22 a62827a9
141              restic find --pack 025c1d06
142
143              EXIT STATUS
144              ===========
145
146              Exit status is 0 if the command was successful, and non-zero if there was any error.
147
148
149
150
151

SEE ALSO

153       restic(1)
154
155
156
157generated by restic generate       Jan 2017                   restic backup(1)