link(3f) [bsd man page]

LINK(3F)																  LINK(3F)

NAME

       link - make a link to an existing file

SYNOPSIS

       function link (name1, name2)
       character*(*) name1, name2

       integer function symlnk (name1, name2)
       character*(*) name1, name2

DESCRIPTION

       Name1  must  be	the  pathname  of  an  existing file.  Name2 is a pathname to be linked to file name1.	Name2 must not already exist.  The
       returned value will be 0 if successful; a system error code otherwise.

       Symlnk creates a symbolic link to name1.

FILES

       /usr/lib/libU77.a

SEE ALSO

       link(2), symlink(2), perror(3F), unlink(3F)

BUGS

       Pathnames can be no longer than MAXPATHLEN as defined in <sys/param.h>.

4.2 Berkeley Distribution					   May 15, 1985 							  LINK(3F)

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)