1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
//===--- InstallAPIOpts.td ------------------------------------------------===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
//
// This file defines the specific options for InstallAPI.
//
//===----------------------------------------------------------------------===//
// Include the common option parsing interfaces.
include "llvm/Option/OptParser.td"
/////////
// Options
//
/// TextAPI options.
//
def filetype : Joined<["--"], "filetype=">,
HelpText<"Specify the output file type (tbd-v4 or tbd-v5)">;
def not_for_dyld_shared_cache : Joined<["-"], "not_for_dyld_shared_cache">,
HelpText<"Mark library as shared cache ineligible">;
//
/// Debugging or logging options.
//
def t: Flag<["-"], "t">,
HelpText<"Logs each dylib loaded for InstallAPI. Useful for debugging problems with search paths where the wrong library is loaded.">;
//
/// Verification options.
//
def verify_against : Separate<["-"], "verify-against">,
HelpText<"Verify the specified dynamic library/framework against the headers">;
def verify_against_EQ : Joined<["--"], "verify-against=">, Alias<verify_against>;
def verify_mode_EQ : Joined<["--"], "verify-mode=">,
HelpText<"Specify the severity and extend of the validation. Valid modes are ErrorsOnly, ErrorsAndWarnings, and Pedantic.">;
def demangle : Flag<["--", "-"], "demangle">,
HelpText<"Demangle symbols when printing warnings and errors">;
def dsym: Joined<["--"], "dsym=">,
MetaVarName<"<path>">, HelpText<"Specify dSYM path for enriched diagnostics.">;
//
/// Additional input options.
//
def extra_project_header : Separate<["-"], "extra-project-header">,
MetaVarName<"<path>">,
HelpText<"Add additional project header location for parsing">;
def extra_project_header_EQ : Joined<["--"], "extra-project-header=">,
Alias<extra_project_header>;
def exclude_project_header : Separate<["-"], "exclude-project-header">,
MetaVarName<"<glob>">,
HelpText<"Exclude project header from parsing">;
def exclude_project_header_EQ : Joined<["--"], "exclude-project-header=">,
Alias<exclude_project_header>;
def extra_public_header : Separate<["-"], "extra-public-header">,
MetaVarName<"<path>">,
HelpText<"Add additional public header location for parsing">;
def extra_public_header_EQ : Joined<["--"], "extra-public-header=">,
Alias<extra_public_header>;
def extra_private_header : Separate<["-"], "extra-private-header">,
MetaVarName<"<path>">,
HelpText<"Add additional private header location for parsing">;
def extra_private_header_EQ : Joined<["--"], "extra-private-header=">,
Alias<extra_private_header>;
def exclude_public_header : Separate<["-"], "exclude-public-header">,
MetaVarName<"<glob>">,
HelpText<"Exclude public header from parsing">;
def exclude_public_header_EQ : Joined<["--"], "exclude-public-header=">,
Alias<exclude_public_header>;
def exclude_private_header : Separate<["-"], "exclude-private-header">,
MetaVarName<"<glob>">,
HelpText<"Exclude private header from parsing">;
def exclude_private_header_EQ : Joined<["--"], "exclude-private-header=">,
Alias<exclude_private_header>;
def public_umbrella_header : Separate<["-"], "public-umbrella-header">,
MetaVarName<"<path>">, HelpText<"Specify the public umbrella header location">;
def public_umbrella_header_EQ : Joined<["--"], "public-umbrella-header=">,
Alias<public_umbrella_header>;
def private_umbrella_header : Separate<["-"], "private-umbrella-header">,
MetaVarName<"<path>">, HelpText<"Specify the private umbrella header location">;
def private_umbrella_header_EQ : Joined<["--"], "private-umbrella-header=">,
Alias<private_umbrella_header>;
def project_umbrella_header : Separate<["-"], "project-umbrella-header">,
MetaVarName<"<path>">, HelpText<"Specify the project umbrella header location">;
def project_umbrella_header_EQ : Joined<["--"], "project-umbrella-header=">,
Alias<project_umbrella_header>;
//
/// X<label> overrides.
//
def Xplatform__ : Joined<["-"], "Xplatform_">;
def Xproject : Joined<["-"], "Xproject">;
def X__ : Joined<["-"], "X">,
HelpText<"Pass <arg> to run unique clang invocation identified as <label>">,
MetaVarName<"<label> <arg>">;
def option_list : Separate<["-"], "optionlist">, MetaVarName<"<path>">,
HelpText<"Specifies the <path> to a file that contains X<label> arguments to parse.">;
//
/// Overidden clang options for different behavior.
//
// Clang's Xarch does not support options that require arguments.
// But is supported for InstallAPI generation.
def Xarch__ : Joined<["-"], "Xarch_">;
def allowable_client : Separate<["-"], "allowable_client">,
HelpText<"Restricts what can link against the dynamic library being created">;
def rpath: Separate<["-"], "rpath">,
HelpText<"Add path to the runpath search path list for the dynamic library being created.">;
def reexport_l : Joined<["-"], "reexport-l">,
HelpText<"Re-export the specified library">;
def reexport_library : Separate<["-"], "reexport_library">, MetaVarName<"<path>">,
HelpText<"Re-export the specified library">;
def reexport_framework : Separate<["-"], "reexport_framework">,
HelpText<"Re-export the specified framework">;
// Xproject supported options.
def fobjc_arc : Flag<["-"], "fobjc-arc">,
HelpText<"Synthesize retain and release calls for Objective-C pointers">;
def include_ : JoinedOrSeparate<["-", "--"], "include">,
MetaVarName<"<file>">, HelpText<"Include file before parsing, can only be used with -Xproject">;
def fvisibility_EQ : Joined<["-"], "fvisibility=">,
HelpText<"Set the default symbol visibility for all global declarations">;
def fmodules : Flag <["-"], "fmodules">,
HelpText<"Enable the 'modules' language feature">;
def fmodules_cache_path : Joined<["-"], "fmodules-cache-path=">,
MetaVarName<"<directory>">,
HelpText<"Specify the module cache path">;
// Xplatform supported options.
def iframework : JoinedOrSeparate<["-"], "iframework">,
HelpText<"Add directory to SYSTEM framework search path">;
// X<label> prefixes supported options.
def D : JoinedOrSeparate<["-"], "D">, HelpText<"Define macro">;
def U : JoinedOrSeparate<["-"], "U">, HelpText<"Undefine macro">;
|
