.th link IV 4/21/86
.sh NAME
link - link to a file
.sh SYNOPSIS
link(name1, name2)
.br
char *name1, *name2;
.ft R
.sh DESCRIPTION
A link to name1 is created; the link has the name name2.  Either name
may be an arbitrary path name.
.sh "SEE ALSO"
unlink (IV)
.sh DIAGNOSTICS
The error bit (c-bit) is set when name1 cannot be found; when name2
already exists; when the directory of name2 cannot be written; when an
attempt is made to link to a directory; when an attempt is made to link
to a file on another file system; when more than 127 links are made.
From C, a -1 return indicates an error, a 0 return indicates success.

