Skip to content

[SYCL][Doc] Update SYCL_UR_USE_LEVEL_ZERO_V2 description #19457

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Aug 25, 2025
Merged

[SYCL][Doc] Update SYCL_UR_USE_LEVEL_ZERO_V2 description #19457

Changes from 3 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
1067d31
[SYCL][Doc] Update SYCL_UR_USE_LEVEL_ZERO_V2 description
igchor Jul 15, 2025
cfcc43a
Update sycl/doc/EnvironmentVariables.md
igchor Jul 16, 2025
1420ebf
Add note about debug env variables
igchor Jul 30, 2025
481afd7
add extra column and describe UR_L0_V2_FORCE_DISABLE_COPY_OFFLOAD
igchor Aug 21, 2025
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
8 changes: 6 additions & 2 deletions sycl/doc/EnvironmentVariables.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -159,7 +159,7 @@ For a description of parallel for range rounding in DPC++ see
| `SYCL_ENABLE_PCI` (Deprecated) | Integer | When set to 1, enables obtaining the GPU PCI address when using the Level Zero backend. The default is 1. This option is kept for compatibility reasons and is immediately deprecated. |
| `SYCL_PI_LEVEL_ZERO_DISABLE_USM_ALLOCATOR` | Any(\*) | Disable USM allocator in Level Zero adapter (each memory request will go directly to Level Zero runtime) |
| `SYCL_PI_LEVEL_ZERO_TRACK_INDIRECT_ACCESS_MEMORY` | Any(\*) | Enable support of the kernels with indirect access and corresponding deferred release of memory allocations in the Level Zero adapter. |
| `SYCL_UR_USE_LEVEL_ZERO_V2` | Integer | Enable ('1') or disable ('0') the use of a preview version of the Level Zero adapter, which features a redesigned architecture aimed at optimizing performance for different queue modes (immediate/batched, in-order/out-of-order). This version is expected to reduce runtime overhead and currently only support immediate, in-order mode. If you experience any performance or functional issues with this adapter enabled, please report them on GitHub, specifying the adapter used. |
| `SYCL_UR_USE_LEVEL_ZERO_V2` | Integer | Enable ('1') or disable ('0') the use of the Level Zero V2 adapter, which features a redesigned architecture aimed at optimizing performance for different queue modes (immediate/batched, in-order/out-of-order). This version is expected to reduce runtime overhead and currently only support immediate command lists. By default, this adapter is used on platforms with GPUs based on the Xe2 architecture or later, such as Battlemage, Lunar Lake, and Arrow Lake. If you experience any performance or functional issues with this adapter enabled, please report them on GitHub, specifying the adapter used. |

`(*) Note: Any means this environment variable is effective when set to any non-null value.`

Expand Down Expand Up @@ -261,7 +261,11 @@ The default value is 0 and no tracing is enabled.
:warning: **Warning:** <span style="color:red">the environment variables
described below are used for development and debugging of DPC++ compiler
and runtime. Their semantics are subject to change. Do not rely on these
variables in production code.</span>
variables in production code. Most of these variables are only supported
by the legacy L0 adapter (when running on platforms with GPUs based on
architectures older than Xe2, such as PVC or DG2 or when
SYCL_UR_USE_LEVEL_ZERO_V2=0 is set). The only exception is
SYCL_PI_LEVEL_ZERO_USM_ALLOCATOR which is supported by both adapters.</span>

| Environment variable | Values | Description |
| -------------------- | ------ | ----------- |
Expand Down