SYMLINK(2) SYMLINK(2)
NAME
symlink - make symbolic link to a file
SYNOPSIS
int symlink(name1, name2)
char *name1, *name2;
DESCRIPTION
A symbolic link name2 is created to name1 (name2 is the name
of the file created, name1 is the string used in creating
the symbolic link). Either name may be an arbitrary path
name; the files need not be on the same file system.
RETURN VALUE
Upon successful completion, a zero value is returned. If an
error occurs, the error code is stored in errno and a -1
value is returned.
ERRORS
The symbolic link is made unless one or more of the
following are true:
[EPERM] Either name1 or name2 contains a character
with the high-order bit set.
[EPERM] A pathname contains a character with the
high-order bit set.
[ENAMETOOLONG]
A component of a pathname exceeded NAME_MAX
characters, or an entire pathname exceeded
PATH_MAX.
[ELOOP] Too many symbolic links were encountered in
translating a pathname.
[ENOENT] One of the pathnames specified was too long.
[ENOTDIR] A component of the name2 prefix is not a
directory.
Page 1 May 1989
SYMLINK(2) SYMLINK(2)
[EEXIST] name2 already exists.
[EACCES] A component of the name2 path prefix denies
search permission.
[EROFS] The file name2 would reside on a read-only
file system.
[EFAULT] name1 or name2 points outside the process'
allocated address space.
SEE ALSO
ln(1), link(2), readlink(2), unlink(2).
Page 2 May 1989