.TH LINK 2 "12 February 1983"
link \- make a hard link to a file
must be in the same file system.
Unless the caller is the super-user,
share equal access and rights to
Upon successful completion, a value of 0 is returned. Otherwise,
a value of \-1 is returned and
is set to indicate the error.
will fail and no link will be created if one or more of the following
Either pathname contains a byte with the high-order bit set.
Either pathname was too long.
A component of either path prefix is not a directory.
A component of either path prefix does not exist.
A component of either path prefix denies search permission.
The file named by \fIname1\fP does not exist.
The link named by \fIname2\fP does exist.
The file named by \fIname1\fP is a directory and the effective
user ID is not super-user.
The link named by \fIname2\fP and the file named by \fIname1\fP
are on different file systems.
The requested link requires writing in a directory with a mode
that denies write permission.
The requested link requires writing in a directory on a read-only file
One of the pathnames specified
is outside the process's allocated address space.
Too many symbolic links were encountered in translating the pathname.