summaryrefslogtreecommitdiff
path: root/lib/ansible/modules/template.py
diff options
context:
space:
mode:
Diffstat (limited to 'lib/ansible/modules/template.py')
-rw-r--r--lib/ansible/modules/template.py66
1 files changed, 6 insertions, 60 deletions
diff --git a/lib/ansible/modules/template.py b/lib/ansible/modules/template.py
index 8f8ad0bd..7ee581ad 100644
--- a/lib/ansible/modules/template.py
+++ b/lib/ansible/modules/template.py
@@ -18,17 +18,16 @@ options:
follow:
description:
- Determine whether symbolic links should be followed.
- - When set to V(true) symbolic links will be followed, if they exist.
- - When set to V(false) symbolic links will not be followed.
- - Previous to Ansible 2.4, this was hardcoded as V(true).
+ - When set to C(true) symbolic links will be followed, if they exist.
+ - When set to C(false) symbolic links will not be followed.
+ - Previous to Ansible 2.4, this was hardcoded as C(true).
type: bool
default: no
version_added: '2.4'
notes:
-- For Windows you can use M(ansible.windows.win_template) which uses V(\\r\\n) as O(newline_sequence) by default.
-- The C(jinja2_native) setting has no effect. Native types are never used in the M(ansible.builtin.template) module
- which is by design used for generating text files. For working with templates and utilizing Jinja2 native types see
- the O(ansible.builtin.template#lookup:jinja2_native) parameter of the P(ansible.builtin.template#lookup) lookup.
+- For Windows you can use M(ansible.windows.win_template) which uses C(\r\n) as C(newline_sequence) by default.
+- The C(jinja2_native) setting has no effect. Native types are never used in the C(template) module which is by design used for generating text files.
+ For working with templates and utilizing Jinja2 native types see the C(jinja2_native) parameter of the C(template lookup).
seealso:
- module: ansible.builtin.copy
- module: ansible.windows.win_copy
@@ -110,56 +109,3 @@ EXAMPLES = r'''
validate: /usr/sbin/sshd -t -f %s
backup: yes
'''
-
-RETURN = r'''
-dest:
- description: Destination file/path, equal to the value passed to I(dest).
- returned: success
- type: str
- sample: /path/to/file.txt
-checksum:
- description: SHA1 checksum of the rendered file
- returned: always
- type: str
- sample: 373296322247ab85d26d5d1257772757e7afd172
-uid:
- description: Numeric id representing the file owner
- returned: success
- type: int
- sample: 1003
-gid:
- description: Numeric id representing the group of the owner
- returned: success
- type: int
- sample: 1003
-owner:
- description: User name of owner
- returned: success
- type: str
- sample: httpd
-group:
- description: Group name of owner
- returned: success
- type: str
- sample: www-data
-md5sum:
- description: MD5 checksum of the rendered file
- returned: changed
- type: str
- sample: d41d8cd98f00b204e9800998ecf8427e
-mode:
- description: Unix permissions of the file in octal representation as a string
- returned: success
- type: str
- sample: 1755
-size:
- description: Size of the rendered file in bytes
- returned: success
- type: int
- sample: 42
-src:
- description: Source file used for the copy on the target machine.
- returned: changed
- type: str
- sample: /home/httpd/.ansible/tmp/ansible-tmp-1423796390.97-147729857856000/source
-'''