about summary refs log tree commit diff
path: root/library/std/src
diff options
context:
space:
mode:
authorPeter Gervai <grinapo@gmail.com>2024-08-22 18:38:27 +0200
committerGitHub <noreply@github.com>2024-08-22 18:38:27 +0200
commit3408dc1eb5f8d744b4d7d5a4392ae6456f036ad9 (patch)
tree70af882f240ca1d29fff3174fba032475179034c /library/std/src
parenta9ecd0fa8141e7614ca35d5a4d2fe5c96b1a7890 (diff)
downloadrust-3408dc1eb5f8d744b4d7d5a4392ae6456f036ad9.tar.gz
rust-3408dc1eb5f8d744b4d7d5a4392ae6456f036ad9.zip
Update chown help with a link and adding cap warning
Linked to chown(2) manpage on the web which expands on chown call behaviour.
Diffstat (limited to 'library/std/src')
-rw-r--r--library/std/src/os/unix/fs.rs3
1 files changed, 2 insertions, 1 deletions
diff --git a/library/std/src/os/unix/fs.rs b/library/std/src/os/unix/fs.rs
index f063fa06cc9..92613d9b004 100644
--- a/library/std/src/os/unix/fs.rs
+++ b/library/std/src/os/unix/fs.rs
@@ -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`].