GOLD(1) User Commands GOLD(1)
NAME
gold - manual page for gold (GNU Binutils for Ubuntu 2.21.53.20110810) 1.11
SYNOPSIS
ld.gold [options] file...
OPTIONS
--help Report usage information
-v, --version
Report version information
-V Report version and target information
--add-needed
Not supported
--no-add-needed
Do not copy DT_NEEDED tags from shared libraries
--allow-multiple-definition Allow multiple definitions of symbols
--no-allow-multiple-definition
Do not allow multiple definitions
--allow-shlib-undefined
Allow unresolved references in shared libraries
--no-allow-shlib-undefined
Do not allow unresolved references in shared libraries
--as-needed
Only set DT_NEEDED for shared libraries if used
--no-as-needed
Always DT_NEEDED for shared libraries
-assert [ignored]
Ignored
-b [elf,binary], --format [elf,binary]
Set input format
-Bdynamic -l searches for shared libraries
-Bstatic -l does not search for shared libraries
-dy alias for -Bdynamic
-dn alias for -Bstatic
-Bgroup
Use group name lookup rules for shared library
-Bsymbolic
Bind defined symbols locally
-Bsymbolic-functions
Bind defined function symbols locally
--build-id [=STYLE]
Generate build ID note
--check-sections
Check segment addresses for overlaps (default)
--no-check-sections
Do not check segment addresses for overlaps
--compress-debug-sections [none,zlib]
Compress .debug_* sections in the output file
--copy-dt-needed-entries
Not supported
--no-copy-dt-needed-entries Do not copy DT_NEEDED tags from shared libraries
--cref
Output cross reference table
--no-cref
Do not output cross reference table
--ctors-in-init-array
Use DT_INIT_ARRAY for all constructors (default)
--no-ctors-in-init-array
Handle constructors as directed by compiler
-d, --define-common
Define common symbols
--no-define-common
Do not define common symbols
-dc Alias for -d
-dp Alias for -d
--debug [all,files,script,task][,...]
Turn on debugging
--defsym SYMBOL=EXPRESSION
Define a symbol
--demangle [=STYLE]
Demangle C++ symbols in log messages
--no-demangle
Do not demangle C++ symbols in log messages
--detect-odr-violations
Look for violations of the C++ One Definition Rule
--no-detect-odr-violations
Do not look for violations of the C++ One Definition Rule
-x, --discard-all
Delete all local symbols
-X, --discard-locals
Delete all temporary local symbols
--dynamic-list-data
Add data symbols to dynamic symbols
--dynamic-list-cpp-new
Add C++ operator new/delete to dynamic symbols
--dynamic-list-cpp-typeinfo Add C++ typeinfo to dynamic symbols
--dynamic-list FILE
Read a list of dynamic symbols
-e ADDRESS, --entry ADDRESS Set program start address
--exclude-libs lib,lib ...
Exclude libraries from automatic export
-E, --export-dynamic
Export all dynamic symbols
--no-export-dynamic
Do not export all dynamic symbols (default)
-EB Link big-endian objects.
-EL Link little-endian objects.
--eh-frame-hdr
Create exception frame header
--no-enum-size-warning
(ARM only) Do not warn about objects with incompatible enum sizes
-f SHLIB, --auxiliary SHLIB Auxiliary filter for shared object symbol table
-F SHLIB, --filter SHLIB
Filter for shared object symbol table
--fatal-warnings
Treat warnings as errors
--no-fatal-warnings
Do not treat warnings as errors
-fini SYMBOL
Call SYMBOL at unload-time
--fix-cortex-a8
(ARM only) Fix binaries for Cortex-A8 erratum.
--no-fix-cortex-a8
(ARM only) Do not fix binaries for Cortex-A8 erratum.
--merge-exidx-entries
(ARM only) Merge exidx entries in debuginfo.
--no-merge-exidx-entries
(ARM only) Do not merge exidx entries in debuginfo.
--fix-v4bx
(ARM only) Rewrite BX rn as MOV pc, rn for ARMv4
--fix-v4bx-interworking
(ARM only) Rewrite BX rn branch to ARMv4 interworking veneer
-g Ignored
-h FILENAME, -soname FILENAME
Set shared library name
--hash-bucket-empty-fraction FRACTION
Min fraction of empty buckets in dynamic hash
--hash-style [sysv,gnu,both]
Dynamic hash style
-I PROGRAM, --dynamic-linker PROGRAM
Set dynamic linker path
--incremental
Do an incremental link if possible; otherwise, do a full link and prepare output for incremental linking
--no-incremental
Do a full link (default)
--incremental-full
Do a full link and prepare output for incremental linking
--incremental-update
Do an incremental link; exit if not possible
--incremental-base FILE
Set base file for incremental linking (default is output file)
--incremental-changed
Assume files changed
--incremental-unchanged
Assume files didn't change
--incremental-unknown
Use timestamps to check files (default)
--incremental-startup-unchanged
Assume startup files unchanged (files preceding this option)
--incremental-patch PERCENT Amount of extra space to allocate for patches
-init SYMBOL
Call SYMBOL at load-time
--just-symbols FILE
Read only symbol values from FILE
--map-whole-files
Map whole files to memory (default on 64-bit hosts)
--no-map-whole-files
Map relevant file parts to memory (default on 32-bit hosts)
--keep-files-mapped
Keep files mapped across passes (default)
--no-keep-files-mapped
Release mapped files after each pass
--ld-generated-unwind-info
Generate unwind information for PLT (default)
--no-ld-generated-unwind-info
Do not generate unwind information for PLT
-l LIBNAME, --library LIBNAME
Search for library LIBNAME
-L DIR, --library-path DIR
Add directory to search path
-nostdlib
Only search directories specified on the command line.
--rosegment
Put read-only non-executable sections in their own segment
-m EMULATION
Set GNU linker emulation; obsolete
-M, --print-map
Write map file on standard output
-Map MAPFILENAME
Write map file
-n, --nmagic
Do not page align data
-N, --omagic
Do not page align data, do not make text readonly
--no-omagic
Page align data, make text readonly
--enable-new-dtags
Enable use of DT_RUNPATH and DT_FLAGS
--disable-new-dtags
Disable use of DT_RUNPATH and DT_FLAGS
--noinhibit-exec
Create an output file even if errors occur
--no-undefined
Report undefined symbols (even with --shared)
-o FILE, --output FILE
Set output file name
-O LEVEL, -optimize LEVEL
Optimize output file size
--oformat [binary]
Set output format
-p (ARM only) Ignore for backward compatibility
-pie Create a position independent executable
--pic-executable
Create a position independent executable
-no-pipeline-knowledge
(ARM only) Ignore for backward compatibility
--plugin PLUGIN
Load a plugin library
--plugin-opt OPTION
Pass an option to the plugin
--preread-archive-symbols
Preread archive symbols when multi-threaded
--print-output-format
Print default output format
--print-symbol-counts FILENAME
Print symbols defined and used for each input
-Qy Ignored for SVR4 compatibility
-q, --emit-relocs
Generate relocations in output
-r, -relocatable
Generate relocatable output
-i Synonym for -r
--relax
Relax branches on certain targets
--retain-symbols-file FILE
keep only symbols listed in this file
-R DIR Add DIR to runtime search path
-rpath DIR
Add DIR to runtime search path
--rpath-link DIR
Add DIR to link time shared library search path
--section-ordering-file FILENAME
Layout sections in the order specified.
--section-start SECTION=ADDRESS
Set address of section
--sort-common [={ascending,descending}]
Sort common symbols by alignment
--spare-dynamic-tags COUNT
Dynamic tag slots to reserve (default 5)
-s, --strip-all
Strip all symbols
-S, --strip-debug
Strip debugging information
--strip-debug-non-line
Emit only debug line number information
--strip-debug-gdb
Strip debug symbols that are unused by gdb (at least versions <= 6.7)
--strip-lto-sections
Strip LTO intermediate code sections
--stub-group-size SIZE
(ARM 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 using default size.
--no-keep-memory
Use less memory and more disk I/O (included only for compatibility with GNU ld)
-G, -shared
Generate shared library
-Bshareable
Generate shared library
--split-stack-adjust-size SIZE
Stack size when -fsplit-stack function calls non-split
-static
Do not link against shared libraries
--icf [none,all,safe]
Identical Code Folding. '--icf=safe' Folds ctors, dtors and functions whose pointers are definitely not taken.
--icf-iterations COUNT
Number of iterations of ICF (default 2)
--print-icf-sections
List folded identical sections on stderr
--no-print-icf-sections
Do not list folded identical sections
--keep-unique SYMBOL
Do not fold this symbol during ICF
--gc-sections
Remove unused sections
--no-gc-sections
Don't remove unused sections (default)
--print-gc-sections
List removed unused sections on stderr
--no-print-gc-sections
Do not list removed unused sections
--stats
Print resource usage statistics
--sysroot DIR
Set target system root directory
-t, --trace
Print the name of each input file
-T FILE, --script FILE
Read linker script
--threads
Run the linker multi-threaded
--no-threads
Do not run the linker multi-threaded
--thread-count COUNT
Number of threads to use
--thread-count-initial COUNT
Number of threads to use in initial pass
--thread-count-middle COUNT Number of threads to use in middle pass
--thread-count-final COUNT
Number of threads to use in final pass
-Tbss ADDRESS
Set the address of the bss segment
-Tdata ADDRESS
Set the address of the data segment
-Ttext ADDRESS
Set the address of the text segment
-u SYMBOL, --undefined SYMBOL
Create undefined reference to SYMBOL
--unresolved-symbols ignore-all,report-all,ignore-in-object-files,ignore-in-shared-libs
How to handle unresolved symbols
--verbose
Synonym for --debug=files
--version-script FILE
Read version script
--warn-common
Warn about duplicate common symbols
--no-warn-common
Do not warn about duplicate common symbols (default)
--warn-constructors
Ignored
--no-warn-constructors
Ignored
--warn-execstack
Warn if the stack is executable
--no-warn-execstack
Do not warn if the stack is executable (default)
--no-warn-mismatch
Don't warn about mismatched input files
--warn-multiple-gp
Ignored
--warn-search-mismatch
Warn when skipping an incompatible library
--no-warn-search-mismatch
Don't warn when skipping an incompatible library
--warn-shared-textrel
Warn if text segment is not shareable
--no-warn-shared-textrel
Do not warn if text segment is not shareable (default)
--warn-unresolved-symbols
Report unresolved symbols as warnings
--error-unresolved-symbols
Report unresolved symbols as errors
--no-wchar-size-warning
(ARM only) Do not warn about objects with incompatible wchar_t sizes
--whole-archive
Include all archive contents
--no-whole-archive
Include only needed archive contents
--wrap SYMBOL
Use wrapper functions for SYMBOL
-y SYMBOL, --trace-symbol SYMBOL
Trace references to symbol
--undefined-version
Allow unused version in script (default)
--no-undefined-version
Do not allow unused version in script
-Y PATH
Default search path for Solaris compatibility
-(, --start-group
Start a library search group
-), --end-group
End a library search group
--start-lib
Start a library
--end-lib
End a library
-z combreloc
Sort dynamic relocs
-z nocombreloc
Do not sort dynamic relocs
-z common-page-size=SIZE
Set common page size to SIZE
-z defs
Report undefined symbols (even with --shared)
-z execstack
Mark output as requiring executable stack
-z initfirst
Mark DSO to be initialized first at runtime
-z interpose
Mark object to interpose all DSOs but executable
-z lazy
Mark object for lazy runtime binding (default)
-z loadfltr
Mark object requiring immediate process
-z max-page-size=SIZE
Set maximum page size to SIZE
-z muldefs
Allow multiple definitions of symbols
-z nocopyreloc
Do not create copy relocs
-z nodefaultlib
Mark object not to use default search paths
-z nodelete
Mark DSO non-deletable at runtime
-z nodlopen
Mark DSO not available to dlopen
-z nodump
Mark DSO not available to dldump
-z noexecstack
Mark output as not requiring executable stack
-z now Mark object for immediate function binding
-z origin
Mark DSO to indicate that needs immediate $ORIGIN processing at runtime
-z relro
Where possible mark variables read-only after relocation
-z norelro
Don't mark variables read-only after relocation
-z text
Do not permit relocations in read-only segments
-z notext
Permit relocations in read-only segments (default)
-z textoff
Permit relocations in read-only segments (default)
-z buildd
Dummy z option
debian/tmp/usr/bin/ld.gold: supported targets: elf32-bigarm elf32-littlearm elf64-powerpcle elf64-powerpc elf32-powerpcle elf32-powerpc
elf64-sparc elf32-sparc elf64-x86-64 elf64-x86-64-freebsd elf32-i386 elf32-i386-freebsd debian/tmp/usr/bin/ld.gold: supported emulations:
armelfb armelf elf64lppc elf64ppc elf32lppc elf32ppc elf64_sparc elf32_sparc elf_x86_64 elf_i386
REPORTING BUGS
Report bugs to <http://www.sourceware.org/bugzilla/>
COPYRIGHT
Copyright 2011 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.
SEE ALSO
The full documentation for gold is maintained as a Texinfo manual. If the info and gold programs are properly installed at your site, the
command
info gold
should give you access to the complete manual.
gold (GNU Binutils for Ubuntu 2.21.53.20110810) 1.11 September 2011 GOLD(1)