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

159 lines
6.9 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>;
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>;
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>;
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>;
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>;
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] 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] 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>">,
HelpText<"alignment for segment/section">;
[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] 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 -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>;