bjoernager/rust
bjoernager/rust
1
Fork 0
Code Activity

Update chown help with a link and adding cap warning

Browse source 
Linked to chown(2) manpage on the web which expands on chown call behaviour.
This commit is contained in:
Peter Gervai 2024-08-22 18:38:27 +02:00 • committed by GitHub
parent a9ecd0fa81
commit 3408dc1eb5
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 2 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

3
library/std/src/os/unix/fs.rs
View file

@ -988,7 +988,8 @@ impl DirBuilderExt for fs::DirBuilder {
///
/// Be aware that changing owner clears the `suid` and `sgid` permission bits in most cases
/// according to POSIX, usually even if the user is root. The sgid is not cleared when
/// the file is non-group-executable.
/// the file is non-group-executable. See: <https://www.man7.org/linux/man-pages/man2/chown.2.html>
/// This call may also clear file capabilities, if there was any.
///
/// If called on a symbolic link, this will change the owner and group of the link target. To
/// change the owner and group of the link itself, see [`lchown`].