|
|
@ -38,41 +38,6 @@ description:
|
|
|
|
- Sets attributes of files, symlinks, and directories, or removes
|
|
|
|
- Sets attributes of files, symlinks, and directories, or removes
|
|
|
|
files/symlinks/directories. Many other modules support the same options as
|
|
|
|
files/symlinks/directories. Many other modules support the same options as
|
|
|
|
the M(file) module - including M(copy), M(template), and M(assemble).
|
|
|
|
the M(file) module - including M(copy), M(template), and M(assemble).
|
|
|
|
options:
|
|
|
|
|
|
|
|
path:
|
|
|
|
|
|
|
|
description:
|
|
|
|
|
|
|
|
- 'path to the file being managed. Aliases: I(dest), I(name)'
|
|
|
|
|
|
|
|
required: true
|
|
|
|
|
|
|
|
default: []
|
|
|
|
|
|
|
|
aliases: ['dest', 'name']
|
|
|
|
|
|
|
|
state:
|
|
|
|
|
|
|
|
description:
|
|
|
|
|
|
|
|
- If C(directory), all immediate subdirectories will be created if they
|
|
|
|
|
|
|
|
do not exist. If C(file), the file will NOT be created if it does not
|
|
|
|
|
|
|
|
exist, see the M(copy) or M(template) module if you want that behavior.
|
|
|
|
|
|
|
|
If C(link), the symbolic link will be created or changed. Use C(hard)
|
|
|
|
|
|
|
|
for hardlinks. If C(absent), directories will be recursively deleted,
|
|
|
|
|
|
|
|
and files or symlinks will be unlinked. If C(touch) (new in 1.4), an empty file will
|
|
|
|
|
|
|
|
be created if the c(path) does not exist, while an existing file or
|
|
|
|
|
|
|
|
directory will receive updated file access and modification times (similar
|
|
|
|
|
|
|
|
to the way `touch` works from the command line).
|
|
|
|
|
|
|
|
required: false
|
|
|
|
|
|
|
|
default: file
|
|
|
|
|
|
|
|
choices: [ file, link, directory, hard, touch, absent ]
|
|
|
|
|
|
|
|
src:
|
|
|
|
|
|
|
|
required: false
|
|
|
|
|
|
|
|
default: null
|
|
|
|
|
|
|
|
choices: []
|
|
|
|
|
|
|
|
description:
|
|
|
|
|
|
|
|
- path of the file to link to (applies only to C(state= link or hard)). Will accept absolute,
|
|
|
|
|
|
|
|
relative and nonexisting (with C(force)) paths. Relative paths are not expanded.
|
|
|
|
|
|
|
|
recurse:
|
|
|
|
|
|
|
|
required: false
|
|
|
|
|
|
|
|
default: "no"
|
|
|
|
|
|
|
|
choices: [ "yes", "no" ]
|
|
|
|
|
|
|
|
version_added: "1.1"
|
|
|
|
|
|
|
|
description:
|
|
|
|
|
|
|
|
- recursively set the specified file attributes (applies only to state=directory)
|
|
|
|
|
|
|
|
notes:
|
|
|
|
notes:
|
|
|
|
- See also M(copy), M(template), M(assemble)
|
|
|
|
- See also M(copy), M(template), M(assemble)
|
|
|
|
requirements: [ ]
|
|
|
|
requirements: [ ]
|
|
|
|