maxjhandsome
/
llvm-project
forked from OSchip/llvm-project
1
0
Fork 0
Code Issues Pull Requests Packages Releases Wiki Activity
llvm-project/lld/MinGW/Options.td

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

131 lines
5.9 KiB
TableGen
Raw Normal View History

LLD: Introduce a GNU LD style driver for COFF When building COFF programs many targets such as mingw prefer to have a gnu ld frontend. Rather then having a fully fledged standalone driver we wrap a shim around the LINK driver. Extra tests were provided by mstorsjo Reviewers: mstorsjo, ruiu Differential Revision: https://reviews.llvm.org/D33880 llvm-svn: 312926
2017-09-12 01:02:59 +08:00
include "llvm/Option/OptParser.td"
class F<string name>: Flag<["--", "-"], name>;
class J<string name>: Joined<["--", "-"], name>;
class S<string name>: Separate<["--", "-"], name>;
[MinGW] Restructure Options.td to use multiclass where sensible. NFC. Differential Revision: https://reviews.llvm.org/D66065 llvm-svn: 368815
2019-08-14 17:35:40 +08:00
multiclass Eq<string name, string help> {
def NAME: Separate<["--", "-"], name>;
def NAME # _eq: Joined<["--", "-"], name # "=">, Alias<!cast<Separate>(NAME)>,
HelpText<help>;
}
multiclass EqLong<string name, string help> {
def NAME: Separate<["--"], name>;
def NAME # _eq: Joined<["--"], name # "=">, Alias<!cast<Separate>(NAME)>,
HelpText<help>;
}
[LLD][MinGW] Cleanup Options.td file. NFC. Based on ELF driver Options.td. Differential Revision: https://reviews.llvm.org/D86509
2020-08-26 14:24:37 +08:00
multiclass B<string name, string help1, string help2> {
def NAME: Flag<["--", "-"], name>, HelpText<help1>;
def no_ # NAME: Flag<["--", "-"], "no-" # name>, HelpText<help2>;
}
LLD: Introduce a GNU LD style driver for COFF When building COFF programs many targets such as mingw prefer to have a gnu ld frontend. Rather then having a fully fledged standalone driver we wrap a shim around the LINK driver. Extra tests were provided by mstorsjo Reviewers: mstorsjo, ruiu Differential Revision: https://reviews.llvm.org/D33880 llvm-svn: 312926
2017-09-12 01:02:59 +08:00
def L: JoinedOrSeparate<["-"], "L">, MetaVarName<"<dir>">,
HelpText<"Add a directory to the library search path">;
[LLD][MinGW] Handle allow-multiple-definition flag Basically copied from ELF driver. Differential Revision: https://reviews.llvm.org/D86512
2020-08-26 14:25:52 +08:00
defm allow_multiple_definition: B<"allow-multiple-definition",
"Allow multiple definitions",
"Do not allow multiple definitions (default)">;
[MinGW] Don't define names for ignored options. NFC. Move them to the same section as the newly added ignored options without a defined name. Also move options that actually weren't ignored to the right section. Differential Revision: https://reviews.llvm.org/D57374 llvm-svn: 352529
2019-01-30 03:24:32 +08:00
def Bdynamic: F<"Bdynamic">, HelpText<"Link against shared libraries">;
def Bstatic: F<"Bstatic">, HelpText<"Do not link against shared libraries">;
[LLD] [COFF] Add options for disabling auto import and runtime pseudo relocs Allow disabling either the full auto import feature, or just forbidding the cases that require runtime fixups. As long as all auto imported variables are referenced from separate .refptr$<name> sections, we can alias them on top of the IAT entries and don't actually need any runtime fixups via pseudo relocations. LLVM generates references to variables in .refptr stubs, if it isn't known that the variable for sure is defined in the same object module. Runtime pseudo relocs are needed if the addresses of auto imported variables are used in constant initializers though. Fixing up runtime pseudo relocations requires the use of VirtualProtect (which is disallowed in WinStore/UWP apps) or VirtualProtectFromApp. To allow any risk of ambiguity, allow rejecting cases that would require this at the linker stage. This adds support for the --disable-runtime-pseudo-reloc and --disable-auto-import options in the MinGW driver (matching GNU ld.bfd) with corresponding lld private options in the COFF driver. Differential Revision: https://reviews.llvm.org/D78923
2020-04-26 05:49:44 +08:00
def disable_auto_import: F<"disable-auto-import">,
HelpText<"Don't automatically import data symbols from other DLLs without dllimport">;
def disable_runtime_pseudo_reloc: F<"disable-runtime-pseudo-reloc">,
HelpText<"Don't do automatic imports that require runtime fixups">;
[LLD] [MinGW] Enable dynamicbase by default This matches lld-link's own default. Add a new command line option --no-dynamicbase for disabling it. (Unfortunately, GNU ld doesn't yet have a matching --no-dynamicbase option, as that's the default there.) Differential Revision: https://reviews.llvm.org/D86654
2020-08-26 21:02:52 +08:00
defm dynamicbase: B<"dynamicbase", "Enable ASLR", "Disable ASLR">;
[LLD] [COFF] Add options for disabling auto import and runtime pseudo relocs Allow disabling either the full auto import feature, or just forbidding the cases that require runtime fixups. As long as all auto imported variables are referenced from separate .refptr$<name> sections, we can alias them on top of the IAT entries and don't actually need any runtime fixups via pseudo relocations. LLVM generates references to variables in .refptr stubs, if it isn't known that the variable for sure is defined in the same object module. Runtime pseudo relocs are needed if the addresses of auto imported variables are used in constant initializers though. Fixing up runtime pseudo relocations requires the use of VirtualProtect (which is disallowed in WinStore/UWP apps) or VirtualProtectFromApp. To allow any risk of ambiguity, allow rejecting cases that would require this at the linker stage. This adds support for the --disable-runtime-pseudo-reloc and --disable-auto-import options in the MinGW driver (matching GNU ld.bfd) with corresponding lld private options in the COFF driver. Differential Revision: https://reviews.llvm.org/D78923
2020-04-26 05:49:44 +08:00
def enable_auto_import: F<"enable-auto-import">,
HelpText<"Automatically import data symbols from other DLLs where needed">;
def enable_runtime_pseudo_reloc: F<"enable-runtime-pseudo-reloc">,
HelpText<"Allow automatic imports that require runtime fixups">;
[MinGW] Correct handling different forms of a few options Support the equals form of the long --entry=<symbol> option, add a test for the -e<symbol> form. Add tests for single dash forms of -exclude-all-symbols and -export-all-symbols. Support single-dash forms of -out-implib and -output-def, support the equals form of --output-def=<file>. (We previously had a test to explicitly disallow -out-implib, but it turns out that GNU ld actually does support it just fine, despite also matching the -o<file> option.) Disallow the double-dashed --u form, add a test for -u<symbol>. Differential Revision: https://reviews.llvm.org/D66066 llvm-svn: 368816
2019-08-14 17:35:44 +08:00
defm entry: Eq<"entry", "Name of entry point symbol">, MetaVarName<"<entry>">;
[MinGW] Hook up the --exclude-all-symbols option Differential Revision: https://reviews.llvm.org/D58380 llvm-svn: 354387
2019-02-20 05:57:49 +08:00
def exclude_all_symbols: F<"exclude-all-symbols">,
HelpText<"Don't automatically export any symbols">;
[MinGW] Hook up the --export-all-symbols and --output-def options Differential Revision: https://reviews.llvm.org/D38761 llvm-svn: 315563
2017-10-12 13:37:18 +08:00
def export_all_symbols: F<"export-all-symbols">,
HelpText<"Export all symbols even if a def file or dllexport attributes are used">;
[LLD] [MinGW] Implement the --file-alignment and --section-alignment options Differential Revision: https://reviews.llvm.org/D83720
2020-07-14 05:12:13 +08:00
defm file_alignment: Eq<"file-alignment", "Set file alignment">;
[LLD][MinGW] Cleanup Options.td file. NFC. Based on ELF driver Options.td. Differential Revision: https://reviews.llvm.org/D86509
2020-08-26 14:24:37 +08:00
defm gc_sections: B<"gc-sections",
"Remove unused sections",
"Don't remove unused sections">;
[MinGW] Implement --help for the MinGW driver Differential Revision: https://reviews.llvm.org/D62029 llvm-svn: 361015
2019-05-17 19:07:38 +08:00
def help: F<"help">, HelpText<"Print option help">;
[MinGW] Implement the --[no-]gc-sections and --icf options GNU ld doesn't seem to support --icf at all, but this was suggested in D39885, and GNU gold seems to support it. Differential Revision: https://reviews.llvm.org/D40019 llvm-svn: 318283
2017-11-15 16:18:20 +08:00
def icf: J<"icf=">, HelpText<"Identical code folding">;
[MinGW] Implement support for the --image-base option Differential Revision: https://reviews.llvm.org/D40018 llvm-svn: 318282
2017-11-15 16:18:15 +08:00
def image_base: S<"image-base">, HelpText<"Base address of the program">;
[LLD][MinGW] Cleanup Options.td file. NFC. Based on ELF driver Options.td. Differential Revision: https://reviews.llvm.org/D86509
2020-08-26 14:24:37 +08:00
defm insert_timestamp: B<"insert-timestamp",
"Include PE header timestamp",
"Don't include PE header timestamp">;
[MinGW] Add support for the GNU ld flag --kill-at llvm-svn: 327562
2018-03-15 04:17:24 +08:00
def kill_at: F<"kill-at">, HelpText<"Remove @n from exported symbols">;
Sort options. This patch also rename OPT_outlib OPT_out_implib for consistency. llvm-svn: 312949
2017-09-12 04:54:51 +08:00
def l: JoinedOrSeparate<["-"], "l">, MetaVarName<"<libName>">,
HelpText<"Root name of library to use">;
LLD: Introduce a GNU LD style driver for COFF When building COFF programs many targets such as mingw prefer to have a gnu ld frontend. Rather then having a fully fledged standalone driver we wrap a shim around the LINK driver. Extra tests were provided by mstorsjo Reviewers: mstorsjo, ruiu Differential Revision: https://reviews.llvm.org/D33880 llvm-svn: 312926
2017-09-12 01:02:59 +08:00
def m: JoinedOrSeparate<["-"], "m">, HelpText<"Set target emulation">;
[MinGW] Restructure Options.td to use multiclass where sensible. NFC. Differential Revision: https://reviews.llvm.org/D66065 llvm-svn: 368815
2019-08-14 17:35:40 +08:00
defm major_os_version: EqLong<"major-os-version",
"Set the OS and subsystem major version">;
defm major_subsystem_version: EqLong<"major-subsystem-version",
"Set the OS and subsystem major version">;
defm map: Eq<"Map", "Output a linker map">;
defm minor_os_version: EqLong<"minor-os-version",
"Set the OS and subsystem minor version">;
defm minor_subsystem_version: EqLong<"minor-subsystem-version",
"Set the OS and subsystem minor version">;
[LLD] [MinGW] Implement the --no-seh flag Previously this flag was just ignored. If set, set the IMAGE_DLL_CHARACTERISTICS_NO_SEH bit, regardless of the normal safeSEH machinery. In mingw configurations, the safeSEH bit might not be set in e.g. object files built from handwritten assembly, making it impossible to use the normal safeseh flag. As mingw setups don't generally use SEH on 32 bit x86 at all, it should be fine to set that flag bit though - hook up the existing GNU ld flag for controlling that. Differential Revision: https://reviews.llvm.org/D84701
2020-07-28 04:44:41 +08:00
def no_seh: F<"no-seh">, HelpText<"Set the 'no SEH' flag in the executable">;
[MinGW] Handle --large-address-aware In GNU ld, this option is only available on i386, not on x86_64 (where it's enabled by default with no option to disable it either). Differential Revision: https://reviews.llvm.org/D40015 llvm-svn: 318280
2017-11-15 16:18:06 +08:00
def large_address_aware: Flag<["--"], "large-address-aware">,
HelpText<"Enable large addresses">;
LLD: Introduce a GNU LD style driver for COFF When building COFF programs many targets such as mingw prefer to have a gnu ld frontend. Rather then having a fully fledged standalone driver we wrap a shim around the LINK driver. Extra tests were provided by mstorsjo Reviewers: mstorsjo, ruiu Differential Revision: https://reviews.llvm.org/D33880 llvm-svn: 312926
2017-09-12 01:02:59 +08:00
def o: JoinedOrSeparate<["-"], "o">, MetaVarName<"<path>">,
HelpText<"Path to file to write output">;
[MinGW] Correct handling different forms of a few options Support the equals form of the long --entry=<symbol> option, add a test for the -e<symbol> form. Add tests for single dash forms of -exclude-all-symbols and -export-all-symbols. Support single-dash forms of -out-implib and -output-def, support the equals form of --output-def=<file>. (We previously had a test to explicitly disallow -out-implib, but it turns out that GNU ld actually does support it just fine, despite also matching the -o<file> option.) Disallow the double-dashed --u form, add a test for -u<symbol>. Differential Revision: https://reviews.llvm.org/D66066 llvm-svn: 368816
2019-08-14 17:35:44 +08:00
defm out_implib: Eq<"out-implib", "Import library name">;
defm output_def: Eq<"output-def", "Output def file">;
[LLD] [MinGW] Implement the --file-alignment and --section-alignment options Differential Revision: https://reviews.llvm.org/D83720
2020-07-14 05:12:13 +08:00
defm section_alignment: Eq<"section-alignment", "Set section alignment">;
LLD: Introduce a GNU LD style driver for COFF When building COFF programs many targets such as mingw prefer to have a gnu ld frontend. Rather then having a fully fledged standalone driver we wrap a shim around the LINK driver. Extra tests were provided by mstorsjo Reviewers: mstorsjo, ruiu Differential Revision: https://reviews.llvm.org/D33880 llvm-svn: 312926
2017-09-12 01:02:59 +08:00
def shared: F<"shared">, HelpText<"Build a shared object">;
[MinGW] Restructure Options.td to use multiclass where sensible. NFC. Differential Revision: https://reviews.llvm.org/D66065 llvm-svn: 368815
2019-08-14 17:35:40 +08:00
defm subs: Eq<"subsystem", "Specify subsystem">;
Accept not only --foo but also -foo. GNU ld manual says that multi-letter long option can be prefixed with either -- or -. Therefore, we should accept not only --subsystem but also -subsystem, for example. There is one exception. If an option starts with "o", it should only be prefixed with -- to avoid ambiguity with -o<filename> option. Differential Revision: https://reviews.llvm.org/D37825 llvm-svn: 313286
2017-09-15 02:33:21 +08:00
def stack: S<"stack">;
[MinGW] Output debug info by default, unless the -s parameter is passed Differential Revision: https://reviews.llvm.org/D39541 llvm-svn: 317376
2017-11-04 06:10:37 +08:00
def strip_all: F<"strip-all">,
HelpText<"Omit all symbol information from the output binary">;
[MinGW] Implement the GNU ld options -S/--strip-debug In this mode, we retain the symbol table, but skip the actual debug information. Differential Revision: https://reviews.llvm.org/D48745 llvm-svn: 335947
2018-06-29 14:08:31 +08:00
def strip_debug: F<"strip-debug">,
HelpText<"Omit all debug information, but keep symbol information">;
[MinGW] Add --reproduce option Differential Revision: https://reviews.llvm.org/D68382 llvm-svn: 373705
2019-10-04 15:27:45 +08:00
defm reproduce: Eq<"reproduce", "Write a tar file containing input files and command line options to reproduce link">;
[MinGW] Restructure Options.td to use multiclass where sensible. NFC. Differential Revision: https://reviews.llvm.org/D66065 llvm-svn: 368815
2019-08-14 17:35:40 +08:00
defm undefined: Eq<"undefined", "Include symbol in the link, if available">;
[LLD][MinGW] Cleanup Options.td file. NFC. Based on ELF driver Options.td. Differential Revision: https://reviews.llvm.org/D86509
2020-08-26 14:24:37 +08:00
defm whole_archive: B<"whole-archive",
"Include all object files for following archives",
"No longer include all object files for following archives">;
[MinGW] Implement the -v and --version flags for the MinGW driver Differential Revision: https://reviews.llvm.org/D62030 llvm-svn: 361016
2019-05-17 19:07:42 +08:00
def v: Flag<["-"], "v">, HelpText<"Display the version number">;
[MinGW] Map the -verbose option, implement -### for showing the produced parameters Pass the -verbose option through to the COFF linker, and show the arguments passed to it. If the -### option is specified, just show the produced argument list and exit, just like in clang. Replace the first argument with "lld-link" in order to produce a correct command line. Differential Revision: https://reviews.llvm.org/D37706 llvm-svn: 312944
2017-09-12 04:43:39 +08:00
def verbose: F<"verbose">, HelpText<"Verbose mode">;
[MinGW] Implement the -v and --version flags for the MinGW driver Differential Revision: https://reviews.llvm.org/D62030 llvm-svn: 361016
2019-05-17 19:07:42 +08:00
def version: F<"version">, HelpText<"Display the version number and exit">;
[MinGW] Restructure Options.td to use multiclass where sensible. NFC. Differential Revision: https://reviews.llvm.org/D66065 llvm-svn: 368815
2019-08-14 17:35:40 +08:00
defm require_defined: Eq<"require-defined",
"Force symbol to be added to symbol table as an undefined one">;
[MinGW] Map the -verbose option, implement -### for showing the produced parameters Pass the -verbose option through to the COFF linker, and show the arguments passed to it. If the -### option is specified, just show the produced argument list and exit, just like in clang. Replace the first argument with "lld-link" in order to produce a correct command line. Differential Revision: https://reviews.llvm.org/D37706 llvm-svn: 312944
2017-09-12 04:43:39 +08:00
// LLD specific options
def _HASH_HASH_HASH : Flag<["-"], "###">,
HelpText<"Print (but do not run) the commands to run for this compilation">;
[MinGW] Add an --appcontainer flag, passed through to lld-link GNU ld doesn't have such a flag though, so this is a lld specific option. Differential Revision: https://reviews.llvm.org/D60860 llvm-svn: 358759
2019-04-19 21:50:43 +08:00
def appcontainer: F<"appcontainer">, HelpText<"Set the appcontainer flag in the executable">;
[MinGW] Restructure Options.td to use multiclass where sensible. NFC. Differential Revision: https://reviews.llvm.org/D66065 llvm-svn: 368815
2019-08-14 17:35:40 +08:00
defm delayload: Eq<"delayload", "DLL to load only on demand">;
[MinGW] Add an option -Xlink for passing options through to lld-link Also move the -mllvm option to the right section of the options list. Differential Revision: https://reviews.llvm.org/D39528 llvm-svn: 317302
2017-11-03 15:18:37 +08:00
def mllvm: S<"mllvm">;
[MinGW] Restructure Options.td to use multiclass where sensible. NFC. Differential Revision: https://reviews.llvm.org/D66065 llvm-svn: 368815
2019-08-14 17:35:40 +08:00
defm pdb: Eq<"pdb", "Output PDB debug info file, chosen implicitly if the argument is empty">;
[LLD/MinGW]: Expose --thinlto-cache-dir Differential Revision: https://reviews.llvm.org/D80438
2020-05-24 17:29:16 +08:00
defm thinlto_cache_dir: EqLong<"thinlto-cache-dir",
"Path to ThinLTO cached object file directory">;
[MinGW] Add an option -Xlink for passing options through to lld-link Also move the -mllvm option to the right section of the options list. Differential Revision: https://reviews.llvm.org/D39528 llvm-svn: 317302
2017-11-03 15:18:37 +08:00
def Xlink : J<"Xlink=">, MetaVarName<"<arg>">,
HelpText<"Pass <arg> to the COFF linker">;
LLD: Introduce a GNU LD style driver for COFF When building COFF programs many targets such as mingw prefer to have a gnu ld frontend. Rather then having a fully fledged standalone driver we wrap a shim around the LINK driver. Extra tests were provided by mstorsjo Reviewers: mstorsjo, ruiu Differential Revision: https://reviews.llvm.org/D33880 llvm-svn: 312926
2017-09-12 01:02:59 +08:00
// Alias
def alias_entry_e: JoinedOrSeparate<["-"], "e">, Alias<entry>;
[MinGW] Output debug info by default, unless the -s parameter is passed Differential Revision: https://reviews.llvm.org/D39541 llvm-svn: 317376
2017-11-04 06:10:37 +08:00
def alias_strip_s: Flag<["-"], "s">, Alias<strip_all>;
[MinGW] Implement the GNU ld options -S/--strip-debug In this mode, we retain the symbol table, but skip the actual debug information. Differential Revision: https://reviews.llvm.org/D48745 llvm-svn: 335947
2018-06-29 14:08:31 +08:00
def alias_strip_S: Flag<["-"], "S">, Alias<strip_debug>;
[MinGW] Correct handling different forms of a few options Support the equals form of the long --entry=<symbol> option, add a test for the -e<symbol> form. Add tests for single dash forms of -exclude-all-symbols and -export-all-symbols. Support single-dash forms of -out-implib and -output-def, support the equals form of --output-def=<file>. (We previously had a test to explicitly disallow -out-implib, but it turns out that GNU ld actually does support it just fine, despite also matching the -o<file> option.) Disallow the double-dashed --u form, add a test for -u<symbol>. Differential Revision: https://reviews.llvm.org/D66066 llvm-svn: 368816
2019-08-14 17:35:44 +08:00
def alias_undefined_u: JoinedOrSeparate<["-"], "u">, Alias<undefined>;
[MinGW] Ignore the --plugin and --plugin-opt option GCC can use LLD with -fuse-ld=lld for MinGW these days, but by default these options are passed to the linker (unless -fno-lto is passed to the GCC driver). Differential Revision: https://reviews.llvm.org/D57304 llvm-svn: 352459
2019-01-29 16:38:48 +08:00
// Ignored options
[MinGW] Don't define names for ignored options. NFC. Move them to the same section as the newly added ignored options without a defined name. Also move options that actually weren't ignored to the right section. Differential Revision: https://reviews.llvm.org/D57374 llvm-svn: 352529
2019-01-30 03:24:32 +08:00
def: Joined<["-"], "O">;
def: F<"build-id">;
def: F<"disable-auto-image-base">;
def: F<"enable-auto-image-base">;
def: F<"end-group">;
def: Flag<["--"], "full-shutdown">;
def: F<"high-entropy-va">;
def: S<"major-image-version">;
def: S<"minor-image-version">;
def: F<"nxcompat">;
def: F<"pic-executable">;
[MinGW] Ignore the --plugin and --plugin-opt option GCC can use LLD with -fuse-ld=lld for MinGW these days, but by default these options are passed to the linker (unless -fno-lto is passed to the GCC driver). Differential Revision: https://reviews.llvm.org/D57304 llvm-svn: 352459
2019-01-29 16:38:48 +08:00
def: S<"plugin">;
def: J<"plugin=">;
def: S<"plugin-opt">;
def: J<"plugin-opt=">;
[MinGW] Don't define names for ignored options. NFC. Move them to the same section as the newly added ignored options without a defined name. Also move options that actually weren't ignored to the right section. Differential Revision: https://reviews.llvm.org/D57374 llvm-svn: 352529
2019-01-30 03:24:32 +08:00
def: J<"sysroot">;
def: F<"start-group">;
def: F<"tsaware">;