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

NAME

6       restic-stats - Scan the repository and show basic statistics
7
8
9

SYNOPSIS

11       restic stats [flags] [snapshot ID] [...]
12
13
14

DESCRIPTION

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

EXIT STATUS

50       Exit status is 0 if the command was successful, and non-zero if there
51       was any error.
52
53
54

OPTIONS

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

OPTIONS INHERITED FROM PARENT COMMANDS

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

SEE ALSO

161       restic(1)
162
163
164
165generated by `restic generate`     Jan 2017                   restic backup(1)
Impressum