]>
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 | .. index:: SYMLNK, file system, create link, file system, soft link | |
7 | ||
8 | .. _symlnk: | |
9 | ||
10 | SYMLNK --- Create a symbolic link | |
11 | ********************************* | |
12 | ||
13 | .. function:: SYMLNK(PATH1, PATH2) | |
14 | ||
15 | Makes a symbolic link from file :samp:`{PATH1}` to :samp:`{PATH2}`. A null | |
16 | character (``CHAR(0)``) can be used to mark the end of the names in | |
17 | :samp:`{PATH1}` and :samp:`{PATH2}` ; otherwise, trailing blanks in the file | |
18 | names are ignored. If the :samp:`{STATUS}` argument is supplied, it | |
19 | contains 0 on success or a nonzero error code upon return; see | |
20 | ``symlink(2)``. If the system does not supply ``symlink(2)``, | |
21 | ``ENOSYS`` is returned. | |
22 | ||
23 | :param PATH1: | |
24 | Shall be of default ``CHARACTER`` type. | |
25 | ||
26 | :param PATH2: | |
27 | Shall be of default ``CHARACTER`` type. | |
28 | ||
29 | :param STATUS: | |
30 | (Optional) Shall be of default ``INTEGER`` type. | |
31 | ||
32 | Standard: | |
33 | GNU extension | |
34 | ||
35 | Class: | |
36 | Subroutine, function | |
37 | ||
38 | Syntax: | |
39 | .. code-block:: fortran | |
40 | ||
41 | CALL SYMLNK(PATH1, PATH2 [, STATUS]) | |
42 | STATUS = SYMLNK(PATH1, PATH2) | |
43 | ||
44 | See also: | |
45 | :ref:`LINK`, | |
3ed1b4ce | 46 | :ref:`UNLINK` |