38 releases

0.13.6 Apr 1, 2024
0.13.4 Dec 27, 2023
0.13.2 Aug 15, 2023
0.13.1 Jul 30, 2023
0.3.2 Mar 21, 2021

#89 in Debugging

Download history 498/week @ 2024-02-14 419/week @ 2024-02-21 638/week @ 2024-02-28 664/week @ 2024-03-06 624/week @ 2024-03-13 626/week @ 2024-03-20 792/week @ 2024-03-27 1027/week @ 2024-04-03 519/week @ 2024-04-10 502/week @ 2024-04-17 795/week @ 2024-04-24 669/week @ 2024-05-01 470/week @ 2024-05-08 1291/week @ 2024-05-15 674/week @ 2024-05-22 723/week @ 2024-05-29

3,228 downloads per month
Used in libafl_frida

wxWindows

480KB
4K SLoC

frida-gum docs.rs

Rust bindings for Frida Gum.

Before Installing

  • Build Frida or download the latest supported package
  • Move frida-gum.h and libfrida-gum.a into /usr/local/include and /usr/local/lib (or a more appropriate folder that Rust can detect)

Or: use the auto-download feature to install Frida.

See the documentation for usage instructions.


lib.rs:

Gum bindings for Rust

Gum provides a number of utilities for instrumenting binary applications, and traditionally is consumed via the JavaScript API known as GumJS. This crate aims to provide a complete interface to the instrumentation API provided by Gum, rather than GumJS (s.t. these bindings exclude the Java and ObjC modules).

Quick Start

First, ensure that your platform is supported by Gum. You can find a listing of development kits on the Frida releases page. To get started using Gum, you need to obtain a global [Gum] object; this is required to safely ensure that Gum has been properly initialized as required. Next, you are free to use any available APIs, such as the stalker::Stalker:

use frida_gum::{Gum, stalker::{Stalker, Transformer}};
#[cfg(feature = "event-sink")]
use frida_gum::stalker::NoneEventSink;
use lazy_static::lazy_static;

lazy_static! {
    static ref GUM: Gum = unsafe { Gum::obtain() };
}

fn main() {
    let mut stalker = Stalker::new(&GUM);

    let transformer = Transformer::from_callback(&GUM, |basic_block, _output| {
        for instr in basic_block {
            instr.keep();
        }
    });

    #[cfg(feature = "event-sink")]
    stalker.follow_me::<NoneEventSink>(&transformer, None);
    #[cfg(not(feature = "event-sink"))]
    stalker.follow_me(&transformer);
    stalker.unfollow_me();
}

Dependencies

~1–4.5MB
~83K SLoC