--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/agent/src/share/classes/sun/jvm/hotspot/tools/ObjectHistogram.java	Sat Dec 01 00:00:00 2007 +0000
@@ -0,0 +1,59 @@
+/*
+ * Copyright 2002-2005 Sun Microsystems, Inc.  All Rights Reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
+ * CA 95054 USA or visit www.sun.com if you need additional information or
+ * have any questions.
+ *
+ */
+
+package sun.jvm.hotspot.tools;
+
+import sun.jvm.hotspot.debugger.*;
+import sun.jvm.hotspot.oops.*;
+import sun.jvm.hotspot.runtime.*;
+import java.io.PrintStream;
+
+/** A sample tool which uses the Serviceability Agent's APIs to obtain
+    an object histogram from a remote or crashed VM. */
+public class ObjectHistogram extends Tool {
+
+   public void run() {
+      run(System.out, System.err);
+   }
+
+   public void run(PrintStream out, PrintStream err) {
+      // Ready to go with the database...
+      ObjectHeap heap = VM.getVM().getObjectHeap();
+      sun.jvm.hotspot.oops.ObjectHistogram histogram =
+        new sun.jvm.hotspot.oops.ObjectHistogram();
+      err.println("Iterating over heap. This may take a while...");
+      long startTime = System.currentTimeMillis();
+      heap.iterate(histogram);
+      long endTime = System.currentTimeMillis();
+      histogram.printOn(out);
+      float secs = (float) (endTime - startTime) / 1000.0f;
+      err.println("Heap traversal took " + secs + " seconds.");
+   }
+
+   public static void main(String[] args) {
+      ObjectHistogram oh = new ObjectHistogram();
+      oh.start(args);
+      oh.stop();
+   }
+}