#include "RetainCountChecker.h"
#include "clang/StaticAnalyzer/Core/PathSensitive/CallEvent.h"
#include <optional>

Namespaces
namespace	clang
	The JSON file list parser is used to communicate input to InstallAPI.
namespace	clang::ento
namespace	clang::ento::retaincountchecker

Functions
const RefVal *	clang::ento::retaincountchecker::getRefBinding (ProgramStateRef State, SymbolRef Sym)
static ProgramStateRef	setRefBinding (ProgramStateRef State, SymbolRef Sym, RefVal Val)
static ProgramStateRef	removeRefBinding (ProgramStateRef State, SymbolRef Sym)
static bool	isReceiverUnconsumedSelf (const CallEvent &Call)
static const RetainSummary *	getSummary (RetainSummaryManager &Summaries, const CallEvent &Call, QualType ReceiverType)
static QualType	GetReturnType (const Expr *RetE, ASTContext &Ctx)
	GetReturnType - Used to get the return type of a message expression or function call with the intention of affixing that type to a tracked symbol.
static std::optional< RefVal >	refValFromRetEffect (RetEffect RE, QualType ResultTy)
static bool	isPointerToObject (QualType QT)
static bool	shouldEscapeOSArgumentOnCall (const CallEvent &CE, unsigned ArgIdx, const RefVal *TrackedValue)
	Whether the tracked value should be escaped on a given call.
static bool	isSmartPtrField (const MemRegion *MR)
static bool	shouldEscapeRegion (ProgramStateRef State, const MemRegion *R)
	A value escapes in these possible cases:
static SmallVector< ProgramStateRef, 2 >	updateOutParameters (ProgramStateRef State, const RetainSummary &Summ, const CallEvent &CE)

Function Documentation

◆ GetReturnType()

QualType GetReturnType	(	const Expr *	RetE,
		ASTContext &	Ctx )

static

GetReturnType - Used to get the return type of a message expression or function call with the intention of affixing that type to a tracked symbol.

While the return type can be queried directly from RetEx, when invoking class methods we augment to the return type to be that of a pointer to the class (as opposed it just being id).

more specific than id.

Definition at line 392 of file RetainCountChecker.cpp.

References clang::Type::getAs(), clang::ASTContext::getObjCInterfaceType(), clang::ASTContext::getObjCObjectPointerType(), and clang::Expr::getType().

◆ getSummary()

const RetainSummary * getSummary	(	RetainSummaryManager &	Summaries,
		const CallEvent &	Call,
		QualType	ReceiverType )

static

Definition at line 350 of file RetainCountChecker.cpp.

References clang::C, clang::Call, clang::cast(), clang::AnyCall::forExpr(), clang::ento::RetainSummaryManager::getSummary(), and isReceiverUnconsumedSelf().

Referenced by clang::ento::retaincountchecker::RetainCountChecker::checkPostCall().

◆ isPointerToObject()

bool isPointerToObject ( QualType QT )

static

Definition at line 424 of file RetainCountChecker.cpp.

References clang::Type::getAsCXXRecordDecl(), clang::Type::getPointeeType(), and clang::QualType::isNull().

Referenced by shouldEscapeOSArgumentOnCall().

◆ isReceiverUnconsumedSelf()

bool isReceiverUnconsumedSelf ( const CallEvent & Call )

static

Definition at line 336 of file RetainCountChecker.cpp.

References clang::Call, and clang::OMF_init.

Referenced by getSummary().

◆ isSmartPtrField()

bool isSmartPtrField ( const MemRegion * MR )

static

Definition at line 486 of file RetainCountChecker.cpp.

References clang::cast(), and clang::ento::RetainSummaryManager::isKnownSmartPointer().

Referenced by shouldEscapeRegion().

◆ refValFromRetEffect()

std::optional< RefVal > refValFromRetEffect	(	RetEffect	RE,
		QualType	ResultTy )

static

Definition at line 413 of file RetainCountChecker.cpp.

References clang::ento::RetEffect::getObjKind(), clang::ento::RetEffect::isOwned(), clang::ento::retaincountchecker::RefVal::makeNotOwned(), clang::ento::retaincountchecker::RefVal::makeOwned(), and clang::ento::RetEffect::notOwned().

Referenced by clang::ento::retaincountchecker::RetainCountChecker::checkSummary().

◆ removeRefBinding()

ProgramStateRef removeRefBinding	(	ProgramStateRef	State,
		SymbolRef	Sym )

static

Definition at line 42 of file RetainCountChecker.cpp.

Referenced by clang::ento::retaincountchecker::RetainCountChecker::checkRegionChanges(), clang::ento::retaincountchecker::RetainCountChecker::handleSymbolDeath(), clang::ento::retaincountchecker::RetainCountChecker::processSummaryOfInlined(), and clang::ento::retaincountchecker::RetainCountChecker::updateSymbol().

◆ setRefBinding()

ProgramStateRef setRefBinding	(	ProgramStateRef	State,
		SymbolRef	Sym,
		RefVal	Val )

static

Definition at line 36 of file RetainCountChecker.cpp.

◆ shouldEscapeOSArgumentOnCall()

bool shouldEscapeOSArgumentOnCall	(	const CallEvent &	CE,
		unsigned	ArgIdx,
		const RefVal *	TrackedValue )

static

Whether the tracked value should be escaped on a given call.

OSObjects are escaped when passed to void * / etc.

Definition at line 434 of file RetainCountChecker.cpp.

References clang::ento::retaincountchecker::RefVal::getObjKind(), isPointerToObject(), clang::ento::OS, and clang::ento::CallEvent::parameters().

Referenced by clang::ento::retaincountchecker::RetainCountChecker::checkSummary(), and clang::ento::retaincountchecker::RetainCountChecker::processSummaryOfInlined().

◆ shouldEscapeRegion()

bool shouldEscapeRegion	(	ProgramStateRef	State,
		const MemRegion *	R )

static

A value escapes in these possible cases:

binding to something that is not a memory region.
binding to a memregion that does not have stack storage
binding to a variable that has a destructor attached using CleanupAttr

We do not currently model what happens when a symbol is assigned to a struct field, unless it is a known smart pointer implementation, about which we know that it is inlined. FIXME: This could definitely be improved upon.

Definition at line 503 of file RetainCountChecker.cpp.

References clang::Decl::hasAttr(), clang::ento::MemRegion::hasMemorySpace(), and isSmartPtrField().

Referenced by clang::ento::retaincountchecker::RetainCountChecker::checkBind(), and updateOutParameters().