20 releases

0.7.8 Mar 10, 2024
0.7.6 Sep 1, 2023
0.7.4 Mar 27, 2023
0.7.1 Dec 22, 2022
0.2.0 May 10, 2021

#338 in Debugging

Download history 1562/week @ 2024-12-17 963/week @ 2024-12-24 884/week @ 2024-12-31 1595/week @ 2025-01-07 1501/week @ 2025-01-14 1892/week @ 2025-01-21 1655/week @ 2025-01-28 2065/week @ 2025-02-04 2073/week @ 2025-02-11 1719/week @ 2025-02-18 1245/week @ 2025-02-25 1205/week @ 2025-03-04 1341/week @ 2025-03-11 1166/week @ 2025-03-18 824/week @ 2025-03-25 1188/week @ 2025-04-01

4,813 downloads per month
Used in 3 crates (2 directly)

MIT license

35KB
596 lines

gdb-command

CI Crates.io Documentation

gdb-command is a library providing API for manipulating gdb in batch mode. It supports:

  • Execution of target program (Local type).
  • Opening core of target program (Core type).
  • Attaching to remote process (Remote type).

Example

use std::process::Command;
use std::thread;
use std::time::Duration;
use gdb_command::*;

fn main () -> error::Result<()> {
    // Get stack trace from running program (stopped at crash)
    let result = GdbCommand::new(&ExecType::Local(&["tests/bins/test_abort", "A"])).r().bt().launch()?;

    // Get stack trace from core
    let result = GdbCommand::new(
            &ExecType::Core {target: "tests/bins/test_canary",
                core: "tests/bins/core.test_canary"})
        .bt().launch()?;

    // Get info from remote attach to process
    let mut child = Command::new("tests/bins/test_callstack_remote")
       .spawn()
       .expect("failed to execute child");

    thread::sleep(Duration::from_millis(10));

    // To run this test: echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope
    let result = GdbCommand::new(&ExecType::Remote(&child.id().to_string()))
        .bt()
        .regs()
        .disassembly()
        .launch();
    child.kill().unwrap();

    Ok(())
}

Installation

[dependencies]
gdb-command = "0.7.8"

License

This crate is licensed under the MIT license.

Dependencies

~2–3MB
~54K SLoC