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

System Functions (f - i) fchmod(2)
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 fchmod( ) 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 fchmod() function sets errno to the corresponding value:
[EBADF] The file descriptor filedes is not valid.
[EFSBAD] The fileset catalog for one of the filesets involved in the operation is corrupt.
[EINTR] A signal was caught during execution of the system call.
[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.
[ENOENT] The program attempted an operation on a file that is open but that has been
unlinked (and the attributes of the file are no longer alterable).
[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.
[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 ID of the owner of the file, and the cal-
ling process does not have super ID privilege.
[EROFS] The file referred to by filedes resides on a read-only fileset.
For all other error conditions, errno is set to the appropriate Guardian file-system error number.
For more information about a specific Guardian file-system error, see the Guardian Procedure
Errors and Messages Manual.
RELATED INFORMATION
Commands: chmod(1), getacl(1), setacl(1).
Functions: acl(2), chmod(2), chown(2), fcntl(2), fchown(2), getgroups(2), lchmod(2),
lchown(2), mknod(2), open(2), open64(2), read(2), setfilepriv(2), write(2).
527186-023 Hewlett-Packard Company 3−5