.th file_stat_block IIa 4/21/86
.sh NAME
file_stat_block \- file status block
.sh SYNOPSIS
.nf
 file_stat_block = RECORD

       f_size          : cardinal32;
       subtype         : seid;      
       time_last_mod   : cardinal32;
       open_at_crash   : boolean    
 END;
.fi
.sh DESCRIPTION
The file status block is used to return information about files,
terminals, extents and devices.
.s3
.lp 20 14
.In f_size
is the number of characters in the file.
The kernel keeps internal track of the highest block
number written in the file.
The
K_device_function
SETFILESIZE
can also be used to set this
field.
.s3
.lp  20 14
.In subtype
is the
Seid
of the subtype of the I/O object or the
null seid
if the object is not subtyped.
.s3
.lp 20 14
.In time_last_mod
is the time of last modification of the text of a file.
It is represented as the number of ticks since
January 1, 1980.
This time is only updated on
K_open
and
K_close and only
if the open mode allows write access.
For all I/O objects other than files, this value is zero.
.s3
.lp 20 14
.In open_at_crash
is
true
if the file was open for writing when the system crashed.
The next open for writing will clear
open_at_crash.
The file system recovery program(s) should be run on all files
with this field set.
For non-file objects,
open_at_crash
is always false.
It should be noted that when
open_at_crash
is true,
f_size
may be incorrect.
.i0
.sh "SEE ALSO"
K_get_file_status (II),
K_device_function (II),
Seid (IIa),
ioFunction(IIa)
