Safe Rust bindings for the COM interfaces of the Windows debugging engine.
- ✅ Safe Rust bindings for Windows debugging interfaces.
- ✅ Easy-to-use macros for logging to the debugger.
- ✅ Abstractions for managing symbols, memory, and CPU registers.
- ✅ Works seamlessly with the Windows COM-based debugging system.
Add dbg
to your project by updating your Cargo.toml
:
cargo add dbg-rs
The dbg-rs
library provides utilities to interact with the Windows debugging engine, such as executing commands, logging messages, and inspecting debug symbols. Below are some common use cases:
Use the dprintln!
macro to send formatted messages to the debugger output:
use dbg_rs::dprintln;
// Example usage
dprintln!(dbg, "Hello, {}!", "Debugger");
dprintln!(dbg, "Number: {}", 42);
Running commands in the debugger:
use dbg_rs::Dbg;
dbg.exec(".echo Hello, Debugger!")?;
Access specific regions of the debugged process's memory:
use dbg_rs::Dbg;
let mut buffer = vec![0u8; 128];
dbg.read_vaddr(0x7FFEBEEF0000, &mut buffer)?;
println!("Read memory: {:?}", &buffer[..16]); // Print first 16 bytes
For more examples, check the examples folder in the repository.
This project is licensed under the MIT License. See the LICENSE file for details.