]>
Commit | Line | Data |
---|---|---|
c63539ff ML |
1 | .. |
2 | Copyright 1988-2022 Free Software Foundation, Inc. | |
3 | This is part of the GCC manual. | |
4 | For copying conditions, see the copyright.rst file. | |
5 | ||
6 | .. _lstat: | |
7 | ||
8 | LSTAT --- Get file status | |
9 | ************************* | |
10 | ||
11 | .. index:: LSTAT, file system, file status | |
12 | ||
13 | .. function:: LSTAT(NAME, VALUES, STATUS) | |
14 | ||
15 | ``LSTAT`` is identical to :ref:`STAT`, except that if path is a | |
16 | symbolic link, then the link itself is statted, not the file that it | |
17 | refers to. | |
18 | ||
19 | :param NAME: | |
20 | The type shall be ``CHARACTER`` of the default | |
21 | kind, a valid path within the file system. | |
22 | ||
23 | :param VALUES: | |
24 | The type shall be ``INTEGER(4), DIMENSION(13)``. | |
25 | ||
26 | :param STATUS: | |
27 | (Optional) status flag of type ``INTEGER(4)``. | |
28 | Returns 0 on success and a system specific error code otherwise. | |
29 | ||
30 | Standard: | |
31 | GNU extension | |
32 | ||
33 | Class: | |
34 | Subroutine, function | |
35 | ||
36 | Syntax: | |
37 | .. code-block:: fortran | |
38 | ||
39 | CALL LSTAT(NAME, VALUES [, STATUS]) | |
40 | STATUS = LSTAT(NAME, VALUES) | |
41 | ||
42 | Example: | |
43 | See :ref:`STAT` for an example. | |
44 | ||
45 | See also: | |
46 | To stat an open file: | |
47 | :ref:`FSTAT` | |
48 | To stat a file: | |
3ed1b4ce | 49 | :ref:`STAT` |