Skip to content

Commit dc8d3f1

Browse files
authored
Merge pull request #6158 from davidmrdavid/dev/dajusto/document-x64-debug-spew-in-asan
Document ASan x64 debug spew
2 parents 4ba32da + e228a3c commit dc8d3f1

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

docs/sanitizers/asan-known-issues.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "AddressSanitizer known issues and limitations"
33
description: "Technical description of the AddressSanitizer for Microsoft C/C++ known issues."
4-
ms.date: 5/21/2025
4+
ms.date: 11/19/2025
55
helpviewer_keywords: ["AddressSanitizer known issues"]
66
---
77

@@ -99,6 +99,12 @@ If all of the DLLs compiled with ASan are unloaded from the process before the p
9999

100100
Please report any bugs to our [Developer Community](https://aka.ms/feedback/report?space=62).
101101

102+
## ASan 64-bit first chance exceptions
103+
104+
On x64, MSVC ASan's [shadow bytes](./asan-shadow-bytes.md) region occupies several terabytes of virtual address space. ASan doesn't pre-commit this memory. Instead, it uses on-demand paging. When a shadow page is accessed for the first time, a first-chance page fault exception occurs and is handled by ASan, which commits the page.
105+
106+
The Visual Studio debugger handles this gracefully, and doesn't show these traces. However, debuggers like WinDbgX may break on every exception by default. Disabling breaking on first-chance exceptions is recommended. For example, in WinDbgX, this corresponds to the [`sxd av`](/windows-hardware/drivers/debuggercmds/sx--sxd--sxe--sxi--sxn--sxr--sx---set-exceptions-) command.
107+
102108
## See also
103109

104110
[AddressSanitizer overview](asan.md)\

0 commit comments

Comments
 (0)