--- name: "ld.lld-6.0" section: "1" platform: "linux" package: "lld-6.0" version: "1:6.0.1-10" release: "Debian 10 (Buster)" platforms: ["linux"] url: "https://new.carta.tech/ld.lld-6.0" --- # ld.lld-6.0(1) manual page for ld.lld 6.0 ## NAME ld.lld - manual page for ld.lld 6.0 ## DESCRIPTION OVERVIEW: lld USAGE: build-llvm/bin/ld.lld \[options\] \ ### OPTIONS: - **--allow-multiple-definition** Allow multiple definitions - **--as-needed** Only set DT\_NEEDED for shared libraries if used - **--auxiliary** \ Set DT\_AUXILIARY field to the specified name - **--Bdynamic** Link against shared libraries - **--Bshareable** Build a shared object - **--Bstatic** Do not link against shared libraries - **--Bsymbolic-functions** Bind defined function symbols locally - **--Bsymbolic** Bind defined symbols locally - **--build-id=**\ Generate build ID note - **--build-id** Generate build ID note - **--b** \ Change the input format of the inputs following this option - **--call\_shared** Link against shared libraries - **--color-diagnostics=**\ Use colors in diagnostics - **--color-diagnostics** Use colors in diagnostics - **--compress-debug-sections=**\ Compress DWARF debug sections - **--compress-debug-sections** \ Compress DWARF debug sections - **--dc** Assign space to common symbols - **--define-common** Assign space to common symbols - **--defsym=**\ Define a symbol alias - **--defsym** \ Define a symbol alias - **--demangle** Demangle symbol names - **--disable-new-dtags** Disable new dynamic tags - **--discard-all** Delete all local symbols - **--discard-locals** Delete temporary local symbols - **--discard-none** Keep all symbols in the symbol table - **--dn** Do not link against shared libraries - **--dp** Assign space to common symbols - **--dynamic-linker** \ Which dynamic linker to use - **--dynamic-list=**\ Read a list of dynamic symbols - **--dynamic-list** \ Read a list of dynamic symbols - **--dy** Link against shared libraries - **-d** Assign space to common symbols - **--eh-frame-hdr** Request creation of .eh\_frame\_hdr section and PT\_GNU\_EH\_FRAME segment header - **--emit-relocs** Generate relocations in output - **--enable-new-dtags** Enable new dynamic tags - **--end-lib** End a grouping of objects that should be treated as if they were together in an archive - **--entry=**\ Name of entry point symbol - **--entry** \ Name of entry point symbol - **--error-limit=**\ Maximum number of errors to emit before stopping (0 = no limit) - **--error-limit** \ Maximum number of errors to emit before stopping (0 = no limit) - **--error-unresolved-symbols** Report unresolved symbols as errors - **--exclude-libs=**\ Exclude static libraries from automatic export - **--exclude-libs** \ Exclude static libraries from automatic export - **--export-dynamic-symbol=**\ Put a symbol in the dynamic symbol table - **--export-dynamic-symbol** \ Put a symbol in the dynamic symbol table - **--export-dynamic** Put symbols in the dynamic symbol table - **-E** Put symbols in the dynamic symbol table - **-e** \ Name of entry point symbol - **--fatal-warnings** Treat warnings as errors - **--filter=**\ Set DT\_FILTER field to the specified name - **--filter** \ Set DT\_FILTER field to the specified name - **--fini=**\ Specify a finalizer function - **--fini** \ Specify a finalizer function **--fix-cortex-a53-843419** Apply fixes for AArch64 Cortex-A53 erratum 843419 **--format=**\ Change the input format of the inputs following this option **--format** \ Change the input format of the inputs following this option - **--full-shutdown** Perform a full shutdown instead of calling \_exit - **-F** \ Set DT\_FILTER field to the specified name - **-f** \ Set DT\_AUXILIARY field to the specified name - **--gc-sections** Enable garbage collection of unused sections - **--gdb-index** Generate .gdb\_index section - **--hash-style=**\ Specify hash style (sysv, gnu or both) - **--hash-style** \ Specify hash style (sysv, gnu or both) - **--help** Print option help - **-h** \ Set DT\_SONAME - **--icf-data** Enable ICF to also fold identical read only data - **--icf**=*all* Enable identical code folding - **--icf**=*none* Disable identical code folding - **--image-base=**\ Set the base address - **--image-base** \ Set the base address - **--init=**\ Specify an initializer function - **--init** \ Specify an initializer function - **--library-path=**\ Add a directory to the library search path - **--library-path** \ Add a directory to the library search path - **--library=**\ Root name of library to use - **--library** \ Root name of library to use - **--lto-aa-pipeline=**\ AA pipeline to run during LTO. Used in conjunction with **-lto-newpm-passes** - **--lto-newpm-passes=**\ Passes to run during LTO - **--lto-O**\ Optimization level for LTO - **--lto-partitions=**\ Number of LTO codegen partitions - **-L** \ Add a directory to the library search path - **-l** \ Root name of library to use - **--Map=**\ Print a link map to the specified file - **--Map** \ Print a link map to the specified file - **--merge-exidx-entries** Enable merging .ARM.exidx entries - **-M** Print a link map to the standard output - **-m** \ Set target emulation - **--no-as-needed** Always DT\_NEEDED for shared libraries - **--no-color-diagnostics** Do not use colors in diagnostics - **--no-define-common** Do not assign space to common symbols - **--no-demangle** Do not demangle symbol names - **--no-dynamic-linker** Inhibit output of .interp section - **--no-eh-frame-hdr** Do not create .eh\_frame\_hdr section - **--no-gc-sections** Disable garbage collection of unused sections - **--no-gdb-index** Do not generate .gdb\_index section - **--no-gnu-unique** Disable STB\_GNU\_UNIQUE symbol binding - **--no-merge-exidx-entries** Disable merging .ARM.exidx entries - **--no-omagic** Do not set the text data sections to be writable - **--no-print-gc-sections** Do not list removed unused sections - **--no-rosegment** Do not put read-only non-executable sections in their own segment - **--no-threads** Do not run the linker multi-threaded - **--no-undefined-version** Report version scripts that refer undefined symbols - **--no-undefined** Report unresolved symbols even if the linker is creating a shared library - **--no-whole-archive** Restores the default behavior of loading archive members - **--noinhibit-exec** Retain the executable output file whenever it is still usable - **--non\_shared** Do not link against shared libraries - **--nopie** Do not create a position independent executable - **--nostdlib** Only search directories specified on the command line - **-N** Set the text and data sections to be readable and writable - **--oformat** \ Specify the binary format for the output object file - **--omagic** Set the text and data sections to be readable and writable - **--opt-remarks-filename** \ YAML output file for optimization remarks - **--opt-remarks-with-hotness** Include hotness informations in the optimization remarks file - **--orphan-handling=**\ Control how orphan sections are handled when linker script used - **--orphan-handling** \ Control how orphan sections are handled when linker script used - **--output=**\ Path to file to write output - **--output** \ Path to file to write output - **-O** \ Optimize output file size - **-o** \ Path to file to write output - **--pack-dyn-relocs=**\ Pack dynamic relocations in the given format (none or android) - **--pic-executable** Create a position independent executable - **--pie** Create a position independent executable - **--plugin-opt=**\ specifies LTO options for compatibility with GNU linkers - **--plugin-opt** \ specifies LTO options for compatibility with GNU linkers - **--print-gc-sections** List removed unused sections - **--print-map** Print a link map to the standard output - **-q** Generate relocations in output - **--relocatable** Create relocatable object file - **--reproduce=**\ Dump linker invocation and input files for debugging - **--reproduce** \ Dump linker invocation and input files for debugging - **--retain-symbols-file=**\ Retain only the symbols listed in the file - **--retain-symbols-file** \ Retain only the symbols listed in the file - **--rpath=**\ Add a DT\_RUNPATH to the output - **--rpath** \ Add a DT\_RUNPATH to the output - **--rsp-quoting=**\ Quoting style for response files. Values supported: windows\|posix - **--rsp-quoting** \ Quoting style for response files. Values supported: windows\|posix - **-R** \ Add a DT\_RUNPATH to the output - **-r** Create relocatable object file - **--script=**\ Read linker script - **--script** \ Read linker script - **--section-start** \ Set address of section - **--shared** Build a shared object - **--soname=**\ Set DT\_SONAME - **--soname** \ Set DT\_SONAME - **--sort-section=**\ Specifies sections sorting rule when linkerscript is used - **--sort-section** \ Specifies sections sorting rule when linkerscript is used - **--start-lib** Start a grouping of objects that should be treated as if they were together in an archive - **--static** Do not link against shared libraries - **--strip-all** Strip all symbols - **--strip-debug** Strip debugging information - **--symbol-ordering-file** \ Layout sections in the order specified by symbol file - **--sysroot=**\ Set the system root - **--sysroot** \ Set the system root - **-S** Strip debugging information - **-s** Strip all symbols - **--target1-abs** Interpret R\_ARM\_TARGET1 as R\_ARM\_ABS32 - **--target1-rel** Interpret R\_ARM\_TARGET1 as R\_ARM\_REL32 - **--target2=**\ Interpret R\_ARM\_TARGET2 as \, where \ is one of rel, abs, or got-rel - **--target2** \ Interpret R\_ARM\_TARGET2 as \, where \ is one of rel, abs, or got-rel - **--Tbss=**\ Same as **--section-start** with .bss as the sectionname - **--Tbss** \ Same as **--section-start** with .bss as the sectionname - **--Tdata=**\ Same as **--section-start** with .data as the sectionname - **--Tdata** \ Same as **--section-start** with .data as the sectionname - **--thinlto-cache-dir=**\ Path to ThinLTO cached object file directory - **--thinlto-cache-policy** \ Pruning policy for the ThinLTO cache - **--thinlto-jobs=**\ Number of ThinLTO jobs - **--threads** Run the linker multi-threaded - **--trace-symbol=**\ Trace references to symbols - **--trace-symbol** \ Trace references to symbols - **--trace** Print the names of the input files **--Ttext-segment=**\ Same as **--section-start** with .text as the sectionname **--Ttext-segment** \ Same as **--section-start** with .text as the sectionname - **--Ttext=**\ Same as **--section-start** with .text as the sectionname - **--Ttext** \ Same as **--section-start** with .text as the sectionname - **-T** \ Read linker script - **-t** Print the names of the input files - **--undefined=**\ Force undefined symbol during linking - **--undefined** \ Force undefined symbol during linking - **--unresolved-symbols=**\ Determine how to handle unresolved symbols - **--unresolved-symbols** \ Determine how to handle unresolved symbols - **-u** \ Force undefined symbol during linking - **--verbose** Verbose mode - **--version-script=**\ Read a version script - **--version-script** \ Read a version script - **--version** Display the version number and exit - **-V** Display the version number and exit - **-v** Display the version number - **--warn-common** Warn about duplicate common symbols - **--warn-unresolved-symbols** Report unresolved symbols as warnings - **--whole-archive** Force load of all members in a static library - **--wrap=**\ Use wrapper functions for symbol - **--wrap** \ Use wrapper functions for symbol - **-X** Delete temporary local symbols - **-x** Delete all local symbols - **-y** \ Trace references to symbols - **-z** \ Linker option extensions build-llvm/bin/ld.lld: supported targets: elf32-i386 elf32-iamcu elf32-littlearm elf32-ntradbigmips elf32-ntradlittlemips elf32-powerpc elf32-tradbigmips elf32-tradlittlemips elf32-x86-64 elf64-amdgpu elf64-littleaarch64 elf64-powerpc elf64-tradbigmips elf64-tradlittlemips elf64-x86-64