OVERVIEW:
A wrapper utility over the host linker. It scans the input files
for sections that require additional processing prior to linking.
The will then transparently pass all arguments and input to the
specified host linker to create the final binary.
USAGE: clang-linker-wrapper [options] -- <options to passed to the linker>
OPTIONS:
--bitcode-library=<kind>-<triple>-<arch>=<path>
Extra bitcode library to link
--builtin-bitcode=<triple>=<path>
Perform a special internalizing link on the bitcode file. This is necessary for some vendor libraries to be linked correctly
--clang-backend Run the backend using clang rather than the LTO backend
--compression-level=<value>
Specify the compression level (integer)
--compress Compress bundled files
--cuda-path=<dir> Set the system CUDA path
--device-debug Use debugging
--device-linker=<value> or <triple>=<value>
Arguments to pass to the device linker invocation
--dry-run Print program arguments without running
--embed-bitcode Embed linked bitcode in the module
--help-hidden Display all available options
--help Display available options (--help-hidden for more)
--host-triple=<triple> Triple to use for the host compilation
--linker-path=<path> The linker executable to invoke
-L <dir> Add <dir> to the library search path
-l <libname> Search for library <libname>
-mllvm <arg> Arguments passed to LLVM, including Clang invocations, for which the '-mllvm' prefix is preserved. Use '-mllvm --help' for a list of options.
--opt-level=<O0, O1, O2, or O3>
Optimization level for LTO
--override-image=<kind=file>
Uses the provided file as if it were the output of the device link step
-o <path> Path to file to write output
--pass-remarks-analysis=<value>
Pass remarks for LTO
--pass-remarks-missed=<value>
Pass remarks for LTO
--pass-remarks=<value> Pass remarks for LTO
--print-wrapped-module Print the wrapped module's IR for testing
--ptxas-arg=<value> Argument to pass to the 'ptxas' invocation
--relocatable Link device code to create a relocatable offloading application
--save-temps Save intermediate results
--sysroot=<value> Set the system root
--v Display the version number and exit
--wrapper-jobs=<number> Sets the number of parallel jobs to use for device linking
--wrapper-time-trace-granularity=<number>
Set the granularity of time-trace updates
--wrapper-time-trace=<file>
Enable time-trace and write the output to <file>
--wrapper-verbose Verbose output from tools
Options (31)
| Option | Description | Source |
|---|---|---|
--bitcode-library kind>-<triple>-<arch>=<path | Extra bitcode library to link | help |
--builtin-bitcode triple>=<path | Perform a special internalizing link on the bitcode file. | help |
--clang-backend | Run the backend using clang rather than the LTO backend | help |
--compression-level value | Specify the compression level (integer) | help |
--compress | Compress bundled files | help |
--cuda-path dir | Set the system CUDA path | help |
--device-debug | Use debugging | help |
--dry-run | Print program arguments without running | help |
--embed-bitcode | Embed linked bitcode in the module | help |
--help-hidden | Display all available options | help |
--help | Display available options (--help-hidden for more) | help |
--host-triple triple | Triple to use for the host compilation | help |
--linker-path path | The linker executable to invoke | help |
-L dir | Add <dir> to the library search path | help |
-l libname | Search for library <libname> | help |
-mllvm arg | Arguments passed to LLVM, including Clang invocations, for which the '-mllvm' prefix is preserved. | help |
--opt-level O0 | Optimization level for LTO | help |
--override-image kind=file | Uses the provided file as if it were the output of the device link step | help |
-o path | Path to file to write output | help |
--pass-remarks-analysis value | Pass remarks for LTO | help |
--pass-remarks-missed value | Pass remarks for LTO | help |
--pass-remarks value | Pass remarks for LTO | help |
--print-wrapped-module | Print the wrapped module's IR for testing | help |
--ptxas-arg value | Argument to pass to the 'ptxas' invocation | help |
--relocatable | Link device code to create a relocatable offloading application | help |
--save-temps | Save intermediate results | help |
--sysroot value | Set the system root | help |
--v | Display the version number and exit | help |
--wrapper-time-trace-granularity number | Set the granularity of time-trace updates | help |
--wrapper-time-trace file | Enable time-trace and write the output to <file> | help |
--wrapper-verbose | Verbose output from tools | help |