---
name: "rdiff-backup-statistics"
section: "1"
platform: "linux"
package: "rdiff-backup"
version: "2.2.6-3+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/rdiff-backup-statistics"
---

# rdiff-backup-statistics(1)

summarize rdiff-backup statistics files

## 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*

  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*.

- \-h, --help

  Output a short usage description and exit.

- \--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 ('\\0').  The default is to assume that newlines separate.  Use this switch if rdiff-backup was run with the **--null-separator** when making the given repository.

- \--quiet

  Suppress printing of the ‘`Processing statistics from session...`’ output lines.

- \-V, --version

  Output full path to command and version then exit.

## 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)](/rdiff-backup/1.md), [**python**(1)](/python/1.md). The rdiff-backup web page is at  \<https://rdiff-backup.net/\>