Open System Services System Calls Reference Manual (G06.25+, H06.03+)

symlink(2) OSS System Calls Reference Manual
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.
7−180 Hewlett-Packard Company 527186-003