borg-tag - Manage tags

       The Borg Collective

                                                   2025-01-03                                        BORG-TAG(1)

       Manage archive tags.

       Borg archives can have a set of tags which can be used for matching archives.

       You  can  set  the  tags  to a specific set of tags or you can add or remove tags from the current set of
       tags.

       User defined tags must not start with @ because such tags are  considered  special  and  users  are  only
       allowed to use known special tags:

       @PROT: protects archives against archive deletion or pruning.

       Pre-existing  special  tags  can  not  be  removed  via --set. You can still use --set, but you must give
       pre-existing special tags also (so they won't be removed).

       borg-tag - Manage tags

       See borg-common(1) for common options of Borg commands.

   argumentsNAME   specify the archive name

   options--setTAG
              set tags (can be given multiple times)

       --addTAG
              add tags (can be given multiple times)

       --removeTAG
              remove tags (can be given multiple times)

   Archivefilters-aPATTERN, --match-archivesPATTERN
              only consider archives matching all patterns. see "borg help match-archives".

       --sort-byKEYS
              Comma-separated list of sorting keys; valid keys are: timestamp, archive, name,  id,  tags,  host,
              user; default is: timestamp

       --firstN
              consider first N archives after other filters were applied

       --lastN
              consider last N archives after other filters were applied

       --oldestTIMESPAN
              consider archives between the oldest archive's timestamp and (oldest + TIMESPAN), e.g. 7d or 12m.

       --newestTIMESPAN
              consider archives between the newest archive's timestamp and (newest - TIMESPAN), e.g. 7d or 12m.

       --olderTIMESPAN
              consider archives older than (now - TIMESPAN), e.g. 7d or 12m.

       --newerTIMESPAN
              consider archives newer than (now - TIMESPAN), e.g. 7d or 12m.

borg-common(1)

       borg [common options] tag [options] [NAME]