1restic backup(1) restic backup(1)
2
6 restic-stats - Scan the repository and show basic statistics
7
11 restic stats [flags] [snapshot ID] [...]
12
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 count‐
19 ing modes as given by the --mode flag.
20 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 The modes are:
30 • restore-size: (default) Counts the size of the restored files.
33 • files-by-contents: Counts total size of files, where a file is
35 considered unique if it has unique contents.
36 • raw-data: Counts the size of blobs in the repository, regard‐
38 less of how many files reference them.
39 • blobs-per-file: A combination of files-by-contents and
41 raw-data.
42 Refer to the online manual for more details about each mode.
46
50 Exit status is 0 if the command was successful, and non-zero if there
51 was any error.
52
56 -h, --help[=false] help for stats
57 -H, --host=[] only consider snapshots with the given host (can be
60 specified multiple times)
61 --mode="restore-size" counting mode: restore-size (default),
64 files-by-contents, blobs-per-file or raw-data
65 --path=[] only consider snapshots which include this (absolute)
68 path (can be specified multiple times)
69 --tag=[] only consider snapshots which include this taglist in the
72 format tag[,tag,...] (can be specified multiple times)
73
77 --cacert=[] file to load root certificates from (default: use sys‐
78 tem certificates)
79 --cache-dir="" set the cache directory. (default: use system de‐
82 fault cache directory)
83 --cleanup-cache[=false] auto remove old cache directories
86 --json[=false] set output mode to JSON for commands that support
89 it
90 --key-hint="" key ID of key to try decrypting first (default:
93 $RESTIC_KEY_HINT)
94 --limit-download=0 limits downloads to a maximum rate in KiB/s.
97 (default: unlimited)
98 --limit-upload=0 limits uploads to a maximum rate in KiB/s. (de‐
101 fault: unlimited)
102 --no-cache[=false] do not use a local cache
105 --no-lock[=false] do not lock the repository, this allows some op‐
108 erations on read-only repositories
109 -o, --option=[] set extended option (key=value, can be specified
112 multiple times)
113 --password-command="" shell command to obtain the repository pass‐
116 word from (default: $RESTIC_PASSWORD_COMMAND)
117 -p, --password-file="" file to read the repository password from
120 (default: $RESTIC_PASSWORD_FILE)
121 -q, --quiet[=false] do not output comprehensive progress report
124 -r, --repo="" repository to backup to or restore from (default:
127 $RESTIC_REPOSITORY)
128 --repository-file="" file to read the repository location from
131 (default: $RESTIC_REPOSITORY_FILE)
132 --tls-client-cert="" path to a file containing PEM encoded TLS
135 client certificate and private key
136 -v, --verbose[=0] be verbose (specify multiple times or a level
139 using --verbose=n, max level/times is 3)
140
144 restic(1)
145generated by restic generate Jan 2017 restic backup(1)