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 raw-
41 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 for this host (can be speci‐
60 fied 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 including this (absolute) path
68 (can be specified multiple times)
69 --tag=[] only consider snapshots including tag[,tag,...] (can be
72 specified multiple times)
73
77 --cacert=[] file to load root certificates from (default: use sys‐
78 tem certificates or $RESTIC_CACERT)
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 --compression=auto compression mode (only available for repository
89 format version 2), one of (auto|off|max) (default: $RESTIC_COMPRESSION)
90 --insecure-tls[=false] skip TLS certificate verification when con‐
93 necting to the repository (insecure)
94 --json[=false] set output mode to JSON for commands that support
97 it
98 --key-hint="" key ID of key to try decrypting first (default:
101 $RESTIC_KEY_HINT)
102 --limit-download=0 limits downloads to a maximum rate in KiB/s.
105 (default: unlimited)
106 --limit-upload=0 limits uploads to a maximum rate in KiB/s. (de‐
109 fault: unlimited)
110 --no-cache[=false] do not use a local cache
113 --no-lock[=false] do not lock the repository, this allows some op‐
116 erations on read-only repositories
117 -o, --option=[] set extended option (key=value, can be specified
120 multiple times)
121 --pack-size=0 set target pack size in MiB, created pack files may
124 be larger (default: $RESTIC_PACK_SIZE)
125 --password-command="" shell command to obtain the repository pass‐
128 word from (default: $RESTIC_PASSWORD_COMMAND)
129 -p, --password-file="" file to read the repository password from
132 (default: $RESTIC_PASSWORD_FILE)
133 -q, --quiet[=false] do not output comprehensive progress report
136 -r, --repo="" repository to backup to or restore from (default:
139 $RESTIC_REPOSITORY)
140 --repository-file="" file to read the repository location from
143 (default: $RESTIC_REPOSITORY_FILE)
144 --retry-lock=0s retry to lock the repository if it is already
147 locked, takes a value like 5m or 2h (default: no retries)
148 --tls-client-cert="" path to a file containing PEM encoded TLS
151 client certificate and private key (default: $RESTIC_TLS_CLIENT_CERT)
152 -v, --verbose[=0] be verbose (specify multiple times or a level
155 using --verbose=n``, max level/times is 2)
156
160 restic(1)
161generated by restic generate Jan 2017 restic backup(1)