restic backup(1)                                              restic backup(1)



NNAAMMEE
       restic-tag - Modify tags on snapshots



SSYYNNOOPPSSIISS
       rreessttiicc ttaagg [[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 "tag" command allows you to modify tags on exiting snapshots.


       You can either set/replace the entire set of tags on a snapshot, or add
       tags to/remove tags from the existing set.


       When no snapshot-ID is given, all snapshots matching the host, tag  and
       path filter criteria are modified.



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
       ----aadddd=[]      ttaaggss which will be added to the existing tags in the for‐
       mat ttaagg[[,,ttaagg,,......]] (can be given multiple times)


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


       --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)


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


       ----rreemmoovvee=[]       ttaaggss  which will be removed from the existing tags in
       the format ttaagg[[,,ttaagg,,......]] (can be given multiple times)


       ----sseett=[]      ttaaggss which will replace the existing tags in  the  format
       ttaagg[[,,ttaagg,,......]] (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



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)
