LINK(2)                              BSD                               LINK(2)



NAME
     link - make a hard link to a file

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

DESCRIPTION
     link creates a hard link to name1 and names it name2.  name1 must exist
     before the call to link is made.  Both name1 and name2 must be in the
     same file system. If name1 specifies a directory, link fails.

     Both the old and the new link share equal access and rights to the
     underlying object.

     Domain/OS does not require that the calling process has permission to
     access the existing file.

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

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

     [ENAMETOOLONG]   A component of either pathname exceeded 255 characters,
                      or the entire length of either pathname exceeded 1023
                      characters.

     [ENOENT]         A component of either path prefix does not exist or path
                      points to an empty string.

     [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 already exists.

     [EPERM]          The file named by name1 is a directory.

     [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 directory.

     [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.

SEE ALSO
     symlink(2), unlink(2)

DIAGNOSTICS
     A successful call returns zero.  A failed call returns -1 and sets errno
     to indicate the error.

NOTES
     The following errors, not returned by Domain/OS BSD, may be returned
     under other implementations:

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

     [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 containing the
                      directory has been exhausted.