derek.holloway
7502bf64a4
CodeQL / Analyze (actions) (push) Canceled after 0s
CodeQL / Analyze (python) (push) Canceled after 0s
pre-commit / pre-commit (push) Canceled after 0s
Multi-Arch CI / setup (push) Canceled after 0s
Publish build_manylinux_x86_64 images / publish_build_manylinux_x86_64 (push) Canceled after 0s
Setup (Multi-Arch) / setup (push) Canceled after 0s
Multi-Arch CI / Linux::${{ fromJSON(needs.setup.outputs.linux_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubi10 image / publish_no_rocm_image_ubi10 (push) Canceled after 0s
Multi-Arch CI / Windows::${{ fromJSON(needs.setup.outputs.windows_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Multi-Arch CI / Manifest Diff (push) Canceled after 0s
TheRock Manifest Diff Report / Generate Manifest Diff Report (push) Canceled after 0s
Multi-Arch CI / CI Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_ocl_rt images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_rocgdb images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Unit Tests / Unit Tests :: ubuntu-24.04 (push) Canceled after 0s
Unit Tests / Unit Tests :: windows-2022 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_media (push) Canceled after 0s
Unit Tests / Unit Tests Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_openmpi (push) Canceled after 0s
78 lines
3.1 KiB
Markdown
78 lines
3.1 KiB
Markdown
# TensileLite Reference
|
|
|
|
Supplementary reference for `AGENTS.md` — load this when you need test commands, custom builds, linting, CMake options, or supported targets.
|
|
|
|
## Running Tests
|
|
|
|
```bash
|
|
# Full test suite (builds client + runs all common tests)
|
|
tox -e py3 -- Tensile/Tests -m common
|
|
|
|
# Python unit tests only (skips the long client build; requires a prior build)
|
|
tox -e unit -- Tensile/Tests/unit
|
|
|
|
# Run a specific test category
|
|
tox -e py3 -- Tensile/Tests -m gemm
|
|
|
|
# Run a single test directly (after a prior `invoke build-client`)
|
|
Tensile/bin/Tensile Tensile/Tests/common/exception/<test>.yaml tensile-out
|
|
```
|
|
|
|
## Custom CMake Build
|
|
|
|
```bash
|
|
cmake --preset tensilelite -S .. -B my-custom-build
|
|
cmake --build my-custom-build --parallel
|
|
|
|
# Run test with custom client path
|
|
./my-custom-build/Tensile.sh Tensile/Tests/common/<test>.yaml tensile-out \
|
|
--prebuilt-client=my-custom-build/tensilelite-client/tensilelite-client
|
|
|
|
# Build with custom args (e.g., Debug + specific GPU)
|
|
TENSILELITE_CLIENT_ARGS="--build-type Debug --gpu-targets gfx90a --clean" tox -e py3 -- Tensile/Tests -m common
|
|
```
|
|
|
|
Iterate on rocisa C++ without re-pip-installing:
|
|
|
|
```bash
|
|
cd rocisa && mkdir build && cd build
|
|
cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_CXX_COMPILER=$ROCM_PATH/bin/amdclang++ ..
|
|
make -j8
|
|
```
|
|
|
|
`invoke build-client` accepts `--clean`, `--build-dir`, `--build-type`, `--gpu-targets`, `--rocm-path`, `--export-compile-commands`, `--bundle-python-deps`, `--enable-rocprof`, `--cxx-flags-release`. See `tasks.py`.
|
|
|
|
## Linting and Formatting
|
|
|
|
```bash
|
|
tox -e lint # flake8 (pyflakes errors only, E/W ignored)
|
|
tox -e format # black (line-length=100) on Common/, TensileCreateLibrary/, Utilities/Decorators/
|
|
tox -e isort # isort (black profile) on same directories
|
|
```
|
|
|
|
## Rebuilding Assembly Without Full Rerun
|
|
|
|
After a Tensile run creates `tensile-out/`, you can edit assembly and rebuild only object code:
|
|
|
|
```bash
|
|
make co TENSILE_OUT=tensile-out # auto-detect arch
|
|
make co TENSILE_OUT=tensile-out ARCH="gfx942" WAVE=64 # gfx9 explicit
|
|
make co TENSILE_OUT=tensile-out ARCH="gfx1100" WAVE=32 # gfx11 explicit
|
|
```
|
|
|
|
## CMake Options
|
|
|
|
| Option | Default | Purpose |
|
|
|--------|---------|---------|
|
|
| `TENSILELITE_ENABLE_HOST` | ON | Build C++ runtime library |
|
|
| `TENSILELITE_ENABLE_CLIENT` | ON | Build benchmark client |
|
|
| `TENSILELITE_ENABLE_AUTOBUILD` | OFF | Auto-rebuild rocisa wrapper scripts |
|
|
| `TENSILELITE_BUILD_TESTING` | OFF | Build C++ host library tests |
|
|
| `GPU_TARGETS` | (detected) | Semicolon-separated list of gfx targets |
|
|
|
|
## Supported Targets
|
|
|
|
GPU architectures (see `Tensile/Common/Architectures.py`): gfx900, gfx906, gfx908, gfx90a, gfx942, gfx950, gfx1010/1011/1012, gfx1030, gfx1100/1101/1102, gfx1200/1201, gfx1250 (each with optional `:xnack+/-`).
|
|
|
|
Test markers for architectures (see `pytest.ini`): `gfx11`, `gfx12`, `gfx94x`, `gfx950`, `gfx1250`, plus per-arch `xfail-gfxNNN` / `skip-gfxNNN`. Data type markers: `Float`, `Double`, `Half`, `BFloat16`, `Int8`, `Float8`/`BFloat8` (OCP and `_fnuz` NANOO variants), mixed `Float8BFloat8`, `Float4`, `Float6`, `BFloat6`.
|