LINK(2) 							System Calls Manual							   LINK(2)

NAME

       link - make a hard link to a file

SYNOPSIS

       #include <unistd.h>

       int link(const char *name1, const char *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.  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:

       [ENOTDIR]      A component of either path prefix is not a directory.

       [ENAMETOOLONG] A path name exceeds PATH_MAX characters.

       [ENOENT]       A component of either path prefix does not exist.

       [EACCES]       A component of either path prefix denies search permission.

       [EACCES]       The requested link requires writing in a directory with a mode that denies write permission.

       [ELOOP]	      Too many symbolic links were encountered in translating one of the pathnames.  (Minix-vmd)

       [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.

       [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 to make the directory entry.

       [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.

SEE ALSO

       symlink(2), unlink(2).

4th Berkeley Distribution					  August 26, 1985							   LINK(2)