Skip to content

[SYCL][Docs] Clarify virtual memory accessibility #20576

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 3 commits into from
Nov 10, 2025
Merged

[SYCL][Docs] Clarify virtual memory accessibility #20576

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
86bd8a5
[SYCL][Docs] Clarify virtual memory accessibility
steffenlarsen Nov 6, 2025
c73a5f8
Change wording to reference peer access extension
steffenlarsen Nov 10, 2025
819b1b1
Fix links
steffenlarsen Nov 10, 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
7 changes: 5 additions & 2 deletions sycl/doc/extensions/experimental/sycl_ext_oneapi_virtual_mem.asciidoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -296,7 +296,9 @@ for the device associated with this instance of `physical_mem`.
If `mode` is `address_access_mode::read` or `address_access_mode::read_write`
the returned pointer is accessible after the call as read-only or read-write
respectively. Otherwise, it is considered inaccessible and accessing it will
result in undefined behavior.
result in undefined behavior. The accessibility applies to all devices in
the context associated with this instance of `physical_mem` from which the
physical memory is reachable.

The returned pointer is equivalent to `reinterpret_cast<void *>(ptr)`.

Expand Down Expand Up @@ -351,7 +353,8 @@ Changes the access mode of a mapped virtual memory range specified by `ptr` and
If `mode` is `address_access_mode::read` or `address_access_mode::read_write`
`ptr` pointer is accessible after the call as read-only or read-write
respectively. Otherwise, it is considered inaccessible and accessing it will
result in undefined behavior.
result in undefined behavior. The accessibility applies to all devices in
`syclContext` from which the memory referenced by `ptr` is reachable.

The virtual memory range specified by `ptr` and `numBytes` must be a sub-range
of virtual memory ranges previously mapped to `physical_mem`. `ptr`
Expand Down