Package com.pnfsoftware.jeb.core.units.code.asm.decompiler.ir

Class EBranchDetails

java.lang.Object

com.pnfsoftware.jeb.core.units.code.asm.decompiler.ir.EBranchDetails

All Implemented Interfaces:

IEBranchDetails

@Ser
public class EBranchDetails
extends Object
implements IEBranchDetails

Standard implementation.

Constructor Summary

Constructors

Constructor	Description
EBranchDetails()
EBranchDetails(IEBranchDetails v)	Copy constructor.
EBranchDetails(List<IEVar> def, List<IEVar> use, List<IEVar> spoiled, int stackPointerDelta, IPrototypeItem nativePrototypeHint, List<IBranchTarget> dynamicTargetCandidates)

Method Summary

Modifier and Type	Method	Description
boolean	addCandidate(int index, IBranchTarget candidate)
boolean	addCandidate(IBranchTarget candidate)
boolean	addCandidates(List<? extends IBranchTarget> candidates)
boolean	equals(Object obj)
List<IEVar>	getDef()	Retrieve the list of defines.
List<IBranchTarget>	getDynamicTargetCandidates()	Retrieve the list of possible branch targets (may be N/A for the owner PC-assign).
IPrototypeItem	getNativePrototypeHint()
PreRoutineInvocationDetails	getPreInvocationDetails()	Get the pre-invocation details object, if one was set.
List<IEVar>	getSpoiled()	Retrieve the list of spoiled variables.
SPDC	getStackPointerDelta()	Convenience method.
SPDDeterminer	getStackPointerDeltaDeterminer()
int	getStackPointerDeltaValue()	Convenience method.
List<IEVar>	getUse()	Retrieve the list of uses.
int	hashCode()
boolean	isIncludeUnknownTarget()
boolean	setIncludeUnknownTarget(boolean include)
boolean	setNativePrototypeHint(IPrototypeItem hint)
boolean	setPreInvocationDetails(PreRoutineInvocationDetails details)	Set the optional pre-invocation details object.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

EBranchDetails

public EBranchDetails(List<IEVar> def,
 List<IEVar> use,
 List<IEVar> spoiled,
 int stackPointerDelta,
 IPrototypeItem nativePrototypeHint,
 List<IBranchTarget> dynamicTargetCandidates)

Parameters:

def -

use -

stackPointerDelta - initial (fallback) SP-delta value, recorded with unknown guarantee and origin

nativePrototypeHint - optional; if provided, can take precedence over stackPointerDelta

dynamicTargetCandidates - optional; if provided, can take precedence over nativePrototypeHint

EBranchDetails

public EBranchDetails()

EBranchDetails

public EBranchDetails(IEBranchDetails v)

Copy constructor.

Method Details

getDef

public List<IEVar> getDef()

Description copied from interface: IEBranchDetails

Retrieve the list of defines.

Specified by:

getDef in interface IEBranchDetails

Returns:

a read-only list

getUse

public List<IEVar> getUse()

Description copied from interface: IEBranchDetails

Retrieve the list of uses.

Specified by:

getUse in interface IEBranchDetails

Returns:

a read-only list

getSpoiled

public List<IEVar> getSpoiled()

Description copied from interface: IEBranchDetails

Retrieve the list of spoiled variables.

Specified by:

getSpoiled in interface IEBranchDetails

Returns:

a read-only list

getStackPointerDeltaDeterminer

public SPDDeterminer getStackPointerDeltaDeterminer()

Specified by:

getStackPointerDeltaDeterminer in interface IEBranchDetails

getStackPointerDelta

public SPDC getStackPointerDelta()

Description copied from interface: IEBranchDetails

Convenience method.

Specified by:

getStackPointerDelta in interface IEBranchDetails

Returns:

getStackPointerDeltaValue

public int getStackPointerDeltaValue()

Description copied from interface: IEBranchDetails

Convenience method.

Specified by:

getStackPointerDeltaValue in interface IEBranchDetails

Returns:

getDynamicTargetCandidates

public List<IBranchTarget> getDynamicTargetCandidates()

Description copied from interface: IEBranchDetails

Retrieve the list of possible branch targets (may be N/A for the owner PC-assign).

Specified by:

getDynamicTargetCandidates in interface IEBranchDetails

Returns:

a read-only list

addCandidate

public boolean addCandidate(IBranchTarget candidate)

Specified by:

addCandidate in interface IEBranchDetails

Returns:

true if the object was modified

addCandidate

public boolean addCandidate(int index,
 IBranchTarget candidate)

Specified by:

addCandidate in interface IEBranchDetails

Returns:

true if the object was modified

addCandidates

public boolean addCandidates(List<? extends IBranchTarget> candidates)

Specified by:

addCandidates in interface IEBranchDetails

Returns:

true if the object was modified

setIncludeUnknownTarget

public boolean setIncludeUnknownTarget(boolean include)

Specified by:

setIncludeUnknownTarget in interface IEBranchDetails

Returns:

true if the object was modified

isIncludeUnknownTarget

public boolean isIncludeUnknownTarget()

Specified by:

isIncludeUnknownTarget in interface IEBranchDetails

Returns:

getNativePrototypeHint

public IPrototypeItem getNativePrototypeHint()

Specified by:

getNativePrototypeHint in interface IEBranchDetails

Returns:

optional hint (if not null, the returned prototype should not be directly modified)

setNativePrototypeHint

public boolean setNativePrototypeHint(IPrototypeItem hint)

Specified by:

setNativePrototypeHint in interface IEBranchDetails

Returns:

true if the object was modified

getPreInvocationDetails

public PreRoutineInvocationDetails getPreInvocationDetails()

Description copied from interface: IEBranchDetails

Get the pre-invocation details object, if one was set.

Specified by:

getPreInvocationDetails in interface IEBranchDetails

Returns:

may be null

setPreInvocationDetails

public boolean setPreInvocationDetails(PreRoutineInvocationDetails details)

Description copied from interface: IEBranchDetails

Set the optional pre-invocation details object.

Specified by:

setPreInvocationDetails in interface IEBranchDetails

Returns:

true if the object was modified

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object