Skip to content
Merged
Changes from all commits
Commits
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
28 changes: 28 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -469,6 +469,32 @@ If you want to see all the other flags you can pass, run:
out\bench\benchmark-<benchmark-name> --help
```

## Other Useful Incantations

To compile the benchmarks with additional compiler options, use the [`CXXFLAGS` environment variable][CXXFLAGS].
Set it after configuring and building the STL, but before configuring and building the benchmarks.
For example, to examine how the `/arch:AVX2` option affects auto-vectorization and bit algorithm intrinsics:

```
set CXXFLAGS=/arch:AVX2
cmake -B out\bench -S benchmarks -G Ninja -DSTL_BINARY_DIR=out\x64
cmake --build out\bench
```

To compile the benchmarks with Clang, use `-DCMAKE_CXX_COMPILER=clang-cl`:

```
cmake -B out\bench -S benchmarks -G Ninja -DSTL_BINARY_DIR=out\x64 -DCMAKE_CXX_COMPILER=clang-cl
cmake --build out\bench
```

To run a benchmark on specific cores (e.g. P-cores vs. E-cores) and with higher priority
(to avoid interference), use the [`start` command][start-command]:

```
start /b /wait /high /affinity 0F out\bench\benchmark-std_copy
```

# Editing And Testing The Debugger Visualizer

### Modify The Visualizer
Expand Down Expand Up @@ -581,3 +607,5 @@ SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
[ASan]: https://learn.microsoft.com/en-us/cpp/sanitizers/asan
[Import Library]: /docs/import_library.md
[VS 2026 Insiders]: https://visualstudio.microsoft.com/insiders/
[CXXFLAGS]: https://cmake.org/cmake/help/latest/envvar/CXXFLAGS.html
[start-command]: https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/start