LINK(2) LINK(2)
NAME
link, symlink, readlink - link to a file
SYNOPSIS
link(name1, name2)
char *name1, *name2;
symlink(name1, name2)
char *name1, *name2;
readlink(name, buf, size)
char *name, *buf;
DESCRIPTION
A link to name1 is created; the link has the name name2.
Either name may be an arbitrary path name. After link,
name2 is entirely equivalent to name1; it is a directory
entry referring to the same file as name1.
After symlink, name2 is a new symbolic link; when it is
encountered in any path name, name1 is substituted for
name2, and path name parsing continues. If name1 begins
with the `/' character, it is interpreted with respect to
the root directory; if not, it is interpreted with respect
to the directory in which name2 resides.
The readlink call returns the contents of a symbolic link
name into buf. No more than size characters are returned.
If there is room, the returned string will be null-padded.
An error is reported if name is not a symbolic link.
SEE ALSO
ln(1), unlink(2), stat(2)
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. With link, only the
super-user may link to a directory. Furthermore, the target
must exist in the same file system, and not have too many
links.