man pages section 1: User Commands

Exit Print View

Updated: July 2014
 
 

rdiff-backup-statistics (1)

Name

rdiff-backup-statistics - backup statistics files

Synopsis

rdiff-backup-statistics  [--begin-time   time]   [--end-time
time]  [--minimum-ratio  ratio] [--null-separator] [--quiet]
repository

Description




User Manuals                                      RDIFF-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 session_statistics 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.3.3        Last change: March 2009                    1






User Manuals                                      RDIFF-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 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.


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.



ATTRIBUTES
     See  attributes(5)  for  descriptions   of   the   following
     attributes:

     +---------------+---------------------+
     |ATTRIBUTE TYPE |  ATTRIBUTE VALUE    |
     +---------------+---------------------+
     |Availability   | backup/rdiff-backup |
     +---------------+---------------------+
     |Stability      | Uncommitted         |
     +---------------+---------------------+
SEE ALSO
     rdiff-backup(1), python(1).  The rdiff-backup web page is at
     http://rdiff-backup.nongnu.org/.



NOTES
     This  software  was   built   from   source   available   at
     https://java.net/projects/solaris-userland.    The  original
     community source was downloaded from  http://download.savan-
     nah.gnu.org/releases/rdiff-backup/rdiff-backup-1.3.3.tar.gz



Version 1.3.3        Last change: March 2009                    2






User Manuals                                      RDIFF-BACKUP(1)



     Further  information about this software can be found on the
     open        source        community        website        at
     http://www.nongnu.org/rdiff-backup/.




















































Version 1.3.3        Last change: March 2009                    3