Manual Reference Pages - DEVEL::MAT::DUMPER (3)
"Devel::MAT::Dumper" - write a heap dump file for later analysis
Devel::MAT::Dumper::dump( "path/to/the/file.pmat" );
This module provides the memory-dumping function that creates a heap dump file
which can later be read by Devel::MAT::Dumpfile. It provides a single
function which is not exported, which writes a file to the given path.
The dump file will contain a representation of every SV in Perls arena,
providing information about pointers between them, as well as other
information about the state of the process at the time it was created. It
contains a snapshot of the process at that moment in time, which can later be
loaded and analysed by various tools using Devel::MAT::Dumpfile.
The following import options control the behaviour of the module. They may
primarily be useful when used in the -M perl option:
Installs a handler for the special __DIE__ signal to write a dump file when
die() is about to cause a fatal signal. This is more reliable at catching
the callstack and memory state than using an END block.
$ perl -MDevel::MAT::Dumper=-dump_at_DIE ...
Installs an END block which writes a dump file at END time, just before
the interpreter exits.
$ perl -MDevel::MAT::Dumper=-dump_at_END ...
Installs a handler for SIGABRT to write a dump file if the signal is
received. After dumping the file, the signal handler is removed and the signal
$ perl -MDevel::MAT::Dumper=-dump_at_SIGABRT ...
Installs a handler for SIGQUIT to write a dump file if the signal is
received. The signal handler will remain in place and can be used several
$ perl -MDevel::MAT::Dumper=-dump_at_SIGQUIT ...
Sets the name of the file which is automatically dumped; defaults to basename
$0.pmat if not supplied.
$ perl -MDevel::MAT::Dumper=-file,foo.pmat ...
If the pattern contains NNN, this will be replaced by a unique serial
number per written file, starting from 0. This may be helpful in the case of
DIE or SIGQUIT handlers, which could be invoked multiple times.
Sets the maximum length of string buffer to dump from PVs; defaults to 256 if
not supplied. Use a negative size to dump the entire buffer of every PV
regardless of size.
Opens the dump file immediately at import time, instead of waiting until
the time it actually writes the heap dump. This may be useful if the process
changes working directory or user ID, or to debug problems involving too many
These functions are not exported, they must be called fully-qualified.
dump( $path )
Writes a heap dump to the named file
dumpfh( $fh )
Writes a heap dump to the given filehandle (which must be a plain OS-level
filehandle, though does not need to be a regular file, or seekable).
Paul Evans <firstname.lastname@example.org>
|perl v5.20.3 ||DEVEL::MAT::DUMPER (3) ||2016-04-03 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.