Struct Command

pub struct Command { /* private fields */ }

Offers an API similar to std::process::Command.

Implementations

impl Command

pub fn new<P: AsRef<Path>>(root_fs: P, path: &str) -> Self

Command path inside the isolated filesystem. Panics if path contains null bytes.

Examples found in repository

examples/shell.rs (line 11)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let d = current_dir().unwrap();

    let rootfs = d.join("rootfs/");
    let writedir = d.join("write/");

    std::fs::create_dir_all(&writedir)?;

    let mut child = isolated::Command::new(rootfs, "/bin/sh")
        .disk_write_to(writedir)
        .spawn()?;

    child.wait()?;
    Ok(())
}

pub fn args(self, args: &[&str]) -> Self

Panics if any argument contains null bytes.

pub fn layer<P: AsRef<Path>>(self, path: P) -> Self

Adds new read-only OverlayFS layer

pub fn disk_write_tempdir(self) -> Self

Allows disk writes to a temporary directory

pub fn disk_write_to<P: AsRef<Path>>(self, path: P) -> Self

Allows disk writes to a temporary directory

Examples found in repository

examples/shell.rs (line 12)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let d = current_dir().unwrap();

    let rootfs = d.join("rootfs/");
    let writedir = d.join("write/");

    std::fs::create_dir_all(&writedir)?;

    let mut child = isolated::Command::new(rootfs, "/bin/sh")
        .disk_write_to(writedir)
        .spawn()?;

    child.wait()?;
    Ok(())
}

pub fn hook_pre_pivot(self, hook: Box<dyn FnOnce() -> Result<()>>) -> Self

Hook is called just before pivot_root, after fork. If multiple hooks are registered, they will be called in order. If any hook returns an error, no more hooks will be called, and the process will not be started.

pub fn hook_pre_exec(self, hook: Box<dyn FnOnce() -> Result<()>>) -> Self

Hook is called just before exec, after fork and pivot_root. If multiple hooks are registered, they will be called in order. If any hook returns an error, no more hooks will be called, and the process will not be started.

pub fn spawn(self) -> Result<Process>

Examples found in repository

examples/shell.rs (line 13)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let d = current_dir().unwrap();

    let rootfs = d.join("rootfs/");
    let writedir = d.join("write/");

    std::fs::create_dir_all(&writedir)?;

    let mut child = isolated::Command::new(rootfs, "/bin/sh")
        .disk_write_to(writedir)
        .spawn()?;

    child.wait()?;
    Ok(())
}