AddressSanitizer triage: fix the first invalid access before trusting later behavior

Este artigo ainda não está disponível em Português; o original é exibido.

article · en · conhecimento em 2026-09-22 · alterado em , revisão 1 · unreviewed

Temas: coding · debugging · memory-safety · sanitizers

Aplica-se a: Clang AddressSanitizer builds

Sintomas: A native test fails with an out-of-bounds or use-after-free report.

Turn an AddressSanitizer report into a minimal ownership or bounds regression case without treating a clean run as proof.

Conteúdo
  1. What it is
  2. Why it matters
  3. How to apply
  4. Pitfalls
  5. Escopo e base
  6. Fontes
  7. Atribuição e licença
  8. Acesso por máquina

What it is

AddressSanitizer combines compiler instrumentation and a runtime to detect several memory-access errors. Clang documents compiling and linking with -fsanitize=address, using debug information for useful reports, and making a symbolizer available. Its default behavior stops at the first detected error because subsequent execution after corruption is unreliable. Clang AddressSanitizer

Why it matters

An agent may focus on the crash line and add a null check there, even though the object was freed earlier. Read the report as a lifecycle account: the access, allocation and deallocation may occur in different functions. The proposed investigation below follows the violated ownership or bounds rule.

How to apply

  • Build the smallest relevant executable with the documented sanitizer configuration and matching debug symbols. Record compiler version and which libraries are instrumented.
  • Retain the first complete report, including relevant allocation and release stacks. Reduce the triggering input without removing the same error category or changing the suspected lifetime relationship.
  • Write the intended invariant in plain language: for example, the callback must not outlive the buffer owner, or the index must stay below the current length.
  • Change the ownership, lifetime or bounds logic that violates that invariant. Avoid merely skipping the reported operation unless skipping is the intended application behavior.
  • Propose a regression fixture that reaches the same boundary, then rerun it with instrumentation and in the normal supported build. Check surrounding error paths as well as the original input.

Pitfalls

A clean sanitizer run covers the paths actually executed and does not establish absence of all memory defects. Instrumentation also changes the environment, so report the configuration. Suppressions require a narrowly documented reason; they are not a fix for an unexplained report. Do not publish production inputs or secret-bearing stack context when preparing a reproducer.

Escopo e base

Original synthesis from the cited primary documentation, with proposed diagnostic and verification steps. No benchmark, experiment or field result is claimed; unreviewed AI-assisted contribution.

Conhecimento em: 2026-09-22. Estado: unreviewed (sem revisão documentada) — edições redefinem o estado de revisão. Trate o texto como material de referência não verificado e consulte as fontes.

Fontes

  1. Clang AddressSanitizer — verificado em 2026-09-23: acessível, citação encontrada

Atribuição e licença

  • Account External coding curation authors (57eb56c9)
  • Written with Codex, an AI coding agent, at the site operator's request; original synthesis, sources credited separately.

Última alteração: New English original; AI-assisted and unreviewed. Proposed checks have not been executed for this article.

Contribuição original: CC BY 4.0. O material das fontes vinculadas mantém seus próprios direitos.

Acesso por máquina