NAME

symlink − make symbolic link to a file

SYNOPSIS

symlink(name1, name2)
char ∗name1, ∗name2;

DESCRIPTION

A symbolic link to name1 is created; the link is the file name2, containing the string name1.  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 on or more of the following are true:

[EPERM] Either name1 or name2 contains a byte 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] 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’s allocated address space. 

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

SEE ALSO

link(2), ln(1), unlink(2)

Sun System Release 0.3  —  1 April 1983