//===--- 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">;
Codebase Browser
llvm