OVERVIEW: A utility that wraps around the SYCL device code linking process.
This enables LLVM IR linking, post-linking and code generation for SPIR-V JIT and AOT targets.
USAGE: clang-sycl-linker [options] <input bitcode files>
OPTIONS:
--arch=<arch> The device architecture
--dry-run Print generated commands without running.
-help-hidden Display all available options
-help Display available options (--help-hidden for more)
-L <dir> Add <dir> to the library search path
-l <libname> Search for library <libname>
--module-split-mode=<mode>
SYCL device code module split mode. Valid values:
- 'translation_unit' (default) emits one device image per translation unit that contains at least one entry point;
- 'kernel' emits one device image per kernel function;
- 'link_unit' emits one device image per linking unit.
--no-whole-archive Disable --whole-archive for the following inputs (default state)
--ocloc-options=<value> Options passed to ocloc for Intel GPU AOT compilation
--opencl-aot-options=<value>
Options passed to opencl-aot for Intel CPU AOT compilation
-o <path> Path to file to write output
--print-linked-module Print the linked module's IR for testing
--save-temps Save intermediate results
--spirv-dump-device-code=<value>
Path to the folder where the tool dumps SPIR-V device code. Other formats aren't dumped.
--triple=<triple> The device target triple
-u <symbol> Force undefined symbol during linking
--version Display the version number and exit
-v Print verbose information
--whole-archive Include all archive members in the link
Options (18)
| Option | Description | Source |
|---|
--arch arch | The device architecture | help |
--dry-run | Print generated commands without running. | help |
-help-hidden | Display all available options | help |
-help | Display available options (--help-hidden for more) | help |
-L dir | Add <dir> to the library search path | help |
-l libname | Search for library <libname> | help |
--module-split-mode mode | SYCL device code module split mode. | help |
--no-whole-archive | Disable --whole-archive for the following inputs (default state) | help |
--opencl-aot-options value | Options passed to opencl-aot for Intel CPU AOT compilation | help |
-o path | Path to file to write output | help |
--print-linked-module | Print the linked module's IR for testing | help |
--save-temps | Save intermediate results | help |
--spirv-dump-device-code value | Path to the folder where the tool dumps SPIR-V device code. | help |
--triple triple | The device target triple | help |
-u symbol | Force undefined symbol during linking | help |
--version | Display the version number and exit | help |
-v | Print verbose information | help |
--whole-archive | Include all archive members in the link | help |
Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.