binutils-source 2.24-5ubuntu3 / usr / src / binutils / debian / ld.gold.1

.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.44.1.
.TH GOLD "1" "April 2014" "gold (GNU Binutils for Ubuntu 2.24) 1.11" "User Commands"
.SH NAME
gold \- The GNU ELF linker
.SH SYNOPSIS
.B ld.gold
[\fIoptions\fR] \fIfile\fR...
.SH OPTIONS
.TP
\fB\-\-help\fR
Report usage information
.TP
\fB\-v\fR, \fB\-\-version\fR
Report version information
.TP
\fB\-V\fR
Report version and target information
.TP
\fB\-\-add\-needed\fR
Not supported
.TP
\fB\-\-no\-add\-needed\fR
Do not copy DT_NEEDED tags from shared libraries
.HP
\fB\-\-allow\-multiple\-definition\fR Allow multiple definitions of symbols
.TP
\fB\-\-no\-allow\-multiple\-definition\fR
Do not allow multiple definitions
.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
.TP
\fB\-\-as\-needed\fR
Only set DT_NEEDED for shared libraries if used
.TP
\fB\-\-no\-as\-needed\fR
Always DT_NEEDED for shared libraries
.TP
\fB\-assert\fR [ignored]
Ignored
.TP
\fB\-b\fR [elf,binary], \fB\-\-format\fR [elf,binary]
Set input format
.HP
\fB\-Bdynamic\fR                   \fB\-l\fR searches for shared libraries
.HP
\fB\-Bstatic\fR                    \fB\-l\fR does not search for shared libraries
.TP
\fB\-dy\fR
alias for \fB\-Bdynamic\fR
.TP
\fB\-dn\fR
alias for \fB\-Bstatic\fR
.TP
\fB\-Bgroup\fR
Use group name lookup rules for shared library
.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
\fB\-\-no\-check\-sections\fR
Do not check segment addresses for overlaps
.TP
\fB\-\-compress\-debug\-sections\fR [none,zlib]
Compress .debug_* sections in the output file
.TP
\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
.TP
\fB\-\-cref\fR
Output cross reference table
.TP
\fB\-\-no\-cref\fR
Do not output cross reference table
.TP
\fB\-\-ctors\-in\-init\-array\fR
Use DT_INIT_ARRAY for all constructors (default)
.TP
\fB\-\-no\-ctors\-in\-init\-array\fR
Handle constructors as directed by compiler
.TP
\fB\-d\fR, \fB\-\-define\-common\fR
Define common symbols
.TP
\fB\-\-no\-define\-common\fR
Do not define common symbols
.TP
\fB\-dc\fR
Alias for \fB\-d\fR
.TP
\fB\-dp\fR
Alias for \fB\-d\fR
.TP
\fB\-\-debug\fR [all,files,script,task][,...]
Turn on debugging
.TP
\fB\-\-defsym\fR SYMBOL=EXPRESSION
Define a symbol
.TP
\fB\-\-demangle\fR [=STYLE]
Demangle C++ symbols in log messages
.TP
\fB\-\-no\-demangle\fR
Do not demangle C++ symbols in log messages
.TP
\fB\-\-detect\-odr\-violations\fR
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\-\-dynamic\-list\-data\fR
Add data symbols to dynamic symbols
.TP
\fB\-\-dynamic\-list\-cpp\-new\fR
Add C++ operator new/delete to dynamic symbols
.HP
\fB\-\-dynamic\-list\-cpp\-typeinfo\fR Add C++ typeinfo to dynamic symbols
.TP
\fB\-\-dynamic\-list\fR FILE
Read a list of dynamic symbols
.HP
\fB\-e\fR ADDRESS, \fB\-\-entry\fR ADDRESS Set program start address
.TP
\fB\-\-exclude\-libs\fR lib,lib ...
Exclude libraries from automatic export
.TP
\fB\-E\fR, \fB\-\-export\-dynamic\fR
Export all dynamic symbols
.TP
\fB\-\-no\-export\-dynamic\fR
Do not export all dynamic symbols (default)
.TP
\fB\-\-export\-dynamic\-symbol\fR SYMBOL
Export SYMBOL to dynamic symbol table
.TP
\fB\-EB\fR
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
\fB\-F\fR SHLIB, \fB\-\-filter\fR SHLIB
Filter for shared object symbol table
.TP
\fB\-\-fatal\-warnings\fR
Treat warnings as errors
.TP
\fB\-\-no\-fatal\-warnings\fR
Do not treat warnings as errors
.TP
\fB\-fini\fR SYMBOL
Call SYMBOL at unload\-time
.TP
\fB\-\-fix\-cortex\-a8\fR
(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.
.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.
.TP
\fB\-\-fix\-v4bx\fR
(ARM only) Rewrite BX rn as MOV pc, rn for ARMv4
.TP
\fB\-\-fix\-v4bx\-interworking\fR
(ARM only) Rewrite BX rn branch to ARMv4 interworking veneer
.TP
\fB\-g\fR
Ignored
.TP
\fB\-\-gdb\-index\fR
Generate .gdb_index section
.TP
\fB\-\-no\-gdb\-index\fR
Do not generate .gdb_index section
.TP
\fB\-\-gnu\-unique\fR
Enable STB_GNU_UNIQUE symbol binding (default)
.TP
\fB\-\-no\-gnu\-unique\fR
Disable STB_GNU_UNIQUE symbol binding
.TP
\fB\-h\fR FILENAME, \fB\-soname\fR FILENAME
Set shared library name
.TP
\fB\-\-hash\-bucket\-empty\-fraction\fR FRACTION
Min fraction of empty buckets in dynamic hash
.TP
\fB\-\-hash\-style\fR [sysv,gnu,both]
Dynamic hash style
.TP
\fB\-I\fR PROGRAM, \fB\-\-dynamic\-linker\fR PROGRAM
Set dynamic linker path
.TP
\fB\-\-incremental\fR
Do an incremental link if possible; otherwise, do a full link and prepare output for incremental linking
.TP
\fB\-\-no\-incremental\fR
Do a full link (default)
.TP
\fB\-\-incremental\-full\fR
Do a full link and prepare output for incremental linking
.TP
\fB\-\-incremental\-update\fR
Do an incremental link; exit if not possible
.TP
\fB\-\-incremental\-base\fR FILE
Set base file for incremental linking (default is output file)
.TP
\fB\-\-incremental\-changed\fR
Assume files changed
.TP
\fB\-\-incremental\-unchanged\fR
Assume files didn't change
.TP
\fB\-\-incremental\-unknown\fR
Use timestamps to check files (default)
.TP
\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
.TP
\fB\-init\fR SYMBOL
Call SYMBOL at load\-time
.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\-\-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)
.TP
\fB\-\-no\-text\-reorder\fR
Disable text section reordering for GCC section names
.TP
\fB\-nostdlib\fR
Only search directories specified on the command line.
.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\-m\fR EMULATION
Set GNU linker emulation; obsolete
.TP
\fB\-\-mmap\-output\-file\fR
Map the output file for writing (default).
.TP
\fB\-\-no\-mmap\-output\-file\fR
Do not map the output file for writing.
.TP
\fB\-M\fR, \fB\-\-print\-map\fR
Write map file on standard output
.TP
\fB\-Map\fR MAPFILENAME
Write map file
.TP
\fB\-n\fR, \fB\-\-nmagic\fR
Do not page align data
.TP
\fB\-N\fR, \fB\-\-omagic\fR
Do not page align data, do not make text readonly
.TP
\fB\-\-no\-omagic\fR
Page align data, make text readonly
.TP
\fB\-\-enable\-new\-dtags\fR
Enable use of DT_RUNPATH and DT_FLAGS
.TP
\fB\-\-disable\-new\-dtags\fR
Disable use of DT_RUNPATH and DT_FLAGS
.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)
.TP
\fB\-o\fR FILE, \fB\-\-output\fR FILE
Set output file name
.TP
\fB\-O\fR LEVEL, \fB\-optimize\fR LEVEL
Optimize output file size
.TP
\fB\-\-oformat\fR [binary]
Set output format
.TP
\fB\-p\fR
(ARM only) Ignore for backward compatibility
.TP
\fB\-pie\fR
Create a position independent executable
.TP
\fB\-\-pic\-executable\fR
Create a position independent executable
.TP
\fB\-no\-pipeline\-knowledge\fR
(ARM only) Ignore for backward compatibility
.TP
\fB\-\-plt\-align\fR [=P2ALIGN]
(PowerPC64 only) Align PLT call stubs to fit cache lines
.TP
\fB\-\-plt\-static\-chain\fR
(PowerPC64 only) PLT call stubs should load r11
.TP
\fB\-\-no\-plt\-static\-chain\fR
(PowerPC64 only) PLT call stubs should not load r11
.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
.TP
\fB\-\-plugin\fR PLUGIN
Load a plugin library
.TP
\fB\-\-plugin\-opt\fR OPTION
Pass an option to the plugin
.TP
\fB\-\-posix\-fallocate\fR
Use posix_fallocate to reserve space in the output file (default).
.TP
\fB\-\-no\-posix\-fallocate\fR
Use fallocate or ftruncate to reserve space.
.TP
\fB\-\-preread\-archive\-symbols\fR
Preread archive symbols when multi\-threaded
.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
.TP
\fB\-q\fR, \fB\-\-emit\-relocs\fR
Generate relocations in output
.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\-R\fR DIR
Add DIR to runtime search path
.TP
\fB\-rpath\fR DIR
Add DIR to runtime search path
.TP
\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
\fB\-S\fR, \fB\-\-strip\-debug\fR
Strip debugging information
.TP
\fB\-\-strip\-debug\-non\-line\fR
Emit only debug line number information
.TP
\fB\-\-strip\-debug\-gdb\fR
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)
.TP
\fB\-G\fR, \fB\-shared\fR
Generate shared library
.TP
\fB\-Bshareable\fR
Generate shared library
.TP
\fB\-\-split\-stack\-adjust\-size\fR SIZE
Stack size when \fB\-fsplit\-stack\fR function calls non\-split
.TP
\fB\-static\fR
Do not link against shared libraries
.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\-\-print\-icf\-sections\fR
List folded identical sections on stderr
.TP
\fB\-\-no\-print\-icf\-sections\fR
Do not list folded identical sections
.TP
\fB\-\-keep\-unique\fR SYMBOL
Do not fold this symbol during ICF
.TP
\fB\-\-gc\-sections\fR
Remove unused sections
.TP
\fB\-\-no\-gc\-sections\fR
Don't remove unused sections (default)
.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
.TP
\fB\-\-stats\fR
Print resource usage statistics
.TP
\fB\-\-sysroot\fR DIR
Set target system root directory
.TP
\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
.TP
\fB\-\-threads\fR
Run the linker multi\-threaded
.TP
\fB\-\-no\-threads\fR
Do not run the linker multi\-threaded
.TP
\fB\-\-thread\-count\fR COUNT
Number of threads to use
.TP
\fB\-\-thread\-count\-initial\fR COUNT
Number of threads to use in initial pass
.HP
\fB\-\-thread\-count\-middle\fR COUNT Number of threads to use in middle pass
.TP
\fB\-\-thread\-count\-final\fR COUNT
Number of threads to use in final pass
.TP
\fB\-Tbss\fR ADDRESS
Set the address of the bss segment
.TP
\fB\-Tdata\fR ADDRESS
Set the address of the data segment
.TP
\fB\-Ttext\fR ADDRESS
Set the address of the text segment
.TP
\fB\-Ttext\-segment\fR ADDRESS
Set the address of the text segment
.TP
\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
\fB\-\-unresolved\-symbols\fR ignore\-all,report\-all,ignore\-in\-object\-files,ignore\-in\-shared\-libs
How to handle unresolved symbols
.TP
\fB\-\-verbose\fR
Synonym for \fB\-\-debug\fR=\fIfiles\fR
.TP
\fB\-\-version\-script\fR FILE
Read version script
.TP
\fB\-\-warn\-common\fR
Warn about duplicate common symbols
.TP
\fB\-\-no\-warn\-common\fR
Do not warn about duplicate common symbols (default)
.TP
\fB\-\-warn\-constructors\fR
Ignored
.TP
\fB\-\-no\-warn\-constructors\fR
Ignored
.TP
\fB\-\-warn\-execstack\fR
Warn if the stack is executable
.TP
\fB\-\-no\-warn\-execstack\fR
Do not warn if the stack is executable (default)
.TP
\fB\-\-no\-warn\-mismatch\fR
Don't warn about mismatched input files
.TP
\fB\-\-warn\-multiple\-gp\fR
Ignored
.TP
\fB\-\-warn\-search\-mismatch\fR
Warn when skipping an incompatible library
.TP
\fB\-\-no\-warn\-search\-mismatch\fR
Don't warn when skipping an incompatible library
.TP
\fB\-\-warn\-shared\-textrel\fR
Warn if text segment is not shareable
.TP
\fB\-\-no\-warn\-shared\-textrel\fR
Do not warn if text segment is not shareable (default)
.TP
\fB\-\-warn\-unresolved\-symbols\fR
Report unresolved symbols as warnings
.TP
\fB\-\-error\-unresolved\-symbols\fR
Report unresolved symbols as errors
.TP
\fB\-\-no\-wchar\-size\-warning\fR
(ARM only) Do not warn about objects with incompatible wchar_t sizes
.TP
\fB\-\-whole\-archive\fR
Include all archive contents
.TP
\fB\-\-no\-whole\-archive\fR
Include only needed archive contents
.TP
\fB\-\-wrap\fR SYMBOL
Use wrapper functions for SYMBOL
.TP
\fB\-y\fR SYMBOL, \fB\-\-trace\-symbol\fR SYMBOL
Trace references to symbol
.TP
\fB\-\-undefined\-version\fR
Allow unused version in script (default)
.TP
\fB\-\-no\-undefined\-version\fR
Do not allow unused version in script
.TP
\fB\-Y\fR PATH
Default search path for Solaris compatibility
.TP
\-(, \fB\-\-start\-group\fR
Start a library search group
.TP
\-), \fB\-\-end\-group\fR
End a library search group
.TP
\fB\-\-start\-lib\fR
Start a library
.TP
\fB\-\-end\-lib\fR
End a library
.TP
\fB\-fuse\-ld\fR
Ignored for GCC linker option compatibility
.TP
\fB\-z\fR combreloc
Sort dynamic relocs
.TP
\fB\-z\fR nocombreloc
Do not sort dynamic relocs
.TP
\fB\-z\fR common\-page\-size=SIZE
Set common page size to SIZE
.TP
\fB\-z\fR defs
Report undefined symbols (even with \fB\-\-shared\fR)
.TP
\fB\-z\fR execstack
Mark output as requiring executable stack
.TP
\fB\-z\fR initfirst
Mark DSO to be initialized first at runtime
.TP
\fB\-z\fR interpose
Mark object to interpose all DSOs but executable
.TP
\fB\-z\fR lazy
Mark object for lazy runtime binding (default)
.TP
\fB\-z\fR loadfltr
Mark object requiring immediate process
.TP
\fB\-z\fR max\-page\-size=SIZE
Set maximum page size to SIZE
.TP
\fB\-z\fR muldefs
Allow multiple definitions of symbols
.TP
\fB\-z\fR nocopyreloc
Do not create copy relocs
.TP
\fB\-z\fR nodefaultlib
Mark object not to use default search paths
.TP
\fB\-z\fR nodelete
Mark DSO non\-deletable at runtime
.TP
\fB\-z\fR nodlopen
Mark DSO not available to dlopen
.TP
\fB\-z\fR nodump
Mark DSO not available to dldump
.TP
\fB\-z\fR noexecstack
Mark output as not requiring executable stack
.TP
\fB\-z\fR now
Mark object for immediate function binding
.TP
\fB\-z\fR origin
Mark DSO to indicate that needs immediate $ORIGIN processing at runtime
.TP
\fB\-z\fR relro
Where possible mark variables read\-only after relocation
.TP
\fB\-z\fR norelro
Don't mark variables read\-only after relocation
.TP
\fB\-z\fR text
Do not permit relocations in read\-only segments
.TP
\fB\-z\fR notext
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\-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_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 2013 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.