2023-01-02 22:51:22 +00:00
|
|
|
.\" Man page generated from reStructuredText.
|
|
|
|
|
.
|
|
|
|
|
.
|
|
|
|
|
.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
|
|
|
|
|
..
|
2024-10-31 19:50:06 +00:00
|
|
|
.TH "BORG-MATCH-ARCHIVES" 1 "2024-10-31" "" "borg backup tool"
|
2023-01-02 22:51:22 +00:00
|
|
|
.SH NAME
|
|
|
|
|
borg-match-archives \- Details regarding match-archives
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.sp
|
2024-10-03 10:23:03 +00: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 22:51:22 +00:00
|
|
|
.sp
|
2024-10-03 10:23:03 +00: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 22:51:22 +00: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
|
|
|
|
|
.B \fI\%Regular expressions\fP, selector \fBre:\fP
|
|
|
|
|
Full regular expression support.
|
|
|
|
|
This is very powerful, but can also get rather complicated.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Examples:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
2024-10-03 10:23:03 +00:00
|
|
|
# name match, id: style
|
2023-01-02 22:51:22 +00: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 10:23:03 +00:00
|
|
|
# name match, sh: style
|
2023-01-02 22:51:22 +00:00
|
|
|
borg delete \-a \(aqsh:home\-kenny\-*\(aq
|
|
|
|
|
|
2024-10-03 10:23:03 +00:00
|
|
|
# name match, re: style
|
2023-01-02 22:51:22 +00:00
|
|
|
borg delete \-a \(aqre:pc[123]\-home\-(user1|user2)\-2022\-09\-.*\(aq
|
2024-10-03 10:23:03 +00: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
|
2023-01-02 22:51:22 +00:00
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SH AUTHOR
|
|
|
|
|
The Borg Collective
|
|
|
|
|
.\" Generated by docutils manpage writer.
|
|
|
|
|
.
|
