restic backup(1)                                              restic backup(1)



NNAAMMEE
       restic-ls - List files in a snapshot



SSYYNNOOPPSSIISS
       rreessttiicc llss [[ffllaaggss]] ssnnaappsshhoottIIDD [[ddiirr......]]



DDEESSCCRRIIPPTTIIOONN
       The "ls" command lists files and directories in a snapshot.


       The special snapshot ID "latest" can be used to list files and directo‐
       ries of the latest snapshot in the repository. The --host flag  can  be
       used  in  conjunction  to select the latest snapshot originating from a
       certain host only.


       File listings can optionally be filtered by directories. Any positional
       arguments  after  the snapshot ID are interpreted as absolute directory
       paths, and only files inside those directories will be listed.  If  the
       --recursive  flag  is  used, then the filter will allow traversing into
       matching directories' subfolders.  Any directory paths  specified  must
       be  absolute  (starting  with  a path separator); paths use the forward
       slash '/' as separator.



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 ls


       --HH, ----hhoosstt=[]      only consider snapshots for this hhoosstt, when snapshot
       ID "latest" is given (can be specified multiple times)


       --ll, ----lloonngg[=false]      use a long listing format showing size and mode


       ----ppaatthh=[]      only consider snapshots which  include  this  (absolute)
       ppaatthh,  when  snapshot  ID  "latest" is given (can be specified multiple
       times)


       ----rreeccuurrssiivvee[=false]      include files  in  subfolders  of  the  listed
       directories


       ----ttaagg=[]       only consider snapshots which include this ttaagglliisstt, when
       snapshot ID "latest" is given (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)
