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

     cannot be written; when an attempt is  made  to  link  to  a

     directory  by  a  user  other  than  the super-user; when an

     attempt is made to link to a file on  another  file  system.

     From C, a -1 return indicates an error, a 0 return indicates

     success.