Struct CrashHandler

pub struct CrashHandler { /* private fields */ }

A wrapper around a process closure that handles crashes by running the closure as a subprocess and invoking a crash handler closure if the subprocess fails.

Implementations

impl CrashHandler

pub fn new() -> Self

Create a new crash reporter with default settings.

pub fn with_process(process: impl Fn() + 'static) -> Self

Create a new crash reporter from the given closure that runs a process.

pub fn child_flag(self, flag: impl Into<String>) -> Self

Sets the command line flag that identifies a child process.

pub fn crash_handler( self, crash_handler: impl Fn(Output) -> Result<(), Box<dyn Error>> + 'static, ) -> Self

Sets the crash handler that is called when the process fails.

pub fn backtrace(self) -> Self

Sets the value of the RUST_BACKTRACE environment variable in the subprocess to 1.

pub fn full_backtrace(self) -> Self

Sets the value of the RUST_BACKTRACE environment variable in the subprocess to full.

pub fn run(&self) -> Result<bool, Box<dyn Error>>

Runs the configured process as a subprocess and handle crashes if the child flag is not present, otherwise run the process normally.

Returns

• Ok(true) if the process ran successfully without errors.
• Ok(false) if there was an error in the process (that was handled).
• Err if there was an error spawning the process or handling an error in the process.

Trait Implementations

impl Default for CrashHandler

fn default() -> Self

Create a new crash reporter with default settings (a process that prints “Hello, world!”, “–cortex-bypass” bypass flag, a crash handler that prints the status code and error message using eprintln!, and RUST_BACKTRACE=full).