SYMLINK(2)
NAME
symlink − make symbolic link to a file
USAGE
symlink(name1, name2) char *name1, *name2;
DESCRIPTION
Symlink creates a symbolic link named name2 that references the object named by name1 (name2 is the name of the file created, and name1 is the string used in creating the symbolic link). Either name may be an arbitrary pathname; the files need not be on the same file system.
RETURN VALUE
A successful call returns zero. A failed call returns -1 and sets errno as indicated below.
ERRORS
The symbolic link is made unless on or more of the following are true:
[EPERM] Either name1 or name2 contains a character with the high-order bit set.
[ENOENT] One of the pathnames specified is too long.
[ENOTDIR] A component of the name2 prefix is not a directory.
[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] Either name1 or name2 points outside the process’s allocated address space.
[ELOOP] The call encountered too many symbolic links in translating the pathname.