git.gag.com Git - fw/sdcc/blob - doc/sdccman.html/node54.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
   2
   3 <!--Converted with LaTeX2HTML 99.1 release (March 30, 1999)
   4 original version by:  Nikos Drakos, CBLU, University of Leeds
   5 * revised and updated by:  Marcus Hennecke, Ross Moore, Herb Swan
   6 * with significant contributions from:
   7   Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
   8 <HTML>
   9 <HEAD>
  10 <TITLE>7.5 Debugger Commands.</TITLE>
  11 <META NAME="description" CONTENT="7.5 Debugger Commands.">
  12 <META NAME="keywords" CONTENT="sdccman">
  13 <META NAME="resource-type" CONTENT="document">
  14 <META NAME="distribution" CONTENT="global">
  15
  16 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
  17 <META NAME="Generator" CONTENT="LaTeX2HTML v99.1 release">
  18 <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
  19
  20 <LINK REL="STYLESHEET" HREF="sdccman.css">
  21
  22 <LINK REL="next" HREF="node55.html">
  23 <LINK REL="previous" HREF="node53.html">
  24 <LINK REL="up" HREF="node49.html">
  25 <LINK REL="next" HREF="node55.html">
  26 </HEAD>
  27
  28 <BODY >
  29 <!--Navigation Panel-->
  30 <A NAME="tex2html1084"
  31  HREF="node55.html">
  32 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_motif.gif"></A>
  33 <A NAME="tex2html1078"
  34  HREF="node49.html">
  35 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up_motif.gif"></A>
  36 <A NAME="tex2html1072"
  37  HREF="node53.html">
  38 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="previous_motif.gif"></A>
  39 <A NAME="tex2html1080"
  40  HREF="node1.html">
  41 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents_motif.gif"></A>
  42 <A NAME="tex2html1082"
  43  HREF="node61.html">
  44 <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index_motif.gif"></A>
  45 <BR>
  46 <B> Next:</B> <A NAME="tex2html1085"
  47  HREF="node55.html">7.6 Interfacing with XEmacs.</A>
  48 <B> Up:</B> <A NAME="tex2html1079"
  49  HREF="node49.html">7. SDCDB - Source</A>
  50 <B> Previous:</B> <A NAME="tex2html1073"
  51  HREF="node53.html">7.4 Command Line Options.</A>
  52  &nbsp <B>  <A NAME="tex2html1081"
  53  HREF="node1.html">Contents</A></B>
  54  &nbsp <B>  <A NAME="tex2html1083"
  55  HREF="node61.html">Index</A></B>
  56 <BR>
  57 <BR>
  58 <!--End of Navigation Panel-->
  59 <!--Table of Child-Links-->
  60 <A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
  61
  62 <UL>
  63 <LI><A NAME="tex2html1086"
  64  HREF="node54.html#SECTION00085100000000000000">7.5.1 break [line | file:line | function | file:function]</A>
  65 <LI><A NAME="tex2html1087"
  66  HREF="node54.html#SECTION00085200000000000000">7.5.2 clear [line | file:line | function | file:function ]</A>
  67 <LI><A NAME="tex2html1088"
  68  HREF="node54.html#SECTION00085300000000000000">7.5.3 continue</A>
  69 <LI><A NAME="tex2html1089"
  70  HREF="node54.html#SECTION00085400000000000000">7.5.4 finish</A>
  71 <LI><A NAME="tex2html1090"
  72  HREF="node54.html#SECTION00085500000000000000">7.5.5 delete [n]</A>
  73 <LI><A NAME="tex2html1091"
  74  HREF="node54.html#SECTION00085600000000000000">7.5.6 info [break | stack | frame | registers ]</A>
  75 <LI><A NAME="tex2html1092"
  76  HREF="node54.html#SECTION00085700000000000000">7.5.7 step</A>
  77 <LI><A NAME="tex2html1093"
  78  HREF="node54.html#SECTION00085800000000000000">7.5.8 next</A>
  79 <LI><A NAME="tex2html1094"
  80  HREF="node54.html#SECTION00085900000000000000">7.5.9 run</A>
  81 <LI><A NAME="tex2html1095"
  82  HREF="node54.html#SECTION000851000000000000000">7.5.10 ptype variable </A>
  83 <LI><A NAME="tex2html1096"
  84  HREF="node54.html#SECTION000851100000000000000">7.5.11 print variable</A>
  85 <LI><A NAME="tex2html1097"
  86  HREF="node54.html#SECTION000851200000000000000">7.5.12 file filename</A>
  87 <LI><A NAME="tex2html1098"
  88  HREF="node54.html#SECTION000851300000000000000">7.5.13 frame</A>
  89 <LI><A NAME="tex2html1099"
  90  HREF="node54.html#SECTION000851400000000000000">7.5.14 set srcmode</A>
  91 <LI><A NAME="tex2html1100"
  92  HREF="node54.html#SECTION000851500000000000000">7.5.15 ! simulator command</A>
  93 <LI><A NAME="tex2html1101"
  94  HREF="node54.html#SECTION000851600000000000000">7.5.16 quit.</A>
  95 </UL>
  96 <!--End of Table of Child-Links-->
  97 <HR>
  98
  99 <H2><A NAME="SECTION00085000000000000000">
 100 7.5 Debugger Commands.</A>
 101 </H2>
 102
 103 <P>
 104 As mention earlier the command interface for the debugger has been
 105 deliberately kept as close the GNU debugger gdb, as possible. This
 106 will help the integration with existing graphical user interfaces
 107 (like ddd, xxgdb or xemacs) existing for the GNU debugger.
 108
 109 <P>
 110
 111 <H3><A NAME="SECTION00085100000000000000">
 112 7.5.1 break [line | file:line | function | file:function]</A>
 113 </H3>
 114
 115 <P>
 116 Set breakpoint at specified line or function:
 117 <BR>
 118
 119 <BR>
 120 <I><B>sdcdb&gt;break 100 </B></I>
 121 <BR>
 122 <I><B>sdcdb&gt;break foo.c:100</B></I>
 123 <BR>
 124 <I><B>sdcdb&gt;break funcfoo</B></I>
 125 <BR>
 126 <I><B>sdcdb&gt;break foo.c:funcfoo</B></I>
 127
 128 <P>
 129
 130 <H3><A NAME="SECTION00085200000000000000">
 131 7.5.2 clear [line | file:line | function | file:function ]</A>
 132 </H3>
 133
 134 <P>
 135 Clear breakpoint at specified line or function:
 136 <BR>
 137
 138 <BR>
 139 <I><B>sdcdb&gt;clear 100</B></I>
 140 <BR>
 141 <I><B>sdcdb&gt;clear foo.c:100</B></I>
 142 <BR>
 143 <I><B>sdcdb&gt;clear funcfoo</B></I>
 144 <BR>
 145 <I><B>sdcdb&gt;clear foo.c:funcfoo</B></I>
 146
 147 <P>
 148
 149 <H3><A NAME="SECTION00085300000000000000">
 150 7.5.3 continue</A>
 151 </H3>
 152
 153 <P>
 154 Continue program being debugged, after breakpoint.
 155
 156 <P>
 157
 158 <H3><A NAME="SECTION00085400000000000000">
 159 7.5.4 finish</A>
 160 </H3>
 161
 162 <P>
 163 Execute till the end of the current function.
 164
 165 <P>
 166
 167 <H3><A NAME="SECTION00085500000000000000">
 168 7.5.5 delete [n]</A>
 169 </H3>
 170
 171 <P>
 172 Delete breakpoint number 'n'. If used without any option clear ALL
 173 user defined break points.
 174
 175 <P>
 176
 177 <H3><A NAME="SECTION00085600000000000000">
 178 7.5.6 info [break | stack | frame | registers ]</A>
 179 </H3>
 180
 181 <P>
 182
 183 <UL>
 184 <LI>info break - list all breakpoints</LI>
 185 <LI>info stack - show the function call stack.</LI>
 186 <LI>info frame - show information about the current execution frame.</LI>
 187 <LI>info registers - show content of all registers.</LI>
 188 </UL>
 189
 190 <P>
 191
 192 <H3><A NAME="SECTION00085700000000000000">
 193 7.5.7 step</A>
 194 </H3>
 195
 196 <P>
 197 Step program until it reaches a different source line.
 198
 199 <P>
 200
 201 <H3><A NAME="SECTION00085800000000000000">
 202 7.5.8 next</A>
 203 </H3>
 204
 205 <P>
 206 Step program, proceeding through subroutine calls.
 207
 208 <P>
 209
 210 <H3><A NAME="SECTION00085900000000000000">
 211 7.5.9 run</A>
 212 </H3>
 213
 214 <P>
 215 Start debugged program.
 216
 217 <P>
 218
 219 <H3><A NAME="SECTION000851000000000000000">
 220 7.5.10 ptype variable </A>
 221 </H3>
 222
 223 <P>
 224 Print type information of the variable.
 225
 226 <P>
 227
 228 <H3><A NAME="SECTION000851100000000000000">
 229 7.5.11 print variable</A>
 230 </H3>
 231
 232 <P>
 233 print value of variable.
 234
 235 <P>
 236
 237 <H3><A NAME="SECTION000851200000000000000">
 238 7.5.12 file filename</A>
 239 </H3>
 240
 241 <P>
 242 load the given file name. Note this is an alternate method of loading
 243 file for debugging.
 244
 245 <P>
 246
 247 <H3><A NAME="SECTION000851300000000000000">
 248 7.5.13 frame</A>
 249 </H3>
 250
 251 <P>
 252 print information about current frame.
 253
 254 <P>
 255
 256 <H3><A NAME="SECTION000851400000000000000">
 257 7.5.14 set srcmode</A>
 258 </H3>
 259
 260 <P>
 261 Toggle between C source &amp; assembly source.
 262
 263 <P>
 264
 265 <H3><A NAME="SECTION000851500000000000000">
 266 7.5.15 ! simulator command</A>
 267 </H3>
 268
 269 <P>
 270 Send the string following '!' to the simulator, the simulator response
 271 is displayed. Note the debugger does not interpret the command being
 272 sent to the simulator, so if a command like 'go' is sent the debugger
 273 can loose its execution context and may display incorrect values.
 274
 275 <P>
 276
 277 <H3><A NAME="SECTION000851600000000000000">
 278 7.5.16 quit.</A>
 279 </H3>
 280
 281 <P>
 282
 283 &#34;Watch me now. Iam going Down. My name is Bobby Brown&#34;
 284
 285 <P>
 286 <HR>
 287 <!--Navigation Panel-->
 288 <A NAME="tex2html1084"
 289  HREF="node55.html">
 290 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_motif.gif"></A>
 291 <A NAME="tex2html1078"
 292  HREF="node49.html">
 293 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up_motif.gif"></A>
 294 <A NAME="tex2html1072"
 295  HREF="node53.html">
 296 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="previous_motif.gif"></A>
 297 <A NAME="tex2html1080"
 298  HREF="node1.html">
 299 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents_motif.gif"></A>
 300 <A NAME="tex2html1082"
 301  HREF="node61.html">
 302 <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index_motif.gif"></A>
 303 <BR>
 304 <B> Next:</B> <A NAME="tex2html1085"
 305  HREF="node55.html">7.6 Interfacing with XEmacs.</A>
 306 <B> Up:</B> <A NAME="tex2html1079"
 307  HREF="node49.html">7. SDCDB - Source</A>
 308 <B> Previous:</B> <A NAME="tex2html1073"
 309  HREF="node53.html">7.4 Command Line Options.</A>
 310  &nbsp <B>  <A NAME="tex2html1081"
 311  HREF="node1.html">Contents</A></B>
 312  &nbsp <B>  <A NAME="tex2html1083"
 313  HREF="node61.html">Index</A></B>
 314 <!--End of Navigation Panel-->
 315 <ADDRESS>
 316 <I>Johan Knol</I>
 317 <BR><I>2001-07-13</I>
 318 </ADDRESS>
 319 </BODY>
 320 </HTML>