OS Manuals

/usr/bin/clang-linker-wrapper

C language family frontend for LLVM 19

From clang-19 19.1.7-r31 (os), captured 2026-11-05 by running clang-linker-wrapper --help (exit 0). permalink

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)
OptionDescriptionSource
--bitcode-library kind>-<triple>-<arch>=<pathExtra bitcode library to linkhelp
--builtin-bitcode triple>=<pathPerform a special internalizing link on the bitcode file.help
--clang-backendRun the backend using clang rather than the LTO backendhelp
--compression-level valueSpecify the compression level (integer)help
--compressCompress bundled fileshelp
--cuda-path dirSet the system CUDA pathhelp
--device-debugUse debugginghelp
--dry-runPrint program arguments without runninghelp
--embed-bitcodeEmbed linked bitcode in the modulehelp
--help-hiddenDisplay all available optionshelp
--helpDisplay available options (--help-hidden for more)help
--host-triple tripleTriple to use for the host compilationhelp
--linker-path pathThe linker executable to invokehelp
-L dirAdd <dir> to the library search pathhelp
-l libnameSearch for library <libname>help
-mllvm argArguments passed to LLVM, including Clang invocations, for which the '-mllvm' prefix is preserved.help
--opt-level O0Optimization level for LTOhelp
--override-image kind=fileUses the provided file as if it were the output of the device link stephelp
-o pathPath to file to write outputhelp
--pass-remarks-analysis valuePass remarks for LTOhelp
--pass-remarks-missed valuePass remarks for LTOhelp
--pass-remarks valuePass remarks for LTOhelp
--print-wrapped-modulePrint the wrapped module's IR for testinghelp
--ptxas-arg valueArgument to pass to the 'ptxas' invocationhelp
--relocatableLink device code to create a relocatable offloading applicationhelp
--save-tempsSave intermediate resultshelp
--sysroot valueSet the system roothelp
--vDisplay the version number and exithelp
--wrapper-time-trace-granularity numberSet the granularity of time-trace updateshelp
--wrapper-time-trace fileEnable time-trace and write the output to <file>help
--wrapper-verboseVerbose output from toolshelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.