Struct ChrootCmd 

pub struct ChrootCmd<'a> {
    chroot_path: Cow<'a, Utf8Path>,
    bind_mounts: Vec<(&'a str, &'a str)>,
    env_vars: Vec<(&'a str, &'a str)>,
}

Builder for running commands inside a target directory using a mount namespace + chroot.

Fields

chroot_path: Cow<'a, Utf8Path>

The target directory to use as root for the chroot.

bind_mounts: Vec<(&'a str, &'a str)>

Bind mounts in format (host source, chroot-relative target).

env_vars: Vec<(&'a str, &'a str)>

Environment variables to set on the spawned command.

Implementations

impl<'a> ChrootCmd<'a>

pub fn new(path: &'a Utf8Path) -> Self

Create a new ChrootCmd builder with a root directory.

pub fn bind( self, source: &'a impl AsRef<Utf8Path>, target: &'a impl AsRef<Utf8Path>, ) -> Self

Add a bind mount from source (on the host) to target (a path inside the chroot, e.g. /boot).

pub fn setenv(self, key: &'a str, value: &'a str) -> Self

Set an environment variable for the child. The chrooted command runs with a cleared environment, isolating it from the buildroot — callers must set every variable they want the child to see.

pub fn set_default_path(self) -> Self

Set $PATH to a reasonable default covering the standard system binary directories.

fn build_command<S: AsRef<OsStr>>( self, args: impl IntoIterator<Item = S>, ) -> Result<Command>

Build the underlying Command with the mount-namespace setup and chroot installed as a pre_exec hook.

pub fn run<S: AsRef<OsStr>>( self, args: impl IntoIterator<Item = S>, ) -> Result<()>

Run the specified command inside the chroot, inheriting stdio. args must include the program as its first element.

pub fn run_get_string<S: AsRef<OsStr>>( self, args: impl IntoIterator<Item = S>, ) -> Result<String>

Run the specified command inside the chroot and capture stdout as a string. args must include the program as its first element.

Trait Implementations

impl<'a> Debug for ChrootCmd<'a>

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

Formats the value using the given formatter.