Download Configurable Binary Instrumenter User Manual

3
Contents
1
Introduction
5
2
Build Instructions
7
2.1
XML Parser: Xerces-C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
2.2
Libelf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8
2.3
Libdwarf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8
2.4
Nasm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8
2.5
Dyninst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8
2.6
Boost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9
2.7
Dependency Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9
2.8
The Configurable Binary Instrumenter . . . . . . . . . . . . . . . . . . . . . . .
9
3
How-to Invoke the Instrumenter
11
4
The Adapter Specification
13
4.1
Adding Additional Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4.2
Define an Adapter Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4.3
Define Inserted Instrumentation Code . . . . . . . . . . . . . . . . . . . . . . . 14
4.3.1
Accessing Context Information . . . . . . . . . . . . . . . . . . . . . . . 16
4.3.2
Using Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16