Struct PtyChild 

pub struct PtyChild { /* private fields */ }

A handle for signaling and reaping a PTY-backed child process.

Implementations

impl PtyChild

pub fn pid(&self) -> ProcessId

Returns the PTY session leader’s process identifier.

The spawned child creates a fresh session and foreground process group, so this PID is also the PTY process-group identifier used for later signal delivery.

pub fn wait(&mut self) -> Result<ExitStatus>

Waits for the child process to exit and reaps it.

pub fn try_wait(&mut self) -> Result<Option<ExitStatus>>

Attempts to reap the child process without blocking.

pub fn interrupt(&self) -> Result<()>

Sends an interrupt request to the PTY foreground process group.

pub fn terminate_forcefully(&self) -> Result<()>

Sends a forceful kill request to the PTY foreground process group.

pub fn kill(&self, signal: Signal) -> Result<()>

Sends a signal to the PTY foreground process group.

PTY-backed sessions commonly fan out into multiple processes while sharing the foreground group created during spawn. Signaling the group preserves teardown correctness even when the session leader has already delegated work to descendants.

pub fn kill_session_leader(&self, signal: Signal) -> Result<()>

Sends a signal directly to the PTY session leader.

This is a teardown fallback for shells that move foreground jobs into a different process group while the session leader is still the child that must be reaped by RMUX.

pub fn continue_if_stopped(&self) -> Result<bool>

Continues the PTY foreground process group if the session leader is currently stopped.

This mirrors tmux’s SIGCHLD policy for stopped panes while leaving SIGTTIN/SIGTTOU alone so background terminal I/O remains governed by normal Unix job-control rules.

Trait Implementations

impl Debug for PtyChild

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

Formats the value using the given formatter.