Dobby Exploit Hook Framework

Dobby is a lightweight, multi-platform, and multi-architecture exploit hook framework. It is designed to be a minimal and modular library suitable for various environments.

Supported Platforms:

• Windows
• macOS
• iOS
• Android
• Linux

Supported Architectures:

• X86
• X86-64
• ARM
• ARM64

Use the scripts/platform_builder.py script to automate builds for different platforms.

iOS (iphoneos):

python3 scripts/platform_builder.py --platform=iphoneos --arch=all

macOS:

python3 scripts/platform_builder.py --platform=macos --arch=all

Linux: Requires running the setup script first to prepare CMake and LLVM.

sh scripts/setup_linux_cross_compile.sh
python3 scripts/platform_builder.py --platform=linux --arch=all --cmake_dir=$HOME/opt/cmake-3.25.2 --llvm_dir=$HOME/opt/llvm-15.0.6

Android: Requires running the setup script and providing paths to CMake, LLVM, and the Android NDK.

sh scripts/setup_linux_cross_compile.sh
python3 scripts/platform_builder.py --platform=android --arch=all --cmake_dir=$HOME/opt/cmake-3.25.2 --llvm_dir=$HOME/opt/llvm-15.0.6 --android_ndk_dir=$HOME/opt/ndk-r25b

You can download the latest pre-compiled versions of the Dobby library from the official GitHub releases page.

https://github.com/jmpews/Dobby/releases/tag/latest

To build Dobby for your local host machine, use standard CMake commands within the Dobby directory.

cd Dobby && mkdir cmake-build-host && cd cmake-build-host
cmake ..
make -j4

To use Dobby as a subdirectory in an Android Studio project, use add_subdirectory and configure the Dobby options using a macro to set cache variables. You must also include the Dobby include directories to ensure your native library can find the headers.

if(NOT TARGET dobby)
set(DOBBY_DIR /Users/jmpews/Workspace/Project.wrk/Dobby)
macro(SET_OPTION option value)
  set(${option} ${value} CACHE INTERNAL "" FORCE)
endmacro()
SET_OPTION(DOBBY_DEBUG OFF)
SET_OPTION(DOBBY_GENERATE_SHARED OFF)
add_subdirectory(${DOBBY_DIR} dobby)
get_property(DOBBY_INCLUDE_DIRECTORIES
  TARGET dobby
  PROPERTY INCLUDE_DIRECTORIES)
include_directories(
  .
  ${DOBBY_INCLUDE_DIRECTORIES}
  $<TARGET_PROPERTY:dobby,INCLUDE_DIRECTORIES>
)
endif()

add_library(native-lib SHARED
  ${DOBBY_DIR}/examples/socket_example.cc
  native-lib.cpp)