clang 20.0.0git
Classes | Public Types | Public Member Functions | List of all members
clang::serialization::ModuleManager Class Reference

Manages the set of modules loaded by an AST reader. More...

#include "clang/Serialization/ModuleManager.h"

Public Types

enum  AddModuleResult { AlreadyLoaded , NewlyLoaded , Missing , OutOfDate }
 The result of attempting to add a new module. More...
 
using ModuleIterator = llvm::pointee_iterator< SmallVectorImpl< std::unique_ptr< ModuleFile > >::iterator >
 
using ModuleConstIterator = llvm::pointee_iterator< SmallVectorImpl< std::unique_ptr< ModuleFile > >::const_iterator >
 
using ModuleReverseIterator = llvm::pointee_iterator< SmallVectorImpl< std::unique_ptr< ModuleFile > >::reverse_iterator >
 
using ModuleOffset = std::pair< uint32_t, StringRef >
 
using ASTFileSignatureReader = ASTFileSignature(*)(StringRef)
 

Public Member Functions

 ModuleManager (FileManager &FileMgr, InMemoryModuleCache &ModuleCache, const PCHContainerReader &PCHContainerRdr, const HeaderSearch &HeaderSearchInfo)
 
ModuleIterator begin ()
 Forward iterator to traverse all loaded modules.
 
ModuleIterator end ()
 Forward iterator end-point to traverse all loaded modules.
 
ModuleConstIterator begin () const
 Const forward iterator to traverse all loaded modules.
 
ModuleConstIterator end () const
 Const forward iterator end-point to traverse all loaded modules.
 
ModuleReverseIterator rbegin ()
 Reverse iterator to traverse all loaded modules.
 
ModuleReverseIterator rend ()
 Reverse iterator end-point to traverse all loaded modules.
 
llvm::iterator_range< SmallVectorImpl< ModuleFile * >::const_iterator > pch_modules () const
 A range covering the PCH and preamble module files loaded.
 
ModuleFilegetPrimaryModule ()
 Returns the primary module associated with the manager, that is, the first module loaded.
 
ModuleFilegetPrimaryModule () const
 Returns the primary module associated with the manager, that is, the first module loaded.
 
ModuleFileoperator[] (unsigned Index) const
 Returns the module associated with the given index.
 
ModuleFilelookupByFileName (StringRef FileName) const
 Returns the module associated with the given file name.
 
ModuleFilelookupByModuleName (StringRef ModName) const
 Returns the module associated with the given module name.
 
ModuleFilelookup (const FileEntry *File) const
 Returns the module associated with the given module file.
 
std::unique_ptr< llvm::MemoryBuffer > lookupBuffer (StringRef Name)
 Returns the in-memory (virtual file) buffer with the given name.
 
unsigned size () const
 Number of modules loaded.
 
AddModuleResult addModule (StringRef FileName, ModuleKind Type, SourceLocation ImportLoc, ModuleFile *ImportedBy, unsigned Generation, off_t ExpectedSize, time_t ExpectedModTime, ASTFileSignature ExpectedSignature, ASTFileSignatureReader ReadSignature, ModuleFile *&Module, std::string &ErrorStr)
 Attempts to create a new module and add it to the list of known modules.
 
void removeModules (ModuleIterator First)
 Remove the modules starting from First (to the end).
 
void addInMemoryBuffer (StringRef FileName, std::unique_ptr< llvm::MemoryBuffer > Buffer)
 Add an in-memory buffer the list of known buffers.
 
void setGlobalIndex (GlobalModuleIndex *Index)
 Set the global module index.
 
void moduleFileAccepted (ModuleFile *MF)
 Notification from the AST reader that the given module file has been "accepted", and will not (can not) be unloaded.
 
void visit (llvm::function_ref< bool(ModuleFile &M)> Visitor, llvm::SmallPtrSetImpl< ModuleFile * > *ModuleFilesHit=nullptr)
 Visit each of the modules.
 
bool lookupModuleFile (StringRef FileName, off_t ExpectedSize, time_t ExpectedModTime, OptionalFileEntryRef &File)
 Attempt to resolve the given module file name to a file entry.
 
void viewGraph ()
 View the graphviz representation of the module graph.
 
InMemoryModuleCachegetModuleCache () const
 

Detailed Description

Manages the set of modules loaded by an AST reader.

Definition at line 46 of file ModuleManager.h.

Member Typedef Documentation

◆ ASTFileSignatureReader

Definition at line 205 of file ModuleManager.h.

◆ ModuleConstIterator

using clang::serialization::ModuleManager::ModuleConstIterator = llvm::pointee_iterator< SmallVectorImpl<std::unique_ptr<ModuleFile> >::const_iterator>

Definition at line 130 of file ModuleManager.h.

◆ ModuleIterator

using clang::serialization::ModuleManager::ModuleIterator = llvm::pointee_iterator< SmallVectorImpl<std::unique_ptr<ModuleFile> >::iterator>

Definition at line 128 of file ModuleManager.h.

◆ ModuleOffset

using clang::serialization::ModuleManager::ModuleOffset = std::pair<uint32_t, StringRef>

Definition at line 134 of file ModuleManager.h.

◆ ModuleReverseIterator

using clang::serialization::ModuleManager::ModuleReverseIterator = llvm::pointee_iterator< SmallVectorImpl<std::unique_ptr<ModuleFile> >::reverse_iterator>

Definition at line 132 of file ModuleManager.h.

Member Enumeration Documentation

◆ AddModuleResult

The result of attempting to add a new module.

Enumerator
AlreadyLoaded 

The module file had already been loaded.

NewlyLoaded 

The module file was just loaded in response to this call.

Missing 

The module file is missing.

OutOfDate 

The module file is out-of-date.

Definition at line 191 of file ModuleManager.h.

Constructor & Destructor Documentation

◆ ModuleManager()

ModuleManager::ModuleManager ( FileManager FileMgr,
InMemoryModuleCache ModuleCache,
const PCHContainerReader PCHContainerRdr,
const HeaderSearch HeaderSearchInfo 
)
explicit

Definition at line 326 of file ModuleManager.cpp.

Member Function Documentation

◆ addInMemoryBuffer()

void ModuleManager::addInMemoryBuffer ( StringRef  FileName,
std::unique_ptr< llvm::MemoryBuffer >  Buffer 
)

Add an in-memory buffer the list of known buffers.

Definition at line 280 of file ModuleManager.cpp.

References clang::FileName, and clang::FileManager::getVirtualFile().

Referenced by clang::ASTReader::addInMemoryBuffer().

◆ addModule()

ModuleManager::AddModuleResult ModuleManager::addModule ( StringRef  FileName,
ModuleKind  Type,
SourceLocation  ImportLoc,
ModuleFile ImportedBy,
unsigned  Generation,
off_t  ExpectedSize,
time_t  ExpectedModTime,
ASTFileSignature  ExpectedSignature,
ASTFileSignatureReader  ReadSignature,
ModuleFile *&  Module,
std::string &  ErrorStr 
)

Attempts to create a new module and add it to the list of known modules.

Parameters
FileNameThe file name of the module to be loaded.
TypeThe kind of module being loaded.
ImportLocThe location at which the module is imported.
ImportedByThe module that is importing this module, or NULL if this module is imported directly by the user.
GenerationThe generation in which this module was loaded.
ExpectedSizeThe expected size of the module file, used for validation. This will be zero if unknown.
ExpectedModTimeThe expected modification time of the module file, used for validation. This will be zero if unknown.
ExpectedSignatureThe expected signature of the module file, used for validation. This will be zero if unknown.
ReadSignatureReads the signature from an AST file without actually loading it.
ModuleA pointer to the module file if the module was successfully loaded.
ErrorStrWill be set to a non-empty string if any errors occurred while trying to load the module.
Returns
A pointer to the module that corresponds to this file name, and a value indicating whether the module was loaded.

Definition at line 99 of file ModuleManager.cpp.

References clang::InMemoryModuleCache::addPCM(), AlreadyLoaded, checkSignature(), clang::FileEntryRef::closeFile(), clang::PCHContainerReader::ExtractPCH(), clang::FileName, clang::FileManager::getBufferForFile(), getModuleCache(), clang::FileManager::getNoncachedStatValue(), lookupBuffer(), lookupModuleFile(), Missing, clang::serialization::MK_ExplicitModule, clang::serialization::MK_ImplicitModule, clang::serialization::MK_PrebuiltModule, NewlyLoaded, OutOfDate, and updateModuleImports().

◆ begin() [1/2]

ModuleIterator clang::serialization::ModuleManager::begin ( )
inline

Forward iterator to traverse all loaded modules.

Definition at line 141 of file ModuleManager.h.

Referenced by llvm::GraphTraits< ModuleManager >::nodes_begin(), and removeModules().

◆ begin() [2/2]

ModuleConstIterator clang::serialization::ModuleManager::begin ( ) const
inline

Const forward iterator to traverse all loaded modules.

Definition at line 147 of file ModuleManager.h.

◆ end() [1/2]

ModuleIterator clang::serialization::ModuleManager::end ( )
inline

Forward iterator end-point to traverse all loaded modules.

Definition at line 144 of file ModuleManager.h.

Referenced by llvm::GraphTraits< ModuleManager >::nodes_end(), and removeModules().

◆ end() [2/2]

ModuleConstIterator clang::serialization::ModuleManager::end ( ) const
inline

Const forward iterator end-point to traverse all loaded modules.

Definition at line 150 of file ModuleManager.h.

◆ getModuleCache()

InMemoryModuleCache & clang::serialization::ModuleManager::getModuleCache ( ) const
inline

Definition at line 309 of file ModuleManager.h.

Referenced by addModule().

◆ getPrimaryModule() [1/2]

ModuleFile & clang::serialization::ModuleManager::getPrimaryModule ( )
inline

Returns the primary module associated with the manager, that is, the first module loaded.

Definition at line 166 of file ModuleManager.h.

Referenced by clang::FrontendAction::BeginSourceFile(), clang::DumpModuleInfoAction::ExecuteAction(), clang::ASTReader::getOriginalSourceFile(), and clang::ASTReader::getSourceDescriptor().

◆ getPrimaryModule() [2/2]

ModuleFile & clang::serialization::ModuleManager::getPrimaryModule ( ) const
inline

Returns the primary module associated with the manager, that is, the first module loaded.

Definition at line 170 of file ModuleManager.h.

◆ lookup()

ModuleFile * ModuleManager::lookup ( const FileEntry File) const

Returns the module associated with the given module file.

Definition at line 61 of file ModuleManager.cpp.

References clang::File.

Referenced by lookupByFileName(), and lookupByModuleName().

◆ lookupBuffer()

std::unique_ptr< llvm::MemoryBuffer > ModuleManager::lookupBuffer ( StringRef  Name)

Returns the in-memory (virtual file) buffer with the given name.

Definition at line 66 of file ModuleManager.cpp.

References clang::FileManager::getFile().

Referenced by addModule().

◆ lookupByFileName()

ModuleFile * ModuleManager::lookupByFileName ( StringRef  FileName) const

Returns the module associated with the given file name.

Definition at line 44 of file ModuleManager.cpp.

References clang::FileManager::getFile(), and lookup().

◆ lookupByModuleName()

ModuleFile * ModuleManager::lookupByModuleName ( StringRef  ModName) const

Returns the module associated with the given module name.

Definition at line 53 of file ModuleManager.cpp.

References clang::File, clang::ModuleMap::findModule(), clang::HeaderSearch::getModuleMap(), and lookup().

◆ lookupModuleFile()

bool ModuleManager::lookupModuleFile ( StringRef  FileName,
off_t  ExpectedSize,
time_t  ExpectedModTime,
OptionalFileEntryRef File 
)

Attempt to resolve the given module file name to a file entry.

Parameters
FileNameThe name of the module file.
ExpectedSizeThe size that the module file is expected to have. If the actual size differs, the resolver should return true.
ExpectedModTimeThe modification time that the module file is expected to have. If the actual modification time differs, the resolver should return true.
FileWill be set to the file if there is one, or null otherwise.
Returns
True if a file exists but does not meet the size/ modification time criteria, false if the file is either available and suitable, or is missing.

Definition at line 434 of file ModuleManager.cpp.

References clang::File, clang::FileName, clang::FileManager::getOptionalFileRef(), and clang::FileManager::getSTDIN().

Referenced by addModule().

◆ moduleFileAccepted()

void ModuleManager::moduleFileAccepted ( ModuleFile MF)

Notification from the AST reader that the given module file has been "accepted", and will not (can not) be unloaded.

Definition at line 319 of file ModuleManager.cpp.

References clang::GlobalModuleIndex::loadedModuleFile().

◆ operator[]()

ModuleFile & clang::serialization::ModuleManager::operator[] ( unsigned  Index) const
inline

Returns the module associated with the given index.

Definition at line 173 of file ModuleManager.h.

◆ pch_modules()

llvm::iterator_range< SmallVectorImpl< ModuleFile * >::const_iterator > clang::serialization::ModuleManager::pch_modules ( ) const
inline

A range covering the PCH and preamble module files loaded.

Definition at line 160 of file ModuleManager.h.

Referenced by clang::ASTReader::getLocalModuleFile(), clang::ASTReader::getModuleFileID(), and clang::ASTReader::getSourceDescriptor().

◆ rbegin()

ModuleReverseIterator clang::serialization::ModuleManager::rbegin ( )
inline

Reverse iterator to traverse all loaded modules.

Definition at line 153 of file ModuleManager.h.

Referenced by getTopImportImplicitModule().

◆ removeModules()

void ModuleManager::removeModules ( ModuleIterator  First)

Remove the modules starting from First (to the end).

Definition at line 241 of file ModuleManager.cpp.

References begin(), end(), clang::First, and clang::Last.

◆ rend()

ModuleReverseIterator clang::serialization::ModuleManager::rend ( )
inline

Reverse iterator end-point to traverse all loaded modules.

Definition at line 156 of file ModuleManager.h.

◆ setGlobalIndex()

void ModuleManager::setGlobalIndex ( GlobalModuleIndex Index)

Set the global module index.

Definition at line 305 of file ModuleManager.cpp.

References clang::GlobalModuleIndex::loadedModuleFile().

◆ size()

unsigned clang::serialization::ModuleManager::size ( ) const
inline

Number of modules loaded.

Definition at line 188 of file ModuleManager.h.

Referenced by clang::PCHValidator::ReadDiagnosticOptions(), and visit().

◆ viewGraph()

void ModuleManager::viewGraph ( )

View the graphviz representation of the module graph.

Definition at line 497 of file ModuleManager.cpp.

◆ visit()

void ModuleManager::visit ( llvm::function_ref< bool(ModuleFile &M)>  Visitor,
llvm::SmallPtrSetImpl< ModuleFile * > *  ModuleFilesHit = nullptr 
)

Visit each of the modules.

This routine visits each of the modules, starting with the "root" modules that no other loaded modules depend on, and proceeding to the leaf modules, visiting each module only once during the traversal.

This traversal is intended to support various "lookup" operations that can find data in any of the loaded modules.

Parameters
VisitorA visitor function that will be invoked with each module. The return value must be convertible to bool; when false, the visitation continues to modules that the current module depends on. When true, the visitation skips any modules that the current module depends on.
ModuleFilesHitIf non-NULL, contains the set of module files that we know we need to visit because the global module index told us to. Any module that is known to both the global module index and the module manager that is not in this set can be skipped.

Definition at line 333 of file ModuleManager.cpp.

References clang::serialization::ModuleFile::ImportedBy, clang::serialization::ModuleFile::Imports, clang::serialization::ModuleFile::Index, and size().

Referenced by clang::ASTReader::ReadMethodPool().


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