Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / libcore / 319a3b994703aac84df7bcde272adfcb3cdbbbf0 / . / jdk / src / share / classes / com / sun / tools / example / doc / jdb.html
blob: a8232b0207d8c2c4cdeb47658dc2280c6f151469 [file] [log] [blame]
J. Duke319a3b92007-12-01 00:00:00 +0000[diff] [blame^]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&nbsp;
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>
21As a demonstration of the
22<A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/architecture.html">
23Java<sup><font size=-2>TM</font></sup> Platform Debugger Architecture</A>
24we are providing source code for the <b>jdb</b> debugger, which was
25re-written to use
26<A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/architecture.html#jdi">
27JDI</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>
38The <b>jdb</b> sample can be started by executing:
39<PRE>
40 java com.sun.tools.example.debug.tty.TTY &lt;options&gt;.. &lt;class-name&gt;
41</PRE>
42where &lt;class-name&gt; is the name you would normally
43place on the <code>java</code> command line. The <code>-help</code>
44option provides information on options.
45</P>
46<P>
47Note: the path to the <A HREF="index.html#SETUP">JDI Library</A> and to
48the compiled <b>jdb</b> class files must be on the class path
49used to invoke com.sun.tools.example.debug.tty.TTY.
50
51<p>
52For more information on invoking and connecting, refer to the
53<A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/conninv.html">
54Connection and Invocation Details</A> section of the
55<A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/">
56JPDA documentation</A>,
57particularly the section on <b>jdb</b>.
58<P>
59
60
61<H2>Source for jdb</H2>
62Full source code for <b>jdb</b> is included under the
63<code>debug</code> directory of <code>examples.jar</code>.
64Note: these directories also include the
65source for <a href="javadt.html"><code>javadt</code></a>.
66Source code for these example applications is included to provide concrete
67examples for debugger developers. Example code may be used, modified
68and redistributed by debugger developers providing they adhere to the
69terms 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>
82To completely rebuild the <b>jdb</b> classes from the
83provided source files under the <code>debug</code> directory,
84you need only to compile them. No special
85options are required, aside from those which set your classpath to
86include the <A HREF="index.html#SETUP">JDI Library</A>.
87</P>
88<P>
89However, 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/">
92JavaCC parser generator</a>.
93It is available free from
94<a
95href="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>