link, symlnk (3f)

makes a link to an existing file

Syntax

  integer*4 link, ierrno
  character*len name1, name2
  external link
  ierrno = link ( name1, name2 )

  integer*4 symlnk, ierrno
  character*len name1, name2
  external symlnk
  ierrno = symlnk ( name1, name2 )

Description

  The link function creates a hard link to the existing file specified by
  name1.  The symlnk function creates a symbolic link to the existing file
  specified by name1.

  The name1 argument must be the pathname of an existing file.  The name2
  argument is the pathname to be linked to the name1 file; name2 must not
  already exist.

  The link function requires that name1 and name2 be within the same file
  system; that is, you cannot use link to create a link between two files
  residing on different NFS mounted disks. Use symlnk to create such a link.

Restrictions

  Pathnames cannot be longer than MAXPATHLEN (as defined in sys/param.h ).

Return Values

  Both functions return zero if they are successful; otherwise, they return
  an error code.

See Also

 link(2), symlink(2), perror(3f), unlink(3f)