Enum ShellChild 

pub enum ShellChild {
    Direct {
        child: Child,
        tree: ProcessTree,
    },
    Helped(HelpedChild),
}

The shell of one MCP shell call, whoever its parent is.

On Unix the parent is this process’s spawn helper (shell::containment): it holds the shell’s session and ends it should this process die. Where there is no helper — Windows, a host that is not lean-ctx, a helper that could not be started — this process is the parent, as it always was.

Variants

Direct

Fields

child: Child

tree: ProcessTree

Helped(HelpedChild)

Implementations

impl ShellChild

pub fn start(cmd: &mut Command) -> Result<StartedShell, String>

Starts the shell that cmd describes, in a session of its own on Unix, with its output piped. cmd must have been through ProcessTree::prepare and must not set its own standard streams.

pub fn id(&self) -> u32

The shell’s process id; on Unix also the id of the group it leads.

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

The exit status, if the shell has exited. Reaps a direct child.

pub fn kill(&mut self)

Ends the shell and everything it started (ProcessTree::kill). The group is signalled by the shell’s parent, while the shell is unreaped.

pub fn wait(&mut self)

Waits for a shell that was just killed to be reaped.

pub fn release(self) -> Option<&'static str>

Hands the tree back after the command exited on its own (ProcessTree::release): what it left running stays.

Some: the fixed notice for a release that could not be handed to the shell’s helper — whether what the command left running is still running is then not known. The caller shows it with the result.

pub fn lost_notice(&self) -> Option<&'static str>

The fixed notice for a shell whose helper went away — before it said whether the command was started, or before the shell’s exit was known. The call’s outcome is then not known in full. Never the case for a direct child.