You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: sycl/doc/extensions/accessor_properties/SYCL_ONEAPI_accessor_properties.asciidoc
+9-7Lines changed: 9 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,10 +11,11 @@ Joe Garvey, Intel +
11
11
Roland Schulz, Intel +
12
12
Ilya Burylov, Intel +
13
13
Michael Kinsner, Intel +
14
-
John Pennycook, Intel
14
+
John Pennycook, Intel +
15
+
Jessica Davies, Intel
15
16
16
17
== Notice
17
-
Copyright (c) 2019-2020 Intel Corporation. All rights reserved.
18
+
Copyright (c) 2019-2021 Intel Corporation. All rights reserved.
18
19
19
20
== Status
20
21
@@ -23,7 +24,7 @@ Working Draft - *DO NOT SHIP*
23
24
== Version
24
25
25
26
Built On: {docdate} +
26
-
Revision: 1
27
+
Revision: 3
27
28
28
29
== Dependencies
29
30
@@ -51,7 +52,7 @@ Adding a new compile-time-constant property consists of adding a class for it, e
51
52
52
53
This extension introduces two compile-time-constant properties: no_offset and no_alias.
53
54
no_offset indicates that the corresponding accessor will never contain an offset.
54
-
no_alias indicates that the corresponding accessorwill not alias with any other accessor or USM pointer used in the kernel.
55
+
no_alias indicates that all modifications to the memory locations accessed (directly or indirectly) by this accessor, that occur during kernel execution, will be done through this accessor (directly or indirectly) and no other accessor or USM pointer in the kernel.
55
56
56
57
=== Examples
57
58
Due to type deduction, users should rarely need to specify the template parameters of accessor_property_list or accessor directly.
@@ -474,7 +475,7 @@ Rewrite Table 4.50: Properties supported by the SYCL accessor class as follows,
474
475
| Property | Description | Compile-time Constant
475
476
| sycl::property::noinit | The noinit property notifies the SYCL runtime that previous contents of a buffer can be discarded. Replaces deprecated discard_write and discard_read_write access modes. | No
476
477
| ONEAPI::property::no_offset | The no_offset property notifies the SYCL device compiler that the accessor will never contain an offset. This may enable the compiler to make assumptions about the alignment of the accessor that it couldn't make otherwise. | Yes
477
-
| ONEAPI::property::no_alias | The no_alias property notifies the SYCL device compiler that the accessorwill not alias with any other accessors or USM pointers accessed in the same kernel. This is an unchecked assertion by the programmer and results in undefined behaviour if it is violated. | Yes
478
+
| ONEAPI::property::no_alias | The no_alias property notifies the SYCL device compiler that all modifications to the memory locations accessed (directly or indirectly) by this accessor, that occur during kernel execution, will be done through this accessor (directly or indirectly) and no other accessor or USM pointer in the kernel. This is an unchecked assertion by the programmer and results in undefined behaviour if it is violated. | Yes
478
479
|====
479
480
--
480
481
@@ -487,6 +488,7 @@ NOTE: The constructors for no_offset and no_alias are unspecified as users must
487
488
[options="header"]
488
489
|========================================
489
490
|Rev|Date|Author|Changes
490
-
|A|2020-06-18|Joe Garvey|Initial public draft
491
-
|B|2020-09-08|Joe Garvey|Rewrote as a vendor extension in the ONEAPI namespace.
491
+
|1|2020-06-18|Joe Garvey|Initial public draft
492
+
|2|2020-09-08|Joe Garvey|Rewrote as a vendor extension in the ONEAPI namespace.
493
+
|3|2021-01-28|Jessica Davies|Modify semantics of no_alias
0 commit comments