fchown#

Synopsis#

#include <unistd.h>

int fchown(int fildes, uid_t owner, gid_t group);

Status#

Declared, not implemented

Conformance#

IEEE Std 1003.1-2017

Description#

The fchown() function shall be equivalent to chown() except that the file whose owner and group are changed is specified by the file descriptor fildes.

Return value#

Upon successful completion, fchown() shall return 0. Otherwise, it shall return -1 and set errno to indicate the error.

Errors#

The fchown() function shall fail if:

EBADF - The fildes argument is not an open file descriptor.
EPERM - The effective user ID does not match the owner of the file or the process does not have appropriate privileges and _POSIX_CHOWN_RESTRICTED indicates that such privilege is required.
EROFS - The file referred to by fildes resides on a read-only file system.

The fchown() function may fail if:

EINVAL - The owner or group ID is not a value supported by the implementation. The fildes argument refers to a pipe or socket or a fattach()-ed STREAM and the implementation disallows execution of fchown() on a pipe.
EIO - A physical I/O error has occurred.
EINTR - The fchown() function was interrupted by a signal which was caught.

Tests#

Untested

Known bugs#

None