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

lchown(2) OSS System Calls Reference Manual
NAME
lchown - Changes the owner and group IDs of a file
LIBRARY
G-series native Guardian processes: system library
G-series native OSS processes: system library
H-series and J-series native Guardian processes: implicit libraries
H-series and J-series OSS processes: implicit libraries
SYNOPSIS
#include <sys/types.h> /* optional except for POSIX.1 */
#include <unistd.h>
int lchown(
const char *path,
uid_t owner,
gid_t group);
PARAMETERS
path Specifies the name of the file whose owner ID, group ID, or both are to be
changed. If the final component of the path parameter names a symbolic link,
the lchown function changes the ownership of the symbolic link instead of the
file or directory to which the symbolic link refers.
owner Specifies a numeric value representing the owner ID.
group Specifies a numeric value representing the group ID.
DESCRIPTION
The lchown() function changes the owner and group of a file. The lchown() function is
equivalent to the chown() function except when the final component of the path parameter refers
to a symbolic link. If the final component of the path parameter names a symbolic link:
• The lchown function changes the ownership of the symbolic link instead of the file or
directory to which the symbolic link refers.
• Access control lists (ACLs) are not supported for a symbolic link.
Only a process that has an effective user ID equal to the super ID or to the file owner, or that has
an effective user ID or group affiliation qualifying for membership in the Safeguard
SECURITY-OSS-ADMINISTRATOR group can use the lchown() function to change the group
of a file. However, processes that have an effective user ID equal to the file owner can only
change the group of a file to a group to which they belong (their effective group or one of their
supplementary groups).
If the lchown() function is invoked by a process whose effective user ID does not equal the super
ID, the set-user-ID and set-group-ID bits of the file mode (04000 and 02000, respectively) are
cleared.
See also "Accessing Files in Restricted-Access Filesets."
A process can change the value of the owner ID of an OSS file only if the effective user ID of the
process gives the process appropriate privileges. A process can change the value of the file
group ID if the effective user ID of the process matches the owner ID of the file or the process
has appropriate privileges. A process without appropriate privileges can change the group ID of
a file only to the value of its effective group ID or to a value in its group list. However, if the
lchown() function is successfully invoked on a file, the S_ISGID and S_ISUID bits of the
st_mode field of the stat structure are cleared unless the user has appropriate privileges.
4−10 Hewlett-Packard Company 527186-023