HP-UX Reference (11i v2 07/12) - 2 System Calls (vol 5)

chmod(2) chmod(2)

If the effective user ID of the process is not that of a user with the

OBJSUID privilege, mode bit S_ISVTX

is cleared.

If the effective user ID of the process is not that of a user with the

OBJSUID privilege, and the effective

group ID of the process does not match the group ID of the ﬁle, and none of the group IDs in the supple-

mentary groups list match the group ID of the ﬁle, mode bit

S_ISGID is cleared.

If the mode bit

S_ISVTX (sticky bit) is set on a directory, ﬁles inside the directory can be renamed or

removed only by the owner of the ﬁle, the owner of the directory, the superuser, or a user with the

OWNER

privilege (even if the modes of the directory would otherwise allow such an operation).

See privileges(5) for more information about privileged access on systems that support ﬁne-grained

privileges.

RETURN VALUE

chmod() returns the following values:

0 Successful completion.

-1 Failure.

errno is set to indicate the error.

ERRORS

chmod() fails, the ﬁle mode is unchanged. errno is set to one of the following values:

[EACCES] Search permission is denied on a component of the path preﬁx.

[EFAULT] path points outside the allocated address space of the process. The reliable detection

of this error is implementation dependent.

[EINVAL] path or ﬁldes descriptor does not refer to an appropriate ﬁle.

[ELOOP] Too many symbolic links were encountered in translating path.

[ENAMETOOLONG]

A component of path exceeds NAME_MAX bytes while _POSIX_NO_TRUNC

is in

effect or path exceeds

PATH_MAX bytes.

[ENOENT] A component of path or the ﬁle named by path does not exist.

[ENOTDIR] A component of the path preﬁx is not a directory.

[EPERM] The effective user ID does not match that of the owner of the ﬁle or a user with the

OWNER privilege.

[EROFS] The named ﬁle resides on a read-only ﬁle system.

If fchmod() fails, the ﬁle mode is unchanged. errno is set to one of the following values:

[EBADF] ﬁldes is not a valid ﬁle descriptor.

[EPERM] The effective user ID does not match that of the owner of the ﬁle or a user with

OWNER privilege.

[EINVAL] path or ﬁldes descriptor does not refer to an appropriate ﬁle.

[EROFS] The named ﬁle resides on a read-only ﬁle system.

AUTHOR

chmod() was developed by AT&T, the University of California, Berkeley, and HP.

fchmod() was developed by the University of California, Berkeley.