ILocatedInstruction
implements IInstruction| com.pnfsoftware.jeb.core.units.code.ILocatedInstruction |
 Known Indirect Subclasses
|
Class Overview
An addressable instruction.
Summary
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| abstract IFlowInformation |
collectIndirectCallReferences()
Collect the list of dereferenced addresses computed by a call-to-sub instruction.
| ||||||||||
| abstract IFlowInformation |
getBreakingFlow()
Determine if an instruction breaks the flow of execution.
| ||||||||||
| abstract long |
getOffset()
Get the instruction offset or address.
| ||||||||||
| abstract long |
getOffsetEnd()
Get the instruction address end (exclusive).
| ||||||||||
| abstract IFlowInformation |
getRoutineCall()
Determine if an instruction branches to (or calls into) a sub-routine.
| ||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
From interface
com.pnfsoftware.jeb.core.units.code.IInstruction
| |||||||||||
Public Methods
public abstract IFlowInformation collectIndirectCallReferences ()
Collect the list of dereferenced addresses computed by a call-to-sub instruction. This method
should not be confused with getRoutineCall(long).
Returns
isBroken()is true if the instruction indirectly calls into a sub-routine, false otherwise (in particular for direct routine calls); if true, thegetTargets()may be filled with the dereferenced addresses, else its contents is irrelevant
See Also
public abstract IFlowInformation getBreakingFlow ()
Determine if an instruction breaks the flow of execution. Examples: jump instructions,
conditional jumps, return-to-caller instructions, etc. Sub-routine calls should not be
regarded as flow-breakers by this method. Refer to getRoutineCall.
Returns
isBroken()is true if the instruction breaks the current flow of execution (sub-routine call instructions are excluded) , false otherwise; if true,getTargets()may be filled with potential addresses, and the first entry should be the fall-through instruction, if there is any
See Also
public abstract long getOffset ()
Get the instruction offset or address. The offset may be relative to a base, or absolute in the case of a memory address. The choice is up to the implementor.
Returns
- the instruction offset/address
public abstract long getOffsetEnd ()
Get the instruction address end (exclusive).
public abstract IFlowInformation getRoutineCall ()
Determine if an instruction branches to (or calls into) a sub-routine.
Under normal circumstances, those instructions save the return address (e.g., on a stack or
in a register). Therefore, the fall-through address is implied and should not be returned by
getTargets(). The list of targets should contain the branch address
- or addresses, for example if the processor branching instruction allows branch selection.
Returns
isBroken()is true if the instruction calls into a sub-routine, false otherwise; if true,getTargets()may be filled, else its contents is irrelevant