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.
6 .. index:: SYMLNK, file system, create link, file system, soft link
10 SYMLNK --- Create a symbolic link
11 *********************************
13 .. function:: SYMLNK(PATH1, PATH2)
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.
24 Shall be of default ``CHARACTER`` type.
27 Shall be of default ``CHARACTER`` type.
30 (Optional) Shall be of default ``INTEGER`` type.
39 .. code-block:: fortran
41 CALL SYMLNK(PATH1, PATH2 [, STATUS])
42 STATUS = SYMLNK(PATH1, PATH2)