LINK(2)                              BSD                               LINK(2)



NAME
     link - make a hard link to a file

SYNOPSIS
     link(name1, name2)
     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.  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.

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.

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

     [EFAULT]         One of the pathnames specified is outside the process'
                      allocated address space.

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.