LINK(2) — HP-UX

NAME

link − link to a file

SYNOPSIS

int link (path1, path2)
char ∗path1, ∗path2;

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.

ERRORS

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.

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

[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. The reliable detection of this error will be implementation dependent.

[ENOENT] Path1 or path2 is null.

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

[ENAMETOOLONG] Either path specified exceeds MAXPATHLEN characters.

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

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.

Museum