ANSIBLE.STAT(3)                 ANSIBLE MODULES                ANSIBLE.STAT(3)



NAME
       stat - retrieve file or file system status

DESCRIPTION
       Retrieves facts for a file similar to the linux/unix 'stat' command.

OPTIONS
       follow Whether to follow symlinks

       path   The full path of the file/object to get the facts of(required).

EXAMPLES
       # Obtain the stats of /etc/foo.conf, and check that the file still belongs
       # to 'root'. Fail otherwise.
       - stat: path=/etc/foo.conf
         register: st
       - fail: msg="Whoops! file ownership has changed"
         when: st.stat.pw_name != 'root'

       # Determine if a path exists and is a directory.  Note we need to test
       # both that p.stat.isdir actually exists, and also that it's set to true.
       - stat: path=/path/to/something
         register: p
       - debug: msg="Path exists and is a directory"
         when: p.stat.isdir is defined and p.stat.isdir == true



AUTHOR
       Bruce Pennypacker

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#stat



1.4.5                             2014-02-12                   ANSIBLE.STAT(3)
