chown(2) UNIX System V chown(2)
NAME
chown, lchown, fchown - change owner and group of a file
SYNOPSIS
#include <unistd.h>
#include <sys/stat.h>
int chown(const char *path, uidt owner, gidt group);
int lchown(const char *path, uidt owner, gidt group);
int fchown(int fildes, uidt owner, gidt group);
DESCRIPTION
The owner ID and group ID of the file specified by path or referenced by
the descriptor fildes, are set to owner and group respectively. If owner
or group is specified as -1, the corresponding ID of the file is not
changed.
The function lchown sets the owner ID and group ID of the named file just
as chown does, except in the case where the named file is a symbolic
link. In this case lchown changes the ownership of the symbolic link
file itself, while chown changes the ownership of the file or directory
to which the symbolic link refers.
If chown, lchown, or fchown is invoked by a process other than super-
user, the set-user-ID and set-group-ID bits of the file mode, SISUID and
SISGID respectively, are cleared [see chmod(2)].
The operating system has a configuration option,
{POSIXCHOWNRESTRICTED}, to restrict ownership changes for the chown,
lchown, and fchown system calls. When {POSIXCHOWNRESTRICTED} is not
in effect, the effective user ID of the process must match the owner of
the file or the process must be the super-user to change the ownership of
a file. When {POSIXCHOWNRESTRICTED} is in effect, the chown, lchown,
and fchown system calls, for users other than super-user, prevent the
owner of the file from changing the owner ID of the file and restrict the
change of the group of the file to the list of supplementary group IDs.
Upon successful completion, chown, fchown and lchown mark for update the
stctime field of the file.
chown and lchown fail and the owner and group of the named file remain
unchanged if one or more of the following are true:
EACCES Search permission is denied on a component of the
path prefix of path.
EFAULT path points outside the allocated address space of
the process.
10/89 Page 1
chown(2) UNIX System V chown(2)
EINTR A signal was caught during the chown or lchown system
calls.
EINVAL group or owner is out of range.
EIO An I/O error occurred while reading from or writing
to the file system.
ELOOP Too many symbolic links were encountered in
translating path.
EMULTIHOP Components of path require hopping to multiple remote
machines and file system type does not allow it. Too
many symbolic links were encountered in translating
path.
ENAMETOOLONG The length of the path argument exceeds {PATHMAX},
or the length of a path component exceeds {NAMEMAX}
while POSIXNOTRUNC is in effect.
ENOLINK path points to a remote machine and the link to that
machine is no longer active.
ENOTDIR A component of the path prefix of path is not a
directory.
ENOENT Either a component of the path prefix or the file
referred to by path does not exist or is a null
pathname.
EPERM The effective user ID does not match the owner of the
file or the process is not the super-user and
{POSIXCHOWNRESTRICTED} indicates that such
privilege is required.
EROFS The named file resides on a read-only file system.
fchown fails and the owner and group of the named file remain unchanged
if one or more of the following are true:
EBADF fildes is not an open file descriptor.
EINVAL group or owner is out of range.
EPERM The effective user ID does not match the owner of the
file or the process is not the super-user and
{POSIXCHOWNRESTRICTED} indicates that such
privilege is required.
EROFS The named file referred to by fildes resides on a
read-only file system.
Page 2 10/89
chown(2) UNIX System V chown(2)
EINTR A signal was caught during execution of the system
call.
EIO An I/O error occurred while reading from or writing
to the file system.
ENOLINK fildes points to a remote machine and the link to
that machine is no longer active.
SEE ALSO
chmod(2).
chown(1), chgrp(1) in the User's Reference Manual.
DIAGNOSTICS
Upon successful completion, a value of 0 is returned. Otherwise, a value
of -1 is returned and errno is set to indicate the error.
10/89 Page 3