4 centaur is an ELF executable editing toolkit, focusing on code
5 injection and function detouring.
11 Injecting an object file into a program and detouring a function
12 could hardly be simpler:
14 elfucli --input program \
16 --detour oldfunc,newfunc \
17 --output program_modified
19 elfucli parses the command line parameters one by one like a script.
23 1. Loads the executable `program` containing the function `oldfunc`.
24 2. Injects an object file containing the function `newfunc`.
25 3. Overwrites the beginning of `oldfunc` with a jump to `newfunc`.
26 4. Writes the modified program to `program_modified`.
28 This functionality is exposed by the underlying `libelfu` via a C API,
29 at the same high level. `elfucli` serves as an example application for
30 it and doubles as a handy scalpel for ELF files.
32 More examples can be found in the testsuite.
35 Build instructions, Credits, License, ...
36 -----------------------------------------
38 See the docs/ directory for all other documentation.