man(1) Manual page archive


NAME
     link - link to a file

SYNOPSIS
     (link = 9.)
     sys link; name1; name2

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

DESCRIPTION
     A link to name1 is created; the link has the name name2.
     Either name may be an arbitrary path name.

SEE ALSO
     link (I), unlink (II)

DIAGNOSTICS
     The error bit (c-bit) is set when name1 cannot be found;
     when name2 already exists; when the directory of name2 can-
     not be written; when an attempt is made to link to a direc-
     tory by a user other than the super-user; 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.

 1