restic backup(1)                                              restic backup(1)



NNAAMMEE
       restic-stats - Scan the repository and show basic statistics



SSYYNNOOPPSSIISS
       rreessttiicc ssttaattss [[ffllaaggss]] [[ssnnaappsshhoott IIDD]] [[......]]



DDEESSCCRRIIPPTTIIOONN
       The "stats" command walks one or multiple snapshots in a repository and
       accumulates statistics about the data stored therein. It reports on the
       number  of unique files and their sizes, according to one of the count‐
       ing modes as given by the --mode flag.


       It operates on all snapshots matching the  selection  criteria  or  all
       snapshots  if nothing is specified. The special snapshot ID "latest" is
       also supported. Some modes make more sense over just a single snapshot,
       while others are useful across all snapshots, depending on what you are
       trying to calculate.


       The modes are:


              · restore-size: (default) Counts the size of the restored files.

              · files-by-contents: Counts total size of files, where a file is
                considered unique if it has unique contents.

              · raw-data:  Counts the size of blobs in the repository, regard‐
                less of how many files reference them.

              · blobs-per-file:  A  combination   of   files-by-contents   and
                raw-data.



       Refer to the online manual for more details about each mode.



EEXXIITT SSTTAATTUUSS
       Exit  status  is 0 if the command was successful, and non-zero if there
       was any error.



OOPPTTIIOONNSS
       --hh, ----hheellpp[=false]      help for stats


       --HH, ----hhoosstt=[]      only consider snapshots with the given hhoosstt (can  be
       specified multiple times)


       ----mmooddee="restore-size"        counting   mode:  restore-size  (default),
       files-by-contents, blobs-per-file or raw-data


       ----ppaatthh=[]      only consider snapshots which  include  this  (absolute)
       ppaatthh (can be specified multiple times)


       ----ttaagg=[]      only consider snapshots which include this ttaagglliisstt in the
       format ttaagg[[,,ttaagg,,......]] (can be specified multiple times)



OOPPTTIIOONNSS IINNHHEERRIITTEEDD FFRROOMM PPAARREENNTT CCOOMMMMAANNDDSS
       ----ccaacceerrtt=[]      ffiillee to load root certificates from (default: use sys‐
       tem certificates)


       ----ccaacchhee--ddiirr=""       set  the  cache  ddiirreeccttoorryy.  (default:  use system
       default cache directory)


       ----cclleeaannuupp--ccaacchhee[=false]      auto remove old cache directories


       ----iinnsseeccuurree--ttllss[=false]      skip TLS certificate verification when con‐
       necting to the repo (insecure)


       ----jjssoonn[=false]       set  output mode to JSON for commands that support
       it


       ----kkeeyy--hhiinntt=""      kkeeyy ID of key  to  try  decrypting  first  (default:
       $RESTIC_KEY_HINT)


       ----lliimmiitt--ddoowwnnllooaadd=0       limits  downloads  to a maximum rate in KiB/s.
       (default: unlimited)


       ----lliimmiitt--uuppllooaadd=0      limits  uploads  to  a  maximum  rate  in  KiB/s.
       (default: unlimited)


       ----nnoo--ccaacchhee[=false]      do not use a local cache


       ----nnoo--lloocckk[=false]       do  not  lock  the repository, this allows some
       operations on read-only repositories


       --oo, ----ooppttiioonn=[]      set extended option (kkeeyy==vvaalluuee, can  be  specified
       multiple times)


       ----ppaasssswwoorrdd--ccoommmmaanndd=""      shell ccoommmmaanndd to obtain the repository pass‐
       word from (default: $RESTIC_PASSWORD_COMMAND)


       --pp, ----ppaasssswwoorrdd--ffiillee=""      ffiillee to read the repository  password  from
       (default: $RESTIC_PASSWORD_FILE)


       --qq, ----qquuiieett[=false]      do not output comprehensive progress report


       --rr,  ----rreeppoo=""       rreeppoossiittoorryy  to backup to or restore from (default:
       $RESTIC_REPOSITORY)


       ----rreeppoossiittoorryy--ffiillee=""      ffiillee to read  the  repository  location  from
       (default: $RESTIC_REPOSITORY_FILE)


       ----ttllss--cclliieenntt--cceerrtt=""       path  to  a  ffiillee containing PEM encoded TLS
       client certificate and private key


       --vv, ----vveerrbboossee[=0]      be verbose (specify multiple times  or  a  level
       using --verbose=nn, max level/times is 3)



SSEEEE AALLSSOO
       rreessttiicc((11))



generated by rreessttiicc ggeenneerraattee       Jan 2017                   restic backup(1)
