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 afattach()
-ed STREAM and the implementation disallows execution offchown()
on a pipe.EIO
- A physical I/O error has occurred.EINTR
- Thefchown()
function was interrupted by a signal which was caught.
Tests#
Untested
Known bugs#
None