Table of Contents

Synopsis:
Technical:
Practical:
Returns:

# $EPIC: stat.txt,v 1.3 2007/03/02 02:32:04 jnelson Exp $

Synopsis:

$stat(<filename>)

Technical:

The <filename> is a dword which is different from most function arguments.
If the <filename> argument is omitted the empty string is returned.
If the <filename> argument cannot be stat(2)ed, the empty string is returned. This can happen for any of the error reasons listed in the stat(2) man page.
Otherwise this function returns a list of words as such:

$0	The device number
$1	The inode number
$2	Permissions of the file (in octal)
$3	Number of links to file
$4	UID of the owner of the file
$5	GID of the group of the file
$6	Device Type (for device files)
$7	Size of the file (truncated to 32 bits)
$8	Size of one block (truncated to 32 bits)
$9	Size of file in blocks (truncated to 32 bits)
$10	Last time file was read (atime)
$11	Last time file's contents changed (mtime)
$12	Last time inode changed (ctime)

Practical:

This can be used to give you exhaustive information about a file.

Returns:

A list of words that exhaustively describe the state of a file.