.\" Man page generated from reStructuredText .\" by the Docutils 0.22.4 manpage writer. . . .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 .. .TH "borg-match-archives" "1" "2026-08-29" "" "borg backup tool" .SH Name borg-match-archives \- Details regarding match-archives .SH DESCRIPTION .sp 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. .sp 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 .IP \(bu 2 date: match on the archive creation timestamp .UNINDENT .sp In case of a name pattern match, it uses pattern styles similar to the ones described by \fBborg help patterns\fP: .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 Regular expressions \%, selector \fBre:\fP Full regular expression support. This is very powerful, but can also get rather complicated. .TP .B Date patterns, selector \fBdate:\fP Match archives by creation timestamp. You can either match a single archive by passing its exact creation time, or all archives created within a given time interval. .sp To match a single archive by its exact creation time, use the forms: .INDENT 7.0 .IP \(bu 2 \fBYYYY\-MM\-DDTHH:MM:SS.ffffff\fP: ISO\-8601\-like date\-time string .IP \(bu 2 \fB@1735732800.123456\fP: UNIX timestamp .UNINDENT .sp To match a single archive, the pattern must specify the archive\(aqs complete creation timestamp, including any fractional seconds. Fractional\-second patterns accept 1 to 6 digits. .sp To match all archives created within a given time interval, use the forms: .INDENT 7.0 .IP \(bu 2 \fBYYYY\fP: match all archives created within the given year .IP \(bu 2 \fBYYYY\-MM\fP: within the given month .IP \(bu 2 \fBYYYY\-MM\-DD\fP: on the given day .IP \(bu 2 \fBYYYY\-MM\-DDTHH\fP: in the given hour .IP \(bu 2 \fBYYYY\-MM\-DDTHH:MM\fP: in the given minute .IP \(bu 2 \fBYYYY\-MM\-DDTHH:MM:SS\fP: in the given second .IP \(bu 2 \fB@1735732800\fP: within the 1 second interval from the given UNIX timestamp .UNINDENT .sp The \fBT\fP date\-time separator may also be written as a space, e.g. \fBdate:2025\-01\-01 14:30\fP\&. .sp Date and time patterns match the interval implied by their precision, including the start and excluding the end. For example, \fBdate:2026\-06\fP matches archives created on or after \fB2026\-06\-01T00:00:00\fP and before \fB2026\-07\-01T00:00:00\fP\&. .sp Date and time patterns may include a timezone suffix: \fBZ\fP (UTC), \fB+HH:MM\fP, \fB\-HH:MM\fP, or \fB[Region/City]\fP\&. Patterns without a timezone are interpreted in the local timezone. Unix timestamps are always UTC and do not accept a timezone suffix. .sp Be wary of Daylight Saving Time (DST) transitions, as they can make time intervals ambiguous or nonexistent. For example, named zones such as \fB[Europe/Berlin]\fP track DST, but the equivalent (winter) UTC offset of \fB+01:00\fP does not. Use UTC to avoid such issues. .UNINDENT .sp Examples: .INDENT 0.0 .INDENT 3.5 .sp .EX # name match, id: style 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 # name match, sh: style borg delete \-a \(aqsh:home\-kenny\-*\(aq # name match, re: style borg delete \-a \(aqre:pc[123]\-home\-(user1|user2)\-2022\-09\-.*\(aq # 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 # archive creation date match borg delete \-a \(aqdate:2025\-01\(aq borg delete \-a \(aqdate:2025\-01\-01T14:30Z\(aq borg delete \-a \(aqdate:2025\-01\-01T09:30[America/New_York]\(aq .EE .UNINDENT .UNINDENT .SH Author The Borg Collective .\" End of generated man page.