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;

Copyright © 2001 O'Reilly & Associates. All rights reserved.