Add SAFETY comments for AsFd implementations on stdin/stdout/stderr

rust-lang · Oct 3, 2022 · 905ebc3 · 905ebc3
1 parent 625ebf6
commit 905ebc3
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/library/std/src/sys/wasi/stdio.rs b/library/std/src/sys/wasi/stdio.rs
@@ -34,6 +34,7 @@ impl AsFd for Stdin {
 impl<'a> AsFd for io::StdinLock<'a> {
     #[inline]
     fn as_fd(&self) -> BorrowedFd<'_> {
+        // SAFETY: user code should not close stdin out from under the standard library
         unsafe { BorrowedFd::borrow_raw(0) }
     }
 }
@@ -77,6 +78,7 @@ impl AsFd for Stdout {
 impl<'a> AsFd for io::StdoutLock<'a> {
     #[inline]
     fn as_fd(&self) -> BorrowedFd<'_> {
+        // SAFETY: user code should not close stdout out from under the standard library
         unsafe { BorrowedFd::borrow_raw(1) }
     }
 }
@@ -123,6 +125,7 @@ impl AsFd for Stderr {
 impl<'a> AsFd for io::StderrLock<'a> {
     #[inline]
     fn as_fd(&self) -> BorrowedFd<'_> {
+        // SAFETY: user code should not close stderr out from under the standard library
         unsafe { BorrowedFd::borrow_raw(2) }
     }
 }