RDIFF-BACKUP-STATISTICS(1) | Rdiff-Backup-Statistics Manual 2.2.6 | RDIFF-BACKUP-STATISTICS(1) |
NAME¶
rdiff-backup-statistics - summarize rdiff-backup statistics files
SYNOPSIS¶
rdiff-backup-statistics [--begin-time time] [--end-time time] [--minimum-ratio ratio] [--null-separator] [--quiet] [-h|--help] [-V|--version] repository
DESCRIPTION¶
rdiff-backup-statistics reads the matching statistics files in a backup repository made by rdiff-backup and prints some summary statistics to the screen. It does not alter the repository in any way.
The required argument is the pathname of the root of an rdiff-backup repository. For instance, if you ran 'rdiff-backup in out', you could later run 'rdiff-backup-statistics out'.
The output has two parts. The first is simply an average of the all matching session_statistics files. The meaning of these fields is explained in the FAQ included in the package, and also at <https://rdiff-backup.net/FAQ.html#what_do_the_various_fields_mean_in_the_session_statistics_and_directory_statistics_files>
The second section lists some particularly significant files (including directories). These files are either contain a lot of data, take up increment space, or contain a lot of changed files. All the files that are above the minimum ratio (default 5%) will be listed.
If a file or directory is listed, its contributions are subtracted from its parent. That is why the percentage listed after a directory can be larger than the percentage of its parent. Without this, the root directory would always be the largest, and the output would be boring.
OPTIONS¶
--begin-time time
--end-time time
-h, --help
--minimum-ratio ratio
--null-separator
--quiet
-V, --version
BUGS¶
When aggregating multiple statistics files, some directories above (but close to) the minimum ratio may not be displayed. For this reason, you may want to set the minimum-ratio lower than need.
AUTHOR¶
Ben Escoto <ben@emerose.org>, based on original script by Dean Gaudet.
SEE ALSO¶
rdiff-backup(1), python(1). The rdiff-backup web page is at <https://rdiff-backup.net/>
July 2024 | rdiff-backup-statistics |