derek.holloway
7502bf64a4
1.8 KiB
hipBLASLt Reference
Supplementary reference for AGENTS.md — load this when you need raw cmake commands, cmake presets, or test instructions.
Raw CMake Build
After activating build/venv:
cmake -B build -S . \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_CXX_COMPILER=/opt/rocm/bin/amdclang++ \
-DCMAKE_C_COMPILER=/opt/rocm/bin/amdclang \
-DCMAKE_PREFIX_PATH=/opt/rocm \
-DGPU_TARGETS=gfx942 \
-DPython_EXECUTABLE="$(pwd)/build/venv/bin/python" \
-DPython3_EXECUTABLE="$(pwd)/build/venv/bin/python"
cmake --build build --parallel
CMake presets (cmake --list-presets): default:release, hipblaslt (host lib only, no device libs), gemm-libs (device libs only), hipblaslt-clients, tensilelite, rocisa, plus pinned configs rocm-7.0.0 / rocm-7.0.2.
Running Tests
Test data is generated at build time from clients/tests/data/*.yaml by clients/tests/hipblaslt_gentest.py into build/clients/hipblaslt_gtest.data. The binary looks for that file in its own directory, so:
cmake --build build --target tensilelite-device-libraries # one-time per GPU config; slow
cmake --build build --target hipblaslt-test
cd build/clients && ./hipblaslt-test --gtest_filter='*quick*'
Runtime device-library lookup: HIPBLASLT_TENSILE_LIBPATH must point directly at the dir containing TensileLibrary_lazy_<arch>.dat and the code objects (e.g. build/Tensile/library or /opt/rocm/lib/hipblaslt/library). If unset, the loader resolves relative to the loaded shared library. Matmul tests will fail without a device library for the running GPU.
To skip a test on a known-broken platform, add an entry under clients/tests/data/known_bugs.yaml (matched by function/initialization/known_bug_platforms).
rtest.py at the repo root is a build-driven test runner — not the usual entry point for local dev.