2026-03-15 09:34:31 -04:00
|
|
|
.\" Man page generated from reStructuredText
|
|
|
|
|
.\" by the Docutils 0.22.4 manpage writer.
|
2023-01-02 17:51:22 -05:00
|
|
|
.
|
|
|
|
|
.
|
|
|
|
|
.nr rst2man-indent-level 0
|
|
|
|
|
.
|
|
|
|
|
.de1 rstReportMargin
|
|
|
|
|
\\$1 \\n[an-margin]
|
|
|
|
|
level \\n[rst2man-indent-level]
|
|
|
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
|
|
-
|
|
|
|
|
\\n[rst2man-indent0]
|
|
|
|
|
\\n[rst2man-indent1]
|
|
|
|
|
\\n[rst2man-indent2]
|
|
|
|
|
..
|
|
|
|
|
.de1 INDENT
|
|
|
|
|
.\" .rstReportMargin pre:
|
|
|
|
|
. RS \\$1
|
|
|
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
|
|
|
. nr rst2man-indent-level +1
|
|
|
|
|
.\" .rstReportMargin post:
|
|
|
|
|
..
|
|
|
|
|
.de UNINDENT
|
|
|
|
|
. RE
|
|
|
|
|
.\" indent \\n[an-margin]
|
|
|
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
|
|
.nr rst2man-indent-level -1
|
|
|
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
|
|
|
..
|
2026-06-16 08:17:43 -04:00
|
|
|
.TH "borg-match-archives" "1" "2026-06-16" "" "borg backup tool"
|
2026-03-15 09:34:31 -04:00
|
|
|
.SH Name
|
2023-01-02 17:51:22 -05:00
|
|
|
borg-match-archives \- Details regarding match-archives
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.sp
|
2024-10-03 06:23:03 -04:00
|
|
|
The \fB\-\-match\-archives\fP option matches a given pattern against the list of all archives
|
|
|
|
|
in the repository. It can be given multiple times.
|
2023-01-02 17:51:22 -05:00
|
|
|
.sp
|
2024-10-03 06:23:03 -04:00
|
|
|
The patterns can have a prefix of:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
name: pattern match on the archive name (default)
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
aid: prefix match on the archive id (only one result allowed)
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
user: exact match on the username who created the archive
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
host: exact match on the hostname where the archive was created
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
tags: match on the archive tags
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
In case of a name pattern match,
|
|
|
|
|
it uses pattern styles similar to the ones described by \fBborg help patterns\fP:
|
2023-01-02 17:51:22 -05:00
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B Identical match pattern, selector \fBid:\fP (default)
|
|
|
|
|
Simple string match, must fully match exactly as given.
|
|
|
|
|
.TP
|
|
|
|
|
.B Shell\-style patterns, selector \fBsh:\fP
|
|
|
|
|
Match like on the shell, wildcards like \fI*\fP and \fI?\fP work.
|
|
|
|
|
.TP
|
2026-03-15 09:34:31 -04:00
|
|
|
.B Regular expressions \%<https://\:docs\:.python\:.org/\:3/\:library/\:re\:.html>, selector \fBre:\fP
|
2023-01-02 17:51:22 -05:00
|
|
|
Full regular expression support.
|
|
|
|
|
This is very powerful, but can also get rather complicated.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Examples:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
2025-04-21 15:07:46 -04:00
|
|
|
.EX
|
2024-10-03 06:23:03 -04:00
|
|
|
# name match, id: style
|
2023-01-02 17:51:22 -05:00
|
|
|
borg delete \-\-match\-archives \(aqid:archive\-with\-crap\(aq
|
|
|
|
|
borg delete \-a \(aqid:archive\-with\-crap\(aq # same, using short option
|
|
|
|
|
borg delete \-a \(aqarchive\-with\-crap\(aq # same, because \(aqid:\(aq is the default
|
|
|
|
|
|
2024-10-03 06:23:03 -04:00
|
|
|
# name match, sh: style
|
2023-01-02 17:51:22 -05:00
|
|
|
borg delete \-a \(aqsh:home\-kenny\-*\(aq
|
|
|
|
|
|
2024-10-03 06:23:03 -04:00
|
|
|
# name match, re: style
|
2023-01-02 17:51:22 -05:00
|
|
|
borg delete \-a \(aqre:pc[123]\-home\-(user1|user2)\-2022\-09\-.*\(aq
|
2024-10-03 06:23:03 -04:00
|
|
|
|
|
|
|
|
# archive id prefix match:
|
|
|
|
|
borg delete \-a \(aqaid:d34db33f\(aq
|
|
|
|
|
|
|
|
|
|
# host or user match
|
|
|
|
|
borg delete \-a \(aquser:kenny\(aq
|
|
|
|
|
borg delete \-a \(aqhost:kenny\-pc\(aq
|
|
|
|
|
|
|
|
|
|
# tags match
|
|
|
|
|
borg delete \-a \(aqtags:TAG1\(aq \-a \(aqtags:TAG2\(aq
|
2025-04-21 15:07:46 -04:00
|
|
|
.EE
|
2023-01-02 17:51:22 -05:00
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2026-03-15 09:34:31 -04:00
|
|
|
.SH Author
|
2023-01-02 17:51:22 -05:00
|
|
|
The Borg Collective
|
2026-03-15 09:34:31 -04:00
|
|
|
.\" End of generated man page.
|
