clang  3.7.0
Classes | Public Member Functions | Public Attributes | List of all members
clang::HeaderSearchOptions Class Reference

#include <HeaderSearchOptions.h>

Inheritance diagram for clang::HeaderSearchOptions:
[legend]
Collaboration diagram for clang::HeaderSearchOptions:
[legend]

Classes

struct  Entry
 
struct  SystemHeaderPrefix
 

Public Member Functions

 HeaderSearchOptions (StringRef _Sysroot="/")
 
void AddPath (StringRef Path, frontend::IncludeDirGroup Group, bool IsFramework, bool IgnoreSysRoot)
 AddPath - Add the Path path to the specified Group list. More...
 
void AddSystemHeaderPrefix (StringRef Prefix, bool IsSystemHeader)
 
void AddVFSOverlayFile (StringRef Name)
 

Public Attributes

std::string Sysroot
 
std::vector< EntryUserEntries
 User specified include entries. More...
 
std::vector< SystemHeaderPrefixSystemHeaderPrefixes
 User-specified system header prefixes. More...
 
std::string ResourceDir
 
std::string ModuleCachePath
 The directory used for the module cache. More...
 
std::string ModuleUserBuildPath
 The directory used for a user build. More...
 
std::string ModuleFormat
 The module/pch container format. More...
 
unsigned DisableModuleHash: 1
 Whether we should disable the use of the hash string within the module cache. More...
 
unsigned ImplicitModuleMaps: 1
 Implicit module maps. This option is enabld by default when modules is enabled. More...
 
unsigned ModuleMapFileHomeIsCwd: 1
 Set the 'home directory' of a module map file to the current working directory (or the home directory of the module map file that contained the 'extern module' directive importing this module map file if any) rather than the directory containing the module map file. More...
 
unsigned ModuleCachePruneInterval
 The interval (in seconds) between pruning operations. More...
 
unsigned ModuleCachePruneAfter
 The time (in seconds) after which an unused module file will be considered unused and will, therefore, be pruned. More...
 
uint64_t BuildSessionTimestamp
 The time in seconds when the build session started. More...
 
llvm::SetVector< std::string > ModulesIgnoreMacros
 The set of macro names that should be ignored for the purposes of computing the module hash. More...
 
std::vector< std::string > VFSOverlayFiles
 The set of user-provided virtual filesystem overlay files. More...
 
unsigned UseBuiltinIncludes: 1
 Include the compiler builtin includes. More...
 
unsigned UseStandardSystemIncludes: 1
 Include the system standard include search directories. More...
 
unsigned UseStandardCXXIncludes: 1
 Include the system standard C++ library include search directories. More...
 
unsigned UseLibcxx: 1
 Use libc++ instead of the default libstdc++. More...
 
unsigned Verbose: 1
 Whether header search information should be output as for -v. More...
 
unsigned ModulesValidateOncePerBuildSession: 1
 If true, skip verifying input files used by modules if the module was already verified during this build session (see BuildSessionTimestamp). More...
 
unsigned ModulesValidateSystemHeaders: 1
 Whether to validate system input files when a module is loaded. More...
 

Detailed Description

HeaderSearchOptions - Helper class for storing options related to the initialization of the HeaderSearch object.

Definition at line 45 of file HeaderSearchOptions.h.

Constructor & Destructor Documentation

clang::HeaderSearchOptions::HeaderSearchOptions ( StringRef  _Sysroot = "/")
inline

Definition at line 172 of file HeaderSearchOptions.h.

Member Function Documentation

void clang::HeaderSearchOptions::AddPath ( StringRef  Path,
frontend::IncludeDirGroup  Group,
bool  IsFramework,
bool  IgnoreSysRoot 
)
inline

AddPath - Add the Path path to the specified Group list.

Definition at line 183 of file HeaderSearchOptions.h.

References UserEntries.

Referenced by ParseHeaderSearchArgs().

void clang::HeaderSearchOptions::AddSystemHeaderPrefix ( StringRef  Prefix,
bool  IsSystemHeader 
)
inline

AddSystemHeaderPrefix - Override whether #include directives naming a path starting with Prefix should be considered as naming a system header.

Definition at line 191 of file HeaderSearchOptions.h.

References SystemHeaderPrefixes.

Referenced by ParseHeaderSearchArgs().

void clang::HeaderSearchOptions::AddVFSOverlayFile ( StringRef  Name)
inline

Definition at line 195 of file HeaderSearchOptions.h.

References VFSOverlayFiles.

Referenced by ParseHeaderSearchArgs().

Member Data Documentation

uint64_t clang::HeaderSearchOptions::BuildSessionTimestamp

The time in seconds when the build session started.

This time is used by other optimizations in header search and module loading.

Definition at line 139 of file HeaderSearchOptions.h.

Referenced by ParseHeaderSearchArgs().

unsigned clang::HeaderSearchOptions::DisableModuleHash

Whether we should disable the use of the hash string within the module cache.

Note: Only used for testing!

Definition at line 102 of file HeaderSearchOptions.h.

Referenced by ParseHeaderSearchArgs().

unsigned clang::HeaderSearchOptions::ImplicitModuleMaps

Implicit module maps. This option is enabld by default when modules is enabled.

Definition at line 106 of file HeaderSearchOptions.h.

Referenced by ParseHeaderSearchArgs().

std::string clang::HeaderSearchOptions::ModuleCachePath

The directory used for the module cache.

Definition at line 90 of file HeaderSearchOptions.h.

Referenced by ParseHeaderSearchArgs(), and pruneModuleCache().

unsigned clang::HeaderSearchOptions::ModuleCachePruneAfter

The time (in seconds) after which an unused module file will be considered unused and will, therefore, be pruned.

When the module cache is pruned, any module file that has not been accessed in this many seconds will be removed. The default value is large, e.g., a month, to avoid forcing infrequently-used modules to be regenerated often.

Definition at line 133 of file HeaderSearchOptions.h.

Referenced by ParseHeaderSearchArgs(), and pruneModuleCache().

unsigned clang::HeaderSearchOptions::ModuleCachePruneInterval

The interval (in seconds) between pruning operations.

This operation is expensive, because it requires Clang to walk through the directory structure of the module cache, stat()'ing and removing files.

The default value is large, e.g., the operation runs once a week.

Definition at line 124 of file HeaderSearchOptions.h.

Referenced by ParseHeaderSearchArgs(), and pruneModuleCache().

std::string clang::HeaderSearchOptions::ModuleFormat
unsigned clang::HeaderSearchOptions::ModuleMapFileHomeIsCwd

Set the 'home directory' of a module map file to the current working directory (or the home directory of the module map file that contained the 'extern module' directive importing this module map file if any) rather than the directory containing the module map file.

The home directory is where we look for files named in the module map file.

Definition at line 115 of file HeaderSearchOptions.h.

Referenced by ParseHeaderSearchArgs().

llvm::SetVector<std::string> clang::HeaderSearchOptions::ModulesIgnoreMacros

The set of macro names that should be ignored for the purposes of computing the module hash.

Definition at line 143 of file HeaderSearchOptions.h.

Referenced by compileModuleImpl(), clang::CompilerInvocation::getModuleHash(), and ParseHeaderSearchArgs().

unsigned clang::HeaderSearchOptions::ModulesValidateOncePerBuildSession

If true, skip verifying input files used by modules if the module was already verified during this build session (see BuildSessionTimestamp).

Definition at line 166 of file HeaderSearchOptions.h.

Referenced by ParseHeaderSearchArgs().

unsigned clang::HeaderSearchOptions::ModulesValidateSystemHeaders

Whether to validate system input files when a module is loaded.

Definition at line 169 of file HeaderSearchOptions.h.

Referenced by clang::CompilerInstance::createModuleManager(), clang::CompilerInstance::createPCHExternalASTSource(), and ParseHeaderSearchArgs().

std::string clang::HeaderSearchOptions::ModuleUserBuildPath

The directory used for a user build.

Definition at line 93 of file HeaderSearchOptions.h.

Referenced by clang::CompilerInvocation::getModuleHash(), and ParseHeaderSearchArgs().

std::string clang::HeaderSearchOptions::ResourceDir

The directory which holds the compiler resource files (builtin includes, etc.).

Definition at line 87 of file HeaderSearchOptions.h.

Referenced by clang::ApplyHeaderSearchOptions(), clang::CompilerInvocation::getModuleHash(), clang::ASTUnit::LoadFromCompilerInvocationAction(), and ParseHeaderSearchArgs().

std::string clang::HeaderSearchOptions::Sysroot
std::vector<SystemHeaderPrefix> clang::HeaderSearchOptions::SystemHeaderPrefixes

User-specified system header prefixes.

Definition at line 83 of file HeaderSearchOptions.h.

Referenced by AddSystemHeaderPrefix(), and clang::ApplyHeaderSearchOptions().

unsigned clang::HeaderSearchOptions::UseBuiltinIncludes

Include the compiler builtin includes.

Definition at line 149 of file HeaderSearchOptions.h.

Referenced by clang::ApplyHeaderSearchOptions(), clang::CompilerInvocation::getModuleHash(), and ParseHeaderSearchArgs().

unsigned clang::HeaderSearchOptions::UseLibcxx

Use libc++ instead of the default libstdc++.

Definition at line 158 of file HeaderSearchOptions.h.

Referenced by clang::CompilerInvocation::getModuleHash(), and ParseHeaderSearchArgs().

std::vector<Entry> clang::HeaderSearchOptions::UserEntries

User specified include entries.

Definition at line 80 of file HeaderSearchOptions.h.

Referenced by AddPath(), and clang::ApplyHeaderSearchOptions().

unsigned clang::HeaderSearchOptions::UseStandardCXXIncludes

Include the system standard C++ library include search directories.

Definition at line 155 of file HeaderSearchOptions.h.

Referenced by clang::CompilerInvocation::getModuleHash(), and ParseHeaderSearchArgs().

unsigned clang::HeaderSearchOptions::UseStandardSystemIncludes

Include the system standard include search directories.

Definition at line 152 of file HeaderSearchOptions.h.

Referenced by clang::CompilerInvocation::getModuleHash(), and ParseHeaderSearchArgs().

unsigned clang::HeaderSearchOptions::Verbose

Whether header search information should be output as for -v.

Definition at line 161 of file HeaderSearchOptions.h.

Referenced by clang::ApplyHeaderSearchOptions(), and ParseHeaderSearchArgs().

std::vector<std::string> clang::HeaderSearchOptions::VFSOverlayFiles

The set of user-provided virtual filesystem overlay files.

Definition at line 146 of file HeaderSearchOptions.h.

Referenced by AddVFSOverlayFile(), and clang::createVFSFromCompilerInvocation().


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