# 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`.