Module openj9.dtfj

Package com.ibm.j9ddr.corereaders

Interface ICoreFileReader

All Known Implementing Classes:

AIXDumpReaderFactory, ELFDumpReaderFactory, MachoDumpReaderFactory, MiniDumpReader, TDumpReader

public interface ICoreFileReader

Interface for entities that can parse core dumps.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static enum	ICoreFileReader.DumpTestResult

Field Summary

Fields

Modifier and Type	Field	Description
static final String	J9DDR_CORE_READERS_LOGGER_NAME	This is the name of the java.util.logging.Logger subsystem to which the core readers pass verbose messages.

Method Summary

Modifier and Type	Method	Description
ICore	processDump(String path)	Called when a core reader should process the dump.
ICore	processDump(ImageInputStream in)	Called when a core reader should process the dump.
ICoreFileReader.DumpTestResult	testDump(String path)	Tests the dump described by the path for compatibility with this CoreFileReader.
ICoreFileReader.DumpTestResult	testDump(ImageInputStream in)	Tests the dump represented by the input stream for compatibility with this CoreFileReader.

Field Details

J9DDR_CORE_READERS_LOGGER_NAME

static final String J9DDR_CORE_READERS_LOGGER_NAME

This is the name of the java.util.logging.Logger subsystem to which the core readers pass verbose messages.

See Also:

• Constant Field Values

Method Details

testDump

ICoreFileReader.DumpTestResult testDump(String path)
                                 throws IOException

Tests the dump described by the path for compatibility with this CoreFileReader.

Parameters:

path - Path to dump file.

Throws:

IOException - If there was an IO problem reading the file (disk full etc.). Note that FileNotFound should be handled with DumpTestResult.

testDump

ICoreFileReader.DumpTestResult testDump(ImageInputStream in)
                                 throws IOException

Tests the dump represented by the input stream for compatibility with this CoreFileReader.

Parameters:

path - Path to dump file.

Throws:

IOException - If there was an IO problem reading the file (disk full etc.). Note that FileNotFound should be handled with DumpTestResult.

processDump

ICore processDump(String path)
           throws InvalidDumpFormatException,
IOException

Called when a core reader should process the dump. This allows lazy initialisation of the readers especially when they are not subsequently used.

Throws:

InvalidDumpFormatException

IOException

processDump

ICore processDump(ImageInputStream in)
           throws InvalidDumpFormatException,
IOException

Called when a core reader should process the dump. This allows lazy initialisation of the readers especially when they are not subsequently used.

Throws:

InvalidDumpFormatException

IOException