diff --git a/lib/ansible/modules/files/file.py b/lib/ansible/modules/files/file.py index be280453fd..4463d19826 100644 --- a/lib/ansible/modules/files/file.py +++ b/lib/ansible/modules/files/file.py @@ -84,6 +84,11 @@ EXAMPLES = ''' owner: foo group: foo mode: 0644 +- file: + path: /work + owner: root + group: root + mode: 01777 - file: src: /file/to/link/to dest: /path/to/symlink diff --git a/lib/ansible/utils/module_docs_fragments/files.py b/lib/ansible/utils/module_docs_fragments/files.py index cd4c120fc5..9594520b91 100644 --- a/lib/ansible/utils/module_docs_fragments/files.py +++ b/lib/ansible/utils/module_docs_fragments/files.py @@ -25,7 +25,7 @@ options: required: false default: null description: - - Mode the file or directory should be. For those used to I(/usr/bin/chmod) remember that modes are actually octal numbers (like 0644). + - Mode the file or directory should be. For those used to I(/usr/bin/chmod) remember that modes are actually octal numbers (like C(0644) or C(01777)). Leaving off the leading zero will likely have unexpected results. As of version 1.8, the mode may be specified as a symbolic mode (for example, C(u+rwx) or C(u=rw,g=r,o=r)). owner: