Getting Started

The following sections explain how one can take advantage of QBDI through different use cases.

• C API
  • Load the target code
  • Initialise the virtual machine
  • Retrieve the VM context
  • Allocate a virtual stack
  • Write our first callback function
  • Register a callback
  • Count the iterations
  • Set instrumented ranges
  • Run the instrumentation
  • Terminate the execution properly
  • Full example
  • Generate a template
• C++ API
  • Load the target code
  • Initialise the virtual machine
  • Retrieve the VM context
  • Allocate a virtual stack
  • Our first callback function
  • Register a callback
  • Count the iterations
  • Set instrumented ranges
  • Run the instrumentation
  • Terminate the execution properly
  • Full example
• PyQBDI
  • Memory allocation
  • Load the target code
  • Initialise the virtual machine
  • Allocate a virtual stack
  • Write our first callback function
  • Register a callback
  • Set instrumented ranges
  • Run the instrumentation
  • Terminate the execution properly
  • Full example
• Frida/QBDI
  • Common tasks
  • Concrete example
  • Generate a template
• QBDIPreload
  • Main hook process
  • Instrumentation
  • Exit hook
  • Compilation and execution
  • Full example
  • Generate a template
  • On macOS
• PyQBDIPreload
  • Main hook process
  • Instrumentation
  • Exit hook
  • Execution
  • Full example
  • On macOS