8.182 LSTAT — Get file status

Description:

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

The elements in VALUES are the same as described by STAT — Get file status.

This intrinsic is provided in both subroutine and function forms; however, only one form can be used in any given program unit.

Standard:

GNU extension

Class:

Subroutine, function

Syntax:
CALL LSTAT(NAME, VALUES [, STATUS])
STATUS = LSTAT(NAME, VALUES)
Arguments:
NAMEThe type shall be CHARACTER of the default kind, a valid path within the file system.
VALUESThe 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 — Get file status for an example.

See also:

To stat an open file: FSTAT — Get file status To stat a file: STAT — Get file status