restic backup(1)                                              restic backup(1)



NNAAMMEE
       restic-ls - List files in a snapshot



SSYYNNOOPPSSIISS
       rreessttiicc llss [[ffllaaggss]] ssnnaappsshhoottIIDD [[ddiirr......]]



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



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 ls


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


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


       ----ppaatthh=[]      only consider snapshots which  include  this  (absolute)
       ppaatthh,  when  snapshot  ID  "latest" is given (can be specified multiple
       times)


       ----rreeccuurrssiivvee[=false]      include files  in  subfolders  of  the  listed
       directories


       ----ttaagg=[]       only consider snapshots which include this ttaagglliisstt, when
       snapshot ID "latest" is given (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)
