1restic backup(1) restic backup(1)
2
3
4
6 restic-stats - Scan the repository and show basic statistics
7
8
9
11 restic stats [flags] [snapshot ID] [...]
12
13
14
16 The "stats" command walks one or multiple snapshots in a repository and
17 accumulates statistics about the data stored therein. It reports on the
18 number of unique files and their sizes, according to one of the
19 counting modes as given by the --mode flag.
20
21
22 It operates on all snapshots matching the selection criteria or all
23 snapshots if nothing is specified. The special snapshot ID "latest" is
24 also supported. Some modes make more sense over just a single snapshot,
25 while others are useful across all snapshots, depending on what you are
26 trying to calculate.
27
28
29 The modes are:
30
31
32 · restore-size: (default) Counts the size of the restored files.
33
34 · files-by-contents: Counts total size of files, where a file is
35 considered unique if it has unique contents.
36
37 · raw-data: Counts the size of blobs in the repository,
38 regardless of how many files reference them.
39
40 · blobs-per-file: A combination of files-by-contents and
41 raw-data.
42
43
44
45 Refer to the online manual for more details about each mode.
46
47
48
50 Exit status is 0 if the command was successful, and non-zero if there
51 was any error.
52
53
54
56 -h, --help[=false]
57 help for stats
58
59
60 -H, --host=[]
61 only consider snapshots with the given host (can be specified
62 multiple times)
63
64
65 --mode="restore-size"
66 counting mode: restore-size (default), files-by-contents,
67 blobs-per-file or raw-data
68
69
70 --path=[]
71 only consider snapshots which include this (absolute) path (can be
72 specified multiple times)
73
74
75 --tag=[]
76 only consider snapshots which include this taglist in the format
77 tag[,tag,...] (can be specified multiple times)
78
79
80
82 --cacert=[]
83 file to load root certificates from (default: use system
84 certificates)
85
86
87 --cache-dir=""
88 set the cache directory. (default: use system default cache
89 directory)
90
91
92 --cleanup-cache[=false]
93 auto remove old cache directories
94
95
96 --json[=false]
97 set output mode to JSON for commands that support it
98
99
100 --key-hint=""
101 key ID of key to try decrypting first (default: $RESTIC_KEY_HINT)
102
103
104 --limit-download=0
105 limits downloads to a maximum rate in KiB/s. (default: unlimited)
106
107
108 --limit-upload=0
109 limits uploads to a maximum rate in KiB/s. (default: unlimited)
110
111
112 --no-cache[=false]
113 do not use a local cache
114
115
116 --no-lock[=false]
117 do not lock the repository, this allows some operations on
118 read-only repositories
119
120
121 -o, --option=[]
122 set extended option (key=value, can be specified multiple times)
123
124
125 --password-command=""
126 shell command to obtain the repository password from (default:
127 $RESTIC_PASSWORD_COMMAND)
128
129
130 -p, --password-file=""
131 file to read the repository password from (default:
132 $RESTIC_PASSWORD_FILE)
133
134
135 -q, --quiet[=false]
136 do not output comprehensive progress report
137
138
139 -r, --repo=""
140 repository to backup to or restore from (default:
141 $RESTIC_REPOSITORY)
142
143
144 --repository-file=""
145 file to read the repository location from (default:
146 $RESTIC_REPOSITORY_FILE)
147
148
149 --tls-client-cert=""
150 path to a file containing PEM encoded TLS client certificate and
151 private key
152
153
154 -v, --verbose[=0]
155 be verbose (specify multiple times or a level using --verbose=n,
156 max level/times is 3)
157
158
159
161 restic(1)
162
163
164
165generated by `restic generate` Jan 2017 restic backup(1)