19 #include "clang/Config/config.h"
36 #include "llvm/ADT/Statistic.h"
37 #include "llvm/Support/CrashRecoveryContext.h"
38 #include "llvm/Support/Errc.h"
39 #include "llvm/Support/FileSystem.h"
40 #include "llvm/Support/Host.h"
41 #include "llvm/Support/LockFileManager.h"
42 #include "llvm/Support/MemoryBuffer.h"
43 #include "llvm/Support/Path.h"
44 #include "llvm/Support/Program.h"
45 #include "llvm/Support/Signals.h"
46 #include "llvm/Support/Timer.h"
47 #include "llvm/Support/raw_ostream.h"
49 #include <system_error>
52 using namespace clang;
54 CompilerInstance::CompilerInstance(
55 std::shared_ptr<PCHContainerOperations> PCHContainerOps,
58 ModuleManager(nullptr), ThePCHContainerOperations(PCHContainerOps),
59 BuildGlobalModuleIndex(
false), HaveFullGlobalModuleIndex(
false),
60 ModuleBuildFailed(
false) {}
63 assert(OutputFiles.empty() &&
"Still output files in flight?");
71 return (BuildGlobalModuleIndex ||
72 (ModuleManager && ModuleManager->isGlobalIndexUnavailable() &&
89 VirtualFileSystem.reset();
110 Consumer = std::move(Value);
117 CompletionConsumer.reset(Value);
121 return std::move(TheSema);
125 return ModuleManager;
128 ModuleManager = Reader;
131 std::shared_ptr<ModuleDependencyCollector>
133 return ModuleDepCollector;
137 std::shared_ptr<ModuleDependencyCollector> Collector) {
138 ModuleDepCollector = Collector;
146 std::unique_ptr<raw_ostream> StreamOwner;
147 raw_ostream *OS = &llvm::errs();
150 auto FileOS = llvm::make_unique<llvm::raw_fd_ostream>(
152 llvm::sys::fs::F_Append | llvm::sys::fs::F_Text);
154 Diags.
Report(diag::warn_fe_cc_log_diagnostics_failure)
157 FileOS->SetUnbuffered();
159 StreamOwner = std::move(FileOS);
164 auto Logger = llvm::make_unique<LogDiagnosticPrinter>(*OS, DiagOpts,
165 std::move(StreamOwner));
175 StringRef OutputFile) {
176 auto SerializedConsumer =
181 Diags.
takeClient(), std::move(SerializedConsumer)));
184 Diags.
getClient(), std::move(SerializedConsumer)));
189 bool ShouldOwnClient) {
197 bool ShouldOwnClient,
206 Diags->setClient(Client, ShouldOwnClient);
211 if (Opts->VerifyDiagnostics)
256 Diags.
Report(diag::err_fe_remap_missing_from_file) << RB.first;
273 Diags.
Report(diag::err_fe_remap_missing_to_file) << RF.first << RF.second;
281 Diags.
Report(diag::err_fe_remap_missing_from_file) << RF.first;
320 PP->setPTHManager(PTHMgr);
324 PP->createPreprocessingRecord();
328 PP->getFileManager(), PPOpts);
336 PP->getLangOpts(), PP->getTargetInfo().getTriple());
340 if (PP->getLangOpts().Modules && PP->getLangOpts().ImplicitModules)
346 TheDependencyFileGenerator.reset(
352 for (
auto &Listener : DependencyCollectors)
353 Listener->attachToPreprocessor(*PP);
358 ModuleDepCollector = std::make_shared<ModuleDependencyCollector>(
366 if (OutputPath ==
"-")
385 llvm::sys::path::append(SpecificModuleCache,
387 return SpecificModuleCache.str();
404 StringRef Path,
bool DisablePCHValidation,
bool AllowPCHWithCompilerErrors,
405 void *DeserializationListener,
bool OwnDeserializationListener) {
412 DeserializationListener,
413 OwnDeserializationListener, Preamble,
418 StringRef Path, StringRef Sysroot,
bool DisablePCHValidation,
422 void *DeserializationListener,
bool OwnDeserializationListener,
423 bool Preamble,
bool UseGlobalModuleIndex) {
427 PP, Context, PCHContainerRdr, Extensions,
428 Sysroot.empty() ?
"" : Sysroot.data(), DisablePCHValidation,
429 AllowPCHWithCompilerErrors,
false,
436 Reader->setDeserializationListener(
437 static_cast<ASTDeserializationListener *>(DeserializationListener),
438 OwnDeserializationListener);
439 switch (Reader->ReadAST(Path,
489 if (!CompletionConsumer) {
495 if (!CompletionConsumer)
503 if (CompletionConsumer->isOutputBinary() &&
504 llvm::sys::ChangeStdoutToBinary()) {
511 FrontendTimerGroup.reset(
new llvm::TimerGroup(
"Clang front-end time report"));
513 new llvm::Timer(
"Clang front-end timer", *FrontendTimerGroup));
533 TUKind, CompletionConsumer));
539 assert(OutFile.OS &&
"Attempt to add empty stream to output list!");
540 OutputFiles.push_back(std::move(OutFile));
544 for (OutputFile &OF : OutputFiles) {
548 if (!OF.TempFilename.empty()) {
550 llvm::sys::fs::remove(OF.TempFilename);
556 FileMgr->FixupRelativePath(NewOutFile);
557 if (std::error_code ec =
558 llvm::sys::fs::rename(OF.TempFilename, NewOutFile)) {
560 << OF.TempFilename << OF.Filename << ec.message();
562 llvm::sys::fs::remove(OF.TempFilename);
565 }
else if (!OF.Filename.empty() && EraseFiles)
566 llvm::sys::fs::remove(OF.Filename);
570 NonSeekStream.reset();
575 StringRef Extension) {
577 true, InFile, Extension,
582 auto OS = llvm::make_unique<llvm::raw_null_ostream>();
583 llvm::raw_null_ostream *Ret = OS.get();
590 bool RemoveFileOnSignal, StringRef InFile,
591 StringRef Extension,
bool UseTemporary,
592 bool CreateMissingDirectories) {
593 std::string OutputPathName, TempPathName;
596 OutputPath, EC, Binary, RemoveFileOnSignal, InFile, Extension,
597 UseTemporary, CreateMissingDirectories, &OutputPathName, &TempPathName);
604 raw_pwrite_stream *Ret = OS.get();
607 addOutputFile(OutputFile((OutputPathName !=
"-") ? OutputPathName :
"",
608 TempPathName, std::move(OS)));
614 StringRef OutputPath, std::error_code &
Error,
bool Binary,
615 bool RemoveFileOnSignal, StringRef InFile, StringRef Extension,
616 bool UseTemporary,
bool CreateMissingDirectories,
617 std::string *ResultPathName, std::string *TempPathName) {
618 assert((!CreateMissingDirectories || UseTemporary) &&
619 "CreateMissingDirectories is only allowed when using temporary files");
621 std::string OutFile, TempFile;
622 if (!OutputPath.empty()) {
623 OutFile = OutputPath;
624 }
else if (InFile ==
"-") {
626 }
else if (!Extension.empty()) {
628 llvm::sys::path::replace_extension(Path, Extension);
629 OutFile = Path.str();
634 std::unique_ptr<llvm::raw_fd_ostream> OS;
639 UseTemporary =
false;
641 llvm::sys::fs::file_status Status;
642 llvm::sys::fs::status(OutputPath, Status);
643 if (llvm::sys::fs::exists(Status)) {
645 if (!llvm::sys::fs::can_write(OutputPath)) {
652 if (!llvm::sys::fs::is_regular_file(Status))
653 UseTemporary =
false;
662 TempPath +=
"-%%%%%%%%";
665 llvm::sys::fs::createUniqueFile(TempPath, fd, TempPath);
667 if (CreateMissingDirectories &&
668 EC == llvm::errc::no_such_file_or_directory) {
669 StringRef Parent = llvm::sys::path::parent_path(OutputPath);
670 EC = llvm::sys::fs::create_directories(Parent);
672 EC = llvm::sys::fs::createUniqueFile(TempPath, fd, TempPath);
677 OS.reset(
new llvm::raw_fd_ostream(fd,
true));
678 OSFile = TempFile = TempPath.str();
687 OS.reset(
new llvm::raw_fd_ostream(
689 (Binary ? llvm::sys::fs::F_None : llvm::sys::fs::F_Text)));
695 if (RemoveFileOnSignal)
696 llvm::sys::RemoveFileOnSignal(OSFile);
699 *ResultPathName = OutFile;
701 *TempPathName = TempFile;
703 if (!Binary || OS->supportsSeeking())
704 return std::move(OS);
706 auto B = llvm::make_unique<llvm::buffer_ostream>(*OS);
707 assert(!NonSeekStream);
708 NonSeekStream = std::move(OS);
730 std::unique_ptr<llvm::MemoryBuffer>(Input.
getBuffer()), Kind));
732 "Couldn't establish MainFileID!");
736 StringRef InputFile = Input.
getFile();
739 if (InputFile !=
"-") {
742 Diags.
Report(diag::err_fe_error_reading) << InputFile;
755 File = FileMgr.
getVirtualFile(InputFile, (*MB)->getBufferSize(), 0);
758 Diags.
Report(diag::err_cannot_open_file) << InputFile
759 << MB.getError().message();
767 llvm::ErrorOr<std::unique_ptr<llvm::MemoryBuffer>> SBOrErr =
768 llvm::MemoryBuffer::getSTDIN();
769 if (std::error_code EC = SBOrErr.getError()) {
770 Diags.
Report(diag::err_fe_error_reading_stdin) << EC.message();
773 std::unique_ptr<llvm::MemoryBuffer> SB = std::move(SBOrErr.get());
776 SB->getBufferSize(), 0);
783 "Couldn't establish MainFileID!");
790 assert(
hasDiagnostics() &&
"Diagnostics engine is not initialized!");
792 assert(!
getFrontendOpts().ShowVersion &&
"Client must handle '-version'!");
796 raw_ostream &OS = llvm::errs();
824 <<
" based upon " << BACKEND_PACKAGE_STRING
825 <<
" default target " << llvm::sys::getDefaultTargetTriple() <<
"\n";
831 llvm::EnableStatistics();
855 OS << NumWarnings <<
" warning" << (NumWarnings == 1 ?
"" :
"s");
856 if (NumWarnings && NumErrors)
859 OS << NumErrors <<
" error" << (NumErrors == 1 ?
"" :
"s");
860 if (NumWarnings || NumErrors)
861 OS <<
" generated.\n";
890 StringRef ModuleFileName) {
902 Invocation->getLangOpts()->resetNonModularOptions();
909 std::remove_if(PPOpts.
Macros.begin(), PPOpts.
Macros.end(),
910 [&HSOpts](
const std::pair<std::string, bool> &def) {
911 StringRef MacroDef = def.first;
932 FrontendOpts.
OutputFile = ModuleFileName.str();
936 FrontendOpts.
Inputs.clear();
942 Invocation->getDiagnosticOpts().VerifyDiagnostics = 0;
944 Invocation->getModuleHash() &&
"Module hash mismatch!");
961 Instance.createSourceManager(Instance.getFileManager());
975 std::string InferredModuleMapContent;
979 FrontendOpts.
Inputs.emplace_back(ModuleMapFile->getName(), IK);
982 llvm::sys::path::append(FakeModuleMapFile,
"__inferred_module.map");
983 FrontendOpts.
Inputs.emplace_back(FakeModuleMapFile, IK);
985 llvm::raw_string_ostream OS(InferredModuleMapContent);
989 std::unique_ptr<llvm::MemoryBuffer> ModuleMapBuffer =
990 llvm::MemoryBuffer::getMemBuffer(InferredModuleMapContent);
991 ModuleMapFile = Instance.getFileManager().getVirtualFile(
992 FakeModuleMapFile, InferredModuleMapContent.size(), 0);
1002 diag::remark_module_build)
1003 << Module->
Name << ModuleFileName;
1007 const unsigned ThreadStackSize = 8 << 20;
1008 llvm::CrashRecoveryContext CRC;
1009 CRC.RunSafelyOnThread([&]() { Instance.ExecuteAction(CreateModuleAction); },
1013 diag::remark_module_build_done)
1020 Instance.clearOutputFiles(
true);
1028 return !Instance.getDiagnostics().hasErrorOccurred();
1034 StringRef ModuleFileName) {
1037 auto diagnoseBuildFailure = [&] {
1038 Diags.
Report(ModuleNameLoc, diag::err_module_not_built)
1044 StringRef Dir = llvm::sys::path::parent_path(ModuleFileName);
1045 llvm::sys::fs::create_directories(Dir);
1049 llvm::LockFileManager Locked(ModuleFileName);
1051 case llvm::LockFileManager::LFS_Error:
1052 Diags.
Report(ModuleNameLoc, diag::err_module_lock_failure)
1056 case llvm::LockFileManager::LFS_Owned:
1060 diagnoseBuildFailure();
1065 case llvm::LockFileManager::LFS_Shared:
1068 switch (Locked.waitForUnlock()) {
1069 case llvm::LockFileManager::Res_Success:
1072 case llvm::LockFileManager::Res_OwnerDied:
1074 case llvm::LockFileManager::Res_Timeout:
1075 Diags.
Report(ModuleNameLoc, diag::err_module_lock_timeout)
1078 Locked.unsafeRemoveLockFile();
1088 ModuleLoadCapabilities);
1091 Locked == llvm::LockFileManager::LFS_Shared) {
1097 diagnoseBuildFailure();
1101 diagnoseBuildFailure();
1122 for (
auto *MD = LatestLocalMD; MD; MD = MD->getPrevious()) {
1127 if (
auto *DMD = dyn_cast<DefMacroDirective>(MD))
1128 CmdLineDefinition = DMD->getMacroInfo();
1133 if (CurrentDefinition == CmdLineDefinition) {
1135 }
else if (!CurrentDefinition) {
1138 PP.
Diag(ImportLoc, diag::warn_module_config_macro_undef)
1140 auto LatestDef = LatestLocalMD->getDefinition();
1141 assert(LatestDef.isUndefined() &&
1142 "predefined macro went away with no #undef?");
1143 PP.
Diag(LatestDef.getUndefLocation(), diag::note_module_def_undef_here)
1146 }
else if (!CmdLineDefinition) {
1149 PP.
Diag(ImportLoc, diag::warn_module_config_macro_undef)
1151 PP.
Diag(CurrentDefinition->getDefinitionLoc(),
1152 diag::note_module_def_undef_here)
1154 }
else if (!CurrentDefinition->isIdenticalTo(*CmdLineDefinition, PP,
1157 PP.
Diag(ImportLoc, diag::warn_module_config_macro_undef)
1159 PP.
Diag(CurrentDefinition->getDefinitionLoc(),
1160 diag::note_module_def_undef_here)
1168 llvm::raw_fd_ostream Out(TimestampFile.str(), EC, llvm::sys::fs::F_None);
1174 struct stat StatBuf;
1177 assert(!TimestampFile.empty());
1178 llvm::sys::path::append(TimestampFile,
"modules.timestamp");
1181 if (::stat(TimestampFile.c_str(), &StatBuf)) {
1183 if (errno == ENOENT) {
1191 time_t TimeStampModTime = StatBuf.st_mtime;
1192 time_t CurrentTime = time(
nullptr);
1205 llvm::sys::path::native(HSOpts.
ModuleCachePath, ModuleCachePathNative);
1206 for (llvm::sys::fs::directory_iterator Dir(ModuleCachePathNative, EC), DirEnd;
1207 Dir != DirEnd && !EC; Dir.increment(EC)) {
1209 if (!llvm::sys::fs::is_directory(Dir->path()))
1213 for (llvm::sys::fs::directory_iterator File(Dir->path(), EC), FileEnd;
1214 File != FileEnd && !EC; File.increment(EC)) {
1216 StringRef Extension = llvm::sys::path::extension(File->path());
1217 if (Extension !=
".pcm" && Extension !=
".timestamp" &&
1218 llvm::sys::path::filename(File->path()) !=
"modules.idx")
1223 if (::stat(File->path().c_str(), &StatBuf))
1227 time_t FileAccessTime = StatBuf.st_atime;
1228 if (CurrentTime - FileAccessTime <=
1234 llvm::sys::fs::remove(File->path());
1237 std::string TimpestampFilename = File->path() +
".timestamp";
1238 llvm::sys::fs::remove(TimpestampFilename);
1243 if (llvm::sys::fs::directory_iterator(Dir->path(), EC) ==
1244 llvm::sys::fs::directory_iterator() && !EC)
1245 llvm::sys::fs::remove(Dir->path());
1250 if (!ModuleManager) {
1257 !
getPreprocessor().getHeaderSearchInfo().getModuleCachePath().empty() &&
1264 std::string Sysroot = HSOpts.
Sysroot;
1266 std::unique_ptr<llvm::Timer> ReadTimer;
1267 if (FrontendTimerGroup)
1268 ReadTimer = llvm::make_unique<llvm::Timer>(
"Reading modules",
1269 *FrontendTimerGroup);
1278 std::move(ReadTimer));
1287 ModuleManager->InitializeSema(
getSema());
1291 if (TheDependencyFileGenerator)
1292 TheDependencyFileGenerator->AttachToASTReader(*ModuleManager);
1293 if (ModuleDepCollector)
1294 ModuleDepCollector->attachToASTReader(*ModuleManager);
1295 for (
auto &Listener : DependencyCollectors)
1296 Listener->attachToASTReader(*ModuleManager);
1302 if (FrontendTimerGroup)
1303 Timer.init(
"Preloading " + FileName.str(), *FrontendTimerGroup);
1304 llvm::TimeRegion TimeLoading(FrontendTimerGroup ? &Timer :
nullptr);
1315 void ReadModuleName(StringRef ModuleName)
override {
1316 LoadedModules.push_back(
1320 void registerAll() {
1321 for (
auto *II : LoadedModules) {
1327 LoadedModules.clear();
1330 void markAllUnavailable() {
1331 for (
auto *II : LoadedModules) {
1338 LoadedModules.clear();
1346 auto Listener = llvm::make_unique<ReadModuleNames>(*this);
1347 auto &ListenerRef = *Listener;
1349 std::move(Listener));
1358 ListenerRef.registerAll();
1367 ListenerRef.markAllUnavailable();
1379 bool IsInclusionDirective) {
1381 StringRef ModuleName = Path[0].first->getName();
1387 if (ImportLoc.
isValid() && LastModuleImportLoc == ImportLoc) {
1391 ModuleManager->makeModuleVisible(LastModuleImportResult, Visibility,
1393 return LastModuleImportResult;
1400 = KnownModules.find(Path[0].first);
1401 if (Known != KnownModules.end()) {
1403 Module = Known->second;
1407 Module = PP->getHeaderSearchInfo().lookupModule(ModuleName);
1408 Known = KnownModules.insert(std::make_pair(Path[0].first, Module)).first;
1411 Module = PP->getHeaderSearchInfo().lookupModule(ModuleName);
1416 ModuleBuildFailed =
true;
1420 std::string ModuleFileName =
1421 PP->getHeaderSearchInfo().getModuleFileName(Module);
1422 if (ModuleFileName.empty()) {
1431 ModuleBuildFailed =
true;
1440 if (FrontendTimerGroup)
1441 Timer.init(
"Loading " + ModuleFileName, *FrontendTimerGroup);
1442 llvm::TimeRegion TimeLoading(FrontendTimerGroup ? &Timer :
nullptr);
1446 switch (ModuleManager->ReadAST(ModuleFileName,
1448 ImportLoc, ARRFlags)) {
1455 assert(Module &&
"missing module file");
1459 for (; Pos != PosEnd; ++Pos) {
1460 if (Pos->first == ModuleName)
1464 if (Pos != PosEnd) {
1466 for (; Pos != PosEnd; ++Pos) {
1467 CyclePath += Pos->first;
1468 CyclePath +=
" -> ";
1470 CyclePath += ModuleName;
1473 << ModuleName << CyclePath;
1484 ModuleBuildFailed =
true;
1492 "undiagnosed error in compileAndLoadModule");
1495 KnownModules[Path[0].first] =
nullptr;
1496 ModuleBuildFailed =
true;
1510 KnownModules[Path[0].first] =
nullptr;
1516 KnownModules[Path[0].first] =
nullptr;
1517 ModuleBuildFailed =
true;
1522 Known = KnownModules.insert(std::make_pair(Path[0].first, Module)).first;
1531 if (Path.size() > 1) {
1532 for (
unsigned I = 1, N = Path.size();
I != N; ++
I) {
1533 StringRef
Name = Path[
I].first->getName();
1544 unsigned ED = Name.edit_distance((*J)->Name,
1547 if (ED <= BestEditDistance) {
1548 if (ED < BestEditDistance) {
1550 BestEditDistance = ED;
1553 Best.push_back((*J)->Name);
1558 if (Best.size() == 1) {
1560 diag::err_no_submodule_suggest)
1584 if (ModuleName ==
getLangOpts().ImplementationOfModule)
1599 <<
SourceRange(Path.front().second, Path.back().second);
1611 diag::err_module_header_missing)
1616 << Requirement.second << Requirement.first
1617 <<
SourceRange(Path.front().second, Path.back().second);
1619 LastModuleImportLoc = ImportLoc;
1624 ModuleManager->makeModuleVisible(Module, Visibility, ImportLoc);
1629 for (
unsigned I = 0, N = TopModule->
ConfigMacros.size();
I != N; ++
I) {
1634 LastModuleImportLoc = ImportLoc;
1636 return LastModuleImportResult;
1647 ModuleManager->makeModuleVisible(Mod, Visibility, ImportLoc);
1652 if (
getPreprocessor().getHeaderSearchInfo().getModuleCachePath().empty())
1661 ModuleManager->loadGlobalIndex();
1666 llvm::sys::fs::create_directories(
1671 ModuleManager->resetForReload();
1672 ModuleManager->loadGlobalIndex();
1673 GlobalIndex = ModuleManager->getGlobalIndex();
1677 if (!HaveFullGlobalModuleIndex && GlobalIndex && !
buildingModule()) {
1679 bool RecreateIndex =
false;
1682 Module *TheModule =
I->second;
1686 Path.push_back(std::make_pair(
1688 std::reverse(Path.begin(), Path.end());
1691 RecreateIndex =
true;
1694 if (RecreateIndex) {
1698 ModuleManager->resetForReload();
1699 ModuleManager->loadGlobalIndex();
1700 GlobalIndex = ModuleManager->getGlobalIndex();
1702 HaveFullGlobalModuleIndex =
true;
std::string OutputFile
The output file, if any.
SourceManager & getSourceManager() const
void setExternalSource(IntrusiveRefCntPtr< ExternalASTSource > Source)
Attach an external AST source to the AST context.
static bool compileAndLoadModule(CompilerInstance &ImportingInstance, SourceLocation ImportLoc, SourceLocation ModuleNameLoc, Module *Module, StringRef ModuleFileName)
Defines the clang::ASTContext interface.
virtual bool isModelParsingAction() const
Is this action invoked on a model file?
LangOptions & getLangOpts()
ASTReadResult
The result of reading the control block of an AST file, which can fail for various reasons...
bool hasFileManager() const
ASTContext & getASTContext() const
std::string Name
The name of this module.
CompilerInvocation & getInvocation()
PreprocessorOptions & getPreprocessorOpts()
void createCodeCompletionConsumer()
Create a code completion consumer using the invocation; note that this will cause the source manager ...
std::vector< std::pair< std::string, bool > > Macros
std::string ModuleDependencyOutputDir
The directory to copy module dependencies to when collecting them.
DiagnosticConsumer * getClient()
module_iterator module_begin() const
std::string DwarfDebugFlags
The string to embed in the debug information for the compile unit, if non-empty.
SelectorTable & getSelectorTable()
std::string DOTOutputFile
The file to write GraphViz-formatted header dependencies to.
bool hasASTConsumer() const
VerifyDiagnosticConsumer - Create a diagnostic client which will use markers in the input source to c...
void createFrontendTimer()
Create the frontend timer and replace any existing one with it.
bool RemappedFilesKeepOriginalName
True if the SourceManager should report the original file name for contents of files that were remapp...
Implements support for file system lookup, file system caching, and directory search management...
void setCodeCompletionConsumer(CodeCompleteConsumer *Value)
setCodeCompletionConsumer - Replace the current code completion consumer; the compiler instance takes...
vfs::FileSystem & getVirtualFileSystem() const
Defines the clang::FileManager interface and associated types.
Module * findModule(StringRef Name) const
Retrieve a module with the given name.
void EndSourceFile()
Perform any per-file post processing, deallocate per-file objects, and run statistics and output file...
void createDiagnostics(DiagnosticConsumer *Client=nullptr, bool ShouldOwnClient=true)
Create the diagnostics engine using the invocation's diagnostic options and replace any existing one ...
submodule_iterator submodule_begin()
static void writeTimestampFile(StringRef TimestampFile)
Write a new timestamp file with the given path.
Module * getTopLevelModule()
Retrieve the top-level module for this (sub)module, which may be this module.
Defines the SourceManager interface.
IntrusiveRefCntPtr< FileSystem > getRealFileSystem()
Gets an vfs::FileSystem for the 'real' file system, as seen by the operating system.
IdentifierInfo * getIdentifierInfo(StringRef Name) const
Return information about the specified preprocessor identifier token.
void createSema(TranslationUnitKind TUKind, CodeCompleteConsumer *CompletionConsumer)
Create the Sema object to be used for parsing.
Abstract base class for actions which can be performed by the frontend.
DiagnosticOptions & getDiagnosticOpts()
std::string HeaderIncludeOutputFile
The file to write header include output to.
bool hasErrorOccurred() const
DiagnosticBuilder Report(SourceLocation Loc, unsigned DiagID)
Issue the message to the client.
bool InitializeSourceManager(const FrontendInputFile &Input)
InitializeSourceManager - Initialize the source manager to set InputFile as the main file...
void setAuxTarget(TargetInfo *Value)
Replace the current AuxTarget.
ChainedDiagnosticConsumer - Chain two diagnostic clients so that diagnostics go to the first client a...
PreprocessorOptions - This class is used for passing the various options used in preprocessor initial...
std::unique_ptr< DiagnosticConsumer > takeClient()
Return the current diagnostic client along with ownership of that client.
The client can handle an AST file that cannot load because it is out-of-date relative to its input fi...
void setModuleManager(IntrusiveRefCntPtr< ASTReader > Reader)
TargetInfo & getTarget() const
void setSourceManager(SourceManager *Value)
setSourceManager - Replace the current source manager.
std::string getModuleHash() const
Retrieve a module hash string that is suitable for uniquely identifying the conditions under which th...
const FileEntry * getASTFile() const
The serialized AST file for this module, if one was created.
SourceManager & getSourceManager() const
Return the current source manager.
Options for controlling the target.
static PTHManager * Create(StringRef file, DiagnosticsEngine &Diags)
Create - This method creates PTHManager objects.
Abstract interface, implemented by clients of the front-end, which formats and prints fully processed...
DependencyOutputOptions & getDependencyOutputOpts()
CharacteristicKind
Indicates whether a file or directory holds normal user code, system code, or system code which is im...
Builtin::Context & getBuiltinInfo()
void setPredefines(const char *P)
Set the predefines for this Preprocessor.
The client can handle an AST file that cannot load because it is missing.
virtual void adjust(const LangOptions &Opts)
Set forced language options.
std::string getFullModuleName() const
Retrieve the full name of this module, including the path from its top-level module.
One of these records is kept for each identifier that is lexed.
void setMainFileID(FileID FID)
Set the file ID for the main source file.
unsigned getNumWarnings() const
void setClient(DiagnosticConsumer *client, bool ShouldOwnClient=true)
Set the diagnostic client associated with this diagnostic object.
static void SetupSerializedDiagnostics(DiagnosticOptions *DiagOpts, DiagnosticsEngine &Diags, StringRef OutputFile)
class LLVM_ALIGNAS(8) DependentTemplateSpecializationType const IdentifierInfo * Name
Represents a template specialization type whose template cannot be resolved, e.g. ...
Holds long-lived AST nodes (such as types and decls) that can be referred to throughout the semantic ...
bool BeginSourceFile(CompilerInstance &CI, const FrontendInputFile &Input)
Prepare the action for processing the input file Input.
void createFileManager()
Create the file manager and replace any existing one with it.
void createSourceManager(FileManager &FileMgr)
Create the source manager and replace any existing one with it.
A source location that has been parsed on the command line.
llvm::SmallPtrSet< ModuleFile *, 4 > HitSet
A set of module files in which we found a result.
const MacroInfo * getMacroInfo(const IdentifierInfo *II) const
unsigned DetailedRecord
Whether we should maintain a detailed record of all macro definitions and expansions.
void setASTContext(ASTContext *Value)
setASTContext - Replace the current AST context.
CodeGenOptions & getCodeGenOpts()
bool buildingModule() const
Returns true if this instance is building a module.
The client can handle an AST file that cannot load because it's compiled configuration doesn't match ...
Keeps track of the various options that can be enabled, which controls the dialect of C or C++ that i...
ASTConsumer & getASTConsumer() const
unsigned BuildingImplicitModule
Whether we are performing an implicit module build.
Describes a module or submodule.
FileManager & getFileManager() const
void makeModuleVisible(Module *Mod, Module::NameVisibilityKind Visibility, SourceLocation ImportLoc) override
Make the given module visible.
bool SetCodeCompletionPoint(const FileEntry *File, unsigned Line, unsigned Column)
Specify the point at which code-completion will be performed.
unsigned ShowStats
Show frontend performance metrics and statistics.
void setBuildGlobalModuleIndex(bool Build)
Set the flag indicating whether we should (re)build the global module index.
bool isAvailable() const
Determine whether this module is available for use within the current translation unit...
FrontendOptions & getFrontendOpts()
IntrusiveRefCntPtr< vfs::FileSystem > getVirtualFileSystem() const
Visibility
Describes the different kinds of visibility that a declaration may have.
DiagnosticConsumer & getDiagnosticClient() const
PreprocessorOutputOptions & getPreprocessorOutputOpts()
Concrete class used by the front-end to report problems and issues.
HeaderSearch & getHeaderSearchInfo() const
IntrusiveRefCntPtr< FailedModulesSet > FailedModules
The set of modules that failed to build.
void AttachHeaderIncludeGen(Preprocessor &PP, const std::vector< std::string > &ExtraHeaders, bool ShowAllHeaders=false, StringRef OutputPath="", bool ShowDepth=true, bool MSStyle=false)
AttachHeaderIncludeGen - Create a header include list generator, and attach it to the given preproces...
module_iterator module_end() const
bool RetainRemappedFileBuffers
Whether the compiler instance should retain (i.e., not free) the buffers associated with remapped fil...
void setASTConsumer(std::unique_ptr< ASTConsumer > Value)
setASTConsumer - Replace the current AST consumer; the compiler instance takes ownership of Value...
unsigned IsFromModuleFile
Whether this module was loaded from a module file.
const FileEntry * getContainingModuleMapFile(const Module *Module) const
Retrieve the module map file containing the definition of the given module.
IntrusiveRefCntPtr< ASTReader > getModuleManager() const
submodule_iterator submodule_end()
void setFileManager(FileManager *Value)
Replace the current file manager and virtual file system.
HeaderSearchOptions & getHeaderSearchOpts()
This abstract interface provides operations for unwrapping containers for serialized ASTs (precompile...
static void checkConfigMacro(Preprocessor &PP, StringRef ConfigMacro, Module *Mod, SourceLocation ImportLoc)
Diagnose differences between the current definition of the given configuration macro and the definiti...
The AST file itself appears corrupted.
detail::InMemoryDirectory::const_iterator I
bool DisablePCHValidation
When true, disables most of the normal validation performed on precompiled headers.
Preprocessor & getPreprocessor() const
Return the current preprocessor.
DiagnosticBuilder Diag(SourceLocation Loc, unsigned DiagID) const
Forwarding function for diagnostics.
std::vector< Module * >::iterator submodule_iterator
void createPCHExternalASTSource(StringRef Path, bool DisablePCHValidation, bool AllowPCHWithCompilerErrors, void *DeserializationListener, bool OwnDeserializationListener)
Create an external AST source to read a PCH file and attach it to the AST context.
bool hasVirtualFileSystem() const
std::vector< std::pair< std::string, llvm::MemoryBuffer * > > RemappedFileBuffers
The set of file-to-buffer remappings, which take existing files on the system (the first part of each...
static ErrorCode writeIndex(FileManager &FileMgr, const PCHContainerReader &PCHContainerRdr, StringRef Path)
Write a global index into the given.
llvm::StringMap< Module * >::const_iterator module_iterator
unsigned IsSystem
Whether this is a "system" module (which assumes that all headers in it are system headers)...
const FileEntry * getFile(StringRef Filename, bool OpenFile=false, bool CacheFailure=true)
Lookup, cache, and verify the specified file (real or virtual).
static DependencyFileGenerator * CreateAndAttachToPreprocessor(Preprocessor &PP, const DependencyOutputOptions &Opts)
Sema - This implements semantic analysis and AST building for C.
void setPreprocessor(Preprocessor *Value)
Replace the current preprocessor.
Module * findSubmodule(StringRef Name) const
Find the submodule with the given name.
static void SetUpDiagnosticLog(DiagnosticOptions *DiagOpts, const CodeGenOptions *CodeGenOpts, DiagnosticsEngine &Diags)
std::string CurrentModule
The name of the current module.
FileID getFileID(SourceLocation SpellingLoc) const
Return the FileID for a SourceLocation.
void setVirtualFileSystem(IntrusiveRefCntPtr< vfs::FileSystem > FS)
Replace the current virtual file system.
Describes the result of attempting to load a module.
Exposes information about the current target.
A simple code-completion consumer that prints the results it receives in a simple format...
void setInvocation(CompilerInvocation *Value)
setInvocation - Replace the current invocation.
static InputKind getSourceInputKindFromOptions(const LangOptions &LangOpts)
Determine the appropriate source input kind based on language options.
ModuleBuildStack getModuleBuildStack() const
Retrieve the module build stack.
std::string getSpecificModuleCachePath()
RAII object to temporarily add an AST callback listener.
FileID createFileID(const FileEntry *SourceFile, SourceLocation IncludePos, SrcMgr::CharacteristicKind FileCharacter, int LoadedID=0, unsigned LoadedOffset=0)
Create a new FileID that represents the specified file being #included from the specified IncludePosi...
Defines version macros and version-related utility functions for Clang.
Defines the clang::Preprocessor interface.
bool hasDiagnostics() const
void createASTContext()
Create the AST context.
unsigned ShowHeaderIncludes
Show header inclusions (-H).
void setSema(Sema *S)
Replace the current Sema; the compiler instance takes ownership of S.
static TargetInfo * CreateTargetInfo(DiagnosticsEngine &Diags, const std::shared_ptr< TargetOptions > &Opts)
Construct a target for the given options.
DiagnosticsEngine & getDiagnostics() const
Get the current diagnostics engine.
static bool EnableCodeCompletion(Preprocessor &PP, const std::string &Filename, unsigned Line, unsigned Column)
void addOutputFile(OutputFile &&OutFile)
addOutputFile - Add an output file onto the list of tracked output files.
std::string AuxTriple
Auxiliary triple for CUDA compilation.
The client can't handle any AST loading failures.
StringRef getTopLevelModuleName() const
Retrieve the name of the top-level module.
The AST file was missing.
bool lookupMissingImports(StringRef Name, SourceLocation TriggerLoc) override
Check global module index for missing imports.
std::unique_ptr< Sema > takeSema()
const DirectoryEntry * Directory
The build directory of this module.
void overrideFileContents(const FileEntry *SourceFile, llvm::MemoryBuffer *Buffer, bool DoNotFree)
Override the contents of the given source file by providing an already-allocated buffer.
bool hasSourceManager() const
FileSystemOptions & getFileSystemOpts()
bool isNamedPipe() const
Check whether the file is a named pipe (and thus can't be opened by the native FileManager methods)...
The control block was read successfully.
void setPreprocessor(Preprocessor *pp)
void ApplyHeaderSearchOptions(HeaderSearch &HS, const HeaderSearchOptions &HSOpts, const LangOptions &Lang, const llvm::Triple &triple)
Apply the header search options to get given HeaderSearch object.
bool ExecuteAction(FrontendAction &Act)
ExecuteAction - Execute the provided action against the compiler's CompilerInvocation object...
File is a PCH file treated as the preamble.
void print(raw_ostream &OS, unsigned Indent=0) const
Print the module map for this module to the given stream.
CompilerInstance - Helper class for managing a single instance of the Clang compiler.
Encodes a location in the source.
const PCHContainerReader & getPCHContainerReader() const
Return the appropriate PCHContainerReader depending on the current CodeGenOptions.
bool Execute()
Set the source manager's main input file, and run the action.
const TemplateArgument * iterator
File is a PCH file treated as such.
ParsedSourceLocation CodeCompletionAt
If given, enable code completion at the provided location.
bool isValid() const
Return true if this is a valid SourceLocation object.
Options for controlling the compiler diagnostics engine.
static bool compileModuleImpl(CompilerInstance &ImportingInstance, SourceLocation ImportLoc, Module *Module, StringRef ModuleFileName)
Compile a module file for the given module, using the options provided by the importing compiler inst...
std::vector< FrontendInputFile > Inputs
The input files and their types.
virtual void finish()
Callback to inform the diagnostic client that processing of all source files has ended.
All of the names in this module are hidden.
File is an implicitly-loaded module.
IdentifierTable & getIdentifierTable()
Cached information about one file (either on disk or in the virtual file system). ...
void AttachDependencyGraphGen(Preprocessor &PP, StringRef OutputFile, StringRef SysRoot)
AttachDependencyGraphGen - Create a dependency graph generator, and attach it to the given preprocess...
std::string DiagnosticSerializationFile
The file to serialize diagnostics to (non-appending).
Diagnostic consumer that forwards diagnostics along to an existing, already-initialized diagnostic co...
void ProcessWarningOptions(DiagnosticsEngine &Diags, const DiagnosticOptions &Opts, bool ReportDiags=true)
ProcessWarningOptions - Initialize the diagnostic client and process the warning options specified on...
DependencyOutputOptions - Options for controlling the compiler dependency file generation.
std::vector< std::string > ExtraDeps
A list of filenames to be used as extra dependencies for every target.
const FileEntry * getVirtualFile(StringRef Filename, off_t Size, time_t ModificationTime)
Retrieve a file entry for a "virtual" file that acts as if there were a file with the given name on d...
std::shared_ptr< PCHContainerOperations > getPCHContainerOperations() const
void InitBuiltinTypes(const TargetInfo &Target, const TargetInfo *AuxTarget=nullptr)
Initialize built-in types.
void pushModuleBuildStack(StringRef moduleName, FullSourceLoc importLoc)
Push an entry to the module build stack.
FileID getMainFileID() const
Returns the FileID of the main source file.
unsigned GenerateGlobalModuleIndex
Whether we can generate the global module index if needed.
void createPreprocessor(TranslationUnitKind TUKind)
Create the preprocessor, using the invocation, file, and source managers, and replace any existing on...
void resetNonModularOptions()
Reset any options that are not considered when building a module.
A global index for a set of module files, providing information about the identifiers within those mo...
The AST file was writtten with a different language/target configuration.
DiagnosticsEngine & getDiagnostics() const
const char * getName() const
FileID getPredefinesFileID() const
Returns the FileID for the preprocessor predefines.
TargetInfo * getAuxTarget() const
std::string OutputFile
The file to write dependency output to.
Abstract interface for a consumer of code-completion information.
An opaque identifier used by SourceManager which refers to a source file (MemoryBuffer) along with it...
Options controlling the behavior of code completion.
void setDeserializationListener(ASTDeserializationListener *Listener, bool TakeOwnership=false)
Set the AST deserialization listener.
llvm::raw_null_ostream * createNullOutputFile()
PreprocessorOptions & getPreprocessorOpts()
static void InitializeFileRemapping(DiagnosticsEngine &Diags, SourceManager &SourceMgr, FileManager &FileMgr, const PreprocessorOptions &InitOpts)
Reads an AST files chain containing the contents of a translation unit.
File is an explicitly-loaded module.
FileManager & getFileManager() const
Return the current file manager to the caller.
bool loadModuleFile(StringRef FileName)
std::unique_ptr< DiagnosticConsumer > create(StringRef OutputFile, DiagnosticOptions *Diags, bool MergeChildRecords=false)
Returns a DiagnosticConsumer that serializes diagnostics to a bitcode file.
llvm::ErrorOr< std::unique_ptr< llvm::MemoryBuffer > > getBufferForFile(const FileEntry *Entry, bool isVolatile=false, bool ShouldCloseOpenFile=true)
Open the specified file as a MemoryBuffer, returning a new MemoryBuffer if successful, otherwise returning null.
unsigned UseGlobalModuleIndex
Whether we can use the global module index if available.
Used for handling and querying diagnostic IDs.
void setASTMutationListener(ASTMutationListener *Listener)
Attach an AST mutation listener to the AST context.
Helper class for holding the data necessary to invoke the compiler.
static void pruneModuleCache(const HeaderSearchOptions &HSOpts)
Prune the module cache of modules that haven't been accessed in a long time.
detail::InMemoryDirectory::const_iterator E
FrontendOptions - Options for controlling the behavior of the frontend.
Abstract interface for a module loader.
std::string ImplementationOfModule
The name of the module that the translation unit is an implementation of.
Defines the Diagnostic-related interfaces.
Encapsulates the data about a macro definition (e.g.
SourceLocation DefinitionLoc
The location of the module definition.
void clearOutputFiles(bool EraseFiles)
clearOutputFiles - Clear the output file list, destroying the contained output streams.
void BuryPointer(const void *Ptr)
const FileEntry * getModuleMapFileForUniquing(const Module *M) const
Get the module map file that (along with the module name) uniquely identifies this module...
Abstract interface for callback invocations by the ASTReader.
MacroDirective * getLocalMacroDirectiveHistory(const IdentifierInfo *II) const
Given an identifier, return the latest non-imported macro directive for that identifier.
void setOverridenFilesKeepOriginalName(bool value)
Set true if the SourceManager should report the original file name for contents of files that were ov...
std::pair< std::string, bool > Requirement
An individual requirement: a feature name and a flag indicating the required state of that feature...
CodeGenOptions - Track various options which control how the code is optimized and passed to the back...
bool hasASTContext() const
void setTarget(TargetInfo *Value)
Replace the current Target.
unsigned DisableFree
Disable memory freeing on exit.
virtual void Initialize(ASTContext &Context)
Initialize - This is called to initialize the consumer, providing the ASTContext. ...
raw_pwrite_stream * createDefaultOutputFile(bool Binary=true, StringRef BaseInput="", StringRef Extension="")
Create the default output file (from the invocation's options) and add it to the list of tracked outp...
~CompilerInstance() override
bool shouldBuildGlobalModuleIndex() const
Indicates whether we should (re)build the global module index.
std::shared_ptr< ModuleDependencyCollector > getModuleDepCollector() const
void InitializePreprocessor(Preprocessor &PP, const PreprocessorOptions &PPOpts, const PCHContainerReader &PCHContainerRdr, const FrontendOptions &FEOpts)
InitializePreprocessor - Initialize the preprocessor getting it and the environment ready to process ...
void setModuleBuildStack(ModuleBuildStack stack)
Set the module build stack.
TranslationUnitKind
Describes the kind of translation unit being processed.
static FixItHint CreateReplacement(CharSourceRange RemoveRange, StringRef Code)
Create a code modification hint that replaces the given source range with the given code string...
std::vector< std::pair< std::string, std::string > > RemappedFiles
The set of file remappings, which take existing files on the system (the first part of each pair) and...
unsigned HasIncompatibleModuleFile
Whether we tried and failed to load a module file for this module.
std::pair< unsigned, bool > PrecompiledPreambleBytes
If non-zero, the implicit PCH include is actually a precompiled preamble that covers this number of b...
Defines the clang::TargetInfo interface.
The AST file is out-of-date relative to its input files, and needs to be regenerated.
A SourceLocation and its associated SourceManager.
NameVisibilityKind
Describes the visibility of the various names within a particular module.
std::vector< std::string > ConfigMacros
The set of "configuration macros", which are macros that (intentionally) change how this module is bu...
bool hasPreprocessor() const
Defines the clang::FrontendAction interface and various convenience abstract classes (clang::ASTFront...
unsigned getNumErrors() const
The AST file was written by a different version of Clang.
#define CLANG_VERSION_STRING
A string that describes the Clang version number, e.g., "1.0".
ModuleLoadResult loadModule(SourceLocation ImportLoc, ModuleIdPath Path, Module::NameVisibilityKind Visibility, bool IsInclusionDirective) override
Attempt to load the given module.
void createModuleManager()
}
void setModuleDepCollector(std::shared_ptr< ModuleDependencyCollector > Collector)
GlobalModuleIndex * loadGlobalModuleIndex(SourceLocation TriggerLoc) override
Load, create, or return global module.
bool hadMacroDefinition() const
Returns true if this identifier was #defined to some value at any moment.
bool ownsClient() const
Determine whether this DiagnosticsEngine object own its client.
A trivial tuple used to represent a source range.
unsigned PrintShowIncludes
Print cl.exe style /showIncludes info.
Records the set of modules.
raw_pwrite_stream * createOutputFile(StringRef OutputPath, bool Binary, bool RemoveFileOnSignal, StringRef BaseInput, StringRef Extension, bool UseTemporary, bool CreateMissingDirectories=false)
Create a new output file and add it to the list of tracked output files, optionally deriving the outp...
This class handles loading and caching of source files into memory.
void setDiagnostics(DiagnosticsEngine *Value)
setDiagnostics - Replace the current diagnostics engine.
void noSignedCharForObjCBool()
std::string DiagnosticLogFile
The file to log diagnostic output to.
std::string TokenCache
If given, a PTH cache file to use for speeding up header parsing.
Engages in a tight little dance with the lexer to efficiently preprocess tokens.
bool lookupIdentifier(StringRef Name, HitSet &Hits)
Look for all of the module files with information about the given identifier, e.g., a global function, variable, or type with that name.