{ "content": [ { "type": "text", "text": "# x86_64-linux-gnu-gold (man)\n\n## NAME\n\ngold - The GNU ELF linker\n\n## SYNOPSIS\n\nld.gold [options] file...\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **OPTIONS** (243 subsections)\n- **REPORTING BUGS**\n- **COPYRIGHT**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "x86_64-linux-gnu-gold", "section": "", "mode": "man", "summary": "gold - The GNU ELF linker", "synopsis": "ld.gold [options] file...", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [ { "flag": "-v", "long": "--version", "arg": null, "description": "Report version information" }, { "flag": "-V", "long": null, "arg": null, "description": "" }, { "flag": "", "long": "--add-needed", "arg": null, "description": "Not supported" }, { "flag": "", "long": "--no-add-needed", "arg": null, "description": "Do not copy DTNEEDED tags from shared libraries (default) --allow-multiple-definition Allow multiple definitions of symbols" }, { "flag": "", "long": "--no-allow-multiple-definition", "arg": null, "description": "Do not allow multiple definitions (default)" }, { "flag": "", "long": "--allow-shlib-undefined", "arg": null, "description": "Allow unresolved references in shared libraries" }, { "flag": "", "long": "--no-allow-shlib-undefined", "arg": null, "description": "Do not allow unresolved references in shared libraries (default)" }, { "flag": "", "long": "--apply-dynamic-relocs", "arg": null, "description": "Apply link-time values for dynamic relocations (default)" }, { "flag": "", "long": "--no-apply-dynamic-relocs", "arg": null, "description": "(aarch64 only) Do not apply link-time values for dynamic relocations" }, { "flag": "", "long": "--as-needed", "arg": null, "description": "Use DTNEEDED only for shared libraries that are used" }, { "flag": "", "long": "--no-as-needed", "arg": null, "description": "Use DTNEEDED for all shared libraries (default)" }, { "flag": "", "long": null, "arg": null, "description": "Ignored" }, { "flag": "-b", "long": "--format", "arg": null, "description": "Set input format --be8 Output BE8 format image --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'" }, { "flag": "-l", "long": null, "arg": null, "description": "" }, { "flag": "-l", "long": null, "arg": null, "description": "" }, { "flag": "", "long": null, "arg": null, "description": "" }, { "flag": "", "long": null, "arg": null, "description": "" }, { "flag": "", "long": null, "arg": null, "description": "Use group name lookup rules for shared library" }, { "flag": "", "long": null, "arg": null, "description": "Generate shared library (alias for -G/-shared)" }, { "flag": "", "long": null, "arg": null, "description": "Don't bind default visibility defined symbols locally for -shared (default)" }, { "flag": "", "long": null, "arg": null, "description": "Bind default visibility defined function symbols locally for -shared" }, { "flag": "", "long": null, "arg": null, "description": "Bind default visibility defined symbols locally for -shared" }, { "flag": "", "long": "--check-sections", "arg": null, "description": "Check segment addresses for overlaps (default)" }, { "flag": "", "long": "--no-check-sections", "arg": null, "description": "Do not check segment addresses for overlaps --compress-debug-sections [none,zlib,zlib-gnu,zlib-gabi] Compress .debug* sections in the output file" }, { "flag": "", "long": "--copy-dt-needed-entries", "arg": null, "description": "Not supported --no-copy-dt-needed-entries Do not copy DTNEEDED tags from shared libraries (default)" }, { "flag": "", "long": "--cref", "arg": null, "description": "Output cross reference table" }, { "flag": "", "long": "--no-cref", "arg": null, "description": "Do not output cross reference table (default)" }, { "flag": "", "long": "--ctors-in-init-array", "arg": null, "description": "Use DTINITARRAY for all constructors (default)" }, { "flag": "", "long": "--no-ctors-in-init-array", "arg": null, "description": "Handle constructors as directed by compiler" }, { "flag": "-d", "long": "--define-common", "arg": null, "description": "Define common symbols" }, { "flag": "", "long": "--no-define-common", "arg": null, "description": "Do not define common symbols in relocatable output (default)" }, { "flag": "-d", "long": null, "arg": null, "description": "" }, { "flag": "-d", "long": null, "arg": null, "description": "--debug [all,files,script,task][,...] Turn on debugging --defsym SYMBOL=EXPRESSION Define a symbol --demangle [=STYLE] Demangle C++ symbols in log messages" }, { "flag": "", "long": "--no-demangle", "arg": null, "description": "Do not demangle C++ symbols in log messages --dependency-file FILE Write a dependency file listing all files read" }, { "flag": "", "long": "--detect-odr-violations", "arg": null, "description": "Look for violations of the C++ One Definition Rule" }, { "flag": "", "long": "--no-detect-odr-violations", "arg": null, "description": "Do not look for violations of the C++ One Definition Rule (default)" }, { "flag": "", "long": "--dynamic-list-data", "arg": null, "description": "Add data symbols to dynamic symbols" }, { "flag": "", "long": "--dynamic-list-cpp-new", "arg": null, "description": "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" }, { "flag": "", "long": "--emit-stub-syms", "arg": null, "description": "(PowerPC only) Label linker stubs with a symbol (default)" }, { "flag": "", "long": "--no-emit-stub-syms", "arg": null, "description": "(PowerPC only) Do not label linker stubs with a symbol" }, { "flag": "-e", "long": "--entry", "arg": null, "description": "" }, { "flag": "", "long": "--eh-frame-hdr", "arg": null, "description": "Create exception frame header" }, { "flag": "", "long": "--no-eh-frame-hdr", "arg": null, "description": "Do not create exception frame header (default)" }, { "flag": "", "long": "--enable-new-dtags", "arg": null, "description": "Enable use of DTRUNPATH (default)" }, { "flag": "", "long": "--disable-new-dtags", "arg": null, "description": "Disable use of DTRUNPATH" }, { "flag": "", "long": "--no-enum-size-warning", "arg": null, "description": "(ARM only) Do not warn about objects with incompatible enum sizes --exclude-libs lib,lib ... Exclude libraries from automatic export" }, { "flag": "-E", "long": "--export-dynamic", "arg": null, "description": "Export all dynamic symbols" }, { "flag": "", "long": "--no-export-dynamic", "arg": null, "description": "Do not export all dynamic symbols (default) --export-dynamic-symbol SYMBOL Export SYMBOL to dynamic symbol table" }, { "flag": "", "long": null, "arg": null, "description": "" }, { "flag": "", "long": null, "arg": null, "description": "" }, { "flag": "-f", "long": "--auxiliary", "arg": null, "description": "" }, { "flag": "-F", "long": "--filter", "arg": null, "description": "Filter for shared object symbol table" }, { "flag": "", "long": "--fatal-warnings", "arg": null, "description": "Treat warnings as errors" }, { "flag": "", "long": "--no-fatal-warnings", "arg": null, "description": "Do not treat warnings as errors (default)" }, { "flag": "", "long": null, "arg": null, "description": "Call SYMBOL at unload-time" }, { "flag": "", "long": "--fix-arm1176", "arg": null, "description": "(ARM only) Fix binaries for ARM1176 erratum (default)" }, { "flag": "", "long": "--no-fix-arm1176", "arg": null, "description": "(ARM only) Do not fix binaries for ARM1176 erratum" }, { "flag": "", "long": "--fix-cortex-a8", "arg": null, "description": "(ARM only) Fix binaries for Cortex-A8 erratum" }, { "flag": "", "long": "--no-fix-cortex-a8", "arg": null, "description": "(ARM only) Do not fix binaries for Cortex-A8 erratum (default)" }, { "flag": "", "long": "--fix-cortex-a53-843419", "arg": null, "description": "(AArch64 only) Fix Cortex-A53 erratum 843419" }, { "flag": "", "long": "--no-fix-cortex-a53-843419", "arg": null, "description": "(AArch64 only) Do not fix Cortex-A53 erratum 843419 (default)" }, { "flag": "", "long": "--fix-cortex-a53-835769", "arg": null, "description": "(AArch64 only) Fix Cortex-A53 erratum 835769" }, { "flag": "", "long": "--no-fix-cortex-a53-835769", "arg": null, "description": "(AArch64 only) Do not fix Cortex-A53 erratum 835769 (default)" }, { "flag": "", "long": "--fix-v4bx", "arg": null, "description": "(ARM only) Rewrite BX rn as MOV pc, rn for ARMv4" }, { "flag": "", "long": "--fix-v4bx-interworking", "arg": null, "description": "(ARM only) Rewrite BX rn branch to ARMv4 interworking veneer" }, { "flag": "", "long": null, "arg": null, "description": "Ignored for GCC linker option compatibility" }, { "flag": "-g", "long": null, "arg": null, "description": "" }, { "flag": "", "long": "--gc-sections", "arg": null, "description": "Remove unused sections" }, { "flag": "", "long": "--no-gc-sections", "arg": null, "description": "Don't remove unused sections (default)" }, { "flag": "", "long": "--gdb-index", "arg": null, "description": "Generate .gdbindex section" }, { "flag": "", "long": "--no-gdb-index", "arg": null, "description": "Do not generate .gdbindex section (default)" }, { "flag": "", "long": "--gnu-unique", "arg": null, "description": "Enable STBGNUUNIQUE symbol binding (default)" }, { "flag": "", "long": "--no-gnu-unique", "arg": null, "description": "Disable STBGNUUNIQUE symbol binding" }, { "flag": "-G", "long": null, "arg": null, "description": "Generate shared library" }, { "flag": "-h", "long": null, "arg": null, "description": "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" }, { "flag": "-r", "long": null, "arg": null, "description": "--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 3)" }, { "flag": "", "long": "--incremental", "arg": null, "description": "Do an incremental link if possible; otherwise, do a full link and prepare output for incremental linking" }, { "flag": "", "long": "--no-incremental", "arg": null, "description": "Do a full link (default)" }, { "flag": "", "long": "--incremental-full", "arg": null, "description": "Do a full link and prepare output for incremental linking" }, { "flag": "", "long": "--incremental-update", "arg": null, "description": "Do an incremental link; exit if not possible --incremental-base FILE Set base file for incremental linking (default is output file)" }, { "flag": "", "long": "--incremental-changed", "arg": null, "description": "Assume files changed" }, { "flag": "", "long": "--incremental-unchanged", "arg": null, "description": "Assume files didn't change" }, { "flag": "", "long": "--incremental-unknown", "arg": null, "description": "Use timestamps to check files (default)" }, { "flag": "", "long": "--incremental-startup-unchanged", "arg": null, "description": "Assume startup files unchanged (files preceding this option) --incremental-patch PERCENT Amount of extra space to allocate for patches (default 10)" }, { "flag": "", "long": null, "arg": null, "description": "Call SYMBOL at load-time" }, { "flag": "-I", "long": "--dynamic-linker", "arg": null, "description": "Set dynamic linker path --just-symbols FILE Read only symbol values from FILE" }, { "flag": "", "long": "--keep-files-mapped", "arg": null, "description": "Keep files mapped across passes (default)" }, { "flag": "", "long": "--no-keep-files-mapped", "arg": null, "description": "Release mapped files after each pass --keep-unique SYMBOL Do not fold this symbol during ICF" }, { "flag": "-l", "long": "--library", "arg": null, "description": "Search for library LIBNAME" }, { "flag": "", "long": "--ld-generated-unwind-info", "arg": null, "description": "Generate unwind information for PLT (default)" }, { "flag": "", "long": "--no-ld-generated-unwind-info", "arg": null, "description": "Do not generate unwind information for PLT" }, { "flag": "-L", "long": "--library-path", "arg": null, "description": "Add directory to search path" }, { "flag": "", "long": "--long-plt", "arg": null, "description": "(ARM only) Generate long PLT entries" }, { "flag": "", "long": "--no-long-plt", "arg": null, "description": "(ARM only) Do not generate long PLT entries (default)" }, { "flag": "-m", "long": null, "arg": null, "description": "Set GNU linker emulation; obsolete" }, { "flag": "", "long": "--map-whole-files", "arg": null, "description": "Map whole files to memory (default)" }, { "flag": "", "long": "--no-map-whole-files", "arg": null, "description": "Map relevant file parts to memory" }, { "flag": "", "long": "--merge-exidx-entries", "arg": null, "description": "(ARM only) Merge exidx entries in debuginfo (default)" }, { "flag": "", "long": "--no-merge-exidx-entries", "arg": null, "description": "(ARM only) Do not merge exidx entries in debuginfo" }, { "flag": "", "long": "--mmap-output-file", "arg": null, "description": "Map the output file for writing (default)" }, { "flag": "", "long": "--no-mmap-output-file", "arg": null, "description": "Do not map the output file for writing" }, { "flag": "-M", "long": "--print-map", "arg": null, "description": "Write map file on standard output" }, { "flag": "", "long": null, "arg": null, "description": "Write map file" }, { "flag": "-n", "long": "--nmagic", "arg": null, "description": "Do not page align data" }, { "flag": "-N", "long": "--omagic", "arg": null, "description": "Do not page align data, do not make text readonly" }, { "flag": "", "long": "--no-omagic", "arg": null, "description": "Page align data, make text readonly (default)" }, { "flag": "", "long": "--no-keep-memory", "arg": null, "description": "Use less memory and more disk I/O (included only for compatibility with GNU ld)" }, { "flag": "", "long": "--no-undefined", "arg": null, "description": "Report undefined symbols (even with --shared)" }, { "flag": "", "long": "--noinhibit-exec", "arg": null, "description": "Create an output file even if errors occur" }, { "flag": "", "long": null, "arg": null, "description": "Only search directories specified on the command line" }, { "flag": "-o", "long": "--output", "arg": null, "description": "Set output file name --oformat [binary] Set output format" }, { "flag": "-O", "long": null, "arg": null, "description": "Optimize output file size --orphan-handling [place,discard,warn,error] Orphan section handling" }, { "flag": "-p", "long": null, "arg": null, "description": "" }, { "flag": "", "long": null, "arg": null, "description": "" }, { "flag": "", "long": null, "arg": null, "description": "Do not create a position independent executable (default)" }, { "flag": "", "long": "--pic-executable", "arg": null, "description": "Create a position independent executable" }, { "flag": "", "long": "--no-pic-executable", "arg": null, "description": "Do not create a position independent executable (default)" }, { "flag": "", "long": "--pic-veneer", "arg": null, "description": "Force PIC sequences for ARM/Thumb interworking veneers" }, { "flag": "", "long": null, "arg": null, "description": "(ARM only) Ignore for backward compatibility (default) --plt-align [=P2ALIGN] (PowerPC only) Align PLT call stubs to fit cache lines" }, { "flag": "", "long": "--plt-localentry", "arg": null, "description": "(PowerPC64 only) Optimize calls to ELFv2 localentry:0 functions" }, { "flag": "", "long": "--no-plt-localentry", "arg": null, "description": "(PowerPC64 only) Don't optimize ELFv2 calls (default)" }, { "flag": "", "long": "--plt-static-chain", "arg": null, "description": "(PowerPC64 only) PLT call stubs should load r11" }, { "flag": "", "long": "--no-plt-static-chain", "arg": null, "description": "(PowerPC64 only) PLT call stubs should not load r11 (default)" }, { "flag": "", "long": "--plt-thread-safe", "arg": null, "description": "(PowerPC64 only) PLT call stubs with load-load barrier" }, { "flag": "", "long": "--no-plt-thread-safe", "arg": null, "description": "(PowerPC64 only) PLT call stubs without barrier (default) --plugin PLUGIN Load a plugin library --plugin-opt OPTION Pass an option to the plugin" }, { "flag": "", "long": "--posix-fallocate", "arg": null, "description": "Use posixfallocate to reserve space in the output file (default)" }, { "flag": "", "long": "--no-posix-fallocate", "arg": null, "description": "Use fallocate or ftruncate to reserve space --power10-stubs [=auto,no,yes] (PowerPC64 only) stubs use power10 insns" }, { "flag": "", "long": "--no-power10-stubs", "arg": null, "description": "(PowerPC64 only) stubs do not use power10 insns" }, { "flag": "", "long": "--preread-archive-symbols", "arg": null, "description": "Preread archive symbols when multi-threaded" }, { "flag": "", "long": "--print-gc-sections", "arg": null, "description": "List removed unused sections on stderr" }, { "flag": "", "long": "--no-print-gc-sections", "arg": null, "description": "Do not list removed unused sections (default)" }, { "flag": "", "long": "--print-icf-sections", "arg": null, "description": "List folded identical sections on stderr" }, { "flag": "", "long": "--no-print-icf-sections", "arg": null, "description": "Do not list folded identical sections (default)" }, { "flag": "", "long": "--print-output-format", "arg": null, "description": "Print default output format --print-symbol-counts FILENAME Print symbols defined and used for each input" }, { "flag": "", "long": "--push-state", "arg": null, "description": "Save the state of flags related to input files" }, { "flag": "", "long": "--pop-state", "arg": null, "description": "Restore the state of flags related to input files" }, { "flag": "-q", "long": "--emit-relocs", "arg": null, "description": "Generate relocations in output" }, { "flag": "", "long": null, "arg": null, "description": "" }, { "flag": "-r", "long": null, "arg": null, "description": "Generate relocatable output" }, { "flag": "", "long": "--relax", "arg": null, "description": "Relax branches on certain targets" }, { "flag": "", "long": "--no-relax", "arg": null, "description": "Do not relax branches (default) --retain-symbols-file FILE keep only symbols listed in this file" }, { "flag": "", "long": "--rosegment", "arg": null, "description": "Put read-only non-executable sections in their own segment" }, { "flag": "", "long": "--no-rosegment", "arg": null, "description": "Do not put read-only non-executable sections in their own segment (default) --rosegment-gap OFFSET Set offset between executable and read-only segments" }, { "flag": "-R", "long": null, "arg": null, "description": "" }, { "flag": "", "long": null, "arg": null, "description": "Add DIR to runtime search path --rpath-link DIR Add DIR to link time shared library search path" }, { "flag": "-s", "long": "--strip-all", "arg": null, "description": "Strip all symbols" }, { "flag": "-S", "long": "--strip-debug", "arg": null, "description": "Strip debugging information" }, { "flag": "", "long": "--strip-debug-non-line", "arg": null, "description": "Emit only debug line number information" }, { "flag": "", "long": "--strip-debug-gdb", "arg": null, "description": "Strip debug symbols that are unused by gdb (at least versions <= 7.4)" }, { "flag": "", "long": "--strip-lto-sections", "arg": null, "description": "Strip LTO intermediate code sections (default) --section-ordering-file FILENAME Layout sections in the order specified --section-start SECTION=ADDRESS Set address of section" }, { "flag": "", "long": "--secure-plt", "arg": null, "description": "(PowerPC only) Use new-style PLT (default) --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) --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 the group. 1 means use de‐ fault size" }, { "flag": "", "long": "--stub-group-multi", "arg": null, "description": "(PowerPC only) Allow a group of stubs to serve multiple output sections (default)" }, { "flag": "", "long": "--no-stub-group-multi", "arg": null, "description": "(PowerPC only) Each output section has its own stubs --split-stack-adjust-size SIZE Stack size when -fsplit-stack function calls non-split" }, { "flag": "", "long": null, "arg": null, "description": "Do not link against shared libraries" }, { "flag": "", "long": "--start-lib", "arg": null, "description": "Start a library" }, { "flag": "", "long": "--end-lib", "arg": null, "description": "End a library" }, { "flag": "", "long": "--stats", "arg": null, "description": "Print resource usage statistics --sysroot DIR Set target system root directory" }, { "flag": "-t", "long": "--trace", "arg": null, "description": "Print the name of each input file" }, { "flag": "", "long": "--target1-abs", "arg": null, "description": "(ARM only) Force RARMTARGET1 type to RARMABS32" }, { "flag": "", "long": "--target1-rel", "arg": null, "description": "(ARM only) Force RARMTARGET1 type to RARMREL32 --target2 [rel, abs, got-rel (ARM only) Set RARMTARGET2 relocation type" }, { "flag": "", "long": "--text-reorder", "arg": null, "description": "Enable text section reordering for GCC section names (default)" }, { "flag": "", "long": "--no-text-reorder", "arg": null, "description": "Disable text section reordering for GCC section names" }, { "flag": "", "long": "--threads", "arg": null, "description": "Run the linker multi-threaded" }, { "flag": "", "long": "--no-threads", "arg": null, "description": "Do not run the linker multi-threaded (default) --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" }, { "flag": "", "long": "--tls-optimize", "arg": null, "description": "(PowerPC/64 only) Optimize GD/LD/IE code to IE/LE (default)" }, { "flag": "", "long": "--no-tls-optimize", "arg": null, "description": "(PowerPC/64 only) Don'''t try to optimize TLS accesses" }, { "flag": "", "long": "--tls-get-addr-optimize", "arg": null, "description": "(PowerPC/64 only) Use a special tlsgetaddr call (default)" }, { "flag": "", "long": "--no-tls-get-addr-optimize", "arg": null, "description": "(PowerPC/64 only) Don't use a special tlsgetaddr call" }, { "flag": "", "long": "--toc-optimize", "arg": null, "description": "(PowerPC64 only) Optimize TOC code sequences (default)" }, { "flag": "", "long": "--no-toc-optimize", "arg": null, "description": "(PowerPC64 only) Don't optimize TOC code sequences" }, { "flag": "", "long": "--toc-sort", "arg": null, "description": "(PowerPC64 only) Sort TOC and GOT sections (default)" }, { "flag": "", "long": "--no-toc-sort", "arg": null, "description": "(PowerPC64 only) Don't sort TOC and GOT sections" }, { "flag": "-T", "long": "--script", "arg": null, "description": "Read linker script" }, { "flag": "", "long": null, "arg": null, "description": "Set the address of the bss segment" }, { "flag": "", "long": null, "arg": null, "description": "Set the address of the data segment" }, { "flag": "", "long": null, "arg": null, "description": "Set the address of the text segment" }, { "flag": "", "long": null, "arg": null, "description": "Set the address of the text segment" }, { "flag": "", "long": null, "arg": null, "description": "Set the address of the rodata segment" }, { "flag": "-u", "long": "--undefined", "arg": null, "description": "Create undefined reference to SYMBOL --unresolved-symbols ignore-all,report-all,ignore-in-object-files,ignore-in-shared-libs How to handle unresolved symbols" }, { "flag": "", "long": "--verbose", "arg": null, "description": "Alias for --debug=files --version-script FILE Read version script" }, { "flag": "", "long": "--warn-common", "arg": null, "description": "Warn about duplicate common symbols" }, { "flag": "", "long": "--no-warn-common", "arg": null, "description": "Do not warn about duplicate common symbols (default)" }, { "flag": "", "long": "--warn-constructors", "arg": null, "description": "Ignored" }, { "flag": "", "long": "--no-warn-constructors", "arg": null, "description": "Ignored" }, { "flag": "", "long": "--warn-drop-version", "arg": null, "description": "Warn when discarding version information" }, { "flag": "", "long": "--no-warn-drop-version", "arg": null, "description": "Do not warn when discarding version information (default)" }, { "flag": "", "long": "--warn-execstack", "arg": null, "description": "Warn if the stack is executable" }, { "flag": "", "long": "--no-warn-execstack", "arg": null, "description": "Do not warn if the stack is executable (default)" }, { "flag": "", "long": "--no-warn-mismatch", "arg": null, "description": "Don't warn about mismatched input files" }, { "flag": "", "long": "--warn-multiple-gp", "arg": null, "description": "Ignored" }, { "flag": "", "long": "--warn-search-mismatch", "arg": null, "description": "Warn when skipping an incompatible library (default)" }, { "flag": "", "long": "--no-warn-search-mismatch", "arg": null, "description": "Don't warn when skipping an incompatible library" }, { "flag": "", "long": "--warn-shared-textrel", "arg": null, "description": "Warn if text segment is not shareable" }, { "flag": "", "long": "--no-warn-shared-textrel", "arg": null, "description": "Do not warn if text segment is not shareable (default)" }, { "flag": "", "long": "--warn-unresolved-symbols", "arg": null, "description": "Report unresolved symbols as warnings" }, { "flag": "", "long": "--error-unresolved-symbols", "arg": null, "description": "Report unresolved symbols as errors (default)" }, { "flag": "-z", "long": null, "arg": null, "description": "Dummy z option" }, { "flag": "", "long": "--no-wchar-size-warning", "arg": null, "description": "(ARM only) Do not warn about objects with incompatible wchart sizes" }, { "flag": "", "long": "--weak-unresolved-symbols", "arg": null, "description": "Convert unresolved symbols to weak references" }, { "flag": "", "long": "--whole-archive", "arg": null, "description": "Include all archive contents" }, { "flag": "", "long": "--no-whole-archive", "arg": null, "description": "Include only needed archive contents (default) --wrap SYMBOL Use wrapper functions for SYMBOL" }, { "flag": "-x", "long": "--discard-all", "arg": null, "description": "Delete all local symbols" }, { "flag": "-X", "long": "--discard-locals", "arg": null, "description": "Delete all temporary local symbols" }, { "flag": "", "long": "--discard-none", "arg": null, "description": "Keep all local symbols" }, { "flag": "-y", "long": "--trace-symbol", "arg": null, "description": "Trace references to symbol" }, { "flag": "", "long": "--undefined-version", "arg": null, "description": "Allow unused version in script (default)" }, { "flag": "", "long": "--no-undefined-version", "arg": null, "description": "Do not allow unused version in script" }, { "flag": "-Y", "long": null, "arg": null, "description": "Default search path for Solaris compatibility -(, --start-group Start a library search group -), --end-group End a library search group" }, { "flag": "-z", "long": null, "arg": null, "description": "(x86-64 only) Generate a BND PLT for Intel MPX" }, { "flag": "-z", "long": null, "arg": null, "description": "Generate a regular PLT (default)" }, { "flag": "-z", "long": null, "arg": null, "description": "Sort dynamic relocs (default)" }, { "flag": "-z", "long": null, "arg": null, "description": "Do not sort dynamic relocs" }, { "flag": "-z", "long": null, "arg": null, "description": "Set common page size to SIZE" }, { "flag": "-z", "long": null, "arg": null, "description": "Report undefined symbols (even with --shared)" }, { "flag": "-z", "long": null, "arg": null, "description": "Mark output as requiring executable stack" }, { "flag": "-z", "long": null, "arg": null, "description": "Make symbols in DSO available for subsequently loaded objects" }, { "flag": "-z", "long": null, "arg": null, "description": "Mark DSO to be initialized first at runtime" }, { "flag": "-z", "long": null, "arg": null, "description": "Mark object to interpose all DSOs but executable" }, { "flag": "-z", "long": null, "arg": null, "description": "Mark DSO to be loaded at most once, and only in the main namespace" }, { "flag": "-z", "long": null, "arg": null, "description": "Do not mark the DSO as one to be loaded only in the main namespace (default)" }, { "flag": "-z", "long": null, "arg": null, "description": "Mark object for lazy runtime binding (default)" }, { "flag": "-z", "long": null, "arg": null, "description": "Mark object requiring immediate process" }, { "flag": "-z", "long": null, "arg": null, "description": "Set maximum page size to SIZE" }, { "flag": "-z", "long": null, "arg": null, "description": "Allow multiple definitions of symbols" }, { "flag": "-z", "long": null, "arg": null, "description": "Do not create copy relocs" }, { "flag": "-z", "long": null, "arg": null, "description": "Mark object not to use default search paths" }, { "flag": "-z", "long": null, "arg": null, "description": "Mark DSO non-deletable at runtime" }, { "flag": "-z", "long": null, "arg": null, "description": "Mark DSO not available to dlopen" }, { "flag": "-z", "long": null, "arg": null, "description": "Mark DSO not available to dldump" }, { "flag": "-z", "long": null, "arg": null, "description": "Mark output as not requiring executable stack" }, { "flag": "-z", "long": null, "arg": null, "description": "" }, { "flag": "-z", "long": null, "arg": null, "description": "Mark DSO to indicate that needs immediate $ORIGIN processing at runtime" }, { "flag": "-z", "long": null, "arg": null, "description": "Where possible mark variables read-only after relocation (default)" }, { "flag": "-z", "long": null, "arg": null, "description": "Don't mark variables read-only after relocation" }, { "flag": "-z", "long": null, "arg": null, "description": "Set PTGNUSTACK segment pmemsz to SIZE" }, { "flag": "-z", "long": null, "arg": null, "description": "ELF symbol visibility for synthesized start* and stop* symbols" }, { "flag": "-z", "long": null, "arg": null, "description": "Do not permit relocations in read-only segments" }, { "flag": "-z", "long": null, "arg": null, "description": "Permit relocations in read-only segments (default)" }, { "flag": "-z", "long": null, "arg": null, "description": "Permit relocations in read-only segments (default)" }, { "flag": "-z", "long": null, "arg": null, "description": "Move .text.unlikely sections to a separate segment." }, { "flag": "-z", "long": null, "arg": null, "description": "Do not move .text.unlikely sections to a separate segment. (default)" }, { "flag": "-z", "long": null, "arg": null, "description": "separate sections in the final binary." }, { "flag": "-z", "long": null, "arg": null, "description": "Merge all .text.* prefix sections. (default) debian/tmp/usr/bin/ld.gold: supported targets: elf32-x86-64 elf32-x86-64-freebsd elf32-x86-64-nacl elf64-x86-64 elf64-x86-64-freebsd elf64-x86-64-nacl elf32-iamcu elf32-i386 elf32-i386-freebsd elf32-i386-nacl debian/tmp/usr/bin/ld.gold: supported emulations: elf32x8664 elf32x8664nacl elfx8664 elfx8664nacl elfiamcu elfi386 elfi386nacl" } ], "examples": [], "see_also": [], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 2, "subsections": [] }, { "name": "OPTIONS", "lines": 2, "subsections": [ { "name": "-v --version", "lines": 2, "flag": "-v", "long": "--version" }, { "name": "-V", "lines": 1, "flag": "-V" }, { "name": "--add-needed", "lines": 2, "long": "--add-needed" }, { "name": "--no-add-needed", "lines": 4, "long": "--no-add-needed" }, { "name": "--no-allow-multiple-definition", "lines": 2, "long": "--no-allow-multiple-definition" }, { "name": "--allow-shlib-undefined", "lines": 2, "long": "--allow-shlib-undefined" }, { "name": "--no-allow-shlib-undefined", "lines": 2, "long": "--no-allow-shlib-undefined" }, { "name": "--apply-dynamic-relocs", "lines": 2, "long": "--apply-dynamic-relocs" }, { "name": "--no-apply-dynamic-relocs", "lines": 2, "long": "--no-apply-dynamic-relocs" }, { "name": "--as-needed", "lines": 2, "long": "--as-needed" }, { "name": "--no-as-needed", "lines": 2, "long": "--no-as-needed" }, { "name": "-assert", "lines": 2 }, { "name": "-b --format", "lines": 14, "flag": "-b", "long": "--format" }, { "name": "-Bdynamic -l", "lines": 1, "flag": "-l" }, { "name": "-Bstatic -l", "lines": 1, "flag": "-l" }, { "name": "-dy -Bdynamic", "lines": 1 }, { "name": "-dn -Bstatic", "lines": 1 }, { "name": "-Bgroup", "lines": 2 }, { "name": "-Bshareable", "lines": 2 }, { "name": "-Bno-symbolic", "lines": 2 }, { "name": "-Bsymbolic-functions", "lines": 2 }, { "name": "-Bsymbolic", "lines": 2 }, { "name": "--check-sections", "lines": 2, "long": "--check-sections" }, { "name": "--no-check-sections", "lines": 5, "long": "--no-check-sections" }, { "name": "--copy-dt-needed-entries", "lines": 4, "long": "--copy-dt-needed-entries" }, { "name": "--cref", "lines": 2, "long": "--cref" }, { "name": "--no-cref", "lines": 2, "long": "--no-cref" }, { "name": "--ctors-in-init-array", "lines": 2, "long": "--ctors-in-init-array" }, { "name": "--no-ctors-in-init-array", "lines": 2, "long": "--no-ctors-in-init-array" }, { "name": "-d --define-common", "lines": 2, "flag": "-d", "long": "--define-common" }, { "name": "--no-define-common", "lines": 2, "long": "--no-define-common" }, { "name": "-dc -d", "lines": 1, "flag": "-d" }, { "name": "-dp -d", "lines": 9, "flag": "-d" }, { "name": "--no-demangle", "lines": 5, "long": "--no-demangle" }, { "name": "--detect-odr-violations", "lines": 2, "long": "--detect-odr-violations" }, { "name": "--no-detect-odr-violations", "lines": 2, "long": "--no-detect-odr-violations" }, { "name": "--dynamic-list-data", "lines": 2, "long": "--dynamic-list-data" }, { "name": "--dynamic-list-cpp-new", "lines": 7, "long": "--dynamic-list-cpp-new" }, { "name": "--emit-stub-syms", "lines": 2, "long": "--emit-stub-syms" }, { "name": "--no-emit-stub-syms", "lines": 2, "long": "--no-emit-stub-syms" }, { "name": "-e --entry", "lines": 1, "flag": "-e", "long": "--entry" }, { "name": "--eh-frame-hdr", "lines": 2, "long": "--eh-frame-hdr" }, { "name": "--no-eh-frame-hdr", "lines": 2, "long": "--no-eh-frame-hdr" }, { "name": "--enable-new-dtags", "lines": 2, "long": "--enable-new-dtags" }, { "name": "--disable-new-dtags", "lines": 2, "long": "--disable-new-dtags" }, { "name": "--no-enum-size-warning", "lines": 5, "long": "--no-enum-size-warning" }, { "name": "-E --export-dynamic", "lines": 2, "flag": "-E", "long": "--export-dynamic" }, { "name": "--no-export-dynamic", "lines": 5, "long": "--no-export-dynamic" }, { "name": "-EB", "lines": 1 }, { "name": "-EL", "lines": 1 }, { "name": "-f --auxiliary", "lines": 1, "flag": "-f", "long": "--auxiliary" }, { "name": "-F --filter", "lines": 2, "flag": "-F", "long": "--filter" }, { "name": "--fatal-warnings", "lines": 2, "long": "--fatal-warnings" }, { "name": "--no-fatal-warnings", "lines": 2, "long": "--no-fatal-warnings" }, { "name": "-fini", "lines": 2 }, { "name": "--fix-arm1176", "lines": 2, "long": "--fix-arm1176" }, { "name": "--no-fix-arm1176", "lines": 2, "long": "--no-fix-arm1176" }, { "name": "--fix-cortex-a8", "lines": 2, "long": "--fix-cortex-a8" }, { "name": "--no-fix-cortex-a8", "lines": 2, "long": "--no-fix-cortex-a8" }, { "name": "--fix-cortex-a53-843419", "lines": 2, "long": "--fix-cortex-a53-843419" }, { "name": "--no-fix-cortex-a53-843419", "lines": 2, "long": "--no-fix-cortex-a53-843419" }, { "name": "--fix-cortex-a53-835769", "lines": 2, "long": "--fix-cortex-a53-835769" }, { "name": "--no-fix-cortex-a53-835769", "lines": 2, "long": "--no-fix-cortex-a53-835769" }, { "name": "--fix-v4bx", "lines": 2, "long": "--fix-v4bx" }, { "name": "--fix-v4bx-interworking", "lines": 2, "long": "--fix-v4bx-interworking" }, { "name": "-fuse-ld", "lines": 2 }, { "name": "-g", "lines": 1, "flag": "-g" }, { "name": "--gc-sections", "lines": 2, "long": "--gc-sections" }, { "name": "--no-gc-sections", "lines": 2, "long": "--no-gc-sections" }, { "name": "--gdb-index", "lines": 2, "long": "--gdb-index" }, { "name": "--no-gdb-index", "lines": 2, "long": "--no-gdb-index" }, { "name": "--gnu-unique", "lines": 2, "long": "--gnu-unique" }, { "name": "--no-gnu-unique", "lines": 2, "long": "--no-gnu-unique" }, { "name": "-G -shared", "lines": 2, "flag": "-G" }, { "name": "-h -soname", "lines": 8, "flag": "-h" }, { "name": "-i -r", "lines": 7, "flag": "-r" }, { "name": "--incremental", "lines": 3, "long": "--incremental" }, { "name": "--no-incremental", "lines": 2, "long": "--no-incremental" }, { "name": "--incremental-full", "lines": 2, "long": "--incremental-full" }, { "name": "--incremental-update", "lines": 5, "long": "--incremental-update" }, { "name": "--incremental-changed", "lines": 2, "long": "--incremental-changed" }, { "name": "--incremental-unchanged", "lines": 2, "long": "--incremental-unchanged" }, { "name": "--incremental-unknown", "lines": 2, "long": "--incremental-unknown" }, { "name": "--incremental-startup-unchanged", "lines": 4, "long": "--incremental-startup-unchanged" }, { "name": "-init", "lines": 2 }, { "name": "-I --dynamic-linker", "lines": 5, "flag": "-I", "long": "--dynamic-linker" }, { "name": "--keep-files-mapped", "lines": 2, "long": "--keep-files-mapped" }, { "name": "--no-keep-files-mapped", "lines": 5, "long": "--no-keep-files-mapped" }, { "name": "-l --library", "lines": 2, "flag": "-l", "long": "--library" }, { "name": "--ld-generated-unwind-info", "lines": 2, "long": "--ld-generated-unwind-info" }, { "name": "--no-ld-generated-unwind-info", "lines": 2, "long": "--no-ld-generated-unwind-info" }, { "name": "-L --library-path", "lines": 2, "flag": "-L", "long": "--library-path" }, { "name": "--long-plt", "lines": 2, "long": "--long-plt" }, { "name": "--no-long-plt", "lines": 2, "long": "--no-long-plt" }, { "name": "-m", "lines": 2, "flag": "-m" }, { "name": "--map-whole-files", "lines": 2, "long": "--map-whole-files" }, { "name": "--no-map-whole-files", "lines": 2, "long": "--no-map-whole-files" }, { "name": "--merge-exidx-entries", "lines": 2, "long": "--merge-exidx-entries" }, { "name": "--no-merge-exidx-entries", "lines": 2, "long": "--no-merge-exidx-entries" }, { "name": "--mmap-output-file", "lines": 2, "long": "--mmap-output-file" }, { "name": "--no-mmap-output-file", "lines": 2, "long": "--no-mmap-output-file" }, { "name": "-M --print-map", "lines": 2, "flag": "-M", "long": "--print-map" }, { "name": "-Map", "lines": 2 }, { "name": "-n --nmagic", "lines": 2, "flag": "-n", "long": "--nmagic" }, { "name": "-N --omagic", "lines": 2, "flag": "-N", "long": "--omagic" }, { "name": "--no-omagic", "lines": 2, "long": "--no-omagic" }, { "name": "--no-keep-memory", "lines": 2, "long": "--no-keep-memory" }, { "name": "--no-undefined", "lines": 2, "long": "--no-undefined" }, { "name": "--noinhibit-exec", "lines": 2, "long": "--noinhibit-exec" }, { "name": "-nostdlib", "lines": 2 }, { "name": "-o --output", "lines": 5, "flag": "-o", "long": "--output" }, { "name": "-O -optimize", "lines": 5, "flag": "-O" }, { "name": "-p", "lines": 1, "flag": "-p" }, { "name": "-pie", "lines": 1 }, { "name": "-no-pie", "lines": 2 }, { "name": "--pic-executable", "lines": 2, "long": "--pic-executable" }, { "name": "--no-pic-executable", "lines": 2, "long": "--no-pic-executable" }, { "name": "--pic-veneer", "lines": 2, "long": "--pic-veneer" }, { "name": "-no-pipeline-knowledge", "lines": 5 }, { "name": "--plt-localentry", "lines": 2, "long": "--plt-localentry" }, { "name": "--no-plt-localentry", "lines": 2, "long": "--no-plt-localentry" }, { "name": "--plt-static-chain", "lines": 2, "long": "--plt-static-chain" }, { "name": "--no-plt-static-chain", "lines": 2, "long": "--no-plt-static-chain" }, { "name": "--plt-thread-safe", "lines": 2, "long": "--plt-thread-safe" }, { "name": "--no-plt-thread-safe", "lines": 8, "long": "--no-plt-thread-safe" }, { "name": "--posix-fallocate", "lines": 2, "long": "--posix-fallocate" }, { "name": "--no-posix-fallocate", "lines": 5, "long": "--no-posix-fallocate" }, { "name": "--no-power10-stubs", "lines": 2, "long": "--no-power10-stubs" }, { "name": "--preread-archive-symbols", "lines": 2, "long": "--preread-archive-symbols" }, { "name": "--print-gc-sections", "lines": 2, "long": "--print-gc-sections" }, { "name": "--no-print-gc-sections", "lines": 2, "long": "--no-print-gc-sections" }, { "name": "--print-icf-sections", "lines": 2, "long": "--print-icf-sections" }, { "name": "--no-print-icf-sections", "lines": 2, "long": "--no-print-icf-sections" }, { "name": "--print-output-format", "lines": 5, "long": "--print-output-format" }, { "name": "--push-state", "lines": 2, "long": "--push-state" }, { "name": "--pop-state", "lines": 2, "long": "--pop-state" }, { "name": "-q --emit-relocs", "lines": 2, "flag": "-q", "long": "--emit-relocs" }, { "name": "-Qy", "lines": 1 }, { "name": "-r -relocatable", "lines": 2, "flag": "-r" }, { "name": "--relax", "lines": 2, "long": "--relax" }, { "name": "--no-relax", "lines": 5, "long": "--no-relax" }, { "name": "--rosegment", "lines": 2, "long": "--rosegment" }, { "name": "--no-rosegment", "lines": 5, "long": "--no-rosegment" }, { "name": "-R", "lines": 1, "flag": "-R" }, { "name": "-rpath", "lines": 5 }, { "name": "-s --strip-all", "lines": 2, "flag": "-s", "long": "--strip-all" }, { "name": "-S --strip-debug", "lines": 2, "flag": "-S", "long": "--strip-debug" }, { "name": "--strip-debug-non-line", "lines": 2, "long": "--strip-debug-non-line" }, { "name": "--strip-debug-gdb", "lines": 2, "long": "--strip-debug-gdb" }, { "name": "--strip-lto-sections", "lines": 8, "long": "--strip-lto-sections" }, { "name": "--secure-plt", "lines": 17, "long": "--secure-plt" }, { "name": "--stub-group-multi", "lines": 2, "long": "--stub-group-multi" }, { "name": "--no-stub-group-multi", "lines": 5, "long": "--no-stub-group-multi" }, { "name": "-static", "lines": 2 }, { "name": "--start-lib", "lines": 2, "long": "--start-lib" }, { "name": "--end-lib", "lines": 2, "long": "--end-lib" }, { "name": "--stats", "lines": 5, "long": "--stats" }, { "name": "-t --trace", "lines": 2, "flag": "-t", "long": "--trace" }, { "name": "--target1-abs", "lines": 2, "long": "--target1-abs" }, { "name": "--target1-rel", "lines": 5, "long": "--target1-rel" }, { "name": "--text-reorder", "lines": 2, "long": "--text-reorder" }, { "name": "--no-text-reorder", "lines": 2, "long": "--no-text-reorder" }, { "name": "--threads", "lines": 2, "long": "--threads" }, { "name": "--no-threads", "lines": 13, "long": "--no-threads" }, { "name": "--tls-optimize", "lines": 2, "long": "--tls-optimize" }, { "name": "--no-tls-optimize", "lines": 2, "long": "--no-tls-optimize" }, { "name": "--tls-get-addr-optimize", "lines": 2, "long": "--tls-get-addr-optimize" }, { "name": "--no-tls-get-addr-optimize", "lines": 2, "long": "--no-tls-get-addr-optimize" }, { "name": "--toc-optimize", "lines": 2, "long": "--toc-optimize" }, { "name": "--no-toc-optimize", "lines": 2, "long": "--no-toc-optimize" }, { "name": "--toc-sort", "lines": 2, "long": "--toc-sort" }, { "name": "--no-toc-sort", "lines": 2, "long": "--no-toc-sort" }, { "name": "-T --script", "lines": 2, "flag": "-T", "long": "--script" }, { "name": "-Tbss", "lines": 2 }, { "name": "-Tdata", "lines": 2 }, { "name": "-Ttext", "lines": 2 }, { "name": "-Ttext-segment", "lines": 2 }, { "name": "-Trodata-segment", "lines": 2 }, { "name": "-u --undefined", "lines": 5, "flag": "-u", "long": "--undefined" }, { "name": "--verbose", "lines": 5, "long": "--verbose" }, { "name": "--warn-common", "lines": 2, "long": "--warn-common" }, { "name": "--no-warn-common", "lines": 2, "long": "--no-warn-common" }, { "name": "--warn-constructors", "lines": 2, "long": "--warn-constructors" }, { "name": "--no-warn-constructors", "lines": 2, "long": "--no-warn-constructors" }, { "name": "--warn-drop-version", "lines": 2, "long": "--warn-drop-version" }, { "name": "--no-warn-drop-version", "lines": 2, "long": "--no-warn-drop-version" }, { "name": "--warn-execstack", "lines": 2, "long": "--warn-execstack" }, { "name": "--no-warn-execstack", "lines": 2, "long": "--no-warn-execstack" }, { "name": "--no-warn-mismatch", "lines": 2, "long": "--no-warn-mismatch" }, { "name": "--warn-multiple-gp", "lines": 2, "long": "--warn-multiple-gp" }, { "name": "--warn-search-mismatch", "lines": 2, "long": "--warn-search-mismatch" }, { "name": "--no-warn-search-mismatch", "lines": 2, "long": "--no-warn-search-mismatch" }, { "name": "--warn-shared-textrel", "lines": 2, "long": "--warn-shared-textrel" }, { "name": "--no-warn-shared-textrel", "lines": 2, "long": "--no-warn-shared-textrel" }, { "name": "--warn-unresolved-symbols", "lines": 2, "long": "--warn-unresolved-symbols" }, { "name": "--error-unresolved-symbols", "lines": 2, "long": "--error-unresolved-symbols" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "--no-wchar-size-warning", "lines": 2, "long": "--no-wchar-size-warning" }, { "name": "--weak-unresolved-symbols", "lines": 2, "long": "--weak-unresolved-symbols" }, { "name": "--whole-archive", "lines": 2, "long": "--whole-archive" }, { "name": "--no-whole-archive", "lines": 5, "long": "--no-whole-archive" }, { "name": "-x --discard-all", "lines": 2, "flag": "-x", "long": "--discard-all" }, { "name": "-X --discard-locals", "lines": 2, "flag": "-X", "long": "--discard-locals" }, { "name": "--discard-none", "lines": 2, "long": "--discard-none" }, { "name": "-y --trace-symbol", "lines": 2, "flag": "-y", "long": "--trace-symbol" }, { "name": "--undefined-version", "lines": 2, "long": "--undefined-version" }, { "name": "--no-undefined-version", "lines": 2, "long": "--no-undefined-version" }, { "name": "-Y", "lines": 8, "flag": "-Y" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 1, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 2, "flag": "-z" }, { "name": "-z", "lines": 7, "flag": "-z" } ] }, { "name": "REPORTING BUGS", "lines": 2, "subsections": [] }, { "name": "COPYRIGHT", "lines": 7, "subsections": [] } ], "sections": { "NAME": { "content": "gold - The GNU ELF linker\n", "subsections": [] }, "SYNOPSIS": { "content": "ld.gold [options] file...\n", "subsections": [] }, "OPTIONS": { "content": "--help Report usage information\n", "subsections": [ { "name": "-v --version", "content": "Report version information\n", "flag": "-v", "long": "--version" }, { "name": "-V", "content": "", "flag": "-V" }, { "name": "--add-needed", "content": "Not supported\n", "long": "--add-needed" }, { "name": "--no-add-needed", "content": "Do not copy DTNEEDED tags from shared libraries (default)\n\n--allow-multiple-definition Allow multiple definitions of symbols\n", "long": "--no-add-needed" }, { "name": "--no-allow-multiple-definition", "content": "Do not allow multiple definitions (default)\n", "long": "--no-allow-multiple-definition" }, { "name": "--allow-shlib-undefined", "content": "Allow unresolved references in shared libraries\n", "long": "--allow-shlib-undefined" }, { "name": "--no-allow-shlib-undefined", "content": "Do not allow unresolved references in shared libraries (default)\n", "long": "--no-allow-shlib-undefined" }, { "name": "--apply-dynamic-relocs", "content": "Apply link-time values for dynamic relocations (default)\n", "long": "--apply-dynamic-relocs" }, { "name": "--no-apply-dynamic-relocs", "content": "(aarch64 only) Do not apply link-time values for dynamic relocations\n", "long": "--no-apply-dynamic-relocs" }, { "name": "--as-needed", "content": "Use DTNEEDED only for shared libraries that are used\n", "long": "--as-needed" }, { "name": "--no-as-needed", "content": "Use DTNEEDED for all shared libraries (default)\n", "long": "--no-as-needed" }, { "name": "-assert", "content": "Ignored\n" }, { "name": "-b --format", "content": "Set input format\n\n--be8 Output BE8 format image\n\n--build-id [=STYLE]\nGenerate build ID note\n\n--build-id-chunk-size-for-treehash SIZE\nChunk size for '--build-id=tree'\n\n--build-id-min-file-size-for-treehash SIZE\nMinimum output file size for '--build-id=tree' to work differently than\n'--build-id=sha1'\n", "flag": "-b", "long": "--format" }, { "name": "-Bdynamic -l", "content": "", "flag": "-l" }, { "name": "-Bstatic -l", "content": "", "flag": "-l" }, { "name": "-dy -Bdynamic", "content": "" }, { "name": "-dn -Bstatic", "content": "" }, { "name": "-Bgroup", "content": "Use group name lookup rules for shared library\n" }, { "name": "-Bshareable", "content": "Generate shared library (alias for -G/-shared)\n" }, { "name": "-Bno-symbolic", "content": "Don't bind default visibility defined symbols locally for -shared (default)\n" }, { "name": "-Bsymbolic-functions", "content": "Bind default visibility defined function symbols locally for -shared\n" }, { "name": "-Bsymbolic", "content": "Bind default visibility defined symbols locally for -shared\n" }, { "name": "--check-sections", "content": "Check segment addresses for overlaps (default)\n", "long": "--check-sections" }, { "name": "--no-check-sections", "content": "Do not check segment addresses for overlaps\n\n--compress-debug-sections [none,zlib,zlib-gnu,zlib-gabi]\nCompress .debug* sections in the output file\n", "long": "--no-check-sections" }, { "name": "--copy-dt-needed-entries", "content": "Not supported\n\n--no-copy-dt-needed-entries Do not copy DTNEEDED tags from shared libraries (default)\n", "long": "--copy-dt-needed-entries" }, { "name": "--cref", "content": "Output cross reference table\n", "long": "--cref" }, { "name": "--no-cref", "content": "Do not output cross reference table (default)\n", "long": "--no-cref" }, { "name": "--ctors-in-init-array", "content": "Use DTINITARRAY for all constructors (default)\n", "long": "--ctors-in-init-array" }, { "name": "--no-ctors-in-init-array", "content": "Handle constructors as directed by compiler\n", "long": "--no-ctors-in-init-array" }, { "name": "-d --define-common", "content": "Define common symbols\n", "flag": "-d", "long": "--define-common" }, { "name": "--no-define-common", "content": "Do not define common symbols in relocatable output (default)\n", "long": "--no-define-common" }, { "name": "-dc -d", "content": "", "flag": "-d" }, { "name": "-dp -d", "content": "--debug [all,files,script,task][,...]\nTurn on debugging\n\n--defsym SYMBOL=EXPRESSION\nDefine a symbol\n\n--demangle [=STYLE]\nDemangle C++ symbols in log messages\n", "flag": "-d" }, { "name": "--no-demangle", "content": "Do not demangle C++ symbols in log messages\n\n--dependency-file FILE\nWrite a dependency file listing all files read\n", "long": "--no-demangle" }, { "name": "--detect-odr-violations", "content": "Look for violations of the C++ One Definition Rule\n", "long": "--detect-odr-violations" }, { "name": "--no-detect-odr-violations", "content": "Do not look for violations of the C++ One Definition Rule (default)\n", "long": "--no-detect-odr-violations" }, { "name": "--dynamic-list-data", "content": "Add data symbols to dynamic symbols\n", "long": "--dynamic-list-data" }, { "name": "--dynamic-list-cpp-new", "content": "Add C++ operator new/delete to dynamic symbols\n\n--dynamic-list-cpp-typeinfo Add C++ typeinfo to dynamic symbols\n\n--dynamic-list FILE\nRead a list of dynamic symbols\n", "long": "--dynamic-list-cpp-new" }, { "name": "--emit-stub-syms", "content": "(PowerPC only) Label linker stubs with a symbol (default)\n", "long": "--emit-stub-syms" }, { "name": "--no-emit-stub-syms", "content": "(PowerPC only) Do not label linker stubs with a symbol\n", "long": "--no-emit-stub-syms" }, { "name": "-e --entry", "content": "", "flag": "-e", "long": "--entry" }, { "name": "--eh-frame-hdr", "content": "Create exception frame header\n", "long": "--eh-frame-hdr" }, { "name": "--no-eh-frame-hdr", "content": "Do not create exception frame header (default)\n", "long": "--no-eh-frame-hdr" }, { "name": "--enable-new-dtags", "content": "Enable use of DTRUNPATH (default)\n", "long": "--enable-new-dtags" }, { "name": "--disable-new-dtags", "content": "Disable use of DTRUNPATH\n", "long": "--disable-new-dtags" }, { "name": "--no-enum-size-warning", "content": "(ARM only) Do not warn about objects with incompatible enum sizes\n\n--exclude-libs lib,lib ...\nExclude libraries from automatic export\n", "long": "--no-enum-size-warning" }, { "name": "-E --export-dynamic", "content": "Export all dynamic symbols\n", "flag": "-E", "long": "--export-dynamic" }, { "name": "--no-export-dynamic", "content": "Do not export all dynamic symbols (default)\n\n--export-dynamic-symbol SYMBOL\nExport SYMBOL to dynamic symbol table\n", "long": "--no-export-dynamic" }, { "name": "-EB", "content": "" }, { "name": "-EL", "content": "" }, { "name": "-f --auxiliary", "content": "", "flag": "-f", "long": "--auxiliary" }, { "name": "-F --filter", "content": "Filter for shared object symbol table\n", "flag": "-F", "long": "--filter" }, { "name": "--fatal-warnings", "content": "Treat warnings as errors\n", "long": "--fatal-warnings" }, { "name": "--no-fatal-warnings", "content": "Do not treat warnings as errors (default)\n", "long": "--no-fatal-warnings" }, { "name": "-fini", "content": "Call SYMBOL at unload-time\n" }, { "name": "--fix-arm1176", "content": "(ARM only) Fix binaries for ARM1176 erratum (default)\n", "long": "--fix-arm1176" }, { "name": "--no-fix-arm1176", "content": "(ARM only) Do not fix binaries for ARM1176 erratum\n", "long": "--no-fix-arm1176" }, { "name": "--fix-cortex-a8", "content": "(ARM only) Fix binaries for Cortex-A8 erratum\n", "long": "--fix-cortex-a8" }, { "name": "--no-fix-cortex-a8", "content": "(ARM only) Do not fix binaries for Cortex-A8 erratum (default)\n", "long": "--no-fix-cortex-a8" }, { "name": "--fix-cortex-a53-843419", "content": "(AArch64 only) Fix Cortex-A53 erratum 843419\n", "long": "--fix-cortex-a53-843419" }, { "name": "--no-fix-cortex-a53-843419", "content": "(AArch64 only) Do not fix Cortex-A53 erratum 843419 (default)\n", "long": "--no-fix-cortex-a53-843419" }, { "name": "--fix-cortex-a53-835769", "content": "(AArch64 only) Fix Cortex-A53 erratum 835769\n", "long": "--fix-cortex-a53-835769" }, { "name": "--no-fix-cortex-a53-835769", "content": "(AArch64 only) Do not fix Cortex-A53 erratum 835769 (default)\n", "long": "--no-fix-cortex-a53-835769" }, { "name": "--fix-v4bx", "content": "(ARM only) Rewrite BX rn as MOV pc, rn for ARMv4\n", "long": "--fix-v4bx" }, { "name": "--fix-v4bx-interworking", "content": "(ARM only) Rewrite BX rn branch to ARMv4 interworking veneer\n", "long": "--fix-v4bx-interworking" }, { "name": "-fuse-ld", "content": "Ignored for GCC linker option compatibility\n" }, { "name": "-g", "content": "", "flag": "-g" }, { "name": "--gc-sections", "content": "Remove unused sections\n", "long": "--gc-sections" }, { "name": "--no-gc-sections", "content": "Don't remove unused sections (default)\n", "long": "--no-gc-sections" }, { "name": "--gdb-index", "content": "Generate .gdbindex section\n", "long": "--gdb-index" }, { "name": "--no-gdb-index", "content": "Do not generate .gdbindex section (default)\n", "long": "--no-gdb-index" }, { "name": "--gnu-unique", "content": "Enable STBGNUUNIQUE symbol binding (default)\n", "long": "--gnu-unique" }, { "name": "--no-gnu-unique", "content": "Disable STBGNUUNIQUE symbol binding\n", "long": "--no-gnu-unique" }, { "name": "-G -shared", "content": "Generate shared library\n", "flag": "-G" }, { "name": "-h -soname", "content": "Set shared library name\n\n--hash-bucket-empty-fraction FRACTION\nMin fraction of empty buckets in dynamic hash\n\n--hash-style [sysv,gnu,both]\nDynamic hash style\n", "flag": "-h" }, { "name": "-i -r", "content": "--icf [none,all,safe]\nIdentical Code Folding. '--icf=safe' Folds ctors, dtors and functions whose pointers\nare definitely not taken\n\n--icf-iterations COUNT\nNumber of iterations of ICF (default 3)\n", "flag": "-r" }, { "name": "--incremental", "content": "Do an incremental link if possible; otherwise, do a full link and prepare output for\nincremental linking\n", "long": "--incremental" }, { "name": "--no-incremental", "content": "Do a full link (default)\n", "long": "--no-incremental" }, { "name": "--incremental-full", "content": "Do a full link and prepare output for incremental linking\n", "long": "--incremental-full" }, { "name": "--incremental-update", "content": "Do an incremental link; exit if not possible\n\n--incremental-base FILE\nSet base file for incremental linking (default is output file)\n", "long": "--incremental-update" }, { "name": "--incremental-changed", "content": "Assume files changed\n", "long": "--incremental-changed" }, { "name": "--incremental-unchanged", "content": "Assume files didn't change\n", "long": "--incremental-unchanged" }, { "name": "--incremental-unknown", "content": "Use timestamps to check files (default)\n", "long": "--incremental-unknown" }, { "name": "--incremental-startup-unchanged", "content": "Assume startup files unchanged (files preceding this option)\n\n--incremental-patch PERCENT Amount of extra space to allocate for patches (default 10)\n", "long": "--incremental-startup-unchanged" }, { "name": "-init", "content": "Call SYMBOL at load-time\n" }, { "name": "-I --dynamic-linker", "content": "Set dynamic linker path\n\n--just-symbols FILE\nRead only symbol values from FILE\n", "flag": "-I", "long": "--dynamic-linker" }, { "name": "--keep-files-mapped", "content": "Keep files mapped across passes (default)\n", "long": "--keep-files-mapped" }, { "name": "--no-keep-files-mapped", "content": "Release mapped files after each pass\n\n--keep-unique SYMBOL\nDo not fold this symbol during ICF\n", "long": "--no-keep-files-mapped" }, { "name": "-l --library", "content": "Search for library LIBNAME\n", "flag": "-l", "long": "--library" }, { "name": "--ld-generated-unwind-info", "content": "Generate unwind information for PLT (default)\n", "long": "--ld-generated-unwind-info" }, { "name": "--no-ld-generated-unwind-info", "content": "Do not generate unwind information for PLT\n", "long": "--no-ld-generated-unwind-info" }, { "name": "-L --library-path", "content": "Add directory to search path\n", "flag": "-L", "long": "--library-path" }, { "name": "--long-plt", "content": "(ARM only) Generate long PLT entries\n", "long": "--long-plt" }, { "name": "--no-long-plt", "content": "(ARM only) Do not generate long PLT entries (default)\n", "long": "--no-long-plt" }, { "name": "-m", "content": "Set GNU linker emulation; obsolete\n", "flag": "-m" }, { "name": "--map-whole-files", "content": "Map whole files to memory (default)\n", "long": "--map-whole-files" }, { "name": "--no-map-whole-files", "content": "Map relevant file parts to memory\n", "long": "--no-map-whole-files" }, { "name": "--merge-exidx-entries", "content": "(ARM only) Merge exidx entries in debuginfo (default)\n", "long": "--merge-exidx-entries" }, { "name": "--no-merge-exidx-entries", "content": "(ARM only) Do not merge exidx entries in debuginfo\n", "long": "--no-merge-exidx-entries" }, { "name": "--mmap-output-file", "content": "Map the output file for writing (default)\n", "long": "--mmap-output-file" }, { "name": "--no-mmap-output-file", "content": "Do not map the output file for writing\n", "long": "--no-mmap-output-file" }, { "name": "-M --print-map", "content": "Write map file on standard output\n", "flag": "-M", "long": "--print-map" }, { "name": "-Map", "content": "Write map file\n" }, { "name": "-n --nmagic", "content": "Do not page align data\n", "flag": "-n", "long": "--nmagic" }, { "name": "-N --omagic", "content": "Do not page align data, do not make text readonly\n", "flag": "-N", "long": "--omagic" }, { "name": "--no-omagic", "content": "Page align data, make text readonly (default)\n", "long": "--no-omagic" }, { "name": "--no-keep-memory", "content": "Use less memory and more disk I/O (included only for compatibility with GNU ld)\n", "long": "--no-keep-memory" }, { "name": "--no-undefined", "content": "Report undefined symbols (even with --shared)\n", "long": "--no-undefined" }, { "name": "--noinhibit-exec", "content": "Create an output file even if errors occur\n", "long": "--noinhibit-exec" }, { "name": "-nostdlib", "content": "Only search directories specified on the command line\n" }, { "name": "-o --output", "content": "Set output file name\n\n--oformat [binary]\nSet output format\n", "flag": "-o", "long": "--output" }, { "name": "-O -optimize", "content": "Optimize output file size\n\n--orphan-handling [place,discard,warn,error]\nOrphan section handling\n", "flag": "-O" }, { "name": "-p", "content": "", "flag": "-p" }, { "name": "-pie", "content": "" }, { "name": "-no-pie", "content": "Do not create a position independent executable (default)\n" }, { "name": "--pic-executable", "content": "Create a position independent executable\n", "long": "--pic-executable" }, { "name": "--no-pic-executable", "content": "Do not create a position independent executable (default)\n", "long": "--no-pic-executable" }, { "name": "--pic-veneer", "content": "Force PIC sequences for ARM/Thumb interworking veneers\n", "long": "--pic-veneer" }, { "name": "-no-pipeline-knowledge", "content": "(ARM only) Ignore for backward compatibility (default)\n\n--plt-align [=P2ALIGN]\n(PowerPC only) Align PLT call stubs to fit cache lines\n" }, { "name": "--plt-localentry", "content": "(PowerPC64 only) Optimize calls to ELFv2 localentry:0 functions\n", "long": "--plt-localentry" }, { "name": "--no-plt-localentry", "content": "(PowerPC64 only) Don't optimize ELFv2 calls (default)\n", "long": "--no-plt-localentry" }, { "name": "--plt-static-chain", "content": "(PowerPC64 only) PLT call stubs should load r11\n", "long": "--plt-static-chain" }, { "name": "--no-plt-static-chain", "content": "(PowerPC64 only) PLT call stubs should not load r11 (default)\n", "long": "--no-plt-static-chain" }, { "name": "--plt-thread-safe", "content": "(PowerPC64 only) PLT call stubs with load-load barrier\n", "long": "--plt-thread-safe" }, { "name": "--no-plt-thread-safe", "content": "(PowerPC64 only) PLT call stubs without barrier (default)\n\n--plugin PLUGIN\nLoad a plugin library\n\n--plugin-opt OPTION\nPass an option to the plugin\n", "long": "--no-plt-thread-safe" }, { "name": "--posix-fallocate", "content": "Use posixfallocate to reserve space in the output file (default)\n", "long": "--posix-fallocate" }, { "name": "--no-posix-fallocate", "content": "Use fallocate or ftruncate to reserve space\n\n--power10-stubs [=auto,no,yes]\n(PowerPC64 only) stubs use power10 insns\n", "long": "--no-posix-fallocate" }, { "name": "--no-power10-stubs", "content": "(PowerPC64 only) stubs do not use power10 insns\n", "long": "--no-power10-stubs" }, { "name": "--preread-archive-symbols", "content": "Preread archive symbols when multi-threaded\n", "long": "--preread-archive-symbols" }, { "name": "--print-gc-sections", "content": "List removed unused sections on stderr\n", "long": "--print-gc-sections" }, { "name": "--no-print-gc-sections", "content": "Do not list removed unused sections (default)\n", "long": "--no-print-gc-sections" }, { "name": "--print-icf-sections", "content": "List folded identical sections on stderr\n", "long": "--print-icf-sections" }, { "name": "--no-print-icf-sections", "content": "Do not list folded identical sections (default)\n", "long": "--no-print-icf-sections" }, { "name": "--print-output-format", "content": "Print default output format\n\n--print-symbol-counts FILENAME\nPrint symbols defined and used for each input\n", "long": "--print-output-format" }, { "name": "--push-state", "content": "Save the state of flags related to input files\n", "long": "--push-state" }, { "name": "--pop-state", "content": "Restore the state of flags related to input files\n", "long": "--pop-state" }, { "name": "-q --emit-relocs", "content": "Generate relocations in output\n", "flag": "-q", "long": "--emit-relocs" }, { "name": "-Qy", "content": "" }, { "name": "-r -relocatable", "content": "Generate relocatable output\n", "flag": "-r" }, { "name": "--relax", "content": "Relax branches on certain targets\n", "long": "--relax" }, { "name": "--no-relax", "content": "Do not relax branches (default)\n\n--retain-symbols-file FILE\nkeep only symbols listed in this file\n", "long": "--no-relax" }, { "name": "--rosegment", "content": "Put read-only non-executable sections in their own segment\n", "long": "--rosegment" }, { "name": "--no-rosegment", "content": "Do not put read-only non-executable sections in their own segment (default)\n\n--rosegment-gap OFFSET\nSet offset between executable and read-only segments\n", "long": "--no-rosegment" }, { "name": "-R", "content": "", "flag": "-R" }, { "name": "-rpath", "content": "Add DIR to runtime search path\n\n--rpath-link DIR\nAdd DIR to link time shared library search path\n" }, { "name": "-s --strip-all", "content": "Strip all symbols\n", "flag": "-s", "long": "--strip-all" }, { "name": "-S --strip-debug", "content": "Strip debugging information\n", "flag": "-S", "long": "--strip-debug" }, { "name": "--strip-debug-non-line", "content": "Emit only debug line number information\n", "long": "--strip-debug-non-line" }, { "name": "--strip-debug-gdb", "content": "Strip debug symbols that are unused by gdb (at least versions <= 7.4)\n", "long": "--strip-debug-gdb" }, { "name": "--strip-lto-sections", "content": "Strip LTO intermediate code sections (default)\n\n--section-ordering-file FILENAME\nLayout sections in the order specified\n\n--section-start SECTION=ADDRESS\nSet address of section\n", "long": "--strip-lto-sections" }, { "name": "--secure-plt", "content": "(PowerPC only) Use new-style PLT (default)\n\n--sort-common [={ascending,descending}]\nSort common symbols by alignment\n\n--sort-section [none,name]\nSort sections by name. '--no-text-reorder' will override '--sort-section=name' for\n.text\n\n--spare-dynamic-tags COUNT\nDynamic tag slots to reserve (default 5)\n\n--stub-group-size SIZE\n(ARM, PowerPC only) The maximum distance from instructions in a group of sections to\ntheir stubs. Negative values mean stubs are always after the group. 1 means use de‐\nfault size\n", "long": "--secure-plt" }, { "name": "--stub-group-multi", "content": "(PowerPC only) Allow a group of stubs to serve multiple output sections (default)\n", "long": "--stub-group-multi" }, { "name": "--no-stub-group-multi", "content": "(PowerPC only) Each output section has its own stubs\n\n--split-stack-adjust-size SIZE\nStack size when -fsplit-stack function calls non-split\n", "long": "--no-stub-group-multi" }, { "name": "-static", "content": "Do not link against shared libraries\n" }, { "name": "--start-lib", "content": "Start a library\n", "long": "--start-lib" }, { "name": "--end-lib", "content": "End a library\n", "long": "--end-lib" }, { "name": "--stats", "content": "Print resource usage statistics\n\n--sysroot DIR\nSet target system root directory\n", "long": "--stats" }, { "name": "-t --trace", "content": "Print the name of each input file\n", "flag": "-t", "long": "--trace" }, { "name": "--target1-abs", "content": "(ARM only) Force RARMTARGET1 type to RARMABS32\n", "long": "--target1-abs" }, { "name": "--target1-rel", "content": "(ARM only) Force RARMTARGET1 type to RARMREL32\n\n--target2 [rel, abs, got-rel\n(ARM only) Set RARMTARGET2 relocation type\n", "long": "--target1-rel" }, { "name": "--text-reorder", "content": "Enable text section reordering for GCC section names (default)\n", "long": "--text-reorder" }, { "name": "--no-text-reorder", "content": "Disable text section reordering for GCC section names\n", "long": "--no-text-reorder" }, { "name": "--threads", "content": "Run the linker multi-threaded\n", "long": "--threads" }, { "name": "--no-threads", "content": "Do not run the linker multi-threaded (default)\n\n--thread-count COUNT\nNumber of threads to use\n\n--thread-count-initial COUNT\nNumber of threads to use in initial pass\n\n--thread-count-middle COUNT Number of threads to use in middle pass\n\n--thread-count-final COUNT\nNumber of threads to use in final pass\n", "long": "--no-threads" }, { "name": "--tls-optimize", "content": "(PowerPC/64 only) Optimize GD/LD/IE code to IE/LE (default)\n", "long": "--tls-optimize" }, { "name": "--no-tls-optimize", "content": "(PowerPC/64 only) Don'''t try to optimize TLS accesses\n", "long": "--no-tls-optimize" }, { "name": "--tls-get-addr-optimize", "content": "(PowerPC/64 only) Use a special tlsgetaddr call (default)\n", "long": "--tls-get-addr-optimize" }, { "name": "--no-tls-get-addr-optimize", "content": "(PowerPC/64 only) Don't use a special tlsgetaddr call\n", "long": "--no-tls-get-addr-optimize" }, { "name": "--toc-optimize", "content": "(PowerPC64 only) Optimize TOC code sequences (default)\n", "long": "--toc-optimize" }, { "name": "--no-toc-optimize", "content": "(PowerPC64 only) Don't optimize TOC code sequences\n", "long": "--no-toc-optimize" }, { "name": "--toc-sort", "content": "(PowerPC64 only) Sort TOC and GOT sections (default)\n", "long": "--toc-sort" }, { "name": "--no-toc-sort", "content": "(PowerPC64 only) Don't sort TOC and GOT sections\n", "long": "--no-toc-sort" }, { "name": "-T --script", "content": "Read linker script\n", "flag": "-T", "long": "--script" }, { "name": "-Tbss", "content": "Set the address of the bss segment\n" }, { "name": "-Tdata", "content": "Set the address of the data segment\n" }, { "name": "-Ttext", "content": "Set the address of the text segment\n" }, { "name": "-Ttext-segment", "content": "Set the address of the text segment\n" }, { "name": "-Trodata-segment", "content": "Set the address of the rodata segment\n" }, { "name": "-u --undefined", "content": "Create undefined reference to SYMBOL\n\n--unresolved-symbols ignore-all,report-all,ignore-in-object-files,ignore-in-shared-libs\nHow to handle unresolved symbols\n", "flag": "-u", "long": "--undefined" }, { "name": "--verbose", "content": "Alias for --debug=files\n\n--version-script FILE\nRead version script\n", "long": "--verbose" }, { "name": "--warn-common", "content": "Warn about duplicate common symbols\n", "long": "--warn-common" }, { "name": "--no-warn-common", "content": "Do not warn about duplicate common symbols (default)\n", "long": "--no-warn-common" }, { "name": "--warn-constructors", "content": "Ignored\n", "long": "--warn-constructors" }, { "name": "--no-warn-constructors", "content": "Ignored\n", "long": "--no-warn-constructors" }, { "name": "--warn-drop-version", "content": "Warn when discarding version information\n", "long": "--warn-drop-version" }, { "name": "--no-warn-drop-version", "content": "Do not warn when discarding version information (default)\n", "long": "--no-warn-drop-version" }, { "name": "--warn-execstack", "content": "Warn if the stack is executable\n", "long": "--warn-execstack" }, { "name": "--no-warn-execstack", "content": "Do not warn if the stack is executable (default)\n", "long": "--no-warn-execstack" }, { "name": "--no-warn-mismatch", "content": "Don't warn about mismatched input files\n", "long": "--no-warn-mismatch" }, { "name": "--warn-multiple-gp", "content": "Ignored\n", "long": "--warn-multiple-gp" }, { "name": "--warn-search-mismatch", "content": "Warn when skipping an incompatible library (default)\n", "long": "--warn-search-mismatch" }, { "name": "--no-warn-search-mismatch", "content": "Don't warn when skipping an incompatible library\n", "long": "--no-warn-search-mismatch" }, { "name": "--warn-shared-textrel", "content": "Warn if text segment is not shareable\n", "long": "--warn-shared-textrel" }, { "name": "--no-warn-shared-textrel", "content": "Do not warn if text segment is not shareable (default)\n", "long": "--no-warn-shared-textrel" }, { "name": "--warn-unresolved-symbols", "content": "Report unresolved symbols as warnings\n", "long": "--warn-unresolved-symbols" }, { "name": "--error-unresolved-symbols", "content": "Report unresolved symbols as errors (default)\n", "long": "--error-unresolved-symbols" }, { "name": "-z", "content": "Dummy z option\n", "flag": "-z" }, { "name": "--no-wchar-size-warning", "content": "(ARM only) Do not warn about objects with incompatible wchart sizes\n", "long": "--no-wchar-size-warning" }, { "name": "--weak-unresolved-symbols", "content": "Convert unresolved symbols to weak references\n", "long": "--weak-unresolved-symbols" }, { "name": "--whole-archive", "content": "Include all archive contents\n", "long": "--whole-archive" }, { "name": "--no-whole-archive", "content": "Include only needed archive contents (default)\n\n--wrap SYMBOL\nUse wrapper functions for SYMBOL\n", "long": "--no-whole-archive" }, { "name": "-x --discard-all", "content": "Delete all local symbols\n", "flag": "-x", "long": "--discard-all" }, { "name": "-X --discard-locals", "content": "Delete all temporary local symbols\n", "flag": "-X", "long": "--discard-locals" }, { "name": "--discard-none", "content": "Keep all local symbols\n", "long": "--discard-none" }, { "name": "-y --trace-symbol", "content": "Trace references to symbol\n", "flag": "-y", "long": "--trace-symbol" }, { "name": "--undefined-version", "content": "Allow unused version in script (default)\n", "long": "--undefined-version" }, { "name": "--no-undefined-version", "content": "Do not allow unused version in script\n", "long": "--no-undefined-version" }, { "name": "-Y", "content": "Default search path for Solaris compatibility\n\n-(, --start-group\nStart a library search group\n\n-), --end-group\nEnd a library search group\n", "flag": "-Y" }, { "name": "-z", "content": "(x86-64 only) Generate a BND PLT for Intel MPX\n", "flag": "-z" }, { "name": "-z", "content": "Generate a regular PLT (default)\n", "flag": "-z" }, { "name": "-z", "content": "Sort dynamic relocs (default)\n", "flag": "-z" }, { "name": "-z", "content": "Do not sort dynamic relocs\n", "flag": "-z" }, { "name": "-z", "content": "Set common page size to SIZE\n", "flag": "-z" }, { "name": "-z", "content": "Report undefined symbols (even with --shared)\n", "flag": "-z" }, { "name": "-z", "content": "Mark output as requiring executable stack\n", "flag": "-z" }, { "name": "-z", "content": "Make symbols in DSO available for subsequently loaded objects\n", "flag": "-z" }, { "name": "-z", "content": "Mark DSO to be initialized first at runtime\n", "flag": "-z" }, { "name": "-z", "content": "Mark object to interpose all DSOs but executable\n", "flag": "-z" }, { "name": "-z", "content": "Mark DSO to be loaded at most once, and only in the main namespace\n", "flag": "-z" }, { "name": "-z", "content": "Do not mark the DSO as one to be loaded only in the main namespace (default)\n", "flag": "-z" }, { "name": "-z", "content": "Mark object for lazy runtime binding (default)\n", "flag": "-z" }, { "name": "-z", "content": "Mark object requiring immediate process\n", "flag": "-z" }, { "name": "-z", "content": "Set maximum page size to SIZE\n", "flag": "-z" }, { "name": "-z", "content": "Allow multiple definitions of symbols\n", "flag": "-z" }, { "name": "-z", "content": "Do not create copy relocs\n", "flag": "-z" }, { "name": "-z", "content": "Mark object not to use default search paths\n", "flag": "-z" }, { "name": "-z", "content": "Mark DSO non-deletable at runtime\n", "flag": "-z" }, { "name": "-z", "content": "Mark DSO not available to dlopen\n", "flag": "-z" }, { "name": "-z", "content": "Mark DSO not available to dldump\n", "flag": "-z" }, { "name": "-z", "content": "Mark output as not requiring executable stack\n", "flag": "-z" }, { "name": "-z", "content": "", "flag": "-z" }, { "name": "-z", "content": "Mark DSO to indicate that needs immediate $ORIGIN processing at runtime\n", "flag": "-z" }, { "name": "-z", "content": "Where possible mark variables read-only after relocation (default)\n", "flag": "-z" }, { "name": "-z", "content": "Don't mark variables read-only after relocation\n", "flag": "-z" }, { "name": "-z", "content": "Set PTGNUSTACK segment pmemsz to SIZE\n", "flag": "-z" }, { "name": "-z", "content": "ELF symbol visibility for synthesized start* and stop* symbols\n", "flag": "-z" }, { "name": "-z", "content": "Do not permit relocations in read-only segments\n", "flag": "-z" }, { "name": "-z", "content": "Permit relocations in read-only segments (default)\n", "flag": "-z" }, { "name": "-z", "content": "Permit relocations in read-only segments (default)\n", "flag": "-z" }, { "name": "-z", "content": "Move .text.unlikely sections to a separate segment.\n", "flag": "-z" }, { "name": "-z", "content": "Do not move .text.unlikely sections to a separate segment. (default)\n", "flag": "-z" }, { "name": "-z", "content": "separate sections in the final binary.\n", "flag": "-z" }, { "name": "-z", "content": "Merge all .text.* prefix sections. (default)\n\ndebian/tmp/usr/bin/ld.gold: supported targets: elf32-x86-64 elf32-x86-64-freebsd\nelf32-x86-64-nacl elf64-x86-64 elf64-x86-64-freebsd elf64-x86-64-nacl elf32-iamcu elf32-i386\nelf32-i386-freebsd elf32-i386-nacl debian/tmp/usr/bin/ld.gold: supported emulations:\nelf32x8664 elf32x8664nacl elfx8664 elfx8664nacl elfiamcu elfi386 elfi386nacl\n", "flag": "-z" } ] }, "REPORTING BUGS": { "content": "Report bugs to \n", "subsections": [] }, "COPYRIGHT": { "content": "Copyright © 2022 Free Software Foundation, Inc. This program is free software; you may re‐\ndistribute it under the terms of the GNU General Public License version 3 or (at your option)\na later version. This program has absolutely no warranty.\n\n\n\nGNU gold (GNU Binutils for Ubuntu 2.37.50.20January 2022 GOLD(1)", "subsections": [] } } } }