# Debug Asan Build

> Build and test this repo with the CMake preset debug-asan (AddressSanitizer). Use when asked how to configure, build, run, or test with ASAN/debug builds in this project.

- Skill: `majiayu000/debug-asan-build` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/debug-asan-build`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/debug-asan-build/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/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.