nordic-dev.net/rust
nordic-dev.net/rust
2
0
Fork 0
mirror of https://github.com/rust-lang/rust.git synced 2025-04-16 22:16:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

std(docs): clarify how std::fs::set_permisions works with symlinks

Browse Source 
fixes https://github.com/rust-lang/rust/issues/75942
fixes https://github.com/rust-lang/rust/issues/124201
This commit is contained in:
binarycat 2025-04-08 12:27:33 -05:00
parent ae9173d7dd
commit 8808d5a2b2
1 changed files with 13 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
library/std/src/fs.rs
View File

@ -2980,6 +2980,19 @@ pub fn read_dir<P: AsRef<Path>>(path: P) -> io::Result<ReadDir> {
///
/// [changes]: io#platform-specific-behavior
///
/// # Symlinks
/// On UNIX systems, it is impossible to manipulate the permission bits of a symlink itself[^1].
/// Because of this, on those systems, this function will update the permission bits
/// of the file pointed to by the symlink.
///
/// Note that this behavior can lead to privalage escalation vulnerabilites,
/// where the ability to write a symlink in one directory allows you to
/// cause the permissions of another directory to be modified.
///
/// For this reason, using this function with symlinks should be avoided.
/// When possible, permissions should be set at creation time instead.
///
/// [^1]: even if it were possible, the permissions on a symlink are ignored.
/// # Errors
///
/// This function will return an error in the following situations, but is not