From: Andre Noll <maan@systemlinux.org>
Date: Tue, 7 Apr 2009 13:23:34 +0000 (+0200)
Subject: Add pre-remove and post-remove hooks to dss.ggo.
X-Git-Tag: v0.1.3~16
X-Git-Url: http://git.tuebingen.mpg.de/?p=dss.git;a=commitdiff_plain;h=260d141cfa4b0f6368920762fe85093da75e3849;hp=4771cf3642f26f29fc91cdfc392203cee5d51f02

Add pre-remove and post-remove hooks to dss.ggo.

These are not yet used in the code.
---

diff --git a/dss.ggo b/dss.ggo
index 099df4c..9c687f4 100644
--- a/dss.ggo
+++ b/dss.ggo
@@ -277,6 +277,37 @@ details="
 	store them in a database for further analysis.
 "
 
+option "pre-remove-hook" -
+#~~~~~~~~~~~~~~~~~~~~~~~~~~
+"Executed before snapshot removal"
+string typestr="command"
+optional
+details="
+	Execute this command before removing a snapshot. If this
+	command returns with a non-zero exit status, no snapshot is
+	being removed and the operation is retried later.
+
+	For example, one might want to execute a script that checks
+	whether the snapshot to be deleted is currently used by
+	another process, e.g. by a tape-based backup system that runs
+	concurrently to dss.
+
+	Another possible application of this is to record disk-usage
+	patterns before and after snapshot removal.
+"
+
+option "post-remove-hook" -
+#~~~~~~~~~~~~~~~~~~~~~~~~~~
+"Executed after snapshot removal"
+string typestr="command"
+optional
+details="
+	Execute this after a snapshot has successfully been
+	removed. The full path of the removed snapshot is
+	passed to the hook as the first argument. The exit code of
+	this hook is ignored.
+"
+
 option "exit-hook" e
 #~~~~~~~~~~~~~~~~~~~
 "Executed if run command exits"