Open System Services System Calls Reference Manual (G06.28+, H06.05+)

System Functions (s and S) symlink(2)
RETURN VALUES
Upon successful completion, the symlink( ) function returns the value 0 (zero). Otherwise, the
value -1 is returned and errno is set to indicate the error.
ERRORS
If any of the following conditions occurs, the symlink() function sets errno to the corresponding
value:
[EACCES] One of the following conditions exists:
— The requested operation requires writing in a directory
with a mode that denies write permission.
— Search permission is denied on a component of path2.
[EEXIST] The path specified by the path2 parameter already exists.
[EFAULT] Either the path1 or the path2 parameter points outside the
process’s allocated address space.
[EFSBAD] The fileset catalog for one of the filesets involved in the opera-
tion is corrupt.
[EIO] An input/output error occurred during a read from or write to the
fileset.
[ELOOP] Too many symbolic links were found in translating path2.
[ENAMETOOLONG]
One of the following is too long:
— The pathname pointed to by the path1 or path2 parame-
ter
— A component of the pathname pointed to by the path1 or
path2 parameter
— The intermediate result of pathname resolution when a
symbolic link is part of the pathname pointed to by the
path2 parameter
The pathconf( ) function can be called to obtain the applicable
limits.
[ENOENT] One of the following conditions exists:
— A named directory does not exist.
— A specified pathname is an empty string.
— A specified pathname cannot be mapped to a valid Guar-
dian filename.
— The path1 or path2 parameter specifies a file on a
remote HP NonStop node but communication with the
remote node has been lost.
527186-007 Hewlett-Packard Company 7−425