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

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

251 lines
12 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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
HelpText<"Create binary for use with embedded systems">, Group<grp_kind>;
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
// optimizations
def grp_opts : OptionGroup<"opts">, HelpText<"OPTIMIZATIONS">;
def dead_strip : Flag<["-"], "dead_strip">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<version>">,
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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<version>">,
HelpText<"Minimum iOS version">, Group<grp_opts>;
[mach-o] add -iphoneos_version_min as alias for -ios_version_min llvm-svn: 219041
2014-10-04 08:19:56 +08:00
def iphoneos_version_min : Separate<["-"], "iphoneos_version_min">,
Alias<ios_version_min>;
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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<version>">,
HelpText<"Minimum iOS simulator version">, Group<grp_opts>;
Add support for -sdk_version cmdline option. This option is emitted in the min_version load commands. Note, there's currently a difference in behaviour compared to ld64 in that we emit a warning if we generate a min_version load command and didn't give an sdk_version. We need to decide what the correct behaviour is here as its possible we want to emit an error and force clients to provide the option. llvm-svn: 259729
2016-02-04 07:39:05 +08:00
def sdk_version : Separate<["-"], "sdk_version">,
MetaVarName<"<version>">,
HelpText<"SDK version">, Group<grp_opts>;
Add support for the source_version cmdline option. This is of the form A.B.C.D.E and to match ld64's behaviour, is always output to files, even when the version is 0. rdar://problem/24472630 llvm-svn: 259746
2016-02-04 10:45:23 +08:00
def source_version : Separate<["-"], "source_version">,
MetaVarName<"<version>">,
HelpText<"Source version">, Group<grp_opts>;
Add generation of LC_VERSION_MIN load commands. If the command line contains something like -macosx_version_min and we don't explicitly disable generation with -no_version_load_command then we generate the LC_VERSION_MIN command in the output file. There's a couple of FIXME's in here. These will be handled soon with more tests but I didn't want to grow this patch any more than it already was. rdar://problem/24472630 llvm-svn: 259718
2016-02-04 06:28:29 +08:00
def version_load_command : Flag<["-"], "version_load_command">,
HelpText<"Force generation of a version load command">, Group<grp_opts>;
def no_version_load_command : Flag<["-"], "no_version_load_command">,
HelpText<"Disable generation of a version load command">, Group<grp_opts>;
Generate LC_FUNCTION_STARTS load command. This load command generates data in the LINKEDIT section which is a list of ULEB128 delta's to all of the functions in the __text section. It is then 0 terminated and pointer aligned to pad. ld64 exposes the -function-starts and no-function-starts cmdline options to override behaviour from the defaults based on file types. rdar://problem/24472630 llvm-svn: 260188
2016-02-09 09:38:13 +08:00
def function_starts : Flag<["-"], "function_starts">,
HelpText<"Force generation of a function starts load command">,
Group<grp_opts>;
def no_function_starts : Flag<["-"], "no_function_starts">,
HelpText<"Disable generation of a function starts load command">,
Group<grp_opts>;
Add cmdline options for LC_DATA_IN_CODE load command. Also added the defaults for whether to generate this load command, which the cmdline options are able to override. There was also a difference to ld64 which is fixed here in that ld64 will generate an empty data in code command if requested. rdar://problem/24472630 llvm-svn: 260191
2016-02-09 10:10:39 +08:00
def data_in_code_info : Flag<["-"], "data_in_code_info">,
HelpText<"Force generation of a data in code load command">,
Group<grp_opts>;
def no_data_in_code_info : Flag<["-"], "no_data_in_code_info">,
HelpText<"Disable generation of a data in code load command">,
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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<option>">,
HelpText<"Options to pass to LLVM during LTO">, Group<grp_opts>;
[mach-o] Add support for -exported_symbols_list and -keep_private_externs Both options control the final scope of atoms. When -exported_symbols_list <file> is used, the file is parsed into one symbol per line in the file. Only those symbols will be exported (global) in the final linked image. The -keep_private_externs option is only used with -r mode. Normally, -r mode reduces private extern (scopeLinkageUnit) symbols to non-external. But add the -keep_private_externs option keeps them private external. llvm-svn: 216146
2014-08-21 09:59:11 +08:00
def exported_symbols_list : Separate<["-"], "exported_symbols_list">,
MetaVarName<"<file-path>">,
HelpText<"Restricts which symbols will be exported">, Group<grp_opts>;
def exported_symbol : Separate<["-"], "exported_symbol">,
MetaVarName<"<symbol>">,
HelpText<"Restricts which symbols will be exported">, Group<grp_opts>;
def unexported_symbols_list : Separate<["-"], "unexported_symbols_list">,
MetaVarName<"<file-path>">,
HelpText<"Lists symbols that should not be exported">, Group<grp_opts>;
def unexported_symbol : Separate<["-"], "unexported_symbol">,
MetaVarName<"<symbol>">,
HelpText<"A symbol which should not be exported">, Group<grp_opts>;
def keep_private_externs : Flag<["-"], "keep_private_externs">,
HelpText<"Private extern (hidden) symbols should not be transformed "
"into local symbols">, Group<grp_opts>;
[mach-o] Add support for -order_file option The darwin linker lets you rearrange functions and data for better locality (less paging). You do this with the -order_file option which supplies a text file containing one symbol per line. Implementing this required a small change to LayoutPass to add a custom sorter hook. llvm-svn: 221545
2014-11-08 05:01:21 +08:00
def order_file : Separate<["-"], "order_file">,
MetaVarName<"<file-path>">,
HelpText<"re-order and move specified symbols to start of their section">,
Group<grp_opts>;
[lld][MachO] Initial implementation of -flat_namespace and -undefined. This is a basic initial implementation of the -flat_namespace and -undefined options for LLD-darwin. It ignores several subtlties, but the result is close enough that we can now link LLVM (but not clang) on Darwin and pass all regression tests. llvm-svn: 248732
2015-09-29 04:25:14 +08:00
def flat_namespace : Flag<["-"], "flat_namespace">,
HelpText<"Resolves symbols in any (transitively) linked dynamic libraries. "
"Source libraries are not recorded: dyld will re-search all "
"images at runtime and use the first definition found.">,
Group<grp_opts>;
def twolevel_namespace : Flag<["-"], "twolevel_namespace">,
HelpText<"Resolves symbols in listed libraries only. Source libraries are "
"recorded in the symbol table.">,
Group<grp_opts>;
def undefined : Separate<["-"], "undefined">,
MetaVarName<"<undefined>">,
HelpText<"Determines how undefined symbols are handled.">,
Group<grp_opts>;
Add command line option to disable ObjC category merging. This adds the no_objc_category_merging cmdline option which will be used in an upcoming commit to disable the category optimizer. It is on by default in ld64 so we match that here. Test case will come soon with the patch to make use of this option. llvm-svn: 259439
2016-02-02 07:56:23 +08:00
def no_objc_category_merging : Flag<["-"], "no_objc_category_merging">,
HelpText<"Disables the optimisation which merges Objective-C categories "
"on a class in to the class itself.">,
Group<grp_opts>;
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
// main executable options
def grp_main : OptionGroup<"opts">, HelpText<"MAIN EXECUTABLE OPTIONS">;
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
def entry : Separate<["-"], "e">,
MetaVarName<"<entry-name>">,
HelpText<"entry symbol name">,Group<grp_main>;
[mach-o] Add support for -pie and -no_pie There is a bit (MH_PIE) in the flags field of the mach_header which tells the kernel is a program was built position independent (for ASLR). The linker automatically attempts to build programs PIE if they are built for a recent OS version. But the -pie and -no_pie options override that default behavior. llvm-svn: 217408
2014-09-09 08:17:52 +08:00
def pie : Flag<["-"], "pie">,
HelpText<"Create Position Independent Executable (for ASLR)">,
Group<grp_main>;
def no_pie : Flag<["-"], "no_pie">,
HelpText<"Do not create Position Independent Executable">,
Group<grp_main>;
[LLD] Add support for the -stack_size option to Darwin ld. llvm-svn: 237841
2015-05-21 06:10:50 +08:00
def stack_size : Separate<["-"], "stack_size">,
HelpText<"Specifies the maximum stack size for the main thread in a program. "
"Must be a page-size multiple. (default=8Mb)">,
Group<grp_main>;
Add support for export_dynamic cmdline option and behaviour. This option matches the behaviour of ld64, that is it prevents globals from being dead stripped in executables and dylibs. Reviewed by Lang Hames Differential Revision: http://reviews.llvm.org/D16026 llvm-svn: 258554
2016-01-23 05:13:24 +08:00
def export_dynamic : Flag<["-"], "export_dynamic">,
HelpText<"Preserves all global symbols in main executables during LTO">,
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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<path>">,
HelpText<"The dylib's install name">, Group<grp_dylib>;
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 mark_dead_strippable_dylib : Flag<["-"], "mark_dead_strippable_dylib">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
HelpText<"Marks the dylib as having no side effects during initialization">,
Group<grp_dylib>;
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 compatibility_version : Separate<["-"], "compatibility_version">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<version>">,
HelpText<"The dylib's compatibility version">, Group<grp_dylib>;
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 current_version : Separate<["-"], "current_version">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<version>">,
HelpText<"The dylib's current version">, Group<grp_dylib>;
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
// dylib executable options - compatibility aliases
def dylib_install_name : Separate<["-"], "dylib_install_name">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
Alias<install_name>;
def dylib_compatibility_version : Separate<["-"], "dylib_compatibility_version">,
MetaVarName<"<version>">, Alias<compatibility_version>;
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 dylib_current_version : Separate<["-"], "dylib_current_version">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<version>">, Alias<current_version>;
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
// bundle executable options
def grp_bundle : OptionGroup<"opts">, HelpText<"BUNDLE EXECUTABLE OPTIONS">;
def bundle_loader : Separate<["-"], "bundle_loader">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<path>">,
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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<dir>">,
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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<dir>">,
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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
HelpText<"Forces all members of all static libraries to be loaded">,
Group<grp_libs>;
[mach-o] Add support for -force_load option The darwin linker has two ways to force all members of an archive to be loaded. The -all_load option applies to all static libraries. The -force_load takes a path to a library and just that library's members are force loaded. llvm-svn: 221477
2014-11-07 03:33:57 +08:00
def force_load : Separate<["-"], "force_load">,
MetaVarName<"<library-path>">,
HelpText<"Forces all members of specified static libraries to be loaded">,
Group<grp_libs>;
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
def syslibroot : Separate<["-"], "syslibroot">, MetaVarName<"<dir>">,
HelpText<"Add path to SDK to all absolute library search paths">,
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
// Input options
def l : Joined<["-"], "l">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<libname>">,
HelpText<"Base name of library searched for in -L directories">;
[mach-o] Add support for upward linking To deal with cycles in shared library dependencies, the darwin linker supports marking specific link dependencies as "upward". An upward link is when a lower level library links against a higher level library. llvm-svn: 219949
2014-10-17 03:31:28 +08:00
def upward_l : Joined<["-"], "upward-l">,
MetaVarName<"<libname>">,
HelpText<"Base name of upward 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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<name>">,
HelpText<"Base name of framework searched for in -F directories">;
[mach-o] Add support for upward linking To deal with cycles in shared library dependencies, the darwin linker supports marking specific link dependencies as "upward". An upward link is when a lower level library links against a higher level library. llvm-svn: 219949
2014-10-17 03:31:28 +08:00
def upward_framework : Separate<["-"], "upward_framework">,
MetaVarName<"<name>">,
HelpText<"Base name of upward framework searched for in -F directories">;
def upward_library : Separate<["-"], "upward_library">,
MetaVarName<"<path>">,
HelpText<"path to upward dylib to link with">;
[mach-o] Support -filelist option in darwin driver The darwin linker has an option, heavily used by Xcode, in which, instead of listing all input files on the command line, the input file paths are written to a text file and the path of that text file is passed to the linker with the -filelist option (similar to @file). In order to make test cases for this, I generalized the -test_libresolution option to become -test_file_usage. llvm-svn: 215762
2014-08-16 03:53:41 +08:00
def filelist : Separate<["-"], "filelist">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<path>">,
HelpText<"file containing paths to input files">;
[mach-o] Support -filelist option in darwin driver The darwin linker has an option, heavily used by Xcode, in which, instead of listing all input files on the command line, the input file paths are written to a text file and the path of that text file is passed to the linker with the -filelist option (similar to @file). In order to make test cases for this, I generalized the -test_libresolution option to become -test_file_usage. llvm-svn: 215762
2014-08-16 03:53:41 +08:00
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">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
HelpText<"Emit output as yaml atoms">;
[mach-o] Support -filelist option in darwin driver The darwin linker has an option, heavily used by Xcode, in which, instead of listing all input files on the command line, the input file paths are written to a text file and the path of that text file is passed to the linker with the -filelist option (similar to @file). In order to make test cases for this, I generalized the -test_libresolution option to become -test_file_usage. llvm-svn: 215762
2014-08-16 03:53:41 +08:00
def test_file_usage : Flag<["-"], "test_file_usage">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
HelpText<"Only files specified by -file_exists are considered to exist. "
"Print which files would be used">;
[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 path_exists : Separate<["-"], "path_exists">,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<path>">,
HelpText<"Used with -test_file_usage to declare a path">;
[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
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
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
def output : Separate<["-"], "o">,
MetaVarName<"<path>">,
HelpText<"Output file path">;
def arch : Separate<["-"], "arch">,
MetaVarName<"<arch-name>">,
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>,
[mach-o] improve darwin driver 'usage' message when run with no args llvm-svn: 215781
2014-08-16 06:42:46 +08:00
MetaVarName<"<segname> <sectname> <alignment>">,
[lld][Darwin] Add support for the -sectcreate option. llvm-svn: 251183
2015-10-24 16:20:51 +08:00
HelpText<"Alignment for segment/section">;
def sectcreate : MultiArg<["-"], "sectcreate", 3>,
MetaVarName<"<segname> <sectname> <file>">,
HelpText<"Create section <segname>/<sectname> from contents of <file>">;
[mach-o]: implement -image_base option on Darwin. As suggested by Nick, this will make __unwind_info implementation more natural, and it'd have to be done at some point anyway. llvm-svn: 217486
2014-09-10 18:39:57 +08:00
def image_base : Separate<["-"], "image_base">;
[mach-o]: Support deprecated -seg1addr alias for -image_base Because NO LINKER MAY CHANGE. EVER. Even if it's a complete rewrite from scratch. llvm-svn: 217572
2014-09-11 15:56:20 +08:00
def seg1addr : Separate<["-"], "seg1addr">, Alias<image_base>;
[mach-o] Implement -demangle. The darwin linker has the -demangle option which directs it to demangle C++ (and soon Swift) mangled symbol names. Long term we need some Diagnostics object for formatting errors and warnings. But for now we have the Core linker just writing messages to llvm::errs(). So, to enable demangling, I changed the Resolver to call a LinkingContext method on the symbol name. To make this more interesting, the demangling code is done via __cxa_demangle() which is part of the C++ ABI, which is only supported on some platforms, so I had to conditionalize the code with the config generated HAVE_CXXABI_H. llvm-svn: 218718
2014-10-01 07:15:39 +08:00
def demangle : Flag<["-"], "demangle">,
HelpText<"Demangles symbol names in errors and warnings">;
[mach-o] Add support for -dependency_info command line option This option is added by Xcode when it runs the linker. It produces a binary file which contains the file the linker used. Xcode uses the info to dynamically update it dependency tracking. To check the content of the binary file, the test case uses a python script to dump the binary file as text which FileCheck can check. llvm-svn: 219039
2014-10-04 08:16:13 +08:00
def dependency_info : Separate<["-"], "dependency_info">,
MetaVarName<"<file>">,
HelpText<"Write binary list of files used during link">;
[mach-o] Add support for -S option The darwin linker does not process dwarf debug info. Instead it produces a "debug map" in the output file which points back to the original .o files for anything that wants debug info (e.g. debugger). The -S option means "don't add a debug map". lld for mach-o currently does not generate the debug map, so there is nothing to do when this option is used. But we need to process the option to get existing projects building. llvm-svn: 221432
2014-11-06 11:03:42 +08:00
def S : Flag<["-"], "S">,
HelpText<"Remove debug information (STABS or DWARF) from the output file">;
[macho] -rpath support Summary: Work on adding -rpath support to the mach-o linker. This patch is based on the ld64 behavior for the command line option validation. It includes a basic test to check that the LC_RPATH load commands are properly generated when that option is used. It also add LC_RPATH support to the binary reader, but I don't know how to test it though. Reviewers: kledzik Subscribers: llvm-commits Projects: #lld Differential Revision: http://reviews.llvm.org/D6724 llvm-svn: 224544
2014-12-19 05:33:38 +08:00
def rpath : Separate<["-"], "rpath">,
MetaVarName<"<path>">,
HelpText<"Add path to the runpath search path list for image being created">;
[mach-o]: Support deprecated -seg1addr alias for -image_base Because NO LINKER MAY CHANGE. EVER. Even if it's a complete rewrite from scratch. llvm-svn: 217572
2014-09-11 15:56:20 +08:00
[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">;
[Darwin] Use errorHandler from liblldCommon Summary: Error handling in liblldCore and the Darwin toolchain prints to an output stream. A TODO in the project explained that a diagnostics interface resembling Clang's should be added. For now, the simple diagnostics interface defined in liblldCommon seems like an improvement. It prints colors when they're available, uses locks for thread-safety, and abstracts away the `"error: "` and newline literal strings that litter the Darwin toolchain code. To use the liblldCommon error handler, a link dependency is added to the liblldDriver library. Test Plan: 1. check-lld 2. Invoke `ld64.lld -r` in a terminal that supports color output. Confirm that "ld64.lld: error: -arch not specified and could not be inferred" is output, and that the "error:" is colored red! Reviewers: ruiu, smeenai Reviewed By: ruiu Subscribers: mgorny, llvm-commits Differential Revision: https://reviews.llvm.org/D47998 llvm-svn: 334466
2018-06-12 10:34:04 +08:00
def error_limit : Separate<["-", "--"], "error-limit">,
MetaVarName<"<number>">,
HelpText<"Maximum number of errors to emit before stopping (0 = no limit)">;
[Darwin] Do not error on '-lto_library' option Summary: Any invocation of `clang -fuse-ld=lld` that results in a link command on a macOS host currently fails, because the Darwin lld driver does not recognize the `-lto_library` option that Clang passes it. Fix the error by having the Darwin driver ignore the option. The Clang driver's macOS toolchain is written such that it will always pass the `-lto_library` option to the linker invocation on a macOS host. And although the DarwinLdDriver is written to ignore any unknown arguments, because `-lto_library` begins with `-l`, the DarwinLdDriver interprets it as a library search command, for a library named "to_library". When the DarwinLdDriver is unable to find a library specified via `-l`, it exits with a hard error. This causes any invocation of `clang -fuse-ld=lld` that results in a link command on a macOS host to fail with an error. To fix the issue, I considered two alternatives: 1. Modify the Clang Darwin toolchain to only pass `-lto_library` if lld is *not* being used. lld doesn't support LTO on Darwin anyway, so it can't use the option. However, I opted against this because, if and when lld *does* support LTO on Darwin, I'll have to make another commit to Clang in order to get it to pass the option to lld again. 2. Modify the Darwin lld driver to ignore the `-lto_library` option. Just in case users may take this to mean LTO is supported, I also added a warning. If and when lld supports LTO on Darwin, the same commit that adds support for this option can remove the warning. Option (2) seemed better to me, and is the rationale behind this commit. Test Plan: check-lld Reviewers: ruiu, smeenai, pcc Reviewed By: smeenai Subscribers: JDevlieghere, pcc, mehdi_amini, inglorion, steven_wu, llvm-commits Differential Revision: https://reviews.llvm.org/D47994 llvm-svn: 334641
2018-06-14 02:59:14 +08:00
// Ignored options
def lto_library : Separate<["-"], "lto_library">,
MetaVarName<"<path>">,
HelpText<"Ignored for compatibility with other linkers">;
[mach-o] Add support for -single_module and -multi_module These are both obsolete options that controled how dylibs were built. llvm-svn: 216205
2014-08-22 02:57:42 +08:00
// Obsolete options
def grp_obsolete : OptionGroup<"obsolete">, HelpText<"OBSOLETE OPTIONS">;
def single_module : Flag<["-"], "single_module">,
HelpText<"Default for dylibs">, Group<grp_obsolete>;
def multi_module : Flag<["-"], "multi_module">,
HelpText<"Unsupported way to build dylibs">, Group<grp_obsolete>;
Add the GC commandline options and throw errors if they are used llvm-svn: 257907
2016-01-16 01:39:02 +08:00
def objc_gc_compaction : Flag<["-"], "objc_gc_compaction">,
HelpText<"Unsupported ObjC GC option">, Group<grp_obsolete>;
def objc_gc : Flag<["-"], "objc_gc">,
HelpText<"Unsupported ObjC GC option">, Group<grp_obsolete>;
def objc_gc_only : Flag<["-"], "objc_gc_only">,
HelpText<"Unsupported ObjC GC option">, Group<grp_obsolete>;