22 #include "clang/Config/config.h"
42 #include "llvm/ADT/STLExtras.h"
43 #include "llvm/ADT/ScopeExit.h"
44 #include "llvm/ADT/Statistic.h"
45 #include "llvm/Config/llvm-config.h"
46 #include "llvm/Support/BuryPointer.h"
47 #include "llvm/Support/CrashRecoveryContext.h"
48 #include "llvm/Support/Errc.h"
49 #include "llvm/Support/FileSystem.h"
50 #include "llvm/Support/LockFileManager.h"
51 #include "llvm/Support/MemoryBuffer.h"
52 #include "llvm/Support/Path.h"
53 #include "llvm/Support/Program.h"
54 #include "llvm/Support/Signals.h"
55 #include "llvm/Support/TimeProfiler.h"
56 #include "llvm/Support/Timer.h"
57 #include "llvm/Support/raw_ostream.h"
58 #include "llvm/TargetParser/Host.h"
63 using namespace clang;
65 CompilerInstance::CompilerInstance(
66 std::shared_ptr<PCHContainerOperations> PCHContainerOps,
70 ModuleCache(SharedModuleCache ? SharedModuleCache
72 ThePCHContainerOperations(
std::move(PCHContainerOps)) {}
75 assert(OutputFiles.empty() &&
"Still output files in flight?");
79 std::shared_ptr<CompilerInvocation>
Value) {
80 Invocation = std::move(
Value);
84 return (BuildGlobalModuleIndex ||
85 (TheASTReader && TheASTReader->isGlobalIndexUnavailable() &&
87 !DisableGeneratingGlobalModuleIndex;
95 OwnedVerboseOutputStream.reset();
96 VerboseOutputStream = &
Value;
100 OwnedVerboseOutputStream.swap(
Value);
101 VerboseOutputStream = OwnedVerboseOutputStream.get();
120 auto TO = std::make_shared<TargetOptions>();
175 PP = std::move(
Value);
181 if (Context && Consumer)
190 Consumer = std::move(
Value);
192 if (Context && Consumer)
197 CompletionConsumer.reset(
Value);
201 return std::move(TheSema);
208 assert(ModuleCache.get() == &Reader->getModuleManager().getModuleCache() &&
209 "Expected ASTReader to use the same PCM cache");
210 TheASTReader = std::move(Reader);
213 std::shared_ptr<ModuleDependencyCollector>
215 return ModuleDepCollector;
219 std::shared_ptr<ModuleDependencyCollector> Collector) {
220 ModuleDepCollector = std::move(Collector);
224 std::shared_ptr<ModuleDependencyCollector> MDC) {
227 for (
auto &Name : HeaderMapFileNames)
232 std::shared_ptr<ModuleDependencyCollector> MDC) {
241 MDC->addFile(PCHInclude);
247 llvm::sys::path::native(PCHDir->getName(), DirNative);
250 for (llvm::vfs::directory_iterator Dir = FS.dir_begin(DirNative, EC), DirEnd;
251 Dir != DirEnd && !EC; Dir.increment(EC)) {
260 MDC->addFile(Dir->path());
265 std::shared_ptr<ModuleDependencyCollector> MDC) {
272 llvm::ErrorOr<std::unique_ptr<llvm::MemoryBuffer>> Buffer =
273 llvm::MemoryBuffer::getFile(VFSFile);
276 llvm::vfs::collectVFSFromYAML(std::move(Buffer.get()),
277 nullptr, VFSFile, VFSEntries);
280 for (
auto &E : VFSEntries)
281 MDC->addFile(E.VPath, E.RPath);
289 std::unique_ptr<raw_ostream> StreamOwner;
290 raw_ostream *OS = &llvm::errs();
293 auto FileOS = std::make_unique<llvm::raw_fd_ostream>(
295 llvm::sys::fs::OF_Append | llvm::sys::fs::OF_TextWithCRLF);
297 Diags.
Report(diag::warn_fe_cc_log_diagnostics_failure)
300 FileOS->SetUnbuffered();
302 StreamOwner = std::move(FileOS);
307 auto Logger = std::make_unique<LogDiagnosticPrinter>(*OS, DiagOpts,
308 std::move(StreamOwner));
322 StringRef OutputFile) {
323 auto SerializedConsumer =
328 Diags.
takeClient(), std::move(SerializedConsumer)));
331 Diags.
getClient(), std::move(SerializedConsumer)));
336 bool ShouldOwnClient) {
344 bool ShouldOwnClient,
353 Diags->setClient(Client, ShouldOwnClient);
360 if (Opts->VerifyDiagnostics)
382 VFS = FileMgr ? &FileMgr->getVirtualFileSystem()
385 assert(VFS &&
"FileManager has no VFS?");
387 return FileMgr.get();
416 FromFile, std::unique_ptr<llvm::MemoryBuffer>(RB.second));
424 Diags.
Report(diag::err_fe_remap_missing_to_file) << RF.first << RF.second;
432 Diags.
Report(diag::err_fe_remap_missing_from_file) << RF.first;
451 TheASTReader.reset();
457 PP = std::make_shared<Preprocessor>(Invocation->getPreprocessorOptsPtr(),
466 PP->createPreprocessingRecord();
470 PP->getFileManager(), PPOpts);
479 const llvm::Triple *HeaderSearchTriple = &PP->getTargetInfo().getTriple();
480 if (PP->getTargetInfo().getTriple().getOS() == llvm::Triple::CUDA &&
481 PP->getAuxTargetInfo())
482 HeaderSearchTriple = &PP->getAuxTargetInfo()->getTriple();
485 PP->getLangOpts(), *HeaderSearchTriple);
489 if (PP->getLangOpts().Modules && PP->getLangOpts().ImplicitModules) {
491 PP->getHeaderSearchInfo().setModuleHash(ModuleHash);
492 PP->getHeaderSearchInfo().setModuleCachePath(
507 ModuleDepCollector = std::make_shared<ModuleDependencyCollector>(
513 if (ModuleDepCollector) {
520 for (
auto &Listener : DependencyCollectors)
521 Listener->attachToPreprocessor(*PP);
528 if (OutputPath ==
"-")
546 llvm::sys::path::append(SpecificModuleCache, ModuleHash);
547 return std::string(SpecificModuleCache);
573 void ReadModuleName(StringRef ModuleName)
override {
576 LoadedModules.push_back(ModuleName.str());
581 for (
const std::string &LoadedModule : LoadedModules)
584 LoadedModules.clear();
587 void markAllUnavailable() {
588 for (
const std::string &LoadedModule : LoadedModules) {
591 M->HasIncompatibleModuleFile =
true;
597 while (!Stack.empty()) {
598 Module *Current = Stack.pop_back_val();
599 if (Current->IsUnimportable)
continue;
600 Current->IsAvailable =
true;
601 auto SubmodulesRange = Current->submodules();
602 Stack.insert(Stack.end(), SubmodulesRange.begin(),
603 SubmodulesRange.end());
607 LoadedModules.clear();
614 bool AllowPCHWithCompilerErrors,
void *DeserializationListener,
615 bool OwnDeserializationListener) {
622 DeserializationListener, OwnDeserializationListener,
Preamble,
627 StringRef Path, StringRef Sysroot,
632 ArrayRef<std::shared_ptr<ModuleFileExtension>> Extensions,
633 ArrayRef<std::shared_ptr<DependencyCollector>> DependencyCollectors,
634 void *DeserializationListener,
bool OwnDeserializationListener,
635 bool Preamble,
bool UseGlobalModuleIndex) {
639 PP, ModuleCache, &Context, PCHContainerRdr, Extensions,
640 Sysroot.empty() ?
"" : Sysroot.data(), DisableValidation,
641 AllowPCHWithCompilerErrors,
false,
643 UseGlobalModuleIndex));
649 Reader->setDeserializationListener(
651 OwnDeserializationListener);
653 for (
auto &Listener : DependencyCollectors)
654 Listener->attachToASTReader(*Reader);
656 auto Listener = std::make_unique<ReadModuleNames>(PP);
657 auto &ListenerRef = *Listener;
659 std::move(Listener));
661 switch (Reader->ReadAST(Path,
670 ListenerRef.registerAll();
686 ListenerRef.markAllUnavailable();
713 if (!CompletionConsumer) {
726 FrontendTimerGroup.reset(
727 new llvm::TimerGroup(
"frontend",
"Clang front-end time report"));
729 new llvm::Timer(
"frontend",
"Clang front-end timer",
730 *FrontendTimerGroup));
750 TUKind, CompletionConsumer));
756 if (ExternalSemaSrc) {
757 TheSema->addExternalSource(ExternalSemaSrc.get());
758 ExternalSemaSrc->InitializeSema(*TheSema);
764 (void)TheSema->APINotes.loadCurrentModuleAPINotes(
776 for (OutputFile &OF : OutputFiles) {
779 consumeError(OF.File->discard());
780 if (!OF.Filename.empty())
788 if (OF.File->TmpName.empty()) {
789 consumeError(OF.File->discard());
793 llvm::Error E = OF.File->keep(OF.Filename);
798 << OF.File->TmpName << OF.Filename << std::move(E);
803 if (DeleteBuiltModules) {
804 for (
auto &
Module : BuiltModules)
806 BuiltModules.clear();
811 bool Binary, StringRef InFile, StringRef Extension,
bool RemoveFileOnSignal,
812 bool CreateMissingDirectories,
bool ForceUseTemporary) {
814 std::optional<SmallString<128>> PathStorage;
815 if (OutputPath.empty()) {
816 if (InFile ==
"-" || Extension.empty()) {
819 PathStorage.emplace(InFile);
820 llvm::sys::path::replace_extension(*PathStorage, Extension);
821 OutputPath = *PathStorage;
827 CreateMissingDirectories);
831 return std::make_unique<llvm::raw_null_ostream>();
834 std::unique_ptr<raw_pwrite_stream>
836 bool RemoveFileOnSignal,
bool UseTemporary,
837 bool CreateMissingDirectories) {
839 createOutputFileImpl(OutputPath, Binary, RemoveFileOnSignal, UseTemporary,
840 CreateMissingDirectories);
842 return std::move(*OS);
844 << OutputPath << errorToErrorCode(OS.takeError()).message();
849 CompilerInstance::createOutputFileImpl(StringRef OutputPath,
bool Binary,
850 bool RemoveFileOnSignal,
852 bool CreateMissingDirectories) {
853 assert((!CreateMissingDirectories || UseTemporary) &&
854 "CreateMissingDirectories is only allowed when using temporary files");
858 std::optional<SmallString<128>> AbsPath;
859 if (OutputPath !=
"-" && !llvm::sys::path::is_absolute(OutputPath)) {
861 "File Manager is required to fix up relative path.\n");
863 AbsPath.emplace(OutputPath);
864 FileMgr->FixupRelativePath(*AbsPath);
865 OutputPath = *AbsPath;
868 std::unique_ptr<llvm::raw_fd_ostream> OS;
869 std::optional<StringRef> OSFile;
872 if (OutputPath ==
"-")
873 UseTemporary =
false;
875 llvm::sys::fs::file_status Status;
876 llvm::sys::fs::status(OutputPath, Status);
877 if (llvm::sys::fs::exists(Status)) {
879 if (!llvm::sys::fs::can_write(OutputPath))
880 return llvm::errorCodeToError(
885 if (!llvm::sys::fs::is_regular_file(Status))
886 UseTemporary =
false;
891 std::optional<llvm::sys::fs::TempFile> Temp;
897 StringRef OutputExtension = llvm::sys::path::extension(OutputPath);
899 StringRef(OutputPath).drop_back(OutputExtension.size());
900 TempPath +=
"-%%%%%%%%";
901 TempPath += OutputExtension;
903 llvm::sys::fs::OpenFlags BinaryFlags =
904 Binary ? llvm::sys::fs::OF_None : llvm::sys::fs::OF_Text;
907 TempPath, llvm::sys::fs::all_read | llvm::sys::fs::all_write,
910 llvm::Error E = handleErrors(
911 ExpectedFile.takeError(), [&](
const llvm::ECError &E) -> llvm::Error {
912 std::error_code EC = E.convertToErrorCode();
913 if (CreateMissingDirectories &&
914 EC == llvm::errc::no_such_file_or_directory) {
915 StringRef Parent = llvm::sys::path::parent_path(OutputPath);
916 EC = llvm::sys::fs::create_directories(Parent);
918 ExpectedFile = llvm::sys::fs::TempFile::create(
919 TempPath, llvm::sys::fs::all_read | llvm::sys::fs::all_write,
922 return llvm::errorCodeToError(
923 llvm::errc::no_such_file_or_directory);
926 return llvm::errorCodeToError(EC);
930 consumeError(std::move(E));
932 Temp = std::move(ExpectedFile.get());
933 OS.reset(
new llvm::raw_fd_ostream(Temp->FD,
false));
934 OSFile = Temp->TmpName;
944 OS.reset(
new llvm::raw_fd_ostream(
946 (Binary ? llvm::sys::fs::OF_None : llvm::sys::fs::OF_TextWithCRLF)));
948 return llvm::errorCodeToError(EC);
953 OutputFiles.emplace_back(((OutputPath !=
"-") ? OutputPath :
"").str(),
956 if (!Binary || OS->supportsSeeking())
957 return std::move(OS);
959 return std::make_unique<llvm::buffer_unique_ostream>(std::move(OS));
983 "Couldn't establish MainFileID!");
987 StringRef InputFile = Input.
getFile();
990 auto FileOrErr = InputFile ==
"-"
994 auto EC = llvm::errorToErrorCode(FileOrErr.takeError());
995 if (InputFile !=
"-")
996 Diags.
Report(diag::err_fe_error_reading) << InputFile << EC.message();
998 Diags.
Report(diag::err_fe_error_reading_stdin) << EC.message();
1006 "Couldn't establish MainFileID!");
1013 assert(
hasDiagnostics() &&
"Diagnostics engine is not initialized!");
1015 assert(!
getFrontendOpts().ShowVersion &&
"Client must handle '-version'!");
1022 auto FinishDiagnosticClient = llvm::make_scope_exit([&]() {
1041 OS <<
"clang -cc1 version " CLANG_VERSION_STRING <<
" based upon LLVM "
1042 << LLVM_VERSION_STRING <<
" default target "
1043 << llvm::sys::getDefaultTargetTriple() <<
"\n";
1049 llvm::EnableStatistics(
false);
1063 if (llvm::Error Err = Act.
Execute()) {
1064 consumeError(std::move(Err));
1077 llvm::PrintStatistics(OS);
1080 if (!StatsFile.empty()) {
1081 llvm::sys::fs::OpenFlags FileFlags = llvm::sys::fs::OF_TextWithCRLF;
1083 FileFlags |= llvm::sys::fs::OF_Append;
1086 std::make_unique<llvm::raw_fd_ostream>(StatsFile, EC, FileFlags);
1089 << StatsFile << EC.message();
1091 llvm::PrintStatisticsJSON(*StatS);
1110 OS << NumWarnings <<
" warning" << (NumWarnings == 1 ?
"" :
"s");
1111 if (NumWarnings && NumErrors)
1114 OS << NumErrors <<
" error" << (NumErrors == 1 ?
"" :
"s");
1115 if (NumWarnings || NumErrors) {
1119 OS <<
" when compiling for host";
1132 if (llvm::sys::DynamicLibrary::LoadLibraryPermanently(Path.c_str(), &Error))
1138 for (
const FrontendPluginRegistry::entry &Plugin :
1139 FrontendPluginRegistry::entries()) {
1140 std::unique_ptr<PluginASTAction>
P(Plugin.instantiate());
1152 if (LangOpts.OpenCL)
1167 StringRef OriginalModuleMapFile, StringRef ModuleFileName,
1172 llvm::TimeTraceScope TimeScope(
"Module Compile", ModuleName);
1178 ImportLoc, diag::err_module_rebuild_finalized)
1185 std::make_shared<CompilerInvocation>(ImportingInstance.
getInvocation());
1196 llvm::erase_if(PPOpts.
Macros,
1197 [&HSOpts](
const std::pair<std::string, bool> &def) {
1198 StringRef MacroDef = def.first;
1199 return HSOpts.ModulesIgnoreMacros.contains(
1200 llvm::CachedHashString(MacroDef.split(
'=').first));
1204 Invocation->getLangOpts().ModuleName =
1208 Invocation->getLangOpts().CurrentModule = std::string(ModuleName);
1214 FrontendOpts.
OutputFile = ModuleFileName.str();
1221 FrontendOpts.
Inputs = {Input};
1228 DiagOpts.VerifyDiagnostics = 0;
1230 Invocation->getModuleHash() &&
"Module hash mismatch!");
1238 auto &
Inv = *Invocation;
1239 Instance.setInvocation(std::move(Invocation));
1246 Instance.getDiagnostics().setSuppressSystemWarnings(
false);
1253 Instance.createSourceManager(Instance.getFileManager());
1277 diag::remark_module_build)
1278 << ModuleName << ModuleFileName;
1280 PreBuildStep(Instance);
1284 bool Crashed = !llvm::CrashRecoveryContext().RunSafelyOnThread(
1287 Instance.ExecuteAction(Action);
1291 PostBuildStep(Instance);
1294 diag::remark_module_build_done)
1304 Instance.setSema(
nullptr);
1305 Instance.setASTConsumer(
nullptr);
1308 Instance.clearOutputFiles(
true);
1313 return !Instance.getDiagnostics().hasErrorOccurred() ||
1314 Instance.getFrontendOpts().AllowPCMWithCompilerErrors;
1319 StringRef
Filename = llvm::sys::path::filename(
File.getName());
1321 if (
Filename ==
"module_private.map")
1322 llvm::sys::path::append(PublicFilename,
"module.map");
1323 else if (
Filename ==
"module.private.modulemap")
1324 llvm::sys::path::append(PublicFilename,
"module.modulemap");
1326 return std::nullopt;
1335 StringRef ModuleFileName) {
1358 assert(ModuleMapFile &&
"Top-level module map with no FileID");
1365 ModuleMapFile = PublicMMFile;
1380 llvm::sys::path::append(FakeModuleMapFile,
"__inferred_module.map");
1382 std::string InferredModuleMapContent;
1383 llvm::raw_string_ostream OS(InferredModuleMapContent);
1393 std::unique_ptr<llvm::MemoryBuffer> ModuleMapBuffer =
1394 llvm::MemoryBuffer::getMemBuffer(InferredModuleMapContent);
1395 FileEntryRef ModuleMapFile = Instance.getFileManager().getVirtualFileRef(
1396 FakeModuleMapFile, InferredModuleMapContent.size(), 0);
1397 Instance.getSourceManager().overrideFileContents(
1398 ModuleMapFile, std::move(ModuleMapBuffer));
1427 ModuleLoadCapabilities);
1439 Diags.
Report(ModuleNameLoc, diag::err_module_not_built)
1451 StringRef ModuleFileName) {
1455 diag::err_module_not_built)
1478 Diags.
Report(ModuleNameLoc, diag::remark_module_lock)
1483 StringRef Dir = llvm::sys::path::parent_path(ModuleFileName);
1484 llvm::sys::fs::create_directories(Dir);
1487 llvm::LockFileManager Locked(ModuleFileName);
1489 case llvm::LockFileManager::LFS_Error:
1493 Diags.
Report(ModuleNameLoc, diag::remark_module_lock_failure)
1496 Locked.unsafeRemoveLockFile();
1498 case llvm::LockFileManager::LFS_Owned:
1501 ModuleNameLoc,
Module, ModuleFileName);
1503 case llvm::LockFileManager::LFS_Shared:
1509 switch (Locked.waitForUnlock()) {
1510 case llvm::LockFileManager::Res_Success:
1512 case llvm::LockFileManager::Res_OwnerDied:
1514 case llvm::LockFileManager::Res_Timeout:
1518 Diags.
Report(ModuleNameLoc, diag::remark_module_lock_timeout)
1521 Locked.unsafeRemoveLockFile();
1526 bool OutOfDate =
false;
1528 Module, ModuleFileName, &OutOfDate))
1567 if (!
Id->hadMacroDefinition())
1573 for (
auto *MD = LatestLocalMD; MD; MD = MD->getPrevious()) {
1578 if (
auto *DMD = dyn_cast<DefMacroDirective>(MD))
1579 CmdLineDefinition = DMD->getMacroInfo();
1584 if (CurrentDefinition == CmdLineDefinition) {
1586 }
else if (!CurrentDefinition) {
1589 PP.
Diag(ImportLoc, diag::warn_module_config_macro_undef)
1591 auto LatestDef = LatestLocalMD->getDefinition();
1592 assert(LatestDef.isUndefined() &&
1593 "predefined macro went away with no #undef?");
1594 PP.
Diag(LatestDef.getUndefLocation(), diag::note_module_def_undef_here)
1597 }
else if (!CmdLineDefinition) {
1600 PP.
Diag(ImportLoc, diag::warn_module_config_macro_undef)
1602 PP.
Diag(CurrentDefinition->getDefinitionLoc(),
1603 diag::note_module_def_undef_here)
1605 }
else if (!CurrentDefinition->isIdenticalTo(*CmdLineDefinition, PP,
1608 PP.
Diag(ImportLoc, diag::warn_module_config_macro_undef)
1610 PP.
Diag(CurrentDefinition->getDefinitionLoc(),
1611 diag::note_module_def_undef_here)
1619 for (
const StringRef ConMacro : TopModule->
ConfigMacros) {
1627 llvm::raw_fd_ostream Out(TimestampFile.str(), EC, llvm::sys::fs::OF_None);
1633 llvm::sys::fs::file_status StatBuf;
1636 assert(!TimestampFile.empty());
1637 llvm::sys::path::append(TimestampFile,
"modules.timestamp");
1640 if (std::error_code EC = llvm::sys::fs::status(TimestampFile, StatBuf)) {
1642 if (EC == std::errc::no_such_file_or_directory) {
1650 time_t TimeStampModTime =
1651 llvm::sys::toTimeT(StatBuf.getLastModificationTime());
1652 time_t CurrentTime = time(
nullptr);
1665 llvm::sys::path::native(HSOpts.
ModuleCachePath, ModuleCachePathNative);
1666 for (llvm::sys::fs::directory_iterator Dir(ModuleCachePathNative, EC), DirEnd;
1667 Dir != DirEnd && !EC; Dir.increment(EC)) {
1669 if (!llvm::sys::fs::is_directory(Dir->path()))
1673 for (llvm::sys::fs::directory_iterator
File(Dir->path(), EC), FileEnd;
1674 File != FileEnd && !EC;
File.increment(EC)) {
1676 StringRef Extension = llvm::sys::path::extension(
File->path());
1677 if (Extension !=
".pcm" && Extension !=
".timestamp" &&
1678 llvm::sys::path::filename(
File->path()) !=
"modules.idx")
1683 if (llvm::sys::fs::status(
File->path(), StatBuf))
1687 time_t FileAccessTime = llvm::sys::toTimeT(StatBuf.getLastAccessedTime());
1688 if (CurrentTime - FileAccessTime <=
1697 std::string TimpestampFilename =
File->path() +
".timestamp";
1703 if (llvm::sys::fs::directory_iterator(Dir->path(), EC) ==
1704 llvm::sys::fs::directory_iterator() && !EC)
1719 !
getPreprocessor().getHeaderSearchInfo().getModuleCachePath().empty() &&
1726 std::string Sysroot = HSOpts.
Sysroot;
1729 std::unique_ptr<llvm::Timer> ReadTimer;
1731 if (FrontendTimerGroup)
1732 ReadTimer = std::make_unique<llvm::Timer>(
"reading_modules",
1734 *FrontendTimerGroup);
1738 Sysroot.empty() ?
"" : Sysroot.c_str(),
1745 TheASTReader->setDeserializationListener(
1752 TheASTReader->InitializeSema(
getSema());
1756 for (
auto &Listener : DependencyCollectors)
1757 Listener->attachToASTReader(*TheASTReader);
1763 if (FrontendTimerGroup)
1765 *FrontendTimerGroup);
1766 llvm::TimeRegion TimeLoading(FrontendTimerGroup ? &Timer :
nullptr);
1774 bool ConfigMismatchIsRecoverable =
1779 auto Listener = std::make_unique<ReadModuleNames>(*PP);
1780 auto &ListenerRef = *Listener;
1782 std::move(Listener));
1785 switch (TheASTReader->ReadAST(
1788 &LoadedModuleFile)) {
1792 ListenerRef.registerAll();
1801 ListenerRef.markAllUnavailable();
1813 MS_PrebuiltModulePath,
1814 MS_ModuleBuildPragma
1821 Module *M, StringRef ModuleName, std::string &ModuleFilename,
1822 const std::map<std::string, std::string, std::less<>> &BuiltModules,
1824 assert(ModuleFilename.empty() &&
"Already has a module source?");
1828 auto BuiltModuleIt = BuiltModules.find(ModuleName);
1829 if (BuiltModuleIt != BuiltModules.end()) {
1830 ModuleFilename = BuiltModuleIt->second;
1831 return MS_ModuleBuildPragma;
1841 if (!ModuleFilename.empty())
1842 return MS_PrebuiltModulePath;
1848 return MS_ModuleCache;
1851 return MS_ModuleNotFound;
1860 HS.
lookupModule(ModuleName, ImportLoc,
true, !IsInclusionDirective);
1870 std::string ModuleFilename;
1871 ModuleSource Source =
1873 if (Source == MS_ModuleNotFound) {
1876 << ModuleName <<
SourceRange(ImportLoc, ModuleNameLoc);
1879 if (ModuleFilename.empty()) {
1897 if (FrontendTimerGroup)
1898 Timer.init(
"loading." + ModuleFilename,
"Loading " + ModuleFilename,
1899 *FrontendTimerGroup);
1900 llvm::TimeRegion TimeLoading(FrontendTimerGroup ? &Timer :
nullptr);
1901 llvm::TimeTraceScope TimeScope(
"Module Load", ModuleName);
1905 unsigned ARRFlags = Source == MS_ModuleCache
1908 : Source == MS_PrebuiltModulePath
1912 Source == MS_PrebuiltModulePath
1914 : Source == MS_ModuleBuildPragma
1917 ImportLoc, ARRFlags)) {
1921 assert(Source != MS_ModuleCache &&
1922 "missing module, but file loaded from cache");
1926 M = HS.
lookupModule(ModuleName, ImportLoc,
true, !IsInclusionDirective);
1930 if (
auto ModuleFile = FileMgr->getFile(ModuleFilename))
1945 if (Source == MS_PrebuiltModulePath)
1949 diag::warn_module_config_mismatch)
1966 if (Source != MS_ModuleCache) {
1974 assert(M &&
"missing module, but trying to compile for cache");
1978 ModuleBuildStack::iterator Pos = ModPath.begin(), PosEnd = ModPath.end();
1979 for (; Pos != PosEnd; ++Pos) {
1980 if (Pos->first == ModuleName)
1984 if (Pos != PosEnd) {
1986 for (; Pos != PosEnd; ++Pos) {
1987 CyclePath += Pos->first;
1988 CyclePath +=
" -> ";
1990 CyclePath += ModuleName;
1993 << ModuleName << CyclePath;
1998 if (FailedModules && FailedModules->hasAlreadyFailed(ModuleName)) {
2000 << ModuleName <<
SourceRange(ImportLoc, ModuleNameLoc);
2008 "undiagnosed error in compileModuleAndReadAST");
2010 FailedModules->addFailed(ModuleName);
2022 bool IsInclusionDirective) {
2024 StringRef ModuleName = Path[0].first->getName();
2030 if (ImportLoc.
isValid() && LastModuleImportLoc == ImportLoc) {
2032 if (LastModuleImportResult && ModuleName !=
getLangOpts().CurrentModule)
2033 TheASTReader->makeModuleVisible(LastModuleImportResult,
Visibility,
2035 return LastModuleImportResult;
2049 }
else if (ModuleName ==
getLangOpts().CurrentModule) {
2052 ModuleName, ImportLoc,
true,
2053 !IsInclusionDirective);
2064 ModuleName, ImportLoc, ModuleNameLoc, IsInclusionDirective);
2065 if (!Result.isNormal())
2068 DisableGeneratingGlobalModuleIndex =
true;
2080 bool MapPrivateSubModToTopLevel =
false;
2081 for (
unsigned I = 1, N = Path.size(); I != N; ++I) {
2082 StringRef Name = Path[I].first->getName();
2091 PrivateModule.append(
"_Private");
2096 PrivPath.push_back(std::make_pair(&II, Path[0].second));
2101 !IsInclusionDirective) ||
2106 MapPrivateSubModToTopLevel =
true;
2109 diag::warn_no_priv_submodule_use_toplevel, ImportLoc)) {
2111 diag::warn_no_priv_submodule_use_toplevel)
2117 diag::note_private_top_level_defined);
2129 Name.edit_distance(SubModule->Name,
2130 true, BestEditDistance);
2131 if (ED <= BestEditDistance) {
2132 if (ED < BestEditDistance) {
2134 BestEditDistance = ED;
2137 Best.push_back(SubModule->Name);
2142 if (Best.size() == 1) {
2145 <<
SourceRange(Path[0].second, Path[I - 1].second)
2158 <<
SourceRange(Path[0].second, Path[I - 1].second);
2177 <<
SourceRange(Path.front().second, Path.back().second);
2186 <<
SourceRange(Path.front().second, Path.back().second);
2187 LastModuleImportLoc = ImportLoc;
2201 LastModuleImportLoc = ImportLoc;
2203 return LastModuleImportResult;
2207 StringRef ModuleName,
2211 for (
auto &C : CleanModuleName)
2219 if (std::error_code EC = llvm::sys::fs::createTemporaryFile(
2220 CleanModuleName,
"pcm", ModuleFileName)) {
2222 << ModuleFileName << EC.message();
2225 std::string ModuleMapFileName = (CleanModuleName +
".map").str();
2232 std::string NullTerminatedSource(Source.str());
2238 ModuleMapFileName, NullTerminatedSource.size(), 0);
2239 Other.getSourceManager().overrideFileContents(
2240 ModuleMapFile, llvm::MemoryBuffer::getMemBuffer(NullTerminatedSource));
2242 Other.BuiltModules = std::move(BuiltModules);
2243 Other.DeleteBuiltModules =
false;
2247 BuiltModules = std::move(
Other.BuiltModules);
2252 ModuleFileName, PreBuildStep, PostBuildStep)) {
2253 BuiltModules[std::string(ModuleName)] = std::string(ModuleFileName);
2254 llvm::sys::RemoveFileOnSignal(ModuleFileName);
2266 TheASTReader->makeModuleVisible(Mod,
Visibility, ImportLoc);
2271 if (
getPreprocessor().getHeaderSearchInfo().getModuleCachePath().empty())
2280 TheASTReader->loadGlobalIndex();
2285 llvm::sys::fs::create_directories(
2294 consumeError(std::move(Err));
2297 TheASTReader->resetForReload();
2298 TheASTReader->loadGlobalIndex();
2299 GlobalIndex = TheASTReader->getGlobalIndex();
2303 if (!HaveFullGlobalModuleIndex && GlobalIndex && !
buildingModule()) {
2305 bool RecreateIndex =
false;
2308 Module *TheModule = I->second;
2312 Path.push_back(std::make_pair(
2314 std::reverse(Path.begin(), Path.end());
2317 RecreateIndex =
true;
2320 if (RecreateIndex) {
2325 consumeError(std::move(Err));
2328 TheASTReader->resetForReload();
2329 TheASTReader->loadGlobalIndex();
2330 GlobalIndex = TheASTReader->getGlobalIndex();
2332 HaveFullGlobalModuleIndex =
true;
2366 ExternalSemaSrc = std::move(ESS);
Defines the clang::ASTContext interface.
Defines the Diagnostic-related interfaces.
static void collectVFSEntries(CompilerInstance &CI, std::shared_ptr< ModuleDependencyCollector > MDC)
static bool compileModuleImpl(CompilerInstance &ImportingInstance, SourceLocation ImportLoc, StringRef ModuleName, FrontendInputFile Input, StringRef OriginalModuleMapFile, StringRef ModuleFileName, llvm::function_ref< void(CompilerInstance &)> PreBuildStep=[](CompilerInstance &) {}, llvm::function_ref< void(CompilerInstance &)> PostBuildStep=[](CompilerInstance &) {})
Compile a module file for the given module, using the options provided by the importing compiler inst...
static bool EnableCodeCompletion(Preprocessor &PP, StringRef Filename, unsigned Line, unsigned Column)
static ModuleSource selectModuleSource(Module *M, StringRef ModuleName, std::string &ModuleFilename, const std::map< std::string, std::string, std::less<>> &BuiltModules, HeaderSearch &HS)
Select a source for loading the named module and compute the filename to load it from.
static void pruneModuleCache(const HeaderSearchOptions &HSOpts)
Prune the module cache of modules that haven't been accessed in a long time.
static bool compileModuleAndReadASTImpl(CompilerInstance &ImportingInstance, SourceLocation ImportLoc, SourceLocation ModuleNameLoc, Module *Module, StringRef ModuleFileName)
Compile a module in a separate compiler instance and read the AST, returning true if the module compi...
static bool compileModuleAndReadASTBehindLock(CompilerInstance &ImportingInstance, SourceLocation ImportLoc, SourceLocation ModuleNameLoc, Module *Module, StringRef ModuleFileName)
Compile a module in a separate compiler instance and read the AST, returning true if the module compi...
static bool readASTAfterCompileModule(CompilerInstance &ImportingInstance, SourceLocation ImportLoc, SourceLocation ModuleNameLoc, Module *Module, StringRef ModuleFileName, bool *OutOfDate)
Read the AST right after compiling the module.
static Language getLanguageFromOptions(const LangOptions &LangOpts)
Determine the appropriate source input kind based on language options.
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...
static void collectHeaderMaps(const HeaderSearch &HS, std::shared_ptr< ModuleDependencyCollector > MDC)
static void SetUpDiagnosticLog(DiagnosticOptions *DiagOpts, const CodeGenOptions *CodeGenOpts, DiagnosticsEngine &Diags)
static void writeTimestampFile(StringRef TimestampFile)
Write a new timestamp file with the given path.
static void InitializeFileRemapping(DiagnosticsEngine &Diags, SourceManager &SourceMgr, FileManager &FileMgr, const PreprocessorOptions &InitOpts)
static bool compileModule(CompilerInstance &ImportingInstance, SourceLocation ImportLoc, Module *Module, StringRef ModuleFileName)
Compile a module file for the given module in a separate compiler instance, using the options provide...
static void SetupSerializedDiagnostics(DiagnosticOptions *DiagOpts, DiagnosticsEngine &Diags, StringRef OutputFile)
static void collectIncludePCH(CompilerInstance &CI, std::shared_ptr< ModuleDependencyCollector > MDC)
static OptionalFileEntryRef getPublicModuleMap(FileEntryRef File, FileManager &FileMgr)
static void checkConfigMacros(Preprocessor &PP, Module *M, SourceLocation ImportLoc)
static bool compileModuleAndReadAST(CompilerInstance &ImportingInstance, SourceLocation ImportLoc, SourceLocation ModuleNameLoc, Module *Module, StringRef ModuleFileName)
Compile a module in a separate compiler instance and read the AST, returning true if the module compi...
Defines the clang::FileManager interface and associated types.
Defines the clang::FrontendAction interface and various convenience abstract classes (clang::ASTFront...
llvm::MachO::Target Target
Defines the clang::Preprocessor interface.
Defines the SourceManager interface.
Defines utilities for dealing with stack allocation and stack space.
Defines version macros and version-related utility functions for Clang.
__DEVICE__ int max(int __a, int __b)
std::vector< std::string > ModuleSearchPaths
The set of search paths where we API notes can be found for particular modules.
virtual void Initialize(ASTContext &Context)
Initialize - This is called to initialize the consumer, providing the ASTContext.
Holds long-lived AST nodes (such as types and decls) that can be referred to throughout the semantic ...
void setASTMutationListener(ASTMutationListener *Listener)
Attach an AST mutation listener to the AST context.
void setExternalSource(IntrusiveRefCntPtr< ExternalASTSource > Source)
Attach an external AST source to the AST context.
Abstract interface for callback invocations by the ASTReader.
RAII object to temporarily add an AST callback listener.
Reads an AST files chain containing the contents of a translation unit.
@ ARR_Missing
The client can handle an AST file that cannot load because it is missing.
@ ARR_None
The client can't handle any AST loading failures.
@ ARR_ConfigurationMismatch
The client can handle an AST file that cannot load because it's compiled configuration doesn't match ...
@ ARR_OutOfDate
The client can handle an AST file that cannot load because it is out-of-date relative to its input fi...
@ ARR_TreatModuleWithErrorsAsOutOfDate
If a module file is marked with errors treat it as out-of-date so the caller can rebuild it.
static bool readASTFileControlBlock(StringRef Filename, FileManager &FileMgr, const InMemoryModuleCache &ModuleCache, const PCHContainerReader &PCHContainerRdr, bool FindModuleFileExtensions, ASTReaderListener &Listener, bool ValidateDiagnosticOptions, unsigned ClientLoadCapabilities=ARR_ConfigurationMismatch|ARR_OutOfDate)
Read the control block for the named AST file.
ASTReadResult
The result of reading the control block of an AST file, which can fail for various reasons.
@ Success
The control block was read successfully.
@ ConfigurationMismatch
The AST file was written with a different language/target configuration.
@ OutOfDate
The AST file is out-of-date relative to its input files, and needs to be regenerated.
@ Failure
The AST file itself appears corrupted.
@ VersionMismatch
The AST file was written by a different version of Clang.
@ HadErrors
The AST file has errors.
@ Missing
The AST file was missing.
ChainedDiagnosticConsumer - Chain two diagnostic clients so that diagnostics go to the first client a...
Abstract interface for a consumer of code-completion information.
Options controlling the behavior of code completion.
CodeGenOptions - Track various options which control how the code is optimized and passed to the back...
std::string DwarfDebugFlags
The string to embed in the debug information for the compile unit, if non-empty.
CompilerInstance - Helper class for managing a single instance of the Clang compiler.
void setFileManager(FileManager *Value)
Replace the current file manager and virtual file system.
CodeGenOptions & getCodeGenOpts()
void setSourceManager(SourceManager *Value)
setSourceManager - Replace the current source manager.
void createPCHExternalASTSource(StringRef Path, DisableValidationForModuleKind DisableValidation, bool AllowPCHWithCompilerErrors, void *DeserializationListener, bool OwnDeserializationListener)
Create an external AST source to read a PCH file and attach it to the AST context.
~CompilerInstance() override
void createPreprocessor(TranslationUnitKind TUKind)
Create the preprocessor, using the invocation, file, and source managers, and replace any existing on...
bool lookupMissingImports(StringRef Name, SourceLocation TriggerLoc) override
Check global module index for missing imports.
void createSourceManager(FileManager &FileMgr)
Create the source manager and replace any existing one with it.
CompilerInvocation & getInvocation()
void createDiagnostics(DiagnosticConsumer *Client=nullptr, bool ShouldOwnClient=true)
Create the diagnostics engine using the invocation's diagnostic options and replace any existing one ...
FileManager * createFileManager(IntrusiveRefCntPtr< llvm::vfs::FileSystem > VFS=nullptr)
Create the file manager and replace any existing one with it.
Preprocessor & getPreprocessor() const
Return the current preprocessor.
std::shared_ptr< FailedModulesSet > getFailedModulesSetPtr() const
bool hasFileManager() const
TargetInfo & getTarget() const
GlobalModuleIndex * loadGlobalModuleIndex(SourceLocation TriggerLoc) override
Load, create, or return global module.
std::unique_ptr< raw_pwrite_stream > createDefaultOutputFile(bool Binary=true, StringRef BaseInput="", StringRef Extension="", bool RemoveFileOnSignal=true, bool CreateMissingDirectories=false, bool ForceUseTemporary=false)
Create the default output file (from the invocation's options) and add it to the list of tracked outp...
void setExternalSemaSource(IntrusiveRefCntPtr< ExternalSemaSource > ESS)
std::string getSpecificModuleCachePath()
ModuleLoadResult loadModule(SourceLocation ImportLoc, ModuleIdPath Path, Module::NameVisibilityKind Visibility, bool IsInclusionDirective) override
Attempt to load the given module.
FrontendOptions & getFrontendOpts()
void setInvocation(std::shared_ptr< CompilerInvocation > Value)
setInvocation - Replace the current invocation.
PreprocessorOptions & getPreprocessorOpts()
bool InitializeSourceManager(const FrontendInputFile &Input)
InitializeSourceManager - Initialize the source manager to set InputFile as the main file.
InMemoryModuleCache & getModuleCache() const
DependencyOutputOptions & getDependencyOutputOpts()
void setBuildGlobalModuleIndex(bool Build)
Set the flag indicating whether we should (re)build the global module index.
std::unique_ptr< Sema > takeSema()
void printDiagnosticStats()
At the end of a compilation, print the number of warnings/errors.
void setASTConsumer(std::unique_ptr< ASTConsumer > Value)
setASTConsumer - Replace the current AST consumer; the compiler instance takes ownership of Value.
IntrusiveRefCntPtr< ASTReader > getASTReader() const
FileSystemOptions & getFileSystemOpts()
ASTConsumer & getASTConsumer() const
void setTarget(TargetInfo *Value)
Replace the current Target.
void setModuleDepCollector(std::shared_ptr< ModuleDependencyCollector > Collector)
void addDependencyCollector(std::shared_ptr< DependencyCollector > Listener)
void createASTContext()
Create the AST context.
std::unique_ptr< raw_pwrite_stream > createOutputFile(StringRef OutputPath, bool Binary, bool RemoveFileOnSignal, bool UseTemporary, bool CreateMissingDirectories=false)
Create a new output file, optionally deriving the output path name, and add it to the list of tracked...
ASTContext & getASTContext() const
bool hasASTContext() const
void createModuleFromSource(SourceLocation ImportLoc, StringRef ModuleName, StringRef Source) override
Attempt to create the given module from the specified source buffer.
SourceManager & getSourceManager() const
Return the current source manager.
TargetInfo * getAuxTarget() const
void setASTContext(ASTContext *Value)
setASTContext - Replace the current AST context.
void LoadRequestedPlugins()
Load the list of plugins requested in the FrontendOptions.
void setASTReader(IntrusiveRefCntPtr< ASTReader > Reader)
std::shared_ptr< ModuleDependencyCollector > getModuleDepCollector() const
bool hasDiagnostics() const
void setSema(Sema *S)
Replace the current Sema; the compiler instance takes ownership of S.
FileManager & getFileManager() const
Return the current file manager to the caller.
APINotesOptions & getAPINotesOpts()
void createFrontendTimer()
Create the frontend timer and replace any existing one with it.
void setDiagnostics(DiagnosticsEngine *Value)
setDiagnostics - Replace the current diagnostics engine.
std::shared_ptr< PCHContainerOperations > getPCHContainerOperations() const
bool hasFailedModulesSet() const
TargetOptions & getTargetOpts()
void setVerboseOutputStream(raw_ostream &Value)
Replace the current stream for verbose output.
DiagnosticConsumer & getDiagnosticClient() const
HeaderSearchOptions & getHeaderSearchOpts()
raw_ostream & getVerboseOutputStream()
Get the current stream for verbose output.
std::shared_ptr< HeaderSearchOptions > getHeaderSearchOptsPtr() const
DiagnosticsEngine & getDiagnostics() const
Get the current diagnostics engine.
llvm::vfs::FileSystem & getVirtualFileSystem() const
void createCodeCompletionConsumer()
Create a code completion consumer using the invocation; note that this will cause the source manager ...
LangOptions & getLangOpts()
void setCodeCompletionConsumer(CodeCompleteConsumer *Value)
setCodeCompletionConsumer - Replace the current code completion consumer; the compiler instance takes...
bool ExecuteAction(FrontendAction &Act)
ExecuteAction - Execute the provided action against the compiler's CompilerInvocation object.
DiagnosticOptions & getDiagnosticOpts()
void clearOutputFiles(bool EraseFiles)
clearOutputFiles - Clear the output file list.
PreprocessorOutputOptions & getPreprocessorOutputOpts()
const PCHContainerReader & getPCHContainerReader() const
Return the appropriate PCHContainerReader depending on the current CodeGenOptions.
bool shouldBuildGlobalModuleIndex() const
Indicates whether we should (re)build the global module index.
bool hasSourceManager() const
bool hasASTConsumer() const
std::unique_ptr< raw_pwrite_stream > createNullOutputFile()
void setAuxTarget(TargetInfo *Value)
Replace the current AuxTarget.
void makeModuleVisible(Module *Mod, Module::NameVisibilityKind Visibility, SourceLocation ImportLoc) override
Make the given module visible.
void createFailedModulesSet()
bool loadModuleFile(StringRef FileName, serialization::ModuleFile *&LoadedModuleFile)
bool hasPreprocessor() const
void setPreprocessor(std::shared_ptr< Preprocessor > Value)
Replace the current preprocessor.
void createSema(TranslationUnitKind TUKind, CodeCompleteConsumer *CompletionConsumer)
Create the Sema object to be used for parsing.
Helper class for holding the data necessary to invoke the compiler.
std::string getModuleHash() const
Retrieve a module hash string that is suitable for uniquely identifying the conditions under which th...
LangOptions & getLangOpts()
Mutable getters.
FrontendOptions & getFrontendOpts()
DependencyOutputOptions - Options for controlling the compiler dependency file generation.
ShowIncludesDestination ShowIncludesDest
Destination of cl.exe style /showIncludes info.
std::string DOTOutputFile
The file to write GraphViz-formatted header dependencies to.
std::string ModuleDependencyOutputDir
The directory to copy module dependencies to when collecting them.
std::string OutputFile
The file to write dependency output to.
std::string HeaderIncludeOutputFile
The file to write header include output to.
unsigned ShowHeaderIncludes
Show header inclusions (-H).
Abstract interface, implemented by clients of the front-end, which formats and prints fully processed...
unsigned getNumErrors() const
virtual void finish()
Callback to inform the diagnostic client that processing of all source files has ended.
unsigned getNumWarnings() const
Used for handling and querying diagnostic IDs.
Options for controlling the compiler diagnostics engine.
std::string DiagnosticLogFile
The file to log diagnostic output to.
std::vector< std::string > SystemHeaderWarningsModules
The list of -Wsystem-header-in-module=...
std::string DiagnosticSerializationFile
The file to serialize diagnostics to (non-appending).
Concrete class used by the front-end to report problems and issues.
DiagnosticBuilder Report(SourceLocation Loc, unsigned DiagID)
Issue the message to the client.
bool hasErrorOccurred() const
void setClient(DiagnosticConsumer *client, bool ShouldOwnClient=true)
Set the diagnostic client associated with this diagnostic object.
Level getDiagnosticLevel(unsigned DiagID, SourceLocation Loc) const
Based on the way the client configured the DiagnosticsEngine object, classify the specified diagnosti...
bool ownsClient() const
Determine whether this DiagnosticsEngine object own its client.
std::unique_ptr< DiagnosticConsumer > takeClient()
Return the current diagnostic client along with ownership of that client.
DiagnosticConsumer * getClient()
StringRef getName() const
A reference to a FileEntry that includes the name of the file as it was accessed by the FileManager's...
StringRef getName() const
The name of this FileEntry.
StringRef getNameAsRequested() const
The name of this FileEntry, as originally requested without applying any remappings for VFS 'use-exte...
Cached information about one file (either on disk or in the virtual file system).
An opaque identifier used by SourceManager which refers to a source file (MemoryBuffer) along with it...
Implements support for file system lookup, file system caching, and directory search management.
void AddStats(const FileManager &Other)
Import statistics from a child FileManager and add them to this current FileManager.
OptionalFileEntryRef getOptionalFileRef(StringRef Filename, bool OpenFile=false, bool CacheFailure=true)
Get a FileEntryRef if it exists, without doing anything on error.
llvm::Expected< FileEntryRef > getSTDIN()
Get the FileEntryRef for stdin, returning an error if stdin cannot be read.
const FileEntry * getVirtualFile(StringRef Filename, off_t Size, time_t ModificationTime)
llvm::vfs::FileSystem & getVirtualFileSystem() const
FileEntryRef getVirtualFileRef(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...
OptionalDirectoryEntryRef getOptionalDirectoryRef(StringRef DirName, bool CacheFailure=true)
Get a DirectoryEntryRef if it exists, without doing anything on error.
llvm::Expected< FileEntryRef > getFileRef(StringRef Filename, bool OpenFile=false, bool CacheFailure=true)
Lookup, cache, and verify the specified file (real or virtual).
static FixItHint CreateReplacement(CharSourceRange RemoveRange, StringRef Code)
Create a code modification hint that replaces the given source range with the given code string.
Diagnostic consumer that forwards diagnostics along to an existing, already-initialized diagnostic co...
Abstract base class for actions which can be performed by the frontend.
virtual void EndSourceFile()
Perform any per-file post processing, deallocate per-file objects, and run statistics and output file...
bool PrepareToExecute(CompilerInstance &CI)
Prepare the action to execute on the given compiler instance.
llvm::Error Execute()
Set the source manager's main input file, and run the action.
bool BeginSourceFile(CompilerInstance &CI, const FrontendInputFile &Input)
Prepare the action for processing the input file Input.
virtual bool isModelParsingAction() const
Is this action invoked on a model file?
FrontendOptions - Options for controlling the behavior of the frontend.
unsigned BuildingImplicitModule
Whether we are performing an implicit module build.
unsigned AllowPCMWithCompilerErrors
Output (and read) PCM files regardless of compiler errors.
unsigned BuildingImplicitModuleUsesLock
Whether to use a filesystem lock when building implicit modules.
unsigned ModulesShareFileManager
Whether to share the FileManager when building modules.
std::optional< std::string > AuxTargetCPU
Auxiliary target CPU for CUDA/HIP compilation.
std::string StatsFile
Filename to write statistics to.
std::string OutputFile
The output file, if any.
std::string ActionName
The name of the action to run when using a plugin action.
ParsedSourceLocation CodeCompletionAt
If given, enable code completion at the provided location.
std::string OriginalModuleMap
When the input is a module map, the original module map file from which that map was inferred,...
unsigned GenerateGlobalModuleIndex
Whether we can generate the global module index if needed.
unsigned DisableFree
Disable memory freeing on exit.
SmallVector< FrontendInputFile, 0 > Inputs
The input files and their types.
frontend::ActionKind ProgramAction
The frontend action to perform.
std::optional< std::vector< std::string > > AuxTargetFeatures
Auxiliary target features for CUDA/HIP compilation.
A SourceLocation and its associated SourceManager.
A global index for a set of module files, providing information about the identifiers within those mo...
bool lookupIdentifier(llvm::StringRef Name, HitSet &Hits)
Look for all of the module files with information about the given identifier, e.g....
static llvm::Error writeIndex(FileManager &FileMgr, const PCHContainerReader &PCHContainerRdr, llvm::StringRef Path)
Write a global index into the given.
One of these records is kept for each identifier that is lexed.
tok::TokenKind getTokenID() const
If this is a source-language token (e.g.
IdentifierInfo & get(StringRef Name)
Return the identifier token info for the specified named identifier.
In-memory cache for modules.
bool isPCMFinal(llvm::StringRef Filename) const
Check whether the PCM is final and has been shown to work.
@ FPE_Default
Used internally to represent initial unspecified value.
@ FPE_Ignore
Assume that floating-point exceptions are masked.
Keeps track of the various options that can be enabled, which controls the dialect of C or C++ that i...
std::string ModuleName
The module currently being compiled as specified by -fmodule-name.
Encapsulates the data about a macro definition (e.g.
Describes the result of attempting to load a module.
Abstract interface for a module loader.
bool buildingModule() const
Returns true if this instance is building a module.
llvm::StringMap< Module * >::const_iterator module_iterator
Module * findModule(StringRef Name) const
Retrieve a module with the given name.
module_iterator module_begin() const
OptionalFileEntryRef getModuleMapFileForUniquing(const Module *M) const
std::optional< Module * > getCachedModuleLoad(const IdentifierInfo &II)
Return a cached module load.
module_iterator module_end() const
FileID getContainingModuleMapFileID(const Module *Module) const
Retrieve the module map file containing the definition of the given module.
void resolveLinkAsDependencies(Module *Mod)
Use PendingLinkAsModule information to mark top level link names that are going to be replaced by exp...
void cacheModuleLoad(const IdentifierInfo &II, Module *M)
Cache a module load. M might be nullptr.
Describes a module or submodule.
StringRef getTopLevelModuleName() const
Retrieve the name of the top-level module.
Module * findSubmodule(StringRef Name) const
Find the submodule with the given name.
std::vector< std::string > ConfigMacros
The set of "configuration macros", which are macros that (intentionally) change how this module is bu...
NameVisibilityKind
Describes the visibility of the various names within a particular module.
@ Hidden
All of the names in this module are hidden.
void print(raw_ostream &OS, unsigned Indent=0, bool Dump=false) const
Print the module map for this module to the given stream.
SourceLocation DefinitionLoc
The location of the module definition.
unsigned IsSystem
Whether this is a "system" module (which assumes that all headers in it are system headers).
std::string Name
The name of this module.
llvm::iterator_range< submodule_iterator > submodules()
OptionalDirectoryEntryRef Directory
The build directory of this module.
unsigned IsFromModuleFile
Whether this module was loaded from a module file.
Module * getTopLevelModule()
Retrieve the top-level module for this (sub)module, which may be this module.
unsigned HasIncompatibleModuleFile
Whether we tried and failed to load a module file for this module.
std::string getFullModuleName(bool AllowStringLiterals=false) const
Retrieve the full name of this module, including the path from its top-level module.
OptionalFileEntryRef getASTFile() const
The serialized AST file for this module, if one was created.
This abstract interface provides operations for unwrapping containers for serialized ASTs (precompile...
@ ReplaceAction
Replace the main action.
PreprocessorOptions - This class is used for passing the various options used in preprocessor initial...
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...
std::pair< unsigned, bool > PrecompiledPreambleBytes
If non-zero, the implicit PCH include is actually a precompiled preamble that covers this number of b...
bool RemappedFilesKeepOriginalName
True if the SourceManager should report the original file name for contents of files that were remapp...
void resetNonModularOptions()
Reset any options that are not considered when building a module.
bool RetainRemappedFileBuffers
Whether the compiler instance should retain (i.e., not free) the buffers associated with remapped fil...
bool DetailedRecord
Whether we should maintain a detailed record of all macro definitions and expansions.
std::string ImplicitPCHInclude
The implicit PCH included at the start of the translation unit, or empty.
DisableValidationForModuleKind DisablePCHOrModuleValidation
Whether to disable most of the normal validation performed on precompiled headers and module files.
std::vector< std::pair< std::string, bool > > Macros
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...
Engages in a tight little dance with the lexer to efficiently preprocess tokens.
void markClangModuleAsAffecting(Module *M)
Mark the given clang module as affecting the current clang module or translation unit.
SourceManager & getSourceManager() const
HeaderSearch & getHeaderSearchInfo() const
MacroDirective * getLocalMacroDirectiveHistory(const IdentifierInfo *II) const
Given an identifier, return the latest non-imported macro directive for that identifier.
bool SetCodeCompletionPoint(FileEntryRef File, unsigned Line, unsigned Column)
Specify the point at which code-completion will be performed.
const TranslationUnitKind TUKind
The kind of translation unit we are processing.
DiagnosticsEngine & getDiagnostics() const
IdentifierTable & getIdentifierTable()
static bool checkModuleIsAvailable(const LangOptions &LangOpts, const TargetInfo &TargetInfo, const Module &M, DiagnosticsEngine &Diags)
Check that the given module is available, producing a diagnostic if not.
FileManager & getFileManager() const
SelectorTable & getSelectorTable()
FileID getPredefinesFileID() const
Returns the FileID for the preprocessor predefines.
void setPredefines(std::string P)
Set the predefines for this Preprocessor.
Builtin::Context & getBuiltinInfo()
IdentifierInfo * getIdentifierInfo(StringRef Name) const
Return information about the specified preprocessor identifier token.
DiagnosticBuilder Diag(SourceLocation Loc, unsigned DiagID) const
Forwarding function for diagnostics.
const MacroInfo * getMacroInfo(const IdentifierInfo *II) const
A simple code-completion consumer that prints the results it receives in a simple format.
Sema - This implements semantic analysis and AST building for C.
ASTReaderListenter implementation to set SuggestedPredefines of ASTReader which is required to use a ...
Encodes a location in the source.
bool isValid() const
Return true if this is a valid SourceLocation object.
This class handles loading and caching of source files into memory.
FileID getFileID(SourceLocation SpellingLoc) const
Return the FileID for a SourceLocation.
OptionalFileEntryRef getFileEntryRefForID(FileID FID) const
Returns the FileEntryRef for the provided FileID.
void setModuleBuildStack(ModuleBuildStack stack)
Set the module build stack.
FileID createFileID(FileEntryRef SourceFile, SourceLocation IncludePos, SrcMgr::CharacteristicKind FileCharacter, int LoadedID=0, SourceLocation::UIntTy LoadedOffset=0)
Create a new FileID that represents the specified file being #included from the specified IncludePosi...
void setOverridenFilesKeepOriginalName(bool value)
Set true if the SourceManager should report the original file name for contents of files that were ov...
ModuleBuildStack getModuleBuildStack() const
Retrieve the module build stack.
FileID getMainFileID() const
Returns the FileID of the main source file.
void pushModuleBuildStack(StringRef moduleName, FullSourceLoc importLoc)
Push an entry to the module build stack.
void overrideFileContents(FileEntryRef SourceFile, const llvm::MemoryBufferRef &Buffer)
Override the contents of the given source file by providing an already-allocated buffer.
SourceLocation getIncludeLoc(FileID FID) const
Returns the include location if FID is a #include'd file otherwise it returns an invalid location.
void setMainFileID(FileID FID)
Set the file ID for the main source file.
SrcMgr::CharacteristicKind getFileCharacteristic(SourceLocation Loc) const
Return the file characteristic of the specified source location, indicating whether this is a normal ...
A trivial tuple used to represent a source range.
Exposes information about the current target.
static TargetInfo * CreateTargetInfo(DiagnosticsEngine &Diags, const std::shared_ptr< TargetOptions > &Opts)
Construct a target for the given options.
virtual void setAuxTarget(const TargetInfo *Aux)
void noSignedCharForObjCBool()
virtual void adjust(DiagnosticsEngine &Diags, LangOptions &Opts)
Set forced language options.
const llvm::Triple & getTriple() const
Returns the target triple of the primary target.
std::string CPU
If given, the name of the target CPU to generate code for.
VerifyDiagnosticConsumer - Create a diagnostic client which will use markers in the input source to c...
Information about a module that has been loaded by the ASTReader.
Defines the clang::TargetInfo interface.
CharacteristicKind
Indicates whether a file or directory holds normal user code, system code, or system code which is im...
bool isModuleMap(CharacteristicKind CK)
Determine whether a file characteristic is for a module map.
@ PluginAction
Run a plugin action,.
@ RewriteObjC
ObjC->C Rewriter.
bool Inv(InterpState &S, CodePtr OpPC)
@ MK_PCH
File is a PCH file treated as such.
@ MK_Preamble
File is a PCH file treated as the preamble.
@ MK_ExplicitModule
File is an explicitly-loaded module.
@ MK_ImplicitModule
File is an implicitly-loaded module.
@ MK_PrebuiltModule
File is from a prebuilt module path.
std::unique_ptr< DiagnosticConsumer > create(StringRef OutputFile, DiagnosticOptions *Diags, bool MergeChildRecords=false)
Returns a DiagnosticConsumer that serializes diagnostics to a bitcode file.
The JSON file list parser is used to communicate input to InstallAPI.
void ProcessWarningOptions(DiagnosticsEngine &Diags, const DiagnosticOptions &Opts, bool ReportDiags=true)
ProcessWarningOptions - Initialize the diagnostic client and process the warning options specified on...
void ApplyHeaderSearchOptions(HeaderSearch &HS, const HeaderSearchOptions &HSOpts, const LangOptions &Lang, const llvm::Triple &triple)
Apply the header search options to get given HeaderSearch object.
void noteBottomOfStack()
Call this once on each thread, as soon after starting the thread as feasible, to note the approximate...
void InitializePreprocessor(Preprocessor &PP, const PreprocessorOptions &PPOpts, const PCHContainerReader &PCHContainerRdr, const FrontendOptions &FEOpts, const CodeGenOptions &CodeGenOpts)
InitializePreprocessor - Initialize the preprocessor getting it and the environment ready to process ...
std::error_code make_error_code(BuildPreambleError Error)
LLVM_READONLY bool isAlphanumeric(unsigned char c)
Return true if this character is an ASCII letter or digit: [a-zA-Z0-9].
Language
The language for the input, used to select and validate the language standard and possible actions.
@ C
Languages that the frontend can parse and compile.
IntrusiveRefCntPtr< llvm::vfs::FileSystem > createVFSFromCompilerInvocation(const CompilerInvocation &CI, DiagnosticsEngine &Diags)
constexpr size_t DesiredStackSize
The amount of stack space that Clang would like to be provided with.
TranslationUnitKind
Describes the kind of translation unit being processed.
void AttachHeaderIncludeGen(Preprocessor &PP, const DependencyOutputOptions &DepOpts, 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...
DisableValidationForModuleKind
Whether to disable the normal validation performed on precompiled headers and module files when they ...
@ Other
Other implicit parameter.
Visibility
Describes the different kinds of visibility that a declaration may have.
void AttachDependencyGraphGen(Preprocessor &PP, StringRef OutputFile, StringRef SysRoot)
AttachDependencyGraphGen - Create a dependency graph generator, and attach it to the given preprocess...
float __ovld __cnfn normalize(float)
Returns a vector in the same direction as p but with a length of 1.
A source location that has been parsed on the command line.