References — bi-12 Debugging and Tracing Chromium

Primary sources first. In-tree Chromium docs beat any external source, including these modules.

Debugging

• Debugging Chromium on macOS · Linux
• docs/lldbinit.md — the recommended .lldbinit; use the in-tree version rather than a copied snippet
• Debugging with Blink layout tests
• Attaching to the right process: launch with --renderer-startup-dialog or --no-sandbox --renderer-cmd-prefix, then attach.

Tracing

• Perfetto documentation — the modern trace viewer and query engine
• Trace event format — the legacy JSON format still emitted by TRACE_EVENT
• base/trace_event/ — the macros: TRACE_EVENT0, TRACE_EVENT_INSTANT, async events
• chrome://tracing (legacy) and ui.perfetto.dev (current)

Related modules

• bi-01 — Navigating Chromium — find the code before you break on it
• bi-15 — Vertical traces — where tracing becomes the whole exercise
• fe-01 — Execution model (sibling project) — the DevTools-level equivalent, including LoAF vs long tasks

When a claim here proves stale, record it in PROGRESS.md section 7.