ln(1) [v7 man page]

LN(1)							      General Commands Manual							     LN(1)

NAME

       ln  -  make a link

SYNOPSIS

       ln name1 [ name2 ]

DESCRIPTION

       A  link	is  a  directory entry referring to a file; the same file (together with its size, all its protection information, etc.)  may have
       several links to it.  There is no way to distinguish a link to a file from its original directory entry; any changes in the file are effec-
       tive independently of the name by which the file is known.

       Ln  creates  a  link to an existing file name1.	If name2 is given, the link has that name; otherwise it is placed in the current directory
       and its name is the last component of name1.

       It is forbidden to link to a directory or to link across file systems.

SEE ALSO

       rm(1)

																	     LN(1)

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)