primecount testing
Run the commands below from the primecount root directory.
cmake . -DBUILD_TESTS=ON
cmake --build . --parallel
ctest
To enable the optional architecture-specific assembly codegen tests use:
cmake . -DBUILD_CODEGEN_TESTS=ON
Please note that these assembly codegen tests should not be enabled when packaging primecount for Linux distros. The purpose of these assembly codegen tests is to debug performance issues, not corretness issues. These tests are run as part of primecount's GitHub Actions CI.
Test in debug mode
When hacking on primecount's source code, it is best to run its test suite
in debug mode i.e. -DCMAKE_BUILD_TYPE=Debug because this enables
extensive (but slow) runtime assertions. In case an assertion is triggered,
the file name and line number where the error occurred will be printed to
the screen. This helps to quickly identify newly introduced bugs.
# Run commands from primecount root directory
cmake . -DBUILD_TESTS=ON -DCMAKE_BUILD_TYPE=Debug -DCMAKE_CXX_FLAGS="-O1 -Wall -Wextra -pedantic" -DCMAKE_C_FLAGS="-O1 -Wall -Wextra -pedantic"
cmake --build . --parallel
ctest --output-on-failure
Test using GCC/Clang sanitizers
Running primecount's test suite with sanitizers enabled is also very useful as this helps find undefined behavior bugs and data races.
# Run commands from primecount root directory
cmake . -DBUILD_TESTS=ON -DCMAKE_CXX_FLAGS="-g -fsanitize=address -fsanitize=undefined -fno-sanitize-recover=all -fno-omit-frame-pointer -Wall -Wextra -pedantic" -DCMAKE_C_FLAGS="-g -fsanitize=address -fsanitize=undefined -fno-sanitize-recover=all -fno-omit-frame-pointer -Wall -Wextra -pedantic"
cmake --build . --parallel
ctest --output-on-failure