


      LLLLIIIINNNNKKKK((((2222))))                     ((((UUUUNNNNIIIIXXXX 5555....0000))))                    LLLLIIIINNNNKKKK((((2222))))



      NNNNAAAAMMMMEEEE
           link - link to a file

      SSSSYYYYNNNNTTTTAAAAXXXX
           iiiinnnntttt lllliiiinnnnkkkk ((((ppppaaaatttthhhh1111,,,, ppppaaaatttthhhh2222))))
           cccchhhhaaaarrrr ****ppppaaaatttthhhh1111,,,, ****ppppaaaatttthhhh2222;;;;

      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
           _P_a_t_h_1 points to a path name naming an existing file.  _P_a_t_h_2
           points to a path name naming the new directory entry to be
           created.  _L_i_n_k creates a new link (directory entry) for the
           existing file.  _L_i_n_k fails and no link is created if one or
           more of the following are true:

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

                A component of either path prefix does not exist.
                [ENOENT]

                A component of either path prefix denies search
                permission.  [EACCES]

                The file named by _p_a_t_h_1 does not exist.  [ENOENT]

                The link named by _p_a_t_h_2 exists.  [EEXIST]

                The file named by _p_a_t_h_1 is a directory and the
                effective user ID is not super-user.  [EPERM]

                The link named by _p_a_t_h_2 and the file named by _p_a_t_h_1 are
                on different logical devices (file systems).  [EXDEV]

                _P_a_t_h_2 points to a null path name.  [ENOENT]

                The requested link requires writing in a directory with
                a mode that denies write permission.  [EACCES]

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

                _P_a_t_h points outside the process's allocated address
                space.  [EFAULT]

      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
           Upon successful completion, a value of 0 is returned.
           Otherwise, a value of -1 is returned and _e_r_r_n_o is set to
           indicate the error.

      SSSSEEEEEEEE AAAALLLLSSSSOOOO
           unlink(2).




      Page 1                                                   (9010-E)






      LLLLIIIINNNNKKKK((((2222))))                     ((((UUUUNNNNIIIIXXXX 5555....0000))))                    LLLLIIIINNNNKKKK((((2222))))























































      Page 2                                                   (9010-E)






