restic backup(1)                                              restic backup(1)



NNAAMMEE
       restic-stats - Scan the repository and show basic statistics



SSYYNNOOPPSSIISS
       rreessttiicc ssttaattss [[ffllaaggss]] [[ssnnaappsshhoott IIDD]] [[......]]



DDEESSCCRRIIPPTTIIOONN
       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.



EEXXIITT SSTTAATTUUSS
       Exit  status  is 0 if the command was successful, and non-zero if there
       was any error.



OOPPTTIIOONNSS
       --hh, ----hheellpp[=false]      help for stats


       --HH, ----hhoosstt=[]      only consider snapshots with the given hhoosstt (can  be
       specified multiple times)


       ----mmooddee="restore-size"        counting   mode:  restore-size  (default),
       files-by-contents, blobs-per-file or raw-data


       ----ppaatthh=[]      only consider snapshots which  include  this  (absolute)
       ppaatthh (can be specified multiple times)


       ----ttaagg=[]      only consider snapshots which include this ttaagglliisstt in the
       format ttaagg[[,,ttaagg,,......]] (can be specified multiple times)



OOPPTTIIOONNSS IINNHHEERRIITTEEDD FFRROOMM PPAARREENNTT CCOOMMMMAANNDDSS
       ----ccaacceerrtt=[]      ffiillee to load root certificates from (default: use sys‐
       tem certificates)


       ----ccaacchhee--ddiirr=""       set  the  cache  ddiirreeccttoorryy.  (default:  use system
       default cache directory)


       ----cclleeaannuupp--ccaacchhee[=false]      auto remove old cache directories


       ----iinnsseeccuurree--ttllss[=false]      skip TLS certificate verification when con‐
       necting to the repo (insecure)


       ----jjssoonn[=false]       set  output mode to JSON for commands that support
       it


       ----kkeeyy--hhiinntt=""      kkeeyy ID of key  to  try  decrypting  first  (default:
       $RESTIC_KEY_HINT)


       ----lliimmiitt--ddoowwnnllooaadd=0       limits  downloads  to a maximum rate in KiB/s.
       (default: unlimited)


       ----lliimmiitt--uuppllooaadd=0      limits  uploads  to  a  maximum  rate  in  KiB/s.
       (default: unlimited)


       ----nnoo--ccaacchhee[=false]      do not use a local cache


       ----nnoo--lloocckk[=false]       do  not  lock  the repository, this allows some
       operations on read-only repositories


       --oo, ----ooppttiioonn=[]      set extended option (kkeeyy==vvaalluuee, can  be  specified
       multiple times)


       ----ppaasssswwoorrdd--ccoommmmaanndd=""      shell ccoommmmaanndd to obtain the repository pass‐
       word from (default: $RESTIC_PASSWORD_COMMAND)


       --pp, ----ppaasssswwoorrdd--ffiillee=""      ffiillee to read the repository  password  from
       (default: $RESTIC_PASSWORD_FILE)


       --qq, ----qquuiieett[=false]      do not output comprehensive progress report


       --rr,  ----rreeppoo=""       rreeppoossiittoorryy  to backup to or restore from (default:
       $RESTIC_REPOSITORY)


       ----rreeppoossiittoorryy--ffiillee=""      ffiillee to read  the  repository  location  from
       (default: $RESTIC_REPOSITORY_FILE)


       ----ttllss--cclliieenntt--cceerrtt=""       path  to  a  ffiillee containing PEM encoded TLS
       client certificate and private key


       --vv, ----vveerrbboossee[=0]      be verbose (specify multiple times  or  a  level
       using --verbose=nn, max level/times is 3)



SSEEEE AALLSSOO
       rreessttiicc((11))



generated by rreessttiicc ggeenneerraattee       Jan 2017                   restic backup(1)
