�

���cpN���dd
lm
Z
mZmZ
eZdZdZdZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlmZ
ddlmZ
d�Zd	�Zed
kre��
dSdS)�)�absolute_import�division�print_functiona
---
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.
     - For Windows targets, use the M(ansible.windows.win_stat) module instead.
options:
  path:
    description:
      - The full path of the file/object to get the facts of.
    type: path
    required: true
    aliases: [ dest, name ]
  follow:
    description:
      - Whether to follow symlinks.
    type: bool
    default: no
  get_checksum:
    description:
      - Whether to return a checksum of the file.
    type: bool
    default: yes
    version_added: "1.8"
  checksum_algorithm:
    description:
      - Algorithm to determine checksum of file.
      - Will throw an error if the host is unable to use specified algorithm.
      - The remote host has to support the hashing method specified, C(md5)
        can be unavailable if the host is FIPS-140 compliant.
    type: str
    choices: [ md5, sha1, sha224, sha256, sha384, sha512 ]
    default: sha1
    aliases: [ checksum, checksum_algo ]
    version_added: "2.0"
  get_mime:
    description:
      - Use file magic and return data about the nature of the file. this uses
        the 'file' utility found on most Linux/Unix systems.
      - This will add both C(mime_type) and C(charset) fields to the return, if possible.
      - In Ansible 2.3 this option changed from I(mime) to I(get_mime) and the default changed to C(true).
    type: bool
    default: yes
    aliases: [ mime, mime_type, mime-type ]
    version_added: "2.1"
  get_attributes:
    description:
      - Get file attributes using lsattr tool if present.
    type: bool
    default: yes
    aliases: [ attr, attributes ]
    version_added: "2.3"
extends_documentation_fragment:
  -  action_common_attributes
attributes:
    check_mode:
        support: full
    diff_mode:
        support: none
    platform:
        platforms: posix
seealso:
- module: ansible.builtin.file
- module: ansible.windows.win_stat
author: Bruce Pennypacker (@bpennypacker)
a�
# Obtain the stats of /etc/foo.conf, and check that the file still belongs
# to 'root'. Fail otherwise.
- name: Get stats of a file
  ansible.builtin.stat:
    path: /etc/foo.conf
  register: st
- name: Fail if the file does not belong to 'root'
  ansible.builtin.fail:
    msg: "Whoops! file ownership has changed"
  when: st.stat.pw_name != 'root'

# Determine if a path exists and is a symlink. Note that if the path does
# not exist, and we test sym.stat.islnk, it will fail with an error. So
# therefore, we must test whether it is defined.
# Run this to understand the structure, the skipped ones do not pass the
# check performed by 'when'
- name: Get stats of the FS object
  ansible.builtin.stat:
    path: /path/to/something
  register: sym

- name: Print a debug message
  ansible.builtin.debug:
    msg: "islnk isn't defined (path doesn't exist)"
  when: sym.stat.islnk is not defined

- name: Print a debug message
  ansible.builtin.debug:
    msg: "islnk is defined (path must exist)"
  when: sym.stat.islnk is defined

- name: Print a debug message
  ansible.builtin.debug:
    msg: "Path exists and is a symlink"
  when: sym.stat.islnk is defined and sym.stat.islnk

- name: Print a debug message
  ansible.builtin.debug:
    msg: "Path exists and isn't a symlink"
  when: sym.stat.islnk is defined and sym.stat.islnk == False


# Determine if a path exists and is a directory.  Note that we need to test
# both that p.stat.isdir actually exists, and also that it's set to true.
- name: Get stats of the FS object
  ansible.builtin.stat:
    path: /path/to/something
  register: p
- name: Print a debug message
  ansible.builtin.debug:
    msg: "Path exists and is a directory"
  when: p.stat.isdir is defined and p.stat.isdir

- name: Do not calculate the checksum
  ansible.builtin.stat:
    path: /path/to/myhugefile
    get_checksum: no

- name: Use sha256 to calculate the checksum
  ansible.builtin.stat:
    path: /path/to/something
    checksum_algorithm: sha256
a�&
stat:
    description: Dictionary containing all the stat data, some platforms might add additional fields.
    returned: success
    type: complex
    contains:
        exists:
            description: If the destination path actually exists or not
            returned: success
            type: bool
            sample: True
        path:
            description: The full path of the file/object to get the facts of
            returned: success and if path exists
            type: str
            sample: '/path/to/file'
        mode:
            description: Unix permissions of the file in octal representation as a string
            returned: success, path exists and user can read stats
            type: str
            sample: 1755
        isdir:
            description: Tells you if the path is a directory
            returned: success, path exists and user can read stats
            type: bool
            sample: False
        ischr:
            description: Tells you if the path is a character device
            returned: success, path exists and user can read stats
            type: bool
            sample: False
        isblk:
            description: Tells you if the path is a block device
            returned: success, path exists and user can read stats
            type: bool
            sample: False
        isreg:
            description: Tells you if the path is a regular file
            returned: success, path exists and user can read stats
            type: bool
            sample: True
        isfifo:
            description: Tells you if the path is a named pipe
            returned: success, path exists and user can read stats
            type: bool
            sample: False
        islnk:
            description: Tells you if the path is a symbolic link
            returned: success, path exists and user can read stats
            type: bool
            sample: False
        issock:
            description: Tells you if the path is a unix domain socket
            returned: success, path exists and user can read stats
            type: bool
            sample: False
        uid:
            description: Numeric id representing the file owner
            returned: success, path exists and user can read stats
            type: int
            sample: 1003
        gid:
            description: Numeric id representing the group of the owner
            returned: success, path exists and user can read stats
            type: int
            sample: 1003
        size:
            description: Size in bytes for a plain file, amount of data for some special files
            returned: success, path exists and user can read stats
            type: int
            sample: 203
        inode:
            description: Inode number of the path
            returned: success, path exists and user can read stats
            type: int
            sample: 12758
        dev:
            description: Device the inode resides on
            returned: success, path exists and user can read stats
            type: int
            sample: 33
        nlink:
            description: Number of links to the inode (hard links)
            returned: success, path exists and user can read stats
            type: int
            sample: 1
        atime:
            description: Time of last access
            returned: success, path exists and user can read stats
            type: float
            sample: 1424348972.575
        mtime:
            description: Time of last modification
            returned: success, path exists and user can read stats
            type: float
            sample: 1424348972.575
        ctime:
            description: Time of last metadata update or creation (depends on OS)
            returned: success, path exists and user can read stats
            type: float
            sample: 1424348972.575
        wusr:
            description: Tells you if the owner has write permission
            returned: success, path exists and user can read stats
            type: bool
            sample: True
        rusr:
            description: Tells you if the owner has read permission
            returned: success, path exists and user can read stats
            type: bool
            sample: True
        xusr:
            description: Tells you if the owner has execute permission
            returned: success, path exists and user can read stats
            type: bool
            sample: True
        wgrp:
            description: Tells you if the owner's group has write permission
            returned: success, path exists and user can read stats
            type: bool
            sample: False
        rgrp:
            description: Tells you if the owner's group has read permission
            returned: success, path exists and user can read stats
            type: bool
            sample: True
        xgrp:
            description: Tells you if the owner's group has execute permission
            returned: success, path exists and user can read stats
            type: bool
            sample: True
        woth:
            description: Tells you if others have write permission
            returned: success, path exists and user can read stats
            type: bool
            sample: False
        roth:
            description: Tells you if others have read permission
            returned: success, path exists and user can read stats
            type: bool
            sample: True
        xoth:
            description: Tells you if others have execute permission
            returned: success, path exists and user can read stats
            type: bool
            sample: True
        isuid:
            description: Tells you if the invoking user's id matches the owner's id
            returned: success, path exists and user can read stats
            type: bool
            sample: False
        isgid:
            description: Tells you if the invoking user's group id matches the owner's group id
            returned: success, path exists and user can read stats
            type: bool
            sample: False
        lnk_source:
            description: Target of the symlink normalized for the remote filesystem
            returned: success, path exists and user can read stats and the path is a symbolic link
            type: str
            sample: /home/foobar/21102015-1445431274-908472971
        lnk_target:
            description: Target of the symlink.  Note that relative paths remain relative
            returned: success, path exists and user can read stats and the path is a symbolic link
            type: str
            sample: ../foobar/21102015-1445431274-908472971
            version_added: 2.4
        md5:
            description: md5 hash of the file; this will be removed in Ansible 2.9 in
                favor of the checksum return value
            returned: success, path exists and user can read stats and path
                supports hashing and md5 is supported
            type: str
            sample: f88fa92d8cf2eeecf4c0a50ccc96d0c0
        checksum:
            description: hash of the file
            returned: success, path exists, user can read stats, path supports
                hashing and supplied checksum algorithm is available
            type: str
            sample: 50ba294cdf28c0d5bcde25708df53346825a429f
        pw_name:
            description: User name of owner
            returned: success, path exists, user can read stats, owner name can be looked up and installed python supports it
            type: str
            sample: httpd
        gr_name:
            description: Group name of owner
            returned: success, path exists, user can read stats, owner group can be looked up and installed python supports it
            type: str
            sample: www-data
        mimetype:
            description: file magic data or mime-type
            returned: success, path exists and user can read stats and
                installed python supports it and the I(mime) option was true, will
                return C(unknown) on error.
            type: str
            sample: application/pdf; charset=binary
        charset:
            description: file character set or encoding
            returned: success, path exists and user can read stats and
                installed python supports it and the I(mime) option was true, will
                return C(unknown) on error.
            type: str
            sample: us-ascii
        readable:
            description: Tells you if the invoking user has the right to read the path
            returned: success, path exists and user can read the path
            type: bool
            sample: False
            version_added: 2.2
        writeable:
            description: Tells you if the invoking user has the right to write the path
            returned: success, path exists and user can write the path
            type: bool
            sample: False
            version_added: 2.2
        executable:
            description: Tells you if the invoking user has execute permission on the path
            returned: success, path exists and user can execute the path
            type: bool
            sample: False
            version_added: 2.2
        attributes:
            description: list of file attributes
            returned: success, path exists and user can execute the path
            type: list
            sample: [ immutable, extent ]
            version_added: 2.3
        version:
            description: The version/generation attribute of a file according to the filesystem
            returned: success, path exists, user can execute the path, lsattr is available and filesystem supports
            type: str
            sample: "381700746"
            version_added: 2.3
N)
�
AnsibleModule)
�to_bytesc	��|j}td$id
d�
d|
�
ddtj|�
�
z�
dtj|�
�
�
dtj|�
�
�
dtj|�
�
�
d	tj|�
�
�
d
tj|�
�
�
dtj	|�
�
�
dtj
|�
�
�
d
|j�
d|j�
d|j
�
d|j�
d|j�
d|j�
d|j�
d|j�
d|j�
dt)|tjz
�
�
�
dt)|tjz
�
�
�
dt)|tjz
�
�
�
dt)|tjz
�
�
�
dt)|tjz
�
�
�
dt)|tjz
�
�
�
dt)|tjz
�
�
�
dt)|tjz
�
�
�
dt)|tjz
�
�
�
dt)|tjz
�
�
�
d t)|tjz
�
�
�
�
}d!D]7}tA||d"��rtC||d"��||d#<�8|S)%N�existsT�path�modez%04o�isdir�ischr�isblk�isreg�isfifo�islnk�issock�uid�gid�size�inode�dev�nlink�atime�mtime�ctime�wusr�rusr�xusr�wgrp�rgrp�xgrp�woth�roth�xoth�isuid�isgid))�	st_blocks�blocks)�
st_blksize�
block_size)�st_rdev�device_type)�st_flags�flags)�st_gen�
generation)�st_birthtime�	birthtime)�st_ftype�	file_type)�st_attrs�attrs)�	st_obtype�object_type)�st_rsize�	real_size)�
st_creator�creator)�st_typer4r�
�)"�st_mode�dict�stat�S_IMODE�S_ISDIR�S_ISCHR�S_ISBLK�S_ISREG�S_ISFIFO�S_ISLNK�S_ISSOCK�st_uid�st_gid�st_size�st_ino�st_dev�st_nlink�st_atime�st_mtime�st_ctime�bool�S_IWUSR�S_IRUSR�S_IXUSR�S_IWGRP�S_IRGRP�S_IXGRP�S_IWOTH�S_IROTH�S_IXOTH�S_ISUID�S_ISGID�hasattr�getattr)�moduler
�str�output�others      �9/usr/lib/python3.11/site-packages/ansible/modules/stat.py�
format_outputrg�
s���
�:�D������t��
�T���d�l�4�(�(�
(�
(���l�4� � � �	�
�l�4� � � ���l�4� � � �
��l�4� � � ���}�T�"�"�"���l�4� � � ���}�T�"�"�"��
�I�I��
�I�I���Z�Z���i�i��
�I�I�� �k�k�!�"�k�k�#�$�k�k�%�&�k�k�'�(�$���%�
&�
&�
&�)�*�$���%�
&�
&�
&�+�,�$���%�
&�
&�
&�-�.�$���%�
&�
&�
&�/�0�$���%�
&�
&�
&�1�2�$���%�
&�
&�
&�3�4�$���%�
&�
&�
&�5�6�$���%�
&�
&�
&�7�8�$���%�
&�
&�
&�9�:�4�$�,�&�'�'�'�;�<�4�$�,�&�'�'�'�=�F�D
�5�5��$�2�u�Q�x� � �
	5�&�r�5��8�4�4�F�5��8����M�c�z	�t
ttd
dddg���tdd���tdd���tdd���tddgd	�
�
��tddddg�
��td
dgd�
ddg������d���}|j�d
�
�
}
t	|
d���}|j�d�
�
}|j�d�
�
}|j�d�
�
}|j�d�
�
}|j�d�
�
}|j�d�
�
}	|rtj|�
�
}	ntj|�
�
}	nb#t$rU}
|
j	tj
krddi
}|�d|���
|�|
j
��
�

Yd}
~
nd}
~
w
wxYw
t||
|	��}d t
jfd!t
jfd"t
jffD]&}tj||d#��||d$<�'|�d%�
�
r9t
j�|�
�
|d&<tj|�
�
|d'<	t-j|	j�
�
}
|
j|d(<n#t4t6f$r
YnwxYw
	t9j|	j�
�
}|j|d)<n#t6t@tBf$r
YnwxYw
|�d*�
�
ra|�d �
�
rL|r/	|�"|�
�
|d+<n#t@$r
d|d+<YnwxYw
|r|�#||��|d<|r�d,x
|d-<|d.<|�$d/�
�
}|r�|d0d1|g}	|�%|�
�
\}}}|d$kry|�&d2d#��d#�'d3�
�
\}}|�(��|d-<|�'d4�
�
d#�(��|d.<n#tR$r
YnwxYw
|r8d|d5<g|d<d6|d7<|�*|�
�
}d8D]}||vr||||<�|�d|���
dS)9Nr
T�dest�name)�type�required�aliasesrTF)rl�default)�mime�	mime_typez	mime-type)rlrorn�attr�
attributes�str�sha1)�md5ru�sha224�sha256�sha384�sha512�checksum�
checksum_algo)rlro�choicesrn)r
�follow�get_md5�get_checksum�get_mime�get_attributes�checksum_algorithm)�
argument_spec�supports_check_mode�surrogate_or_strict)
�errorsr~r�r�r�r�rr	)�changedrB)
�msg�readable�	writeable�
executabler>rr�
lnk_source�
lnk_target�pw_name�gr_namerrv�unknown�mimetype�charset�filez--mime-typez--mime-encoding�
:�
;�
=�version��
attr_flags)r�rsr�)+rrA�params�getr�osrB�lstat�OSError�errno�ENOENT�	exit_json�	fail_json�strerrorrg�R_OK�W_OK�X_OK�accessr
�realpath�readlink�pwd�getpwuidrKr��	TypeError�KeyError�grp�getgrgidrLr��
ValueError�
OverflowErrorrv�digest_from_file�get_bin_path�run_command�rsplit�split�strip�	Exception�get_file_attributes)rbr
�b_pathr~r��get_attrr�r�rrc�
erd�perm�pw�grp_info�mimecmd�rc�out�errr�r��
xs                      rf�mainr��
so��
���6�D�6�6�:J�K�K�K��V�U�3�3�3��f�e�4�4�4��6�4�8�8�8��v�t�=_�=_�=_�`�`�`��V�T�F�L�CY�Z�Z�Z�#���,c�,c�,c�-7��,I� K
� K
� K
�

�

�

�!�
�
�
�F��=���V�$�$�D�
�d�#8�
9�
9�
9�F�
�]�
�
�x�
(�
(�F��}� � ��,�,�H��}� � �!1�2�2�H��=�$�$�^�4�4�L���*�*�+?�@�@���m���	�*�*�G�
)��	"������B�B���&�!�!�B����)�)�)��7�e�l�"�"���&�F����U���8�8�8����Q�Z��(�(�(�(�(�(�(�(�����)�����6�4��
,�
,�F��b�g�&��b�g�(>��r�w�@W�X�
5�
5���)�F�D��G�4�4��t�A�w����z�z�'���3�!�w�/�/��7�7��|��!�{�6�2�2��|��
�
�\�"�)�
$�
$���J��y�����x� �

�

�

���

����
��<��	�*�*��$�,��y�����j�-�0�

�

�

���

�����z�z�'���U
�v�z�z�*�5�5�U
��	%�
%� &�
�
�6� 2� 2��u�
�
���

%�

%�

%� $��u�
�
�
�

%�����
	U
�!'�!8�!8��AS�!T�!T�F�:����1:�:��z��V�I�.��%�%�f�-�-���		��
�/@�&�I�G�
�%�1�1�'�:�:���C����7�7�(+�
�
�3�
�(:�(:�1�(=�(C�(C�C�(H�(H�%�H�g�)1���)9�)9�F�:�&�(/�
�
�c�(:�(:�1�(=�(C�(C�(E�(E�F�9�%����

�

�

���

�����#� ��y��!��|��!��|���(�(��0�0��8�	#�	#�A��C�x�x��
�F��q�	��
���U���0�0�0�0�0sb�&+F�
G1�AG,�,G1�$#K�K�
K� #L�L�
L�M'�'M9�8
M9�
BQ�
Q'�&
Q'�__main__)�
__future__rrrrl�
__metaclass__�
DOCUMENTATION�EXAMPLES�RETURNr�r�r�r�rB�ansible.module_utils.basicr�ansible.module_utils._textrrgr��__name__r?rhrf�<module>r�
s��


�

A
�@�@�@�@�@�@�@�@�@��
�C
�
�J?��Bj
��X

����
�
�
�
�	�	�	�	�
�
�
�
�����
5�4�4�4�4�4�/�/�/�/�/�/�;
�;
�;
�|
h

1�h

1�h

1�V�z����D�F�F�F�F�F��rh