<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<TITLE>trace example</TITLE>
</HEAD>
<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000FF" VLINK="#000077" ALINK="#FF0000">
<H2>trace example</H2>
<B>Trace</B> runs the Java language program passed as an argument and
generates a trace of its execution. <B>Trace</B> is a simple command
line tool that uses the
<A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/architecture.html#jdi">
Java Debug Interface (JDI)</A>. Programs need
not be compiled for debugging since this information is not
used.
<P>
<B>Trace</B> can be invoked as follows:
<PRE>
java com.sun.tools.example.trace.Trace <i>options class args</i>
</PRE>
Your classpath must include the JDI Library
(see <A HREF="index.html#SETUP">set-up</A>),
the path to the compiled <b>trace</b> class files,
and the path for the application being traced.
<P>
Available <i>options</i> are:
<PRE>
-output <i>filename</i>
Set destination for output trace. By default output
goes to the terminal.
-all
Include system classes in output. By default
java.*, javax.*, sun.* and com.sun.* events are
not diplayed.
-fields
Also show assignments into fields.
-help
Print a help message
</PRE>
<i>class</i> is the program to trace. <i>args</i> are the arguments to <i>class</i>.
<P>
<H2>Source for trace</H2>
Full source code for <b>trace</b> is included in the
<code>trace</code> directory of <code>examples.jar</code>.
Source code for these example applications is included to provide concrete
examples for debugger developers. Example code may be used, modified
and redistributed by debugger developers providing they adhere to the
terms in the COPYRIGHT notice.
<P>
<H2>Building trace</H2>
To completely rebuild the <b>trace</b> classes from the
provided source files in the <code>trace</code> directory,
you need only to compile them. No special
options are required, aside from those which set your classpath to
include the <A HREF="index.html#SETUP">JDI Library</A>.
<P>
<hr>
<address><a href="mailto:java-debugger@java.sun.com">java-debugger@java.sun.com</a></address>
</P>
<P>
</P>
</BODY>
</HTML>