restic-tag(1)

1restic backup(1)                                              restic backup(1)
2
3
4

NAME

6       restic-tag - Modify tags on snapshots
7
8
9

SYNOPSIS

11       restic tag [flags] [snapshot-ID ...]
12
13
14

DESCRIPTION

16       The "tag" command allows you to modify tags on exiting snapshots.
17
18
19       You can either set/replace the entire set of tags on a snapshot, or add
20       tags to/remove tags from the existing set.
21
22
23       When no snapshot-ID is given, all snapshots matching the host, tag  and
24       path filter criteria are modified.
25
26
27

EXIT STATUS

29       Exit  status  is 0 if the command was successful, and non-zero if there
30       was any error.
31
32
33

OPTIONS

35       --add=[]      tags which will be added to the existing tags in the for‐
36       mat tag[,tag,...] (can be given multiple times)
37
38
39       -h, --help[=false]      help for tag
40
41
42       -H, --host=[]      only consider snapshots for this host, when no snap‐
43       shot ID is given (can be specified multiple times)
44
45
46       --path=[]      only consider snapshots which  include  this  (absolute)
47       path, when no snapshot-ID is given
48
49
50       --remove=[]       tags  which will be removed from the existing tags in
51       the format tag[,tag,...] (can be given multiple times)
52
53
54       --set=[]      tags which will replace the existing tags in  the  format
55       tag[,tag,...] (can be given multiple times)
56
57
58       --tag=[]       only consider snapshots which include this taglist, when
59       no snapshot-ID is given
60
61
62

OPTIONS INHERITED FROM PARENT COMMANDS

64       --cacert=[]      file to load root certificates from (default: use sys‐
65       tem certificates)
66
67
68       --cache-dir=""       set  the cache directory. (default: use system de‐
69       fault cache directory)
70
71
72       --cleanup-cache[=false]      auto remove old cache directories
73
74
75       --json[=false]      set output mode to JSON for commands  that  support
76       it
77
78
79       --key-hint=""       key  ID  of  key  to try decrypting first (default:
80       $RESTIC_KEY_HINT)
81
82
83       --limit-download=0      limits downloads to a maximum  rate  in  KiB/s.
84       (default: unlimited)
85
86
87       --limit-upload=0       limits  uploads to a maximum rate in KiB/s. (de‐
88       fault: unlimited)
89
90
91       --no-cache[=false]      do not use a local cache
92
93
94       --no-lock[=false]      do not lock the repository, this allows some op‐
95       erations on read-only repositories
96
97
98       -o,  --option=[]       set extended option (key=value, can be specified
99       multiple times)
100
101
102       --password-command=""      shell command to obtain the repository pass‐
103       word from (default: $RESTIC_PASSWORD_COMMAND)
104
105
106       -p,  --password-file=""       file to read the repository password from
107       (default: $RESTIC_PASSWORD_FILE)
108
109
110       -q, --quiet[=false]      do not output comprehensive progress report
111
112
113       -r, --repo=""      repository to backup to or  restore  from  (default:
114       $RESTIC_REPOSITORY)
115
116
117       --repository-file=""       file  to  read  the repository location from
118       (default: $RESTIC_REPOSITORY_FILE)
119
120
121       --tls-client-cert=""      path to a file  containing  PEM  encoded  TLS
122       client certificate and private key
123
124
125       -v,  --verbose[=0]       be  verbose (specify multiple times or a level
126       using --verbose=n, max level/times is 3)
127
128
129

NAME

SYNOPSIS

DESCRIPTION

EXIT STATUS

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

SEE ALSO