clang
6.0.0
|
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, MemoryBufferCache &PCMCache, const PCHContainerReader &PCHContainerRdr, const HeaderSearch &HeaderSearchInfo) | |
~ModuleManager () | |
ModuleIterator | begin () |
Forward iterator to traverse all loaded modules. More... | |
ModuleIterator | end () |
Forward iterator end-point to traverse all loaded modules. More... | |
ModuleConstIterator | begin () const |
Const forward iterator to traverse all loaded modules. More... | |
ModuleConstIterator | end () const |
Const forward iterator end-point to traverse all loaded modules. More... | |
ModuleReverseIterator | rbegin () |
Reverse iterator to traverse all loaded modules. More... | |
ModuleReverseIterator | rend () |
Reverse iterator end-point to traverse all loaded modules. More... | |
llvm::iterator_range< SmallVectorImpl< ModuleFile * >::const_iterator > | pch_modules () const |
A range covering the PCH and preamble module files loaded. More... | |
ModuleFile & | getPrimaryModule () |
Returns the primary module associated with the manager, that is, the first module loaded. More... | |
ModuleFile & | getPrimaryModule () const |
Returns the primary module associated with the manager, that is, the first module loaded. More... | |
ModuleFile & | operator[] (unsigned Index) const |
Returns the module associated with the given index. More... | |
ModuleFile * | lookupByFileName (StringRef FileName) const |
Returns the module associated with the given file name. More... | |
ModuleFile * | lookupByModuleName (StringRef ModName) const |
Returns the module associated with the given module name. More... | |
ModuleFile * | lookup (const FileEntry *File) const |
Returns the module associated with the given module file. More... | |
std::unique_ptr< llvm::MemoryBuffer > | lookupBuffer (StringRef Name) |
Returns the in-memory (virtual file) buffer with the given name. More... | |
unsigned | size () const |
Number of modules loaded. More... | |
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. More... | |
void | removeModules (ModuleIterator First, llvm::SmallPtrSetImpl< ModuleFile *> &LoadedSuccessfully, ModuleMap *modMap) |
Remove the modules starting from First (to the end). More... | |
void | addInMemoryBuffer (StringRef FileName, std::unique_ptr< llvm::MemoryBuffer > Buffer) |
Add an in-memory buffer the list of known buffers. More... | |
void | setGlobalIndex (GlobalModuleIndex *Index) |
Set the global module index. More... | |
void | moduleFileAccepted (ModuleFile *MF) |
Notification from the AST reader that the given module file has been "accepted", and will not (can not) be unloaded. More... | |
void | visit (llvm::function_ref< bool(ModuleFile &M)> Visitor, llvm::SmallPtrSetImpl< ModuleFile *> *ModuleFilesHit=nullptr) |
Visit each of the modules. More... | |
bool | lookupModuleFile (StringRef FileName, off_t ExpectedSize, time_t ExpectedModTime, const FileEntry *&File) |
Attempt to resolve the given module file name to a file entry. More... | |
void | viewGraph () |
View the graphviz representation of the module graph. More... | |
MemoryBufferCache & | getPCMCache () const |
Manages the set of modules loaded by an AST reader.
Definition at line 49 of file ModuleManager.h.
using clang::serialization::ModuleManager::ASTFileSignatureReader = ASTFileSignature (*)(StringRef) |
Definition at line 213 of file ModuleManager.h.
using clang::serialization::ModuleManager::ModuleConstIterator = llvm::pointee_iterator< SmallVectorImpl<std::unique_ptr<ModuleFile> >::const_iterator> |
Definition at line 138 of file ModuleManager.h.
using clang::serialization::ModuleManager::ModuleIterator = llvm::pointee_iterator< SmallVectorImpl<std::unique_ptr<ModuleFile> >::iterator> |
Definition at line 136 of file ModuleManager.h.
using clang::serialization::ModuleManager::ModuleOffset = std::pair<uint32_t, StringRef> |
Definition at line 141 of file ModuleManager.h.
using clang::serialization::ModuleManager::ModuleReverseIterator = llvm::pointee_iterator< SmallVectorImpl<std::unique_ptr<ModuleFile> >::reverse_iterator> |
Definition at line 140 of file ModuleManager.h.
The result of attempting to add a new module.
Definition at line 199 of file ModuleManager.h.
|
explicit |
Definition at line 328 of file ModuleManager.cpp.
ModuleManager::~ModuleManager | ( | ) |
Definition at line 334 of file ModuleManager.cpp.
void ModuleManager::addInMemoryBuffer | ( | StringRef | FileName, |
std::unique_ptr< llvm::MemoryBuffer > | Buffer | ||
) |
Add an in-memory buffer the list of known buffers.
Definition at line 281 of file ModuleManager.cpp.
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.
FileName | The file name of the module to be loaded. |
Type | The kind of module being loaded. |
ImportLoc | The location at which the module is imported. |
ImportedBy | The module that is importing this module, or NULL if this module is imported directly by the user. |
Generation | The generation in which this module was loaded. |
ExpectedSize | The expected size of the module file, used for validation. This will be zero if unknown. |
ExpectedModTime | The expected modification time of the module file, used for validation. This will be zero if unknown. |
ExpectedSignature | The expected signature of the module file, used for validation. This will be zero if unknown. |
ReadSignature | Reads the signature from an AST file without actually loading it. |
Module | A pointer to the module file if the module was successfully loaded. |
ErrorStr | Will be set to a non-empty string if any errors occurred while trying to load the module. |
Definition at line 102 of file ModuleManager.cpp.
|
inline |
Forward iterator to traverse all loaded modules.
Definition at line 149 of file ModuleManager.h.
Referenced by llvm::GraphTraits< ModuleManager >::nodes_begin().
|
inline |
Const forward iterator to traverse all loaded modules.
Definition at line 155 of file ModuleManager.h.
|
inline |
Forward iterator end-point to traverse all loaded modules.
Definition at line 152 of file ModuleManager.h.
Referenced by llvm::GraphTraits< ModuleManager >::nodes_end(), and removeModules().
|
inline |
Const forward iterator end-point to traverse all loaded modules.
Definition at line 158 of file ModuleManager.h.
|
inline |
Definition at line 321 of file ModuleManager.h.
|
inline |
Returns the primary module associated with the manager, that is, the first module loaded.
Definition at line 174 of file ModuleManager.h.
Referenced by clang::ASTReader::getOriginalSourceFile().
|
inline |
Returns the primary module associated with the manager, that is, the first module loaded.
Definition at line 178 of file ModuleManager.h.
ModuleFile * ModuleManager::lookup | ( | const FileEntry * | File | ) | const |
Returns the module associated with the given module file.
Definition at line 62 of file ModuleManager.cpp.
std::unique_ptr< llvm::MemoryBuffer > ModuleManager::lookupBuffer | ( | StringRef | Name | ) |
Returns the in-memory (virtual file) buffer with the given name.
Definition at line 71 of file ModuleManager.cpp.
ModuleFile * ModuleManager::lookupByFileName | ( | StringRef | FileName | ) | const |
Returns the module associated with the given file name.
Definition at line 45 of file ModuleManager.cpp.
Referenced by operator[]().
ModuleFile * ModuleManager::lookupByModuleName | ( | StringRef | ModName | ) | const |
Returns the module associated with the given module name.
Definition at line 54 of file ModuleManager.cpp.
bool ModuleManager::lookupModuleFile | ( | StringRef | FileName, |
off_t | ExpectedSize, | ||
time_t | ExpectedModTime, | ||
const FileEntry *& | File | ||
) |
Attempt to resolve the given module file name to a file entry.
FileName | The name of the module file. |
ExpectedSize | The size that the module file is expected to have. If the actual size differs, the resolver should return true . |
ExpectedModTime | The modification time that the module file is expected to have. If the actual modification time differs, the resolver should return true . |
File | Will be set to the file if there is one, or null otherwise. |
Definition at line 440 of file ModuleManager.cpp.
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 321 of file ModuleManager.cpp.
References clang::GlobalModuleIndex::loadedModuleFile().
|
inline |
Returns the module associated with the given index.
Definition at line 181 of file ModuleManager.h.
References lookupByFileName().
|
inline |
A range covering the PCH and preamble module files loaded.
Definition at line 168 of file ModuleManager.h.
|
inline |
Reverse iterator to traverse all loaded modules.
Definition at line 161 of file ModuleManager.h.
Referenced by getTopImportImplicitModule().
void ModuleManager::removeModules | ( | ModuleIterator | First, |
llvm::SmallPtrSetImpl< ModuleFile *> & | LoadedSuccessfully, | ||
ModuleMap * | modMap | ||
) |
Remove the modules starting from First (to the end).
Definition at line 217 of file ModuleManager.cpp.
References end(), and clang::Last.
|
inline |
Reverse iterator end-point to traverse all loaded modules.
Definition at line 164 of file ModuleManager.h.
void ModuleManager::setGlobalIndex | ( | GlobalModuleIndex * | Index | ) |
Set the global module index.
Definition at line 307 of file ModuleManager.cpp.
References clang::GlobalModuleIndex::loadedModuleFile().
|
inline |
Number of modules loaded.
Definition at line 196 of file ModuleManager.h.
Referenced by clang::PCHValidator::ReadDiagnosticOptions(), and visit().
void ModuleManager::viewGraph | ( | ) |
View the graphviz representation of the module graph.
Definition at line 504 of file ModuleManager.cpp.
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.
Visitor | A 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. |
ModuleFilesHit | If 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 336 of file ModuleManager.cpp.
References clang::serialization::ModuleFile::ImportedBy, clang::serialization::ModuleFile::Imports, clang::serialization::ModuleFile::Index, size(), and State.