Provided by: gcj-4.6-jdk_4.6.3-1ubuntu2_amd64 bug


       gc-analyze - Analyze Garbage Collector (GC) memory dumps


       gc-analyze [OPTION] ... [file]


       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

       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);

       The memory dump may then be displayed by running:

               gc-analyze -v TestDump001


       -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

           Print a help message, then exit.

           Print version information, then exit.



       Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2010 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.3 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.