LINK(2)                  HP Integral PC                   LINK(2)
     LINK(2)                  HP Integral PC                   LINK(2)
     LINK(2)                  HP Integral PC                   LINK(2)
     LINK(2)                  HP Integral PC                   LINK(2)



     NAME
     NAME
     NAME
     NAME
          link - link to a file

     SYNOPSIS
     SYNOPSIS
     SYNOPSIS
     SYNOPSIS
          int link (path1, path2)
          char *path1, *path2;

     DESCRIPTION
     DESCRIPTION
     DESCRIPTION
     DESCRIPTION
          Path1 points to a path name naming an existing file.  Path2
          points to a path name naming the new directory entry to be
          created.  Link creates a new link (directory entry) for the
          existing file.

          Link will fail and no link will be 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 path1 does not exist.  [ENOENT]

               The link named by path2 exists.  [EEXIST]

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

               Path2 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]

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

     RETURN VALUE
     RETURN VALUE
     RETURN VALUE
     RETURN VALUE
          Upon successful completion, a value of 0 is returned.
          Otherwise, a value of -1 is returned and errno is set to
          indicate the error.

     SEE ALSO
     SEE ALSO
     SEE ALSO
     SEE ALSO
          link(1M), unlink(2).





     Hewlett-Packard               - 1 -            (printed 12/12/84)