Crate boxxy

This crate provides an interactive shell that can be used to provide a basic debugger for sandboxes. It features a couple of builtin commands to test eg. file access when external programs can’t be used (chroots or seccomp).

It also accepts custom functions that can be included to step through various stages of your sandbox.

Example

#[macro_use] extern crate boxxy;

fn stage1(sh: &mut boxxy::Shell, args: Vec<String>) -> Result<(), boxxy::Error> {
    shprintln!(sh, "init stage 1! {:?}", args);
    // your code here
    Ok(())
}

fn stage2(sh: &mut boxxy::Shell, args: Vec<String>) -> Result<(), boxxy::Error> {
    shprintln!(sh, "init stage 2! {:?}", args);
    // your code here
    Ok(())
}

fn main() {
    env_logger::init();

    let toolbox = boxxy::Toolbox::new().with(vec![
            ("stage1", stage1),
            ("stage2", stage2),
        ]);
    boxxy::Shell::new(toolbox).run()
}

Re-exports

• pub use crate::ctrl::Interface;
• pub use crate::shell::Shell;
• pub use crate::shell::Toolbox;
• pub use crate::shell::Command;
• pub use crate::shell::NativeCommand;
• pub use crate::shell::ForeignCommand;

Modules

• busybox
  Builtin commands.
• completer
• ctrl
• errors
• ffi
  Abstractions of some unsafe functions.
• shell
  The interactive shell.

Macros

• shprintln

Structs

• Error
  The Error type, a wrapper around a dynamic error type.

Type Aliases

• Arguments
  Arguments passed to builtin commands
• Result
  Result<T, Error>