Skip to content

Splice 1.0.0

Latest
Latest

Choose a tag to compare

View all tags
@allenk allenk released this 14 Jun 00:08
v1.0.0
fb74756

Splice 1.0.0 — the first public release. A cross-platform C++20 function-hooking library with a type-safe, fluent API across ARM64 / x86_64 on Android, Linux, and Windows.

#include <splice/splice.h>

// Observe every frame — by name, resolved at install time (dlsym / IAT)
SPLICE_HOOK_LIB("libEGL.so", eglSwapBuffers)
    .after([](EGLBoolean, EGLDisplay, EGLSurface) { ++frame_count; });

// Conditionally rewrite an argument, then call through
SPLICE_HOOK(set_viewport)
    .when([](int w, int) { return w == 160; })
    .onInvoke([](auto orig, int, int h) { return orig(640, h); });

Why Splice

  • Compiler-checked hooks — signatures are deduced with decltype, so a wrong callback shape is a compile error, not a silent void*-cast crash. This is the headline advantage over C-style hooking libraries.
  • A fluent DSL that reads like English — .before / .after / .when / .once / .times / .onInvoke, plus SPLICE_HOOK_MEMBER and ScopedHook RAII auto-disable.
  • Honest about its limits — no fake "uninstall"; a tiered disable() instead.

Highlights

  • decltype-deduced, type-safe hook signatures — no void* casts
  • Fluent modifiers + diagnostic sugar (SPLICE_TRACE / SPLICE_COUNT / SPLICE_TIME)
  • Atomic install + tiered disable() (GOT/IAT pointer swap; inline atomic restore)
  • Lock-free RCU hook registry; per-call-site concurrency policy override
  • GOT/PLT on ELF, IAT on PE, inline instruction patching on ARM64 + x86_64
  • Exception-neutral (-fno-exceptions compatible); zero-alloc C-macro logging substrate

Platforms & CI

All green on every push:

Job Status
Linux x64 (gcc) + tests ✅
Linux x64 + ASan/UBSan ✅
Linux ARM64 (native) + tests ✅
Windows x64 (MSVC) + tests ✅
Android ARM64 (NDK cross-compile, build-only) ✅

Add it to your project

Source consumption (no prebuilt binaries — ABI safety):

include(FetchContent)
FetchContent_Declare(splice
    GIT_REPOSITORY https://github.com/allenk/splice.git
    GIT_TAG        v1.0.0)
FetchContent_MakeAvailable(splice)
target_link_libraries(your_target PRIVATE splice::splice)

add_subdirectory() and find_package(splice CONFIG) are also supported.

Honest about limits

  • No true reversible uninstall with memory reclaim — architecturally impossible for in-process, non-privileged inline hooks. disable() is tiered instead.
  • No stop-the-world thread coordination (would need ptrace/root).

Docs & examples

  • docs/splice-guide.md — capability guide (中文版: docs/splice-guide-zh.md)
  • docs/splice-vs-hooking-libraries.md — comparison vs other hooking libraries + the modern-C++ advantage
  • examples/ — hello_hook, malloc_tracker, member_function, plus runnable GPU and Vulkan enhancer demos

Licensed under MIT.

Assets 2
Loading