Crate rstack_self

Retrieve stack traces of all threads of the process.

This is implemented using the rstack crate, which itself uses ptrace to unwind the threads of the process. Because processes cannot ptrace themselves, we’re forced to use spawn a child process which does that work. Multiple unwinding implementations are supported via Cargo features:

• unwind: Uses libunwind.
• dw: Uses libdw, part of the elfutils project.

By default, the libunwind backend is used. You can switch to libdw via Cargo:

[dependencies]
rstack-self = { version = "0.1", features = ["dw"], default-features = false }

Example

extern crate rstack_self;

use std::env;
use std::process::Command;
use std::thread;

fn main() {
    if env::args_os().count() > 1 {
        let _ = rstack_self::child();
        return;
    }

    // spawn a second thread just for fun
    thread::spawn(background_thread);

    let exe = env::current_exe().unwrap();
    let trace = rstack_self::trace(Command::new(exe).arg("child")).unwrap();

    println!("{:#?}", trace);
}

fn background_thread() {
    loop {
        thread::park();
    }
}

Structs

Error

The error type returned by methods in this crate.

Frame

Information about a stack frame.

Symbol

Information about a symbol.

Thread

Information about a thread.

Trace

A trace of the threads in a process.

TraceOptions

Options controlling tracing.

Functions

child

The function called by the process spawned by a call to trace.

trace

A convenience wrapper over TraceOptions which uses default options.

Type Aliases

Result

The result type returned by methods in this crate.