NAME

link − make a hard link to a file

SYNOPSIS

link(name1, name2)
char ∗name1, ∗name2;

DESCRIPTION

A hard link to name1 is created; the link has the name name2. Name1 must exist. 

With hard links, both name1 and name2 must be in the same file system.  Unless the caller is the super-user, name1 must not be a directory.  Both the old and the new link share equal access and rights to the underlying object. 

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. 

ERRORS

Link will fail and no link will be created if one or more of the following are true:

[EPERM] Either pathname contains a byte with the high-order bit set. 

[ENOENT] Either pathname was too long. 

[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 name1 does not exist. 

[EEXIST] The link named by name2 does exist. 

[EPERM] The file named by name1 is a directory and the effective user ID is not super-user. 

[EXDEV] The link named by name2 and the file named by name1 are on different file systems. 

[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] One of the pathnames specified is outside the process’s allocated address space. 

[ELOOP] Too many symbolic links were encountered in translating the pathname. 

[ENOSPC] The directory in which the entry for the new link is being placed cannot be extended because there is no space left on the file system containing the directory. 

[EIO] An I/O error occurred while reading from or writing to the file system. 

SEE ALSO

symlink(2), unlink(2)

4BSD