#include "CGBlocks.h"
#include "CGDebugInfo.h"
#include "CGObjCRuntime.h"
#include "CodeGenFunction.h"
#include "CodeGenModule.h"
#include "clang/AST/DeclObjC.h"
#include "llvm/ADT/SmallSet.h"
#include "llvm/IR/CallSite.h"
#include "llvm/IR/DataLayout.h"
#include "llvm/IR/Module.h"
#include <algorithm>
#include <cstdio>

Include dependency graph for CGBlocks.cpp:

Functions
static llvm::Constant *	buildGlobalBlock (CodeGenModule &CGM, const CGBlockInfo &blockInfo, llvm::Constant *blockFn)
	Build the given block as a global block.
static llvm::Constant *	buildCopyHelper (CodeGenModule &CGM, const CGBlockInfo &blockInfo)
	Build the helper function to copy a block.
static llvm::Constant *	buildDisposeHelper (CodeGenModule &CGM, const CGBlockInfo &blockInfo)
	Build the helper function to dispose of a block.
static llvm::Constant *	buildBlockDescriptor (CodeGenModule &CGM, const CGBlockInfo &blockInfo)
static bool	isSafeForCXXConstantCapture (QualType type)
	Determines if the given type is safe for constant capture in C++.
static llvm::Constant *	tryCaptureAsConstant (CodeGenModule &CGM, CodeGenFunction CGF, const VarDecl var)
static CharUnits	getLowBit (CharUnits v)
static void	initializeForBlockHeader (CodeGenModule &CGM, CGBlockInfo &info, SmallVectorImpl< llvm::Type * > &elementTypes)
static void	computeBlockInfo (CodeGenModule &CGM, CodeGenFunction *CGF, CGBlockInfo &info)
static void	enterBlockScope (CodeGenFunction &CGF, BlockDecl *block)
static CGBlockInfo *	findAndRemoveBlockInfo (CGBlockInfo *head, const BlockDecl block)
	Find the layout for the given block in a linked list and remove it.
static llvm::Constant *	generateByrefCopyHelper (CodeGenFunction &CGF, llvm::StructType &byrefType, unsigned valueFieldIndex, CodeGenModule::ByrefHelpers &byrefInfo)
static llvm::Constant *	buildByrefCopyHelper (CodeGenModule &CGM, llvm::StructType &byrefType, unsigned byrefValueIndex, CodeGenModule::ByrefHelpers &info)
	Build the copy helper for a __block variable.
static llvm::Constant *	generateByrefDisposeHelper (CodeGenFunction &CGF, llvm::StructType &byrefType, unsigned byrefValueIndex, CodeGenModule::ByrefHelpers &byrefInfo)
	Generate code for a __block variable's dispose helper.
static llvm::Constant *	buildByrefDisposeHelper (CodeGenModule &CGM, llvm::StructType &byrefType, unsigned byrefValueIndex, CodeGenModule::ByrefHelpers &info)
	Build the dispose helper for a __block variable.
template<class T >
static T *	buildByrefHelpers (CodeGenModule &CGM, llvm::StructType &byrefTy, unsigned byrefValueIndex, T &byrefInfo)
static void	configureBlocksRuntimeObject (CodeGenModule &CGM, llvm::Constant *C)
	Adjust the declaration of something from the blocks API.
Variables
const unsigned	BlockHeaderSize = 5
	The number of fields in a block header.

Function Documentation

static llvm::Constant* buildBlockDescriptor	(	CodeGenModule &	CGM,
		const CGBlockInfo &	blockInfo
	)		`[static]`

buildBlockDescriptor - Build the block descriptor meta-data for a block. buildBlockDescriptor is accessed from 5th field of the Block_literal meta-data and contains stationary information about the block literal. Its definition will have 4 (or optinally 6) words.

 struct Block_descriptor {
   unsigned long reserved;
   unsigned long size;  // size of Block_literal metadata in bytes.
   void *copy_func_helper_decl;  // optional copy helper.
   void *destroy_func_decl; // optioanl destructor helper.
   void *block_method_encoding_address; // @encode for block literal signature.
   void *block_layout_info; // encoding of captured block variables.
 };

Definition at line 76 of file CGBlocks.cpp.

Referenced by buildGlobalBlock(), and clang::CodeGen::CodeGenFunction::EmitBlockLiteral().

static llvm::Constant* buildByrefCopyHelper	(	CodeGenModule &	CGM,
		llvm::StructType &	byrefType,
		unsigned	byrefValueIndex,
		CodeGenModule::ByrefHelpers &	info
	)		`[static]`

Build the copy helper for a __block variable.

Definition at line 1815 of file CGBlocks.cpp.

References generateByrefCopyHelper().

Referenced by buildByrefHelpers().

static llvm::Constant* buildByrefDisposeHelper	(	CodeGenModule &	CGM,
		llvm::StructType &	byrefType,
		unsigned	byrefValueIndex,
		CodeGenModule::ByrefHelpers &	info
	)		`[static]`

Build the dispose helper for a __block variable.

Definition at line 1876 of file CGBlocks.cpp.

References generateByrefDisposeHelper().

Referenced by buildByrefHelpers().

template<class T >

static T* buildByrefHelpers	(	CodeGenModule &	CGM,
		llvm::StructType &	byrefTy,
		unsigned	byrefValueIndex,
		T &	byrefInfo
	)		`[static]`

Lazily build the copy and dispose helpers for a __block variable with the given information.

Definition at line 1886 of file CGBlocks.cpp.

References buildByrefCopyHelper(), buildByrefDisposeHelper(), clang::CodeGen::CodeGenModule::ByrefHelpersCache, clang::CharUnits::fromQuantity(), clang::CodeGen::CodeGenModule::getContext(), clang::ast_matchers::id(), and clang::CodeGen::CodeGenTypeCache::PointerAlignInBytes.

Referenced by clang::CodeGen::CodeGenFunction::emitByrefStructureInit().

static llvm::Constant* buildCopyHelper	(	CodeGenModule &	CGM,
		const CGBlockInfo &	blockInfo
	)		`[static]`

Build the helper function to copy a block.

Definition at line 51 of file CGBlocks.cpp.

References clang::CodeGen::CodeGenFunction::GenerateCopyHelperFunction().

Referenced by buildBlockDescriptor().

static llvm::Constant* buildDisposeHelper	(	CodeGenModule &	CGM,
		const CGBlockInfo &	blockInfo
	)		`[static]`

Build the helper function to dispose of a block.

Definition at line 57 of file CGBlocks.cpp.

References clang::CodeGen::CodeGenFunction::GenerateDestroyHelperFunction().

Referenced by buildBlockDescriptor().

static llvm::Constant * buildGlobalBlock	(	CodeGenModule &	CGM,
		const CGBlockInfo &	blockInfo,
		llvm::Constant *	blockFn
	)		`[static]`

Build the given block as a global block.

Definition at line 1055 of file CGBlocks.cpp.

References clang::CodeGen::BLOCK_HAS_SIGNATURE, clang::CodeGen::BLOCK_IS_GLOBAL, clang::CodeGen::BLOCK_USE_STRET, clang::CodeGen::CGBlockInfo::BlockAlign, BlockHeaderSize, buildBlockDescriptor(), clang::CodeGen::CGBlockInfo::CanBeGlobal, clang::CodeGen::CodeGenTypes::ConvertType(), clang::CodeGen::BlockFlags::getBitMask(), clang::CodeGen::CGBlockInfo::getBlockExpr(), clang::CodeGen::CodeGenModule::getModule(), clang::CodeGen::CodeGenModule::getNSConcreteGlobalBlock(), clang::CharUnits::getQuantity(), clang::Expr::getType(), clang::CodeGen::CodeGenModule::getTypes(), clang::InternalLinkage, clang::CodeGen::CodeGenTypeCache::IntTy, and clang::CodeGen::CGBlockInfo::UsesStret.

Referenced by clang::CodeGen::CodeGenFunction::EmitBlockLiteral(), and clang::CodeGen::CodeGenModule::GetAddrOfGlobalBlock().

static void computeBlockInfo	(	CodeGenModule &	CGM,
		CodeGenFunction *	CGF,
		CGBlockInfo &	info
	)		`[static]`

Compute the layout of the given block. Attempts to lay the block out with minimal space requirements.

Definition at line 337 of file CGBlocks.cpp.

Referenced by clang::CodeGen::CodeGenFunction::EmitBlockLiteral(), enterBlockScope(), and clang::CodeGen::CodeGenModule::GetAddrOfGlobalBlock().

static void configureBlocksRuntimeObject	(	CodeGenModule &	CGM,
		llvm::Constant *	C
	)		`[static]`

Adjust the declaration of something from the blocks API.

Definition at line 2251 of file CGBlocks.cpp.

References clang::CodeGen::CodeGenModule::getLangOpts().

Referenced by clang::CodeGen::CodeGenModule::getBlockObjectAssign(), clang::CodeGen::CodeGenModule::getBlockObjectDispose(), clang::CodeGen::CodeGenModule::getNSConcreteGlobalBlock(), and clang::CodeGen::CodeGenModule::getNSConcreteStackBlock().

static void enterBlockScope	(	CodeGenFunction &	CGF,
		BlockDecl *	block
	)		`[static]`

Enter the scope of a block. This should be run at the entrance to a full-expression so that the block's cleanups are pushed at the right place in the stack.

Definition at line 572 of file CGBlocks.cpp.

Referenced by clang::CodeGen::CodeGenFunction::enterNonTrivialFullExpression().

static CGBlockInfo* findAndRemoveBlockInfo	(	CGBlockInfo **	head,
		const BlockDecl *	block
	)		`[static]`

Find the layout for the given block in a linked list and remove it.

Definition at line 657 of file CGBlocks.cpp.

References clang::CodeGen::CGBlockInfo::getBlockDecl(), and clang::CodeGen::CGBlockInfo::NextBlockInfo.

Referenced by clang::CodeGen::CodeGenFunction::EmitBlockLiteral().

static llvm::Constant* generateByrefCopyHelper	(	CodeGenFunction &	CGF,
		llvm::StructType &	byrefType,
		unsigned	valueFieldIndex,
		CodeGenModule::ByrefHelpers &	byrefInfo
	)		`[static]`

Definition at line 1750 of file CGBlocks.cpp.

Referenced by buildByrefCopyHelper().

static llvm::Constant* generateByrefDisposeHelper	(	CodeGenFunction &	CGF,
		llvm::StructType &	byrefType,
		unsigned	byrefValueIndex,
		CodeGenModule::ByrefHelpers &	byrefInfo
	)		`[static]`

Generate code for a __block variable's dispose helper.

Definition at line 1825 of file CGBlocks.cpp.

Referenced by buildByrefDisposeHelper().

static CharUnits getLowBit ( CharUnits v ) [static]

Get the low bit of a nonzero character count. This is the alignment of the nth byte if the 0th byte is universally aligned.

Definition at line 299 of file CGBlocks.cpp.

References clang::CharUnits::fromQuantity(), and clang::CharUnits::getQuantity().

Referenced by computeBlockInfo().

static void initializeForBlockHeader	(	CodeGenModule &	CGM,
		CGBlockInfo &	info,
		SmallVectorImpl< llvm::Type * > &	elementTypes
	)		`[static]`

Definition at line 303 of file CGBlocks.cpp.

References clang::CodeGen::CGBlockInfo::BlockAlign, BlockHeaderSize, clang::CodeGen::CGBlockInfo::BlockSize, AttributeLangSupport::C, clang::CodeGen::CodeGenTypes::ConvertType(), clang::CodeGen::CodeGenModule::getBlockDescriptorType(), clang::CodeGen::CodeGenModule::getContext(), clang::ASTContext::getTypeInfoInChars(), clang::CodeGen::CodeGenModule::getTypes(), clang::ASTContext::IntTy, and clang::ASTContext::VoidPtrTy.

Referenced by computeBlockInfo().

static bool isSafeForCXXConstantCapture ( QualType type ) [static]

Determines if the given type is safe for constant capture in C++.

Definition at line 248 of file CGBlocks.cpp.

References clang::Type::getAs(), clang::Type::getBaseElementTypeUnsafe(), and clang::RecordType::getDecl().

Referenced by tryCaptureAsConstant().

static llvm::Constant* tryCaptureAsConstant	(	CodeGenModule &	CGM,
		CodeGenFunction *	CGF,
		const VarDecl *	var
	)		`[static]`

It is illegal to modify a const object after initialization. Therefore, if a const object has a constant initializer, we don't actually need to keep storage for it in the block; we'll just rematerialize it at the start of the block function. This is acceptable because we make no promises about address stability of captured variables.

Definition at line 272 of file CGBlocks.cpp.

References clang::CodeGen::CodeGenModule::EmitConstantInit(), clang::VarDecl::getInit(), clang::CodeGen::CodeGenModule::getLangOpts(), clang::ValueDecl::getType(), clang::QualType::isConstQualified(), isSafeForCXXConstantCapture(), and clang::ast_matchers::type.

Referenced by computeBlockInfo().

Variable Documentation

const unsigned BlockHeaderSize = 5

The number of fields in a block header.

Definition at line 187 of file CGBlocks.cpp.

Referenced by buildGlobalBlock(), and initializeForBlockHeader().

Functions

Variables

Function Documentation

Variable Documentation