idakit-sys 0.1.1

Raw FFI bindings to IDA Pro's idalib runtime and the idakit C++ facade
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

//! Core-read through the generated cxx bridge: open a DB copy, list functions + segments.
//! Run: cargo run -p idakit-sys --example read -- path/to/database.i64

use std::env;
use std::ffi::CString;
use std::ptr;

use idakit_sys::*;

fn main() {
    let db = env::args()
        .nth(1)
        .expect("usage: read <db.i64>  (a COPY; opened save=false)");

    // SAFETY: the library lifecycle is the raw C ABI; the func_*/seg_* reads below are safe bridge
    // calls needing no `unsafe`.
    unsafe {
        assert_eq!(init_library(0, ptr::null_mut()), 0, "init_library failed");
        let cpath = CString::new(db.clone()).unwrap();
        assert_eq!(
            open_database(cpath.as_ptr(), false, ptr::null()),
            0,
            "open_database failed"
        );
    }

    let nf = func_qty();
    println!("functions: {nf}");
    println!("first 12 by index:");
    for i in 0..12.min(nf) {
        let address = func_ea(i);
        let name = func_name(address).unwrap_or_default();
        println!("  [{i:>2}] {address:#012x}  {name}");
    }

    let ns = gen_seg_qty();
    println!("\nsegments: {ns}");
    for n in 0..ns {
        let n = n as i32;
        let (s, e) = (gen_seg_start(n), gen_seg_end(n));
        let name = gen_seg_name(n).unwrap_or_default();
        println!("  {s:#012x}..{e:#012x}  {name}");
    }

    // SAFETY: raw C ABI lifecycle call.
    unsafe {
        close_database(false);
    }

    println!("\nREAD OK");
}