Struct ChrootCmd 

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

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

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>, mode: BindMode, ) -> Self

Add a bind mount from source (on the host) to target (a path inside the chroot, e.g. /sysroot). See BindMode for the difference between recursive and non-recursive bind mounts.

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.

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.