Man page - borg2-tag(1)

Packages contains this manual

Manual

BORG-TAG

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
arguments
options
Archive filters
SEE ALSO
AUTHOR

NAME

borg-tag - Manage tags

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

arguments

NAME

specify the archive name

options

--set TAG

set tags (can be given multiple times)

--add TAG

add tags (can be given multiple times)

--remove TAG

remove tags (can be given multiple times)

Archive filters

-a PATTERN , --match-archives PATTERN

only consider archives matching all patterns. see "borg help match-archives".

--sort-by KEYS

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

--first N

consider first N archives after other filters were applied

--last N

consider last N archives after other filters were applied

--oldest TIMESPAN

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

--newest TIMESPAN

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

--older TIMESPAN

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

--newer TIMESPAN

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

SEE ALSO

borg-common(1)

AUTHOR

The Borg Collective