ghidra::SignaturesAt Class Reference

Command to generate a feature vector from a function's data-flow and control-flow graphs. More...

#include <signature_ghidra.hh>

Inheritance diagram for ghidra::SignaturesAt:

Collaboration diagram for ghidra::SignaturesAt:

Public Member Functions
	SignaturesAt (bool dbg)
	Constructor specifying response format.
virtual void	rawAction (void)
	Perform the action of the command.
Public Member Functions inherited from ghidra::GhidraCommand
	GhidraCommand (void)
	Construct given i/o streams.
virtual	~GhidraCommand (void)
	Destructor.
int4	doit (void)
	Configure and execute the command, then send back results.

Private Member Functions
virtual void	loadParameters (void)
	Read parameters directing command execution.

Private Attributes
bool	debug
	True if the command should return verbose feature encodings.
Address	addr
	The entry point of the function to generate features for.

Additional Inherited Members
Protected Member Functions inherited from ghidra::GhidraCommand
virtual void	sendResult (void)
	Send results of the command (if any) back to the Ghidra client.
Protected Attributes inherited from ghidra::GhidraCommand
istream &	sin
	The input stream from the Ghidra client.
ostream &	sout
	The output stream to the Ghidra client.
ArchitectureGhidra *	ghidra
	The Architecture on which to perform the command.
int4	status
	Meta-command to system (0=wait for next command, 1=terminate process)

Detailed Description

Command to generate a feature vector from a function's data-flow and control-flow graphs.

The command expects to receive the entry point address of a function. The function is decompiled using the "normalize" simplification style. Then features are extracted from the resulting data-flow and control-flow graphs of the decompiled function. The features are returned to the Ghidra client. The command can be instantiated in two forms. One form returns a stream-lined encoding of the feature vector for more efficient transfers during normal operation. The other form returns more descriptive meta-data with the features and is suitable for debugging or exploring the feature generation process.

Member Function Documentation

loadParameters()

void ghidra::SignaturesAt::loadParameters ( void  )

privatevirtual

Read parameters directing command execution.

This method reads an id selecting the Architecture to act on, but it can be overloaded to read any set of data from the Ghidra client to configure how the command is executed. Individual parameters are read using the method protocol.

Reimplemented from ghidra::GhidraCommand.

References addr, ghidra::Address::decode(), ghidra::GhidraCommand::ghidra, ghidra::GhidraCommand::loadParameters(), ghidra::ArchitectureGhidra::readStringStream(), and ghidra::GhidraCommand::sin.

rawAction()

void ghidra::SignaturesAt::rawAction ( void  )

virtual

Perform the action of the command.

Configuration is assumed to have happened, and this object can immediately begin examining and manipulating data under the active Architecture object to perform the command.

Implements ghidra::GhidraCommand.

References addr, ghidra::Architecture::allacts, debug, ghidra::ActionDatabase::getCurrent(), ghidra::ActionDatabase::getCurrentName(), ghidra::Database::getGlobalScope(), ghidra::Address::getShortcut(), ghidra::GhidraCommand::ghidra, ghidra::Funcdata::isProcStarted(), ghidra::Action::perform(), ghidra::Address::printRaw(), ghidra::Scope::queryFunction(), ghidra::Action::reset(), ghidra::ActionDatabase::setCurrent(), ghidra::GhidraCommand::sout, and ghidra::Architecture::symboltab.

---

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

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