---

8.188 LSTAT — Get file status ¶

Synopsis:

CALL LSTAT(NAME, VALUES [, STATUS])

STATUS = LSTAT(NAME, VALUES)

Description:

LSTAT is identical to STAT — Get file status, except that if path is a symbolic link, then the operation is performed on the link itself, 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.

Class:

Subroutine, function

Arguments:

NAME	The type shall be CHARACTER of the default kind, a valid path within the file system.
VALUES	The type shall be INTEGER, DIMENSION(13) of either kind 4 or kind 8.
STATUS	(Optional) status flag of type INTEGER of kind 2 or larger. Returns 0 on success and a system specific error code otherwise.

Example:

See STAT — Get file status for an example.

Standard:

GNU extension

See also:

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