Representations of a library's headers for InstallAPI. More...

Classes
class	DylibVerifier
	Service responsible to tracking state of verification across the lifetime of InstallAPI. More...

class	FileListReader

struct	FrontendAttrs
	Frontend information captured about records. More...

class	FrontendRecordsSlice

class	HeaderFile

class	HeaderGlob
	Glob that represents a pattern of header files to retreive. More...

class	InstallAPIAction

struct	InstallAPIContext
	Struct used for generating validating InstallAPI. More...

class	InstallAPIVisitor
	ASTVisitor for collecting declarations that represent global symbols. More...

struct	ZipperedDeclSource

Typedefs
using	LibAttrs = llvm::StringMap< ArchitectureSet >

using	ReexportedInterfaces = llvm::SmallVector< llvm::MachO::InterfaceFile, 8 >

using	ZipperedDeclSources = std::vector< ZipperedDeclSource >

using	HeaderSeq = std::vector< HeaderFile >

Enumerations
enum class	VerificationMode { Invalid , ErrorsOnly , ErrorsAndWarnings , Pedantic }
	A list of InstallAPI verification modes. More...

enum class	HeaderType { Public , Private , Project , Unknown }

Functions
std::string	findLibrary (StringRef InstallName, FileManager &FM, ArrayRef< std::string > FrameworkSearchPaths, ArrayRef< std::string > LibrarySearchPaths, ArrayRef< std::string > SearchPaths)
	Lookup the dylib or TextAPI file location for a system library or framework.

std::unique_ptr< llvm::MemoryBuffer >	createInputBuffer (InstallAPIContext &Ctx)
	Create a buffer that contains all headers to scan for global symbols with.

StringRef	getName (const HeaderType T)

std::optional< std::string >	createIncludeHeaderName (const StringRef FullPath)
	Assemble expected way header will be included by clients.

bool	isHeaderFile (StringRef Path)
	Determine if Path is a header file.

llvm::Expected< PathSeq >	enumerateFiles (clang::FileManager &FM, StringRef Directory)
	Given input directory, collect all header files.

static bool	isCppMangled (StringRef Name)

static std::string	demangle (StringRef Name)

static DylibVerifier::Result	updateResult (const DylibVerifier::Result Prev, const DylibVerifier::Result Curr)

static bool	shouldIgnorePrivateExternAttr (const Decl *D)

Record *	findRecordFromSlice (const RecordsSlice *Slice, StringRef Name, EncodeKind Kind)

static ObjCIFSymbolKind	assignObjCIFSymbolKind (const ObjCInterfaceRecord *R)

static bool	shouldIgnoreCpp (StringRef Name, bool IsWeakDef)

static StringRef	getFileExtension (clang::Language Lang)

static bool	isExported (const NamedDecl *D)

static bool	isInlined (const FunctionDecl *D)

static SymbolFlags	getFlags (bool WeakDef, bool ThreadLocal=false)

static bool	hasObjCExceptionAttribute (const ObjCInterfaceDecl *D)
	Check if the interface itself or any of its super classes have an exception attribute.

static bool	hasVTable (const CXXRecordDecl *D)

static CXXLinkage	getVTableLinkage (const CXXRecordDecl *D)

static bool	isRTTIWeakDef (const CXXRecordDecl *D)

static bool	hasRTTI (const CXXRecordDecl *D)

Detailed Description

Representations of a library's headers for InstallAPI.

Typedef Documentation

◆ HeaderSeq

using clang::installapi::HeaderSeq = typedef std::vector<HeaderFile>

Definition at line 137 of file HeaderFile.h.

◆ LibAttrs

using clang::installapi::LibAttrs = typedef llvm::StringMap<ArchitectureSet>

Definition at line 28 of file DylibVerifier.h.

◆ ReexportedInterfaces

using clang::installapi::ReexportedInterfaces = typedef llvm::SmallVector<llvm::MachO::InterfaceFile, 8>

Definition at line 29 of file DylibVerifier.h.

◆ ZipperedDeclSources

using clang::installapi::ZipperedDeclSources = typedef std::vector<ZipperedDeclSource>

Definition at line 39 of file DylibVerifier.h.

Enumeration Type Documentation

◆ HeaderType

enum class clang::installapi::HeaderType

strong

Enumerator
Public	Represents declarations accessible to all clients.
Private	Represents declarations accessible to a disclosed set of clients.
Project	Represents declarations only accessible as implementation details to the input library.
Unknown	Unset or unknown type.

Definition at line 26 of file HeaderFile.h.

◆ VerificationMode

enum class clang::installapi::VerificationMode

strong

A list of InstallAPI verification modes.

Enumerator
Invalid
ErrorsOnly
ErrorsAndWarnings
Pedantic

Definition at line 21 of file DylibVerifier.h.

Function Documentation

◆ assignObjCIFSymbolKind()

static ObjCIFSymbolKind clang::installapi::assignObjCIFSymbolKind ( const ObjCInterfaceRecord * R )

static

Definition at line 535 of file DylibVerifier.cpp.

References clang::Result.

Referenced by clang::installapi::DylibVerifier::verify().

◆ createIncludeHeaderName()

std::optional< std::string > clang::installapi::createIncludeHeaderName ( const StringRef FullPath )

Assemble expected way header will be included by clients.

As in what maps inside the brackets of #include <IncludeName.h> For example, "/System/Library/Frameworks/Foo.framework/Headers/Foo.h" returns "Foo/Foo.h"

Parameters

FullPath Path to the header file which includes the library structure.

Definition at line 19 of file HeaderFile.cpp.

References clang::installapi::HeaderFile::getFrameworkIncludeRule().

◆ createInputBuffer()

std::unique_ptr< MemoryBuffer > clang::installapi::createInputBuffer ( InstallAPIContext & Ctx )

Create a buffer that contains all headers to scan for global symbols with.

Definition at line 136 of file Frontend.cpp.

References clang::installapi::InstallAPIContext::addKnownHeader(), clang::C, clang::CXX, getFileExtension(), clang::installapi::HeaderFile::getIncludeName(), getName(), clang::installapi::HeaderFile::getPath(), clang::installapi::HeaderFile::getType(), clang::installapi::InstallAPIContext::InputHeaders, clang::installapi::HeaderFile::isExcluded(), clang::installapi::InstallAPIContext::LangMode, clang::installapi::InstallAPIContext::Slice, clang::installapi::InstallAPIContext::Type, Unknown, and clang::installapi::HeaderFile::useIncludeName().

◆ demangle()

static std::string clang::installapi::demangle ( StringRef Name )

static

Definition at line 54 of file DylibVerifier.cpp.

References isCppMangled(), and clang::Result.

◆ enumerateFiles()

llvm::Expected< PathSeq > clang::installapi::enumerateFiles	(	clang::FileManager &	FM,
		StringRef	Directory
	)

Given input directory, collect all header files.

Parameters

FM	FileManager for finding input files.
Directory	Path to directory file.

Definition at line 45 of file HeaderFile.cpp.

References clang::FileManager::getVirtualFileSystem(), and isHeaderFile().

◆ findLibrary()

std::string clang::installapi::findLibrary	(	StringRef	InstallName,
		FileManager &	FM,
		ArrayRef< std::string >	FrameworkSearchPaths,
		ArrayRef< std::string >	LibrarySearchPaths,
		ArrayRef< std::string >	SearchPaths
	)

Lookup the dylib or TextAPI file location for a system library or framework.

The search paths provided are searched in order. @rpath based libraries are not supported.

Parameters

InstallName	The install name for the library.
FrameworkSearchPaths	Search paths to look up frameworks with.
LibrarySearchPaths	Search paths to look up dylibs with.
SearchPaths	Fallback search paths if library was not found in earlier paths.