Man page - borg-match-archives(1)
Packages contas this manual
- borg-tag(1)
- borg-repo-delete(1)
- borg-create(1)
- borg(1)
- borg-mount(1)
- borg-info(1)
- borg-list(1)
- borg-placeholders(1)
- borg-benchmark(1)
- borg-diff(1)
- borg-key-change-passphrase(1)
- borg-repo-compress(1)
- borg-import-tar(1)
- borg-benchmark-crud(1)
- borg-repo-create(1)
- borg-repo-list(1)
- borg-compression(1)
- borg-version(1)
- borg-delete(1)
- borg-undelete(1)
- borg-key-change-location(1)
- borg-recreate(1)
- borg-check(1)
- borg-repo-space(1)
- borg-key(1)
- borg-compact(1)
- borg-umount(1)
- borg-serve(1)
- borg-transfer(1)
- borg-prune(1)
- borg-with-lock(1)
- borg-common(1)
- borg-patterns(1)
- borg-match-archives(1)
- borg-break-lock(1)
- borg-repo-info(1)
- borg-rename(1)
- borg-analyze(1)
- borg-export-tar(1)
- borg-key-export(1)
- borg-extract(1)
- borg-benchmark-cpu(1)
- borgfs(1)
- borg-key-import(1)
Package: borgbackup-is-borgbackup2
apt-get install borgbackup-is-borgbackup2
apt-get install borgbackup-is-borgbackup2
Manuals in package:
Manual
| BORG-MATCH-ARCHIVES(1) | borg backup tool | BORG-MATCH-ARCHIVES(1) |
NAME
borg-match-archives - Details regarding match-archives
DESCRIPTION
The --match-archives option matches a given pattern against the list of all archives in the repository. It can be given multiple times.
The patterns can have a prefix of:
- name: pattern match on the archive name (default)
- aid: prefix match on the archive id (only one result allowed)
- user: exact match on the username who created the archive
- host: exact match on the hostname where the archive was created
- tags: match on the archive tags
In case of a name pattern match, it uses pattern styles similar to the ones described by borg help patterns:
- Identical match pattern, selector id: (default)
- Simple string match, must fully match exactly as given.
- Shell-style patterns, selector sh:
- Match like on the shell, wildcards like * and ? work.
- Regular expressions <https://docs.python.org/3/library/re.html>
- , selector re: Full regular expression support. This is very powerful, but can also get rather complicated.
Examples:
# name match, id: style borg delete --match-archives 'id:archive-with-crap' borg delete -a 'id:archive-with-crap' # same, using short option borg delete -a 'archive-with-crap' # same, because 'id:' is the default # name match, sh: style borg delete -a 'sh:home-kenny-*' # name match, re: style borg delete -a 're:pc[123]-home-(user1|user2)-2022-09-.*' # archive id prefix match: borg delete -a 'aid:d34db33f' # host or user match borg delete -a 'user:kenny' borg delete -a 'host:kenny-pc' # tags match borg delete -a 'tags:TAG1' -a 'tags:TAG2'
AUTHOR
The Borg Collective
| 2025-08-04 |