ghidra::GhidraStringManager Class Reference

Implementation of the StringManager that queries through the ghidra client. More...

#include <string_ghidra.hh>

Inheritance diagram for ghidra::GhidraStringManager:

Collaboration diagram for ghidra::GhidraStringManager:

Public Member Functions
	GhidraStringManager (ArchitectureGhidra *g, int4 max)
	Constructor.
virtual const vector< uint1 > &	getStringData (const Address &addr, Datatype *charType, bool &isTrunc)
	Retrieve string data at the given address as a UTF8 byte array.
Public Member Functions inherited from ghidra::StringManager
	StringManager (int4 max)
	Constructor.
virtual	~StringManager (void)
	Destructor.
void	clear (void)
	Clear out any cached strings.
bool	isString (const Address &addr, Datatype *charType)
uint8	registerInternalStringData (const Address &addr, const uint1 *buf, int4 size, Datatype *charType)
	Associate string data at a code address or other location that doesn't hold string data normally.
void	encode (Encoder &encoder) const
	Encode cached strings to a stream.
void	decode (Decoder &decoder)
	Restore string cache from a stream.

Private Attributes
ArchitectureGhidra *	glb
	The ghidra client interface.
uint1 *	testBuffer
	Temporary storage for storing bytes from client.

Additional Inherited Members
Static Public Member Functions inherited from ghidra::StringManager
static bool	hasCharTerminator (const uint1 *buffer, int4 size, int4 charsize)
	Check for a unicode string terminator.
static int4	readUtf16 (const uint1 *buf, bool bigend)
	Read a UTF16 code point from a byte array.
static void	writeUtf8 (ostream &s, int4 codepoint)
	Write unicode character to stream in UTF8 encoding.
static int4	checkCharacters (const uint1 *buf, int4 size, int4 charsize, bool bigend)
	Make sure buffer has valid bounded set of unicode.
static int4	getCodepoint (const uint1 *buf, int4 charsize, bool bigend, int4 &skip)
	Extract next unicode codepoint.
Protected Member Functions inherited from ghidra::StringManager
bool	writeUnicode (ostream &s, const uint1 *buffer, int4 size, int4 charsize, bool bigend)
	Translate/copy unicode to UTF8.
void	assignStringData (StringData &data, const uint1 *buf, int4 size, int4 charsize, int4 numChars, bool bigend)
	Translate and assign raw string data to a StringData object.
Static Protected Member Functions inherited from ghidra::StringManager
static uint8	calcInternalHash (const Address &addr, const uint1 *buf, int4 size)
	Calculate hash of a specific Address and contents of a byte array.
Protected Attributes inherited from ghidra::StringManager
map< Address, StringData >	stringMap
	Map from address to string data.
int4	maximumChars
	Maximum characters in a string before truncating.

Detailed Description

Implementation of the StringManager that queries through the ghidra client.

This acts as a front end to Ghidra's string formats and encodings. The client translates any type of string into a UTF8 representation, and this class stores it for final presentation. Escaping the UTF8 string is left up to the PrintLanguage.

Member Function Documentation

getStringData()

const vector< uint1 > & ghidra::GhidraStringManager::getStringData ( const Address &  addr, Datatype *  charType, bool &  isTrunc  )

virtual

Retrieve string data at the given address as a UTF8 byte array.

If the address does not represent string data, a zero length vector is returned. Otherwise, the string data is fetched, converted to a UTF8 encoding, cached and returned.

Parameters

addr	is the given address
charType	is a character data-type indicating the encoding
isTrunc	passes back whether the string is truncated

Returns

the byte array of UTF8 data

Implements ghidra::StringManager.

References ghidra::StringManager::StringData::byteData, ghidra::ArchitectureGhidra::getStringData(), glb, ghidra::StringManager::StringData::isTruncated, ghidra::StringManager::maximumChars, and ghidra::StringManager::stringMap.

---

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

• /builds/appsec/reveng-binrw/ghidraplusplus/src/ghidra/string_ghidra.hh
• /builds/appsec/reveng-binrw/ghidraplusplus/src/ghidra/string_ghidra.cc