ghidra::MultiMemberAssign Class Reference

Consume a register per primitive member of an aggregate data-type. More...

#include <modelrules.hh>

Inheritance diagram for ghidra::MultiMemberAssign:

Collaboration diagram for ghidra::MultiMemberAssign:

Public Member Functions
	MultiMemberAssign (type_class store, bool stack, bool mostSig, const ParamListStandard *res)
	Constructor.
virtual AssignAction *	clone (const ParamListStandard *newResource) const
	Make a copy of this action.
virtual uint4	assignAddress (Datatype *dt, const PrototypePieces &proto, int4 pos, TypeFactory &tlist, vector< int4 > &status, ParameterPieces &res) const
	Assign an address and other meta-data for a specific parameter or for return storage in context.
virtual bool	fillinOutputMap (ParamActive *active) const
	Test if this action could produce return value storage matching the given set of trials.
virtual void	decode (Decoder &decoder)
	Configure any details of how this action should behave from the stream.
Public Member Functions inherited from ghidra::AssignAction
	AssignAction (const ParamListStandard *res)
	Constructor.
bool	canAffectFillinOutput (void) const
	Return true if fillinOutputMap is active.

Private Attributes
type_class	resourceType
	Resource list from which to consume.
bool	consumeFromStack
	True if resources should be consumed from the stack.
bool	consumeMostSig
	True if resources are consumed starting with most significant bytes.

Additional Inherited Members
Public Types inherited from ghidra::AssignAction
enum	{   success , fail , no_assignment , hiddenret_ptrparam ,   hiddenret_specialreg , hiddenret_specialreg_void }
Static Public Member Functions inherited from ghidra::AssignAction
static AssignAction *	decodeAction (Decoder &decoder, const ParamListStandard *res)
	Read the next model rule action element from the stream.
static AssignAction *	decodeSideeffect (Decoder &decoder, const ParamListStandard *res)
	Read the next model rule sideeffect element from the stream.
Protected Attributes inherited from ghidra::AssignAction
const ParamListStandard *	resource
	Resources to which this action applies.
bool	fillinOutputActive
	If true, fillinOutputMap is active.

Detailed Description

Consume a register per primitive member of an aggregate data-type.

The data-type is split up into its underlying primitive elements, and each one is assigned a register from the specific resource list. There must be no padding between elements. No packing of elements into a single register occurs.

Member Function Documentation

assignAddress()

uint4 ghidra::MultiMemberAssign::assignAddress ( Datatype *  dt, const PrototypePieces &  proto, int4  pos, TypeFactory &  tlist, vector< int4 > &  status, ParameterPieces &  res  ) const

virtual

Assign an address and other meta-data for a specific parameter or for return storage in context.

The Address is assigned based on the data-type of the parameter, available register resources, and other details of the function prototype. Consumed resources are marked. This method returns a response code:

• success - indicating the Address was successfully assigned
• fail - if the Address could not be assigned
• hiddenret_ptrparam - if an additional hidden return parameter is required

Parameters

dt	is the data-type of the parameter or return value
proto	is the high-level description of the function prototype
pos	is the position of the parameter (pos>=0) or return storage (pos=-1)
tlist	is a data-type factory for (possibly) transforming the data-type
status	is the resource consumption array
res	will hold the resulting description of the parameter

Returns

the response code

Implements ghidra::AssignAction.

References ghidra::ParameterPieces::addr, ghidra::ParamListStandard::assignAddressFallback(), consumeFromStack, consumeMostSig, ghidra::PrimitiveExtractor::containsHoles(), ghidra::PrimitiveExtractor::containsUnknown(), ghidra::PrimitiveExtractor::Primitive::dt, ghidra::AssignAction::fail, ghidra::AddrSpaceManager::findAddJoin(), ghidra::ParameterPieces::flags, ghidra::PrimitiveExtractor::get(), ghidra::VarnodeData::getAddr(), ghidra::TypeFactory::getArch(), ghidra::Address::getOffset(), ghidra::Datatype::getSize(), ghidra::Address::getSpace(), ghidra::JoinRecord::getUnified(), ghidra::PrimitiveExtractor::isAligned(), ghidra::PrimitiveExtractor::isValid(), ghidra::AssignAction::resource, resourceType, ghidra::PrimitiveExtractor::size(), ghidra::AssignAction::success, and ghidra::ParameterPieces::type.

clone()

virtual AssignAction * ghidra::MultiMemberAssign::clone ( const ParamListStandard *  newResource ) const

inlinevirtual

Make a copy of this action.

Parameters

newResource

is the new resource object that will own the clone

Returns

the newly allocated copy

Implements ghidra::AssignAction.

References consumeFromStack, consumeMostSig, and resourceType.

decode()

void ghidra::MultiMemberAssign::decode ( Decoder &  decoder )

virtual

Configure any details of how this action should behave from the stream.

Parameters

decoder

is the given stream decoder

Implements ghidra::AssignAction.

References ghidra::Decoder::closeElement(), ghidra::Decoder::getNextAttributeId(), ghidra::Decoder::openElement(), ghidra::Decoder::readString(), and resourceType.

fillinOutputMap()

bool ghidra::MultiMemberAssign::fillinOutputMap ( ParamActive *  active ) const

virtual

Test if this action could produce return value storage matching the given set of trials.

If there is a return value data-type that could be assigned storage matching the trials by this action, return true. The trials have their matching ParamEntry and offset already set and are already sorted.

Parameters

active

is the given set of trials

Returns

true if the trials could form a valid return value

Reimplemented from ghidra::AssignAction.

References ghidra::ParamTrial::getEntry(), ghidra::ParamEntry::getGroup(), ghidra::ParamActive::getNumTrials(), ghidra::ParamTrial::getOffset(), ghidra::ParamActive::getTrial(), ghidra::ParamEntry::getType(), ghidra::ParamEntry::isFirstInClass(), and resourceType.

---

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

• /builds/appsec/reveng-binrw/ghidraplusplus/src/dec/modelrules.hh
• /builds/appsec/reveng-binrw/ghidraplusplus/src/dec/modelrules.cc