Skip to content

Add -fsanitize-minimal-runtime and -fsanitize-trap=undefined to UBSan description table #933

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jul 10, 2025
Merged

Add -fsanitize-minimal-runtime and -fsanitize-trap=undefined to UBSan description table #933

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a4e0ac6
Add -fsanitize-minimal-runtime to UBSan description
thomasnyman Jun 27, 2025
c0aac42
Add -fsanitize-trap=undefined to UBSan description
thomasnyman Jun 28, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions docs/Compiler-Hardening-Guides/Compiler-Options-Hardening-Guide-for-C-and-C++.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1304,9 +1304,11 @@ LSan cannot be used simultaneously with AddressSanitizer (ASan) or ThreadSanitiz

### UndefinedBehaviorSanitizer

| Compiler Flag | Supported since | Description |
|:---------------------- |:---------------------:|:--------------------------------------------------------------------------- |
| `-fsanitize=undefined`<br/>(requires `-O1` or higher) | GCC 4.9.0<br/>Clang 3.3.0 | Enables UndefinedBehaviorSanitizer to detect undefined behavior at run time |
| Compiler Flag | Supported since | Description |
|:------------------------------------------------------------------------- |:-------------------------:|:--------------------------------------------------------------------------------------------------------------------------------- |
| <span id="-fsanitize=undefined">`-fsanitize=undefined`</span> | GCC 4.9.0<br/>Clang 3.3.0 | Enables UndefinedBehaviorSanitizer to detect undefined behavior at run time. Requires `-O1` or higher. |
| <span id="-fsanitize-minimal-runtime">`-fsanitize-minimal-runtime`</span> | Clang 6.0.0 | Enables minimal UBSan runtime rather than Clang's usual libubsan library for using UBSan in production code. |
| <span id="-fsanitize-trap=undefined">`-fsanitize-trap=undefined`</span> | GCC 13.1.0 | Enables UBSan with reporting through `__builtin_trap` rather than GCC's usual libubsan runtime library. Requires `-O1` or higher. |

UndefinedBehaviorSanitizer (UBSan) is a detector of non-portable or erroneous program constructs which cause behavior which is not clearly defined in the ISO C standard. UBSan provides a large number of sub-options to enable / disable individual checks for different classes of undefined behavior. Consult the GCC[^gcc-instrumentation] and Clang[^clang-ubsan] documentation respectively for up-to-date information on supported sub-options.

Expand Down