175 lines
6.3 KiB
HTML
175 lines
6.3 KiB
HTML
<HTML>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<!-- Created on November, 11 2002 by texi2html 1.64 -->
|
|
<!--
|
|
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
|
|
Karl Berry <karl@freefriends.org>
|
|
Olaf Bachmann <obachman@mathematik.uni-kl.de>
|
|
and many others.
|
|
Maintained by: Olaf Bachmann <obachman@mathematik.uni-kl.de>
|
|
Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
|
|
|
|
-->
|
|
<HEAD>
|
|
<TITLE>Debugging with GDB: Maintenance Commands</TITLE>
|
|
|
|
<META NAME="description" CONTENT="Debugging with GDB: Maintenance Commands">
|
|
<META NAME="keywords" CONTENT="Debugging with GDB: Maintenance Commands">
|
|
<META NAME="resource-type" CONTENT="document">
|
|
<META NAME="distribution" CONTENT="global">
|
|
<META NAME="Generator" CONTENT="texi2html 1.64">
|
|
|
|
</HEAD>
|
|
|
|
<BODY LANG="" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
|
|
|
|
<A NAME="SEC630"></A>
|
|
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
|
|
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_30.html#SEC629"> < </A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_32.html#SEC631"> > </A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_32.html#SEC631"> << </A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb.html#SEC_Top"> Up </A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_32.html#SEC631"> >> </A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb.html#SEC_Top">Top</A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_toc.html#SEC_Contents">Contents</A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_35.html#SEC643">Index</A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_abt.html#SEC_About"> ? </A>]</TD>
|
|
</TR></TABLE>
|
|
<H1> C. Maintenance Commands </H1>
|
|
<!--docid::SEC630::-->
|
|
<P>
|
|
|
|
In addition to commands intended for GDB users, GDB
|
|
includes a number of commands intended for GDB developers.
|
|
These commands are provided here for reference.
|
|
</P><P>
|
|
|
|
<DL COMPACT>
|
|
<A NAME="IDX1206"></A>
|
|
<A NAME="maint info breakpoints"></A>
|
|
<DT><CODE>maint info breakpoints</CODE>
|
|
<DD>Using the same format as <SAMP>`info breakpoints'</SAMP>, display both the
|
|
breakpoints you've set explicitly, and those GDB is using for
|
|
internal purposes. Internal breakpoints are shown with negative
|
|
breakpoint numbers. The type column identifies what kind of breakpoint
|
|
is shown:
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT><CODE>breakpoint</CODE>
|
|
<DD>Normal, explicitly set breakpoint.
|
|
<P>
|
|
|
|
<DT><CODE>watchpoint</CODE>
|
|
<DD>Normal, explicitly set watchpoint.
|
|
<P>
|
|
|
|
<DT><CODE>longjmp</CODE>
|
|
<DD>Internal breakpoint, used to handle correctly stepping through
|
|
<CODE>longjmp</CODE> calls.
|
|
<P>
|
|
|
|
<DT><CODE>longjmp resume</CODE>
|
|
<DD>Internal breakpoint at the target of a <CODE>longjmp</CODE>.
|
|
<P>
|
|
|
|
<DT><CODE>until</CODE>
|
|
<DD>Temporary internal breakpoint used by the GDB <CODE>until</CODE> command.
|
|
<P>
|
|
|
|
<DT><CODE>finish</CODE>
|
|
<DD>Temporary internal breakpoint used by the GDB <CODE>finish</CODE> command.
|
|
<P>
|
|
|
|
<DT><CODE>shlib events</CODE>
|
|
<DD>Shared library events.
|
|
<P>
|
|
|
|
</DL>
|
|
<P>
|
|
|
|
<A NAME="IDX1207"></A>
|
|
<A NAME="IDX1208"></A>
|
|
<DT><CODE>maint internal-error</CODE>
|
|
<DD><DT><CODE>maint internal-warning</CODE>
|
|
<DD>Cause GDB to call the internal function <CODE>internal_error</CODE>
|
|
or <CODE>internal_warning</CODE> and hence behave as though an internal error
|
|
or internal warning has been detected. In addition to reporting the
|
|
internal problem, these functions give the user the opportunity to
|
|
either quit GDB or create a core file of the current
|
|
GDB session.
|
|
<P>
|
|
|
|
<TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>(gdb) <KBD>maint internal-error testing, 1, 2</KBD>
|
|
<small>...</small>/maint.c:121: internal-error: testing, 1, 2
|
|
A problem internal to GDB has been detected. Further
|
|
debugging may prove unreliable.
|
|
Quit this debugging session? (y or n) <KBD>n</KBD>
|
|
Create a core file? (y or n) <KBD>n</KBD>
|
|
(gdb)
|
|
</FONT></pre></td></tr></table></P><P>
|
|
|
|
Takes an optional parameter that is used as the text of the error or
|
|
warning message.
|
|
</P><P>
|
|
|
|
<A NAME="IDX1209"></A>
|
|
<A NAME="IDX1210"></A>
|
|
<A NAME="IDX1211"></A>
|
|
<DT><CODE>maint print registers</CODE>
|
|
<DD><DT><CODE>maint print raw-registers</CODE>
|
|
<DD><DT><CODE>maint print cooked-registers</CODE>
|
|
<DD>Print GDB's internal register data structures.
|
|
<P>
|
|
|
|
The command <SAMP>`maint print raw-registers'</SAMP> includes the contents of
|
|
the raw register cache; and the command <SAMP>`maint print
|
|
cooked-registers'</SAMP> includes the (cooked) value of all registers.
|
|
See section `Registers' in <CITE>GDB Internals</CITE>.
|
|
</P><P>
|
|
|
|
Takes an optional file parameter.
|
|
</P><P>
|
|
|
|
</DL>
|
|
<P>
|
|
|
|
<A NAME="Remote Protocol"></A>
|
|
<HR SIZE="6">
|
|
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
|
|
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_32.html#SEC631"> << </A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_32.html#SEC631"> >> </A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb.html#SEC_Top">Top</A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_toc.html#SEC_Contents">Contents</A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_35.html#SEC643">Index</A>]</TD>
|
|
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_abt.html#SEC_About"> ? </A>]</TD>
|
|
</TR></TABLE>
|
|
<BR>
|
|
<FONT SIZE="-1">
|
|
|
|
<address>
|
|
|
|
<p>Please send FSF & GNU inquiries & questions to <a
|
|
href="mailto:gnu@gnu.org">gnu@gnu.org</a>. There are also <a
|
|
href="http://www.gnu.org/home.html#ContactInfo">other ways to
|
|
contact</a> the FSF.</p>
|
|
|
|
<p>These pages are maintained by <a
|
|
href="http://www.gnu.org/software/gdb/">the GDB developers</a>.</p>
|
|
|
|
<p>Copyright Free Software Foundation, Inc., 59 Temple Place - Suite
|
|
330, Boston, MA 02111, USA.</p>
|
|
|
|
<p>Verbatim copying and distribution of this entire article is
|
|
permitted in any medium, provided this notice is preserved.</p>
|
|
|
|
</address>
|
|
|
|
This document was generated
|
|
by <I>GDB Administrator</I> on <I>November, 11 2002</I>
|
|
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
|
|
"><I>texi2html</I></A>
|
|
|
|
</BODY>
|
|
</HTML>
|