|
2
|
1 |
<HTML>
|
|
|
2 |
<HEAD>
|
|
|
3 |
<TITLE>Release notes for the jdb debugger</TITLE>
|
|
|
4 |
</HEAD>
|
|
|
5 |
<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000FF" VLINK="#000077" ALINK="#FF0000">
|
|
|
6 |
|
|
|
7 |
<TABLE BORDER=0 WIDTH="100%" >
|
|
|
8 |
<TR>
|
|
|
9 |
|
|
|
10 |
<TD>
|
|
|
11 |
<CENTER>
|
|
|
12 |
<H1>Release notes for the jdb debugger</H1></CENTER>
|
|
|
13 |
</TD>
|
|
|
14 |
</TR>
|
|
|
15 |
</TABLE>
|
|
|
16 |
<!-- Body text begins here -->
|
|
|
17 |
<P>
|
|
|
18 |
<A HREF="index.html">Home Page</A>
|
|
|
19 |
|
|
|
20 |
<P>
|
|
|
21 |
As a demonstration of the
|
|
|
22 |
<A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/architecture.html">
|
|
|
23 |
Java<sup><font size=-2>TM</font></sup> Platform Debugger Architecture</A>
|
|
|
24 |
we are providing source code for the <b>jdb</b> debugger, which was
|
|
|
25 |
re-written to use
|
|
|
26 |
<A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/architecture.html#jdi">
|
|
|
27 |
JDI</A>.
|
|
|
28 |
|
|
|
29 |
<P>
|
|
|
30 |
<H2><b>jdb</b> man pages</H2>
|
|
|
31 |
<BLOCKQUOTE>
|
|
|
32 |
<a href="http://java.sun.com/j2se/1.4/docs/tooldocs/win32/jdb.html"><font size="+1"><b>jdb</b> man pages for Windows</font></a>
|
|
|
33 |
<P>
|
|
|
34 |
<a href="http://java.sun.com/j2se/1.4/docs/tooldocs/solaris/jdb.html"><font size="+1"><b>jdb</b> man pages for Solaris</font></a>
|
|
|
35 |
</BLOCKQUOTE>
|
|
|
36 |
<P>
|
|
|
37 |
<H2>Invoking <b>jdb</b></H2>
|
|
|
38 |
The <b>jdb</b> sample can be started by executing:
|
|
|
39 |
<PRE>
|
|
|
40 |
java com.sun.tools.example.debug.tty.TTY <options>.. <class-name>
|
|
|
41 |
</PRE>
|
|
|
42 |
where <class-name> is the name you would normally
|
|
|
43 |
place on the <code>java</code> command line. The <code>-help</code>
|
|
|
44 |
option provides information on options.
|
|
|
45 |
</P>
|
|
|
46 |
<P>
|
|
|
47 |
Note: the path to the <A HREF="index.html#SETUP">JDI Library</A> and to
|
|
|
48 |
the compiled <b>jdb</b> class files must be on the class path
|
|
|
49 |
used to invoke com.sun.tools.example.debug.tty.TTY.
|
|
|
50 |
|
|
|
51 |
<p>
|
|
|
52 |
For more information on invoking and connecting, refer to the
|
|
|
53 |
<A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/conninv.html">
|
|
|
54 |
Connection and Invocation Details</A> section of the
|
|
|
55 |
<A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/">
|
|
|
56 |
JPDA documentation</A>,
|
|
|
57 |
particularly the section on <b>jdb</b>.
|
|
|
58 |
<P>
|
|
|
59 |
|
|
|
60 |
|
|
|
61 |
<H2>Source for jdb</H2>
|
|
|
62 |
Full source code for <b>jdb</b> is included under the
|
|
|
63 |
<code>debug</code> directory of <code>examples.jar</code>.
|
|
|
64 |
Note: these directories also include the
|
|
|
65 |
source for <a href="javadt.html"><code>javadt</code></a>.
|
|
|
66 |
Source code for these example applications is included to provide concrete
|
|
|
67 |
examples for debugger developers. Example code may be used, modified
|
|
|
68 |
and redistributed by debugger developers providing they adhere to the
|
|
|
69 |
terms in the COPYRIGHT notice.
|
|
|
70 |
<P>
|
|
|
71 |
<b>jdb</b> uses the following packages (found under the
|
|
|
72 |
<code>debug</code> directory):
|
|
|
73 |
<DL>
|
|
|
74 |
<DT><code>tty</code>
|
|
|
75 |
<DD>Application code
|
|
|
76 |
<DT><code>expr</code>
|
|
|
77 |
<DD>Expression processing code
|
|
|
78 |
</DL>
|
|
|
79 |
|
|
|
80 |
<P>
|
|
|
81 |
<H2>Building jdb</H2>
|
|
|
82 |
To completely rebuild the <b>jdb</b> classes from the
|
|
|
83 |
provided source files under the <code>debug</code> directory,
|
|
|
84 |
you need only to compile them. No special
|
|
|
85 |
options are required, aside from those which set your classpath to
|
|
|
86 |
include the <A HREF="index.html#SETUP">JDI Library</A>.
|
|
|
87 |
</P>
|
|
|
88 |
<P>
|
|
|
89 |
However, if you want to modify the expression parser in the file
|
|
|
90 |
<code>Expr.jj</code>, you will need the
|
|
|
91 |
<a href="http://www.metamata.com/javacc/">
|
|
|
92 |
JavaCC parser generator</a>.
|
|
|
93 |
It is available free from
|
|
|
94 |
<a
|
|
|
95 |
href="http://www.webgain.com/products/metamata/java_doc.html">Metamata
|
|
|
96 |
(now part of WebGain)</a>.
|
|
|
97 |
<P>
|
|
|
98 |
<hr>
|
|
|
99 |
<address><a href="mailto:java-debugger@java.sun.com">java-debugger@java.sun.com</a></address>
|
|
|
100 |
</P>
|
|
|
101 |
<P>
|
|
|
102 |
</P>
|
|
|
103 |
</BODY>
|
|
|
104 |
</HTML>
|