LINK(2) — UNIX Programmer’s Manual
NAME
link − link to a file
SYNOPSIS
link(name1, name2)
char *name1, *name2;
DESCRIPTION
A link to name1 is created; the link has the name name2. Either name may be an arbitrary path name. The linked file is actually a pointer to the original file. When the last link to a file is removed the file is deleted.
SEE ALSO
DIAGNOSTICS
Zero is returned when a link is made; −1 is returned when name1 cannot be found; when name2 already exists; when the directory of name2 cannot be written; when an attempt is made to link to a directory by a user other than the super-user; when an attempt is made to link to a file on another file system; when a file has more than 32767 links.
On some systems the super-user may link to non-ordinary files.
7th Edition