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 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  —  HP-UX Release 9.0: August 1992