mikros/rust
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Don't encourage migration until io_safety is stablized.

Browse Source
This commit is contained in:
Dan Gohman 2021-07-28 09:00:18 -07:00
parent 1dbd6d60f0
commit 18a9f4628a
2 changed files with 8 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
library/std/src/os/unix/io/mod.rs
View File

@ -17,9 +17,10 @@
//! Like raw pointers, `RawFd` values are primitive values. And in new code,
//! they should be considered unsafe to do I/O on (analogous to dereferencing
//! them). Rust did not always provide this guidance, so existing code in the
//! Rust ecosystem often doesn't mark `RawFd` usage as unsafe. Libraries are
//! encouraged to migrate, either by adding `unsafe` to APIs that dereference
//! `RawFd` values, or by using to `BorrowedFd` or `OwnedFd` instead.
//! Rust ecosystem often doesn't mark `RawFd` usage as unsafe. Once the
//! `io_safety` feature is stable, libraries will be encouraged to migrate,
//! either by adding `unsafe` to APIs that dereference `RawFd` values, or by
//! using to `BorrowedFd` or `OwnedFd` instead.
//!
//! Like references, `BorrowedFd` values are tied to a lifetime, to ensure
//! that they don't outlive the resource they point to. These are safe to

8
library/std/src/os/windows/io/mod.rs
View File

@ -23,10 +23,10 @@
//! And in new code, they should be considered unsafe to do I/O on (analogous
//! to dereferencing them). Rust did not always provide this guidance, so
//! existing code in the Rust ecosystem often doesn't mark `RawHandle` and
//! `RawSocket` usage as unsafe. Libraries are encouraged to migrate, either by
//! adding `unsafe` to APIs that dereference `RawHandle` and `RawSocket`
//! values, or by using to `BorrowedHandle`, `BorrowedSocket`, `OwnedHandle`,
//! or `OwnedSocket`.
//! `RawSocket` usage as unsafe. Once the `io_safety` feature is stable,
//! libraries will be encouraged to migrate, either by adding `unsafe` to APIs
//! that dereference `RawHandle` and `RawSocket` values, or by using to
//! `BorrowedHandle`, `BorrowedSocket`, `OwnedHandle`, or `OwnedSocket`.
//!
//! Like references, `BorrowedHandle` and `BorrowedSocket` values are tied to a
//! lifetime, to ensure that they don't outlive the resource they point to.