6.129 LSTAT — Get file status

Description:

LSTAT is identical to STAT, except that if path is a symbolic link, then the link itself is statted, not the file that it refers to.

The elements in BUFF are the same as described by STAT.

Standard:

GNU extension

Class:

Non-elemental subroutine

Syntax:

CALL LSTAT(FILE, BUFF [, STATUS])

Arguments:

FILE	The type shall be CHARACTER(*), a valid path within the file system.
BUFF	The type shall be INTEGER(4), DIMENSION(13).
STATUS	(Optional) status flag of type INTEGER(4). Returns 0 on success and a system specific error code otherwise.

Example:

See STAT for an example.

See also:

To stat an open file: FSTAT, to stat a file: STAT