5 releases

✓ Uses Rust 2018 edition

0.2.0 Jan 28, 2019
0.1.3 Aug 22, 2018
0.1.2 Aug 8, 2018
0.1.1 Jul 10, 2018
0.1.0 Nov 22, 2017

#50 in Debugging

Download history 35/week @ 2018-12-20 22/week @ 2019-01-03 21/week @ 2019-01-10 135/week @ 2019-01-17 65/week @ 2019-01-24 43/week @ 2019-01-31 51/week @ 2019-02-07 45/week @ 2019-02-14 54/week @ 2019-02-21 63/week @ 2019-02-28 26/week @ 2019-03-07 16/week @ 2019-03-14 37/week @ 2019-03-21 24/week @ 2019-03-28

201 downloads per month

MIT/Apache

31KB
729 lines

rstack

CircleCI

Documentation

Remote stack tracing.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.


lib.rs:

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:

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();
    }
}

Dependencies

~2MB
~38K SLoC