clang 22.0.0git
clang::FrontendOptions Class Reference

FrontendOptions - Options for controlling the behavior of the frontend. More...

#include "clang/Frontend/FrontendOptions.h"

Public Member Functions

 FrontendOptions ()

Static Public Member Functions

static InputKind getInputKindForExtension (StringRef Extension)
 getInputKindForExtension - Return the appropriate input kind for a file extension.

Public Attributes

unsigned DisableFree: 1
 Disable memory freeing on exit.
unsigned RelocatablePCH: 1
 When generating PCH files, instruct the AST writer to create relocatable PCH files.
unsigned ShowHelp: 1
 Show the -help text.
unsigned ShowStats: 1
 Show frontend performance metrics and statistics.
unsigned AppendStats: 1
unsigned PrintSupportedCPUs: 1
 print the supported cpus for the current target
unsigned PrintSupportedExtensions: 1
 Print the supported extensions for the current target.
unsigned PrintEnabledExtensions: 1
 Print the extensions enabled for the current target.
unsigned ShowVersion: 1
 Show the -version text.
unsigned FixWhatYouCan: 1
 Apply fixes even if there are unfixable errors.
unsigned FixOnlyWarnings: 1
 Apply fixes only for warnings.
unsigned FixAndRecompile: 1
 Apply fixes and recompile.
unsigned FixToTemporaries: 1
 Apply fixes to temporary files.
unsigned SkipFunctionBodies: 1
 Skip over function bodies to speed up parsing in cases you do not need them (e.g.
unsigned UseGlobalModuleIndex: 1
 Whether we can use the global module index if available.
unsigned GenerateGlobalModuleIndex: 1
 Whether we can generate the global module index if needed.
unsigned ASTDumpDecls: 1
 Whether we include declaration dumps in AST dumps.
unsigned ASTDumpAll: 1
 Whether we deserialize all decls when forming AST dumps.
unsigned ASTDumpLookups: 1
 Whether we include lookup table dumps in AST dumps.
unsigned ASTDumpDeclTypes: 1
 Whether we include declaration type dumps in AST dumps.
unsigned BuildingImplicitModule: 1
 Whether we are performing an implicit module build.
unsigned BuildingImplicitModuleUsesLock: 1
 Whether to use a filesystem lock when building implicit modules.
unsigned ModulesEmbedAllFiles: 1
 Whether we should embed all used files into the PCM file.
unsigned IncludeTimestamps: 1
 Whether timestamps should be written to the produced PCH file.
unsigned UseTemporary: 1
 Should a temporary file be used during compilation.
unsigned IsSystemModule: 1
 When using -emit-module, treat the modulemap as a system module.
unsigned AllowPCMWithCompilerErrors: 1
 Output (and read) PCM files regardless of compiler errors.
unsigned ModulesShareFileManager: 1
 Whether to share the FileManager when building modules.
unsigned EmitSymbolGraph: 1
 Whether to emit symbol graph files as a side effect of compilation.
unsigned EmitExtensionSymbolGraphs: 1
 Whether to emit additional symbol graphs for extended modules.
unsigned EmitSymbolGraphSymbolLabelsForTesting: 1
 Whether to emit symbol labels for testing in generated symbol graphs.
unsigned EmitPrettySymbolGraphs: 1
 Whether to emit symbol labels for testing in generated symbol graphs.
unsigned GenReducedBMI: 1
 Whether to generate reduced BMI for C++20 named modules.
unsigned UseClangIRPipeline: 1
 Use Clang IR pipeline to emit code.
unsigned ClangIRDisablePasses: 1
 Disable Clang IR specific (CIR) passes.
unsigned ClangIRDisableCIRVerifier: 1
 Disable Clang IR (CIR) verifier.
CodeCompleteOptions CodeCompleteOpts
ASTDumpOutputFormat ASTDumpFormat = ADOF_Default
 Specifies the output format of the AST.
InputKind DashX
 The input kind, either specified via -x argument or deduced from the input file name.
SmallVector< FrontendInputFile, 0 > Inputs
 The input files and their types.
std::string OriginalModuleMap
 When the input is a module map, the original module map file from which that map was inferred, if any (for umbrella modules).
std::string OutputFile
 The output file, if any.
std::string FixItSuffix
 If given, the new suffix for fix-it rewritten files.
std::string ASTDumpFilter
 If given, filter dumped AST Decl nodes by this substring.
ParsedSourceLocation CodeCompletionAt
 If given, enable code completion at the provided location.
frontend::ActionKind ProgramAction = frontend::ParseSyntaxOnly
 The frontend action to perform.
std::string ActionName
 The name of the action to run when using a plugin action.
std::string ProductName
 The name of the product the input files belong too.
std::vector< std::string > ExtractAPIIgnoresFileList
std::string SymbolGraphOutputDir
std::map< std::string, std::vector< std::string > > PluginArgs
 Args to pass to the plugins.
std::vector< std::string > AddPluginActions
 The list of plugin actions to run in addition to the normal action.
std::vector< std::string > Plugins
 The list of plugins to load.
std::vector< std::shared_ptr< ModuleFileExtension > > ModuleFileExtensions
 The list of module file extensions.
std::vector< std::string > ModuleMapFiles
 The list of module map files to load before processing the input.
std::vector< std::string > ModuleFiles
 The list of additional prebuilt module files to load before processing the input.
std::vector< std::string > ModulesEmbedFiles
 The list of files to embed into the compiled module file.
std::vector< std::string > ASTMergeFiles
 The list of AST files to merge.
std::vector< std::string > LLVMArgs
 A list of arguments to forward to LLVM's option processing; this should only be used for debugging and experimental features.
std::vector< std::string > MLIRArgs
 A list of arguments to forward to MLIR's option processing; this should only be used for debugging and experimental features.
std::string OverrideRecordLayoutsFile
 File name of the file that will provide record layouts (in the format produced by -fdump-record-layouts).
std::string AuxTriple
 Auxiliary triple for CUDA/HIP compilation.
std::optional< std::string > AuxTargetCPU
 Auxiliary target CPU for CUDA/HIP compilation.
std::optional< std::vector< std::string > > AuxTargetFeatures
 Auxiliary target features for CUDA/HIP compilation.
std::string StatsFile
 Filename to write statistics to.
unsigned TimeTraceGranularity
 Minimum time granularity (in microseconds) traced by time profiler.
unsigned TimeTraceVerbose: 1
 Make time trace capture verbose event details (e.g.
std::string TimeTracePath
 Path which stores the output files for -ftime-trace.
std::string ModuleOutputPath
 Output Path for module output file.
std::string DumpMinimizationHintsPath
 Output path to dump ranges of deserialized declarations to use as minimization hints.

Detailed Description

FrontendOptions - Options for controlling the behavior of the frontend.

Definition at line 276 of file FrontendOptions.h.

Constructor & Destructor Documentation

◆ FrontendOptions()

Member Function Documentation

◆ getInputKindForExtension()

InputKind FrontendOptions::getInputKindForExtension ( StringRef Extension)
static

getInputKindForExtension - Return the appropriate input kind for a file extension.

For example, "c" would return Language::C.

Returns
The input kind for the extension, or Language::Unknown if the extension is not recognized.

Definition at line 15 of file FrontendOptions.cpp.

References clang::Asm, clang::C, clang::CIR, clang::CUDA, clang::CXX, clang::HIP, clang::HLSL, clang::LLVM_IR, clang::ObjC, clang::ObjCXX, clang::OpenCL, clang::OpenCLCXX, clang::InputKind::Precompiled, and clang::Unknown.

Referenced by ParseFrontendArgs().

Member Data Documentation

◆ ActionName

std::string clang::FrontendOptions::ActionName

The name of the action to run when using a plugin action.

Definition at line 455 of file FrontendOptions.h.

Referenced by clang::CreateFrontendBaseAction(), GenerateFrontendArgs(), clang::CompilerInstance::LoadRequestedPlugins(), and ParseFrontendArgs().

◆ AddPluginActions

std::vector<std::string> clang::FrontendOptions::AddPluginActions

The list of plugin actions to run in addition to the normal action.

Definition at line 474 of file FrontendOptions.h.

◆ AllowPCMWithCompilerErrors

unsigned clang::FrontendOptions::AllowPCMWithCompilerErrors

◆ AppendStats

unsigned clang::FrontendOptions::AppendStats

Definition at line 296 of file FrontendOptions.h.

Referenced by FrontendOptions().

◆ ASTDumpAll

unsigned clang::FrontendOptions::ASTDumpAll

Whether we deserialize all decls when forming AST dumps.

Definition at line 349 of file FrontendOptions.h.

Referenced by clang::ASTDumpAction::CreateASTConsumer(), GenerateFrontendArgs(), and ParseFrontendArgs().

◆ ASTDumpDecls

unsigned clang::FrontendOptions::ASTDumpDecls

Whether we include declaration dumps in AST dumps.

Definition at line 345 of file FrontendOptions.h.

Referenced by clang::ASTDumpAction::CreateASTConsumer(), FrontendOptions(), GenerateFrontendArgs(), and ParseFrontendArgs().

◆ ASTDumpDeclTypes

unsigned clang::FrontendOptions::ASTDumpDeclTypes

Whether we include declaration type dumps in AST dumps.

Definition at line 357 of file FrontendOptions.h.

Referenced by clang::ASTDumpAction::CreateASTConsumer().

◆ ASTDumpFilter

std::string clang::FrontendOptions::ASTDumpFilter

If given, filter dumped AST Decl nodes by this substring.

Definition at line 446 of file FrontendOptions.h.

Referenced by clang::ASTDumpAction::CreateASTConsumer(), and clang::ASTPrintAction::CreateASTConsumer().

◆ ASTDumpFormat

ASTDumpOutputFormat clang::FrontendOptions::ASTDumpFormat = ADOF_Default

Specifies the output format of the AST.

Definition at line 426 of file FrontendOptions.h.

Referenced by clang::ASTDumpAction::CreateASTConsumer(), GenerateFrontendArgs(), and ParseFrontendArgs().

◆ ASTDumpLookups

unsigned clang::FrontendOptions::ASTDumpLookups

Whether we include lookup table dumps in AST dumps.

Definition at line 353 of file FrontendOptions.h.

Referenced by clang::ASTDumpAction::CreateASTConsumer(), and FrontendOptions().

◆ ASTMergeFiles

std::vector<std::string> clang::FrontendOptions::ASTMergeFiles

The list of AST files to merge.

Definition at line 493 of file FrontendOptions.h.

Referenced by clang::CreateFrontendAction().

◆ AuxTargetCPU

std::optional<std::string> clang::FrontendOptions::AuxTargetCPU

Auxiliary target CPU for CUDA/HIP compilation.

Definition at line 511 of file FrontendOptions.h.

Referenced by clang::CompilerInstance::createTarget(), GenerateFrontendArgs(), and ParseFrontendArgs().

◆ AuxTargetFeatures

std::optional<std::vector<std::string> > clang::FrontendOptions::AuxTargetFeatures

Auxiliary target features for CUDA/HIP compilation.

Definition at line 514 of file FrontendOptions.h.

Referenced by clang::CompilerInstance::createTarget(), GenerateFrontendArgs(), and ParseFrontendArgs().

◆ AuxTriple

std::string clang::FrontendOptions::AuxTriple

Auxiliary triple for CUDA/HIP compilation.

Definition at line 508 of file FrontendOptions.h.

◆ BuildingImplicitModule

unsigned clang::FrontendOptions::BuildingImplicitModule

Whether we are performing an implicit module build.

Definition at line 361 of file FrontendOptions.h.

Referenced by clang::GenerateModuleAction::CreateMultiplexConsumer(), and FrontendOptions().

◆ BuildingImplicitModuleUsesLock

unsigned clang::FrontendOptions::BuildingImplicitModuleUsesLock

Whether to use a filesystem lock when building implicit modules.

Definition at line 365 of file FrontendOptions.h.

Referenced by compileModuleAndReadAST(), and FrontendOptions().

◆ ClangIRDisableCIRVerifier

unsigned clang::FrontendOptions::ClangIRDisableCIRVerifier

Disable Clang IR (CIR) verifier.

Definition at line 421 of file FrontendOptions.h.

Referenced by FrontendOptions(), and ParseFrontendArgs().

◆ ClangIRDisablePasses

unsigned clang::FrontendOptions::ClangIRDisablePasses

Disable Clang IR specific (CIR) passes.

Definition at line 417 of file FrontendOptions.h.

Referenced by FrontendOptions(), and ParseFrontendArgs().

◆ CodeCompleteOpts

CodeCompleteOptions clang::FrontendOptions::CodeCompleteOpts

Definition at line 423 of file FrontendOptions.h.

Referenced by clang::ASTUnit::CodeComplete().

◆ CodeCompletionAt

ParsedSourceLocation clang::FrontendOptions::CodeCompletionAt

◆ DashX

InputKind clang::FrontendOptions::DashX

The input kind, either specified via -x argument or deduced from the input file name.

Definition at line 430 of file FrontendOptions.h.

Referenced by GenerateFrontendArgs(), clang::InitializePreprocessor(), and ParseFrontendArgs().

◆ DisableFree

unsigned clang::FrontendOptions::DisableFree

◆ DumpMinimizationHintsPath

std::string clang::FrontendOptions::DumpMinimizationHintsPath

Output path to dump ranges of deserialized declarations to use as minimization hints.

Definition at line 535 of file FrontendOptions.h.

◆ EmitExtensionSymbolGraphs

unsigned clang::FrontendOptions::EmitExtensionSymbolGraphs

Whether to emit additional symbol graphs for extended modules.

Definition at line 397 of file FrontendOptions.h.

Referenced by FrontendOptions(), and clang::ExtractAPIActionBase::ImplEndSourceFileAction().

◆ EmitPrettySymbolGraphs

unsigned clang::FrontendOptions::EmitPrettySymbolGraphs

Whether to emit symbol labels for testing in generated symbol graphs.

Definition at line 405 of file FrontendOptions.h.

Referenced by FrontendOptions(), and clang::ExtractAPIActionBase::ImplEndSourceFileAction().

◆ EmitSymbolGraph

unsigned clang::FrontendOptions::EmitSymbolGraph

Whether to emit symbol graph files as a side effect of compilation.

Definition at line 393 of file FrontendOptions.h.

Referenced by clang::CreateFrontendAction(), and FrontendOptions().

◆ EmitSymbolGraphSymbolLabelsForTesting

unsigned clang::FrontendOptions::EmitSymbolGraphSymbolLabelsForTesting

Whether to emit symbol labels for testing in generated symbol graphs.

Definition at line 401 of file FrontendOptions.h.

Referenced by FrontendOptions(), and clang::ExtractAPIActionBase::ImplEndSourceFileAction().

◆ ExtractAPIIgnoresFileList

std::vector<std::string> clang::FrontendOptions::ExtractAPIIgnoresFileList

◆ FixAndRecompile

unsigned clang::FrontendOptions::FixAndRecompile

Apply fixes and recompile.

Definition at line 324 of file FrontendOptions.h.

Referenced by clang::CreateFrontendAction(), and FrontendOptions().

◆ FixItSuffix

std::string clang::FrontendOptions::FixItSuffix

If given, the new suffix for fix-it rewritten files.

Definition at line 443 of file FrontendOptions.h.

Referenced by clang::FixItAction::BeginSourceFileAction(), GenerateFrontendArgs(), and ParseFrontendArgs().

◆ FixOnlyWarnings

unsigned clang::FrontendOptions::FixOnlyWarnings

Apply fixes only for warnings.

Definition at line 320 of file FrontendOptions.h.

Referenced by clang::FixItRecompile::BeginInvocation(), and FrontendOptions().

◆ FixToTemporaries

unsigned clang::FrontendOptions::FixToTemporaries

Apply fixes to temporary files.

Definition at line 328 of file FrontendOptions.h.

Referenced by clang::FixItRecompile::BeginInvocation(), and FrontendOptions().

◆ FixWhatYouCan

unsigned clang::FrontendOptions::FixWhatYouCan

Apply fixes even if there are unfixable errors.

Definition at line 316 of file FrontendOptions.h.

Referenced by clang::FixItRecompile::BeginInvocation(), clang::FixItAction::BeginSourceFileAction(), and FrontendOptions().

◆ GenerateGlobalModuleIndex

unsigned clang::FrontendOptions::GenerateGlobalModuleIndex

Whether we can generate the global module index if needed.

Definition at line 341 of file FrontendOptions.h.

Referenced by FixupInvocation(), and FrontendOptions().

◆ GenReducedBMI

unsigned clang::FrontendOptions::GenReducedBMI

◆ IncludeTimestamps

unsigned clang::FrontendOptions::IncludeTimestamps

Whether timestamps should be written to the produced PCH file.

Definition at line 373 of file FrontendOptions.h.

Referenced by clang::GenerateModuleAction::CreateMultiplexConsumer(), and FrontendOptions().

◆ Inputs

◆ IsSystemModule

unsigned clang::FrontendOptions::IsSystemModule

When using -emit-module, treat the modulemap as a system module.

Definition at line 381 of file FrontendOptions.h.

Referenced by ParseFrontendArgs().

◆ LLVMArgs

std::vector<std::string> clang::FrontendOptions::LLVMArgs

A list of arguments to forward to LLVM's option processing; this should only be used for debugging and experimental features.

Definition at line 497 of file FrontendOptions.h.

Referenced by clang::ExecuteCompilerInvocation(), and makeCommonInvocationForModuleBuild().

◆ MLIRArgs

std::vector<std::string> clang::FrontendOptions::MLIRArgs

A list of arguments to forward to MLIR's option processing; this should only be used for debugging and experimental features.

Definition at line 501 of file FrontendOptions.h.

Referenced by clang::ExecuteCompilerInvocation().

◆ ModuleFileExtensions

std::vector<std::shared_ptr<ModuleFileExtension> > clang::FrontendOptions::ModuleFileExtensions

◆ ModuleFiles

std::vector<std::string> clang::FrontendOptions::ModuleFiles

The list of additional prebuilt module files to load before processing the input.

Definition at line 487 of file FrontendOptions.h.

Referenced by clang::tooling::dependencies::ModuleDepCollector::applyDiscoveredDependencies(), clang::FrontendAction::BeginSourceFile(), GenerateFrontendArgs(), and ParseFrontendArgs().

◆ ModuleMapFiles

std::vector<std::string> clang::FrontendOptions::ModuleMapFiles

The list of module map files to load before processing the input.

Definition at line 483 of file FrontendOptions.h.

Referenced by clang::tooling::dependencies::ModuleDepCollector::applyDiscoveredDependencies(), and clang::FrontendAction::BeginSourceFile().

◆ ModuleOutputPath

std::string clang::FrontendOptions::ModuleOutputPath

Output Path for module output file.

Definition at line 531 of file FrontendOptions.h.

Referenced by clang::CodeGenAction::CreateASTConsumer(), and clang::GenerateModuleInterfaceAction::CreateASTConsumer().

◆ ModulesEmbedAllFiles

unsigned clang::FrontendOptions::ModulesEmbedAllFiles

Whether we should embed all used files into the PCM file.

Definition at line 369 of file FrontendOptions.h.

Referenced by clang::FrontendAction::BeginSourceFile(), and FrontendOptions().

◆ ModulesEmbedFiles

std::vector<std::string> clang::FrontendOptions::ModulesEmbedFiles

The list of files to embed into the compiled module file.

Definition at line 490 of file FrontendOptions.h.

Referenced by clang::FrontendAction::BeginSourceFile().

◆ ModulesShareFileManager

unsigned clang::FrontendOptions::ModulesShareFileManager

Whether to share the FileManager when building modules.

Definition at line 389 of file FrontendOptions.h.

Referenced by FrontendOptions().

◆ OriginalModuleMap

std::string clang::FrontendOptions::OriginalModuleMap

When the input is a module map, the original module map file from which that map was inferred, if any (for umbrella modules).

Definition at line 437 of file FrontendOptions.h.

Referenced by prepareToBuildModule().

◆ OutputFile

◆ OverrideRecordLayoutsFile

std::string clang::FrontendOptions::OverrideRecordLayoutsFile

File name of the file that will provide record layouts (in the format produced by -fdump-record-layouts).

Definition at line 505 of file FrontendOptions.h.

Referenced by clang::FrontendAction::BeginSourceFile().

◆ PluginArgs

std::map<std::string, std::vector<std::string> > clang::FrontendOptions::PluginArgs

Args to pass to the plugins.

Definition at line 471 of file FrontendOptions.h.

Referenced by clang::CreateFrontendBaseAction(), GenerateFrontendArgs(), and ParseFrontendArgs().

◆ Plugins

std::vector<std::string> clang::FrontendOptions::Plugins

The list of plugins to load.

Definition at line 477 of file FrontendOptions.h.

Referenced by clang::ento::CreateAnalysisConsumer(), GenerateFrontendArgs(), and ParseFrontendArgs().

◆ PrintEnabledExtensions

unsigned clang::FrontendOptions::PrintEnabledExtensions

Print the extensions enabled for the current target.

Definition at line 308 of file FrontendOptions.h.

◆ PrintSupportedCPUs

unsigned clang::FrontendOptions::PrintSupportedCPUs

print the supported cpus for the current target

Definition at line 300 of file FrontendOptions.h.

◆ PrintSupportedExtensions

unsigned clang::FrontendOptions::PrintSupportedExtensions

Print the supported extensions for the current target.

Definition at line 304 of file FrontendOptions.h.

◆ ProductName

std::string clang::FrontendOptions::ProductName

The name of the product the input files belong too.

Definition at line 459 of file FrontendOptions.h.

Referenced by clang::ExtractAPIAction::CreateASTConsumer(), and clang::WrappingExtractAPIAction::CreateASTConsumer().

◆ ProgramAction

◆ RelocatablePCH

unsigned clang::FrontendOptions::RelocatablePCH

When generating PCH files, instruct the AST writer to create relocatable PCH files.

Definition at line 285 of file FrontendOptions.h.

Referenced by clang::GeneratePCHAction::ComputeASTConsumerArguments(), clang::GeneratePCHAction::CreateASTConsumer(), and FrontendOptions().

◆ ShowHelp

unsigned clang::FrontendOptions::ShowHelp

Show the -help text.

Definition at line 289 of file FrontendOptions.h.

Referenced by clang::ExecuteCompilerInvocation(), and FrontendOptions().

◆ ShowStats

unsigned clang::FrontendOptions::ShowStats

Show frontend performance metrics and statistics.

Definition at line 293 of file FrontendOptions.h.

Referenced by clang::FrontendAction::EndSourceFile(), clang::ASTFrontendAction::ExecuteAction(), FixupInvocation(), and FrontendOptions().

◆ ShowVersion

unsigned clang::FrontendOptions::ShowVersion

Show the -version text.

Definition at line 312 of file FrontendOptions.h.

Referenced by clang::ExecuteCompilerInvocation(), and FrontendOptions().

◆ SkipFunctionBodies

unsigned clang::FrontendOptions::SkipFunctionBodies

Skip over function bodies to speed up parsing in cases you do not need them (e.g.

with code completion).

Definition at line 333 of file FrontendOptions.h.

Referenced by clang::ASTFrontendAction::ExecuteAction(), and FrontendOptions().

◆ StatsFile

std::string clang::FrontendOptions::StatsFile

Filename to write statistics to.

Definition at line 517 of file FrontendOptions.h.

Referenced by clang::CompilerInstance::ExecuteAction().

◆ SymbolGraphOutputDir

std::string clang::FrontendOptions::SymbolGraphOutputDir

◆ TimeTraceGranularity

unsigned clang::FrontendOptions::TimeTraceGranularity

Minimum time granularity (in microseconds) traced by time profiler.

Definition at line 520 of file FrontendOptions.h.

Referenced by FrontendOptions().

◆ TimeTracePath

std::string clang::FrontendOptions::TimeTracePath

Path which stores the output files for -ftime-trace.

Definition at line 528 of file FrontendOptions.h.

◆ TimeTraceVerbose

unsigned clang::FrontendOptions::TimeTraceVerbose

Make time trace capture verbose event details (e.g.

source filenames). This can increase the size of the output by 2-3 times.

Definition at line 525 of file FrontendOptions.h.

Referenced by FrontendOptions().

◆ UseClangIRPipeline

unsigned clang::FrontendOptions::UseClangIRPipeline

Use Clang IR pipeline to emit code.

Definition at line 413 of file FrontendOptions.h.

Referenced by clang::CreateFrontendBaseAction(), FrontendOptions(), and ParseFrontendArgs().

◆ UseGlobalModuleIndex

unsigned clang::FrontendOptions::UseGlobalModuleIndex

Whether we can use the global module index if available.

Definition at line 337 of file FrontendOptions.h.

Referenced by FixupInvocation(), and FrontendOptions().

◆ UseTemporary

unsigned clang::FrontendOptions::UseTemporary

Should a temporary file be used during compilation.

Definition at line 377 of file FrontendOptions.h.

Referenced by FrontendOptions().


The documentation for this class was generated from the following files: