blob: c9ddb655413179f63c412c455ccfd7f66206d771 (
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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
|
centaur
=======
centaur is an ELF executable editing toolkit, focusing on code
injection and function detouring.
Example
-------
Injecting an object file into a program and detouring a function
could hardly be simpler:
elfucli --input program \
--reladd objfile.o \
--detour oldfunc,newfunc \
--output program_modified
elfucli parses the command line parameters one by one like a script.
In this example, it:
1. Loads the executable `program` containing the function `oldfunc`.
2. Injects an object file containing the function `newfunc`.
3. Overwrites the beginning of `oldfunc` with a jump to `newfunc`.
4. Writes the modified program to `program_modified`.
This functionality is exposed by the underlying `libelfu` via a C API,
at the same high level. `elfucli` serves as an example application for
it and doubles as a handy scalpel for ELF files.
More examples can be found in the testsuite. The 'detour' test is
particularly similar to the example above.
Build instructions, testing
---------------------------
Usually, a plain
make
should be enough to build centaur, provided that a version of libelf
and its development files are installed. If not, see docs/building.md
for further hints such as the packages to be installed on Ubuntu.
Once that is done,
make check
will build and run the testsuite. See docs/tests.md for details.
License, etc
------------
See the docs/ directory for all other documentation.
|