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

109 lines
4.8 KiB
TableGen
Raw Normal View History

This is my Driver refactoring patch. The major changes are: 1) LinkerOptions has been merged into TargetInfo 2) LinkerInvocation has been merged into Driver 3) Drivers no longer convert arguments into an intermediate (core) argument list, but instead create a TargetInfo object and call setter methods on it. This is only how in-process linking would work. That is, you can programmatically set up a TargetInfo object which controls the linking. 4) Lots of tweaks to test suite to work with driver changes 5) Add the DarwinDriver 6) I heavily doxygen commented TargetInfo.h Things to do after this patch is committed: a) Consider renaming TargetInfo, given its new roll. b) Consider pulling the list of input files out of TargetInfo. This will enable in-process clients to create one TargetInfo the re-use it with different input file lists. c) Work out a way for Drivers to format the warnings and error done in core linking. llvm-svn: 178776
2013-04-05 02:59:24 +08:00
include "llvm/Option/OptParser.td"
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
This is my Driver refactoring patch. The major changes are: 1) LinkerOptions has been merged into TargetInfo 2) LinkerInvocation has been merged into Driver 3) Drivers no longer convert arguments into an intermediate (core) argument list, but instead create a TargetInfo object and call setter methods on it. This is only how in-process linking would work. That is, you can programmatically set up a TargetInfo object which controls the linking. 4) Lots of tweaks to test suite to work with driver changes 5) Add the DarwinDriver 6) I heavily doxygen commented TargetInfo.h Things to do after this patch is committed: a) Consider renaming TargetInfo, given its new roll. b) Consider pulling the list of input files out of TargetInfo. This will enable in-process clients to create one TargetInfo the re-use it with different input file lists. c) Work out a way for Drivers to format the warnings and error done in core linking. llvm-svn: 178776
2013-04-05 02:59:24 +08:00
// output kinds
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
def grp_kind : OptionGroup<"outs">, HelpText<"OUTPUT KIND">;
Rename *Options.td -> <flavor>Options.td. Before this patch, name of driver implementation is not consistent with its option table file. Specifically, LDOptions has a different prefix than GnuLdDriver. This patch renames option files, so that the option files have the same prefix as the corresponding driver files. Differential Revision: http://llvm-reviews.chandlerc.com/D1591 llvm-svn: 189895
2013-09-04 08:24:35 +08:00
def relocatable : Flag<["-"], "r">,
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
HelpText<"Create relocatable object file">, Group<grp_kind>;
Rename *Options.td -> <flavor>Options.td. Before this patch, name of driver implementation is not consistent with its option table file. Specifically, LDOptions has a different prefix than GnuLdDriver. This patch renames option files, so that the option files have the same prefix as the corresponding driver files. Differential Revision: http://llvm-reviews.chandlerc.com/D1591 llvm-svn: 189895
2013-09-04 08:24:35 +08:00
def static : Flag<["-"], "static">,
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
HelpText<"Create static executable">, Group<grp_kind>;
Rename *Options.td -> <flavor>Options.td. Before this patch, name of driver implementation is not consistent with its option table file. Specifically, LDOptions has a different prefix than GnuLdDriver. This patch renames option files, so that the option files have the same prefix as the corresponding driver files. Differential Revision: http://llvm-reviews.chandlerc.com/D1591 llvm-svn: 189895
2013-09-04 08:24:35 +08:00
def dynamic : Flag<["-"], "dynamic">,
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
HelpText<"Create dynamic executable (default)">,Group<grp_kind>;
Rename *Options.td -> <flavor>Options.td. Before this patch, name of driver implementation is not consistent with its option table file. Specifically, LDOptions has a different prefix than GnuLdDriver. This patch renames option files, so that the option files have the same prefix as the corresponding driver files. Differential Revision: http://llvm-reviews.chandlerc.com/D1591 llvm-svn: 189895
2013-09-04 08:24:35 +08:00
def dylib : Flag<["-"], "dylib">,
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
HelpText<"Create dynamic library">, Group<grp_kind>;
Rename *Options.td -> <flavor>Options.td. Before this patch, name of driver implementation is not consistent with its option table file. Specifically, LDOptions has a different prefix than GnuLdDriver. This patch renames option files, so that the option files have the same prefix as the corresponding driver files. Differential Revision: http://llvm-reviews.chandlerc.com/D1591 llvm-svn: 189895
2013-09-04 08:24:35 +08:00
def bundle : Flag<["-"], "bundle">,
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
HelpText<"Create dynamic bundle">, Group<grp_kind>;
Rename *Options.td -> <flavor>Options.td. Before this patch, name of driver implementation is not consistent with its option table file. Specifically, LDOptions has a different prefix than GnuLdDriver. This patch renames option files, so that the option files have the same prefix as the corresponding driver files. Differential Revision: http://llvm-reviews.chandlerc.com/D1591 llvm-svn: 189895
2013-09-04 08:24:35 +08:00
def execute : Flag<["-"], "execute">,
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
HelpText<"Create main executable (default)">, Group<grp_kind>;
Rename *Options.td -> <flavor>Options.td. Before this patch, name of driver implementation is not consistent with its option table file. Specifically, LDOptions has a different prefix than GnuLdDriver. This patch renames option files, so that the option files have the same prefix as the corresponding driver files. Differential Revision: http://llvm-reviews.chandlerc.com/D1591 llvm-svn: 189895
2013-09-04 08:24:35 +08:00
def preload : Flag<["-"], "preload">,
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
HelpText<"Create preload">, Group<grp_kind>;
// optimizations
def grp_opts : OptionGroup<"opts">, HelpText<"OPTIMIZATIONS">;
def dead_strip : Flag<["-"], "dead_strip">,
HelpText<"Remove unreference code and data">, Group<grp_opts>;
Rename *Options.td -> <flavor>Options.td. Before this patch, name of driver implementation is not consistent with its option table file. Specifically, LDOptions has a different prefix than GnuLdDriver. This patch renames option files, so that the option files have the same prefix as the corresponding driver files. Differential Revision: http://llvm-reviews.chandlerc.com/D1591 llvm-svn: 189895
2013-09-04 08:24:35 +08:00
def macosx_version_min : Separate<["-"], "macosx_version_min">,
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
HelpText<"Minimum Mac OS X version">, Group<grp_opts>;
Rename *Options.td -> <flavor>Options.td. Before this patch, name of driver implementation is not consistent with its option table file. Specifically, LDOptions has a different prefix than GnuLdDriver. This patch renames option files, so that the option files have the same prefix as the corresponding driver files. Differential Revision: http://llvm-reviews.chandlerc.com/D1591 llvm-svn: 189895
2013-09-04 08:24:35 +08:00
def ios_version_min : Separate<["-"], "ios_version_min">,
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
HelpText<"Minimum iOS version">, Group<grp_opts>;
Rename *Options.td -> <flavor>Options.td. Before this patch, name of driver implementation is not consistent with its option table file. Specifically, LDOptions has a different prefix than GnuLdDriver. This patch renames option files, so that the option files have the same prefix as the corresponding driver files. Differential Revision: http://llvm-reviews.chandlerc.com/D1591 llvm-svn: 189895
2013-09-04 08:24:35 +08:00
def ios_simulator_version_min : Separate<["-"], "ios_simulator_version_min">,
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
HelpText<"Minimum iOS simulator version">, Group<grp_opts>;
Rename *Options.td -> <flavor>Options.td. Before this patch, name of driver implementation is not consistent with its option table file. Specifically, LDOptions has a different prefix than GnuLdDriver. This patch renames option files, so that the option files have the same prefix as the corresponding driver files. Differential Revision: http://llvm-reviews.chandlerc.com/D1591 llvm-svn: 189895
2013-09-04 08:24:35 +08:00
def mllvm : Separate<["-"], "mllvm">,
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
HelpText<"Options to pass to LLVM during LTO">, Group<grp_opts>;
// main executable options
def grp_main : OptionGroup<"opts">, HelpText<"MAIN EXECUTABLE OPTIONS">;
def entry : Separate<["-"], "e">, HelpText<"entry symbol name">,Group<grp_main>;
This is my Driver refactoring patch. The major changes are: 1) LinkerOptions has been merged into TargetInfo 2) LinkerInvocation has been merged into Driver 3) Drivers no longer convert arguments into an intermediate (core) argument list, but instead create a TargetInfo object and call setter methods on it. This is only how in-process linking would work. That is, you can programmatically set up a TargetInfo object which controls the linking. 4) Lots of tweaks to test suite to work with driver changes 5) Add the DarwinDriver 6) I heavily doxygen commented TargetInfo.h Things to do after this patch is committed: a) Consider renaming TargetInfo, given its new roll. b) Consider pulling the list of input files out of TargetInfo. This will enable in-process clients to create one TargetInfo the re-use it with different input file lists. c) Work out a way for Drivers to format the warnings and error done in core linking. llvm-svn: 178776
2013-04-05 02:59:24 +08:00
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
// dylib executable options
def grp_dylib : OptionGroup<"opts">, HelpText<"DYLIB EXECUTABLE OPTIONS">;
Support darwin linker options: -current_version, -compatibility_version, and -install_name. Patch by Joe Ranieri llvm-svn: 190452
2013-09-11 07:55:14 +08:00
def install_name : Separate<["-"], "install_name">,
HelpText<"The dylib's install name">, Group<grp_dylib>;
def mark_dead_strippable_dylib : Flag<["-"], "mark_dead_strippable_dylib">,
HelpText<"Marks the dylib as having no side effects during initialization">,
Group<grp_dylib>;
def compatibility_version : Separate<["-"], "compatibility_version">,
HelpText<"The dylib's compatibility version">, Group<grp_dylib>;
def current_version : Separate<["-"], "current_version">,
HelpText<"The dylib's current version">, Group<grp_dylib>;
// dylib executable options - compatibility aliases
def dylib_install_name : Separate<["-"], "dylib_install_name">,
Alias<install_name>;
def dylib_compatibility_version :
Separate<["-"], "dylib_compatibility_version">,
Alias<compatibility_version>;
def dylib_current_version : Separate<["-"], "dylib_current_version">,
Alias<current_version>;
// bundle executable options
def grp_bundle : OptionGroup<"opts">, HelpText<"BUNDLE EXECUTABLE OPTIONS">;
def bundle_loader : Separate<["-"], "bundle_loader">,
HelpText<"The executable that will be loading this Mach-O bundle">,
Group<grp_bundle>;
This is my Driver refactoring patch. The major changes are: 1) LinkerOptions has been merged into TargetInfo 2) LinkerInvocation has been merged into Driver 3) Drivers no longer convert arguments into an intermediate (core) argument list, but instead create a TargetInfo object and call setter methods on it. This is only how in-process linking would work. That is, you can programmatically set up a TargetInfo object which controls the linking. 4) Lots of tweaks to test suite to work with driver changes 5) Add the DarwinDriver 6) I heavily doxygen commented TargetInfo.h Things to do after this patch is committed: a) Consider renaming TargetInfo, given its new roll. b) Consider pulling the list of input files out of TargetInfo. This will enable in-process clients to create one TargetInfo the re-use it with different input file lists. c) Work out a way for Drivers to format the warnings and error done in core linking. llvm-svn: 178776
2013-04-05 02:59:24 +08:00
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
// library options
def grp_libs : OptionGroup<"libs">, HelpText<"LIBRARY OPTIONS">;
[mach-o]: support user-specified (-L) library search paths llvm-svn: 212712
2014-07-10 19:46:08 +08:00
def L : JoinedOrSeparate<["-"], "L">,
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
HelpText<"Add directory to library search path">, Group<grp_libs>;
[mach-o] Support -F and -framework options in darwin driver Darwin has a packaging mechanism for shared libraries and headers called frameworks. A directory Foo.framework contains a shared library binary file "Foo" and a subdirectory "Headers". Most OS frameworks are all in one directory /System/Library/Frameworks/. As a linking convenience, the linker option "-framework Foo" means search the framework directories specified with -F (analogous to -L) looking for a shared library Foo.framework/Foo. llvm-svn: 215680
2014-08-15 06:20:41 +08:00
def F : JoinedOrSeparate<["-"], "F">,
HelpText<"Add directory to framework search path">, Group<grp_libs>;
[mach-o]: support -Z option to skip standard library paths llvm-svn: 212713
2014-07-10 19:46:13 +08:00
def Z : Flag<["-"], "Z">,
HelpText<"Do not search standard directories for libraries or frameworks">;
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
def all_load : Flag<["-"], "all_load">,
Rename *Options.td -> <flavor>Options.td. Before this patch, name of driver implementation is not consistent with its option table file. Specifically, LDOptions has a different prefix than GnuLdDriver. This patch renames option files, so that the option files have the same prefix as the corresponding driver files. Differential Revision: http://llvm-reviews.chandlerc.com/D1591 llvm-svn: 189895
2013-09-04 08:24:35 +08:00
HelpText<"Forces all members of all static libraries to be loaded">,
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
Group<grp_libs>;
[mach-o]: support -syslibroot and -l options These behave slightly idiosyncratically in the best of cases, and have additional hacks layered on top of that for compatibility with badly behaved build systems (via ld64). For -lXYZ: + If XYZ is actually XY.o then search all library paths for XY.o + Otherwise search all library paths, first for libXYZ.dylib, then libXYZ.a + By default the library paths are /usr/lib and /usr/local/lib in that order. For -syslibroot: + -syslibroot options apply to absolute paths in the search order. + All -syslibroot prefixes that exist are added to the search path *instead* of the original. + If no -syslibroot prefixed path exists, the original is kept. + Hacks^WExceptions: + If only 1 -syslibroot is given and doesn't contain /usr/lib or /usr/local/lib, that path is dropped entirely. (rdar://problem/6438270). + If the last -syslibroot is "/", all of them are ignored entirely. (rdar://problem/5829579). At least, that's my best interpretation of what ld64 does in buildSearchPaths. llvm-svn: 212706
2014-07-10 19:21:06 +08:00
def syslibroot : Separate<["-"], "syslibroot">,
HelpText<"Add path to SDK to all absolute library search paths">,
Group<grp_libs>;
// Input options
def l : Joined<["-"], "l">,
HelpText<"Base name of library searched for in -L directories">;
[mach-o] Support -F and -framework options in darwin driver Darwin has a packaging mechanism for shared libraries and headers called frameworks. A directory Foo.framework contains a shared library binary file "Foo" and a subdirectory "Headers". Most OS frameworks are all in one directory /System/Library/Frameworks/. As a linking convenience, the linker option "-framework Foo" means search the framework directories specified with -F (analogous to -L) looking for a shared library Foo.framework/Foo. llvm-svn: 215680
2014-08-15 06:20:41 +08:00
def framework : Separate<["-"], "framework">,
HelpText<"Base name of framework searched for in -F directories">;
Rename *Options.td -> <flavor>Options.td. Before this patch, name of driver implementation is not consistent with its option table file. Specifically, LDOptions has a different prefix than GnuLdDriver. This patch renames option files, so that the option files have the same prefix as the corresponding driver files. Differential Revision: http://llvm-reviews.chandlerc.com/D1591 llvm-svn: 189895
2013-09-04 08:24:35 +08:00
Add -print_atoms options to DarwinLdDriver which dumps final state of all atoms in yaml llvm-svn: 208813
2014-05-15 05:32:21 +08:00
// test case options
[mach-o]: support -syslibroot and -l options These behave slightly idiosyncratically in the best of cases, and have additional hacks layered on top of that for compatibility with badly behaved build systems (via ld64). For -lXYZ: + If XYZ is actually XY.o then search all library paths for XY.o + Otherwise search all library paths, first for libXYZ.dylib, then libXYZ.a + By default the library paths are /usr/lib and /usr/local/lib in that order. For -syslibroot: + -syslibroot options apply to absolute paths in the search order. + All -syslibroot prefixes that exist are added to the search path *instead* of the original. + If no -syslibroot prefixed path exists, the original is kept. + Hacks^WExceptions: + If only 1 -syslibroot is given and doesn't contain /usr/lib or /usr/local/lib, that path is dropped entirely. (rdar://problem/6438270). + If the last -syslibroot is "/", all of them are ignored entirely. (rdar://problem/5829579). At least, that's my best interpretation of what ld64 does in buildSearchPaths. llvm-svn: 212706
2014-07-10 19:21:06 +08:00
def print_atoms : Flag<["-"], "print_atoms">,
Add -print_atoms options to DarwinLdDriver which dumps final state of all atoms in yaml llvm-svn: 208813
2014-05-15 05:32:21 +08:00
HelpText<"Emit output as yaml atoms">;
[mach-o]: support -syslibroot and -l options These behave slightly idiosyncratically in the best of cases, and have additional hacks layered on top of that for compatibility with badly behaved build systems (via ld64). For -lXYZ: + If XYZ is actually XY.o then search all library paths for XY.o + Otherwise search all library paths, first for libXYZ.dylib, then libXYZ.a + By default the library paths are /usr/lib and /usr/local/lib in that order. For -syslibroot: + -syslibroot options apply to absolute paths in the search order. + All -syslibroot prefixes that exist are added to the search path *instead* of the original. + If no -syslibroot prefixed path exists, the original is kept. + Hacks^WExceptions: + If only 1 -syslibroot is given and doesn't contain /usr/lib or /usr/local/lib, that path is dropped entirely. (rdar://problem/6438270). + If the last -syslibroot is "/", all of them are ignored entirely. (rdar://problem/5829579). At least, that's my best interpretation of what ld64 does in buildSearchPaths. llvm-svn: 212706
2014-07-10 19:21:06 +08:00
def test_libresolution : Flag<["-"], "test_libresolution">,
HelpText<"Only files specified by -file_exists are considered to exist."
" Print debugging information during resolution">;
def path_exists : Separate<["-"], "path_exists">,
HelpText<"When used with -test_libresolution, only these paths exist">;
This is my Driver refactoring patch. The major changes are: 1) LinkerOptions has been merged into TargetInfo 2) LinkerInvocation has been merged into Driver 3) Drivers no longer convert arguments into an intermediate (core) argument list, but instead create a TargetInfo object and call setter methods on it. This is only how in-process linking would work. That is, you can programmatically set up a TargetInfo object which controls the linking. 4) Lots of tweaks to test suite to work with driver changes 5) Add the DarwinDriver 6) I heavily doxygen commented TargetInfo.h Things to do after this patch is committed: a) Consider renaming TargetInfo, given its new roll. b) Consider pulling the list of input files out of TargetInfo. This will enable in-process clients to create one TargetInfo the re-use it with different input file lists. c) Work out a way for Drivers to format the warnings and error done in core linking. llvm-svn: 178776
2013-04-05 02:59:24 +08:00
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
// general options
def output : Separate<["-"], "o">, HelpText<"Output file path">;
def arch : Separate<["-"], "arch">, HelpText<"Architecture to link">;
[mach-o] Add support for -sectalign option The -sectalign option is used to increase the alignment required for a section. It required some reworking of how the __TEXT segment is laid out because that segment also contains the mach_header and load commands. And the size of load commands depend on the number of segments, sections, and dependent dylibs used. Using this option will simplify some future test cases because the final address of code can be pinned down, making tests of its content easier. llvm-svn: 214268
2014-07-30 08:58:06 +08:00
def sectalign : MultiArg<["-"], "sectalign", 3>,
HelpText<"alignment for segment/section">;
[mach-o] wire up -t option llvm-svn: 214414
2014-08-01 02:19:03 +08:00
def t : Flag<["-"], "t">,
HelpText<"Print the names of the input files as ld processes them">;
[mach-o] Support re-exported dylibs In general two-level namespace means each program records exactly which dylib each undefined (imported) symbol comes from. But, sometimes the implementor wants to hide the implementation dylib. For instance libSytem.dylib is the base dylib all Darwin programs must link with. A few years ago it was split up into two dozen dylibs by all are hidden behind libSystem.dylib which re-exports each sub-dylib. All clients still think libSystem.dylib is the implementor. To support this, the linker must load "indirect" dylibs and not just the "direct" dylibs specified on the command line. This is done in the createImplicitFiles() method after all command line specified files are loaded. Since an indirect dylib may have already been loaded as a direct dylib (or indirectly via a previous direct dylib), the MachOLinkingContext keeps a list of all loaded dylibs. With this change hello world can now be linked against the real OS or SDK. llvm-svn: 215605
2014-08-14 07:55:41 +08:00
def v : Flag<["-"], "v">,
HelpText<"Print linker information">;
[mach-o] Add support for -sectalign option The -sectalign option is used to increase the alignment required for a section. It required some reworking of how the __TEXT segment is laid out because that segment also contains the mach_header and load commands. And the size of load commands depend on the number of segments, sections, and dependent dylibs used. Using this option will simplify some future test cases because the final address of code can be pinned down, making tests of its content easier. llvm-svn: 214268
2014-07-30 08:58:06 +08:00
This is my Driver refactoring patch. The major changes are: 1) LinkerOptions has been merged into TargetInfo 2) LinkerInvocation has been merged into Driver 3) Drivers no longer convert arguments into an intermediate (core) argument list, but instead create a TargetInfo object and call setter methods on it. This is only how in-process linking would work. That is, you can programmatically set up a TargetInfo object which controls the linking. 4) Lots of tweaks to test suite to work with driver changes 5) Add the DarwinDriver 6) I heavily doxygen commented TargetInfo.h Things to do after this patch is committed: a) Consider renaming TargetInfo, given its new roll. b) Consider pulling the list of input files out of TargetInfo. This will enable in-process clients to create one TargetInfo the re-use it with different input file lists. c) Work out a way for Drivers to format the warnings and error done in core linking. llvm-svn: 178776
2013-04-05 02:59:24 +08:00
Add -help option to Darwin Driver. Use grouping in Options table to better format help output llvm-svn: 186640
2013-07-19 09:02:49 +08:00
// extras
def help : Flag<["-"], "help">;