blob: 0296ae48265aed7e2da440e63487268ba0e99532 [file] [log] [blame]
J. Duke319a3b92007-12-01 00:00:00 +00001<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
2<html>
3 <head>
4 <title>Example JDI Applications</title>
5 </head>
6<BODY BGCOLOR="#FFFFFF">
7 <h1>Example JDI Applications</h1>
8This example download contains the source code and
9documentation for three applications written using
10the Java<sup><font size=-2>TM</font></sup> Debug Interface (JDI)
11of the <A HREF="http://java.sun.com/products/jpda">Java Platform Debugger Architecture</A> (JPDA).
12They are provided as educational tools and as starting
13points for debugger development.
14<P>
15In increasing order of complexity:
16<UL>
17<LI><A HREF="trace.html">Trace</A> displays traces
18of program execution. It is very simple (less than 600 lines)
19yet uses most of the basic JDI functionality. It is a
20good starting point.
21<LI><A HREF="jdb.html">Jdb</A> is the command line debugger
22distributed with the J2SE SDK.
23<LI><A HREF="javadt.html">Javadt</A> is the beginnings of
24a GUI debugger.
25</UL>
26<P>
27Trace is in the <code>trace</code> directory.
28Jdb and Javadt share a package, and are under the
29<code>debug</code> directory.
30
31<A NAME="SETUP"><H2>Required Set-up</H2></A>
32
33<H4>Where is JPDA?</H4>
34New versions of the J2SE SDK have JPDA included. For
35older versions JPDA must be separately downloaded.
36<DL>
37 <DT>SDKs with JPDA included
38 <DD>J2SE SDK v1.3 and later and J2SE SDK for Linux v1.2.2
39 <DT>SDKs requiring JPDA download
40 <DD>J2SE SDK v1.2.1 and v1.2.2 for Solaris and Windows
41 <DT>Other SDKs
42 <DD>Check with vendor
43</DL>
44<P>
45<H4>Set-up for J2SE SDKs with JPDA included</H4>
46Your classpath must include the JDI Library code, which is
47in <code>tools.jar</code> in the <code>lib</code> directory.
48This is needed for both compiling the example code and
49executing it.
50<p>
51<H4>Set-up for J2SE SDKs without JPDA - Solaris</H4>
52Download JPDA v1.0 from
53<A HREF="http://java.sun.com/products/jpda">http://java.sun.com/products/jpda</A>. Follow the
54<A HREF="http://java.sun.com/products/jpda/installinst.html">Installation Instructions</A>
55found there. Pay particular attention to setting the library
56path.
57<P>
58Your classpath must include the JDI Library code, which is
59in <VAR>jpda_home</VAR>/<code>lib/tools.jar</code>.
60This is needed for both compiling the example code and
61executing it.
62<P>
63<H4>Set-up for J2SE SDKs without JPDA - Windows</H4>
64Download JPDA v1.0 from
65<A HREF="http://java.sun.com/products/jpda">http://java.sun.com/products/jpda</A>. Follow the
66<A HREF="http://java.sun.com/products/jpda/installinst.html">Installation Instructions</A>
67found there. Be sure to add:
68<PRE>
69 <VAR>jpda_home</VAR>\bin
70</PRE>
71to your path.
72<P>
73Your classpath must include the JDI Library code, which is
74in <VAR>jpda_home</VAR>\<code>lib\tools.jar</code>.
75This is needed for both compiling the example code and
76executing it.
77<P>
78 <hr>
79 <address><a href="mailto:java-debugger@java.sun.com">java-debugger@java.sun.com</a></address>
80 </P>
81<P>
82</P>
83<!-- Created: Mon Feb 7 18:56:28 PST 2000 -->
84</body>
85</html>