SYMLINK(2)
NAME
symlink − make symbolic link to a file
USAGE
symlink(name1, name2)
char *name1, *name2;
DESCRIPTION
A symbolic link name2 is created to 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
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 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] Name1 or name2 points outside the process’ allocated address space.
[ELOOP] The call encountered too many symbolic links in translating the pathname.