Struct beach::Chroot

pub struct Chroot { /* fields omitted */ }

A wrapper for chroot(1).

Note: Running chroot requires root privileges.

Examples

beach::Chroot::new()
    .user_group("nvzqz", "everyone")
    .command("/path/to/root", "ls")
    .arg("/")
    .spawn();

Methods

impl Chroot

pub const fn new() -> Self

Creates an instance suitable for setting up a Command to execute a program through chroot.

pub fn skip_chdir(self) -> Self

Do not change the working directory to /.

pub fn user<U>(self, user: U) -> Self where
    U: AsRef<OsStr>, 

Specify the user to use.

pub fn user_group<U, G>(self, user: U, group: G) -> Self where
    U: AsRef<OsStr>,
    G: AsRef<OsStr>, 

Specify the user and group (ID or name) to use.

pub fn groups<G>(self, groups: G) -> Self where
    G: IntoIterator,
    G::Item: AsRef<OsStr>, 

Specifies supplementary groups.

pub fn command<R, P>(&self, root: R, program: P) -> Command where
    R: AsRef<Path>,
    P: AsRef<OsStr>, 

Returns a Command suitable for spawning program with root as /.

Trait Implementations

impl Clone for Chroot

fn clone(&self) -> Chroot

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Chroot

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

Formats the value using the given formatter.

impl Default for Chroot

fn default() -> Self

Returns the "default value" for a type.