restic backup(1)                                              restic backup(1)



NNAAMMEE
       restic-find - Find a file, a directory or restic IDs



SSYYNNOOPPSSIISS
       rreessttiicc ffiinndd [[ffllaaggss]] PPAATTTTEERRNN......



DDEESSCCRRIIPPTTIIOONN
       The  "find"  command  searches  for  files  or directories in snapshots
       stored in the repo.  It can also be used to search for restic blobs  or
       trees for troubleshooting.



OOPPTTIIOONNSS
       ----bblloobb[=false]      pattern is a blob-ID


       --hh, ----hheellpp[=false]      help for find


       --HH, ----hhoosstt=[]      only consider snapshots for this hhoosstt, when no snap‐
       shot ID is given (can be specified multiple times)


       --ii, ----iiggnnoorree--ccaassee[=false]      ignore case for pattern


       --ll, ----lloonngg[=false]      use a long listing format showing size and mode


       --NN, ----nneewweesstt=""      newest modification date/time


       --OO, ----oollddeesstt=""      oldest modification date/time


       ----ppaacckk[=false]      pattern is a pack-ID


       ----ppaatthh=[]      only consider snapshots which  include  this  (absolute)
       ppaatthh, when no snapshot-ID is given


       ----sshhooww--ppaacckk--iidd[=false]       display  the  pack-ID  the blobs belong to
       (with --blob or --tree)


       --ss, ----ssnnaappsshhoott=[]      snapshot iidd to search in (can be given  multiple
       times)


       ----ttaagg=[]       only consider snapshots which include this ttaagglliisstt, when
       no snapshot-ID is given


       ----ttrreeee[=false]      pattern is a tree-ID



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)



EEXXAAMMPPLLEE
              restic find config.json
              restic find --json "*.yml" "*.json"
              restic find --json --blob 420f620f b46ebe8a ddd38656
              restic find --show-pack-id --blob 420f620f
              restic find --tree 577c2bc9 f81f2e22 a62827a9
              restic find --pack 025c1d06

              EXIT STATUS
              ===========

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





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)
