Ghidra 11.3.2
Ghidra internal decompiler documentation.
Loading...
Searching...
No Matches
ghidra::ConsumeExtra Class Reference

Consume additional registers from an alternate resource list. More...

#include <modelrules.hh>

Inheritance diagram for ghidra::ConsumeExtra:
[legend]
Collaboration diagram for ghidra::ConsumeExtra:
[legend]

Public Member Functions

 ConsumeExtra (const ParamListStandard *res)
 Constructor for use with decode.
 
 ConsumeExtra (type_class store, bool match, const ParamListStandard *res)
 Constructor.
 
virtual AssignActionclone (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 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.
 
virtual bool fillinOutputMap (ParamActive *active) const
 Test if this action could produce return value storage matching the given set of trials.
 

Private Member Functions

void initializeEntries (void)
 Cache specific ParamEntry needed by the action.
 

Private Attributes

type_class resourceType
 The other resource list to consume from.
 
list< ParamEntry >::const_iterator firstIter
 Iterator to first element in the resource list.
 
bool matchSize
 false, if side-effect only consumes a single register
 

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 AssignActiondecodeAction (Decoder &decoder, const ParamListStandard *res)
 Read the next model rule action element from the stream.
 
static AssignActiondecodeSideeffect (Decoder &decoder, const ParamListStandard *res)
 Read the next model rule sideeffect element from the stream.
 
- Protected Attributes inherited from ghidra::AssignAction
const ParamListStandardresource
 Resources to which this action applies.
 
bool fillinOutputActive
 If true, fillinOutputMap is active.
 

Detailed Description

Consume additional registers from an alternate resource list.

This action is a side-effect and doesn't assign an address for the current parameter. The resource list, resourceType, is specified. If the side-effect is triggered, register resources from this list are consumed. If matchSize is true (the default), registers are consumed, until the number of bytes in the data-type is reached. Otherwise, only a single register is consumed. If all registers are already consumed, no action is taken.

Member Function Documentation

◆ assignAddress()

uint4 ghidra::ConsumeExtra::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
dtis the data-type of the parameter or return value
protois the high-level description of the function prototype
posis the position of the parameter (pos>=0) or return storage (pos=-1)
tlistis a data-type factory for (possibly) transforming the data-type
statusis the resource consumption array
reswill hold the resulting description of the parameter
Returns
the response code

Implements ghidra::AssignAction.

References firstIter, ghidra::ParamEntry::getAllGroups(), ghidra::ParamListStandard::getEntry(), ghidra::ParamEntry::getGroup(), ghidra::ParamEntry::getSize(), ghidra::Datatype::getSize(), ghidra::ParamEntry::getType(), ghidra::ParamEntry::isExclusion(), matchSize, ghidra::AssignAction::resource, resourceType, and ghidra::AssignAction::success.

◆ clone()

virtual AssignAction * ghidra::ConsumeExtra::clone ( const ParamListStandard newResource) const
inlinevirtual

Make a copy of this action.

Parameters
newResourceis the new resource object that will own the clone
Returns
the newly allocated copy

Implements ghidra::AssignAction.

References matchSize, and resourceType.

◆ decode()

void ghidra::ConsumeExtra::decode ( Decoder decoder)
virtual

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

Parameters
decoderis the given stream decoder

Implements ghidra::AssignAction.

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

◆ initializeEntries()

void ghidra::ConsumeExtra::initializeEntries ( void  )
private

Cache specific ParamEntry needed by the action.

Find the first ParamEntry matching the resourceType.

References firstIter, ghidra::ParamListStandard::getEntry(), ghidra::ParamListStandard::getFirstIter(), ghidra::AssignAction::resource, and resourceType.

Referenced by ConsumeExtra(), and decode().


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