Skip to content

[SYCL][Doc][E2E] Align intel device query spec with backend queries #21378

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
sergey-semenov merged 1 commit into from
Mar 2, 2026
Merged

[SYCL][Doc][E2E] Align intel device query spec with backend queries #21378

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
34 changes: 19 additions & 15 deletions sycl/doc/extensions/supported/sycl_ext_intel_device_info.asciidoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -242,7 +242,8 @@ if (dev.has(aspect::ext_intel_gpu_eu_count)) {
=== Intel GPU Number of Slices

This extension adds the following device aspect and information descriptor,
which allow an application to query the number of slices on an Intel GPU.
which allow an application to query the maximum number of slices on an Intel
GPU.

==== New device aspect

Expand Down Expand Up @@ -274,8 +275,8 @@ struct gpu_slices {

_Remarks:_ Template parameter to `device::get_info`.

_Returns:_ The number of slices. If the device is a subdevice, then the number
of slices in the subdevice is returned.
_Returns:_ The maximum number of slices. If the device is a subdevice, then the
maximum number of slices in the subdevice is returned.

_Throws:_ An `exception` with the `errc::feature_not_supported` error code if
the device does not have `aspect::ext_intel_gpu_slices`.
Expand All @@ -294,8 +295,8 @@ if (dev.has(aspect::ext_intel_gpu_slices)) {
=== Intel GPU Number of Subslices per Slice

This extension adds the following device aspect and information descriptor,
which allow an application to query the number of subslices per slice on an
Intel GPU.
which allow an application to query the maximum number of subslices per slice
on an Intel GPU.

==== New device aspect

Expand Down Expand Up @@ -327,8 +328,9 @@ struct gpu_subslices_per_slice {

_Remarks:_ Template parameter to `device::get_info`.

_Returns:_ The number of subslices per slice. If the device is a subdevice,
then the number of subslices per slice in the subdevice is returned.
_Returns:_ The maximum number of subslices per slice. If the device is a
subdevice, then the maximum number of subslices per slice in the subdevice is
returned.

_Throws:_ An `exception` with the `errc::feature_not_supported` error code if
the device does not have `aspect::ext_intel_gpu_subslices_per_slice`.
Expand All @@ -347,8 +349,8 @@ if (dev.has(aspect::ext_intel_gpu_subslices_per_slice)) {
=== Intel GPU Number of Execution Units (EUs) per Subslice

This extension adds the following device aspect and information descriptor,
which allow an application to query the number of EUs per subslice on an Intel
GPU.
which allow an application to query the maximum number of EUs per subslice on
an Intel GPU.

==== New device aspect

Expand Down Expand Up @@ -380,8 +382,9 @@ struct gpu_eu_count_per_subslice {

_Remarks:_ Template parameter to `device::get_info`.

_Returns:_ The number of EUs in a subslice. If the device is a subdevice, then
the number of EUs per subslice in the subdevice is returned.
_Returns:_ The maximum number of EUs in a subslice. If the device is a
subdevice, then the maximum number of EUs per subslice in the subdevice is
returned.

_Throws:_ An `exception` with the `errc::feature_not_supported` error code if
the device does not have `aspect::ext_intel_gpu_eu_count_per_subslice`.
Expand Down Expand Up @@ -509,8 +512,8 @@ if (dev.has(aspect::ext_intel_device_info_uuid)) {
Missing before version 3 of this extension.

This extension adds the following device aspect and information descriptor,
which allow an application to query the number of hardware threads per EU on an
Intel GPU.
which allow an application to query the maximum number of hardware threads per
EU on an Intel GPU.

==== New device aspect

Expand Down Expand Up @@ -542,8 +545,9 @@ struct gpu_hw_threads_per_eu {

_Remarks:_ Template parameter to `device::get_info`.

_Returns:_ The number of hardware threads in EU. If the device is a subdevice,
then the number of hardware threads per EU in the subdevice is returned.
_Returns:_ The maximum number of hardware threads in EU. If the device is a
subdevice, then the maximum number of hardware threads per EU in the subdevice
is returned.

_Throws:_ An `exception` with the `errc::feature_not_supported` error code if
the device does not have `aspect::ext_intel_gpu_hw_threads_per_eu`.
Expand Down
6 changes: 0 additions & 6 deletions sycl/test-e2e/Basic/intel-ext-device.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -96,12 +96,6 @@ int main(int argc, char **argv) {
long m = dev.get_info<ext::intel::info::device::max_mem_bandwidth>();
std::cout << "Maximum memory bandwidth = " << m << std::endl;
}
// This is the only data we can verify.
if (totalEUs != numSlices * numSubslices * numEUsPerSubslice) {
std::cout << "Error: EU Count is incorrect!" << std::endl;
std::cout << "Failed!" << std::endl;
return 1;
}
if (dev.has(aspect::ext_intel_free_memory)) {
auto TotalMemory = dev.get_info<info::device::global_mem_size>();
auto FreeMemory =
Expand Down
6 changes: 0 additions & 6 deletions sycl/test-e2e/DeprecatedFeatures/deprecated_intel_ext_device.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -95,12 +95,6 @@ int main(int argc, char **argv) {
long m = dev.get_info<info::device::ext_intel_max_mem_bandwidth>();
std::cout << "Maximum memory bandwidth = " << m << std::endl;
}
// This is the only data we can verify.
if (totalEUs != numSlices * numSubslices * numEUsPerSubslice) {
std::cout << "Error: EU Count is incorrect!" << std::endl;
std::cout << "Failed!" << std::endl;
return 1;
}
} // SYCL_EXT_INTEL_DEVICE_INFO
std::cout << std::endl;
}
Expand Down
Loading