Skip to content

Commit 506e614

Browse files
committed
Document the available sanitizers in the README
1 parent ebed32c commit 506e614

File tree

1 file changed

+21
-1
lines changed

1 file changed

+21
-1
lines changed

README.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ The Unified Memory Framework (UMF) is a library for constructing allocators and
1313

1414
A UMF memory pool is a combination of a pool allocator and a memory provider. A memory provider is responsible for coarse-grained memory allocations and management of memory pages, while the pool allocator controls memory pooling and handles fine-grained memory allocations.
1515

16-
Pool allocator can leverage existing allocators (e.g. jemalloc or tbbmalloc) or be written from scratch.
16+
Pool allocator can leverage existing allocators (e.g. jemalloc or tbbmalloc) or be written from scratch.
1717

1818
UMF comes with predefined pool allocators (see include/pool) and providers (see include/provider). UMF can also work with user-defined pools and providers that implement a specific interface (see include/umf/memory_pool_ops.h and include/umf/memory_provider_ops.h)
1919

@@ -98,6 +98,22 @@ $ cd build
9898
$ cmake {path_to_source_dir}
9999
$ make
100100
```
101+
102+
### Sanitizers
103+
104+
List of sanitizers available on Linux:
105+
- AddressSanitizer
106+
- UndefinedBehaviorSanitizer
107+
- ThreadSanitizer
108+
- Is mutually exclusive with other sanitizers.
109+
- MemorySanitizer
110+
- Requires linking against MSan-instrumented libraries to prevent false positive reports. More information [here](https://github.com/google/sanitizers/wiki/MemorySanitizerLibcxxHowTo).
111+
112+
List of sanitizers available on Windows:
113+
- AddressSanitizer
114+
115+
Listed sanitizers can be enabled with appropriate [CMake options](#cmake-standard-options).
116+
101117
## Contributions
102118

103119
All code has to be formatted using clang-format. To check the formatting do:
@@ -131,3 +147,7 @@ List of options provided by CMake:
131147
| UMF_ENABLE_POOL_TRACKING | Build UMF with pool tracking | ON/OFF | ON |
132148
| UMF_DEVELOPER_MODE | Treat warnings as errors and enables additional checks | ON/OFF | OFF |
133149
| UMF_FORMAT_CODE_STYLE | Add clang-format-check and clang-format-apply targets to make | ON/OFF | OFF |
150+
| USE_ASAN | Enable AddressSanitizer checks | ON/OFF | OFF |
151+
| USE_UBSAN | Enable UndefinedBehaviorSanitizer checks | ON/OFF | OFF |
152+
| USE_TSAN | Enable ThreadSanitizer checks | ON/OFF | OFF |
153+
| USE_MSAN | Enable MemorySanitizer checks | ON/OFF | OFF |

0 commit comments

Comments
 (0)