4.3BSD-UWisc/man/cat2/link.2

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 12/27/86         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 12/27/86         August 26, 1985                        2