Package com.pnfsoftware.jeb.core.units.code

Class CodePointer

java.lang.Object

com.pnfsoftware.jeb.core.units.code.Pointer

com.pnfsoftware.jeb.core.units.code.CodePointer

All Implemented Interfaces:

ICodePointer

@Ser
public class CodePointer
extends Pointer
implements ICodePointer

Standard implementation of a pointer to code.

Field Summary

Fields inherited from class com.pnfsoftware.jeb.core.units.code.Pointer

address, CODE, DATA, PTRCODE, PTRDATA, size, type, UNKNOWN

Constructor Summary

Constructors

Constructor	Description
CodePointer(long address)	Create an entry-point description using a default processor mode.
CodePointer(long address, int mode)	Create an entry-point address description.
CodePointer(ICodePointer src)	Create a code pointer from another pointer.

Method Summary

Modifier and Type	Method	Description
boolean	almostEquals(Object obj)	Equality that disregards the processor mode.
static CodePointer	createFrom(long internalAddress, INativeCodeModel<?> model)	Create a code pointer from an internal address and native code model.
static CodePointer	createFrom(INativeMethodDataItem routineData)	Create a code pointer from routine data.
static CodePointer	createFrom(INativeMethodItem routine)	Create a code pointer from a routine item.
static CodePointer	createFrom(ILocatedInstruction insn)	Create a code pointer from a located instruction.
static CodePointer	createFrom(String entryPointAsString)	Create a code pointer from its string representation.
static CodePointer	createUnknown()	Create an Entry Point Description pointing to an unknown address.
static CodePointer	createUnknown(int mode)	Create an Entry Point Description pointing to an unknown address.
boolean	equals(Object obj)
int	getMode()	Get the processor mode that should be used when parsing at the address.
int	hashCode()
boolean	isUnknownAddress()	Indicate if the entry-point relates to an unknown address
void	setMode(int mode)	Set the processor mode.
String	toString()	The returned format is 0xADDRESS(MODE) or simply 0xADDRESS for default mode.

Methods inherited from class com.pnfsoftware.jeb.core.units.code.Pointer

getAddress, getSize, getType, setSize

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.pnfsoftware.jeb.core.units.code.ICodePointer

getAddress

Constructor Details

CodePointer

public CodePointer(long address,
 int mode)

Create an entry-point address description.

Parameters:

address - address of the Entry point or -1 for unknown address.

mode - optional processor mode, can be IProcessor.MODE_DEFAULT (0) if unknown/default

CodePointer

public CodePointer(long address)

Create an entry-point description using a default processor mode.

Parameters:

address - address of the entry point or -1 for unknown address

CodePointer

public CodePointer(ICodePointer src)

Create a code pointer from another pointer.

Parameters:

src - source pointer

Method Details

hashCode

public int hashCode()

Overrides:

hashCode in class Pointer

equals

public boolean equals(Object obj)

Overrides:

equals in class Pointer

almostEquals

public boolean almostEquals(Object obj)

Equality that disregards the processor mode.

Parameters:

obj - object to compare

Returns:

true if the address and size match

getMode

public int getMode()

Get the processor mode that should be used when parsing at the address.

Specified by:

getMode in interface ICodePointer

Returns:

processor mode

setMode

public void setMode(int mode)

Set the processor mode.

Parameters:

mode - processor mode

isUnknownAddress

public boolean isUnknownAddress()

Description copied from interface: ICodePointer

Indicate if the entry-point relates to an unknown address

Specified by:

isUnknownAddress in interface ICodePointer

Returns:

true if address is unknown, false otherwise

toString

public String toString()

Description copied from interface: ICodePointer

The returned format is 0xADDRESS(MODE) or simply 0xADDRESS for default mode.

Specified by:

toString in interface ICodePointer

Overrides:

toString in class Pointer

Returns:

formatted pointer

createFrom

public static CodePointer createFrom(String entryPointAsString)

Create a code pointer from its string representation.

Parameters:

entryPointAsString - entry-point string

Returns:

code pointer

createFrom

public static CodePointer createFrom(long internalAddress,
 INativeCodeModel<?> model)

Create a code pointer from an internal address and native code model.

Parameters:

internalAddress - internal address

model - native code model

Returns:

code pointer

createFrom

public static CodePointer createFrom(ILocatedInstruction insn)

Create a code pointer from a located instruction.

Parameters:

insn - located instruction

Returns:

code pointer

createFrom

public static CodePointer createFrom(INativeMethodDataItem routineData)

Create a code pointer from routine data.

Parameters:

routineData - routine data

Returns:

code pointer

createFrom

public static CodePointer createFrom(INativeMethodItem routine)

Create a code pointer from a routine item.

Parameters:

routine - routine item

Returns:

code pointer

createUnknown

public static CodePointer createUnknown()

Create an Entry Point Description pointing to an unknown address.

Returns:

code pointer

createUnknown

public static CodePointer createUnknown(int mode)

Create an Entry Point Description pointing to an unknown address.

Parameters:

mode - processor mode

Returns:

code pointer