gc-analyze-4.2

Langue: en

Version: 2009-01-10 (ubuntu - 07/07/09)

Section: 1 (Commandes utilisateur)

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 (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007 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 the Invariant Sections being ``GNU General Public License'', 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.