summaryrefslogtreecommitdiffstats
path: root/lib/ansible/plugins/filter/realpath.yml
diff options
context:
space:
mode:
Diffstat (limited to 'lib/ansible/plugins/filter/realpath.yml')
-rw-r--r--lib/ansible/plugins/filter/realpath.yml21
1 files changed, 21 insertions, 0 deletions
diff --git a/lib/ansible/plugins/filter/realpath.yml b/lib/ansible/plugins/filter/realpath.yml
new file mode 100644
index 0000000..12687b6
--- /dev/null
+++ b/lib/ansible/plugins/filter/realpath.yml
@@ -0,0 +1,21 @@
+DOCUMENTATION:
+ name: realpath
+ author: darkone23 (@darkone23)
+ version_added: "1.8"
+ short_description: Turn path into real path
+ description:
+ - Resolves/follows symliknks to return the 'real path' from a given path.
+ - Filters alwasy run on controller so this path is resolved using the controller's filesystem.
+ options:
+ _input:
+ description: A path.
+ type: path
+ required: true
+EXAMPLES: |
+
+ realpath: {{ '/path/to/synlink' | realpath }}
+
+RETURN:
+ _value:
+ description: The canonical path.
+ type: path