summaryrefslogtreecommitdiffstats
path: root/lib/ansible/plugins/test/reachable.yml
diff options
context:
space:
mode:
Diffstat (limited to 'lib/ansible/plugins/test/reachable.yml')
-rw-r--r--lib/ansible/plugins/test/reachable.yml21
1 files changed, 21 insertions, 0 deletions
diff --git a/lib/ansible/plugins/test/reachable.yml b/lib/ansible/plugins/test/reachable.yml
new file mode 100644
index 0000000..8cb1ce3
--- /dev/null
+++ b/lib/ansible/plugins/test/reachable.yml
@@ -0,0 +1,21 @@
+DOCUMENTATION:
+ name: reachable
+ author: Ansible Core
+ version_added: "1.9"
+ short_description: Task did not end due to unreachable host
+ description:
+ - Tests if task was able to reach the host for execution
+ - This test checks for the existance of a C(unreachable) key in the input dictionary and that it is C(False) if present
+ options:
+ _input:
+ description: registered result from an Ansible task
+ type: dictionary
+ required: True
+EXAMPLES: |
+ # test 'status' to know how to respond
+ {{ (taskresults is reachable }}
+
+RETURN:
+ _value:
+ description: Returns C(True) if the task did not flag the host as unreachable, C(False) otherwise.
+ type: boolean