[pve-devel] [PATCH docs] backup: add section for protection

[Fabian Ebner <f.ebner@proxmox.com>]

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>
---
 vzdump.adoc | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/vzdump.adoc b/vzdump.adoc
index 96ae70d..f766d36 100644
--- a/vzdump.adoc
+++ b/vzdump.adoc
@@ -284,6 +284,19 @@ We recommend that you use a higher retention period than is minimally required
 by your environment; you can always reduce it if you find it is unnecessarily
 high, but you cannot recreate backups once they have been removed.
 
+[[vzdump_protection]]
+Backup Protection
+-----------------
+
+You can mark a backup as `protected` to prevent its removal. Attempting to
+remove a protected backup via {pve}'s UI or API will fail. However, manual
+removal of a backup file via CLI is still possible. Protected backups are
+ignored by pruning and do not count towards the retention settings.
+
+For filesystem-based storages, the protection is implemented via a sentinel file
+`<backup-name>.protected`. For Proxmox Backup Server, it is handled on the
+server side.
+
 [[vzdump_restore]]
 Restore
 -------
-- 
2.30.2