rdiff-backup-statistics (1) Linux Manual Page

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] 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 http://rdiff-backup.nongnu.org/FAQ.html#statistics.

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

Do not read statistics files older than time. By default, all statistics files will be read. time should be in the same format taken by –restore-as-of. (See TIME FORMATS in the rdiff-backup man page for details.)

–end-time time

Like –begin-time but exclude statistics files later than time.

–minimum-ratio ratio

Print all directories contributing more than the given ratio to the total. The default value is .05, or 5 percent.

–null-separator

Specify that the lines of the file_statistics file are separated by nulls (