retour 0.3.1

A cross-platform detour library written in Rust
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

use once_cell::sync::Lazy;

use crate::{alloc, arch, error::Result, pic};
use std::sync::Mutex;

/// Shared allocator for all detours.
pub static POOL: Lazy<Mutex<alloc::ThreadAllocator>> = Lazy::new(|| {
  // Use a range of +/- 2 GB for seeking a memory block
  Mutex::new(alloc::ThreadAllocator::new(arch::meta::DETOUR_RANGE))
});

/// Allocates PIC code at the specified address.
pub fn allocate_pic(
  pool: &mut alloc::ThreadAllocator,
  emitter: &pic::CodeEmitter,
  origin: *const (),
) -> Result<alloc::ExecutableMemory> {
  // Allocate memory close to the origin
  pool.allocate(origin, emitter.len()).map(|mut memory| {
    // Generate code for the obtained address
    let code = emitter.emit(memory.as_ptr() as *const _);
    memory.copy_from_slice(code.as_slice());
    memory
  })
}