User Manuals                                      RDIF-BACKUP(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]
     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 sessionstatistics files.  The meaning of
     these fields is explained in the FAQ included in  the  pack-
     age,         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 sub-
     tracted  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.




Version 1.2.1       Last change: August 2008                    1






User Manuals                                      RDIF-BACKUP(1)



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


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 , based on  original  script  by
     Dean Gaudet.


SEE ALSO
     rdiff-backup(1), python(1).  The rdiff-backup web page is at
     http:/rdiff-backup.nongnu.org/.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE 
    
     Availability         SUNWrdiff-backup
    
     Interface Stability  Volatile        
    

NOTES
     Source     for     rdiff-backup     is     available      on
     http:/opensolaris.org.







Version 1.2.1       Last change: August 2008                    2