Skip to content

Commit

Permalink
Mention how you can go from BorrowedFd to OwnedFd and back
Browse files Browse the repository at this point in the history
  • Loading branch information
tbu- committed Jun 28, 2024
1 parent d590f80 commit 08175f8
Showing 1 changed file with 5 additions and 0 deletions.
5 changes: 5 additions & 0 deletions library/std/src/os/fd/owned.rs
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,9 @@ use crate::sys_common::{AsInner, FromInner, IntoInner};
/// it on `&BorrowedFd` and use the `Clone::clone()` like `ToOwned` does for
/// all types implementing `Clone`. The result will be descriptor borrowed
/// under the same lifetime.
///
/// To obtain an [`OwnedFd`], you can use [`BorrowedFd::try_clone_to_owned`]
/// instead, but this is not supported on all platforms.
#[derive(Copy, Clone)]
#[repr(transparent)]
#[rustc_layout_scalar_valid_range_start(0)]
Expand All @@ -52,6 +55,8 @@ pub struct BorrowedFd<'fd> {
/// descriptor, so it can be used in FFI in places where a file descriptor is
/// passed as a consumed argument or returned as an owned value, and it never
/// has the value `-1`.
///
/// You can use [`AsFd::as_fd`] to obtain a [`BorrowedFd`].
#[repr(transparent)]
#[rustc_layout_scalar_valid_range_start(0)]
// libstd/os/raw/mod.rs assures me that every libstd-supported platform has a
Expand Down

0 comments on commit 08175f8

Please sign in to comment.