gold --version (return code: 0)
GNU gold (GNU Binutils for Ubuntu 2.26.1) 1.11
Copyright (C) 2015 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.
gold --help (return code: 0)
Usage: 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
--apply-dynamic-relocs Apply link-time values for dynamic relocations (default)
--no-apply-dynamic-relocs (aarch64 only) Do not apply link-time values for dynamic relocations
--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
--build-id-chunk-size-for-treehash SIZE
Chunk size for '--build-id=tree'
--build-id-min-file-size-for-treehash SIZE
Minimum output file size for '--build-id=tree' to work differently than '--build-id=sha1'
--check-sections Check segment addresses for overlaps (default)
--no-check-sections Do not check segment addresses for overlaps
--compress-debug-sections [none,zlib,zlib-gnu,zlib-gabi]
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
--discard-none Keep all 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)
--export-dynamic-symbol SYMBOL
Export SYMBOL to dynamic symbol table
-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.
--fix-cortex-a53-843419 (AArch64 only) Fix Cortex-A53 erratum 843419.
--no-fix-cortex-a53-843419 (AArch64 only) Do not fix Cortex-A53 erratum 843419.
--fix-cortex-a53-835769 (AArch64 only) Fix Cortex-A53 erratum 835769.
--no-fix-cortex-a53-835769 (AArch64 only) Do not fix Cortex-A53 erratum 835769.
--fix-arm1176 (ARM only) Fix binaries for ARM1176 erratum.
--no-fix-arm1176 (ARM only) Do not fix binaries for ARM1176 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
--gdb-index Generate .gdb_index section
--no-gdb-index Do not generate .gdb_index section
--gnu-unique Enable STB_GNU_UNIQUE symbol binding (default)
--no-gnu-unique Disable STB_GNU_UNIQUE symbol binding
-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
--text-reorder Enable text section reordering for GCC section names (default)
--no-text-reorder Disable text section reordering for GCC section names
-nostdlib Only search directories specified on the command line.
--rosegment Put read-only non-executable sections in their own segment
--rosegment-gap OFFSET Set offset between executable and read-only segments
-m EMULATION Set GNU linker emulation; obsolete
--mmap-output-file Map the output file for writing (default).
--no-mmap-output-file Do not map the output file for writing.
-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
-no-pie Do not create a position independent executable
--pic-executable Create a position independent executable
--no-pic-executable Do not create a position independent executable
--pic-veneer Force PIC sequences for ARM/Thumb interworking veneers
-no-pipeline-knowledge (ARM only) Ignore for backward compatibility
--plt-align [=P2ALIGN] (PowerPC64 only) Align PLT call stubs to fit cache lines
--plt-static-chain (PowerPC64 only) PLT call stubs should load r11
--no-plt-static-chain (PowerPC64 only) PLT call stubs should not load r11
--plt-thread-safe (PowerPC64 only) PLT call stubs with load-load barrier
--no-plt-thread-safe (PowerPC64 only) PLT call stubs without barrier
--plugin PLUGIN Load a plugin library
--plugin-opt OPTION Pass an option to the plugin
--posix-fallocate Use posix_fallocate to reserve space in the output file (default).
--no-posix-fallocate Use fallocate or ftruncate to reserve space.
--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
--sort-section [none,name] Sort sections by name. '--no-text-reorder' will override '--sort-section=name' for .text
--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 <= 7.4)
--strip-lto-sections Strip LTO intermediate code sections
--stub-group-size 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.
--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
-Ttext-segment ADDRESS Set the address of the text segment
-Trodata-segment ADDRESS Set the address of the rodata segment
--toc-optimize (PowerPC64 only) Optimize TOC code sequences
--no-toc-optimize (PowerPC64 only) Don't optimize TOC code sequences
--toc-sort (PowerPC64 only) Sort TOC and GOT sections
--no-toc-sort (PowerPC64 only) Don't sort TOC and GOT sections
-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
--weak-unresolved-symbols Convert unresolved symbols to weak references
--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
-fuse-ld Ignored for GCC linker option compatibility
-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 global Make symbols in DSO available for subsequently loaded objects
-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
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
gold: supported emulations: elf_iamcu elf_i386 elf_i386_nacl elf32_x86_64 elf32_x86_64_nacl elf_x86_64 elf_x86_64_nacl
Report bugs to <http://www.sourceware.org/bugzilla/>