OS Manuals

/usr/bin/clang-linker-wrapper

C language family frontend for LLVM 23

From clang-23 23.1.5-r0 (os), captured 2026-11-05 by running clang-linker-wrapper --help (exit 0). permalink

Also provided by 9 other package versions
OVERVIEW:
A wrapper utility over the host linker. It scans the input files
for sections that require additional processing prior to linking.
It 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 pass to the linker>

OPTIONS:
  --compression-level=<value>
                          Specify the compression level (integer)
  --compress              Compress bundled files
  --cuda-path=<dir>       Set the system CUDA path
  --device-compiler=<value> or <triple>=<value>
                          Arguments to pass to the device compiler invocation
  --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
  --emit-fatbin-only      Emit fat binary directly without wrapping or host linking
  --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.
  --no-canonical-prefixes Do not resolve symbolic links, turn relative paths into absolute ones, or do anything else to identify the executable
  --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
  --print-wrapped-module  Print the wrapped module's IR for testing
  --relocatable           Link device code to create a relocatable offloading application
  --save-temps            Save intermediate results
  --should-extract=<kind=file>
                          Set of device architectures we should always extract if found.
  --sysroot=<value>       Set the system root
  --wrapper-jobs=<number> Sets the number of parallel jobs for device linking. Can be a positive integer or 'jobserver'.
  --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 (23)
OptionDescriptionSource
--compression-level valueSpecify the compression level (integer)help
--compressCompress bundled fileshelp
--cuda-path dirSet the system CUDA pathhelp
--dry-runPrint program arguments without runninghelp
--embed-bitcodeEmbed linked bitcode in the modulehelp
--emit-fatbin-onlyEmit fat binary directly without wrapping or host linkinghelp
--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
--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
--print-wrapped-modulePrint the wrapped module's IR for testinghelp
--relocatableLink device code to create a relocatable offloading applicationhelp
--save-tempsSave intermediate resultshelp
--should-extract kind=fileSet of device architectures we should always extract if found.help
--sysroot valueSet the system roothelp
--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.