HPUX link[2]

 link(2)                                                             link(2)





 NAME
      link - link to a file

 SYNOPSIS
      #include <unistd.h>

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

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

 RETURN VALUE
      Upon successful completion, link() returns 0; otherwise, it returns -1
      and sets errno to indicate the error.

 ERRORS
      link() fails and no link is created if one or more of the following is
      true:

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

           [EACCES]                 The requested link requires writing in a
                                    directory that does not permit writing.

           [EDQUOT]                 User's disk quota block limit has been
                                    reached for this file system.

           [EEXIST]                 The link named by path2 exists.

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

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

           [ENOENT]                 path2 points to a null path name.

           [ENOSPC]                 The directory to contain the file cannot
                                    be extended.

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

           [EPERM]                  The file named by path1 is a directory
                                    and the effective user ID is not a user
                                    who has appropriate privileges.

           [EXDEV]                  The link named by path2 and the file
                                    named by path1 are on different logical



 Hewlett-Packard Company            - 1 -     HP-UX Release 9.0: August 1992






 link(2)                                                             link(2)





                                    devices (file systems).

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

           [EFAULT]                 path points outside the allocated
                                    address space of the process.  The
                                    reliable detection of this error is
                                    implementation dependent.

           [ENOENT]                 path1 or path2 is null.

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

           [ENAMETOOLONG]           Either specified path exceeds PATH_MAX
                                    bytes, or a component of either
                                    specified path exceeds NAME_MAX while
                                    POSIX_NO_TRUNC is in effect.

           [ELOOP]                  Too many symbolic links were encountered
                                    in translating either path name.

 DEPENDENCIES
    Series 300, 400, and 700:
      If path2 names a symbolic link, link() fails without creating the
      link, -1 is returned, and errno is set to:

           [EEXIST]                 path2 names a symbolic link.

 SEE ALSO
      cp(1), link(1M), symlink(2), symlink(4), unlink(2).

 STANDARDS CONFORMANCE
      link(): AES [Series 300/400/700 only], SVID2, XPG2, XPG3, XPG4, FIPS
      151-2, POSIX.1


















 Hewlett-Packard Company            - 2 -     HP-UX Release 9.0: August 1992