# HPROF Enhancement

###### Identifier:

org.eclipse.mat.hprof.enhancer

###### Since:

0.7.0

###### Description:

This extension point can be used to provide more details about the heap dump which are not contained in the HPROF format itself. For example, SAP has extended the Hotspot-based SAPJVM to write perm space information, OoM stack traces, interfaces and object generations whenever a HPROF dump is written.

###### Configuration Markup:

<!ELEMENT extension (enhancer)+>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED

>

<!ELEMENT enhancer EMPTY>

<!ATTLIST enhancer

parser CDATA #REQUIRED

runtime CDATA #REQUIRED

>

- parser - implementor of `org.eclipse.mat.hprof.extension.IParsingEnhancer` called during the parsing of the HPROF dump to add information
- runtime - implementor of `org.eclipse.mat.hprof.extension.IRuntimeEnhancer` called when analysing the dump

###### Examples:

Following is an example of a Hprof enhancer declaration:

       <extension point="org.eclipse.mat.hprof.enhancer">
          <enhancer parser="com.acme.HprofExtraParser"
                runtime="com.acme.HprofExtraRuntime" />
       </extension>

###### API Information:

The value of the parser attribute must represent an implementor of `org.eclipse.mat.hprof.extension.IParsingEnhancer`. The value of the runtime attribute must represent an implementor of `org.eclipse.mat.hprof.extension.IRuntimeEnhancer`.

###### Supplied Implementation:

No standard implementations are provided with Memory Analyzer from Eclipse.org.

Copyright (c) 2008,2011 SAP AG and IBM Corporation.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html