Devel::MAT - Perl Memory Analysis Tool
Devel::MAT instance loads a heapdump file, and provides a container to
store analysis tools to work on it. Tools may be provided that conform to the
Devel::MAT::Tool API, which can help analyse the data and interact with the
explorer user interface by using the methods in the Devel::MAT::UI package.
The dump file format is still under development, so at present no guarantees
are made on whether files can be loaded over mismatching versions of
Devel::MAT. However, as of version 0.11 the format should be more
extensible, allowing new SV fields to be added without breaking loading - older
tools will ignore new fields and newer tools will just load undef for fields
absent in older files. As the distribution approaches maturity the format will
be made more stable.
Loads a heap dump file from the given path, and returns a new
instance wrapping it.
Returns the underlying Devel::MAT::Dumpfile instance backing this analysis object.
Lists the Devel::MAT::Tool classes that are installed and available.
Loads the named Devel::MAT::Tool class.
Traces the tree of inrefs from
$sv back towards the known roots, returning
a Devel::MAT::Graph node object representing it, within a graph of reverse
references back to the known roots.
This method will load Devel::MAT::Tool::Inrefs if it isn't yet loaded.
The following named options are recognised:
strongwill follow only strong direct inrefs. Passing
directwill follow only direct inrefs.
Attempts to walk the symbol table looking for a symbol of the given name, which must include the sigil.
$Package::Name::symbol_name => to return a SCALAR SV @Package::Name::symbol_name => to return an ARRAY SV %Package::Name::symbol_name => to return a HASH SV &Package::Name::symbol_name => to return a CODE SV
Attempts to walk to the symbol table looking for a symbol of the given name,
GLOB object if found.
Paul Evans <email@example.com>