idakit-sys 0.1.0

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

//! A hand-written `cxx` bridge over the *generated* [`FlowChart`] `ExternType` (`idakit_cxx::cfg2_*`).
//!
//! This bridge exists only to prove that a hand-written bridge can share an `ExternType` the
//! spec-driven generator produced. It declares no `qflow_chart_t` of its own; instead it aliases
//! the *same* Rust type [`bridge_gen`](crate::bridge_gen) bound to the SDK's `qflow_chart_t`. A
//! `&FlowChart` produced by [`cfg_build`](crate::bridge_gen::cfg_build) is therefore accepted here
//! without conversion, which a `using`-alias-per-bridge form could not express (each bridge would
//! mint its own distinct opaque `FlowChart`). The body is hand-written in `facade/cfg2_cxx.cc`
//! (declaration in `facade/cfg2_cxx.h`).

#[cxx::bridge(namespace = "idakit_cxx")]
mod ffi {
    unsafe extern "C++" {
        include!("cfg2_cxx.h");

        /// The same `qflow_chart_t` the [`bridge_gen`](crate::bridge_gen) bridge bound; this is
        /// a type alias, not a fresh opaque type, so the two bridges share one Rust `FlowChart`.
        ///
        /// The C++ name override is repeated per bridge (`cxx` derives the emitted name from
        /// each declaration), so this bridge also emits the real global `::qflow_chart_t`.
        #[namespace = ""]
        #[cxx_name = "qflow_chart_t"]
        type FlowChart = crate::bridge_gen::FlowChart;

        /// Total number of successor edges across the whole graph (the sum of every block's
        /// successor count). A free function over a `&FlowChart` built by the generated bridge.
        fn cfg2_total_edges(fc: &FlowChart) -> usize;
    }
}

pub use ffi::cfg2_total_edges;