NAME

symlink − make symbolic link to a file

SYNTAX

int symlink(name1, name2)
char *name1, *name2;

DESCRIPTION

The symlink system call creates a symbolic link with name2 to the specified file name1. Either name may be an arbitrary path name, and the files need not be on the same file system. 

RETURN VALUE

If unsuccessful, returns a −1, and the global variable errno indicates the error code. 

DIAGNOSTICS

The symlink call will fail if:

[EPERM] Either name1 or name2 contains a character with the high-order bit set. 

[ENOENT] One of the pathnames specified was too long. 

[ENOTDIR] A component of the name2 prefix is not a directory. 

[EEXIST] The specified name2 already exists. 

[EACCES] A component of the name2 path prefix denies search permission. 

[EROFS] The specified name2 would reside on a read-only file system. 

[EFAULT] Either name1 or name2 points outside the process’s allocated address space. 

[ELOOP] Too may symbolic links were encountered in translating the pathname. 

SEE ALSO

ln(1), link(2)