Provided by: binutils_2.24-5ubuntu14.2_amd64
NAME
gold - The GNU ELF linker
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 --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] 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) --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-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 --pic-executable Create a position independent executable -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 --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 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 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
REPORTING BUGS
Report bugs to <http://www.sourceware.org/bugzilla/>
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.