Class MachoDumpReader

java.lang.Object

com.ibm.j9ddr.corereaders.AbstractCoreReader

com.ibm.j9ddr.corereaders.macho.MachoDumpReader

All Implemented Interfaces:

ICore, ILibraryDependentCore

public class MachoDumpReader
extends AbstractCoreReader
implements ILibraryDependentCore

This dump reader supports Mach-O core files generated on 64-bit macOS systems.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	MachoDumpReader.MachFile64
class	MachoDumpReader.MachHeader64
static final class	MachoDumpReader.OSXAArch64Thread
static final class	MachoDumpReader.OSXAMD64Thread
static class	MachoDumpReader.OSXThread

Field Summary

Fields

Modifier and Type	Field	Description
static final int	MH_BUNDLE
static final int	MH_CORE
static final int	MH_DSYM
static final int	MH_DYLIB
static final int	MH_DYLIB_STUB
static final int	MH_DYLINKER
static final int	MH_EXECUTE
static final int	MH_FVMLIB
static final int	MH_KEXT_BUNDLE
static final int	MH_OBJECT
static final int	MH_PRELOAD

Fields declared in class com.ibm.j9ddr.corereaders.AbstractCoreReader

_fileReader, _memoryRanges, coreFile

Fields declared in interface com.ibm.j9ddr.corereaders.ICore

CORE_CREATE_TIME_PROPERTY, PROCESSOR_COUNT_PROPERTY, PROCESSOR_SUBTYPE_PROPERTY, PROCESSOR_TYPE_PROPERTY, SYSTEM_SUBTYPE_PROPERTY, SYSTEM_TYPE_PROPERTY

Fields declared in interface com.ibm.j9ddr.corereaders.ILibraryDependentCore

SYSTEM_PROP_EXE_PATH

Constructor Summary

Constructors

Constructor	Description
MachoDumpReader(ImageInputStream in)

Method Summary

Modifier and Type	Method	Description
void	executablePathHint(String path)	Give the core reader a hint to the location of the executable.
Collection<? extends IAddressSpace>	getAddressSpaces()
String	getCommandLine()
String	getDumpFormat()	This is the dump format expressed as a string e.g. elf or xcoff.
IModule	getExecutable()
List<? extends IModule>	getModules()
Platform	getPlatform()
long	getProcessId()
Properties	getProperties()
static ICore	getReaderForFile(File f)
static ICore	getReaderForFile(ImageInputStream in)
int	getSignalNumber()
List<? extends IOSThread>	getThreads()
static boolean	isMACHO(byte[] data)
MachoDumpReader.MachHeader64	readHeader(long offset)
MachoDumpReader.MachFile64	readMachFile(long fileOffset)

Methods declared in class com.ibm.j9ddr.corereaders.AbstractCoreReader

checkOffset, close, format, format, readByte, readBytes, readFully, readFully, readInt, readInt, readLong, readLong, readShort, readString, seek, setReader

Methods declared in class java.lang.Object

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

Methods declared in interface com.ibm.j9ddr.corereaders.ICore

close, isTruncated

Field Details

MH_OBJECT

public static final int MH_OBJECT

See Also:

• Constant Field Values

MH_EXECUTE

public static final int MH_EXECUTE

See Also:

• Constant Field Values

MH_FVMLIB

public static final int MH_FVMLIB

See Also:

• Constant Field Values

MH_CORE

public static final int MH_CORE

See Also:

• Constant Field Values

MH_PRELOAD

public static final int MH_PRELOAD

See Also:

• Constant Field Values

MH_DYLIB

public static final int MH_DYLIB

See Also:

• Constant Field Values

MH_DYLINKER

public static final int MH_DYLINKER

See Also:

• Constant Field Values

MH_BUNDLE

public static final int MH_BUNDLE

See Also:

• Constant Field Values

MH_DYLIB_STUB

public static final int MH_DYLIB_STUB

See Also:

• Constant Field Values

MH_DSYM

public static final int MH_DSYM

See Also:

• Constant Field Values

MH_KEXT_BUNDLE

public static final int MH_KEXT_BUNDLE

See Also:

• Constant Field Values

Constructor Details

MachoDumpReader

public MachoDumpReader(ImageInputStream in)
                throws IOException,
InvalidDumpFormatException

Throws:

IOException

InvalidDumpFormatException

Method Details

isMACHO

public static boolean isMACHO(byte[] data)

getReaderForFile

public static ICore getReaderForFile(File f)
                              throws IOException,
InvalidDumpFormatException

Throws:

IOException

InvalidDumpFormatException

getReaderForFile

public static ICore getReaderForFile(ImageInputStream in)
                              throws IOException,
InvalidDumpFormatException

Throws:

IOException

InvalidDumpFormatException

getCommandLine

public String getCommandLine()
                      throws DataUnavailableException

Throws:

DataUnavailableException

getPlatform

public Platform getPlatform()

Specified by:

getPlatform in interface ICore

Returns:

Platform that created the dump

getDumpFormat

public String getDumpFormat()

Description copied from interface: ICore

This is the dump format expressed as a string e.g. elf or xcoff. It is recommended that this name is in lower case.

Specified by:

getDumpFormat in interface ICore

Returns:

getAddressSpaces

public Collection<? extends IAddressSpace> getAddressSpaces()

Specified by:

getAddressSpaces in interface ICore

Returns:

Address spaces held in this core dump

getProperties

public Properties getProperties()

Specified by:

getProperties in interface ICore

Returns:

Property set for this core

executablePathHint

public void executablePathHint(String path)

Description copied from interface: ILibraryDependentCore

Give the core reader a hint to the location of the executable. If it hasn't already found and loaded the libraries, may attempt to do so.

Specified by:

executablePathHint in interface ILibraryDependentCore

Parameters:

path -

getExecutable

public IModule getExecutable()

getModules

public List<? extends IModule> getModules()

getProcessId

public long getProcessId()

getThreads

public List<? extends IOSThread> getThreads()
                                     throws CorruptDataException

Throws:

CorruptDataException

getSignalNumber

public int getSignalNumber()
                    throws DataUnavailableException

Throws:

DataUnavailableException

readMachFile

public MachoDumpReader.MachFile64 readMachFile(long fileOffset)
                                        throws IOException,
InvalidDumpFormatException

Throws:

IOException

InvalidDumpFormatException

readHeader

public MachoDumpReader.MachHeader64 readHeader(long offset)
                                        throws IOException,
InvalidDumpFormatException

Throws:

IOException

InvalidDumpFormatException