[SYCL][Driver] Validate the Intel GPU names of '--offload-arch' by KornevNikita · Pull Request #23060 · intel/llvm

KornevNikita · 2026-08-31T18:18:08Z

Record the IGCA level of every device in IntelGPUArch.def, so that the
table lists both names a device answers to, and add the names that cover
more than one release (xe-dg2, xe-mtl, xe-bmg, xe-ptl) with a sentinel
GMDID of zero. Move the table to clang/include/clang/Basic/ so that the
driver and the offload-arch tool can share it.

The driver now accepts, and validates against that table, the three
forms of a name the GPU driver uses: the name of an architecture
('xe-lnl-m'), the IGCA level shared by a group of architectures
('igca_40r'), and the numeric form the offload-arch tool prints for an
architecture this build has no name for ('xe_20.4.5'). Of the numeric
form only the architecture and the release are validated, as every
stepping of an architecture shares one name. Anything else is rejected
with the existing 'unsupported offload gpu architecture' diagnostic.

Co-Authored-By: Claude Opus 5 noreply@anthropic.com

…ames The output of this utility is expected to be a list of names that are legal --offload-arch parameters, but for Intel GPUs it printed the name of the device, e.g. "Intel(R) Data Center GPU Max 1100", which is not one. Query the GMDID of each device with zeDeviceGetProperties and the device IP version extension, and translate its architecture and release components into an architecture name using the table in IntelGPUArch.def, which is meant to be generated from the data published by the GPU driver. A device that has no entry in the table is named after all three components of its GMDID, e.g. xe_40.11.0, so that a GPU newer than the compiler is still usable. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> (cherry picked from commit a7e6682f197f7603915e5de75bc17683f8be6455)

Record the IGCA level of every device in IntelGPUArch.def, so that the table lists both names a device answers to, and add the names that cover more than one release (xe-dg2, xe-mtl, xe-bmg, xe-ptl) with a sentinel GMDID of zero. Move the table to clang/include/clang/Basic/ so that the driver and the offload-arch tool can share it. The driver now accepts, and validates against that table, the three forms of a name the GPU driver uses: the name of an architecture ('xe-lnl-m'), the IGCA level shared by a group of architectures ('igca_40r'), and the numeric form the offload-arch tool prints for an architecture this build has no name for ('xe_20.4.5'). Of the numeric form only the architecture and the release are validated, as every stepping of an architecture shares one name. Anything else is rejected with the existing 'unsupported offload gpu architecture' diagnostic. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

# Conflicts: # clang/tools/offload-arch/LevelZeroArch.cpp # clang/unittests/offload-arch/OffloadArchTest.cpp

tahonermann

This looks pretty good. I added some comments regarding asserts and diagnostics.

tahonermann · 2026-09-01T21:38:26Z

+  // Only valid when isIntelCPU(), or when isIntelGPU() and !isIntelXeGPU().
  IntelArch intelKind() const { return static_cast<IntelArch>(Kind); }
+  // Only valid when isIntelXeGPU(); opaque outside of OffloadArch.cpp.
+  uint32_t intelXeKind() const { return Kind; }


Any reason not to assert the preconditions?

Suggested change

// Only valid when isIntelCPU(), or when isIntelGPU() and !isIntelXeGPU().

IntelArch intelKind() const { return static_cast<IntelArch>(Kind); }

// Only valid when isIntelXeGPU(); opaque outside of OffloadArch.cpp.

uint32_t intelXeKind() const { return Kind; }

// Only valid when isIntelCPU(), or when isIntelGPU() and !isIntelXeGPU().

IntelArch intelKind() const {

assert(isIntelCPU() || (isIntelGPU() && !isIntelXeGPU()), "Intel CPU or non-Xe GPU required");

return static_cast<IntelArch>(Kind);

}

// Only valid when isIntelXeGPU(); opaque outside of OffloadArch.cpp.

uint32_t intelXeKind() const {

assert(isIntelXeGPU(), "Intel Xe GPU required");

return Kind;

}

Added asserts d992cfc

tahonermann · 2026-09-01T21:41:21Z

+  static constexpr OffloadArch getIntelXeGPU(uint32_t Kind) {
+    return {TargetArch::IntelXeGPU, Kind};
+  }


Can it be asserted that Kind matches a Xe GPU?

Updated the function - d992cfc

tahonermann

Thanks @KornevNikita, looks good to me. I added one comment regarding a possible group architecture addition, but I understand if such decisions aren't ours to make.

tahonermann · 2026-09-03T20:59:58Z

+INTEL_GPU_ARCH(35, 10, "xe-nvl-p", "igca_60r")
+INTEL_GPU_ARCH(30, 5, "xe-nvl-u", "igca_60r")
+INTEL_GPU_ARCH(30, 5, "xe-nvl-h", "igca_60r")
+INTEL_GPU_ARCH(30, 4, "xe-nvl-s", "igca_60r")
+INTEL_GPU_ARCH(30, 4, "xe-nvl-hx", "igca_60r")
+INTEL_GPU_ARCH(30, 4, "xe-nvl-ul", "igca_60r")


These all have a consistent name prefix and map to the same IGCA level. Should there not be a "xe-nvl" group name for these?

IIUC not all nvc-* devices share the same device code, e.g. xe-nvl-p is different from the rest of xe-nvl-*.

Actually xe-ptl covers all xe-nvl-u*, xe-nvl-h*, xe-nvl-s, xe-wcl and xe-ptl-* targets (but not xe-nvl-p), see https://github.com/intel/llvm/blob/sycl/sycl/doc/UsersManual.md.

And there are also other group names like xe-dg2 etc.

KornevNikita · 2026-09-04T11:08:02Z

@srividya-sundaram could you please take a look?

tahonermann · 2026-09-04T23:29:29Z

@KornevNikita, what is the plan for pushing these changes to upstream. We'll need them there to work on the frontend portions of the IGCA support.

KornevNikita and others added 5 commits August 28, 2026 14:45

format

cd8e2fa

apply-review

da2643b

Merge branch 'refs/heads/sycl' into offload-arch-validate

8f66147

# Conflicts: # clang/tools/offload-arch/LevelZeroArch.cpp # clang/unittests/offload-arch/OffloadArchTest.cpp

tahonermann reviewed Sep 1, 2026

View reviewed changes

KornevNikita added 2 commits September 3, 2026 14:50

apply-review

d992cfc

restore

b8a37ce

KornevNikita marked this pull request as ready for review September 3, 2026 13:49

KornevNikita requested review from a team as code owners September 3, 2026 13:49

KornevNikita mentioned this pull request Sep 3, 2026

[SYCL][Driver] Restrict '--offload-arch=native' to Intel GPUs #23095

Draft

tahonermann approved these changes Sep 3, 2026

View reviewed changes

Navigation Menu

Uh oh!

[SYCL][Driver] Validate the Intel GPU names of '--offload-arch' - #23060

[SYCL][Driver] Validate the Intel GPU names of '--offload-arch'#23060
KornevNikita wants to merge 7 commits into
intel:syclfrom
KornevNikita:offload-arch-validate

KornevNikita commented Aug 31, 2026

Uh oh!

tahonermann left a comment

Uh oh!

tahonermann Sep 1, 2026

Uh oh!

KornevNikita Sep 3, 2026

Uh oh!

tahonermann Sep 1, 2026

Uh oh!

KornevNikita Sep 3, 2026

Uh oh!

Uh oh!

tahonermann left a comment

Uh oh!

tahonermann Sep 3, 2026

Uh oh!

KornevNikita Sep 4, 2026

Uh oh!

KornevNikita commented Sep 4, 2026

Uh oh!

tahonermann commented Sep 4, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

KornevNikita commented Aug 31, 2026

Uh oh!

tahonermann left a comment

Choose a reason for hiding this comment

Uh oh!

tahonermann Sep 1, 2026

Choose a reason for hiding this comment

Uh oh!

KornevNikita Sep 3, 2026

Choose a reason for hiding this comment

Uh oh!

tahonermann Sep 1, 2026

Choose a reason for hiding this comment

Uh oh!

KornevNikita Sep 3, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

tahonermann left a comment

Choose a reason for hiding this comment

Uh oh!

tahonermann Sep 3, 2026

Choose a reason for hiding this comment

Uh oh!

KornevNikita Sep 4, 2026

Choose a reason for hiding this comment

Uh oh!

KornevNikita commented Sep 4, 2026

Uh oh!

tahonermann commented Sep 4, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants