SYNOPSIS

       rdiff-backup-statistics  [--begin-time time] [--end-time time] [--mini-
       mum-ratio ratio] [--null-separator] 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 for-
              mat 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 (\0).  The default is to assume that newlines separate.
              Use  this switch if rdiff-backup was run with the --null-separa-
              tor when making the given repository.

BUGS

Version 1.1.14                    August 2007                  RDIFF-BACKUP(1)