Trait io_extras::os::rustix::FromRawFd

1.1.0 · source · [−]
pub trait FromRawFd {
    unsafe fn from_raw_fd(fd: i32) -> Self;
}
Expand description

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

Required methods

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

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.

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

RawReadable doesn’t own its handle.

RawWriteable doesn’t own its handle.