xref: /openbsd/gnu/llvm/lld/MinGW/Options.td (revision 3cab2bb3)
1include "llvm/Option/OptParser.td"
2
3class F<string name>: Flag<["--", "-"], name>;
4class J<string name>: Joined<["--", "-"], name>;
5class S<string name>: Separate<["--", "-"], name>;
6
7multiclass Eq<string name, string help> {
8  def NAME: Separate<["--", "-"], name>;
9  def NAME # _eq: Joined<["--", "-"], name # "=">, Alias<!cast<Separate>(NAME)>,
10    HelpText<help>;
11}
12
13multiclass EqLong<string name, string help> {
14  def NAME: Separate<["--"], name>;
15  def NAME # _eq: Joined<["--"], name # "=">, Alias<!cast<Separate>(NAME)>,
16    HelpText<help>;
17}
18
19def L: JoinedOrSeparate<["-"], "L">, MetaVarName<"<dir>">,
20  HelpText<"Add a directory to the library search path">;
21def Bdynamic: F<"Bdynamic">, HelpText<"Link against shared libraries">;
22def Bstatic: F<"Bstatic">, HelpText<"Do not link against shared libraries">;
23def dynamicbase: F<"dynamicbase">, HelpText<"Enable ASLR">;
24defm entry: Eq<"entry", "Name of entry point symbol">, MetaVarName<"<entry>">;
25def exclude_all_symbols: F<"exclude-all-symbols">,
26    HelpText<"Don't automatically export any symbols">;
27def export_all_symbols: F<"export-all-symbols">,
28    HelpText<"Export all symbols even if a def file or dllexport attributes are used">;
29def gc_sections: F<"gc-sections">, HelpText<"Remove unused sections">;
30def help: F<"help">, HelpText<"Print option help">;
31def icf: J<"icf=">, HelpText<"Identical code folding">;
32def image_base: S<"image-base">, HelpText<"Base address of the program">;
33def insert_timestamp: F<"insert-timestamp">,
34    HelpText<"Include PE header timestamp">;
35def kill_at: F<"kill-at">, HelpText<"Remove @n from exported symbols">;
36def l: JoinedOrSeparate<["-"], "l">, MetaVarName<"<libName>">,
37  HelpText<"Root name of library to use">;
38def m: JoinedOrSeparate<["-"], "m">, HelpText<"Set target emulation">;
39defm major_os_version: EqLong<"major-os-version",
40     "Set the OS and subsystem major version">;
41defm major_subsystem_version: EqLong<"major-subsystem-version",
42     "Set the OS and subsystem major version">;
43defm map: Eq<"Map", "Output a linker map">;
44defm minor_os_version: EqLong<"minor-os-version",
45     "Set the OS and subsystem minor version">;
46defm minor_subsystem_version: EqLong<"minor-subsystem-version",
47     "Set the OS and subsystem minor version">;
48def no_insert_timestamp: F<"no-insert-timestamp">,
49    HelpText<"Don't include PE header timestamp">;
50def no_whole_archive: F<"no-whole-archive">,
51    HelpText<"No longer include all object files for following archives">;
52def large_address_aware: Flag<["--"], "large-address-aware">,
53    HelpText<"Enable large addresses">;
54def no_gc_sections: F<"no-gc-sections">, HelpText<"Don't remove unused sections">;
55def o: JoinedOrSeparate<["-"], "o">, MetaVarName<"<path>">,
56  HelpText<"Path to file to write output">;
57defm out_implib: Eq<"out-implib", "Import library name">;
58defm output_def: Eq<"output-def", "Output def file">;
59def shared: F<"shared">, HelpText<"Build a shared object">;
60defm subs: Eq<"subsystem", "Specify subsystem">;
61def stack: S<"stack">;
62def strip_all: F<"strip-all">,
63    HelpText<"Omit all symbol information from the output binary">;
64def strip_debug: F<"strip-debug">,
65    HelpText<"Omit all debug information, but keep symbol information">;
66defm reproduce: Eq<"reproduce", "Write a tar file containing input files and command line options to reproduce link">;
67defm undefined: Eq<"undefined", "Include symbol in the link, if available">;
68def whole_archive: F<"whole-archive">,
69    HelpText<"Include all object files for following archives">;
70def v: Flag<["-"], "v">, HelpText<"Display the version number">;
71def verbose: F<"verbose">, HelpText<"Verbose mode">;
72def version: F<"version">, HelpText<"Display the version number and exit">;
73defm require_defined: Eq<"require-defined",
74     "Force symbol to be added to symbol table as an undefined one">;
75
76// LLD specific options
77def _HASH_HASH_HASH : Flag<["-"], "###">,
78    HelpText<"Print (but do not run) the commands to run for this compilation">;
79def appcontainer: F<"appcontainer">, HelpText<"Set the appcontainer flag in the executable">;
80defm delayload: Eq<"delayload", "DLL to load only on demand">;
81def mllvm: S<"mllvm">;
82defm pdb: Eq<"pdb", "Output PDB debug info file, chosen implicitly if the argument is empty">;
83def Xlink : J<"Xlink=">, MetaVarName<"<arg>">,
84    HelpText<"Pass <arg> to the COFF linker">;
85
86// Alias
87def alias_entry_e: JoinedOrSeparate<["-"], "e">, Alias<entry>;
88def alias_strip_s: Flag<["-"], "s">, Alias<strip_all>;
89def alias_strip_S: Flag<["-"], "S">, Alias<strip_debug>;
90def alias_undefined_u: JoinedOrSeparate<["-"], "u">, Alias<undefined>;
91
92// Ignored options
93def: Joined<["-"], "O">;
94def: F<"build-id">;
95def: F<"disable-auto-image-base">;
96def: F<"enable-auto-image-base">;
97def: F<"enable-auto-import">, HelpText<"Ignored; listed for libtool compatibility">;
98def: F<"end-group">;
99def: Flag<["--"], "full-shutdown">;
100def: F<"high-entropy-va">;
101def: S<"major-image-version">;
102def: S<"minor-image-version">;
103def: F<"no-seh">;
104def: F<"nxcompat">;
105def: F<"pic-executable">;
106def: S<"plugin">;
107def: J<"plugin=">;
108def: S<"plugin-opt">;
109def: J<"plugin-opt=">;
110def: J<"sysroot">;
111def: F<"start-group">;
112def: F<"tsaware">;
113