Struct IoHandleData 

pub struct IoHandleData {
    pub kind: IoHandleKind,
    pub resource: Arc<Mutex<Option<IoResource>>>,
    pub path: String,
    pub mode: String,
}

Data for IoHandle variant (Arc-wrapped at the HeapValue level to keep HeapValue small and to enable cluster #2 marshal FromSlot for Arc<IoHandleData>).

Wraps an OS resource (file, socket, process) in an Arc<Mutex<Option>> so it can be shared and closed. The Option is None after close(). Rust’s Drop closes the underlying resource if not already closed.

Storage: HeapValue::IoHandle(Arc<IoHandleData>). The variant Arc is the marshal-layer’s typed handle (per cluster #2 option γ in docs/defections.md 2026-05-06); the inner Arc<Mutex<...>> is the shared resource lock. Cloning the variant is one atomic op.

Fields

kind: IoHandleKind

resource: Arc<Mutex<Option<IoResource>>>

path: String

mode: String

Implementations

impl IoHandleData

pub fn new_file(file: File, path: String, mode: String) -> Self

Create a new file handle.

pub fn new_tcp_stream(stream: TcpStream, addr: String) -> Self

Create a new TCP stream handle.

pub fn new_tcp_listener(listener: TcpListener, addr: String) -> Self

Create a new TCP listener handle.

pub fn new_udp_socket(socket: UdpSocket, addr: String) -> Self

Create a new UDP socket handle.

pub fn new_child_process(child: Child, cmd: String) -> Self

Create a handle wrapping a spawned child process.

pub fn new_pipe_reader(stdout: ChildStdout, label: String) -> Self

Create a handle wrapping a child stdout pipe.

pub fn new_pipe_writer(stdin: ChildStdin, label: String) -> Self

Create a handle wrapping a child stdin pipe.

pub fn new_pipe_reader_err(stderr: ChildStderr, label: String) -> Self

Create a handle wrapping a child stderr pipe.

pub fn new_custom(resource: Box<dyn Any + Send>, label: String) -> Self

Create a handle wrapping a custom type-erased resource.

pub fn is_open(&self) -> bool

Check if the handle is still open.

pub fn close(&self) -> bool

Close the handle, returning true if it was open.

Trait Implementations

impl Clone for IoHandleData

fn clone(&self) -> IoHandleData

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for IoHandleData

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

Formats the value using the given formatter.