mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
2af6510ded
Add follow parameter to stat module that controls whether to follow symlinks. It defaults to no. This then calls os.stat or os.lstat based on the value of follow. Add lnk_source key/value pair if path is a symlink and follow=no. Drop the statement that sets isdir=False and islnk=True when path is a symlink that points to a directory.
131 lines
3.5 KiB
Python
131 lines
3.5 KiB
Python
#!/usr/bin/python
|
|
# This file is part of Ansible
|
|
#
|
|
# Ansible is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# Ansible is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with Ansible. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
DOCUMENTATION = '''
|
|
---
|
|
module: stat
|
|
version_added: "1.3"
|
|
short_description: retrieve file or file system status
|
|
description:
|
|
- Retrieves facts for a file similar to the linux/unix 'stat' command.
|
|
options:
|
|
path:
|
|
description:
|
|
- The full path of the file/object to get the facts of
|
|
required: true
|
|
default: null
|
|
aliases: []
|
|
follow:
|
|
description:
|
|
- Whether to follow symlinks
|
|
required: false
|
|
default: no
|
|
aliases: []
|
|
author: Bruce Pennypacker
|
|
'''
|
|
|
|
EXAMPLES = '''
|
|
# Obtain the stats of /etc/foo.conf, and check that the file still belongs
|
|
# to 'root'. Fail otherwise.
|
|
- stats: path=/etc/foo.conf
|
|
register: st
|
|
- fail: msg="Whoops! file ownership has changed"
|
|
when: st.stat.pw_name != 'root'
|
|
'''
|
|
|
|
import os
|
|
import sys
|
|
from stat import *
|
|
import pwd
|
|
|
|
def main():
|
|
module = AnsibleModule(
|
|
argument_spec = dict(
|
|
path = dict(required=True),
|
|
follow = dict(default='no', type='bool')
|
|
)
|
|
)
|
|
|
|
path = module.params.get('path')
|
|
follow = module.params.get('follow')
|
|
|
|
try:
|
|
if follow:
|
|
st = os.stat(path)
|
|
else:
|
|
st = os.lstat(path)
|
|
except OSError, e:
|
|
if e.errno == errno.ENOENT:
|
|
d = { 'exists' : False }
|
|
module.exit_json(changed=False, stat=d)
|
|
|
|
module.fail_json(msg = e.strerror)
|
|
|
|
mode = st.st_mode
|
|
|
|
# back to ansible
|
|
d = {
|
|
'exists' : True,
|
|
'mode' : S_IMODE(mode),
|
|
'isdir' : S_ISDIR(mode),
|
|
'ischr' : S_ISCHR(mode),
|
|
'isblk' : S_ISBLK(mode),
|
|
'isreg' : S_ISREG(mode),
|
|
'isfifo' : S_ISFIFO(mode),
|
|
'islnk' : S_ISLNK(mode),
|
|
'issock' : S_ISSOCK(mode),
|
|
'uid' : st.st_uid,
|
|
'gid' : st.st_gid,
|
|
'size' : st.st_size,
|
|
'inode' : st.st_ino,
|
|
'dev' : st.st_dev,
|
|
'nlink' : st.st_nlink,
|
|
'atime' : st.st_atime,
|
|
'mtime' : st.st_mtime,
|
|
'ctime' : st.st_ctime,
|
|
'wusr' : bool(mode & stat.S_IWUSR),
|
|
'rusr' : bool(mode & stat.S_IRUSR),
|
|
'xusr' : bool(mode & stat.S_IXUSR),
|
|
'wgrp' : bool(mode & stat.S_IWGRP),
|
|
'rgrp' : bool(mode & stat.S_IRGRP),
|
|
'xgrp' : bool(mode & stat.S_IXGRP),
|
|
'woth' : bool(mode & stat.S_IWOTH),
|
|
'roth' : bool(mode & stat.S_IROTH),
|
|
'xoth' : bool(mode & stat.S_IXOTH),
|
|
'isuid' : bool(mode & stat.S_ISUID),
|
|
'isgid' : bool(mode & stat.S_ISGID),
|
|
}
|
|
|
|
if S_ISLNK(mode):
|
|
d['lnk_source'] = os.path.realpath(path)
|
|
|
|
if S_ISREG(mode):
|
|
d['md5'] = module.md5(path)
|
|
|
|
try:
|
|
pw = pwd.getpwuid(st.st_uid)
|
|
|
|
d['pw_name'] = pw.pw_name
|
|
except:
|
|
pass
|
|
|
|
|
|
module.exit_json(changed=False, stat=d)
|
|
|
|
# this is magic, see lib/ansible/module_common.py
|
|
#<<INCLUDE_ANSIBLE_MODULE_COMMON>>
|
|
|
|
main()
|