Package ghidra.pcode.emulate

Class EmulateMemoryStateBuffer

java.lang.Object

ghidra.pcode.emulate.EmulateMemoryStateBuffer

All Implemented Interfaces:

MemBuffer

public class EmulateMemoryStateBuffer
extends Object
implements MemBuffer

MemoryStateBuffer provides a MemBuffer for instruction parsing use which wraps an emulator MemoryState. This implementation wraps all specified memory offsets within the associated address space.

Constructor Summary

Constructors

Constructor	Description
EmulateMemoryStateBuffer(MemoryState memState, Address addr)

Method Summary

Modifier and Type	Method	Description
Address	getAddress()	Get the Address which corresponds to the offset 0.
BigInteger	getBigInteger(int offset, int size, boolean signed)	returns the value at the given offset, taking into account the endianness.
byte	getByte(int offset)	Get one byte from memory at the current position plus offset.
int	getBytes(byte[] b, int offset)	Reads b.length bytes from this memory buffer starting at the address of this memory buffer plus the given memoryBufferOffset from that position.
int	getInt(int offset)	returns the int at the given offset, taking into account the endianness.
long	getLong(int offset)	returns the long at the given offset, taking into account the endianness.
Memory	getMemory()	Get the Memory object actually used by the MemBuffer.
short	getShort(int offset)	returns the short at the given offset, taking into account the endianness.
boolean	isBigEndian()	Returns true if the underlying bytes are in big-endian order, false if they are little endian.
void	setAddress(Address addr)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface ghidra.program.model.mem.MemBuffer

getInputStream, getInputStream, getUnsignedByte, getUnsignedInt, getUnsignedShort, getVarLengthInt, getVarLengthUnsignedInt, isInitializedMemory

Constructor Details

EmulateMemoryStateBuffer

public EmulateMemoryStateBuffer(MemoryState memState,
 Address addr)

Method Details

setAddress

public void setAddress(Address addr)

getAddress

public Address getAddress()

Description copied from interface: MemBuffer

Get the Address which corresponds to the offset 0.

Specified by:

getAddress in interface MemBuffer

Returns:

the current address of offset 0.

getBigInteger

public BigInteger getBigInteger(int offset,
 int size,
 boolean signed)
                         throws MemoryAccessException

Description copied from interface: MemBuffer

returns the value at the given offset, taking into account the endianness.

Specified by:

getBigInteger in interface MemBuffer

Parameters:

offset - the offset from the membuffers origin (the address that it is set at)

size - the number of bytes to include in the value

signed - true if value should be treated as a signed twos-compliment value.

Returns:

the value at the given offset, taking into account the endianness.

Throws:

MemoryAccessException - if the request size value cannot be read at the specified offset

getBytes

public int getBytes(byte[] b,
 int offset)

Description copied from interface: MemBuffer

Reads b.length bytes from this memory buffer starting at the address of this memory buffer plus the given memoryBufferOffset from that position. The actual number of bytes may be fewer if bytes can't be read.

Specified by:

getBytes in interface MemBuffer

Parameters:

b - the buffer into which bytes will be placed

offset - the offset in this memory buffer from which to start reading bytes.

Returns:

the number of bytes read which may be fewer than b.length if available bytes are exhausted or no bytes are available at the specified offset.

getByte

public byte getByte(int offset)
             throws MemoryAccessException

Description copied from interface: MemBuffer

Get one byte from memory at the current position plus offset.

Specified by:

getByte in interface MemBuffer

Parameters:

offset - the displacement from the current position.

Returns:

the data at offset from the current position.

Throws:

MemoryAccessException - if memory cannot be read at the specified offset

getShort

public short getShort(int offset)
               throws MemoryAccessException

Description copied from interface: MemBuffer

returns the short at the given offset, taking into account the endianness.

Specified by:

getShort in interface MemBuffer

Parameters:

offset - the offset from the membuffers origin (the address that it is set at)

Returns:

the short at the given offset, taking into account the endianness.

Throws:

MemoryAccessException - if a 2-byte short value cannot be read at the specified offset

getInt

public int getInt(int offset)
           throws MemoryAccessException

Description copied from interface: MemBuffer

returns the int at the given offset, taking into account the endianness.

Specified by:

getInt in interface MemBuffer

Parameters:

offset - the offset from the membuffers origin (the address that it is set at)

Returns:

the int at the given offset, taking into account the endianness.

Throws:

MemoryAccessException - if a 4-byte integer value cannot be read at the specified offset

getLong

public long getLong(int offset)
             throws MemoryAccessException

Description copied from interface: MemBuffer

returns the long at the given offset, taking into account the endianness.

Specified by:

getLong in interface MemBuffer

Parameters:

offset - the offset from the membuffers origin (the address that it is set at)

Returns:

the long at the given offset, taking into account the endianness.

Throws:

MemoryAccessException - if a 8-byte long value cannot be read at the specified offset

getMemory

public Memory getMemory()

Description copied from interface: MemBuffer

Get the Memory object actually used by the MemBuffer.

Specified by:

getMemory in interface MemBuffer

Returns:

the Memory used by this MemBuffer or null if not available.

isBigEndian

public boolean isBigEndian()

Description copied from interface: MemBuffer

Returns true if the underlying bytes are in big-endian order, false if they are little endian.

Specified by:

isBigEndian in interface MemBuffer

Returns:

true if the underlying bytes are in big-endian order, false if they are little endian.