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

System Functions (a - d) chmod(2)
[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 HP NonStop node, and communication
with the remote name server has been lost.
[ENOTDIR] A component, other than the last part, of the path parameter is not a directory.
[ENXIO] The fileset containing the client’s current working directory or root directory is
not mounted.
[EOSSNOTRUNNING]
The program attempted an operation on an object in the OSS environment while
a required system process was not running.
[EPERM] The effective user ID does not match the user ID of the owner of the file, or the
owner does not have appropriate privileges.
[EROFS] The named file resides on a read-only fileset.
For all other error conditions, errno is set to the appropriate Guardian file-system error number.
See the Guardian Procedure Errors and Messages Manual for more information about a specific
Guardian file-system error.
RELATED INFORMATION
Commands: chmod(1).
Functions: chown(2), fcntl(2), getgroups(2), mknod(2), open(2), read(2), write(2).
STANDARDS CONFORMANCE
The POSIX standards leave some features to the implementing vendor to define. These features
are affected in the HP implementation:
• To change file-access permissions, either the process must have the same effective user
ID as the owner of the file or the process must have an effective user ID of the super ID.
• A call to the chmod() function has no effect on the file descriptor for a file that is open at
the time of the call. However, new openers of the file are authenticated by using the new
access permissions that were specified in the call.
HP extensions to the XPG4 Version 2 specification are:
• The errno values [EFAULT], [EFSBAD], [EINVAL], [ENOROOT], [ENXIO], and
[EOSSNOTRUNNING] can be returned.
• The S_NONSTOP flag is supported for regular files.
527186-003 Hewlett-Packard Company 1−17