System Calls                                              link(2)



NAME
     link - link to a file

SYNOPSIS
     #include <unistd.h>

     int link(const char *existing, const char *new);

DESCRIPTION
     The link() function creates a new link (directory entry) for
     the existing file and increments its link count by one.  The
     _e_x_i_s_t_i_n_g argument points to a path name naming  an  existing
     file.   The _n_e_w argument points to a pathname naming the new
     directory entry to be created.

     To create hard links, both files must be on  the  same  file
     system. Both the old and the new link share equal access and
     rights to the underlying object.  The  super-user  may  make
     multiple  links  to  a  directory.  Unless the caller is the
     super-user, the file named by _e_x_i_s_t_i_n_g must not be a  direc-
     tory.

     Upon successful completion,  link()  marks  for  update  the
     st_ctime  field of the file. Also, the st_ctime and st_mtime
     fields of the directory that  contains  the  new  entry  are
     marked for update.

RETURN VALUES
     Upon successful completion, 0 is returned. Otherwise, -1  is
     returned,  no  link is created, and errno is set to indicate
     the error.

ERRORS
     The link() function will fail if:

     EACCES
           A component of either path prefix denies  search  per-
           mission,  or  the requested link requires writing in a
           directory with a mode that denies write permission.

     EDQUOT
           The directory where the entry  for  the  new  link  is
           being  placed  cannot  be  extended because the user's
           quota of disk blocks on  that  file  system  has  been
           exhausted.

     EEXIST
           The link named by _n_e_w exists.

     EFAULT
           The _e_x_i_s_t_i_n_g or _n_e_w  argument  points  to  an  illegal
           address.



SunOS 5.8           Last change: 28 Dec 1996                    1






System Calls                                              link(2)



     EINTR A signal was caught during the execution of the link()
           function.

     ELOOP Too many symbolic links were encountered in  translat-
           ing _p_a_t_h.

     EMLINK
           The maximum  number  of  links  to  a  file  would  be
           exceeded.

     ENAMETOOLONG
           The length of the _e_x_i_s_t_i_n_g  or  _n_e_w  argument  exceeds
           PATH_MAX, or the length of a _e_x_i_s_t_i_n_g or _n_e_w component
           exceeds NAME_MAX while _POSIX_NO_TRUNC is in effect.

     ENOENT
           The _e_x_i_s_t_i_n_g or _n_e_w argument is  a  null  pathname;  a
           component of either path prefix does not exist; or the
           file named by _e_x_i_s_t_i_n_g does not exist.

     ENOLINK
           The _e_x_i_s_t_i_n_g  or  _n_e_w  argument  points  to  a  remote
           machine  and  the  link  to  that machine is no longer
           active.

     ENOSPC
           The directory that would contain the  link  cannot  be
           extended.

     ENOTDIR
           A component of either path prefix is not a directory.

     EPERM The file named by _e_x_i_s_t_i_n_g  is  a  directory  and  the
           effective  user  of  the calling process is not super-
           user.

     EROFS The requested link requires writing in a directory  on
           a read-only file system.

     EXDEV The link named by _n_e_w and the file named  by  _e_x_i_s_t_i_n_g
           are on different logical devices (file systems).

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |______________________________|______________________________|
    | MT-Level                    | Async-Signal-Safe           |
    |______________________________|______________________________|




SunOS 5.8           Last change: 28 Dec 1996                    2






System Calls                                              link(2)



SEE ALSO
     symlink(2), unlink(2), attributes(5)





















































SunOS 5.8           Last change: 28 Dec 1996                    3