LINK(2)
NAME
link − link to a file
SYNOPSIS
int link (path1, path2)
char ∗path1, ∗path2;
HP-UX COMPATIBILITY
Level: HP-UX/RUN ONLY
Origin: System V
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:
[ENOTDIR] A component of either path prefix is not a directory.
[ENOENT] A component of either path prefix does not exist.
[EACCES] A component of either path prefix denies search permission.
[ENOENT] The file named by path1 does not exist.
[EEXIST] The link named by path2 exists.
[EPERM] The file named by path1 is a directory and the effective user ID is not super-user.
[EXDEV] The link named by path2 and the file named by path1 are on different logical devices (file systems).
[ENOENT] Path2 points to a null path name.
[EACCES] The requested link requires writing in a directory with a mode that denies write permission.
[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.
[ENOENT] Path1 or path2 is null.
[EMLINK] The maximum number of links to a file would be exceeded.
HARDWARE DEPENDENCIES
Series 500:
For Structured Directory Format (SDF) discs, if path2 is "..", then that directory’s i-node will be altered such that its ".." entry points to the directory specified by path1. In this way, the super-user can establish the parent directory of an existing directory.
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
Hewlett-Packard — last mod. May 11, 2021