Provides the same file status information as the Perl
functions stat
and lstat
. Exports two functions
that return File::stat objects. The objects
have methods that return the equivalent fields from the Unix stat(2)
call:
Field | Meaning |
---|---|
dev | Device number of filesystem |
ino | Inode number |
mode | File mode |
nlink | Number of links to the file |
uid | Numeric user ID of owner |
gid | Numeric group ID of owner |
rdev | Device identifier |
size | Size of file, in bytes |
atime | Last access time |
mtime | Last modified time |
ctime | Inode change time |
blksize | Preferred blocksize for filesystem I/O |
blocks | Number of blocks allocated |
You can access the status fields either with the methods or by
importing the fields into your namespace with the :FIELDS import tag and
then accessing them by prepending st_
to the field name (e.g., $st_mode
). Here are examples of
doing it both ways:
use File::stat; $stats = stat($file); print $stats->uid; print $st_uid;