631 lines
26 KiB
HTML
631 lines
26 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of GOLD</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>GOLD</H1>
|
|
Section: User Commands (1)<BR>Updated: November 2019<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
gold - The GNU ELF linker
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>ld.gold</B>
|
|
|
|
[<I>,options/</I>] <I>,file/</I>...
|
|
<A NAME="lbAD"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>--help</B><DD>
|
|
Report usage information
|
|
<DT id="2"><B>-v</B>, <B>--version</B><DD>
|
|
Report version information
|
|
<DT id="3"><B>-V</B><DD>
|
|
Report version and target information
|
|
<DT id="4"><B>--add-needed</B><DD>
|
|
Not supported
|
|
<DT id="5"><B>--no-add-needed</B><DD>
|
|
Do not copy DT_NEEDED tags from shared libraries (default)
|
|
<DT id="6">
|
|
<B>--allow-multiple-definition</B> Allow multiple definitions of symbols
|
|
<DT id="7"><B>--no-allow-multiple-definition</B><DD>
|
|
<DD>Do not allow multiple definitions (default)
|
|
<DT id="8"><B>--allow-shlib-undefined</B><DD>
|
|
Allow unresolved references in shared libraries
|
|
<DT id="9"><B>--no-allow-shlib-undefined</B><DD>
|
|
Do not allow unresolved references in shared libraries (default)
|
|
<DT id="10"><B>--apply-dynamic-relocs</B><DD>
|
|
Apply link-time values for dynamic relocations (default)
|
|
<DT id="11"><B>--no-apply-dynamic-relocs</B><DD>
|
|
(aarch64 only) Do not apply link-time values for dynamic relocations
|
|
<DT id="12"><B>--as-needed</B><DD>
|
|
Use DT_NEEDED only for shared libraries that are used
|
|
<DT id="13"><B>--no-as-needed</B><DD>
|
|
Use DT_NEEDED for all shared libraries (default)
|
|
<DT id="14"><B>-assert</B> [ignored]<DD>
|
|
Ignored
|
|
<DT id="15"><B>-b</B> [elf,binary], <B>--format</B> [elf,binary]<DD>
|
|
Set input format
|
|
<DT id="16"><B>--be8</B><DD>
|
|
Output BE8 format image
|
|
<DT id="17"><B>--build-id</B> [=STYLE]<DD>
|
|
Generate build ID note
|
|
<DT id="18"><B>--build-id-chunk-size-for-treehash</B> SIZE<DD>
|
|
Chunk size for '--build-id=tree'
|
|
<DT id="19"><B>--build-id-min-file-size-for-treehash</B> SIZE<DD>
|
|
Minimum output file size for '--build-id=tree' to work differently than '--build-id=sha1'
|
|
<DT id="20">
|
|
<B>-Bdynamic</B> <B>-l</B> searches for shared libraries (default)
|
|
<DT id="21">
|
|
<B>-Bstatic</B> <B>-l</B> does not search for shared libraries
|
|
<DT id="22"><B>-dy</B><DD>
|
|
<DD>alias for <B>-Bdynamic</B> (default)
|
|
<DT id="23"><B>-dn</B><DD>
|
|
alias for <B>-Bstatic</B>
|
|
<DT id="24"><B>-Bgroup</B><DD>
|
|
Use group name lookup rules for shared library
|
|
<DT id="25"><B>-Bshareable</B><DD>
|
|
Generate shared library (alias for <B>-G</B>/-shared)
|
|
<DT id="26"><B>-Bsymbolic</B><DD>
|
|
Bind defined symbols locally
|
|
<DT id="27"><B>-Bsymbolic-functions</B><DD>
|
|
Bind defined function symbols locally
|
|
<DT id="28"><B>--check-sections</B><DD>
|
|
Check segment addresses for overlaps (default)
|
|
<DT id="29"><B>--no-check-sections</B><DD>
|
|
Do not check segment addresses for overlaps
|
|
<DT id="30"><B>--compress-debug-sections</B> [none,zlib,zlib-gnu,zlib-gabi]<DD>
|
|
Compress .debug_* sections in the output file
|
|
<DT id="31"><B>--copy-dt-needed-entries</B><DD>
|
|
Not supported
|
|
<DT id="32">
|
|
<B>--no-copy-dt-needed-entries</B> Do not copy DT_NEEDED tags from shared libraries (default)
|
|
<DT id="33"><B>--cref</B><DD>
|
|
<DD>Output cross reference table
|
|
<DT id="34"><B>--no-cref</B><DD>
|
|
Do not output cross reference table (default)
|
|
<DT id="35"><B>--ctors-in-init-array</B><DD>
|
|
Use DT_INIT_ARRAY for all constructors (default)
|
|
<DT id="36"><B>--no-ctors-in-init-array</B><DD>
|
|
Handle constructors as directed by compiler
|
|
<DT id="37"><B>-d</B>, <B>--define-common</B><DD>
|
|
Define common symbols
|
|
<DT id="38"><B>--no-define-common</B><DD>
|
|
Do not define common symbols in relocatable output (default)
|
|
<DT id="39"><B>-dc</B><DD>
|
|
Alias for <B>-d</B>
|
|
<DT id="40"><B>-dp</B><DD>
|
|
Alias for <B>-d</B>
|
|
<DT id="41"><B>--debug</B> [all,files,script,task][,...]<DD>
|
|
Turn on debugging
|
|
<DT id="42"><B>--defsym</B> SYMBOL=EXPRESSION<DD>
|
|
Define a symbol
|
|
<DT id="43"><B>--demangle</B> [=STYLE]<DD>
|
|
Demangle C++ symbols in log messages
|
|
<DT id="44"><B>--no-demangle</B><DD>
|
|
Do not demangle C++ symbols in log messages
|
|
<DT id="45"><B>--detect-odr-violations</B><DD>
|
|
Look for violations of the C++ One Definition Rule
|
|
<DT id="46"><B>--no-detect-odr-violations</B><DD>
|
|
Do not look for violations of the C++ One Definition Rule (default)
|
|
<DT id="47"><B>--dynamic-list-data</B><DD>
|
|
Add data symbols to dynamic symbols
|
|
<DT id="48"><B>--dynamic-list-cpp-new</B><DD>
|
|
Add C++ operator new/delete to dynamic symbols
|
|
<DT id="49">
|
|
<B>--dynamic-list-cpp-typeinfo</B> Add C++ typeinfo to dynamic symbols
|
|
<DT id="50"><B>--dynamic-list</B> FILE<DD>
|
|
<DD>Read a list of dynamic symbols
|
|
<DT id="51"><B>--emit-stub-syms</B><DD>
|
|
(PowerPC only) Label linker stubs with a symbol (default)
|
|
<DT id="52"><B>--no-emit-stub-syms</B><DD>
|
|
(PowerPC only) Do not label linker stubs with a symbol
|
|
<DT id="53">
|
|
<B>-e</B> ADDRESS, <B>--entry</B> ADDRESS Set program start address
|
|
<DT id="54"><B>--eh-frame-hdr</B><DD>
|
|
<DD>Create exception frame header
|
|
<DT id="55"><B>--no-eh-frame-hdr</B><DD>
|
|
Do not create exception frame header (default)
|
|
<DT id="56"><B>--enable-new-dtags</B><DD>
|
|
Enable use of DT_RUNPATH (default)
|
|
<DT id="57"><B>--disable-new-dtags</B><DD>
|
|
Disable use of DT_RUNPATH
|
|
<DT id="58"><B>--no-enum-size-warning</B><DD>
|
|
(ARM only) Do not warn about objects with incompatible enum sizes
|
|
<DT id="59"><B>--exclude-libs</B> lib,lib ...<DD>
|
|
Exclude libraries from automatic export
|
|
<DT id="60"><B>-E</B>, <B>--export-dynamic</B><DD>
|
|
Export all dynamic symbols
|
|
<DT id="61"><B>--no-export-dynamic</B><DD>
|
|
Do not export all dynamic symbols (default)
|
|
<DT id="62"><B>--export-dynamic-symbol</B> SYMBOL<DD>
|
|
Export SYMBOL to dynamic symbol table
|
|
<DT id="63"><B>-EB</B><DD>
|
|
Link big-endian objects.
|
|
<DT id="64"><B>-EL</B><DD>
|
|
Link little-endian objects.
|
|
<DT id="65">
|
|
<B>-f</B> SHLIB, <B>--auxiliary</B> SHLIB Auxiliary filter for shared object symbol table
|
|
<DT id="66"><B>-F</B> SHLIB, <B>--filter</B> SHLIB<DD>
|
|
<DD>Filter for shared object symbol table
|
|
<DT id="67"><B>--fatal-warnings</B><DD>
|
|
Treat warnings as errors
|
|
<DT id="68"><B>--no-fatal-warnings</B><DD>
|
|
Do not treat warnings as errors (default)
|
|
<DT id="69"><B>-fini</B> SYMBOL<DD>
|
|
Call SYMBOL at unload-time
|
|
<DT id="70"><B>--fix-arm1176</B><DD>
|
|
(ARM only) Fix binaries for ARM1176 erratum (default)
|
|
<DT id="71"><B>--no-fix-arm1176</B><DD>
|
|
(ARM only) Do not fix binaries for ARM1176 erratum
|
|
<DT id="72"><B>--fix-cortex-a8</B><DD>
|
|
(ARM only) Fix binaries for Cortex-A8 erratum
|
|
<DT id="73"><B>--no-fix-cortex-a8</B><DD>
|
|
(ARM only) Do not fix binaries for Cortex-A8 erratum (default)
|
|
<DT id="74"><B>--fix-cortex-a53-843419</B><DD>
|
|
(AArch64 only) Fix Cortex-A53 erratum 843419
|
|
<DT id="75"><B>--no-fix-cortex-a53-843419</B><DD>
|
|
(AArch64 only) Do not fix Cortex-A53 erratum 843419 (default)
|
|
<DT id="76"><B>--fix-cortex-a53-835769</B><DD>
|
|
(AArch64 only) Fix Cortex-A53 erratum 835769
|
|
<DT id="77"><B>--no-fix-cortex-a53-835769</B><DD>
|
|
(AArch64 only) Do not fix Cortex-A53 erratum 835769 (default)
|
|
<DT id="78"><B>--fix-v4bx</B><DD>
|
|
(ARM only) Rewrite BX rn as MOV pc, rn for ARMv4
|
|
<DT id="79"><B>--fix-v4bx-interworking</B><DD>
|
|
(ARM only) Rewrite BX rn branch to ARMv4 interworking veneer
|
|
<DT id="80"><B>-fuse-ld</B> [gold,bfd]<DD>
|
|
Ignored for GCC linker option compatibility
|
|
<DT id="81"><B>-g</B><DD>
|
|
Ignored
|
|
<DT id="82"><B>--gc-sections</B><DD>
|
|
Remove unused sections
|
|
<DT id="83"><B>--no-gc-sections</B><DD>
|
|
Don't remove unused sections (default)
|
|
<DT id="84"><B>--gdb-index</B><DD>
|
|
Generate .gdb_index section
|
|
<DT id="85"><B>--no-gdb-index</B><DD>
|
|
Do not generate .gdb_index section (default)
|
|
<DT id="86"><B>--gnu-unique</B><DD>
|
|
Enable STB_GNU_UNIQUE symbol binding (default)
|
|
<DT id="87"><B>--no-gnu-unique</B><DD>
|
|
Disable STB_GNU_UNIQUE symbol binding
|
|
<DT id="88"><B>-G</B>, <B>-shared</B><DD>
|
|
Generate shared library
|
|
<DT id="89"><B>-h</B> FILENAME, <B>-soname</B> FILENAME<DD>
|
|
Set shared library name
|
|
<DT id="90"><B>--hash-bucket-empty-fraction</B> FRACTION<DD>
|
|
Min fraction of empty buckets in dynamic hash
|
|
<DT id="91"><B>--hash-style</B> [sysv,gnu,both]<DD>
|
|
Dynamic hash style
|
|
<DT id="92"><B>-i</B><DD>
|
|
Alias for <B>-r</B>
|
|
<DT id="93"><B>--icf</B> [none,all,safe]<DD>
|
|
Identical Code Folding. '--icf=safe' Folds ctors, dtors and functions whose pointers are definitely not taken
|
|
<DT id="94"><B>--icf-iterations</B> COUNT<DD>
|
|
Number of iterations of ICF (default 3)
|
|
<DT id="95"><B>--incremental</B><DD>
|
|
Do an incremental link if possible; otherwise, do a full link and prepare output for incremental linking
|
|
<DT id="96"><B>--no-incremental</B><DD>
|
|
Do a full link (default)
|
|
<DT id="97"><B>--incremental-full</B><DD>
|
|
Do a full link and prepare output for incremental linking
|
|
<DT id="98"><B>--incremental-update</B><DD>
|
|
Do an incremental link; exit if not possible
|
|
<DT id="99"><B>--incremental-base</B> FILE<DD>
|
|
Set base file for incremental linking (default is output file)
|
|
<DT id="100"><B>--incremental-changed</B><DD>
|
|
Assume files changed
|
|
<DT id="101"><B>--incremental-unchanged</B><DD>
|
|
Assume files didn't change
|
|
<DT id="102"><B>--incremental-unknown</B><DD>
|
|
Use timestamps to check files (default)
|
|
<DT id="103"><B>--incremental-startup-unchanged</B><DD>
|
|
Assume startup files unchanged (files preceding this option)
|
|
<DT id="104">
|
|
<B>--incremental-patch</B> PERCENT Amount of extra space to allocate for patches (default 10)
|
|
<DT id="105"><B>-init</B> SYMBOL<DD>
|
|
<DD>Call SYMBOL at load-time
|
|
<DT id="106"><B>-I</B> PROGRAM, <B>--dynamic-linker</B> PROGRAM<DD>
|
|
Set dynamic linker path
|
|
<DT id="107"><B>--just-symbols</B> FILE<DD>
|
|
Read only symbol values from FILE
|
|
<DT id="108"><B>--keep-files-mapped</B><DD>
|
|
Keep files mapped across passes (default)
|
|
<DT id="109"><B>--no-keep-files-mapped</B><DD>
|
|
Release mapped files after each pass
|
|
<DT id="110"><B>--keep-unique</B> SYMBOL<DD>
|
|
Do not fold this symbol during ICF
|
|
<DT id="111"><B>-l</B> LIBNAME, <B>--library</B> LIBNAME<DD>
|
|
Search for library LIBNAME
|
|
<DT id="112"><B>--ld-generated-unwind-info</B><DD>
|
|
Generate unwind information for PLT (default)
|
|
<DT id="113"><B>--no-ld-generated-unwind-info</B><DD>
|
|
Do not generate unwind information for PLT
|
|
<DT id="114"><B>-L</B> DIR, <B>--library-path</B> DIR<DD>
|
|
Add directory to search path
|
|
<DT id="115"><B>--long-plt</B><DD>
|
|
(ARM only) Generate long PLT entries
|
|
<DT id="116"><B>--no-long-plt</B><DD>
|
|
(ARM only) Do not generate long PLT entries (default)
|
|
<DT id="117"><B>-m</B> EMULATION<DD>
|
|
Set GNU linker emulation; obsolete
|
|
<DT id="118"><B>--map-whole-files</B><DD>
|
|
Map whole files to memory (default)
|
|
<DT id="119"><B>--no-map-whole-files</B><DD>
|
|
Map relevant file parts to memory
|
|
<DT id="120"><B>--merge-exidx-entries</B><DD>
|
|
(ARM only) Merge exidx entries in debuginfo (default)
|
|
<DT id="121"><B>--no-merge-exidx-entries</B><DD>
|
|
(ARM only) Do not merge exidx entries in debuginfo
|
|
<DT id="122"><B>--mmap-output-file</B><DD>
|
|
Map the output file for writing (default)
|
|
<DT id="123"><B>--no-mmap-output-file</B><DD>
|
|
Do not map the output file for writing
|
|
<DT id="124"><B>-M</B>, <B>--print-map</B><DD>
|
|
Write map file on standard output
|
|
<DT id="125"><B>-Map</B> MAPFILENAME<DD>
|
|
Write map file
|
|
<DT id="126"><B>-n</B>, <B>--nmagic</B><DD>
|
|
Do not page align data
|
|
<DT id="127"><B>-N</B>, <B>--omagic</B><DD>
|
|
Do not page align data, do not make text readonly
|
|
<DT id="128"><B>--no-omagic</B><DD>
|
|
Page align data, make text readonly (default)
|
|
<DT id="129"><B>--no-keep-memory</B><DD>
|
|
Use less memory and more disk I/O (included only for compatibility with GNU ld)
|
|
<DT id="130"><B>--no-undefined</B><DD>
|
|
Report undefined symbols (even with <B>--shared</B>)
|
|
<DT id="131"><B>--noinhibit-exec</B><DD>
|
|
Create an output file even if errors occur
|
|
<DT id="132"><B>-nostdlib</B><DD>
|
|
Only search directories specified on the command line
|
|
<DT id="133"><B>-o</B> FILE, <B>--output</B> FILE<DD>
|
|
Set output file name
|
|
<DT id="134"><B>--oformat</B> [binary]<DD>
|
|
Set output format
|
|
<DT id="135"><B>-O</B> LEVEL, <B>-optimize</B> LEVEL<DD>
|
|
Optimize output file size
|
|
<DT id="136"><B>--orphan-handling</B> [place,discard,warn,error]<DD>
|
|
Orphan section handling
|
|
<DT id="137"><B>-p</B><DD>
|
|
Ignored for ARM compatibility
|
|
<DT id="138"><B>-pie</B><DD>
|
|
Create a position independent executable
|
|
<DT id="139"><B>-no-pie</B><DD>
|
|
Do not create a position independent executable (default)
|
|
<DT id="140"><B>--pic-executable</B><DD>
|
|
Create a position independent executable
|
|
<DT id="141"><B>--no-pic-executable</B><DD>
|
|
Do not create a position independent executable (default)
|
|
<DT id="142"><B>--pic-veneer</B><DD>
|
|
Force PIC sequences for ARM/Thumb interworking veneers
|
|
<DT id="143"><B>-no-pipeline-knowledge</B><DD>
|
|
(ARM only) Ignore for backward compatibility (default)
|
|
<DT id="144"><B>--plt-align</B> [=P2ALIGN]<DD>
|
|
(PowerPC only) Align PLT call stubs to fit cache lines
|
|
<DT id="145"><B>--plt-localentry</B><DD>
|
|
(PowerPC64 only) Optimize calls to ELFv2 localentry:0 functions
|
|
<DT id="146"><B>--no-plt-localentry</B><DD>
|
|
(PowerPC64 only) Don't optimize ELFv2 calls (default)
|
|
<DT id="147"><B>--plt-static-chain</B><DD>
|
|
(PowerPC64 only) PLT call stubs should load r11
|
|
<DT id="148"><B>--no-plt-static-chain</B><DD>
|
|
(PowerPC64 only) PLT call stubs should not load r11 (default)
|
|
<DT id="149"><B>--plt-thread-safe</B><DD>
|
|
(PowerPC64 only) PLT call stubs with load-load barrier
|
|
<DT id="150"><B>--no-plt-thread-safe</B><DD>
|
|
(PowerPC64 only) PLT call stubs without barrier (default)
|
|
<DT id="151"><B>--plugin</B> PLUGIN<DD>
|
|
Load a plugin library
|
|
<DT id="152"><B>--plugin-opt</B> OPTION<DD>
|
|
Pass an option to the plugin
|
|
<DT id="153"><B>--posix-fallocate</B><DD>
|
|
Use posix_fallocate to reserve space in the output file (default)
|
|
<DT id="154"><B>--no-posix-fallocate</B><DD>
|
|
Use fallocate or ftruncate to reserve space
|
|
<DT id="155"><B>--preread-archive-symbols</B><DD>
|
|
Preread archive symbols when multi-threaded
|
|
<DT id="156"><B>--print-gc-sections</B><DD>
|
|
List removed unused sections on stderr
|
|
<DT id="157"><B>--no-print-gc-sections</B><DD>
|
|
Do not list removed unused sections (default)
|
|
<DT id="158"><B>--print-icf-sections</B><DD>
|
|
List folded identical sections on stderr
|
|
<DT id="159"><B>--no-print-icf-sections</B><DD>
|
|
Do not list folded identical sections (default)
|
|
<DT id="160"><B>--print-output-format</B><DD>
|
|
Print default output format
|
|
<DT id="161"><B>--print-symbol-counts</B> FILENAME<DD>
|
|
Print symbols defined and used for each input
|
|
<DT id="162"><B>--push-state</B><DD>
|
|
Save the state of flags related to input files
|
|
<DT id="163"><B>--pop-state</B><DD>
|
|
Restore the state of flags related to input files
|
|
<DT id="164"><B>-q</B>, <B>--emit-relocs</B><DD>
|
|
Generate relocations in output
|
|
<DT id="165"><B>-Qy</B><DD>
|
|
Ignored for SVR4 compatibility
|
|
<DT id="166"><B>-r</B>, <B>-relocatable</B><DD>
|
|
Generate relocatable output
|
|
<DT id="167"><B>--relax</B><DD>
|
|
Relax branches on certain targets
|
|
<DT id="168"><B>--no-relax</B><DD>
|
|
Do not relax branches (default)
|
|
<DT id="169"><B>--retain-symbols-file</B> FILE<DD>
|
|
keep only symbols listed in this file
|
|
<DT id="170"><B>--rosegment</B><DD>
|
|
Put read-only non-executable sections in their own segment
|
|
<DT id="171"><B>--rosegment-gap</B> OFFSET<DD>
|
|
Set offset between executable and read-only segments
|
|
<DT id="172"><B>-R</B> DIR<DD>
|
|
Add DIR to runtime search path
|
|
<DT id="173"><B>-rpath</B> DIR<DD>
|
|
Add DIR to runtime search path
|
|
<DT id="174"><B>--rpath-link</B> DIR<DD>
|
|
Add DIR to link time shared library search path
|
|
<DT id="175"><B>-s</B>, <B>--strip-all</B><DD>
|
|
Strip all symbols
|
|
<DT id="176"><B>-S</B>, <B>--strip-debug</B><DD>
|
|
Strip debugging information
|
|
<DT id="177"><B>--strip-debug-non-line</B><DD>
|
|
Emit only debug line number information
|
|
<DT id="178"><B>--strip-debug-gdb</B><DD>
|
|
Strip debug symbols that are unused by gdb (at least versions <= 7.4)
|
|
<DT id="179"><B>--strip-lto-sections</B><DD>
|
|
Strip LTO intermediate code sections (default)
|
|
<DT id="180"><B>--section-ordering-file</B> FILENAME<DD>
|
|
Layout sections in the order specified
|
|
<DT id="181"><B>--section-start</B> SECTION=ADDRESS<DD>
|
|
Set address of section
|
|
<DT id="182"><B>--secure-plt</B><DD>
|
|
(PowerPC only) Use new-style PLT (default)
|
|
<DT id="183"><B>--sort-common</B> [={ascending,descending}]<DD>
|
|
Sort common symbols by alignment
|
|
<DT id="184"><B>--sort-section</B> [none,name]<DD>
|
|
Sort sections by name. '--no-text-reorder' will override '--sort-section=name' for .text
|
|
<DT id="185"><B>--spare-dynamic-tags</B> COUNT<DD>
|
|
Dynamic tag slots to reserve (default 5)
|
|
<DT id="186"><B>--stub-group-size</B> SIZE<DD>
|
|
(ARM, PowerPC only) The maximum distance from instructions in a group of sections to their stubs. Negative values mean stubs are always after the group. 1 means use default size
|
|
<DT id="187"><B>--stub-group-multi</B><DD>
|
|
(PowerPC only) Allow a group of stubs to serve multiple output sections (default)
|
|
<DT id="188"><B>--no-stub-group-multi</B><DD>
|
|
(PowerPC only) Each output section has its own stubs
|
|
<DT id="189"><B>--split-stack-adjust-size</B> SIZE<DD>
|
|
Stack size when <B>-fsplit-stack</B> function calls non-split
|
|
<DT id="190"><B>-static</B><DD>
|
|
Do not link against shared libraries
|
|
<DT id="191"><B>--start-lib</B><DD>
|
|
Start a library
|
|
<DT id="192"><B>--end-lib</B><DD>
|
|
End a library
|
|
<DT id="193"><B>--stats</B><DD>
|
|
Print resource usage statistics
|
|
<DT id="194"><B>--sysroot</B> DIR<DD>
|
|
Set target system root directory
|
|
<DT id="195"><B>-t</B>, <B>--trace</B><DD>
|
|
Print the name of each input file
|
|
<DT id="196"><B>--target1-abs</B><DD>
|
|
(ARM only) Force R_ARM_TARGET1 type to R_ARM_ABS32
|
|
<DT id="197"><B>--target1-rel</B><DD>
|
|
(ARM only) Force R_ARM_TARGET1 type to R_ARM_REL32
|
|
<DT id="198"><B>--target2</B> [rel, abs, got-rel<DD>
|
|
(ARM only) Set R_ARM_TARGET2 relocation type
|
|
<DT id="199"><B>--text-reorder</B><DD>
|
|
Enable text section reordering for GCC section names (default)
|
|
<DT id="200"><B>--no-text-reorder</B><DD>
|
|
Disable text section reordering for GCC section names
|
|
<DT id="201"><B>--threads</B><DD>
|
|
Run the linker multi-threaded
|
|
<DT id="202"><B>--no-threads</B><DD>
|
|
Do not run the linker multi-threaded (default)
|
|
<DT id="203"><B>--thread-count</B> COUNT<DD>
|
|
Number of threads to use
|
|
<DT id="204"><B>--thread-count-initial</B> COUNT<DD>
|
|
Number of threads to use in initial pass
|
|
<DT id="205">
|
|
<B>--thread-count-middle</B> COUNT Number of threads to use in middle pass
|
|
<DT id="206"><B>--thread-count-final</B> COUNT<DD>
|
|
<DD>Number of threads to use in final pass
|
|
<DT id="207"><B>--tls-optimize</B><DD>
|
|
(PowerPC/64 only) Optimize GD/LD/IE code to IE/LE (default)
|
|
<DT id="208"><B>--no-tls-optimize</B><DD>
|
|
(PowerPC/64 only) Don'''t try to optimize TLS accesses
|
|
<DT id="209"><B>--tls-get-addr-optimize</B><DD>
|
|
(PowerPC/64 only) Use a special __tls_get_addr call (default)
|
|
<DT id="210"><B>--no-tls-get-addr-optimize</B><DD>
|
|
(PowerPC/64 only) Don't use a special __tls_get_addr call
|
|
<DT id="211"><B>--toc-optimize</B><DD>
|
|
(PowerPC64 only) Optimize TOC code sequences (default)
|
|
<DT id="212"><B>--no-toc-optimize</B><DD>
|
|
(PowerPC64 only) Don't optimize TOC code sequences
|
|
<DT id="213"><B>--toc-sort</B><DD>
|
|
(PowerPC64 only) Sort TOC and GOT sections (default)
|
|
<DT id="214"><B>--no-toc-sort</B><DD>
|
|
(PowerPC64 only) Don't sort TOC and GOT sections
|
|
<DT id="215"><B>-T</B> FILE, <B>--script</B> FILE<DD>
|
|
Read linker script
|
|
<DT id="216"><B>-Tbss</B> ADDRESS<DD>
|
|
Set the address of the bss segment
|
|
<DT id="217"><B>-Tdata</B> ADDRESS<DD>
|
|
Set the address of the data segment
|
|
<DT id="218"><B>-Ttext</B> ADDRESS<DD>
|
|
Set the address of the text segment
|
|
<DT id="219"><B>-Ttext-segment</B> ADDRESS<DD>
|
|
Set the address of the text segment
|
|
<DT id="220"><B>-Trodata-segment</B> ADDRESS<DD>
|
|
Set the address of the rodata segment
|
|
<DT id="221"><B>-u</B> SYMBOL, <B>--undefined</B> SYMBOL<DD>
|
|
Create undefined reference to SYMBOL
|
|
<DT id="222"><B>--unresolved-symbols</B> ignore-all,report-all,ignore-in-object-files,ignore-in-shared-libs<DD>
|
|
How to handle unresolved symbols
|
|
<DT id="223"><B>--verbose</B><DD>
|
|
Alias for <B>--debug</B>=<I>,files/</I>
|
|
<DT id="224"><B>--version-script</B> FILE<DD>
|
|
Read version script
|
|
<DT id="225"><B>--warn-common</B><DD>
|
|
Warn about duplicate common symbols
|
|
<DT id="226"><B>--no-warn-common</B><DD>
|
|
Do not warn about duplicate common symbols (default)
|
|
<DT id="227"><B>--warn-constructors</B><DD>
|
|
Ignored
|
|
<DT id="228"><B>--no-warn-constructors</B><DD>
|
|
Ignored
|
|
<DT id="229"><B>--warn-drop-version</B><DD>
|
|
Warn when discarding version information
|
|
<DT id="230"><B>--no-warn-drop-version</B><DD>
|
|
Do not warn when discarding version information (default)
|
|
<DT id="231"><B>--warn-execstack</B><DD>
|
|
Warn if the stack is executable
|
|
<DT id="232"><B>--no-warn-execstack</B><DD>
|
|
Do not warn if the stack is executable (default)
|
|
<DT id="233"><B>--no-warn-mismatch</B><DD>
|
|
Don't warn about mismatched input files
|
|
<DT id="234"><B>--warn-multiple-gp</B><DD>
|
|
Ignored
|
|
<DT id="235"><B>--warn-search-mismatch</B><DD>
|
|
Warn when skipping an incompatible library (default)
|
|
<DT id="236"><B>--no-warn-search-mismatch</B><DD>
|
|
Don't warn when skipping an incompatible library
|
|
<DT id="237"><B>--warn-shared-textrel</B><DD>
|
|
Warn if text segment is not shareable
|
|
<DT id="238"><B>--no-warn-shared-textrel</B><DD>
|
|
Do not warn if text segment is not shareable (default)
|
|
<DT id="239"><B>--warn-unresolved-symbols</B><DD>
|
|
Report unresolved symbols as warnings
|
|
<DT id="240"><B>--error-unresolved-symbols</B><DD>
|
|
Report unresolved symbols as errors (default)
|
|
<DT id="241"><B>-z</B> buildd<DD>
|
|
Dummy z option
|
|
<DT id="242"><B>--no-wchar-size-warning</B><DD>
|
|
(ARM only) Do not warn about objects with incompatible wchar_t sizes
|
|
<DT id="243"><B>--weak-unresolved-symbols</B><DD>
|
|
Convert unresolved symbols to weak references
|
|
<DT id="244"><B>--whole-archive</B><DD>
|
|
Include all archive contents
|
|
<DT id="245"><B>--no-whole-archive</B><DD>
|
|
Include only needed archive contents (default)
|
|
<DT id="246"><B>--wrap</B> SYMBOL<DD>
|
|
Use wrapper functions for SYMBOL
|
|
<DT id="247"><B>-x</B>, <B>--discard-all</B><DD>
|
|
Delete all local symbols
|
|
<DT id="248"><B>-X</B>, <B>--discard-locals</B><DD>
|
|
Delete all temporary local symbols
|
|
<DT id="249"><B>--discard-none</B><DD>
|
|
Keep all local symbols
|
|
<DT id="250"><B>-y</B> SYMBOL, <B>--trace-symbol</B> SYMBOL<DD>
|
|
Trace references to symbol
|
|
<DT id="251"><B>--undefined-version</B><DD>
|
|
Allow unused version in script (default)
|
|
<DT id="252"><B>--no-undefined-version</B><DD>
|
|
Do not allow unused version in script
|
|
<DT id="253"><B>-Y</B> PATH<DD>
|
|
Default search path for Solaris compatibility
|
|
<DT id="254">-(, <B>--start-group</B><DD>
|
|
Start a library search group
|
|
<DT id="255">-), <B>--end-group</B><DD>
|
|
End a library search group
|
|
<DT id="256"><B>-z</B> bndplt<DD>
|
|
(x86-64 only) Generate a BND PLT for Intel MPX
|
|
<DT id="257"><B>-z</B> nobndplt<DD>
|
|
Generate a regular PLT (default)
|
|
<DT id="258"><B>-z</B> combreloc<DD>
|
|
Sort dynamic relocs (default)
|
|
<DT id="259"><B>-z</B> nocombreloc<DD>
|
|
Do not sort dynamic relocs
|
|
<DT id="260"><B>-z</B> common-page-size=SIZE<DD>
|
|
Set common page size to SIZE
|
|
<DT id="261"><B>-z</B> defs<DD>
|
|
Report undefined symbols (even with <B>--shared</B>)
|
|
<DT id="262"><B>-z</B> execstack<DD>
|
|
Mark output as requiring executable stack
|
|
<DT id="263"><B>-z</B> global<DD>
|
|
Make symbols in DSO available for subsequently loaded objects
|
|
<DT id="264"><B>-z</B> initfirst<DD>
|
|
Mark DSO to be initialized first at runtime
|
|
<DT id="265"><B>-z</B> interpose<DD>
|
|
Mark object to interpose all DSOs but executable
|
|
<DT id="266"><B>-z</B> lazy<DD>
|
|
Mark object for lazy runtime binding (default)
|
|
<DT id="267"><B>-z</B> loadfltr<DD>
|
|
Mark object requiring immediate process
|
|
<DT id="268"><B>-z</B> max-page-size=SIZE<DD>
|
|
Set maximum page size to SIZE
|
|
<DT id="269"><B>-z</B> muldefs<DD>
|
|
Allow multiple definitions of symbols
|
|
<DT id="270"><B>-z</B> nocopyreloc<DD>
|
|
Do not create copy relocs
|
|
<DT id="271"><B>-z</B> nodefaultlib<DD>
|
|
Mark object not to use default search paths
|
|
<DT id="272"><B>-z</B> nodelete<DD>
|
|
Mark DSO non-deletable at runtime
|
|
<DT id="273"><B>-z</B> nodlopen<DD>
|
|
Mark DSO not available to dlopen
|
|
<DT id="274"><B>-z</B> nodump<DD>
|
|
Mark DSO not available to dldump
|
|
<DT id="275"><B>-z</B> noexecstack<DD>
|
|
Mark output as not requiring executable stack
|
|
<DT id="276"><B>-z</B> now<DD>
|
|
Mark object for immediate function binding
|
|
<DT id="277"><B>-z</B> origin<DD>
|
|
Mark DSO to indicate that needs immediate $ORIGIN processing at runtime
|
|
<DT id="278"><B>-z</B> relro<DD>
|
|
Where possible mark variables read-only after relocation (default)
|
|
<DT id="279"><B>-z</B> norelro<DD>
|
|
Don't mark variables read-only after relocation
|
|
<DT id="280"><B>-z</B> stack-size=SIZE<DD>
|
|
Set PT_GNU_STACK segment p_memsz to SIZE
|
|
<DT id="281"><B>-z</B> text<DD>
|
|
Do not permit relocations in read-only segments
|
|
<DT id="282"><B>-z</B> notext<DD>
|
|
Permit relocations in read-only segments (default)
|
|
<DT id="283"><B>-z</B> textoff<DD>
|
|
Permit relocations in read-only segments (default)
|
|
<DT id="284"><B>-z</B> text-unlikely-segment<DD>
|
|
Move .text.unlikely sections to a separate segment.
|
|
<DT id="285"><B>-z</B> notext-unlikely-segment<DD>
|
|
Do not move .text.unlikely sections to a separate segment. (default)
|
|
<DT id="286">
|
|
<B>-z</B> keep-text-section-prefix Keep .text.hot, .text.startup, .text.exit and .text.unlikely as separate sections in the final binary.
|
|
<DT id="287"><B>-z</B> nokeep-text-section-prefix<DD>
|
|
<DD>Merge all .text.* prefix sections. (default)
|
|
</DL>
|
|
<P>
|
|
|
|
debian/tmp/usr/bin/ld.gold: supported targets: elf32-iamcu elf32-i386 elf32-i386-freebsd elf32-i386-nacl elf32-x86-64 elf32-x86-64-freebsd elf32-x86-64-nacl elf64-x86-64 elf64-x86-64-freebsd elf64-x86-64-nacl
|
|
debian/tmp/usr/bin/ld.gold: supported emulations: elf_iamcu elf_i386 elf_i386_nacl elf32_x86_64 elf32_x86_64_nacl elf_x86_64 elf_x86_64_nacl
|
|
<A NAME="lbAE"> </A>
|
|
<H2>REPORTING BUGS</H2>
|
|
|
|
Report bugs to <<A HREF="http://www.sourceware.org/bugzilla/">http://www.sourceware.org/bugzilla/</A>>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright © 2019 Free Software Foundation, Inc.
|
|
This program is free software; you may redistribute it under the terms of
|
|
the GNU General Public License version 3 or (at your option) a later version.
|
|
This program has absolutely no warranty.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="288"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="289"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="290"><A HREF="#lbAD">OPTIONS</A><DD>
|
|
<DT id="291"><A HREF="#lbAE">REPORTING BUGS</A><DD>
|
|
<DT id="292"><A HREF="#lbAF">COPYRIGHT</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:18 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|