diff --git a/files/file b/files/file index 9ef61d0ce22..c96c081ae84 100644 --- a/files/file +++ b/files/file @@ -50,10 +50,12 @@ options: 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. + and files or symlinks will be unlinked. If C(touched), existing file and + directory will change file access and modification times, not existing + file will be created. required: false default: file - choices: [ file, link, directory, hard, absent ] + choices: [ file, link, directory, hard, touched, absent ] mode: required: false default: null @@ -139,7 +141,7 @@ def main(): module = AnsibleModule( argument_spec = dict( - state = dict(choices=['file','directory','link','hard','absent'], default='file'), + state = dict(choices=['file','directory','link','hard','touched','absent'], default='file'), path = dict(aliases=['dest', 'name'], required=True), recurse = dict(default='no', type='bool'), force = dict(required=False,default=False,type='bool'), @@ -223,7 +225,7 @@ def main(): module.exit_json(path=path, changed=True) if prev_state != 'absent' and prev_state != state: - if not (force and prev_state == 'file' and state == 'link'): + if not (force and prev_state == 'file' and state == 'link') and state != 'touched': module.fail_json(path=path, msg='refusing to convert between %s and %s for %s' % (prev_state, state, src)) if prev_state == 'absent' and state == 'absent': @@ -307,6 +309,25 @@ def main(): changed = module.set_file_attributes_if_different(file_args, changed) module.exit_json(dest=path, src=src, changed=changed) + elif state == 'touched': + if module.check_mode: + module.exit_json(path=path, skipped=True) + + if prev_state not in ['file', 'directory', 'absent']: + module.fail_json(msg='Cannot touch other than files and directories') + if prev_state != 'absent': + try: + os.utime(path, None) + except OSError, e: + module.fail_json(path=path, msg='Error while touching existing target: %s' % str(e)) + else: + try: + open(path, 'w').close() + except OSError, e: + module.fail_json(path=path, msg='Error while touching non-existing target: %s' % str(e)) + module.set_file_attributes_if_different(file_args, True) + module.exit_json(dest=path, changed=True) + else: module.fail_json(path=path, msg='unexpected position reached')