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>