2.11BSD/man/cat2/link.0

LINK(2)             UNIX Programmer's Manual		  LINK(2)



NAME
     link - make a hard link to a file

SYNOPSIS
     link(name1, name2)
     char *name1, *name2;

DESCRIPTION
     A hard link to _n_a_m_e_1 is created; the link has the name
     _n_a_m_e_2.  _N_a_m_e_1 must exist.

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

RETURN VALUE
     Upon successful completion, a value of 0 is returned.  Oth-
     erwise, a value of -1 is returned and _e_r_r_n_o is set to indi-
     cate the error.

ERRORS
     _L_i_n_k 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.

     [EINVAL]	    Either pathname contains a character with the
		    high-order bit set.

     [ENAMETOOLONG] A component of either pathname exceeded 255
		    characters, or entire length of either path
		    name exceeded 1023 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 per-
		    mission.

     [ELOOP]	    Too many symbolic links were encountered in
		    translating one of the pathnames.

     [ENOENT]	    The file named by _n_a_m_e_1 does not exist.

     [EEXIST]	    The link named by _n_a_m_e_2 does exist.




Printed 11/26/99	 August 26, 1985			1






LINK(2)             UNIX Programmer's Manual		  LINK(2)



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

     [EXDEV]	    The link named by _n_a_m_e_2 and the file named by
		    _n_a_m_e_1 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.

     [EDQUOT]	    The directory in which the entry for the new
		    link is being placed cannot be extended
		    because the user's quota of disk blocks on
		    the file system containing the directory has
		    been exhausted.

     [EIO]	    An I/O error occurred while reading from or
		    writing to the file system to make the direc-
		    tory 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)


























Printed 11/26/99	 August 26, 1985			2