Skip to content

Commit ab4d276

Browse files
committed
Changed documentation
Signed-off-by: Rauf, Rana <[email protected]>
1 parent 8b8eb77 commit ab4d276

File tree

2 files changed

+27
-4
lines changed

2 files changed

+27
-4
lines changed

sycl/doc/extensions/experimental/sycl_ext_oneapi_max_work_group_query.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -68,13 +68,20 @@ assert(global_size[2] * global_size[1] * global_size[0] <= global_groups); //Mak
6868
6969
gpu_queue.submit(work_range, ...);
7070
```
71+
## Deprecated queries
7172

72-
## Implementation
73+
The table below lists the soon to be removed deprecated descriptors and their replacements:
74+
75+
|Deprecated Descriptors| Replacement Decriptors|
76+
| -------------------- | -------------------- |
77+
| sycl::info::ext_oneapi_max_global_work_groups |sycl::ext::oneapi::experimental::info::max_global_work_groups |
78+
| sycl::info::ext_oneapi_max_work_groups_*N*d | sycl::ext::oneapi::experimental::info::max_work_groups\<*N*\> |
79+
80+
* Note *N* can take the value 1,2, or 3
7381

74-
### Deprecated queries
7582

76-
Older versions of DPC++ used information descriptors with the inncorrect namespace; according to SYCL 2020 specification section 6.3.1 "Extension namespace" , `sycl::info::ext_oneapi_max_global_work_groups` is not allowed.
77-
Some of those descriptors were also not templated, according to SYCL specification section 4.6.4.2 "Device information descriptors", e.g: `ext_oneapi_max_work_groups_[1,2,3]d` . These information descriptors are still supported but deprecated.
83+
## Implementation
84+
7885
### Consistency with existing checks
7986

8087
The implementation already checks when enqueuing a kernel that the global and per dimension work-group number is smaller than `std::numeric_limits<int>::max`. This check is implemented in `sycl/include/sycl/handler.hpp`. For consistency, values returned by the two device descriptors are bound by this limit.

sycl/doc/extensions/supported/sycl_ext_intel_device_info.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -386,3 +386,19 @@ Then the free device memory can be obtained using the standard get\_info() inte
386386
if (dev.has(aspect::ext_intel_free_memory)) {
387387
auto FreeMemory = dev.get_info<info::device::ext_intel_free_memory>();
388388
}
389+
390+
# Deprecated queries #
391+
392+
The table below lists deprecated, that would soon be removed and their replacements:
393+
394+
|Deprecated Descriptors | Replacement Descriptors |
395+
| ------------------------------- |--------------------------- |
396+
| info\:\:device\:\:ext\_intel\_device\_info\_uuid | ext\:\:intel\:\:info\:\:device\:\:uuid |
397+
| info\:\:device\:\:ext\_intel\_pci\_address | ext\:\:intel\:\:info\:\:device\:\:pci\_address |
398+
| info\:\:device\:\:ext\_intel\_gpu\_eu\_simd\_width | ext\:\:intel\:\:info\:\:device\:\:gpu\_eu\_simd\_width |
399+
| info\:\:device\:\:ext\_intel\_gpu\__eu\_count | ext\:\:intel\:\:info\:\:device\:\:gpu\__eu\_count |
400+
| info\:\:device\:\:ext\_intel\_gpu\_slices | ext\:\:intel\:\:info\:\:device\:\:gpu\_slices |
401+
| info\:\:device\:\:ext\_intel\_gpu\_subslices\_per\_slice | ext\:\:intel\:\:info\:\:device\:\:gpu\_subslices\_per\_slice |
402+
|info\:\:device\:\:ext\_intel\_gpu\_eu\_count\_per\_subslice | ext\:\:intel\:\:info\:\:device\:\:gpu\_eu\_count\_per\_subslice |
403+
| info\:\:device\:\:ext\_intel\_gpu\_hw\_threads\_per\_eu | ext\:\:intel\:\:info\:\:device\:\:gpu\_hw\_threads\_per\_eu |
404+
| info\:\:device\:\:ext\_intel\_max\_mem\_bandwidth | ext\:\:intel\:\:info\:\:device\:\:max\_mem\_bandwidth |

0 commit comments

Comments
 (0)