From 58618eef8d9510b7eea5b881f6a2e467154c351f Mon Sep 17 00:00:00 2001 From: Mike Grozak Date: Tue, 4 Jun 2013 12:06:08 +0200 Subject: [PATCH] Updated documentaion for the file module --- files/file | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/files/file b/files/file index ab0ab6ec1d2..9538853c241 100644 --- a/files/file +++ b/files/file @@ -120,6 +120,20 @@ options: version_added: "1.1" description: - recursively set the specified file attributes (applies only to state=directory) + force: + required: false + default: "no" + choises: [ "yes", "no" ] + description: + - force the creation of the symlinks in two cases: the source file does + not exist (but will appear later); the destination exists and a file (so, we need to unlink the + "path" file and create symlink to the "src" file in place of it). +examples: + - code: "file: path=/etc/foo.conf owner=foo group=foo mode=0644" + description: Example from Ansible Playbooks + - code: "file: src=/file/to/link/to dest=/path/to/symlink owner=foo group=foo state=link" + - code: "action: file state=link path=/etc/localtime src=/usr/share/zoneinfo/Europe/Zurich force=yes" + description: Force /etc/locatime be the symbolic link to /usr/share/zoneinfo/Europe/Zurich notes: - See also M(copy), M(template), M(assemble) requirements: [ ]