Debug ASAN Build

Debug ASAN Build

Configure

• Run:
  • cmake --preset debug-asan
• This preset inherits the default binary dir: build/ and sets ENABLE_ASAN=ON.

Build

• Build everything:
  • cmake --build --preset debug-asan
• Build a specific target:
  • cmake --build --preset debug-asan --target <target>
• Many app targets live under debug-asan/. Use the app target name as the build target.

Run

• Preferred binary path pattern:
  • ./​build/​debug-asan/<target>/<target>_debug
• Example:
  • ./​build/​debug-asan/​cert_ctrl_debug

Test

• ctest --test-dir build/​debug-asan Run all tests (with failures shown):
• ctest --test-dir build/​debug-asan --output-on-failure List all discovered tests:
• ctest --test-dir build/​debug-asan -N Run a subset by regex:
• ctest --test-dir build/​debug-asan -R <regex> --output-on-failure

Notes:

CTest filters by registered test names (GoogleTest suite/​case), not by the test executable name. For example, the test_websocket_client executable registers tests like WebsocketClientIntegrationTest.*, so this works:

• ctest --test-dir build/​debug-asan -R WebsocketClientIntegrationTest --output-on-failure
• Run a single gtest binary:

Python (Harnesses / E2E)

Some long-running quality checks are implemented as small Python harnesses (e.g. websocket end-to-end drivers under tests/​e2e/).

On some minimal Linux images, python3 -m venv or python3 -m pip may not be available by default. Prefer using uv for Python-related tasks.

• Check uv:
  • uv --version
• Run a one-off script with ephemeral deps (no venv needed):
  • uv run --with websockets>=12,<14 python tests/​e2e/​ws_e2e_harness.py --bin ./​build/​debug-asan/​cert_ctrl_debug

If uv is not installed, install it via your standard tooling (for example, your distro package manager or the upstream installer), then rerun the command above.

ASAN Notes

• The preset already sets ASAN_OPTIONS=allocator_may_return_null=1 during configure.
• If you need to override runtime ASAN options, export ASAN_OPTIONS before running.