Package ghidra.app.util.bin.format.dwarf.funcfixup

Interface DWARFFunctionFixup

All Superinterfaces:

ExtensionPoint

All Known Implementing Classes:

GolangDWARFFunctionFixup, OutputParamCheckDWARFFunctionFixup, ParamNameDWARFFunctionFixup, ParamSpillDWARFFunctionFixup, RustDWARFFunctionFixup, SanityCheckDWARFFunctionFixup, StorageVerificationDWARFFunctionFixup, ThisCallingConventionDWARFFunctionFixup

public interface DWARFFunctionFixup
extends ExtensionPoint

Interface for add-in logic to fix/modify/tweak DWARF functions before they are written to the Ghidra program.

Use @ExtensionPointProperties(priority = DWARFFunctionFixup.PRIORITY_*) to control the order of evaluation (higher numbers are run earlier).

Fixups are found using ClassSearcher, and their class names must end in "DWARFFunctionFixup" (see ExtensionPoint.manifest).

Instance lifetime:

New instances are not shared between programs or analysis sessions, but will be re-used to handle the various functions found in a single binary.

If the implementation also implements Closeable, it will be called when the fixup is no longer needed.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	PRIORITY_LAST
static final int	PRIORITY_NORMAL
static final int	PRIORITY_NORMAL_EARLY
static final int	PRIORITY_NORMAL_LATE

Method Summary

Modifier and Type	Method	Description
static List<DWARFFunctionFixup>	findFixups()	Return a list of all current fixups found in the classpath by ClassSearcher.
void	fixupDWARFFunction(DWARFFunction dfunc)	Called before a DWARFFunction is used to create a Ghidra Function.

Field Details

PRIORITY_NORMAL_EARLY

static final int PRIORITY_NORMAL_EARLY

See Also:

• Constant Field Values

PRIORITY_NORMAL

static final int PRIORITY_NORMAL

See Also:

• Constant Field Values

PRIORITY_NORMAL_LATE

static final int PRIORITY_NORMAL_LATE

See Also:

• Constant Field Values

PRIORITY_LAST

static final int PRIORITY_LAST

See Also:

• Constant Field Values

Method Details

fixupDWARFFunction

void fixupDWARFFunction(DWARFFunction dfunc)
                 throws DWARFException

Called before a DWARFFunction is used to create a Ghidra Function.

If processing of the function should terminate (and the function be skipped), throw a DWARFException.

Parameters:

dfunc - DWARFFunction info read from DWARF about the function

Throws:

DWARFException

findFixups

static List<DWARFFunctionFixup> findFixups()

Return a list of all current fixups found in the classpath by ClassSearcher.

Returns:

list of all current fixups found in the classpath