Skip to content

Commit cdcc4a5

Browse files
Revert "Code escape values"
This reverts commit 2922a7e.
1 parent d2cd848 commit cdcc4a5

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

docs/sanitizers/asan-flags.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -21,44 +21,44 @@ The following table lists the options for the AddressSanitizer. Enable them via
2121
|`allocator_may_return_null` | `false` | If `true`, the allocator returns `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.|
2222
|`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using the [Manual AddressSanitizer poising interface](./asan-runtime.md#poisoning).|
2323
|`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.|
24-
|`continue_on_error` | `0` | Allows an application to continue running while reporting memory safety errors.<br>`0` - disabled.<br>`1` - enabled. errors are sent to `stdout`.<br>`2` - enabled. errors are sent to `stderr`.<br>For more information, see [continue_on_error](asan-continue-on-error.md).|
24+
|`continue_on_error` | 0 | Allows an application to continue running while reporting memory safety errors.<br>0-disabled.<br>1-enabled; errors are sent to `stdout`.<br>2-enabled; errors are sent to `stderr`.<br>For more information, see [continue_on_error](asan-continue-on-error.md).|
2525
|`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. For more information, see [ContainerOverflow](./error-container-overflow.md).|
2626
|`detect_invalid_pointer_pairs` | `false` | If `true`, ASan detects operations like `<`, `<=`, `>`, `>=`, and `-` on invalid pointer pairs such as pointers that belong to different objects.|
2727
|`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. For more information, see [stack-use-after-return](./error-stack-use-after-return.md).|
28-
|`exitcode` | `1` | Overrides the program exit status with this value if ASan finds an error.|
29-
|`external_symbolizer_path` | `""` | Path to the external symbolizer. If empty, ASan searches `$PATH` for the symbolizer.|
28+
|`exitcode` | 1 | Overrides the program exit status with this value if ASan finds an error.|
29+
|`external_symbolizer_path` | "" | Path to the external symbolizer. If empty, ASan searches `$PATH` for the symbolizer.|
3030
|`fast_unwind_on_malloc` | `true` | If available, ASan uses the fast frame-pointer-based unwinder on `malloc`/`free`.|
3131
|`halt_on_error` | `true` | Not supported. Use `continue_on_error` instead.|
3232
|`handle_segv` | `true` | If `true`, ASan handles `SEGV` errors.|
3333
|`handle_sigfpe` | `true` | If `true`, ASan handles `SIGFPE` errors.|
3434
|`handle_sigill` | `true` | If `true`, ASan handles `SIGILL` errors.|
3535
|`help` | `false` | If `true`, ASan prints the flag options to the console.|
3636
|`iat_overwrite`|`error`|`error` - reports an error whenever an overwrite is detected.<br>`protect` - trys to avoid using the overwritten definition.<br>`ignore` - doesn't try to correct any overwritten functions. For more information, see [`iat_overwrite`](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).|
37-
|`include_if_exists` | `""` | Reads options from the specified file. ASan doesn't fail if the file doesn't exist.|
37+
|`include_if_exists` | "" | Reads options from the specified file. ASan doesn't fail if the file doesn't exist.|
3838
|`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for `strpbrk` to find more errors.|
3939
|`intercept_strspn` | `true` | If `true`, uses custom wrappers for `strspn` and `strcspn` to find more errors.|
4040
|`intercept_strstr` | `true` | If `true`, uses custom wrappers for `strstr` and `strcasestr` to find more errors.|
41-
|`malloc_context_size` | `1` | Maximum number of stack frames to keep for each allocation/deallocation.|
41+
|`malloc_context_size` | 1 | Maximum number of stack frames to keep for each allocation/deallocation.|
4242
|`malloc_fill_byte` | `0xbe` | Value used to fill newly allocated memory.|
43-
|`max_malloc_fill_size` | `4096` | The ASan allocator fills an allocation with `malloc_fill_byte` up to `max_malloc_fill_size` on a call to `malloc`.|
44-
|`max_redzone` | `2048` | Maximum size (in bytes) of redzones around heap objects.|
43+
|`max_malloc_fill_size` | 4096 | The ASan allocator fills an allocation with `malloc_fill_byte` up to `max_malloc_fill_size` on a call to `malloc`.|
44+
|`max_redzone` | 2048 | Maximum size (in bytes) of redzones around heap objects.|
4545
|`new_delete_type_mismatch` | `true` | Report errors on mismatch between the size of `new` and `delete`. For more information, see [`new-delete-type-mismatch`](./error-new-delete-type-mismatch.md).|
4646
|`poison_heap` | `true` | If `true`, poison the heap memory on allocation and deallocation. `false` is useful for benchmarking the allocator or instrumentator.|
4747
|`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.|
4848
|`print_cmdline` | `false` | Print the command line on crash. With `continue_on_error` set >= 1, prints the current working directory and is `UTF-16` aware.|
4949
|`print_summary` | `true` | If `false`, disables showing error summaries that accompany error reports.|
50-
|`quarantine_size_mb` | `-1` | Size (in Mb) of quarantine used to detect `use-after-free` errors. A lower value may increase the chance of false negatives.|
51-
|`redzone` | `16` | Minimum size (in bytes) of redzones around heap objects. Requirement: `redzone >= 16` and must be a power of two.|
50+
|`quarantine_size_mb` | -1 | Size (in Mb) of quarantine used to detect `use-after-free` errors. A lower value may increase the chance of false negatives.|
51+
|`redzone` | 16 | Minimum size (in bytes) of redzones around heap objects. Requirement: `redzone >= 16` and must be a power of two.|
5252
|`replace_str` | `true` | If `true`, uses custom wrappers and replacements for `libc` string functions to find more errors.|
53-
|`report_globals` | `1` | How to respond to buffer overflow for globals:<br>`0` - don't detect buffer overflow on globals.<br>`1` - detect buffer overflow.<br>`2` - detect buffer overflow and print registered globals data.|
54-
|`sleep_before_dying` | `0` | Number of seconds to sleep between printing an error report and terminating the program.|
53+
|`report_globals` | 1 | How to respond to buffer overflow for globals:<br>0-don't detect buffer overflow on globals.<br>1 - detect buffer overflow.<br>2 - detect buffer overflow and print registered globals data.|
54+
|`sleep_before_dying` | 0 | Number of seconds to sleep between printing an error report and terminating the program.|
5555
|`stack_trace_format` | `DEFAULT` | Format string used to render stack frames. `DEFAULT` - ` #%n %p %F %L`. List of available placeholders:<br> `%%` - represents a `'%'` character<br> `%n` - frame number (copy of `frame_no`)<br> `%p` - `PC`<br> `%m` - path to module<br> `%o` - offset in the module<br> `%f` - function name<br> `%q` - if available, offset in the function<br> `%s` - path to source file<br> `%l` - line in the source file<br> `%c` - column in the source file<br> `%F` - if the function is known, ASan prints `in <func name>` followed by the offset in this function if source is unknown<br> `%S` - ASan prints file/line/column information<br> `%L` - If file information is available, ASan prints the file name, line, and column. If module information is available, ASan prints the module name, offset, and architecture. If neither are available, ASan prints `(<unknown module>)`<br> `%M` - If known, ASan prints module basename and offset, or `PC`|
5656
|`strict_memcmp` | `true` | If `true`, assumes that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.|
5757
|`strict_string_checks` | `false` | If `true` checks that string arguments are properly null-terminated.|
58-
|`strip_path_prefix` | `""` | Strips this prefix from file paths in error reports.|
58+
|`strip_path_prefix` | "" | Strips this prefix from file paths in error reports.|
5959
|`symbolize` | `true` | If `true`, use the `llvm-symbolizer` to turn virtual addresses into file or line locations.|
6060
|`symbolize_inline_frames` | `true` | Print inlined frames in stacktraces.|
61-
|`verbosity` | `0` | Verbosity level:<br>`0` - default verbosity.<br>`1` - more output.<br>`2` - even more output.<br>`3` - maximum verbosity. |
61+
|`verbosity` | 0 | Verbosity level:<br>0 - default verbosity.<br>1 - more output.<br>2 - even more output.<br>3 - maximum verbosity. |
6262
|`windows_fast_fail_on_error`| `false` | If `true`, the process can terminate with a `__fastfail(71)` after printing the error report. For more information, see [`windows_fast_fail_on_error`](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).|
6363
|`windows_hook_legacy_allocators`| `true` |If `true`, enables hooking of (`Global`/`Local`)(`Alloc`/`Free`/`Size`/`ReAlloc`/`Lock`/`Unlock`) functions.|
6464

0 commit comments

Comments
 (0)