Container class for PcodeOps associated with a single function. More...

#include <op.hh>

Public Member Functions
void	clear (void)
	Clear all PcodeOps from this container.

PcodeOp *	create (int4 inputs, const Address &pc)
	Create a PcodeOp with at a given Address. More...

PcodeOp *	create (int4 inputs, const SeqNum &sq)
	Create a PcodeOp with a given sequence number. More...

void	destroy (PcodeOp *op)
	Destroy/retire the given PcodeOp. More...

void	destroyDead (void)
	Destroy/retire all PcodeOps in the dead list.

void	changeOpcode (PcodeOp op, TypeOp newopc)
	Change the op-code for the given PcodeOp. More...

void	markAlive (PcodeOp *op)
	Mark the given PcodeOp as alive. More...

void	markDead (PcodeOp *op)
	Mark the given PcodeOp as dead. More...

void	insertAfterDead (PcodeOp op, PcodeOp prev)
	Insert the given PcodeOp after a point in the dead list. More...

void	moveSequenceDead (PcodeOp firstop, PcodeOp lastop, PcodeOp *prev)
	Move a sequence of PcodeOps to a point in the dead list. More...

void	markIncidentalCopy (PcodeOp firstop, PcodeOp lastop)
	Mark any COPY ops in the given range as incidental. More...

PcodeOp *	target (const Address &addr) const
	Find the first executing PcodeOp for a target address. More...

PcodeOp *	findOp (const SeqNum &num) const
	Find a PcodeOp by sequence number. More...

PcodeOp *	fallthru (const PcodeOp *op) const
	Find the PcodeOp considered a fallthru of the given PcodeOp. More...

PcodeOpTree::const_iterator	beginAll (void) const
	Start of all PcodeOps in sequence number order.

PcodeOpTree::const_iterator	endAll (void) const
	End of all PcodeOps in sequence number order.

PcodeOpTree::const_iterator	begin (const Address &addr) const
	Start of all PcodeOps at one Address.

PcodeOpTree::const_iterator	end (const Address &addr) const
	End of all PcodeOps at one Address.

list< PcodeOp * >::const_iterator	beginAlive (void) const
	Start of all PcodeOps marked as alive.

list< PcodeOp * >::const_iterator	endAlive (void) const
	End of all PcodeOps marked as alive.

list< PcodeOp * >::const_iterator	beginDead (void) const
	Start of all PcodeOps marked as dead.

list< PcodeOp * >::const_iterator	endDead (void) const
	End of all PcodeOps marked as dead.

list< PcodeOp * >::const_iterator	begin (OpCode opc) const
	Start of all PcodeOps sharing the given op-code.

list< PcodeOp * >::const_iterator	end (OpCode opc) const
	End of all PcodeOps sharing the given op-code.

Detailed Description

Container class for PcodeOps associated with a single function.

The PcodeOp objects are maintained under multiple different sorting criteria to facilitate quick access in various situations. The main sort (PcodeOpTree) is by sequence number (SeqNum). PcodeOps are also grouped into alive and dead lists to distinguish between raw p-code ops and those that are fully linked into control-flow. Several lists group PcodeOps with important op-codes (like STORE and RETURN).

Member Function Documentation

◆ changeOpcode()

void PcodeOpBank::changeOpcode	(	PcodeOp *	op,
		TypeOp *	newopc
	)

Change the op-code for the given PcodeOp.

The PcodeOp is assigned the new op-code, which may involve moving it between the internal op-code specific lists.

Parameters

op	is the given PcodeOp to change
newopc	is the new op-code object

◆ create() [1/2]

PcodeOp * PcodeOpBank::create	(	int4	inputs,
		const Address &	pc
	)

Create a PcodeOp with at a given Address.

A new PcodeOp is allocated with the indicated number of input slots, which start out empty. A sequence number is assigned, and the op is added to the end of the dead list.

Parameters

inputs	is the number of input slots
pc	is the Address to associate with the PcodeOp

Returns: the newly allocated PcodeOp

◆ create() [2/2]

PcodeOp * PcodeOpBank::create	(	int4	inputs,
		const SeqNum &	sq
	)

Create a PcodeOp with a given sequence number.

A new PcodeOp is allocated with the indicated number of input slots and the specific sequence number, suitable for cloning and restoring from XML. The op is added to the end of the dead list.

Parameters

inputs	is the number of input slots
sq	is the specified sequence number

Returns: the newly allocated PcodeOp

◆ destroy()

void PcodeOpBank::destroy ( PcodeOp * op )

Destroy/retire the given PcodeOp.

The given PcodeOp is removed from all internal lists and added to a final deadandgone list. The memory is not reclaimed until the whole container is destroyed, in case pointer references still exist. These will all still be marked as dead.

Parameters

op	is the given PcodeOp to destroy

◆ fallthru()

PcodeOp * PcodeOpBank::fallthru ( const PcodeOp * op ) const

Find the PcodeOp considered a fallthru of the given PcodeOp.

The term fallthru in this context refers to p-code not assembly instructions.

Parameters

op	is the given PcodeOp

Returns: the fallthru PcodeOp

◆ findOp()

PcodeOp * PcodeOpBank::findOp ( const SeqNum & num ) const

Find a PcodeOp by sequence number.

Parameters

num	is the given sequence number

Returns: the matching PcodeOp (or NULL)

◆ insertAfterDead()

void PcodeOpBank::insertAfterDead	(	PcodeOp *	op,
		PcodeOp *	prev
	)

Insert the given PcodeOp after a point in the dead list.

The op is moved to right after a specified op in the dead list.

Parameters

op	is the given PcodeOp to move
prev	is the specified op in the dead list

◆ markAlive()

void PcodeOpBank::markAlive ( PcodeOp * op )

Mark the given PcodeOp as alive.

The PcodeOp is moved out of the dead list into the alive list. The PcodeOp::isDead() method will now return false.

Parameters

op	is the given PcodeOp to mark

◆ markDead()

void PcodeOpBank::markDead ( PcodeOp * op )

Mark the given PcodeOp as dead.

The PcodeOp is moved out of the alive list into the dead list. The PcodeOp::isDead() method will now return true.

Parameters

op	is the given PcodeOp to mark

◆ markIncidentalCopy()

void PcodeOpBank::markIncidentalCopy	(	PcodeOp *	firstop,
		PcodeOp *	lastop
	)

Mark any COPY ops in the given range as incidental.

Incidental COPYs are not considered active use of parameter passing Varnodes by parameter analysis algorithms.

Parameters

firstop	is the start of the range of incidental COPY ops
lastop	is the end of the range of incidental COPY ops

◆ moveSequenceDead()

void PcodeOpBank::moveSequenceDead	(	PcodeOp *	firstop,
		PcodeOp *	lastop,
		PcodeOp *	prev
	)

Move a sequence of PcodeOps to a point in the dead list.

The point is right after a provided op. All ops must be in the dead list.

Parameters

firstop	is the first PcodeOp in the sequence to be moved
lastop	is the last PcodeOp in the sequence to be moved
prev	is the provided point to move to

◆ target()

PcodeOp * PcodeOpBank::target ( const Address & addr ) const

Find the first executing PcodeOp for a target address.

Find the first PcodeOp at or after the given Address assuming they have not yet been broken up into basic blocks. Take into account delay slots.

Parameters

addr	is the given Address

Returns: the targeted PcodeOp (or NULL)

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

op.hh
op.cc

Public Member Functions

Detailed Description

Member Function Documentation

◆ changeOpcode()

◆ create() [1/2]

◆ create() [2/2]

◆ destroy()

◆ fallthru()

◆ findOp()

◆ insertAfterDead()

◆ markAlive()

◆ markDead()

◆ markIncidentalCopy()

◆ moveSequenceDead()

◆ target()