10b57cec5SDimitry Andricinclude "llvm/Option/OptParser.td" 20b57cec5SDimitry Andric 30b57cec5SDimitry Andric// For options whose names are multiple letters, either one dash or 40b57cec5SDimitry Andric// two can precede the option name except those that start with 'o'. 50b57cec5SDimitry Andricclass F<string name>: Flag<["--", "-"], name>; 60b57cec5SDimitry Andricclass J<string name>: Joined<["--", "-"], name>; 70b57cec5SDimitry Andric 80b57cec5SDimitry Andricmulticlass Eq<string name, string help> { 90b57cec5SDimitry Andric def NAME: Separate<["--", "-"], name>; 100b57cec5SDimitry Andric def NAME # _eq: Joined<["--", "-"], name # "=">, Alias<!cast<Separate>(NAME)>, 110b57cec5SDimitry Andric HelpText<help>; 120b57cec5SDimitry Andric} 130b57cec5SDimitry Andric 140b57cec5SDimitry Andricmulticlass B<string name, string help1, string help2> { 150b57cec5SDimitry Andric def NAME: Flag<["--", "-"], name>, HelpText<help1>; 160b57cec5SDimitry Andric def no_ # NAME: Flag<["--", "-"], "no-" # name>, HelpText<help2>; 170b57cec5SDimitry Andric} 180b57cec5SDimitry Andric 190b57cec5SDimitry Andricdefm auxiliary: Eq<"auxiliary", "Set DT_AUXILIARY field to the specified name">; 200b57cec5SDimitry Andric 210b57cec5SDimitry Andricdef Bsymbolic: F<"Bsymbolic">, HelpText<"Bind defined symbols locally">; 220b57cec5SDimitry Andric 230b57cec5SDimitry Andricdef Bsymbolic_functions: F<"Bsymbolic-functions">, 240b57cec5SDimitry Andric HelpText<"Bind defined function symbols locally">; 250b57cec5SDimitry Andric 260b57cec5SDimitry Andricdef Bdynamic: F<"Bdynamic">, HelpText<"Link against shared libraries (default)">; 270b57cec5SDimitry Andric 280b57cec5SDimitry Andricdef Bstatic: F<"Bstatic">, HelpText<"Do not link against shared libraries">; 290b57cec5SDimitry Andric 300b57cec5SDimitry Andricdef build_id: F<"build-id">, HelpText<"Alias for --build-id=fast">; 310b57cec5SDimitry Andric 320b57cec5SDimitry Andricdef build_id_eq: J<"build-id=">, HelpText<"Generate build ID note">, 330b57cec5SDimitry Andric MetaVarName<"[fast,md5,sha1,uuid,0x<hexstring>]">; 340b57cec5SDimitry Andric 350b57cec5SDimitry Andricdefm check_sections: B<"check-sections", 360b57cec5SDimitry Andric "Check section addresses for overlaps (default)", 370b57cec5SDimitry Andric "Do not check section addresses for overlaps">; 380b57cec5SDimitry Andric 390b57cec5SDimitry Andricdefm compress_debug_sections: 400b57cec5SDimitry Andric Eq<"compress-debug-sections", "Compress DWARF debug sections">, 410b57cec5SDimitry Andric MetaVarName<"[none,zlib]">; 420b57cec5SDimitry Andric 430b57cec5SDimitry Andricdefm defsym: Eq<"defsym", "Define a symbol alias">, MetaVarName<"<symbol>=<value>">; 440b57cec5SDimitry Andric 450b57cec5SDimitry Andricdefm split_stack_adjust_size 460b57cec5SDimitry Andric : Eq<"split-stack-adjust-size", 470b57cec5SDimitry Andric "Specify adjustment to stack size when a split-stack function calls a " 480b57cec5SDimitry Andric "non-split-stack function">, 490b57cec5SDimitry Andric MetaVarName<"<value>">; 500b57cec5SDimitry Andric 510b57cec5SDimitry Andricdefm library_path: 520b57cec5SDimitry Andric Eq<"library-path", "Add a directory to the library search path">, MetaVarName<"<dir>">; 530b57cec5SDimitry Andric 540b57cec5SDimitry Andricdef O: JoinedOrSeparate<["-"], "O">, HelpText<"Optimize output file size">; 550b57cec5SDimitry Andric 560b57cec5SDimitry Andricdefm Tbss: Eq<"Tbss", "Same as --section-start with .bss as the sectionname">; 570b57cec5SDimitry Andric 580b57cec5SDimitry Andricdefm Tdata: Eq<"Tdata", "Same as --section-start with .data as the sectionname">; 590b57cec5SDimitry Andric 600b57cec5SDimitry Andricdefm Ttext: Eq<"Ttext", "Same as --section-start with .text as the sectionname">; 610b57cec5SDimitry Andric 62*480093f4SDimitry Andricdef Ttext_segment: Separate<["-", "--"], "Ttext-segment">; 63*480093f4SDimitry Andric 640b57cec5SDimitry Andricdefm allow_multiple_definition: B<"allow-multiple-definition", 650b57cec5SDimitry Andric "Allow multiple definitions", 660b57cec5SDimitry Andric "Do not allow multiple definitions (default)">; 670b57cec5SDimitry Andric 680b57cec5SDimitry Andricdefm allow_shlib_undefined: B<"allow-shlib-undefined", 690b57cec5SDimitry Andric "Allow unresolved references in shared libraries (default when linking a shared library)", 700b57cec5SDimitry Andric "Do not allow unresolved references in shared libraries (default when linking an executable)">; 710b57cec5SDimitry Andric 720b57cec5SDimitry Andricdefm apply_dynamic_relocs: B<"apply-dynamic-relocs", 730b57cec5SDimitry Andric "Apply link-time values for dynamic relocations", 740b57cec5SDimitry Andric "Do not apply link-time values for dynamic relocations (default)">; 750b57cec5SDimitry Andric 760b57cec5SDimitry Andricdefm dependent_libraries: B<"dependent-libraries", 770b57cec5SDimitry Andric "Process dependent library specifiers from input files (default)", 780b57cec5SDimitry Andric "Ignore dependent library specifiers from input files">; 790b57cec5SDimitry Andric 800b57cec5SDimitry Andricdefm as_needed: B<"as-needed", 810b57cec5SDimitry Andric "Only set DT_NEEDED for shared libraries if used", 820b57cec5SDimitry Andric "Always set DT_NEEDED for shared libraries (default)">; 830b57cec5SDimitry Andric 840b57cec5SDimitry Andricdefm call_graph_ordering_file: 850b57cec5SDimitry Andric Eq<"call-graph-ordering-file", "Layout sections to optimize the given callgraph">; 860b57cec5SDimitry Andric 870b57cec5SDimitry Andricdefm call_graph_profile_sort: B<"call-graph-profile-sort", 880b57cec5SDimitry Andric "Reorder sections with call graph profile (default)", 890b57cec5SDimitry Andric "Do not reorder sections with call graph profile">; 900b57cec5SDimitry Andric 910b57cec5SDimitry Andric// -chroot doesn't have a help text because it is an internal option. 920b57cec5SDimitry Andricdef chroot: Separate<["--", "-"], "chroot">; 930b57cec5SDimitry Andric 940b57cec5SDimitry Andricdef color_diagnostics: F<"color-diagnostics">, 950b57cec5SDimitry Andric HelpText<"Alias for --color-diagnostics=always">; 960b57cec5SDimitry Andric 970b57cec5SDimitry Andricdef color_diagnostics_eq: J<"color-diagnostics=">, 980b57cec5SDimitry Andric HelpText<"Use colors in diagnostics">, 990b57cec5SDimitry Andric MetaVarName<"[auto,always,never]">; 1000b57cec5SDimitry Andric 1010b57cec5SDimitry Andricdefm cref: B<"cref", 1020b57cec5SDimitry Andric "Output cross reference table", 1030b57cec5SDimitry Andric "Do not output cross reference table">; 1040b57cec5SDimitry Andric 1050b57cec5SDimitry Andricdefm define_common: B<"define-common", 1060b57cec5SDimitry Andric "Assign space to common symbols", 1070b57cec5SDimitry Andric "Do not assign space to common symbols">; 1080b57cec5SDimitry Andric 1090b57cec5SDimitry Andricdefm demangle: B<"demangle", 1100b57cec5SDimitry Andric "Demangle symbol names (default)", 1110b57cec5SDimitry Andric "Do not demangle symbol names">; 1120b57cec5SDimitry Andric 1130b57cec5SDimitry Andricdef disable_new_dtags: F<"disable-new-dtags">, 1140b57cec5SDimitry Andric HelpText<"Disable new dynamic tags">; 1150b57cec5SDimitry Andric 1160b57cec5SDimitry Andricdef discard_all: F<"discard-all">, HelpText<"Delete all local symbols">; 1170b57cec5SDimitry Andric 1180b57cec5SDimitry Andricdef discard_locals: F<"discard-locals">, 1190b57cec5SDimitry Andric HelpText<"Delete temporary local symbols">; 1200b57cec5SDimitry Andric 1210b57cec5SDimitry Andricdef discard_none: F<"discard-none">, 1220b57cec5SDimitry Andric HelpText<"Keep all symbols in the symbol table">; 1230b57cec5SDimitry Andric 1240b57cec5SDimitry Andricdefm dynamic_linker: Eq<"dynamic-linker", "Which dynamic linker to use">; 1250b57cec5SDimitry Andric 1260b57cec5SDimitry Andricdefm dynamic_list: Eq<"dynamic-list", "Read a list of dynamic symbols">; 1270b57cec5SDimitry Andric 1280b57cec5SDimitry Andricdefm eh_frame_hdr: B<"eh-frame-hdr", 1290b57cec5SDimitry Andric "Request creation of .eh_frame_hdr section and PT_GNU_EH_FRAME segment header", 1300b57cec5SDimitry Andric "Do not create .eh_frame_hdr section">; 1310b57cec5SDimitry Andric 1320b57cec5SDimitry Andricdef emit_relocs: F<"emit-relocs">, HelpText<"Generate relocations in output">; 1330b57cec5SDimitry Andric 1340b57cec5SDimitry Andricdef enable_new_dtags: F<"enable-new-dtags">, 1350b57cec5SDimitry Andric HelpText<"Enable new dynamic tags (default)">; 1360b57cec5SDimitry Andric 1370b57cec5SDimitry Andricdef end_group: F<"end-group">, 1380b57cec5SDimitry Andric HelpText<"Ignored for compatibility with GNU unless you pass --warn-backrefs">; 1390b57cec5SDimitry Andric 1400b57cec5SDimitry Andricdef end_lib: F<"end-lib">, 1410b57cec5SDimitry Andric HelpText<"End a grouping of objects that should be treated as if they were together in an archive">; 1420b57cec5SDimitry Andric 1430b57cec5SDimitry Andricdefm entry: Eq<"entry", "Name of entry point symbol">, 1440b57cec5SDimitry Andric MetaVarName<"<entry>">; 1450b57cec5SDimitry Andric 1460b57cec5SDimitry Andricdefm error_limit: 1470b57cec5SDimitry Andric Eq<"error-limit", "Maximum number of errors to emit before stopping (0 = no limit)">; 1480b57cec5SDimitry Andric 1490b57cec5SDimitry Andricdef error_unresolved_symbols: F<"error-unresolved-symbols">, 1500b57cec5SDimitry Andric HelpText<"Report unresolved symbols as errors">; 1510b57cec5SDimitry Andric 1520b57cec5SDimitry Andricdefm exclude_libs: Eq<"exclude-libs", "Exclude static libraries from automatic export">; 1530b57cec5SDimitry Andric 1540b57cec5SDimitry Andricdefm execute_only: B<"execute-only", 1550b57cec5SDimitry Andric "Mark executable sections unreadable", 1560b57cec5SDimitry Andric "Mark executable sections readable (default)">; 1570b57cec5SDimitry Andric 1580b57cec5SDimitry Andricdefm export_dynamic: B<"export-dynamic", 1590b57cec5SDimitry Andric "Put symbols in the dynamic symbol table", 1600b57cec5SDimitry Andric "Do not put symbols in the dynamic symbol table (default)">; 1610b57cec5SDimitry Andric 1620b57cec5SDimitry Andricdefm export_dynamic_symbol: 1630b57cec5SDimitry Andric Eq<"export-dynamic-symbol", "Put a symbol in the dynamic symbol table">; 1640b57cec5SDimitry Andric 1650b57cec5SDimitry Andricdefm fatal_warnings: B<"fatal-warnings", 1660b57cec5SDimitry Andric "Treat warnings as errors", 1670b57cec5SDimitry Andric "Do not treat warnings as errors (default)">; 1680b57cec5SDimitry Andric 1690b57cec5SDimitry Andricdefm filter: Eq<"filter", "Set DT_FILTER field to the specified name">; 1700b57cec5SDimitry Andric 1710b57cec5SDimitry Andricdefm fini: Eq<"fini", "Specify a finalizer function">, MetaVarName<"<symbol>">; 1720b57cec5SDimitry Andric 1730b57cec5SDimitry Andricdef fix_cortex_a53_843419: F<"fix-cortex-a53-843419">, 1740b57cec5SDimitry Andric HelpText<"Apply fixes for AArch64 Cortex-A53 erratum 843419">; 1750b57cec5SDimitry Andric 17685868e8aSDimitry Andricdef fix_cortex_a8: F<"fix-cortex-a8">, 17785868e8aSDimitry Andric HelpText<"Apply fixes for ARM Cortex-A8 erratum 657417">; 17885868e8aSDimitry Andric 1790b57cec5SDimitry Andricdefm format: Eq<"format", "Change the input format of the inputs following this option">, 1800b57cec5SDimitry Andric MetaVarName<"[default,elf,binary]">; 1810b57cec5SDimitry Andric 1820b57cec5SDimitry Andricdefm gc_sections: B<"gc-sections", 1830b57cec5SDimitry Andric "Enable garbage collection of unused sections", 1840b57cec5SDimitry Andric "Disable garbage collection of unused sections (default)">; 1850b57cec5SDimitry Andric 1860b57cec5SDimitry Andricdefm gdb_index: B<"gdb-index", 1870b57cec5SDimitry Andric "Generate .gdb_index section", 1880b57cec5SDimitry Andric "Do not generate .gdb_index section (default)">; 1890b57cec5SDimitry Andric 1900b57cec5SDimitry Andricdefm gnu_unique: B<"gnu-unique", 1910b57cec5SDimitry Andric "Enable STB_GNU_UNIQUE symbol binding (default)", 1920b57cec5SDimitry Andric "Disable STB_GNU_UNIQUE symbol binding">; 1930b57cec5SDimitry Andric 1940b57cec5SDimitry Andricdefm hash_style: Eq<"hash-style", "Specify hash style (sysv, gnu or both)">; 1950b57cec5SDimitry Andric 1960b57cec5SDimitry Andricdef help: F<"help">, HelpText<"Print option help">; 1970b57cec5SDimitry Andric 1980b57cec5SDimitry Andricdef icf_all: F<"icf=all">, HelpText<"Enable identical code folding">; 1990b57cec5SDimitry Andric 2000b57cec5SDimitry Andricdef icf_safe: F<"icf=safe">, HelpText<"Enable safe identical code folding">; 2010b57cec5SDimitry Andric 2020b57cec5SDimitry Andricdef icf_none: F<"icf=none">, HelpText<"Disable identical code folding (default)">; 2030b57cec5SDimitry Andric 2040b57cec5SDimitry Andricdef ignore_function_address_equality: F<"ignore-function-address-equality">, 2050b57cec5SDimitry Andric HelpText<"lld can break the address equality of functions">; 2060b57cec5SDimitry Andric 2070b57cec5SDimitry Andricdef ignore_data_address_equality: F<"ignore-data-address-equality">, 2080b57cec5SDimitry Andric HelpText<"lld can break the address equality of data">; 2090b57cec5SDimitry Andric 2100b57cec5SDimitry Andricdefm image_base: Eq<"image-base", "Set the base address">; 2110b57cec5SDimitry Andric 2120b57cec5SDimitry Andricdefm init: Eq<"init", "Specify an initializer function">, 2130b57cec5SDimitry Andric MetaVarName<"<symbol>">; 2140b57cec5SDimitry Andric 2150b57cec5SDimitry Andricdefm just_symbols: Eq<"just-symbols", "Just link symbols">; 2160b57cec5SDimitry Andric 2170b57cec5SDimitry Andricdefm keep_unique: Eq<"keep-unique", "Do not fold this symbol during ICF">; 2180b57cec5SDimitry Andric 2190b57cec5SDimitry Andricdefm library: Eq<"library", "Root name of library to use">, 2200b57cec5SDimitry Andric MetaVarName<"<libName>">; 2210b57cec5SDimitry Andric 2220b57cec5SDimitry Andricdef m: JoinedOrSeparate<["-"], "m">, HelpText<"Set target emulation">; 2230b57cec5SDimitry Andric 2240b57cec5SDimitry Andricdefm Map: Eq<"Map", "Print a link map to the specified file">; 2250b57cec5SDimitry Andric 2260b57cec5SDimitry Andricdefm merge_exidx_entries: B<"merge-exidx-entries", 2270b57cec5SDimitry Andric "Enable merging .ARM.exidx entries (default)", 2280b57cec5SDimitry Andric "Disable merging .ARM.exidx entries">; 2290b57cec5SDimitry Andric 230*480093f4SDimitry Andricdefm mmap_output_file: B<"mmap-output-file", 231*480093f4SDimitry Andric "Mmap the output file for writing (default)", 232*480093f4SDimitry Andric "Do not mmap the output file for writing">; 233*480093f4SDimitry Andric 2340b57cec5SDimitry Andricdef nmagic: F<"nmagic">, MetaVarName<"<magic>">, 2350b57cec5SDimitry Andric HelpText<"Do not page align sections, link against static libraries.">; 2360b57cec5SDimitry Andric 2370b57cec5SDimitry Andricdef nostdlib: F<"nostdlib">, 2380b57cec5SDimitry Andric HelpText<"Only search directories specified on the command line">; 2390b57cec5SDimitry Andric 2400b57cec5SDimitry Andricdef no_color_diagnostics: F<"no-color-diagnostics">, 2410b57cec5SDimitry Andric HelpText<"Do not use colors in diagnostics">; 2420b57cec5SDimitry Andric 2430b57cec5SDimitry Andricdef no_dynamic_linker: F<"no-dynamic-linker">, 2440b57cec5SDimitry Andric HelpText<"Inhibit output of .interp section">; 2450b57cec5SDimitry Andric 2460b57cec5SDimitry Andricdef noinhibit_exec: F<"noinhibit-exec">, 2470b57cec5SDimitry Andric HelpText<"Retain the executable output file whenever it is still usable">; 2480b57cec5SDimitry Andric 2490b57cec5SDimitry Andricdef no_nmagic: F<"no-nmagic">, MetaVarName<"<magic>">, 2500b57cec5SDimitry Andric HelpText<"Page align sections (default)">; 2510b57cec5SDimitry Andric 2520b57cec5SDimitry Andricdef no_omagic: F<"no-omagic">, MetaVarName<"<magic>">, 2530b57cec5SDimitry Andric HelpText<"Do not set the text data sections to be writable, page align sections (default)">; 2540b57cec5SDimitry Andric 2550b57cec5SDimitry Andricdef no_rosegment: F<"no-rosegment">, 2560b57cec5SDimitry Andric HelpText<"Do not put read-only non-executable sections in their own segment">; 2570b57cec5SDimitry Andric 2580b57cec5SDimitry Andricdef no_undefined: F<"no-undefined">, 2590b57cec5SDimitry Andric HelpText<"Report unresolved symbols even if the linker is creating a shared library">; 2600b57cec5SDimitry Andric 2610b57cec5SDimitry Andricdef o: JoinedOrSeparate<["-"], "o">, MetaVarName<"<path>">, 2620b57cec5SDimitry Andric HelpText<"Path to file to write output">; 2630b57cec5SDimitry Andric 2640b57cec5SDimitry Andricdef oformat: Separate<["--"], "oformat">, MetaVarName<"<format>">, 2650b57cec5SDimitry Andric HelpText<"Specify the binary format for the output object file">; 2660b57cec5SDimitry Andric 2670b57cec5SDimitry Andricdef omagic: Flag<["--"], "omagic">, MetaVarName<"<magic>">, 2680b57cec5SDimitry Andric HelpText<"Set the text and data sections to be readable and writable, do not page align sections, link against static libraries">; 2690b57cec5SDimitry Andric 2700b57cec5SDimitry Andricdefm orphan_handling: 2710b57cec5SDimitry Andric Eq<"orphan-handling", "Control how orphan sections are handled when linker script used">; 2720b57cec5SDimitry Andric 2730b57cec5SDimitry Andricdefm pack_dyn_relocs: 2740b57cec5SDimitry Andric Eq<"pack-dyn-relocs", "Pack dynamic relocations in the given format">, 2750b57cec5SDimitry Andric MetaVarName<"[none,android,relr,android+relr]">; 2760b57cec5SDimitry Andric 2770b57cec5SDimitry Andricdefm use_android_relr_tags: B<"use-android-relr-tags", 2780b57cec5SDimitry Andric "Use SHT_ANDROID_RELR / DT_ANDROID_RELR* tags instead of SHT_RELR / DT_RELR*", 2790b57cec5SDimitry Andric "Use SHT_RELR / DT_RELR* tags (default)">; 2800b57cec5SDimitry Andric 2810b57cec5SDimitry Andricdef pic_veneer: F<"pic-veneer">, 2820b57cec5SDimitry Andric HelpText<"Always generate position independent thunks (veneers)">; 2830b57cec5SDimitry Andric 2840b57cec5SDimitry Andricdefm pie: B<"pie", 2850b57cec5SDimitry Andric "Create a position independent executable", 2860b57cec5SDimitry Andric "Do not create a position independent executable (default)">; 2870b57cec5SDimitry Andric 2880b57cec5SDimitry Andricdefm print_gc_sections: B<"print-gc-sections", 2890b57cec5SDimitry Andric "List removed unused sections", 2900b57cec5SDimitry Andric "Do not list removed unused sections (default)">; 2910b57cec5SDimitry Andric 2920b57cec5SDimitry Andricdefm print_icf_sections: B<"print-icf-sections", 2930b57cec5SDimitry Andric "List identical folded sections", 2940b57cec5SDimitry Andric "Do not list identical folded sections (default)">; 2950b57cec5SDimitry Andric 2960b57cec5SDimitry Andricdefm print_symbol_order: Eq<"print-symbol-order", 297*480093f4SDimitry Andric "Print a symbol order specified by --call-graph-ordering-file into the specified file">; 2980b57cec5SDimitry Andric 2990b57cec5SDimitry Andricdef pop_state: F<"pop-state">, 3000b57cec5SDimitry Andric HelpText<"Undo the effect of -push-state">; 3010b57cec5SDimitry Andric 3020b57cec5SDimitry Andricdef push_state: F<"push-state">, 3030b57cec5SDimitry Andric HelpText<"Save the current state of -as-needed, -static and -whole-archive">; 3040b57cec5SDimitry Andric 3050b57cec5SDimitry Andricdef print_map: F<"print-map">, 3060b57cec5SDimitry Andric HelpText<"Print a link map to the standard output">; 3070b57cec5SDimitry Andric 30885868e8aSDimitry Andricdefm reproduce: Eq<"reproduce", "Write a tar file containing input files and command line options to reproduce link">; 3090b57cec5SDimitry Andric 3100b57cec5SDimitry Andricdefm rpath: Eq<"rpath", "Add a DT_RUNPATH to the output">; 3110b57cec5SDimitry Andric 3120b57cec5SDimitry Andricdef relocatable: F<"relocatable">, HelpText<"Create relocatable object file">; 3130b57cec5SDimitry Andric 3140b57cec5SDimitry Andricdefm retain_symbols_file: 3150b57cec5SDimitry Andric Eq<"retain-symbols-file", "Retain only the symbols listed in the file">, 3160b57cec5SDimitry Andric MetaVarName<"<file>">; 3170b57cec5SDimitry Andric 3180b57cec5SDimitry Andricdefm script: Eq<"script", "Read linker script">; 3190b57cec5SDimitry Andric 3200b57cec5SDimitry Andricdefm section_start: Eq<"section-start", "Set address of section">, 3210b57cec5SDimitry Andric MetaVarName<"<address>">; 3220b57cec5SDimitry Andric 3230b57cec5SDimitry Andricdef shared: F<"shared">, HelpText<"Build a shared object">; 3240b57cec5SDimitry Andric 3250b57cec5SDimitry Andricdefm soname: Eq<"soname", "Set DT_SONAME">; 3260b57cec5SDimitry Andric 3270b57cec5SDimitry Andricdefm sort_section: 3280b57cec5SDimitry Andric Eq<"sort-section", "Specifies sections sorting rule when linkerscript is used">; 3290b57cec5SDimitry Andric 3300b57cec5SDimitry Andricdef start_group: F<"start-group">, 3310b57cec5SDimitry Andric HelpText<"Ignored for compatibility with GNU unless you pass --warn-backrefs">; 3320b57cec5SDimitry Andric 3330b57cec5SDimitry Andricdef start_lib: F<"start-lib">, 3340b57cec5SDimitry Andric HelpText<"Start a grouping of objects that should be treated as if they were together in an archive">; 3350b57cec5SDimitry Andric 3360b57cec5SDimitry Andricdef strip_all: F<"strip-all">, HelpText<"Strip all symbols">; 3370b57cec5SDimitry Andric 3380b57cec5SDimitry Andricdef strip_debug: F<"strip-debug">, HelpText<"Strip debugging information">; 3390b57cec5SDimitry Andric 3400b57cec5SDimitry Andricdefm symbol_ordering_file: 3410b57cec5SDimitry Andric Eq<"symbol-ordering-file", "Layout sections to place symbols in the order specified by symbol ordering file">; 3420b57cec5SDimitry Andric 3430b57cec5SDimitry Andricdefm sysroot: Eq<"sysroot", "Set the system root">; 3440b57cec5SDimitry Andric 3450b57cec5SDimitry Andricdef target1_rel: F<"target1-rel">, HelpText<"Interpret R_ARM_TARGET1 as R_ARM_REL32">; 3460b57cec5SDimitry Andric 3470b57cec5SDimitry Andricdef target1_abs: F<"target1-abs">, HelpText<"Interpret R_ARM_TARGET1 as R_ARM_ABS32 (default)">; 3480b57cec5SDimitry Andric 3490b57cec5SDimitry Andricdefm target2: 3500b57cec5SDimitry Andric Eq<"target2", "Interpret R_ARM_TARGET2 as <type>, where <type> is one of rel, abs, or got-rel">, 3510b57cec5SDimitry Andric MetaVarName<"<type>">; 3520b57cec5SDimitry Andric 3530b57cec5SDimitry Andricdefm threads: B<"threads", 3540b57cec5SDimitry Andric "Run the linker multi-threaded (default)", 3550b57cec5SDimitry Andric "Do not run the linker multi-threaded">; 3560b57cec5SDimitry Andric 3570b57cec5SDimitry Andricdefm toc_optimize : B<"toc-optimize", 3580b57cec5SDimitry Andric "(PowerPC64) Enable TOC related optimizations (default)", 3590b57cec5SDimitry Andric "(PowerPC64) Disable TOC related optimizations">; 3600b57cec5SDimitry Andric 3610b57cec5SDimitry Andricdef trace: F<"trace">, HelpText<"Print the names of the input files">; 3620b57cec5SDimitry Andric 3630b57cec5SDimitry Andricdefm trace_symbol: Eq<"trace-symbol", "Trace references to symbols">; 3640b57cec5SDimitry Andric 3650b57cec5SDimitry Andricdefm undefined: Eq<"undefined", "Force undefined symbol during linking">, 3660b57cec5SDimitry Andric MetaVarName<"<symbol>">; 3670b57cec5SDimitry Andric 3680b57cec5SDimitry Andricdefm undefined_glob: Eq<"undefined-glob", "Force undefined symbol during linking">, 3690b57cec5SDimitry Andric MetaVarName<"<pattern>">; 3700b57cec5SDimitry Andric 3710b57cec5SDimitry Andricdefm unresolved_symbols: 3720b57cec5SDimitry Andric Eq<"unresolved-symbols", "Determine how to handle unresolved symbols">; 3730b57cec5SDimitry Andric 3740b57cec5SDimitry Andricdefm undefined_version: B<"undefined-version", 3750b57cec5SDimitry Andric "Allow unused version in version script (default)", 3760b57cec5SDimitry Andric "Report version scripts that refer undefined symbols">; 3770b57cec5SDimitry Andric 3780b57cec5SDimitry Andricdefm rsp_quoting: Eq<"rsp-quoting", "Quoting style for response files">, 3790b57cec5SDimitry Andric MetaVarName<"[posix,windows]">; 3800b57cec5SDimitry Andric 3810b57cec5SDimitry Andricdef v: Flag<["-"], "v">, HelpText<"Display the version number">; 3820b57cec5SDimitry Andric 3830b57cec5SDimitry Andricdef verbose: F<"verbose">, HelpText<"Verbose mode">; 3840b57cec5SDimitry Andric 3850b57cec5SDimitry Andricdef version: F<"version">, HelpText<"Display the version number and exit">; 3860b57cec5SDimitry Andric 3870b57cec5SDimitry Andricdefm version_script: Eq<"version-script", "Read a version script">; 3880b57cec5SDimitry Andric 3890b57cec5SDimitry Andricdefm warn_backrefs: B<"warn-backrefs", 3900b57cec5SDimitry Andric "Warn about backward symbol references to fetch archive members", 3910b57cec5SDimitry Andric "Do not warn about backward symbol references to fetch archive members (default)">; 3920b57cec5SDimitry Andric 3930b57cec5SDimitry Andricdefm warn_common: B<"warn-common", 3940b57cec5SDimitry Andric "Warn about duplicate common symbols", 3950b57cec5SDimitry Andric "Do not warn about duplicate common symbols (default)">; 3960b57cec5SDimitry Andric 3970b57cec5SDimitry Andricdefm warn_ifunc_textrel: B<"warn-ifunc-textrel", 3980b57cec5SDimitry Andric "Warn about using ifunc symbols with text relocations", 3990b57cec5SDimitry Andric "Do not warn about using ifunc symbols with text relocations (default)">; 4000b57cec5SDimitry Andric 4010b57cec5SDimitry Andricdefm warn_symbol_ordering: B<"warn-symbol-ordering", 4020b57cec5SDimitry Andric "Warn about problems with the symbol ordering file (default)", 4030b57cec5SDimitry Andric "Do not warn about problems with the symbol ordering file">; 4040b57cec5SDimitry Andric 4050b57cec5SDimitry Andricdef warn_unresolved_symbols: F<"warn-unresolved-symbols">, 4060b57cec5SDimitry Andric HelpText<"Report unresolved symbols as warnings">; 4070b57cec5SDimitry Andric 4080b57cec5SDimitry Andricdefm whole_archive: B<"whole-archive", 4090b57cec5SDimitry Andric "Force load of all members in a static library", 4100b57cec5SDimitry Andric "Do not force load of all members in a static library (default)">; 4110b57cec5SDimitry Andric 4120b57cec5SDimitry Andricdefm wrap: Eq<"wrap", "Use wrapper functions for symbol">, 4130b57cec5SDimitry Andric MetaVarName<"<symbol>=<symbol>">; 4140b57cec5SDimitry Andric 4150b57cec5SDimitry Andricdef z: JoinedOrSeparate<["-"], "z">, MetaVarName<"<option>">, 4160b57cec5SDimitry Andric HelpText<"Linker option extensions">; 4170b57cec5SDimitry Andric 4180b57cec5SDimitry Andricdef visual_studio_diagnostics_format : F<"vs-diagnostics">, 419*480093f4SDimitry AndricHelpText<"Format diagnostics for Visual Studio compatibility">; 4200b57cec5SDimitry Andric 4210b57cec5SDimitry Andric// Aliases 4220b57cec5SDimitry Andricdef: Separate<["-"], "f">, Alias<auxiliary>, HelpText<"Alias for --auxiliary">; 4230b57cec5SDimitry Andricdef: F<"call_shared">, Alias<Bdynamic>, HelpText<"Alias for --Bdynamic">; 4240b57cec5SDimitry Andricdef: F<"dy">, Alias<Bdynamic>, HelpText<"Alias for --Bdynamic">; 4250b57cec5SDimitry Andricdef: F<"dn">, Alias<Bstatic>, HelpText<"Alias for --Bstatic">; 4260b57cec5SDimitry Andricdef: F<"non_shared">, Alias<Bstatic>, HelpText<"Alias for --Bstatic">; 4270b57cec5SDimitry Andricdef: F<"static">, Alias<Bstatic>, HelpText<"Alias for --Bstatic">; 4280b57cec5SDimitry Andricdef: Flag<["-"], "d">, Alias<define_common>, HelpText<"Alias for --define-common">; 4290b57cec5SDimitry Andricdef: F<"dc">, Alias<define_common>, HelpText<"Alias for --define-common">; 4300b57cec5SDimitry Andricdef: F<"dp">, Alias<define_common>, HelpText<"Alias for --define-common">; 4310b57cec5SDimitry Andricdef: Flag<["-"], "x">, Alias<discard_all>, HelpText<"Alias for --discard-all">; 4320b57cec5SDimitry Andricdef: Flag<["-"], "X">, Alias<discard_locals>, HelpText<"Alias for --discard-locals">; 4330b57cec5SDimitry Andricdef: Flag<["-"], "q">, Alias<emit_relocs>, HelpText<"Alias for --emit-relocs">; 4340b57cec5SDimitry Andricdef: Flag<["-"], ")">, Alias<end_group>, HelpText<"Alias for --end-group">; 4350b57cec5SDimitry Andricdef: JoinedOrSeparate<["-"], "e">, Alias<entry>, HelpText<"Alias for --entry">; 4360b57cec5SDimitry Andricdef: Flag<["-"], "E">, Alias<export_dynamic>, HelpText<"Alias for --export-dynamic">; 4370b57cec5SDimitry Andricdef: Separate<["-"], "F">, Alias<filter>, HelpText<"Alias for --filter">; 4380b57cec5SDimitry Andricdef: Separate<["-"], "b">, Alias<format>, HelpText<"Alias for --format">; 4390b57cec5SDimitry Andricdef: JoinedOrSeparate<["-"], "l">, Alias<library>, HelpText<"Alias for --library">; 4400b57cec5SDimitry Andricdef: JoinedOrSeparate<["-"], "L">, Alias<library_path>, HelpText<"Alias for --library-path">; 4410b57cec5SDimitry Andricdef: F<"no-pic-executable">, Alias<no_pie>, HelpText<"Alias for --no-pie">; 4420b57cec5SDimitry Andricdef: Flag<["-"], "n">, Alias<nmagic>, HelpText<"Alias for --nmagic">; 4430b57cec5SDimitry Andricdef: Flag<["-"], "N">, Alias<omagic>, HelpText<"Alias for --omagic">; 4440b57cec5SDimitry Andricdef: Joined<["--"], "output=">, Alias<o>, HelpText<"Alias for -o">; 4450b57cec5SDimitry Andricdef: Separate<["--"], "output">, Alias<o>, HelpText<"Alias for -o">; 4460b57cec5SDimitry Andricdef: F<"pic-executable">, Alias<pie>, HelpText<"Alias for --pie">; 4470b57cec5SDimitry Andricdef: Flag<["-"], "M">, Alias<print_map>, HelpText<"Alias for --print-map">; 4480b57cec5SDimitry Andricdef: Flag<["-"], "r">, Alias<relocatable>, HelpText<"Alias for --relocatable">; 4490b57cec5SDimitry Andricdef: JoinedOrSeparate<["-"], "R">, Alias<rpath>, HelpText<"Alias for --rpath">; 4500b57cec5SDimitry Andricdef: JoinedOrSeparate<["-"], "T">, Alias<script>, HelpText<"Alias for --script">; 4510b57cec5SDimitry Andricdef: F<"Bshareable">, Alias<shared>, HelpText<"Alias for --shared">; 4520b57cec5SDimitry Andricdef: JoinedOrSeparate<["-"], "h">, Alias<soname>, HelpText<"Alias for --soname">; 4530b57cec5SDimitry Andricdef: Flag<["-"], "(">, Alias<start_group>, HelpText<"Alias for --start-group">; 4540b57cec5SDimitry Andricdef: Flag<["-"], "s">, Alias<strip_all>, HelpText<"Alias for --strip-all">; 4550b57cec5SDimitry Andricdef: Flag<["-"], "S">, Alias<strip_debug>, HelpText<"Alias for --strip-debug">; 4560b57cec5SDimitry Andricdef: Flag<["-"], "t">, Alias<trace>, HelpText<"Alias for --trace">; 457*480093f4SDimitry Andricdef: Joined<["-", "--"], "Ttext-segment=">, Alias<Ttext_segment>; 4580b57cec5SDimitry Andricdef: JoinedOrSeparate<["-"], "y">, Alias<trace_symbol>, HelpText<"Alias for --trace-symbol">; 4590b57cec5SDimitry Andricdef: JoinedOrSeparate<["-"], "u">, Alias<undefined>, HelpText<"Alias for --undefined">; 4600b57cec5SDimitry Andricdef: Flag<["-"], "V">, Alias<version>, HelpText<"Alias for --version">; 4610b57cec5SDimitry Andric 4620b57cec5SDimitry Andric// LTO-related options. 4630b57cec5SDimitry Andricdef lto_aa_pipeline: J<"lto-aa-pipeline=">, 4640b57cec5SDimitry Andric HelpText<"AA pipeline to run during LTO. Used in conjunction with -lto-newpm-passes">; 4650b57cec5SDimitry Andricdef lto_debug_pass_manager: F<"lto-debug-pass-manager">, 4660b57cec5SDimitry Andric HelpText<"Debug new pass manager">; 4670b57cec5SDimitry Andricdef lto_new_pass_manager: F<"lto-new-pass-manager">, 4680b57cec5SDimitry Andric HelpText<"Use new pass manager">; 4690b57cec5SDimitry Andricdef lto_newpm_passes: J<"lto-newpm-passes=">, 4700b57cec5SDimitry Andric HelpText<"Passes to run during LTO">; 4710b57cec5SDimitry Andricdef lto_O: J<"lto-O">, MetaVarName<"<opt-level>">, 4720b57cec5SDimitry Andric HelpText<"Optimization level for LTO">; 4730b57cec5SDimitry Andricdef lto_partitions: J<"lto-partitions=">, 4740b57cec5SDimitry Andric HelpText<"Number of LTO codegen partitions">; 4750b57cec5SDimitry Andricdef lto_cs_profile_generate: F<"lto-cs-profile-generate">, 476*480093f4SDimitry Andric HelpText<"Perform context sensitive PGO instrumentation">; 4770b57cec5SDimitry Andricdef lto_cs_profile_file: J<"lto-cs-profile-file=">, 4780b57cec5SDimitry Andric HelpText<"Context sensitive profile file path">; 47985868e8aSDimitry Andricdef lto_obj_path_eq: J<"lto-obj-path=">; 4800b57cec5SDimitry Andricdef lto_sample_profile: J<"lto-sample-profile=">, 4810b57cec5SDimitry Andric HelpText<"Sample profile file path">; 4820b57cec5SDimitry Andricdef disable_verify: F<"disable-verify">; 4830b57cec5SDimitry Andricdefm mllvm: Eq<"mllvm", "Additional arguments to forward to LLVM's option processing">; 4840b57cec5SDimitry Andricdef opt_remarks_filename: Separate<["--"], "opt-remarks-filename">, 4850b57cec5SDimitry Andric HelpText<"YAML output file for optimization remarks">; 4860b57cec5SDimitry Andricdef opt_remarks_passes: Separate<["--"], "opt-remarks-passes">, 4870b57cec5SDimitry Andric HelpText<"Regex for the passes that need to be serialized to the output file">; 4880b57cec5SDimitry Andricdef opt_remarks_with_hotness: Flag<["--"], "opt-remarks-with-hotness">, 4890b57cec5SDimitry Andric HelpText<"Include hotness information in the optimization remarks file">; 4900b57cec5SDimitry Andricdef opt_remarks_format: Separate<["--"], "opt-remarks-format">, 4910b57cec5SDimitry Andric HelpText<"The format used for serializing remarks (default: YAML)">; 4920b57cec5SDimitry Andricdefm plugin_opt: Eq<"plugin-opt", "specifies LTO options for compatibility with GNU linkers">; 4930b57cec5SDimitry Andricdef save_temps: F<"save-temps">; 4940b57cec5SDimitry Andricdef thinlto_cache_dir: J<"thinlto-cache-dir=">, 4950b57cec5SDimitry Andric HelpText<"Path to ThinLTO cached object file directory">; 4960b57cec5SDimitry Andricdefm thinlto_cache_policy: Eq<"thinlto-cache-policy", "Pruning policy for the ThinLTO cache">; 49785868e8aSDimitry Andricdef thinlto_emit_imports_files: F<"thinlto-emit-imports-files">; 49885868e8aSDimitry Andricdef thinlto_index_only: F<"thinlto-index-only">; 49985868e8aSDimitry Andricdef thinlto_index_only_eq: J<"thinlto-index-only=">; 5000b57cec5SDimitry Andricdef thinlto_jobs: J<"thinlto-jobs=">, HelpText<"Number of ThinLTO jobs">; 50185868e8aSDimitry Andricdef thinlto_object_suffix_replace_eq: J<"thinlto-object-suffix-replace=">; 50285868e8aSDimitry Andricdef thinlto_prefix_replace_eq: J<"thinlto-prefix-replace=">; 5030b57cec5SDimitry Andric 5040b57cec5SDimitry Andricdef: J<"plugin-opt=O">, Alias<lto_O>, HelpText<"Alias for -lto-O">; 5050b57cec5SDimitry Andricdef: F<"plugin-opt=debug-pass-manager">, 5060b57cec5SDimitry Andric Alias<lto_debug_pass_manager>, HelpText<"Alias for -lto-debug-pass-manager">; 5070b57cec5SDimitry Andricdef: F<"plugin-opt=disable-verify">, Alias<disable_verify>, HelpText<"Alias for -disable-verify">; 5080b57cec5SDimitry Andricdef plugin_opt_dwo_dir_eq: J<"plugin-opt=dwo_dir=">, 5090b57cec5SDimitry Andric HelpText<"Directory to store .dwo files when LTO and debug fission are used">; 5100b57cec5SDimitry Andricdef plugin_opt_emit_llvm: F<"plugin-opt=emit-llvm">; 5110b57cec5SDimitry Andricdef: J<"plugin-opt=jobs=">, Alias<thinlto_jobs>, HelpText<"Alias for -thinlto-jobs">; 5120b57cec5SDimitry Andricdef: J<"plugin-opt=lto-partitions=">, Alias<lto_partitions>, HelpText<"Alias for -lto-partitions">; 5130b57cec5SDimitry Andricdef plugin_opt_mcpu_eq: J<"plugin-opt=mcpu=">; 5140b57cec5SDimitry Andricdef: F<"plugin-opt=new-pass-manager">, 5150b57cec5SDimitry Andric Alias<lto_new_pass_manager>, HelpText<"Alias for -lto-new-pass-manager">; 5160b57cec5SDimitry Andricdef: F<"plugin-opt=cs-profile-generate">, 5170b57cec5SDimitry Andric Alias<lto_cs_profile_generate>, HelpText<"Alias for -lto-cs-profile-generate">; 5180b57cec5SDimitry Andricdef: J<"plugin-opt=cs-profile-path=">, 5190b57cec5SDimitry Andric Alias<lto_cs_profile_file>, HelpText<"Alias for -lto-cs-profile-file">; 52085868e8aSDimitry Andricdef: J<"plugin-opt=obj-path=">, 52185868e8aSDimitry Andric Alias<lto_obj_path_eq>, 52285868e8aSDimitry Andric HelpText<"Alias for -lto-obj-path=">; 5230b57cec5SDimitry Andricdef: J<"plugin-opt=sample-profile=">, 5240b57cec5SDimitry Andric Alias<lto_sample_profile>, HelpText<"Alias for -lto-sample-profile">; 5250b57cec5SDimitry Andricdef: F<"plugin-opt=save-temps">, Alias<save_temps>, HelpText<"Alias for -save-temps">; 52685868e8aSDimitry Andricdef: F<"plugin-opt=thinlto-emit-imports-files">, 52785868e8aSDimitry Andric Alias<thinlto_emit_imports_files>, 52885868e8aSDimitry Andric HelpText<"Alias for -thinlto-emit-imports-files">; 52985868e8aSDimitry Andricdef: F<"plugin-opt=thinlto-index-only">, 53085868e8aSDimitry Andric Alias<thinlto_index_only>, 53185868e8aSDimitry Andric HelpText<"Alias for -thinlto-index-only">; 53285868e8aSDimitry Andricdef: J<"plugin-opt=thinlto-index-only=">, 53385868e8aSDimitry Andric Alias<thinlto_index_only_eq>, 53485868e8aSDimitry Andric HelpText<"Alias for -thinlto-index-only=">; 53585868e8aSDimitry Andricdef: J<"plugin-opt=thinlto-object-suffix-replace=">, 53685868e8aSDimitry Andric Alias<thinlto_object_suffix_replace_eq>, 53785868e8aSDimitry Andric HelpText<"Alias for -thinlto-object-suffix-replace=">; 53885868e8aSDimitry Andricdef: J<"plugin-opt=thinlto-prefix-replace=">, 53985868e8aSDimitry Andric Alias<thinlto_prefix_replace_eq>, 54085868e8aSDimitry Andric HelpText<"Alias for -thinlto-prefix-replace=">; 5410b57cec5SDimitry Andric 5420b57cec5SDimitry Andric// Ignore LTO plugin-related options. 5430b57cec5SDimitry Andric// clang -flto passes -plugin and -plugin-opt to the linker. This is required 5440b57cec5SDimitry Andric// for ld.gold and ld.bfd to get LTO working. But it's not for lld which doesn't 5450b57cec5SDimitry Andric// rely on a plugin. Instead of detecting which linker is used on clang side we 5460b57cec5SDimitry Andric// just ignore the option on lld side as it's easier. In fact, the linker could 5470b57cec5SDimitry Andric// be called 'ld' and understanding which linker is used would require parsing of 5480b57cec5SDimitry Andric// --version output. 5490b57cec5SDimitry Andricdefm plugin: Eq<"plugin", "Ignored for compatibility with GNU linkers">; 5500b57cec5SDimitry Andric 5510b57cec5SDimitry Andricdef plugin_opt_fresolution_eq: J<"plugin-opt=-fresolution=">; 5520b57cec5SDimitry Andricdef plugin_opt_pass_through_eq: J<"plugin-opt=-pass-through=">; 5530b57cec5SDimitry Andricdef plugin_opt_thinlto: J<"plugin-opt=thinlto">; 5540b57cec5SDimitry Andricdef plugin_opt_slash: J<"plugin-opt=/">; 5550b57cec5SDimitry Andric 5560b57cec5SDimitry Andric// Options listed below are silently ignored for now for compatibility. 5570b57cec5SDimitry Andricdef: F<"detect-odr-violations">; 5580b57cec5SDimitry Andricdef: Flag<["-"], "g">; 5590b57cec5SDimitry Andricdef: F<"long-plt">; 5600b57cec5SDimitry Andricdef: F<"no-add-needed">; 5610b57cec5SDimitry Andricdef: F<"no-copy-dt-needed-entries">; 5620b57cec5SDimitry Andricdef: F<"no-ctors-in-init-array">; 5630b57cec5SDimitry Andricdef: F<"no-keep-memory">; 5640b57cec5SDimitry Andricdef: F<"no-pipeline-knowledge">; 5650b57cec5SDimitry Andricdef: F<"no-warn-mismatch">; 5660b57cec5SDimitry Andricdef: Flag<["-"], "p">; 5670b57cec5SDimitry Andricdef: Separate<["--", "-"], "rpath-link">; 5680b57cec5SDimitry Andricdef: J<"rpath-link=">; 5690b57cec5SDimitry Andricdef: F<"secure-plt">; 5700b57cec5SDimitry Andricdef: F<"sort-common">; 5710b57cec5SDimitry Andricdef: F<"stats">; 5720b57cec5SDimitry Andricdef: F<"warn-execstack">; 5730b57cec5SDimitry Andricdef: F<"warn-once">; 5740b57cec5SDimitry Andricdef: F<"warn-shared-textrel">; 5750b57cec5SDimitry Andricdef: F<"EB">; 5760b57cec5SDimitry Andricdef: F<"EL">; 5770b57cec5SDimitry Andricdef: JoinedOrSeparate<["-"], "G">; 5780b57cec5SDimitry Andricdef: F<"Qy">; 5790b57cec5SDimitry Andric 5800b57cec5SDimitry Andric// Hidden option used for testing MIPS multi-GOT implementation. 5810b57cec5SDimitry Andricdefm mips_got_size: 5820b57cec5SDimitry Andric Eq<"mips-got-size", "Max size of a single MIPS GOT. 0x10000 by default.">, 5830b57cec5SDimitry Andric Flags<[HelpHidden]>; 584