LSTAT (The GNU Fortran Compiler)

### 8.189 `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