Trait io_extras::os::rustix::FromRawFd

pub trait FromRawFd {
    unsafe fn from_raw_fd(fd: i32) -> Self;
}

A trait to express the ability to construct an object from a raw file descriptor.

Required methods

unsafe fn from_raw_fd(fd: i32) -> Self

Constructs a new instance of Self from the given raw file descriptor.

This function is typically used to consume ownership of the specified file descriptor. When used in this way, the returned object will take responsibility for closing it when the object goes out of scope.

However, consuming ownership is not strictly required. Use a From<OwnedFd>::from implementation for an API which strictly consumes ownership.

Safety

The fd passed in must be a valid an open file descriptor.

Example

use std::fs::File;
#[cfg(unix)]
use std::os::unix::io::{FromRawFd, IntoRawFd, RawFd};
#[cfg(target_os = "wasi")]
use std::os::wasi::io::{FromRawFd, IntoRawFd, RawFd};

let f = File::open("foo.txt")?;
let raw_fd: RawFd = f.into_raw_fd();
// SAFETY: no other functions should call `from_raw_fd`, so there
// is only one owner for the file descriptor.
let f = unsafe { File::from_raw_fd(raw_fd) };

Implementations on Foreign Types

impl FromRawFd for OwnedFd

unsafe fn from_raw_fd(fd: i32) -> OwnedFd

Constructs a new instance of Self from the given raw file descriptor.

Safety

The resource pointed to by fd must be open and suitable for assuming ownership. The resource must not require any cleanup other than close.

impl FromRawFd for UdpSocket

unsafe fn from_raw_fd(fd: i32) -> UdpSocket

impl FromRawFd for TcpStream

unsafe fn from_raw_fd(fd: i32) -> TcpStream

impl FromRawFd for PidFd

unsafe fn from_raw_fd(fd: i32) -> PidFd

impl FromRawFd for i32

unsafe fn from_raw_fd(fd: i32) -> i32

impl FromRawFd for UnixStream

unsafe fn from_raw_fd(fd: i32) -> UnixStream

impl FromRawFd for TcpListener

unsafe fn from_raw_fd(fd: i32) -> TcpListener

impl FromRawFd for UnixDatagram

unsafe fn from_raw_fd(fd: i32) -> UnixDatagram

impl FromRawFd for UnixListener

unsafe fn from_raw_fd(fd: i32) -> UnixListener

impl FromRawFd for Stdio

unsafe fn from_raw_fd(fd: i32) -> Stdio

impl FromRawFd for File

unsafe fn from_raw_fd(fd: i32) -> File

impl FromRawFd for OwnedFd

unsafe fn from_raw_fd(fd: i32) -> OwnedFd

Constructs a new instance of Self from the given raw file descriptor.

Safety

The resource pointed to by raw must be open and suitable for assuming ownership.

Implementors

impl FromRawFd for RawReadable

RawReadable doesn’t own its handle.

impl FromRawFd for RawWriteable

RawWriteable doesn’t own its handle.