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

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, 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.