summaryrefslogtreecommitdiffstats
path: root/source/rainerscript/functions/rs-previous_action_suspended.rst
diff options
context:
space:
mode:
Diffstat (limited to 'source/rainerscript/functions/rs-previous_action_suspended.rst')
-rw-r--r--source/rainerscript/functions/rs-previous_action_suspended.rst30
1 files changed, 30 insertions, 0 deletions
diff --git a/source/rainerscript/functions/rs-previous_action_suspended.rst b/source/rainerscript/functions/rs-previous_action_suspended.rst
new file mode 100644
index 0000000..b78e448
--- /dev/null
+++ b/source/rainerscript/functions/rs-previous_action_suspended.rst
@@ -0,0 +1,30 @@
+***************************
+previous_action_suspended()
+***************************
+
+Purpose
+=======
+
+previous_action_suspended()
+
+This boolean function returns 1 (true) if the previous action is suspended,
+0 (false) otherwise. It can be used to initiate action that shall happen if
+a function failed. Please note that an action failure may not be immediately
+detected, so the function return value is a bit fuzzy. It is guaranteed, however
+that a suspension will be detected with the next batch of messages that is
+being processed.
+
+
+Example
+=======
+
+In the following example the if-clause is executed if the previous action
+is suspended.
+
+.. code-block:: none
+
+ action(type="omfwd" protocol="tcp" target="10.1.1.1")
+
+ if previous_action_suspended() then {}
+
+