NAME
gc-analyze - Analyze Garbage Collector (GC) memory dumps
SYNOPSIS
gc-analyze [OPTION] ... [file]
DESCRIPTION
gc-analyze prints an analysis of a GC memory dump to standard out.
The memory dumps may be created by calling
"gnu.gcj.util.GCInfo.enumerate(String namePrefix)" from java code. A
memory dump will be created on an out of memory condition if
"gnu.gcj.util.GCInfo.setOOMDump(String namePrefix)" is called before
the out of memory occurs.
Running this program will create two files: TestDump001 and
TestDump001.bytes.
import gnu.gcj.util.*;
import java.util.*;
public class GCDumpTest
{
static public void main(String args[])
{
ArrayList<String> l = new ArrayList<String>(1000);
for (int i = 1; i < 1500; i++) {
l.add("This is string #" + i);
}
GCInfo.enumerate("TestDump");
}
}
The memory dump may then be displayed by running:
gc-analyze -v TestDump001
OPTIONS
--verbose
-v Verbose output.
-p tool-prefix
Prefix added to the names of the nm and readelf commands.
-d directory
Directory that contains the executable and shared libraries used
when the dump was generated.
--help
Print a help message, then exit.
--version
Print version information, then exit.
SEE ALSO
COPYRIGHT
Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free
Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no
Invariant Sections, the Front-Cover Texts being (a) (see below), and
with the Back-Cover Texts being (b) (see below). A copy of the license
is included in the man page gfdl(7).
(a) The FSF's Front-Cover Text is:
A GNU Manual
(b) The FSF's Back-Cover Text is:
You have freedom to copy and modify this GNU Manual, like GNU
software. Copies published by the Free Software Foundation raise
funds for GNU development.