1restic backup(1) restic backup(1)
2
3
4
6 restic-tag - Modify tags on snapshots
7
8
9
11 restic tag [flags] [snapshotID ...]
12
13
14
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 snapshotID is given, all snapshots matching the host, tag and
24 path filter criteria are modified.
25
26
27
29 Exit status is 0 if the command was successful, and non-zero if there
30 was any error.
31
32
33
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 (can be speci‐
43 fied multiple times)
44
45
46 --path=[] only consider snapshots including this (absolute) path
47 (can be specified multiple times)
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 including tag[,tag,...] (can be
59 specified multiple times)
60
61
62
64 --cacert=[] file to load root certificates from (default: use sys‐
65 tem certificates or $RESTIC_CACERT)
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 --compression=auto compression mode (only available for repository
76 format version 2), one of (auto|off|max) (default: $RESTIC_COMPRESSION)
77
78
79 --insecure-tls[=false] skip TLS certificate verification when con‐
80 necting to the repository (insecure)
81
82
83 --json[=false] set output mode to JSON for commands that support
84 it
85
86
87 --key-hint="" key ID of key to try decrypting first (default:
88 $RESTIC_KEY_HINT)
89
90
91 --limit-download=0 limits downloads to a maximum rate in KiB/s.
92 (default: unlimited)
93
94
95 --limit-upload=0 limits uploads to a maximum rate in KiB/s. (de‐
96 fault: unlimited)
97
98
99 --no-cache[=false] do not use a local cache
100
101
102 --no-lock[=false] do not lock the repository, this allows some op‐
103 erations on read-only repositories
104
105
106 -o, --option=[] set extended option (key=value, can be specified
107 multiple times)
108
109
110 --pack-size=0 set target pack size in MiB, created pack files may
111 be larger (default: $RESTIC_PACK_SIZE)
112
113
114 --password-command="" shell command to obtain the repository pass‐
115 word from (default: $RESTIC_PASSWORD_COMMAND)
116
117
118 -p, --password-file="" file to read the repository password from
119 (default: $RESTIC_PASSWORD_FILE)
120
121
122 -q, --quiet[=false] do not output comprehensive progress report
123
124
125 -r, --repo="" repository to backup to or restore from (default:
126 $RESTIC_REPOSITORY)
127
128
129 --repository-file="" file to read the repository location from
130 (default: $RESTIC_REPOSITORY_FILE)
131
132
133 --retry-lock=0s retry to lock the repository if it is already
134 locked, takes a value like 5m or 2h (default: no retries)
135
136
137 --tls-client-cert="" path to a file containing PEM encoded TLS
138 client certificate and private key (default: $RESTIC_TLS_CLIENT_CERT)
139
140
141 -v, --verbose[=0] be verbose (specify multiple times or a level
142 using --verbose=n``, max level/times is 2)
143
144
145
147 restic(1)
148
149
150
151generated by restic generate Jan 2017 restic backup(1)