Package ghidra.app.util.opinion

Class ElfLoader

java.lang.Object

ghidra.app.util.opinion.AbstractProgramLoader

ghidra.app.util.opinion.AbstractLibrarySupportLoader

ghidra.app.util.opinion.ElfLoader

All Implemented Interfaces:

Loader, ExtensionPoint, java.lang.Comparable<Loader>

public class ElfLoader
extends AbstractLibrarySupportLoader

A Loader for processing executable and linking files (ELF).

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	ELF_ENTRY_FUNCTION_NAME
static java.lang.String	ELF_FILE_TYPE_PROPERTY
static java.lang.String	ELF_NAME
static java.lang.String	ELF_ORIGINAL_IMAGE_BASE_PROPERTY
static java.lang.String	ELF_PRELINKED_PROPERTY
static java.lang.String	ELF_REQUIRED_LIBRARY_PROPERTY_PREFIX
static java.lang.String	ELF_SOURCE_FILE_PROPERTY_PREFIX

Fields inherited from class ghidra.app.util.opinion.AbstractLibrarySupportLoader

LIB_OPTION_NAME, SYM_OPTION_NAME

Fields inherited from class ghidra.app.util.opinion.AbstractProgramLoader

ANCHOR_LABELS_OPTION_NAME, APPLY_LABELS_OPTION_NAME

Fields inherited from interface ghidra.app.util.opinion.Loader

COMMAND_LINE_ARG_PREFIX

Constructor Summary

Constructors

Constructor	Description
ElfLoader()

Method Summary

Modifier and Type	Method	Description
java.util.Collection<LoadSpec>	findSupportedLoadSpecs(ByteProvider provider)	If this Loader supports loading the given ByteProvider, this methods returns a Collection of all supported LoadSpecs that contain discovered load specification information that this Loader will need to load.
java.util.List<Option>	getDefaultOptions(ByteProvider provider, LoadSpec loadSpec, DomainObject domainObject, boolean loadIntoProgram)	Gets the default Loader options.
static java.lang.Long	getElfOriginalImageBase(Program program)	Getter for the ELF_ORIGINAL_IMAGE_BASE_PROPERTY property.
java.lang.String	getName()	Gets the Loader's name, which is used both for display purposes, and to identify the Loader in the opinion files.
void	load(ByteProvider provider, LoadSpec loadSpec, java.util.List<Option> options, Program program, TaskMonitor monitor, MessageLog log)	Loads bytes in a particular format into the given Program.
protected void	postLoadProgramFixups(java.util.List<Program> importedPrograms, DomainFolder importFolder, java.util.List<Option> options, MessageLog messageLog, TaskMonitor monitor)	This gets called after the given list of Programs is finished loading.
java.lang.String	validateOptions(ByteProvider provider, LoadSpec loadSpec, java.util.List<Option> options, Program program)	Validates the Loader's options and returns null if all options are valid; otherwise, an error message describing the problem is returned.

Methods inherited from class ghidra.app.util.opinion.AbstractLibrarySupportLoader

createExportsFile, findAlreadyImportedLibrary, getLoadSpec, getTier, getTierPriority, importLibrary, importLibrary, isCaseInsensitiveLibraryFilenames, loadProgram, loadProgramInto

Methods inherited from class ghidra.app.util.opinion.AbstractProgramLoader

createDefaultMemoryBlocks, createProgram, generateBlockName, getLanguageService, load, loadInto, markAsFunction, release, shouldApplyProcessorLabelsByDefault

Methods inherited from class java.lang.Object

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

Methods inherited from interface ghidra.app.util.opinion.Loader

compareTo, getPreferredFileName, supportsLoadIntoProgram

Field Detail

ELF_NAME

public static final java.lang.String ELF_NAME

See Also:

Constant Field Values

ELF_ENTRY_FUNCTION_NAME

public static final java.lang.String ELF_ENTRY_FUNCTION_NAME

See Also:

Constant Field Values

ELF_FILE_TYPE_PROPERTY

public static final java.lang.String ELF_FILE_TYPE_PROPERTY

See Also:

Constant Field Values

ELF_ORIGINAL_IMAGE_BASE_PROPERTY

public static final java.lang.String ELF_ORIGINAL_IMAGE_BASE_PROPERTY

See Also:

Constant Field Values

ELF_PRELINKED_PROPERTY

public static final java.lang.String ELF_PRELINKED_PROPERTY

See Also:

Constant Field Values

ELF_REQUIRED_LIBRARY_PROPERTY_PREFIX

public static final java.lang.String ELF_REQUIRED_LIBRARY_PROPERTY_PREFIX

See Also:

Constant Field Values

ELF_SOURCE_FILE_PROPERTY_PREFIX

public static final java.lang.String ELF_SOURCE_FILE_PROPERTY_PREFIX

See Also:

Constant Field Values

Constructor Detail

ElfLoader

public ElfLoader()

Method Detail

getElfOriginalImageBase

public static java.lang.Long getElfOriginalImageBase(Program program)

Getter for the ELF_ORIGINAL_IMAGE_BASE_PROPERTY property.

Parameters:

program - Ghidra program that has the property to get

Returns:

Long value of the original image base, or null if the property is not present

getDefaultOptions

public java.util.List<Option> getDefaultOptions(ByteProvider provider,
                                                LoadSpec loadSpec,
                                                DomainObject domainObject,
                                                boolean loadIntoProgram)

Description copied from interface: Loader

Gets the default Loader options.

Specified by:

getDefaultOptions in interface Loader

Overrides:

getDefaultOptions in class AbstractLibrarySupportLoader

Parameters:

provider - The bytes of the thing being loaded.

loadSpec - The LoadSpec.

domainObject - The DomainObject being loaded.

loadIntoProgram - True if the load is adding to an existing DomainObject; otherwise, false.

Returns:

A list of the Loader's default options.

validateOptions

public java.lang.String validateOptions(ByteProvider provider,
                                        LoadSpec loadSpec,
                                        java.util.List<Option> options,
                                        Program program)

Description copied from interface: Loader

Validates the Loader's options and returns null if all options are valid; otherwise, an error message describing the problem is returned.

Specified by:

validateOptions in interface Loader

Overrides:

validateOptions in class AbstractLibrarySupportLoader

Parameters:

provider - The bytes of the thing being loaded.

loadSpec - The proposed LoadSpec.

options - The list of Options to validate.

program - existing program if the loader is adding to an existing program. If it is a fresh import, then this will be null.

Returns:

null if all Options are valid; otherwise, an error message describing the problem is returned.

findSupportedLoadSpecs

public java.util.Collection<LoadSpec> findSupportedLoadSpecs(ByteProvider provider)
                                                      throws java.io.IOException

Description copied from interface: Loader

If this Loader supports loading the given ByteProvider, this methods returns a Collection of all supported LoadSpecs that contain discovered load specification information that this Loader will need to load. If this Loader cannot support loading the given ByteProvider, an empty Collection is returned.

Parameters:

provider - The bytes being loaded.

Returns:

A Collection of LoadSpecs that this Loader supports loading, or an empty Collection if this Loader doesn't support loading the given ByteProvider.

Throws:

java.io.IOException - if there was an IO-related issue finding the LoadSpecs.

load

public void load(ByteProvider provider,
                 LoadSpec loadSpec,
                 java.util.List<Option> options,
                 Program program,
                 TaskMonitor monitor,
                 MessageLog log)
          throws java.io.IOException,
                 CancelledException

Description copied from class: AbstractLibrarySupportLoader

Loads bytes in a particular format into the given Program.

Specified by:

load in class AbstractLibrarySupportLoader

Parameters:

provider - The bytes to load.

loadSpec - The LoadSpec to use during load.

options - The load options.

program - The Program to load into.

monitor - A cancelable task monitor.

log - The message log.

Throws:

java.io.IOException - if there was an IO-related problem loading.

CancelledException - if the user cancelled the load.

postLoadProgramFixups

protected void postLoadProgramFixups(java.util.List<Program> importedPrograms,
                                     DomainFolder importFolder,
                                     java.util.List<Option> options,
                                     MessageLog messageLog,
                                     TaskMonitor monitor)
                              throws CancelledException,
                                     java.io.IOException

Description copied from class: AbstractProgramLoader

This gets called after the given list of Programs is finished loading. It provides subclasses an opportunity to do follow-on actions to the load.

Overrides:

postLoadProgramFixups in class AbstractLibrarySupportLoader

Parameters:

importedPrograms - The Programs that got loaded.

importFolder - The folder the programs were loaded to.

options - The load options.

messageLog - The message log.

monitor - A cancelable task monitor.

Throws:

CancelledException - if the user cancelled the load.

java.io.IOException - if there was an IO-related problem loading.

getName

public java.lang.String getName()

Description copied from interface: Loader

Gets the Loader's name, which is used both for display purposes, and to identify the Loader in the opinion files.

Returns:

The Loader's name.