Wakeful-Cloud / cpp-proxy

C++ shared library proxy prototype

C++ Proxy

C++ proxy/intercept prototypes

Prototypes

• ld-preload: a shared-library proxy based on LD_PRELOAD
• ld-preload-template: a shared-library proxy based on LD_PRELOAD with C++ templates
• ptrace: a static-library proxy based on ptrace (X86-only)
• dynamorio: a static-library proxy based on DynamoRIO
• qbdi: a static-library proxy based on QuarkslaB Dynamic binary Instrumentation (QBDI)
• eigen: a proxy for intercepting Eigen static library calls based on QuarkslaB Dynamic binary Instrumentation (QBDI) (X86-only)

Documentation

Architecture

This repository contains Docker images for x86-64 (amd64) and ARM v8 64 bit (arm64-v8) in order to simulate running the proxies in a variety of environments including servers, desktops, and mobile/embedded systems. You will likely need to setup QEMU for development unless you're using Docker Desktop on non-Linux systems.

Docker

1. Install Docker
2. Build:

docker build . -f amd64.dockerfile -t cpp-proxy:amd64
# Or
docker build . -f arm64-v8.dockerfile -t cpp-proxy:arm64-v8

3. Run:

# Note: CAP_SYS_PTRACE is required for process_vm_readv and QBDIPreload to work
docker run -it --cap-add CAP_SYS_PTRACE -v "$(pwd):/home/dev/cpp-proxy" --name cpp-proxy-amd64 cpp-proxy:amd64
# Or
docker run -it --cap-add CAP_SYS_PTRACE -v "$(pwd):/home/dev/cpp-proxy" --name cpp-proxy-arm64-v8 cpp-proxy:arm64-v8

4. Notes:

• The default user (dev) has password-less sudo setup and uses Zsh
• The /home/dev/cpp-proxy directory in the container is mapped to the repository root directory on the host, but you will probably need to chown it (eg: sudo chown dev:dev /home/dev -R)