clang 23.0.0git
clang::dependencies::DependencyScanningWorkerFilesystem Class Reference

A virtual file system optimized for the dependency discovery. More...

#include "clang/DependencyScanning/DependencyScanningFilesystem.h"

Inheritance diagram for clang::dependencies::DependencyScanningWorkerFilesystem:
[legend]

Public Member Functions

 DependencyScanningWorkerFilesystem (DependencyScanningFilesystemSharedCache &SharedCache, IntrusiveRefCntPtr< llvm::vfs::FileSystem > FS)
llvm::ErrorOr< llvm::vfs::Status > status (const Twine &Path) override
llvm::ErrorOr< std::unique_ptr< llvm::vfs::File > > openFileForRead (const Twine &Path) override
std::error_code getRealPath (const Twine &Path, SmallVectorImpl< char > &Output) override
std::error_code setCurrentWorkingDirectory (const Twine &Path) override
llvm::ErrorOr< EntryRefgetOrCreateFileSystemEntry (StringRef Filename)
 Returns entry for the given filename.
bool ensureDirectiveTokensArePopulated (EntryRef Entry)
 Ensure the directive tokens are populated for this file entry.
std::optional< ArrayRef< dependency_directives_scan::Directive > > getDirectiveTokens (const Twine &Path)
bool exists (const Twine &Path) override
 Check whether Path exists.

Static Public Attributes

static const char ID = 0

Detailed Description

A virtual file system optimized for the dependency discovery.

It is primarily designed to work with source files whose contents was preprocessed to remove any tokens that are unlikely to affect the dependency computation.

This is not a thread safe VFS. A single instance is meant to be used only in one thread. Multiple instances are allowed to service multiple threads running in parallel.

Definition at line 366 of file DependencyScanningFilesystem.h.

Constructor & Destructor Documentation

◆ DependencyScanningWorkerFilesystem()

DependencyScanningWorkerFilesystem::DependencyScanningWorkerFilesystem ( DependencyScanningFilesystemSharedCache & SharedCache,
IntrusiveRefCntPtr< llvm::vfs::FileSystem > FS )

Member Function Documentation

◆ ensureDirectiveTokensArePopulated()

bool DependencyScanningWorkerFilesystem::ensureDirectiveTokensArePopulated ( EntryRef Entry)

Ensure the directive tokens are populated for this file entry.

Returns true if the directive tokens are populated for this file entry, false if not (i.e. this entry is not a file or its scan fails).

Definition at line 42 of file DependencyScanningFilesystem.cpp.

References clang::dependencies::CachedFileContents::DepDirectives, clang::dependencies::CachedFileContents::DepDirectiveTokens, clang::dependencies::CachedFileContents::Original, clang::scanSourceForDependencyDirectives(), and clang::dependencies::CachedFileContents::ValueLock.

Referenced by getDirectiveTokens().

◆ exists()

bool DependencyScanningWorkerFilesystem::exists ( const Twine & Path)
override

Check whether Path exists.

By default checks cached result of status(), and falls back on FS if unable to do so.

Definition at line 333 of file DependencyScanningFilesystem.cpp.

References status().

◆ getDirectiveTokens()

std::optional< ArrayRef< dependency_directives_scan::Directive > > clang::dependencies::DependencyScanningWorkerFilesystem::getDirectiveTokens ( const Twine & Path)
inline
Returns
The scanned preprocessor directive tokens of the file that are used to speed up preprocessing, if available.

Definition at line 400 of file DependencyScanningFilesystem.h.

References ensureDirectiveTokensArePopulated(), and getOrCreateFileSystemEntry().

◆ getOrCreateFileSystemEntry()

llvm::ErrorOr< EntryRef > DependencyScanningWorkerFilesystem::getOrCreateFileSystemEntry ( StringRef Filename)

Returns entry for the given filename.

Attempts to use the local and shared caches first, then falls back to using the underlying filesystem.

Definition at line 306 of file DependencyScanningFilesystem.cpp.

References clang::dependencies::EntryRef::unwrapError().

Referenced by getDirectiveTokens(), openFileForRead(), and status().

◆ getRealPath()

std::error_code DependencyScanningWorkerFilesystem::getRealPath ( const Twine & Path,
SmallVectorImpl< char > & Output )
override

Definition at line 403 of file DependencyScanningFilesystem.cpp.

◆ openFileForRead()

llvm::ErrorOr< std::unique_ptr< llvm::vfs::File > > DependencyScanningWorkerFilesystem::openFileForRead ( const Twine & Path)
override

◆ setCurrentWorkingDirectory()

std::error_code DependencyScanningWorkerFilesystem::setCurrentWorkingDirectory ( const Twine & Path)
override

Definition at line 450 of file DependencyScanningFilesystem.cpp.

◆ status()

llvm::ErrorOr< llvm::vfs::Status > DependencyScanningWorkerFilesystem::status ( const Twine & Path)
override

Definition at line 323 of file DependencyScanningFilesystem.cpp.

References getOrCreateFileSystemEntry(), and clang::Result.

Referenced by exists().

Member Data Documentation

◆ ID

const char DependencyScanningWorkerFilesystem::ID = 0
static

Definition at line 370 of file DependencyScanningFilesystem.h.


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