document how state=file works (#50986)

* document how state=file works

 this seems to have been lost in previous updates to docs

* Update lib/ansible/modules/files/file.py

Co-Authored-By: bcoca <bcoca@users.noreply.github.com>
pull/51452/head
Brian Coca 6 years ago committed by Sandra McCann
parent 19441df7e9
commit ce898bfde5

@ -37,8 +37,9 @@ options:
not exist as the state did not change. not exist as the state did not change.
- If C(directory), all intermediate subdirectories will be created if they - If C(directory), all intermediate subdirectories will be created if they
do not exist. Since Ansible 1.7 they will be created with the supplied permissions. do not exist. Since Ansible 1.7 they will be created with the supplied permissions.
- If C(file), the file will NOT be created if it does not exist; see the C(touch) - If C(file), without any other options this works mostly as a 'stat' and will return the current state of C(path).
value or the M(copy) or M(template) module if you want that behavior. Even with other options (i.e C(mode)), the file will be modified but will NOT be created if it does not exist;
see the C(touch) value or the M(copy) or M(template) module if you want that behavior.
- If C(hard), the hard link will be created or changed. - If C(hard), the hard link will be created or changed.
- If C(link), the symbolic link will be created or changed. - If C(link), the symbolic link will be created or changed.
- If C(touch) (new in 1.4), an empty file will be created if the C(path) does not - If C(touch) (new in 1.4), an empty file will be created if the C(path) does not

Loading…
Cancel
Save