Skip to content

[SYCL][Doc] Update restrictions in extension #10281

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.

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 2 commits into from
Jul 10, 2023
Merged
Changes from all commits
Commits
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
Original file line number Diff line number Diff line change
Expand Up @@ -51,10 +51,10 @@ change incompatibly in future versions of {dpcpp} without prior notice.
specification.*

There are important limitations with the {dpcpp} implementation of this
experimental extension. In particular, this extension may only be used when
the application is compiled in AOT mode. See the section below titled
"Limitations with the experimental version" for a full description of the
limitations.
experimental extension. In particular, some parts of this extension may only
be used when the application is compiled in AOT mode. See the section below
titled "Limitations with the experimental version" for a full description of
the limitations.


== Overview
Expand Down Expand Up @@ -578,12 +578,18 @@ case syclex::architecture::intel_gpu_bdw:
== Limitations with the experimental version

The {dpcpp} implementation of this extension currently has some important
limitations. The application must be compiled in ahead-of-time (AOT) mode
using `-fsycl-targets=<special-target>` where `<special-target>` is one of the
limitations with the `if_architecture_is` free function. In order to use this
feature, the application must be compiled in ahead-of-time (AOT) mode using
`-fsycl-targets=<special-target>` where `<special-target>` is one of the
"special target values" listed in the link:../../UsersManual.md[users manual]
description of the `-fsycl-targets` option. These are the target names of the
form "intel_gpu_*", "nvidia_gpu_*", or "amd_gpu_*".

The two APIs `device::ext_oneapi_architecture_is` and the
`ext::oneapi::experimental::info::device::architecture` device descriptor are
currently supported only for Intel devices (both GPU and CPU). There is no
support yet for Nvidia or AMD devices.


== Future direction

Expand Down