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

chmod(2) OSS System Calls Reference Manual
NAME
chmod - Changes file-access permissions
LIBRARY
G-series native Guardian processes: system library
G-series native OSS processes: system library
H-series native Guardian processes: implicit libraries
H-series OSS processes: implicit libraries
SYNOPSIS
#include <sys/types.h> /* optional except for POSIX.1 */
#include <sys/stat.h>
int chmod(
const char *path,
mode_t mode);
PARAMETERS
path Specifies the full pathname of the file. If the path parameter refers to a symbolic
link, the chmod() function changes access permissions on the file specified by
the symbolic link.
mode Specifies the bit pattern that determines the access permissions.
DESCRIPTION
The chmod() function sets the access permissions of the file specified by the path parameter
according to the bit pattern specified by the mode parameter.
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 its effective user ID or one of its group |
affiliations must qualify it for membership in the Safeguard SECURITY-OSS- |
ADMINISTRATOR group. |
If chmod() is invoked by a process whose effective user ID does not equal the super ID or file |
owner, the set-user-ID and set-group-ID bits of the file mode (04000 and 02000, respectively) are |
cleared.
If the S_ISVTX bit is on for a directory, only processes with an effective user ID equal to the
user ID of the file’s owner or the directory’s owner, or a process with appropriate privileges, can
remove files from the directory.
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 will be authorized by using the new access per-
missions that were specified in the call.
The mode parameter is constructed by logically ORing one or more of these symbols, which are
defined in the sys/stat.h header file:
S_ISUID Sets the process’s effective user ID to the user ID of the file’s owner on execu-
tion.
S_ISGID Sets the process’s effective group ID to the group ID of the file’s group on execu-
tion.
S_ISVTX For a directory, permits modification to the directory only if the effective user ID
of the process matches that of the file being accessed.
1−20 Hewlett-Packard Company 527186-007