Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

lchmod(2) OSS System Calls Reference Manual
NOTES
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
this function with 32-bit or 64-bit OSS applications.
RETURN VALUES
Upon successful completion, the lchmod() function returns the value 0 (zero). Otherwise, the
value -1 is returned, and errno is set to indicate the error.
ERRORS
If any of these conditions occur, the lchmod() function sets errno to the corresponding value:
[EACCES] Search permission is denied for a component of the path parameter.
[EFAULT] The path parameter points to a location outside of the allocated address space of
the process.
[EFSBAD] The fileset catalog for one of the filesets involved in the operation is corrupt.
[EINVAL] One of these conditions exists:
• The value of the mode parameter is invalid.
• An attempt was made to set access permissions on a Guardian file (that
is, a file in the /G file system).
[EIO] An input or output error occurred. The device holding the file might be in the
down state, or both processors that provide access to the device might have
failed.
[ELOOP] Too many symbolic links were encountered in translating the path parameter.
[ENAMETOOLONG]
One of these names is too long:
• The pathname pointed to by the path parameter
• A component of the pathname pointed to by the path parameter
• The intermediate result of pathname resolution when a symbolic link is
part of the path parameter
You can call the pathconf() function to obtain the applicable limits.
[ENOENT] One of these conditions exists:
• The named file does not exist, or the specified name is an empty string.
• The path parameter specifies a file on a remote HP NonStop node, but
communication with the remote node has been lost.
[ENOROOT] One of these conditions exists:
• The root fileset of the local node (fileset 0) is not in the STARTED state.
• The current root fileset for the specified file is unavailable. The OSS
name server for the fileset might have failed.
• The specified file is on a remote node, and communication with the
remote name server has been lost.
4−8 Hewlett-Packard Company 527186-023