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

fchown(2) OSS System Calls Reference Manual
[EINVAL] The owner or group parameter is out of range.
An attempt was made to change ownership of a Guardian file that is not a disk
file.
[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 calling process does not have appropriate privileges.
[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: chgrp(1), chown(1), getacl(1), setacl(1).|
Functions: acl(2), chmod(2), chown(2), fchmod(2), lchmod(2), lchown(2).|
Miscellaneous topics: acl(5).|
STANDARDS CONFORMANCE
The POSIX standards leave some features to the implementing vendor to define. These features
are affected in the HP implementation:
• A process can change the value of the owner ID of a file only if the effective user ID of
the process gives the process appropriate privileges.
• Upon successful completion, the set-user-ID attribute (the S_ISUID bit) and the set-
group-ID attribute (the S_ISGID bit) of the file are always cleared.
• To change the file access permissions of a file or directory, the effective user ID of the |
process must match the super ID or the owner of the file, or the effective user ID or one |
of the group affiliations for the process must qualify the process for membership in the |
Safeguard SECURITY-OSS-ADMINISTRATOR group.
• The errors [EINTR], [EINVAL], and [EIO] can be detected.
3−8 Hewlett-Packard Company 527186-007