Struct Generator 

pub struct Generator { /* private fields */ }

Generates Rust bindings from the Ir of one or more builds.

Create one with Generator::new, optionally configure it, then call generate.

Examples

let generator = imping_codegen::Generator::new()
    .module_name("TargetCore.dll", "target")
    .accept_build("steam", "TargetCore.dll", 0x64b8f2a1, 0xa3c000);

Implementations

impl Generator

pub fn new() -> Self

Creates a generator with default settings.

pub fn module_name( self, ir_name: impl Into<String>, rust_name: impl Into<String>, ) -> Self

Names the Rust module generated for the IR module ir_name.

By default it’s the IR module’s file name without the extension, in snake case: TargetCore.dll becomes target_core. If the same ir_name is given more than once, the last call wins.

pub fn accept_build( self, label: impl Into<String>, ir_name: impl Into<String>, timestamp: u32, image_size: u32, ) -> Self

Makes the generated init() of the IR module ir_name also accept, as the build labelled label, the image with this timestamp and image size.

Meant for the same code in a different image, such as an executable wrapped by a packer or DRM layer that keeps the timestamp but grows the image. The bindings promise the IR describes every build they accept, so only add images whose code and data match the analysed one.

pub fn generate(&self, builds: &[(&str, &Ir)]) -> Result<Bindings, Error>

Generates one set of bindings for every module in builds, the IR of each build with its label.

Validates each IR first. A module’s items are matched across the builds that have it; see Several builds. Anything the generator can’t represent becomes a Warning instead of an error. With no builds, the bindings are empty.

Errors

• Error::InvalidBuildLabel if a label isn’t lowercase letters, digits and single underscores, starting with a letter.
• Error::DuplicateBuild if two builds have the same label, or labels that make the same Build variant.
• Error::InvalidIr if an IR fails Ir::validate.
• Error::UnknownBuild if an accept_build names a label none of builds has.
• Error::UnknownModule if a module_name names a module no IR has, or an accept_build one its build’s IR doesn’t have.
• Error::InvalidModuleName if a module_name isn’t a valid Rust module name.
• Error::ModuleNameClash if two IR modules get the same Rust module name.
• Error::BuildsDiffer if two builds disagree on a type, a function’s signature or a global’s type.

Trait Implementations

impl Clone for Generator

fn clone(&self) -> Generator

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Generator

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Generator

fn default() -> Generator

Returns the “default value” for a type.