Type Alias RawFdContainer

pub type RawFdContainer = OwnedFd;

A type representative of the file descriptors as they are sent to and from the X server.

On cfg(unix) platforms, this is a type alias for std::os::unix::io::OwnedFd. See the documentation for that type for more information on how it should be used. In most cases it can be cast into a File or UnixStream, or otherwise downgraded into the actual underlying file descriptor.

On non-Unix platforms, this is an uninhabited type in the same vogue as Void. As handle passing is an undefined operation on non-Unix implementations of the X11 protocol, instances of this type cannot exist. No operations can be called on this type. If handle passing is ever added to any reference implementation of the X11 protocol, this type will be changed to something that can be used to represent the file descriptors.

Consumers of this type should be careful to check for cfg(unix) before using it in any meaningful way. Otherwise, the program will not compile on non-Unix platforms.

Aliased Type

struct RawFdContainer { /* private fields */ }

Implementations

impl OwnedFd

pub fn try_clone(&self) -> Result<OwnedFd, Error>

Creates a new OwnedFd instance that shares the same underlying file description as the existing OwnedFd instance.

Trait Implementations

impl AsFd for OwnedFd

fn as_fd(&self) -> BorrowedFd<'_>

Borrows the file descriptor.

impl AsRawFd for OwnedFd

fn as_raw_fd(&self) -> i32

Extracts the raw file descriptor.

impl Debug for OwnedFd

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Drop for OwnedFd

fn drop(&mut self)

Executes the destructor for this type.

impl From<ChildStderr> for OwnedFd

fn from(child_stderr: ChildStderr) -> OwnedFd

Takes ownership of a ChildStderr’s file descriptor.

impl From<ChildStdin> for OwnedFd

fn from(child_stdin: ChildStdin) -> OwnedFd

Takes ownership of a ChildStdin’s file descriptor.

impl From<ChildStdout> for OwnedFd

fn from(child_stdout: ChildStdout) -> OwnedFd

Takes ownership of a ChildStdout’s file descriptor.

impl From<DefaultStream> for OwnedFd

fn from(stream: DefaultStream) -> Self

Converts to this type from the input type.

impl From<File> for OwnedFd

fn from(file: File) -> OwnedFd

Takes ownership of a File’s underlying file descriptor.

impl From<PidFd> for OwnedFd

fn from(pid_fd: PidFd) -> OwnedFd

Converts to this type from the input type.

impl From<PipeReader> for OwnedFd

fn from(pipe: PipeReader) -> OwnedFd

Converts to this type from the input type.

impl From<PipeWriter> for OwnedFd

fn from(pipe: PipeWriter) -> OwnedFd

Converts to this type from the input type.

impl From<TcpListener> for OwnedFd

fn from(tcp_listener: TcpListener) -> OwnedFd

Takes ownership of a TcpListener’s socket file descriptor.

impl From<TcpStream> for OwnedFd

fn from(tcp_stream: TcpStream) -> OwnedFd

Takes ownership of a TcpStream’s socket file descriptor.

impl From<UdpSocket> for OwnedFd

fn from(udp_socket: UdpSocket) -> OwnedFd

Takes ownership of a UdpSocket’s file descriptor.

impl From<UnixDatagram> for OwnedFd

fn from(unix_datagram: UnixDatagram) -> OwnedFd

Takes ownership of a UnixDatagram’s socket file descriptor.

impl From<UnixListener> for OwnedFd

fn from(listener: UnixListener) -> OwnedFd

Takes ownership of a UnixListener’s socket file descriptor.

impl From<UnixStream> for OwnedFd

fn from(unix_stream: UnixStream) -> OwnedFd

Takes ownership of a UnixStream’s socket file descriptor.

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 IntoRawFd for OwnedFd

fn into_raw_fd(self) -> i32

Consumes this object, returning the raw underlying file descriptor.

impl IsTerminal for OwnedFd

fn is_terminal(&self) -> bool

Returns true if the descriptor/handle refers to a terminal/tty.