Struct Command 

pub struct Command<'a> { /* private fields */ }

A builder for launching a command inside the guest.

This has a similar API to std::process::Command.

Implementations

impl<'a> Command<'a>

pub fn arg(&mut self, arg: impl AsRef<str>) -> &mut Self

Adds an argument to the command.

pub fn args<I: IntoIterator>(&mut self, args: I) -> &mut Self

where I::Item: AsRef<str>,

Adds multiple arguments to the command.

pub fn current_dir(&mut self, dir: impl AsRef<str>) -> &mut Self

Sets the current working directory for the command.

pub fn env_clear(&mut self) -> &mut Self

Clears the environment before setting the new environment.

pub fn env( &mut self, name: impl AsRef<str>, value: impl AsRef<str>, ) -> &mut Self

Sets an environment variable for the command.

pub fn env_remove(&mut self, name: impl AsRef<str>) -> &mut Self

Removes an environment variable for the command.

pub fn stdin(&mut self, stdin: impl Into<Stdio>) -> &mut Self

Sets the stdin for the command.

pub fn stdout(&mut self, stdout: impl Into<Stdio>) -> &mut Self

Sets the stdout for the command.

pub fn stderr(&mut self, stderr: impl Into<Stdio>) -> &mut Self

Sets the stderr for the command.

pub fn chroot(&mut self, root: impl AsRef<str>) -> &mut Self

Sets the chroot directory for the command (Linux only).

pub fn pty(&mut self, allocate: bool) -> &mut Self

Allocate a PTY for the child process (Linux guests only).

When set, stdin/stdout/stderr are all connected to a PTY secondary, enabling terminal features like Ctrl-C signal propagation and line editing. The PTY primary is relayed through the stdout pipe.

pub fn combine_stderr(&mut self, combine: bool) -> &mut Self

Redirect stderr to the stdout pipe.

When set, the child’s stderr is merged into stdout so callers receive interleaved output through a single stream.

pub async fn spawn(&self) -> Result<Child>

Spawns the command, defaulting to inheriting (relaying, really) the current process for stdin, stdout, and stderr.

pub async fn output(&self) -> Result<Output>

Spawns the command, capturing the standard output and standard error (if they are not already set).