.th K_get_file_status II 4/21/86
.sh NAME
K_get_file_status - get type dependent information for any I/O-class object
.sh "MODULA SYNOPSIS"
.nh
.na
 CONST fSeid: seid;
.br
 CONST stCap: openDescriptor;
.br
 VAR status: file_stat_block;
.br
 VAR stat: K_err_num;
.br
 . . .
.br
 stat := NK_get_file_status(fSeid, stCap, status);
.br
.hy
.ad
.sp
.sh "C SYNOPSIS"
.nh
.na
 seid fSeid;
.br
 openDescriptor stCap;
.br
 file_stat_block status;
.br
 int stat;
.br
 . . .
.br
 stat = K_get_file_status (fSeid, stCap, &status);
.br
.hy
.ad
.sh DESCRIPTION
K_get_file_status returns the type dependent information associated
with a file, terminal, extent, or device.  This information includes
the size of the object in bytes (zero for non-addressable devices), and
the time of the last open for writing (meaningful for files only).  The
invoking process must have read access to the file with respect to the
mandatory security and integrity rules only.  No discretionary access
checking is performed.

.sh EXCEPTIONS
.lp 22 15
XbadStCap	The subtype specified is not open or is not defined.
.lp 22 15
XnoClass	The seid does not specify a file, extent or device 
or is an invalid seid.
.lp 22 15
XnoObj	The object specified by the seid does not exist.
.i0
.sh "SEE ALSO"
K_get_object_level(II),
file_stat_block(IIa),
tii_struct(IIa)
