HP-UX Reference (11i v2 07/12) - 2 System Calls (vol 5)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

151

152

153

154

155

156

157

158

159

160

link(2) link(2)

NAME

link() - link to a ﬁle

SYNOPSIS

#include <unistd.h>

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

DESCRIPTION

The link() system call creates a new link (directory entry) for the existing ﬁle. path1 points to a path

name naming an existing ﬁle. path2 points to a path name naming the new directory entry to be created.

RETURN VALUE

Upon successful completion,

link() returns zero. Otherwise, it returns -1 and sets

errno (see errno(2))

to indicate the error.

ERRORS

The

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

[EACCES] A component of either path preﬁx denies search permission.

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

[EDQUOT] The user’s disk quota block limit has been reached for this ﬁle system.

[EEXIST] The link named by path2 exists.

[ENOENT] The ﬁle named by path1 does not exist.

[ENOENT] A component of either path preﬁx does not exist.

[ENOENT] path2 points to a null path name.

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

[ENOTDIR] A component of either path preﬁx is not a directory.

[EPERM] The ﬁle named by path1 is a directory and the effective user ID is not a user who has

appropriate privileges. Some ﬁle systems return this error whenever path1 names a

directory, regardless of the user ID.

[EXDEV] The link named by path2 and the ﬁle named by path1 are on different logical devices

(ﬁle systems).

[EROFS] The requested link requires writing in a directory on a read-only ﬁle 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 ﬁle would be exceeded.

[ENAMETOOLONG]

Either the speciﬁed path exceeds

PATH_MAX bytes, or a component of either speciﬁed

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 700

If path2 names a symbolic link, link() fails without creating the link, it returns -1, and sets errno to

the following value:

[EEXIST] path2 names a symbolic link.