/sys/doc/ Documentation archive



LINK(II)                      8/5/73                     LINK(II)



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 -