blob: 225452dd6a6013f41d135fa4611ace6753dabb67 (
plain)
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
|
# cdl86
cdl86 - Compact Detour Library 86
# Abstract
cdl86 is a simple cross platform detours library written in C for Linux and Windows.
It allows for the interception of x86 and x86_64 C/C++ functions in memory.
[https://journal.lunar.sh/2022/linux-detours.html](https://journal.lunar.sh/2022/linux-detours.html)
The library currently supports two types of function hooks:
* JMP patch - patches origin function with a JMP to detour.
* INT3 patch - places software breakpoint (SWBP) at origin address. Handles control flow to detour.
This project makes use of an internal x86 instruction length disassembly engine.
# API
```C
struct cdl_jmp_patch cdl_jmp_attach(void **target, void *detour);
struct cdl_swbp_patch cdl_swbp_attach(void **target, void *detour);
void cdl_jmp_detach(struct cdl_jmp_patch *jmp_patch);
void cdl_swbp_detach(struct cdl_swbp_patch *swbp_patch);
void cdl_jmp_dbg(struct cdl_jmp_patch *jmp_patch);
void cdl_swbp_dbg(struct cdl_swbp_patch *swbp_patch);
```
The API is documented in more detail in the corresponding header and source
files.
# Info
**cdl.c** - C source file for CDL. <br>
**cdl.h** - CDL header file to include.
Folders:
* **/tests** - CDL test suite. Run `make all`.
|
