Back to index...

	/*
	* Copyright (c) 2005, 2008, Oracle and/or its affiliates. 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. Oracle designates this
	* particular file as subject to the "Classpath" exception as provided
	* by Oracle in the LICENSE file that accompanied this code.
	*
	* 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 Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
	* or visit www.oracle.com if you need additional information or have any
	* questions.
	*/

	/*
	* The Original Code is HAT. The Initial Developer of the
	* Original Code is Bill Foote, with contributions from others
	* at JavaSoft/Sun.
	*/

	package com.sun.tools.hat;

	import java.io.IOException;
	import java.io.File;

	import com.sun.tools.hat.internal.model.Snapshot;
	import com.sun.tools.hat.internal.model.ReachableExcludesImpl;
	import com.sun.tools.hat.internal.server.QueryListener;

	/**
	*
	* @author Bill Foote
	*/


	public class Main {

	private static String VERSION_STRING = "jhat version 2.0";

	private static void usage(String message) {
	if ( message != null ) {
	System.err.println("ERROR: " + message);
	}
	System.err.println("Usage: jhat [-stack <bool>] [-refs <bool>] [-port <port>] [-baseline <file>] [-debug <int>] [-version] [-h\|-help] <file>");
	System.err.println();
	System.err.println("\t-J<flag> Pass <flag> directly to the runtime system. For");
	System.err.println("\t\t\t example, -J-mx512m to use a maximum heap size of 512MB");
	System.err.println("\t-stack false: Turn off tracking object allocation call stack.");
	System.err.println("\t-refs false: Turn off tracking of references to objects");
	System.err.println("\t-port <port>: Set the port for the HTTP server. Defaults to 7000");
	System.err.println("\t-exclude <file>: Specify a file that lists data members that should");
	System.err.println("\t\t\t be excluded from the reachableFrom query.");
	System.err.println("\t-baseline <file>: Specify a baseline object dump. Objects in");
	System.err.println("\t\t\t both heap dumps with the same ID and same class will");
	System.err.println("\t\t\t be marked as not being \"new\".");
	System.err.println("\t-debug <int>: Set debug level.");
	System.err.println("\t\t\t 0: No debug output");
	System.err.println("\t\t\t 1: Debug hprof file parsing");
	System.err.println("\t\t\t 2: Debug hprof file parsing, no server");
	System.err.println("\t-version Report version number");
	System.err.println("\t-h\|-help Print this help and exit");
	System.err.println("\t<file> The file to read");
	System.err.println();
	System.err.println("For a dump file that contains multiple heap dumps,");
	System.err.println("you may specify which dump in the file");
	System.err.println("by appending \"#<number>\" to the file name, i.e. \"foo.hprof#3\".");
	System.err.println();
	System.err.println("All boolean options default to \"true\"");
	System.exit(1);
	}

	//
	// Convert s to a boolean. If it's invalid, abort the program.
	//
	private static boolean booleanValue(String s) {
	if ("true".equalsIgnoreCase(s)) {
	return true;
	} else if ("false".equalsIgnoreCase(s)) {
	return false;
	} else {
	usage("Boolean value must be true or false");
	return false; // Never happens
	}
	}

	public static void main(String[] args) {
	if (args.length < 1) {
	usage("No arguments supplied");
	}

	boolean parseonly = false;
	int portNumber = 7000;
	boolean callStack = true;
	boolean calculateRefs = true;
	String baselineDump = null;
	String excludeFileName = null;
	int debugLevel = 0;
	for (int i = 0; ; i += 2) {
	if (i > (args.length - 1)) {
	usage("Option parsing error");
	}
	if ("-version".equals(args[i])) {
	System.out.print(VERSION_STRING);
	System.out.println(" (java version " + System.getProperty("java.version") + ")");
	System.exit(0);
	}

	if ("-h".equals(args[i]) \|\| "-help".equals(args[i])) {
	usage(null);
	}

	if (i == (args.length - 1)) {
	break;
	}
	String key = args[i];
	String value = args[i+1];
	if ("-stack".equals(key)) {
	callStack = booleanValue(value);
	} else if ("-refs".equals(key)) {
	calculateRefs = booleanValue(value);
	} else if ("-port".equals(key)) {
	portNumber = Integer.parseInt(value, 10);
	} else if ("-exclude".equals(key)) {
	excludeFileName = value;
	} else if ("-baseline".equals(key)) {
	baselineDump = value;
	} else if ("-debug".equals(key)) {
	debugLevel = Integer.parseInt(value, 10);
	} else if ("-parseonly".equals(key)) {
	// Undocumented option. To be used for testing purpose only
	parseonly = booleanValue(value);
	}
	}
	String fileName = args[args.length - 1];
	Snapshot model = null;
	File excludeFile = null;
	if (excludeFileName != null) {
	excludeFile = new File(excludeFileName);
	if (!excludeFile.exists()) {
	System.out.println("Exclude file " + excludeFile
	+ " does not exist. Aborting.");
	System.exit(1);
	}
	}

	System.out.println("Reading from " + fileName + "...");
	try {
	model = com.sun.tools.hat.internal.parser.Reader.readFile(fileName, callStack, debugLevel);
	} catch (IOException ex) {
	ex.printStackTrace();
	System.exit(1);
	} catch (RuntimeException ex) {
	ex.printStackTrace();
	System.exit(1);
	}
	System.out.println("Snapshot read, resolving...");
	model.resolve(calculateRefs);
	System.out.println("Snapshot resolved.");

	if (excludeFile != null) {
	model.setReachableExcludes(new ReachableExcludesImpl(excludeFile));
	}

	if (baselineDump != null) {
	System.out.println("Reading baseline snapshot...");
	Snapshot baseline = null;
	try {
	baseline = com.sun.tools.hat.internal.parser.Reader.readFile(baselineDump, false,
	debugLevel);
	} catch (IOException ex) {
	ex.printStackTrace();
	System.exit(1);
	} catch (RuntimeException ex) {
	ex.printStackTrace();
	System.exit(1);
	}
	baseline.resolve(false);
	System.out.println("Discovering new objects...");
	model.markNewRelativeTo(baseline);
	baseline = null; // Guard against conservative GC
	}
	if ( debugLevel == 2 ) {
	System.out.println("No server, -debug 2 was used.");
	System.exit(0);
	}

	if (parseonly) {
	// do not start web server.
	System.out.println("-parseonly is true, exiting..");
	System.exit(0);
	}

	QueryListener listener = new QueryListener(portNumber);
	listener.setModel(model);
	Thread t = new Thread(listener, "Query Listener");
	t.setPriority(Thread.NORM_PRIORITY+1);
	t.start();
	System.out.println("Started HTTP server on port " + portNumber);
	System.out.println("Server is ready.");
	}
	}

Back to index...