mirror/borg
1
0
Fork 0
mirror of https://github.com/borgbackup/borg.git synced 2025-02-25 15:33:39 +00:00
Code Issues Releases Wiki Activity

Merge pull request #7571 from ThomasWaldmann/match-archives-docs

Browse source 
docs: fix some -a / --match-archives issues
This commit is contained in:
TW 2023-05-16 10:13:19 +02:00 committed by GitHub
commit 4d7c7b0fcb
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
5 changed files with 10 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
docs/faq.rst
View file

@ -369,8 +369,8 @@ different prefixes. For example, you could have a script that does::
Then you would have two different prune calls with different policies:: Then you would have two different prune calls with different policies::
borg prune --verbose --list -d 30 -a 'main-*' borg prune --verbose --list -d 30 -a 'sh:main-*'
borg prune --verbose --list -d 7 -a 'logs-*' borg prune --verbose --list -d 7 -a 'sh:logs-*'
This will keep 7 days of logs and 30 days of everything else. This will keep 7 days of logs and 30 days of everything else.

4
docs/quickstart_example.rst.inc
View file

@ -48,8 +48,8 @@
$ borg -r /path/to/repo delete -a Monday $ borg -r /path/to/repo delete -a Monday
Please note the ``-a`` option here (short for ``--glob-archives``) which enables you Please note the ``-a`` option here (short for ``--match-archives``) which enables you
to give a globbing pattern to delete multiple archives, like ``-a 'oldcrap-*'``. to give a pattern to delete multiple archives, like ``-a 'sh:oldcrap-*'``.
You can also combine this with ``--first``, ``--last`` and ``--sort-by``. You can also combine this with ``--first``, ``--last`` and ``--sort-by``.
Be careful, always first use with ``--dry-run`` and ``--list``! Be careful, always first use with ``--dry-run`` and ``--list``!

6
docs/usage/delete.rst
View file

@ -10,11 +10,11 @@ Examples
$ borg compact $ borg compact
# delete all archives whose names begin with the machine's hostname followed by "-" # delete all archives whose names begin with the machine's hostname followed by "-"
$ borg delete -a '{hostname}-*' $ borg delete -a 'sh:{hostname}-*'
# delete all archives whose names contain "-2012-" # delete all archives whose names contain "-2012-"
$ borg delete -a '*-2012-*' $ borg delete -a 'sh:*-2012-*'
# see what would be deleted if delete was run without --dry-run # see what would be deleted if delete was run without --dry-run
$ borg delete --list --dry-run -a '*-May-*' $ borg delete --list --dry-run -a 'sh:*-May-*'

2
docs/usage/mount.rst
View file

@ -27,7 +27,7 @@ Examples
# Archive filters are supported. # Archive filters are supported.
# These are especially handy for the "versions view", # These are especially handy for the "versions view",
# which does not support lazy processing of archives. # which does not support lazy processing of archives.
$ borg mount -o versions --glob-archives '*-my-home' --last 10 /tmp/mymountpoint $ borg mount -o versions --match-archives 'sh:*-my-home' --last 10 /tmp/mymountpoint
# Exclusion options are supported. # Exclusion options are supported.
# These can speed up mounting and lower memory needs significantly. # These can speed up mounting and lower memory needs significantly.

4
docs/usage/prune.rst
View file

@ -7,7 +7,7 @@ Be careful, prune is a potentially dangerous command, it will remove backup
archives. archives.
The default of prune is to apply to **all archives in the repository** unless The default of prune is to apply to **all archives in the repository** unless
you restrict its operation to a subset of the archives using ``-a`` / ``--glob-archives``. you restrict its operation to a subset of the archives using ``-a`` / ``--match-archives``.
When using ``-a``, be careful to choose a good pattern - e.g. do not use a When using ``-a``, be careful to choose a good pattern - e.g. do not use a
prefix "foo" if you do not also want to match "foobar". prefix "foo" if you do not also want to match "foobar".
@ -22,7 +22,7 @@ first so you will see what it would do without it actually doing anything.
# Same as above but only apply to archive names starting with the hostname # Same as above but only apply to archive names starting with the hostname
# of the machine followed by a "-" character: # of the machine followed by a "-" character:
$ borg prune -v --list --keep-daily=7 --keep-weekly=4 -a '{hostname}-*' $ borg prune -v --list --keep-daily=7 --keep-weekly=4 -a 'sh:{hostname}-*'
# actually free disk space: # actually free disk space:
$ borg compact $ borg compact