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



NAME
     link - make a hard link to a file

SYNOPSIS
     link(name1, name2)
     char *name1, *name2;

DESCRIPTION
     A hard link to name1 is created; the link has the name
     name2.  name1 must exist.

     With hard links, both name1 and name2 must be in the same
     file system.  Unless the caller is the super-user, name1
     must not be a directory.  Both the old and the new link
     share equal access and rights to the underlying object.

RETURN VALUE
     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.

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.

     [EINVAL]            Either pathname contains a character
                         with the high-order bit set.

     [ENAMETOOLONG]      A component of either pathname exceeded
                         255 characters, or entire length of
                         either path name exceeded 1023 charac-
                         ters.

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

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

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

     [ELOOP]             Too many symbolic links were encountered
                         in translating one of the pathnames.

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

     [EEXIST]            The link named by name2 does exist.



                        Printed 11/19/92                   Page 1

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



     [EPERM]             The file named by name1 is a directory
                         and the effective user ID is not super-
                         user.

     [EXDEV]             The link named by name2 and the file
                         named by name1 are on different file
                         systems.

     [ENOSPC]            The directory in which the entry for the
                         new link is being placed cannot be
                         extended because there is no space left
                         on the file system containing the direc-
                         tory.

     [EDQUOT]            The directory in which the entry for the
                         new link is being placed cannot be
                         extended because the user's quota of
                         disk blocks on the file system contain-
                         ing the directory has been exhausted.

     [EIO]               An I/O error occurred while reading from
                         or writing to the file system to make
                         the directory entry.

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

     [EFAULT]            One of the pathnames specified is out-
                         side the process's allocated address
                         space.

SEE ALSO
     symlink(2), unlink(2)






















 Page 2                 Printed 11/19/92