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
[SYCL] Add internal debugging environment variables to append to compile/link options (#11981)
Add two new environment variables to append to compile or link options.
This is only intended for SYCL developers, and end users should use the
'-X' family of dpcpp options.
We are adding this because we have had some people hit unexpected issues
because if `SYCL_PROGRAM_COMPILE_OPTIONS` is set, any options that would
normally be added internally by the runtime and invisibly to the user
(`ze-opt-disable`, `ze-opt-level`, etc) are not added, so someone doing
A/B testing would not be comparing apples to apples with the envvar set
vs not set.
---------
Signed-off-by: Sarnie, Nick <nick.sarnie@intel.com>
Copy file name to clipboardExpand all lines: sycl/doc/EnvironmentVariables.md
+4-2Lines changed: 4 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -227,8 +227,10 @@ variables in production code.</span>
227
227
|`SYCL_DISABLE_EXECUTION_GRAPH_CLEANUP`| Any(\*) | Disable regular cleanup of enqueued (or finished, in case of host tasks) non-leaf command nodes. If disabled, command nodes will be cleaned up only during the destruction of the last remaining memory object used by them. |
228
228
|`SYCL_DISABLE_POST_ENQUEUE_CLEANUP` (deprecated) | Any(\*) | Use `SYCL_DISABLE_EXECUTION_GRAPH_CLEANUP` instead. |
229
229
|`SYCL_DEVICELIB_INHIBIT_NATIVE`| String of device library extensions (separated by a whitespace) | Do not rely on device native support for devicelib extensions listed in this option. |
230
-
|`SYCL_PROGRAM_COMPILE_OPTIONS`| String of valid OpenCL compile options | Override compile options for all programs. |
231
-
|`SYCL_PROGRAM_LINK_OPTIONS`| String of valid OpenCL link options | Override link options for all programs. |
230
+
|`SYCL_PROGRAM_COMPILE_OPTIONS`| String of valid compile options | Override compile options for all programs. |
231
+
|`SYCL_PROGRAM_LINK_OPTIONS`| String of valid link options | Override link options for all programs. |
232
+
|`SYCL_PROGRAM_APPEND_COMPILE_OPTIONS`| String of valid compile options | Append to the end of compile options for all programs. |
233
+
|`SYCL_PROGRAM_APPEND_LINK_OPTIONS`| String of valid link options | Append to the end of link options for all programs. |
232
234
|`SYCL_USE_KERNEL_SPV`| Path to the SPIR-V binary | Load device image from the specified file. If runtime is unable to read the file, `sycl::runtime_error` exception is thrown. The image is assumed to have been created using the `-fno-sycl-dead-args-optimization` option. |
233
235
|`SYCL_DUMP_IMAGES`| Any(\*) | Dump device image binaries to file. Control has no effect if `SYCL_USE_KERNEL_SPV` is set. |
234
236
|`SYCL_HOST_UNIFIED_MEMORY`| Integer | Enforce host unified memory support or lack of it for the execution graph builder. If set to 0, it is enforced as not supported by all devices. If set to 1, it is enforced as supported by all devices. |
0 commit comments