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
--------------------------------------------------------------
1. Remove notes
2. Specify which malloc api accept the property
3. Add more detaile ddescription, and expected behavior when used on non fpga device
Copy file name to clipboardExpand all lines: sycl/doc/extensions/experimental/sycl_ext_intel_runtime_buffer_location.asciidoc
+10-13Lines changed: 10 additions & 13 deletions
Original file line number
Diff line number
Diff line change
@@ -45,21 +45,13 @@ change incompatibly in future versions of {dpcpp} without prior notice.
45
45
*Shipping software products should not rely on APIs defined in this
46
46
specification.*
47
47
48
-
[NOTE]
49
-
====
50
-
This extension is currently implemented in {dpcpp} only for FPGA devices. Attempting to use this extension on other devices or backends may result in no effect.
51
-
52
-
This serves as a temporary workaround for usm allocation to accept buffer location properties, and the formal solution will come in the future.
53
-
====
54
48
55
49
== Overview
56
50
57
51
This document propose a new buffer_location runtime property that can be passed to `malloc_device`.
58
52
59
53
On targets that provide more than one type of global memory, this provide users the flexibility of choosing which memory the device usm should be allocated to.
60
54
61
-
This information is not a hint; it is a functional requirement of the program that must be respected.
To pass the runtime properties into malloc API, a new buffer properties is introduced.
94
+
This extension adds the new property `sycl::ext::intel::experimental::property::usm::buffer_location`` which applications can pass in the property_list parameter to all overloads of the `sycl::malloc_device()`, `sycl::malloc_shared()`, `sycl::malloc_host()` function. However, this property has no effect when passed to `sycl::malloc_shared()`, `sycl::malloc_host()`. Following is a synopsis of this property.
On targets that provide more than one type of global memory, `buffer_location` allows user to specify which of the global memory to allocate memory to. This provide user the flexibility to choose the global memory that satisfy requirements for bandwodth and throughput.
110
+
111
+
This property is ignored for non-FPGA devices. Attempting to use this extension on other devices or backends will result in no effect.
0 commit comments