Package ghidra.app.util.opinion

Class MapLoader

java.lang.Object

ghidra.app.util.opinion.AbstractProgramLoader

ghidra.app.util.opinion.AbstractLibrarySupportLoader

ghidra.app.util.opinion.MapLoader

All Implemented Interfaces:

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

public class MapLoader
extends AbstractLibrarySupportLoader

A Loader for processing Microsoft MAP files.

Sample .map file section we parse to extract symbol information:

   ...
   ...
   ...

   Address         Publics by Value              Rva+Base               Lib:Object
   
  0000:00000000       ___safe_se_handler_table   0000000000000000     <absolute>
  0000:00000000       ___safe_se_handler_count   0000000000000000     <absolute>
  0000:00000000       __ImageBase                0000000140000000     <linker-defined>
  0001:00000040       foo                        0000000140001040 f   foo.obj
  0001:000000c0       bar                        00000001400010c0 f   foo.obj
  
  ...
  ...
  ...
  

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	MAP_NAME
static java.lang.String	NO_MAGIC

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

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.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 prog, TaskMonitor monitor, MessageLog log)	Loads bytes in a particular format into the given Program.
boolean	supportsLoadIntoProgram()	Checks to see if this Loader supports loading into an existing Program.

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

createExportsFile, findAlreadyImportedLibrary, getDefaultOptions, getLoadSpec, getTier, getTierPriority, importLibrary, importLibrary, isCaseInsensitiveLibraryFilenames, loadProgram, loadProgramInto, postLoadProgramFixups, validateOptions

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

Field Detail

MAP_NAME

public static final java.lang.String MAP_NAME

See Also:

Constant Field Values

NO_MAGIC

public static final java.lang.String NO_MAGIC

See Also:

Constant Field Values

Constructor Detail

MapLoader

public MapLoader()

Method Detail

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 prog,
                 TaskMonitor monitor,
                 MessageLog log)
          throws java.io.IOException

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.

prog - 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.

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.

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.