.IOSTA - find I/O status for a unit.

Alternate Entry Name: _IOSTA

Usage:

B:
   val = .iosta( unit [, status] );

C:
   int _iosta(FILE *unit [,int *status] );

Where:

unit

is the unit for which the status is to be found.

status

is an optional two-word vector where the status is to be put.

val

is the return flag. This is zero if no return status is applicable (e.g. "unit" is not open, or is associated with a tty, or is a string). If there is a status applicable to this unit, "val" receives a pointer to where this status is stored in memory, either in "status" or in the unit's IOV.

Description:

.IOSTA is used to find the I/O status for an open I/O unit. This includes the filsys status for a successful open, and therefore the user information bits. If "status" is not specified but there is a status applicable to the "unit", "val" will receive a pointer to where the status is stored in the unit's IOV.

See Also:

expl b lib io.err

Copyright © 1996, Thinkage Ltd.