LINK(2-SysV)        RISC/os Reference Manual         LINK(2-SysV)



NAME
     link - link to a file

SYNOPSIS
     int link (path1, path2)
     char *path1, *path2;

DESCRIPTION
     path1 points to a path name naming an existing file.  path2
     points to a path name naming the new directory entry to be
     created.  link creates a new link (directory entry) for the
     existing file.

ERRORS
     link will fail and no link will be created if one or more of
     the following are true:

     [ENOTDIR]                A component of either path prefix
                              is not a directory.

     [ENOENT]                 A component of either path prefix
                              does not exist.

     [EACCES]                 A component of either path prefix
                              denies search permission.

     [ENOENT]                 The file named by path1 does not
                              exist.

     [EEXIST]                 The link named by path2 exists.

     [EPERM]                  The file named by path1 is a direc-
                              tory and the effective user ID is
                              not super-user.

     [EXDEV]                  The link named by path2 and the
                              file named by path1 are on dif-
                              ferent logical devices (file sys-
                              tems).

     [ENOENT]                 path2 points to a null path name.

     [EACCES]                 The requested link requires writing
                              in a directory with a mode that
                              denies write permission.

     [EROFS]                  The requested link requires writing
                              in a directory on a read-only file
                              system.

     [EFAULT]                 path points outside the allocated
                              address space of the process.



                         Printed 1/15/91                   Page 1

LINK(2-SysV)        RISC/os Reference Manual         LINK(2-SysV)



     [EMLINK]                 The maximum number of links to a
                              file would be exceeded.

     [EINTR]                  A signal was caught during the link
                              system call.

     [ENOLINK]                path points to a remote machine and
                              the link to that machine is no
                              longer active.

     [EMULTIHOP]              Components of path require hopping
                              to multiple remote machines.

SEE ALSO
     unlink(2).

DIAGNOSTICS
     Upon successful completion, a value of 0 is returned.  Oth-
     erwise, a value of -1 is returned and errno is set to indi-
     cate the error.



































 Page 2                  Printed 1/15/91