Command to set the root Action used by the decompiler or toggle output components. More...
#include <ghidra_process.hh>
Public Member Functions | |
| virtual void | rawAction (void) |
| Perform the action of the command. More... | |
 Public Member Functions inherited from GhidraCommand | |
| GhidraCommand (void) | |
| Construct given i/o streams. | |
| virtual | ~GhidraCommand (void) |
| Destructor. | |
| int4 | doit (void) |
| Configure and execute the command, then send back results. More... | |
Public Attributes | |
| bool | res |
| Set to true if the configuration action was successful. | |
Private Member Functions | |
| virtual void | loadParameters (void) |
| Read parameters directing command execution. More... | |
| virtual void | sendResult (void) |
| Send results of the command (if any) back to the Ghidra client. More... | |
Private Attributes | |
| string | actionstring |
| The root Action to switch to. | |
| string | printstring |
| The printing output configuration to toggle. | |
Additional Inherited Members | |
| Protected Attributes inherited from 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 set the root Action used by the decompiler or toggle output components.
The command expects 3 string parameters, the encoded integer id of the program being decompiled, the root action name, and the name of the output printing configuration. If the root action name is empty, no change is made to the root action. If the printing name is empty, no change is made to what gets output. The root action name can be:
- decompile – The main decompiler action
- normalize – Decompilation tuned for normalization
- jumptable – Simplify just enough to recover a jump-table
- paramid – Simplify enough to recover function parameters
- register – Perform one analysis pass on registers, without stack variables
- firstpass – Construct the initial raw syntax tree, with no simplification
The printing configuration can be:
- tree – Send data-flow and control-flow structures
- notree – Do not send data-flow and control-flow
- c – Send recovered source code
- noc – Do not send recovered source code
- parammeasures – Send parameter measures
- noparammeasures – Do not send parameter measures
- jumpload – Send addresses of jump-table entries, when recovering switch destinations
- nojumpload – Do not send addresses of jump-table entries
The command returns a single character message, 't' or 'f', indicating whether the action succeeded.
Member Function Documentation
|
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 GhidraCommand.
References GhidraCommand::loadParameters(), ArchitectureGhidra::readStringStream(), and GhidraCommand::sin.
|
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 GhidraCommand.
References Architecture::allacts, Architecture::flowoptions, GhidraCommand::ghidra, FlowInfo::record_jumploads, ActionDatabase::setCurrent(), ArchitectureGhidra::setSendCCode(), ArchitectureGhidra::setSendParamMeasures(), and ArchitectureGhidra::setSendSyntaxTree().
|
privatevirtual |
Send results of the command (if any) back to the Ghidra client.
This method sends any warnings accumulated during execution back, but it can be overloaded to send back any kind of information. Individual records are sent using the message protocol.
Reimplemented from GhidraCommand.
References GhidraCommand::GhidraCommand(), GhidraCommand::sendResult(), GhidraCommand::sout, and ArchitectureGhidra::writeStringStream().
The documentation for this class was generated from the following files:
- ghidra_process.hh
- ghidra_process.cc
