Package ghidra.app.util.opinion

Class BinaryLoader

java.lang.Object

ghidra.app.util.opinion.AbstractProgramLoader

ghidra.app.util.opinion.BinaryLoader

All Implemented Interfaces:

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

public class BinaryLoader
extends AbstractProgramLoader

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	BINARY_NAME
static java.lang.String	OPTION_NAME_BASE_ADDR
static java.lang.String	OPTION_NAME_BLOCK_NAME
static java.lang.String	OPTION_NAME_FILE_OFFSET
static java.lang.String	OPTION_NAME_IS_OVERLAY
static java.lang.String	OPTION_NAME_LEN

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
BinaryLoader()

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.
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.
LoaderTier	getTier()	For ordering purposes; lower tier numbers are more important (and listed first).
int	getTierPriority()	For ordering purposes; lower numbers are more important (and listed first, within its tier).
protected java.util.List<Program>	loadProgram(ByteProvider provider, java.lang.String programName, DomainFolder programFolder, LoadSpec loadSpec, java.util.List<Option> options, MessageLog log, java.lang.Object consumer, TaskMonitor monitor)	Loads program bytes in a particular format as a new Program.
protected boolean	loadProgramInto(ByteProvider provider, LoadSpec loadSpec, java.util.List<Option> options, MessageLog log, Program prog, TaskMonitor monitor)	Loads program bytes into the specified Program.
boolean	shouldApplyProcessorLabelsByDefault()	Returns whether or not processor labels should be applied by default.
boolean	supportsLoadIntoProgram()	Checks to see if this Loader supports loading into an existing Program.
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.AbstractProgramLoader

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

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

Field Detail

BINARY_NAME

public static final java.lang.String BINARY_NAME

See Also:

Constant Field Values

OPTION_NAME_LEN

public static final java.lang.String OPTION_NAME_LEN

See Also:

Constant Field Values

OPTION_NAME_FILE_OFFSET

public static final java.lang.String OPTION_NAME_FILE_OFFSET

See Also:

Constant Field Values

OPTION_NAME_BASE_ADDR

public static final java.lang.String OPTION_NAME_BASE_ADDR

See Also:

Constant Field Values

OPTION_NAME_BLOCK_NAME

public static final java.lang.String OPTION_NAME_BLOCK_NAME

See Also:

Constant Field Values

OPTION_NAME_IS_OVERLAY

public static final java.lang.String OPTION_NAME_IS_OVERLAY

See Also:

Constant Field Values

Constructor Detail

BinaryLoader

public BinaryLoader()

Method Detail

getTier

public LoaderTier getTier()

Description copied from interface: Loader

For ordering purposes; lower tier numbers are more important (and listed first).

Returns:

the tier of the loader

getTierPriority

public int getTierPriority()

Description copied from interface: Loader

For ordering purposes; lower numbers are more important (and listed first, within its tier).

Returns:

the ordering of the loader within its tier

supportsLoadIntoProgram

public boolean supportsLoadIntoProgram()

Description copied from interface: Loader

Checks to see if this Loader supports loading into an existing Program.

The default behavior of this method is to return false.

Returns:

True if this Loader supports loading into an existing Program; otherwise, false.

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.

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 AbstractProgramLoader

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.

loadProgram

protected java.util.List<Program> loadProgram(ByteProvider provider,
                                              java.lang.String programName,
                                              DomainFolder programFolder,
                                              LoadSpec loadSpec,
                                              java.util.List<Option> options,
                                              MessageLog log,
                                              java.lang.Object consumer,
                                              TaskMonitor monitor)
                                       throws java.io.IOException,
                                              CancelledException

Description copied from class: AbstractProgramLoader

Loads program bytes in a particular format as a new Program. Multiple Programs may end up getting created, depending on the nature of the format.

Specified by:

loadProgram in class AbstractProgramLoader

Parameters:

provider - The bytes to load.

programName - The name of the Program that's being loaded.

programFolder - The DomainFolder where the loaded thing should be saved. Could be null if the thing should not be pre-saved.

loadSpec - The LoadSpec to use during load.

options - The load options.

log - The message log.

consumer - A consumer object for Programs generated.

monitor - A cancelable task monitor.

Returns:

A list of loaded Programs (element 0 corresponds to primary loaded Program).

Throws:

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

CancelledException - if the user cancelled the load.

loadProgramInto

protected boolean loadProgramInto(ByteProvider provider,
                                  LoadSpec loadSpec,
                                  java.util.List<Option> options,
                                  MessageLog log,
                                  Program prog,
                                  TaskMonitor monitor)
                           throws java.io.IOException,
                                  CancelledException

Description copied from class: AbstractProgramLoader

Loads program bytes into the specified Program. This method will not create any new Programs. It is only for adding to an existing Program.

NOTE: The loading that occurs in this method will automatically be done in a transaction.

Specified by:

loadProgramInto in class AbstractProgramLoader

Parameters:

provider - The bytes to load into the Program.

loadSpec - The LoadSpec to use during load.

options - The load options.

log - The message log.

prog - The Program to load into.

monitor - A cancelable task monitor.

Returns:

True if the file was successfully loaded; otherwise, false.

Throws:

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

CancelledException - if the user cancelled the load.

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 AbstractProgramLoader

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.

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.

shouldApplyProcessorLabelsByDefault

public boolean shouldApplyProcessorLabelsByDefault()

Description copied from class: AbstractProgramLoader

Returns whether or not processor labels should be applied by default. Most loaders will not need to override this method because they will not want the labels applied by default.

Overrides:

shouldApplyProcessorLabelsByDefault in class AbstractProgramLoader

Returns:

Whether or not processor labels should be applied by default.