Skip to content

Commit 942ea93

Browse files
committed
clarify docs
Signed-off-by: Neil R. Spruit <neil.r.spruit@intel.com>
1 parent 8205e5f commit 942ea93

1 file changed

Lines changed: 8 additions & 3 deletions

File tree

test/README.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,16 +22,16 @@ All tests are compiled into a single executable named `tests`, which includes:
2222
- `loader_validation_layer.cpp` - Validation layer tests
2323
- `loader_tracing_layer.cpp` - Tracing layer tests
2424
- `driver_ordering_helper_tests.cpp` - Driver ordering helper functions
25-
- `driver_ordering_unit_tests.cpp` - Driver ordering logic (static builds and non-Windows only)
26-
- `driver_teardown_unit_tests.cpp` - Driver teardown logic (static builds and non-Windows only)
25+
- `driver_ordering_unit_tests.cpp` - Driver ordering logic (static builds on all platforms, or dynamic builds on Linux only)
26+
- `driver_teardown_unit_tests.cpp` - Driver teardown logic (static builds on all platforms, or dynamic builds on Linux only)
2727
- `init_driver_unit_tests.cpp` - Driver initialization tests (non-Windows only)
2828
- `init_driver_dynamic_unit_tests.cpp` - Dynamic driver initialization tests (dynamic builds, non-Windows only)
2929

3030
### Build Configurations
3131

3232
Different test files are conditionally compiled based on the build configuration:
3333

34-
**Static Build Only (`BUILD_STATIC` or non-Windows):**
34+
**Static Builds (All Platforms) OR Dynamic Builds (Linux Only):**
3535
- `driver_ordering_unit_tests.cpp`
3636
- `driver_teardown_unit_tests.cpp`
3737

@@ -59,6 +59,11 @@ CTest automatically sets up the required environment variables, working director
5959

6060
**Before running CTest, you must set the `ZEL_LIBRARY_PATH` environment variable** to point to where the loader libraries and null drivers are located. This ensures tests can find the required libraries at runtime.
6161

62+
**Why `ZEL_LIBRARY_PATH`?**
63+
- **Targeted scope**: Only affects the Level Zero loader's library search path, not the entire system
64+
- **Cross-platform**: Works consistently across Linux, Windows, and macOS
65+
- **Preferred over `LD_LIBRARY_PATH`** (Linux) or `PATH` (Windows) which have broader system-wide effects
66+
6267
**Linux/Mac:**
6368
```bash
6469
export ZEL_LIBRARY_PATH=/path/to/build/lib

0 commit comments

Comments
 (0)