pub fn fchownat<Fd: AsFd, P: ?Sized + NixPath>(
dirfd: Fd,
path: &P,
owner: Option<Uid>,
group: Option<Gid>,
flag: AtFlags,
) -> Result<()>
Expand description
Change the ownership of the file at path
to be owned by the specified
owner
(user) and group
.
The owner/group for the provided path name will not be modified if None
is
provided for that argument. Ownership change will be attempted for the path
only if Some
owner/group is provided.
If flag
is AtFlags::AT_SYMLINK_NOFOLLOW
and path
names a symbolic link,
then the mode of the symbolic link is changed.
fchownat(AT_FDCWD, path, owner, group, AtFlags::AT_SYMLINK_NOFOLLOW)
is identical to
a call libc::lchown(path, owner, group)
. That’s why lchown
is unimplemented in
the nix
crate.