mirror of https://github.com/borgbackup/borg.git
docs: add warning about prune
This commit is contained in:
parent
2c13027750
commit
bf3cf21ac5
|
@ -85,9 +85,12 @@ certain number of old archives::
|
|||
--exclude /home/Ben/Music/Justin\ Bieber \
|
||||
--exclude '*.pyc'
|
||||
|
||||
# Use the `prune` subcommand to maintain 7 daily, 4 weekly
|
||||
# and 6 monthly archives.
|
||||
borg prune -v $REPOSITORY --keep-daily=7 --keep-weekly=4 --keep-monthly=6
|
||||
# Use the `prune` subcommand to maintain 7 daily, 4 weekly and 6 monthly
|
||||
# archives of THIS machine. --prefix `hostname`- is very important to
|
||||
# limit prune's operation to this machine's archives and not apply to
|
||||
# other machine's archives also.
|
||||
borg prune -v $REPOSITORY --prefix `hostname`- \
|
||||
--keep-daily=7 --keep-weekly=4 --keep-monthly=6
|
||||
|
||||
.. backup_compression:
|
||||
|
||||
|
|
|
@ -265,10 +265,23 @@ Examples
|
|||
|
||||
Examples
|
||||
~~~~~~~~
|
||||
|
||||
Be careful, prune is potentially dangerous command, it will remove backup
|
||||
archives.
|
||||
|
||||
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 `--prefix`.
|
||||
When using --prefix, be careful to choose a good prefix - e.g. do not use a
|
||||
prefix "foo" if you do not also want to match "foobar".
|
||||
|
||||
It is strongly recommended to always run `prune --dry-run ...` first so you
|
||||
will see what it would do without it actually doing anything.
|
||||
|
||||
::
|
||||
|
||||
# Keep 7 end of day and 4 additional end of week archives:
|
||||
$ borg prune /mnt/backup --keep-daily=7 --keep-weekly=4
|
||||
# Keep 7 end of day and 4 additional end of week archives.
|
||||
# Do a dry-run without actually deleting anything.
|
||||
$ borg prune /mnt/backup --dry-run --keep-daily=7 --keep-weekly=4
|
||||
|
||||
# Same as above but only apply to archive names starting with "foo":
|
||||
$ borg prune /mnt/backup --keep-daily=7 --keep-weekly=4 --prefix=foo
|
||||
|
|
Loading…
Reference in New Issue