| Documentation Contents

# Java Platform Debugger Architecture

Trace runs the Java language program passed as an argument and generates a trace of its execution. Trace is a simple command line tool that uses the Java Debug Interface (JDI). Programs need not be compiled for debugging since this information is not used.

Trace can be invoked as follows:

            java Trace options class args

Your classpath must include the Java 2 SDK's `lib/tools.jar` file which contains the JDI Library (see set-up), the path to the compiled trace class files, and the path for the application being traced.

Available options are:

      -output filename
            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

class is the program to trace. args are the arguments to class.

## Source for trace

Full source code for trace is included in the `trace` directory of `examples.jar`. Source code of these example application 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.

## Building trace

To completely rebuild the trace classes from the provided source files in the `trace` directory, you need only to compile them. No special options are required, aside from those which set your classpath to include the JDI Library in `lib/tools.jar`.

Copyright © 1993, 2010, Oracle and/or its affiliates. All rights reserved. Please send comments using this Feedback page. | Java Technology