diff options
Diffstat (limited to 'debian/ld.gold.1')
-rw-r--r-- | debian/ld.gold.1 | 421 |
1 files changed, 233 insertions, 188 deletions
diff --git a/debian/ld.gold.1 b/debian/ld.gold.1 index 3f7438c..50a4261 100644 --- a/debian/ld.gold.1 +++ b/debian/ld.gold.1 @@ -1,5 +1,5 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.2. -.TH GOLD "1" "November 2015" "gold (GNU Binutils for Debian 2.25.51.20151106) 1.11" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.4. +.TH GOLD "1" "May 2017" "gold (GNU Binutils for Debian 2.28) 1.14" "User Commands" .SH NAME gold \- The GNU ELF linker .SH SYNOPSIS @@ -20,18 +20,18 @@ Report version and target information Not supported .TP \fB\-\-no\-add\-needed\fR -Do not copy DT_NEEDED tags from shared libraries +Do not copy DT_NEEDED tags from shared libraries (default) .HP \fB\-\-allow\-multiple\-definition\fR Allow multiple definitions of symbols .TP \fB\-\-no\-allow\-multiple\-definition\fR -Do not allow multiple definitions +Do not allow multiple definitions (default) .TP \fB\-\-allow\-shlib\-undefined\fR Allow unresolved references in shared libraries .TP \fB\-\-no\-allow\-shlib\-undefined\fR -Do not allow unresolved references in shared libraries +Do not allow unresolved references in shared libraries (default) .TP \fB\-\-apply\-dynamic\-relocs\fR Apply link\-time values for dynamic relocations (default) @@ -40,23 +40,35 @@ Apply link\-time values for dynamic relocations (default) (aarch64 only) Do not apply link\-time values for dynamic relocations .TP \fB\-\-as\-needed\fR -Only set DT_NEEDED for shared libraries if used +Use DT_NEEDED only for shared libraries that are used .TP \fB\-\-no\-as\-needed\fR -Always DT_NEEDED for shared libraries +Use DT_NEEDED for all shared libraries (default) .TP \fB\-assert\fR [ignored] Ignored .TP \fB\-b\fR [elf,binary], \fB\-\-format\fR [elf,binary] Set input format +.TP +\fB\-\-be8\fR +Output BE8 format image +.TP +\fB\-\-build\-id\fR [=STYLE] +Generate build ID note +.TP +\fB\-\-build\-id\-chunk\-size\-for\-treehash\fR SIZE +Chunk size for '\-\-build\-id=tree' +.TP +\fB\-\-build\-id\-min\-file\-size\-for\-treehash\fR SIZE +Minimum output file size for '\-\-build\-id=tree' to work differently than '\-\-build\-id=sha1' .HP -\fB\-Bdynamic\fR \fB\-l\fR searches for shared libraries +\fB\-Bdynamic\fR \fB\-l\fR searches for shared libraries (default) .HP \fB\-Bstatic\fR \fB\-l\fR does not search for shared libraries .TP \fB\-dy\fR -alias for \fB\-Bdynamic\fR +alias for \fB\-Bdynamic\fR (default) .TP \fB\-dn\fR alias for \fB\-Bstatic\fR @@ -64,21 +76,15 @@ alias for \fB\-Bstatic\fR \fB\-Bgroup\fR Use group name lookup rules for shared library .TP +\fB\-Bshareable\fR +Generate shared library (alias for \fB\-G\fR/\-shared) +.TP \fB\-Bsymbolic\fR Bind defined symbols locally .TP \fB\-Bsymbolic\-functions\fR Bind defined function symbols locally .TP -\fB\-\-build\-id\fR [=STYLE] -Generate build ID note -.TP -\fB\-\-build\-id\-chunk\-size\-for\-treehash\fR SIZE -Chunk size for '\-\-build\-id=tree' -.TP -\fB\-\-build\-id\-min\-file\-size\-for\-treehash\fR SIZE -Minimum output file size for '\-\-build\-id=tree' to work differently than '\-\-build\-id=sha1' -.TP \fB\-\-check\-sections\fR Check segment addresses for overlaps (default) .TP @@ -91,13 +97,13 @@ Compress .debug_* sections in the output file \fB\-\-copy\-dt\-needed\-entries\fR Not supported .HP -\fB\-\-no\-copy\-dt\-needed\-entries\fR Do not copy DT_NEEDED tags from shared libraries +\fB\-\-no\-copy\-dt\-needed\-entries\fR Do not copy DT_NEEDED tags from shared libraries (default) .TP \fB\-\-cref\fR Output cross reference table .TP \fB\-\-no\-cref\fR -Do not output cross reference table +Do not output cross reference table (default) .TP \fB\-\-ctors\-in\-init\-array\fR Use DT_INIT_ARRAY for all constructors (default) @@ -109,7 +115,7 @@ Handle constructors as directed by compiler Define common symbols .TP \fB\-\-no\-define\-common\fR -Do not define common symbols +Do not define common symbols in relocatable output (default) .TP \fB\-dc\fR Alias for \fB\-d\fR @@ -133,16 +139,7 @@ Do not demangle C++ symbols in log messages Look for violations of the C++ One Definition Rule .TP \fB\-\-no\-detect\-odr\-violations\fR -Do not look for violations of the C++ One Definition Rule -.TP -\fB\-x\fR, \fB\-\-discard\-all\fR -Delete all local symbols -.TP -\fB\-X\fR, \fB\-\-discard\-locals\fR -Delete all temporary local symbols -.TP -\fB\-\-discard\-none\fR -Keep all local symbols +Do not look for violations of the C++ One Definition Rule (default) .TP \fB\-\-dynamic\-list\-data\fR Add data symbols to dynamic symbols @@ -157,6 +154,21 @@ Read a list of dynamic symbols .HP \fB\-e\fR ADDRESS, \fB\-\-entry\fR ADDRESS Set program start address .TP +\fB\-\-eh\-frame\-hdr\fR +Create exception frame header +.TP +\fB\-\-no\-eh\-frame\-hdr\fR +Do not create exception frame header (default) +.TP +\fB\-\-enable\-new\-dtags\fR +Enable use of DT_RUNPATH (default) +.TP +\fB\-\-disable\-new\-dtags\fR +Disable use of DT_RUNPATH +.TP +\fB\-\-no\-enum\-size\-warning\fR +(ARM only) Do not warn about objects with incompatible enum sizes +.TP \fB\-\-exclude\-libs\fR lib,lib ... Exclude libraries from automatic export .TP @@ -174,12 +186,6 @@ Link big\-endian objects. .TP \fB\-EL\fR Link little\-endian objects. -.TP -\fB\-\-eh\-frame\-hdr\fR -Create exception frame header -.TP -\fB\-\-no\-enum\-size\-warning\fR -(ARM only) Do not warn about objects with incompatible enum sizes .HP \fB\-f\fR SHLIB, \fB\-\-auxiliary\fR SHLIB Auxiliary filter for shared object symbol table .TP @@ -190,40 +196,34 @@ Filter for shared object symbol table Treat warnings as errors .TP \fB\-\-no\-fatal\-warnings\fR -Do not treat warnings as errors +Do not treat warnings as errors (default) .TP \fB\-fini\fR SYMBOL Call SYMBOL at unload\-time .TP +\fB\-\-fix\-arm1176\fR +(ARM only) Fix binaries for ARM1176 erratum (default) +.TP +\fB\-\-no\-fix\-arm1176\fR +(ARM only) Do not fix binaries for ARM1176 erratum +.TP \fB\-\-fix\-cortex\-a8\fR -(ARM only) Fix binaries for Cortex\-A8 erratum. +(ARM only) Fix binaries for Cortex\-A8 erratum .TP \fB\-\-no\-fix\-cortex\-a8\fR -(ARM only) Do not fix binaries for Cortex\-A8 erratum. +(ARM only) Do not fix binaries for Cortex\-A8 erratum (default) .TP \fB\-\-fix\-cortex\-a53\-843419\fR -(AArch64 only) Fix Cortex\-A53 erratum 843419. +(AArch64 only) Fix Cortex\-A53 erratum 843419 .TP \fB\-\-no\-fix\-cortex\-a53\-843419\fR -(AArch64 only) Do not fix Cortex\-A53 erratum 843419. +(AArch64 only) Do not fix Cortex\-A53 erratum 843419 (default) .TP \fB\-\-fix\-cortex\-a53\-835769\fR -(AArch64 only) Fix Cortex\-A53 erratum 835769. +(AArch64 only) Fix Cortex\-A53 erratum 835769 .TP \fB\-\-no\-fix\-cortex\-a53\-835769\fR -(AArch64 only) Do not fix Cortex\-A53 erratum 835769. -.TP -\fB\-\-fix\-arm1176\fR -(ARM only) Fix binaries for ARM1176 erratum. -.TP -\fB\-\-no\-fix\-arm1176\fR -(ARM only) Do not fix binaries for ARM1176 erratum. -.TP -\fB\-\-merge\-exidx\-entries\fR -(ARM only) Merge exidx entries in debuginfo. -.TP -\fB\-\-no\-merge\-exidx\-entries\fR -(ARM only) Do not merge exidx entries in debuginfo. +(AArch64 only) Do not fix Cortex\-A53 erratum 835769 (default) .TP \fB\-\-fix\-v4bx\fR (ARM only) Rewrite BX rn as MOV pc, rn for ARMv4 @@ -231,14 +231,23 @@ Call SYMBOL at unload\-time \fB\-\-fix\-v4bx\-interworking\fR (ARM only) Rewrite BX rn branch to ARMv4 interworking veneer .TP +\fB\-fuse\-ld\fR +Ignored for GCC linker option compatibility +.TP \fB\-g\fR Ignored .TP +\fB\-\-gc\-sections\fR +Remove unused sections +.TP +\fB\-\-no\-gc\-sections\fR +Don't remove unused sections (default) +.TP \fB\-\-gdb\-index\fR Generate .gdb_index section .TP \fB\-\-no\-gdb\-index\fR -Do not generate .gdb_index section +Do not generate .gdb_index section (default) .TP \fB\-\-gnu\-unique\fR Enable STB_GNU_UNIQUE symbol binding (default) @@ -246,6 +255,9 @@ Enable STB_GNU_UNIQUE symbol binding (default) \fB\-\-no\-gnu\-unique\fR Disable STB_GNU_UNIQUE symbol binding .TP +\fB\-G\fR, \fB\-shared\fR +Generate shared library +.TP \fB\-h\fR FILENAME, \fB\-soname\fR FILENAME Set shared library name .TP @@ -255,8 +267,14 @@ Min fraction of empty buckets in dynamic hash \fB\-\-hash\-style\fR [sysv,gnu,both] Dynamic hash style .TP -\fB\-I\fR PROGRAM, \fB\-\-dynamic\-linker\fR PROGRAM -Set dynamic linker path +\fB\-i\fR +Alias for \fB\-r\fR +.TP +\fB\-\-icf\fR [none,all,safe] +Identical Code Folding. '\-\-icf=safe' Folds ctors, dtors and functions whose pointers are definitely not taken +.TP +\fB\-\-icf\-iterations\fR COUNT +Number of iterations of ICF (default 2) .TP \fB\-\-incremental\fR Do an incremental link if possible; otherwise, do a full link and prepare output for incremental linking @@ -285,61 +303,64 @@ Use timestamps to check files (default) \fB\-\-incremental\-startup\-unchanged\fR Assume startup files unchanged (files preceding this option) .HP -\fB\-\-incremental\-patch\fR PERCENT Amount of extra space to allocate for patches +\fB\-\-incremental\-patch\fR PERCENT Amount of extra space to allocate for patches (default 10) .TP \fB\-init\fR SYMBOL Call SYMBOL at load\-time .TP +\fB\-I\fR PROGRAM, \fB\-\-dynamic\-linker\fR PROGRAM +Set dynamic linker path +.TP \fB\-\-just\-symbols\fR FILE Read only symbol values from FILE .TP -\fB\-\-map\-whole\-files\fR -Map whole files to memory (default on 64\-bit hosts) -.TP -\fB\-\-no\-map\-whole\-files\fR -Map relevant file parts to memory (default on 32\-bit hosts) -.TP \fB\-\-keep\-files\-mapped\fR Keep files mapped across passes (default) .TP \fB\-\-no\-keep\-files\-mapped\fR Release mapped files after each pass .TP +\fB\-\-keep\-unique\fR SYMBOL +Do not fold this symbol during ICF +.TP +\fB\-l\fR LIBNAME, \fB\-\-library\fR LIBNAME +Search for library LIBNAME +.TP \fB\-\-ld\-generated\-unwind\-info\fR Generate unwind information for PLT (default) .TP \fB\-\-no\-ld\-generated\-unwind\-info\fR Do not generate unwind information for PLT .TP -\fB\-l\fR LIBNAME, \fB\-\-library\fR LIBNAME -Search for library LIBNAME -.TP \fB\-L\fR DIR, \fB\-\-library\-path\fR DIR Add directory to search path .TP -\fB\-\-text\-reorder\fR -Enable text section reordering for GCC section names (default) +\fB\-\-long\-plt\fR +(ARM only) Generate long PLT entries .TP -\fB\-\-no\-text\-reorder\fR -Disable text section reordering for GCC section names +\fB\-\-no\-long\-plt\fR +(ARM only) Do not generate long PLT entries (default) .TP -\fB\-nostdlib\fR -Only search directories specified on the command line. +\fB\-m\fR EMULATION +Set GNU linker emulation; obsolete .TP -\fB\-\-rosegment\fR -Put read\-only non\-executable sections in their own segment +\fB\-\-map\-whole\-files\fR +Map whole files to memory (default) .TP -\fB\-\-rosegment\-gap\fR OFFSET -Set offset between executable and read\-only segments +\fB\-\-no\-map\-whole\-files\fR +Map relevant file parts to memory .TP -\fB\-m\fR EMULATION -Set GNU linker emulation; obsolete +\fB\-\-merge\-exidx\-entries\fR +(ARM only) Merge exidx entries in debuginfo (default) +.TP +\fB\-\-no\-merge\-exidx\-entries\fR +(ARM only) Do not merge exidx entries in debuginfo .TP \fB\-\-mmap\-output\-file\fR -Map the output file for writing (default). +Map the output file for writing (default) .TP \fB\-\-no\-mmap\-output\-file\fR -Do not map the output file for writing. +Do not map the output file for writing .TP \fB\-M\fR, \fB\-\-print\-map\fR Write map file on standard output @@ -354,49 +375,52 @@ Do not page align data Do not page align data, do not make text readonly .TP \fB\-\-no\-omagic\fR -Page align data, make text readonly +Page align data, make text readonly (default) .TP -\fB\-\-enable\-new\-dtags\fR -Enable use of DT_RUNPATH and DT_FLAGS +\fB\-\-no\-keep\-memory\fR +Use less memory and more disk I/O (included only for compatibility with GNU ld) .TP -\fB\-\-disable\-new\-dtags\fR -Disable use of DT_RUNPATH and DT_FLAGS +\fB\-\-no\-undefined\fR +Report undefined symbols (even with \fB\-\-shared\fR) .TP \fB\-\-noinhibit\-exec\fR Create an output file even if errors occur .TP -\fB\-\-no\-undefined\fR -Report undefined symbols (even with \fB\-\-shared\fR) +\fB\-nostdlib\fR +Only search directories specified on the command line .TP \fB\-o\fR FILE, \fB\-\-output\fR FILE Set output file name .TP +\fB\-\-oformat\fR [binary] +Set output format +.TP \fB\-O\fR LEVEL, \fB\-optimize\fR LEVEL Optimize output file size .TP -\fB\-\-oformat\fR [binary] -Set output format +\fB\-\-orphan\-handling\fR [place,discard,warn,error] +Orphan section handling .TP \fB\-p\fR -(ARM only) Ignore for backward compatibility +Ignored for ARM compatibility .TP \fB\-pie\fR Create a position independent executable .TP \fB\-no\-pie\fR -Do not create a position independent executable +Do not create a position independent executable (default) .TP \fB\-\-pic\-executable\fR Create a position independent executable .TP \fB\-\-no\-pic\-executable\fR -Do not create a position independent executable +Do not create a position independent executable (default) .TP \fB\-\-pic\-veneer\fR Force PIC sequences for ARM/Thumb interworking veneers .TP \fB\-no\-pipeline\-knowledge\fR -(ARM only) Ignore for backward compatibility +(ARM only) Ignore for backward compatibility (default) .TP \fB\-\-plt\-align\fR [=P2ALIGN] (PowerPC64 only) Align PLT call stubs to fit cache lines @@ -405,13 +429,13 @@ Force PIC sequences for ARM/Thumb interworking veneers (PowerPC64 only) PLT call stubs should load r11 .TP \fB\-\-no\-plt\-static\-chain\fR -(PowerPC64 only) PLT call stubs should not load r11 +(PowerPC64 only) PLT call stubs should not load r11 (default) .TP \fB\-\-plt\-thread\-safe\fR (PowerPC64 only) PLT call stubs with load\-load barrier .TP \fB\-\-no\-plt\-thread\-safe\fR -(PowerPC64 only) PLT call stubs without barrier +(PowerPC64 only) PLT call stubs without barrier (default) .TP \fB\-\-plugin\fR PLUGIN Load a plugin library @@ -420,38 +444,59 @@ Load a plugin library Pass an option to the plugin .TP \fB\-\-posix\-fallocate\fR -Use posix_fallocate to reserve space in the output file (default). +Use posix_fallocate to reserve space in the output file (default) .TP \fB\-\-no\-posix\-fallocate\fR -Use fallocate or ftruncate to reserve space. +Use fallocate or ftruncate to reserve space .TP \fB\-\-preread\-archive\-symbols\fR Preread archive symbols when multi\-threaded .TP +\fB\-\-print\-gc\-sections\fR +List removed unused sections on stderr +.TP +\fB\-\-no\-print\-gc\-sections\fR +Do not list removed unused sections (default) +.TP +\fB\-\-print\-icf\-sections\fR +List folded identical sections on stderr +.TP +\fB\-\-no\-print\-icf\-sections\fR +Do not list folded identical sections (default) +.TP \fB\-\-print\-output\-format\fR Print default output format .TP \fB\-\-print\-symbol\-counts\fR FILENAME Print symbols defined and used for each input .TP -\fB\-Qy\fR -Ignored for SVR4 compatibility +\fB\-\-push\-state\fR +Save the state of flags related to input files +.TP +\fB\-\-pop\-state\fR +Restore the state of flags related to input files .TP \fB\-q\fR, \fB\-\-emit\-relocs\fR Generate relocations in output .TP +\fB\-Qy\fR +Ignored for SVR4 compatibility +.TP \fB\-r\fR, \fB\-relocatable\fR Generate relocatable output .TP -\fB\-i\fR -Synonym for \fB\-r\fR -.TP \fB\-\-relax\fR Relax branches on certain targets .TP \fB\-\-retain\-symbols\-file\fR FILE keep only symbols listed in this file .TP +\fB\-\-rosegment\fR +Put read\-only non\-executable sections in their own segment +.TP +\fB\-\-rosegment\-gap\fR OFFSET +Set offset between executable and read\-only segments +.TP \fB\-R\fR DIR Add DIR to runtime search path .TP @@ -461,21 +506,6 @@ Add DIR to runtime search path \fB\-\-rpath\-link\fR DIR Add DIR to link time shared library search path .TP -\fB\-\-section\-ordering\-file\fR FILENAME -Layout sections in the order specified. -.TP -\fB\-\-section\-start\fR SECTION=ADDRESS -Set address of section -.TP -\fB\-\-sort\-common\fR [={ascending,descending}] -Sort common symbols by alignment -.TP -\fB\-\-sort\-section\fR [none,name] -Sort sections by name. '\-\-no\-text\-reorder' will override '\-\-sort\-section=name' for .text -.TP -\fB\-\-spare\-dynamic\-tags\fR COUNT -Dynamic tag slots to reserve (default 5) -.TP \fB\-s\fR, \fB\-\-strip\-all\fR Strip all symbols .TP @@ -489,52 +519,43 @@ Emit only debug line number information Strip debug symbols that are unused by gdb (at least versions <= 7.4) .TP \fB\-\-strip\-lto\-sections\fR -Strip LTO intermediate code sections -.TP -\fB\-\-stub\-group\-size\fR SIZE -(ARM, PowerPC only) The maximum distance from instructions in a group of sections to their stubs. Negative values mean stubs are always after (PowerPC before) the group. 1 means use default size. -.TP -\fB\-\-no\-keep\-memory\fR -Use less memory and more disk I/O (included only for compatibility with GNU ld) +Strip LTO intermediate code sections (default) .TP -\fB\-G\fR, \fB\-shared\fR -Generate shared library -.TP -\fB\-Bshareable\fR -Generate shared library +\fB\-\-section\-ordering\-file\fR FILENAME +Layout sections in the order specified .TP -\fB\-\-split\-stack\-adjust\-size\fR SIZE -Stack size when \fB\-fsplit\-stack\fR function calls non\-split +\fB\-\-section\-start\fR SECTION=ADDRESS +Set address of section .TP -\fB\-static\fR -Do not link against shared libraries +\fB\-\-secure\-plt\fR +(PowerPC only) Use new\-style PLT (default) .TP -\fB\-\-icf\fR [none,all,safe] -Identical Code Folding. '\-\-icf=safe' Folds ctors, dtors and functions whose pointers are definitely not taken. +\fB\-\-sort\-common\fR [={ascending,descending}] +Sort common symbols by alignment .TP -\fB\-\-icf\-iterations\fR COUNT -Number of iterations of ICF (default 2) +\fB\-\-sort\-section\fR [none,name] +Sort sections by name. '\-\-no\-text\-reorder' will override '\-\-sort\-section=name' for .text .TP -\fB\-\-print\-icf\-sections\fR -List folded identical sections on stderr +\fB\-\-spare\-dynamic\-tags\fR COUNT +Dynamic tag slots to reserve (default 5) .TP -\fB\-\-no\-print\-icf\-sections\fR -Do not list folded identical sections +\fB\-\-stub\-group\-size\fR SIZE +(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 .TP -\fB\-\-keep\-unique\fR SYMBOL -Do not fold this symbol during ICF +\fB\-\-stub\-group\-multi\fR +(PowerPC only) Allow a group of stubs to serve multiple output sections .TP -\fB\-\-gc\-sections\fR -Remove unused sections +\fB\-\-split\-stack\-adjust\-size\fR SIZE +Stack size when \fB\-fsplit\-stack\fR function calls non\-split .TP -\fB\-\-no\-gc\-sections\fR -Don't remove unused sections (default) +\fB\-static\fR +Do not link against shared libraries .TP -\fB\-\-print\-gc\-sections\fR -List removed unused sections on stderr +\fB\-\-start\-lib\fR +Start a library .TP -\fB\-\-no\-print\-gc\-sections\fR -Do not list removed unused sections +\fB\-\-end\-lib\fR +End a library .TP \fB\-\-stats\fR Print resource usage statistics @@ -545,14 +566,26 @@ Set target system root directory \fB\-t\fR, \fB\-\-trace\fR Print the name of each input file .TP -\fB\-T\fR FILE, \fB\-\-script\fR FILE -Read linker script +\fB\-\-target1\-abs\fR +(ARM only) Force R_ARM_TARGET1 type to R_ARM_ABS32 +.TP +\fB\-\-target1\-rel\fR +(ARM only) Force R_ARM_TARGET1 type to R_ARM_REL32 +.TP +\fB\-\-target2\fR [rel, abs, got\-rel +(ARM only) Set R_ARM_TARGET2 relocation type +.TP +\fB\-\-text\-reorder\fR +Enable text section reordering for GCC section names (default) +.TP +\fB\-\-no\-text\-reorder\fR +Disable text section reordering for GCC section names .TP \fB\-\-threads\fR Run the linker multi\-threaded .TP \fB\-\-no\-threads\fR -Do not run the linker multi\-threaded +Do not run the linker multi\-threaded (default) .TP \fB\-\-thread\-count\fR COUNT Number of threads to use @@ -565,6 +598,21 @@ Number of threads to use in initial pass \fB\-\-thread\-count\-final\fR COUNT Number of threads to use in final pass .TP +\fB\-\-toc\-optimize\fR +(PowerPC64 only) Optimize TOC code sequences (default) +.TP +\fB\-\-no\-toc\-optimize\fR +(PowerPC64 only) Don't optimize TOC code sequences +.TP +\fB\-\-toc\-sort\fR +(PowerPC64 only) Sort TOC and GOT sections (default) +.TP +\fB\-\-no\-toc\-sort\fR +(PowerPC64 only) Don't sort TOC and GOT sections +.TP +\fB\-T\fR FILE, \fB\-\-script\fR FILE +Read linker script +.TP \fB\-Tbss\fR ADDRESS Set the address of the bss segment .TP @@ -580,18 +628,6 @@ Set the address of the text segment \fB\-Trodata\-segment\fR ADDRESS Set the address of the rodata segment .TP -\fB\-\-toc\-optimize\fR -(PowerPC64 only) Optimize TOC code sequences -.TP -\fB\-\-no\-toc\-optimize\fR -(PowerPC64 only) Don't optimize TOC code sequences -.TP -\fB\-\-toc\-sort\fR -(PowerPC64 only) Sort TOC and GOT sections -.TP -\fB\-\-no\-toc\-sort\fR -(PowerPC64 only) Don't sort TOC and GOT sections -.TP \fB\-u\fR SYMBOL, \fB\-\-undefined\fR SYMBOL Create undefined reference to SYMBOL .TP @@ -599,7 +635,7 @@ Create undefined reference to SYMBOL How to handle unresolved symbols .TP \fB\-\-verbose\fR -Synonym for \fB\-\-debug\fR=\fI\,files\/\fR +Alias for \fB\-\-debug\fR=\fI\,files\/\fR .TP \fB\-\-version\-script\fR FILE Read version script @@ -629,7 +665,7 @@ Don't warn about mismatched input files Ignored .TP \fB\-\-warn\-search\-mismatch\fR -Warn when skipping an incompatible library +Warn when skipping an incompatible library (default) .TP \fB\-\-no\-warn\-search\-mismatch\fR Don't warn when skipping an incompatible library @@ -644,23 +680,35 @@ Do not warn if text segment is not shareable (default) Report unresolved symbols as warnings .TP \fB\-\-error\-unresolved\-symbols\fR -Report unresolved symbols as errors +Report unresolved symbols as errors (default) .TP -\fB\-\-weak\-unresolved\-symbols\fR -Convert unresolved symbols to weak references +\fB\-z\fR buildd +Dummy z option .TP \fB\-\-no\-wchar\-size\-warning\fR (ARM only) Do not warn about objects with incompatible wchar_t sizes .TP +\fB\-\-weak\-unresolved\-symbols\fR +Convert unresolved symbols to weak references +.TP \fB\-\-whole\-archive\fR Include all archive contents .TP \fB\-\-no\-whole\-archive\fR -Include only needed archive contents +Include only needed archive contents (default) .TP \fB\-\-wrap\fR SYMBOL Use wrapper functions for SYMBOL .TP +\fB\-x\fR, \fB\-\-discard\-all\fR +Delete all local symbols +.TP +\fB\-X\fR, \fB\-\-discard\-locals\fR +Delete all temporary local symbols +.TP +\fB\-\-discard\-none\fR +Keep all local symbols +.TP \fB\-y\fR SYMBOL, \fB\-\-trace\-symbol\fR SYMBOL Trace references to symbol .TP @@ -679,17 +727,14 @@ Start a library search group \-), \fB\-\-end\-group\fR End a library search group .TP -\fB\-\-start\-lib\fR -Start a library +\fB\-z\fR bndplt +(x86\-64 only) Generate a BND PLT for Intel MPX .TP -\fB\-\-end\-lib\fR -End a library -.TP -\fB\-fuse\-ld\fR -Ignored for GCC linker option compatibility +\fB\-z\fR nobndplt +Generate a regular PLT (default) .TP \fB\-z\fR combreloc -Sort dynamic relocs +Sort dynamic relocs (default) .TP \fB\-z\fR nocombreloc Do not sort dynamic relocs @@ -749,11 +794,14 @@ Mark object for immediate function binding Mark DSO to indicate that needs immediate $ORIGIN processing at runtime .TP \fB\-z\fR relro -Where possible mark variables read\-only after relocation +Where possible mark variables read\-only after relocation (default) .TP \fB\-z\fR norelro Don't mark variables read\-only after relocation .TP +\fB\-z\fR stack\-size=SIZE +Set PT_GNU_STACK segment p_memsz to SIZE +.TP \fB\-z\fR text Do not permit relocations in read\-only segments .TP @@ -762,16 +810,13 @@ Permit relocations in read\-only segments (default) .TP \fB\-z\fR textoff Permit relocations in read\-only segments (default) -.TP -\fB\-z\fR buildd -Dummy z option .PP 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 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 .SH "REPORTING BUGS" Report bugs to <http://www.sourceware.org/bugzilla/> .SH COPYRIGHT -Copyright \(co 2015 Free Software Foundation, Inc. +Copyright \(co 2017 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. |