<HTML>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- Created on March, 27 2008 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: Controlling GDB</TITLE>
<META NAME="description" CONTENT="Debugging with GDB: Controlling GDB">
<META NAME="keywords" CONTENT="Debugging with GDB: Controlling GDB">
<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="SEC220"></A>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_19.html#SEC219"> < </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC221"> > </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_3.html#SEC6"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb.html#SEC_Top"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_21.html#SEC229"> >> </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_38.html#SEC764">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H1> 19. Controlling GDB </H1>
<!--docid::SEC220::-->
<P>
You can alter the way GDB interacts with you by using the
<CODE>set</CODE> command. For commands controlling how GDB displays
data, see <A HREF="gdb_9.html#SEC66">Print Settings</A>. Other settings are
described here.
</P><P>
<BLOCKQUOTE><TABLE BORDER=0 CELLSPACING=0>
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="gdb_20.html#SEC221">19.1 Prompt</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="gdb_20.html#SEC222">19.2 Command Editing</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Command editing</TD></TR>
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="gdb_20.html#SEC223">19.3 Command History</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Command history</TD></TR>
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="gdb_20.html#SEC224">19.4 Screen Size</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Screen size</TD></TR>
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="gdb_20.html#SEC225">19.5 Numbers</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="gdb_20.html#SEC226">19.6 Configuring the Current ABI</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Configuring the current ABI</TD></TR>
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="gdb_20.html#SEC227">19.7 Optional Warnings and Messages</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Optional warnings and messages</TD></TR>
<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="gdb_20.html#SEC228">19.8 Optional Messages about Internal Happenings</A></TD><TD> </TD><TD ALIGN="left" VALIGN="TOP">Optional messages about internal happenings</TD></TR>
</TABLE></BLOCKQUOTE>
<P>
<A NAME="Prompt"></A>
<HR SIZE="6">
<A NAME="SEC221"></A>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC220"> < </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC222"> > </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC220"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC220"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_21.html#SEC229"> >> </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_38.html#SEC764">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H2> 19.1 Prompt </H2>
<!--docid::SEC221::-->
<P>
<A NAME="IDX1103"></A>
</P><P>
GDB indicates its readiness to read a command by printing a string
called the <EM>prompt</EM>. This string is normally <SAMP>`(gdb)'</SAMP>. You
can change the prompt string with the <CODE>set prompt</CODE> command. For
instance, when debugging GDB with GDB, it is useful to change
the prompt in one of the GDB sessions so that you can always tell
which one you are talking to.
</P><P>
<EM>Note:</EM> <CODE>set prompt</CODE> does not add a space for you after the
prompt you set. This allows you to set a prompt which ends in a space
or a prompt that does not.
</P><P>
<DL COMPACT>
<A NAME="IDX1104"></A>
<DT><CODE>set prompt <VAR>newprompt</VAR></CODE>
<DD>Directs GDB to use <VAR>newprompt</VAR> as its prompt string henceforth.
<P>
<A NAME="IDX1105"></A>
<DT><CODE>show prompt</CODE>
<DD>Prints a line of the form: <SAMP>`Gdb's prompt is: <VAR>your-prompt</VAR>'</SAMP>
</DL>
<P>
<A NAME="Editing"></A>
<HR SIZE="6">
<A NAME="SEC222"></A>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC221"> < </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC223"> > </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC223"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC220"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_21.html#SEC229"> >> </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_38.html#SEC764">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H2> 19.2 Command Editing </H2>
<!--docid::SEC222::-->
<P>
GDB reads its input commands via the <EM>Readline</EM> interface. This
GNU library provides consistent behavior for programs which provide a
command line interface to the user. Advantages are GNU Emacs-style
or <EM>vi</EM>-style inline editing of commands, <CODE>csh</CODE>-like history
substitution, and a storage and recall of command history across
debugging sessions.
</P><P>
You may control the behavior of command line editing in GDB with the
command <CODE>set</CODE>.
</P><P>
<DL COMPACT>
<A NAME="IDX1106"></A>
<A NAME="IDX1107"></A>
<DT><CODE>set editing</CODE>
<DD><DT><CODE>set editing on</CODE>
<DD>Enable command line editing (enabled by default).
<P>
<DT><CODE>set editing off</CODE>
<DD>Disable command line editing.
<P>
<A NAME="IDX1108"></A>
<DT><CODE>show editing</CODE>
<DD>Show whether command line editing is enabled.
</DL>
<P>
See section <A HREF="gdb_28.html#SEC657">27. Command Line Editing</A>, for more details about the Readline
interface. Users unfamiliar with GNU Emacs or <CODE>vi</CODE> are
encouraged to read that chapter.
</P><P>
<A NAME="Command History"></A>
<HR SIZE="6">
<A NAME="SEC223"></A>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC222"> < </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC224"> > </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC224"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC220"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_21.html#SEC229"> >> </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_38.html#SEC764">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H2> 19.3 Command History </H2>
<!--docid::SEC223::-->
<P>
GDB can keep track of the commands you type during your
debugging sessions, so that you can be certain of precisely what
happened. Use these commands to manage the GDB command
history facility.
</P><P>
GDB uses the GNU History library, a part of the Readline
package, to provide the history facility. See section <A HREF="gdb_29.html#SEC679">28. Using History Interactively</A>, for the detailed description of the History library.
</P><P>
To issue a command to GDB without affecting certain aspects of
the state which is seen by users, prefix it with <SAMP>`server '</SAMP>
(see section <A HREF="gdb_26.html#SEC648">25.2 The Server Prefix</A>). This
means that this command will not affect the command history, nor will it
affect GDB's notion of which command to repeat if <KBD>RET</KBD> is
pressed on a line by itself.
</P><P>
<A NAME="IDX1109"></A>
The server prefix does not affect the recording of values into the value
history; to print a value without recording it into the value history,
use the <CODE>output</CODE> command instead of the <CODE>print</CODE> command.
</P><P>
Here is the description of GDB commands related to command
history.
</P><P>
<DL COMPACT>
<A NAME="IDX1110"></A>
<A NAME="IDX1111"></A>
<A NAME="IDX1112"></A>
<A NAME="IDX1113"></A>
<DT><CODE>set history filename <VAR>fname</VAR></CODE>
<DD>Set the name of the GDB command history file to <VAR>fname</VAR>.
This is the file where GDB reads an initial command history
list, and where it writes the command history from this session when it
exits. You can access this list through history expansion or through
the history command editing characters listed below. This file defaults
to the value of the environment variable <CODE>GDBHISTFILE</CODE>, or to
<TT>`./.gdb_history'</TT> (<TT>`./_gdb_history'</TT> on MS-DOS) if this variable
is not set.
<P>
<A NAME="IDX1114"></A>
<A NAME="IDX1115"></A>
<DT><CODE>set history save</CODE>
<DD><DT><CODE>set history save on</CODE>
<DD>Record command history in a file, whose name may be specified with the
<CODE>set history filename</CODE> command. By default, this option is disabled.
<P>
<DT><CODE>set history save off</CODE>
<DD>Stop recording command history in a file.
<P>
<A NAME="IDX1116"></A>
<A NAME="IDX1117"></A>
<A NAME="IDX1118"></A>
<DT><CODE>set history size <VAR>size</VAR></CODE>
<DD>Set the number of commands which GDB keeps in its history list.
This defaults to the value of the environment variable
<CODE>HISTSIZE</CODE>, or to 256 if this variable is not set.
</DL>
<P>
History expansion assigns special meaning to the character <KBD>!</KBD>.
See section <A HREF="gdb_29.html#SEC681">28.1.1 Event Designators</A>, for more details.
</P><P>
<A NAME="IDX1119"></A>
Since <KBD>!</KBD> is also the logical not operator in C, history expansion
is off by default. If you decide to enable history expansion with the
<CODE>set history expansion on</CODE> command, you may sometimes need to
follow <KBD>!</KBD> (when it is used as logical not, in an expression) with
a space or a tab to prevent it from being expanded. The readline
history facilities do not attempt substitution on the strings
<KBD>!=</KBD> and <KBD>!(</KBD>, even when history expansion is enabled.
</P><P>
The commands to control history expansion are:
</P><P>
<DL COMPACT>
<DT><CODE>set history expansion on</CODE>
<DD><DT><CODE>set history expansion</CODE>
<DD><A NAME="IDX1120"></A>
Enable history expansion. History expansion is off by default.
<P>
<DT><CODE>set history expansion off</CODE>
<DD>Disable history expansion.
<P>
<A NAME="IDX1121"></A>
<DT><CODE>show history</CODE>
<DD><DT><CODE>show history filename</CODE>
<DD><DT><CODE>show history save</CODE>
<DD><DT><CODE>show history size</CODE>
<DD><DT><CODE>show history expansion</CODE>
<DD>These commands display the state of the GDB history parameters.
<CODE>show history</CODE> by itself displays all four states.
</DL>
<P>
<DL COMPACT>
<A NAME="IDX1122"></A>
<A NAME="IDX1123"></A>
<A NAME="IDX1124"></A>
<DT><CODE>show commands</CODE>
<DD>Display the last ten commands in the command history.
<P>
<DT><CODE>show commands <VAR>n</VAR></CODE>
<DD>Print ten commands centered on command number <VAR>n</VAR>.
<P>
<DT><CODE>show commands +</CODE>
<DD>Print ten commands just after the commands last printed.
</DL>
<P>
<A NAME="Screen Size"></A>
<HR SIZE="6">
<A NAME="SEC224"></A>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC223"> < </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC225"> > </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC225"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC220"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_21.html#SEC229"> >> </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_38.html#SEC764">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H2> 19.4 Screen Size </H2>
<!--docid::SEC224::-->
<P>
Certain commands to GDB may produce large amounts of
information output to the screen. To help you read all of it,
GDB pauses and asks you for input at the end of each page of
output. Type <KBD>RET</KBD> when you want to continue the output, or <KBD>q</KBD>
to discard the remaining output. Also, the screen width setting
determines when to wrap lines of output. Depending on what is being
printed, GDB tries to break the line at a readable place,
rather than simply letting it overflow onto the following line.
</P><P>
Normally GDB knows the size of the screen from the terminal
driver software. For example, on Unix GDB uses the termcap data base
together with the value of the <CODE>TERM</CODE> environment variable and the
<CODE>stty rows</CODE> and <CODE>stty cols</CODE> settings. If this is not correct,
you can override it with the <CODE>set height</CODE> and <CODE>set
width</CODE> commands:
</P><P>
<DL COMPACT>
<A NAME="IDX1125"></A>
<A NAME="IDX1126"></A>
<A NAME="IDX1127"></A>
<A NAME="IDX1128"></A>
<DT><CODE>set height <VAR>lpp</VAR></CODE>
<DD><DT><CODE>show height</CODE>
<DD><DT><CODE>set width <VAR>cpl</VAR></CODE>
<DD><DT><CODE>show width</CODE>
<DD>These <CODE>set</CODE> commands specify a screen height of <VAR>lpp</VAR> lines and
a screen width of <VAR>cpl</VAR> characters. The associated <CODE>show</CODE>
commands display the current settings.
<P>
If you specify a height of zero lines, GDB does not pause during
output no matter how long the output is. This is useful if output is to a
file or to an editor buffer.
</P><P>
Likewise, you can specify <SAMP>`set width 0'</SAMP> to prevent GDB
from wrapping its output.
</P><P>
<DT><CODE>set pagination on</CODE>
<DD><DT><CODE>set pagination off</CODE>
<DD><A NAME="IDX1129"></A>
Turn the output pagination on or off; the default is on. Turning
pagination off is the alternative to <CODE>set height 0</CODE>.
<P>
<DT><CODE>show pagination</CODE>
<DD><A NAME="IDX1130"></A>
Show the current pagination mode.
</DL>
<P>
<A NAME="Numbers"></A>
<HR SIZE="6">
<A NAME="SEC225"></A>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC224"> < </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC226"> > </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC226"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC220"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_21.html#SEC229"> >> </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_38.html#SEC764">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H2> 19.5 Numbers </H2>
<!--docid::SEC225::-->
<P>
You can always enter numbers in octal, decimal, or hexadecimal in
GDB by the usual conventions: octal numbers begin with
<SAMP>`0'</SAMP>, decimal numbers end with <SAMP>`.'</SAMP>, and hexadecimal numbers
begin with <SAMP>`0x'</SAMP>. Numbers that neither begin with <SAMP>`0'</SAMP> or
<SAMP>`0x'</SAMP>, nor end with a <SAMP>`.'</SAMP> are, by default, entered in base
10; likewise, the default display for numbers--when no particular
format is specified--is base 10. You can change the default base for
both input and output with the commands described below.
</P><P>
<DL COMPACT>
<A NAME="IDX1131"></A>
<DT><CODE>set input-radix <VAR>base</VAR></CODE>
<DD>Set the default base for numeric input. Supported choices
for <VAR>base</VAR> are decimal 8, 10, or 16. <VAR>base</VAR> must itself be
specified either unambiguously or using the current input radix; for
example, any of
<P>
<TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>set input-radix 012
set input-radix 10.
set input-radix 0xa
</FONT></pre></td></tr></table></P><P>
sets the input base to decimal. On the other hand, <SAMP>`set input-radix 10'</SAMP>
leaves the input radix unchanged, no matter what it was, since
<SAMP>`10'</SAMP>, being without any leading or trailing signs of its base, is
interpreted in the current radix. Thus, if the current radix is 16,
<SAMP>`10'</SAMP> is interpreted in hex, i.e. as 16 decimal, which doesn't
change the radix.
</P><P>
<A NAME="IDX1132"></A>
<DT><CODE>set output-radix <VAR>base</VAR></CODE>
<DD>Set the default base for numeric display. Supported choices
for <VAR>base</VAR> are decimal 8, 10, or 16. <VAR>base</VAR> must itself be
specified either unambiguously or using the current input radix.
<P>
<A NAME="IDX1133"></A>
<DT><CODE>show input-radix</CODE>
<DD>Display the current default base for numeric input.
<P>
<A NAME="IDX1134"></A>
<DT><CODE>show output-radix</CODE>
<DD>Display the current default base for numeric display.
<P>
<DT><CODE>set radix [<VAR>base</VAR>]</CODE>
<DD><DT><CODE>show radix</CODE>
<DD><A NAME="IDX1135"></A>
<A NAME="IDX1136"></A>
These commands set and show the default base for both input and output
of numbers. <CODE>set radix</CODE> sets the radix of input and output to
the same base; without an argument, it resets the radix back to its
default value of 10.
<P>
</DL>
<P>
<A NAME="ABI"></A>
<HR SIZE="6">
<A NAME="SEC226"></A>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC225"> < </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC227"> > </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC227"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC220"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_21.html#SEC229"> >> </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_38.html#SEC764">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H2> 19.6 Configuring the Current ABI </H2>
<!--docid::SEC226::-->
<P>
GDB can determine the <EM>ABI</EM> (Application Binary Interface) of your
application automatically. However, sometimes you need to override its
conclusions. Use these commands to manage GDB's view of the
current ABI.
</P><P>
<A NAME="IDX1137"></A>
<A NAME="IDX1138"></A>
<A NAME="IDX1139"></A>
</P><P>
One GDB configuration can debug binaries for multiple operating
system targets, either via remote debugging or native emulation.
GDB will autodetect the <EM>OS ABI</EM> (Operating System ABI) in use,
but you can override its conclusion using the <CODE>set osabi</CODE> command.
One example where this is useful is in debugging of binaries which use
an alternate C library (e.g. UCLIBC for GNU/Linux) which does
not have the same identifying marks that the standard C library for your
platform provides.
</P><P>
<DL COMPACT>
<DT><CODE>show osabi</CODE>
<DD>Show the OS ABI currently in use.
<P>
<DT><CODE>set osabi</CODE>
<DD>With no argument, show the list of registered available OS ABI's.
<P>
<DT><CODE>set osabi <VAR>abi</VAR></CODE>
<DD>Set the current OS ABI to <VAR>abi</VAR>.
</DL>
<P>
<A NAME="IDX1140"></A>
</P><P>
Generally, the way that an argument of type <CODE>float</CODE> is passed to a
function depends on whether the function is prototyped. For a prototyped
(i.e. ANSI/ISO style) function, <CODE>float</CODE> arguments are passed unchanged,
according to the architecture's convention for <CODE>float</CODE>. For unprototyped
(i.e. K&R style) functions, <CODE>float</CODE> arguments are first promoted to type
<CODE>double</CODE> and then passed.
</P><P>
Unfortunately, some forms of debug information do not reliably indicate whether
a function is prototyped. If GDB calls a function that is not marked
as prototyped, it consults <KBD>set coerce-float-to-double</KBD>.
</P><P>
<DL COMPACT>
<A NAME="IDX1141"></A>
<DT><CODE>set coerce-float-to-double</CODE>
<DD><DT><CODE>set coerce-float-to-double on</CODE>
<DD>Arguments of type <CODE>float</CODE> will be promoted to <CODE>double</CODE> when passed
to an unprototyped function. This is the default setting.
<P>
<DT><CODE>set coerce-float-to-double off</CODE>
<DD>Arguments of type <CODE>float</CODE> will be passed directly to unprototyped
functions.
<P>
<A NAME="IDX1142"></A>
<DT><CODE>show coerce-float-to-double</CODE>
<DD>Show the current setting of promoting <CODE>float</CODE> to <CODE>double</CODE>.
</DL>
<P>
<A NAME="IDX1143"></A>
<A NAME="IDX1144"></A>
GDB needs to know the ABI used for your program's C<TT>++</TT>
objects. The correct C<TT>++</TT> ABI depends on which C<TT>++</TT> compiler was
used to build your application. GDB only fully supports
programs with a single C<TT>++</TT> ABI; if your program contains code using
multiple C<TT>++</TT> ABI's or if GDB can not identify your
program's ABI correctly, you can tell GDB which ABI to use.
Currently supported ABI's include "gnu-v2", for <CODE>g++</CODE> versions
before 3.0, "gnu-v3", for <CODE>g++</CODE> versions 3.0 and later, and
"hpaCC" for the HP ANSI C<TT>++</TT> compiler. Other C<TT>++</TT> compilers may
use the "gnu-v2" or "gnu-v3" ABI's as well. The default setting is
"auto".
</P><P>
<DL COMPACT>
<DT><CODE>show cp-abi</CODE>
<DD>Show the C<TT>++</TT> ABI currently in use.
<P>
<DT><CODE>set cp-abi</CODE>
<DD>With no argument, show the list of supported C<TT>++</TT> ABI's.
<P>
<DT><CODE>set cp-abi <VAR>abi</VAR></CODE>
<DD><DT><CODE>set cp-abi auto</CODE>
<DD>Set the current C<TT>++</TT> ABI to <VAR>abi</VAR>, or return to automatic detection.
</DL>
<P>
<A NAME="Messages/Warnings"></A>
<HR SIZE="6">
<A NAME="SEC227"></A>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC226"> < </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC228"> > </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC228"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC220"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_21.html#SEC229"> >> </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_38.html#SEC764">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H2> 19.7 Optional Warnings and Messages </H2>
<!--docid::SEC227::-->
<P>
<A NAME="IDX1145"></A>
<A NAME="IDX1146"></A>
By default, GDB is silent about its inner workings. If you are
running on a slow machine, you may want to use the <CODE>set verbose</CODE>
command. This makes GDB tell you when it does a lengthy
internal operation, so you will not think it has crashed.
</P><P>
Currently, the messages controlled by <CODE>set verbose</CODE> are those
which announce that the symbol table for a source file is being read;
see <CODE>symbol-file</CODE> in <A HREF="gdb_16.html#SEC155">Commands to Specify Files</A>.
</P><P>
<DL COMPACT>
<A NAME="IDX1147"></A>
<DT><CODE>set verbose on</CODE>
<DD>Enables GDB output of certain informational messages.
<P>
<DT><CODE>set verbose off</CODE>
<DD>Disables GDB output of certain informational messages.
<P>
<A NAME="IDX1148"></A>
<DT><CODE>show verbose</CODE>
<DD>Displays whether <CODE>set verbose</CODE> is on or off.
</DL>
<P>
By default, if GDB encounters bugs in the symbol table of an
object file, it is silent; but if you are debugging a compiler, you may
find this information useful (see section <A HREF="gdb_16.html#SEC157">Errors Reading Symbol Files</A>).
</P><P>
<DL COMPACT>
<A NAME="IDX1149"></A>
<DT><CODE>set complaints <VAR>limit</VAR></CODE>
<DD>Permits GDB to output <VAR>limit</VAR> complaints about each type of
unusual symbols before becoming silent about the problem. Set
<VAR>limit</VAR> to zero to suppress all complaints; set it to a large number
to prevent complaints from being suppressed.
<P>
<A NAME="IDX1150"></A>
<DT><CODE>show complaints</CODE>
<DD>Displays how many symbol complaints GDB is permitted to produce.
<P>
</DL>
<P>
By default, GDB is cautious, and asks what sometimes seems to be a
lot of stupid questions to confirm certain commands. For example, if
you try to run a program which is already running:
</P><P>
<TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>(gdb) run
The program being debugged has been started already.
Start it from the beginning? (y or n)
</FONT></pre></td></tr></table></P><P>
If you are willing to unflinchingly face the consequences of your own
commands, you can disable this "feature":
</P><P>
<DL COMPACT>
<A NAME="IDX1151"></A>
<A NAME="IDX1152"></A>
<A NAME="IDX1153"></A>
<A NAME="IDX1154"></A>
<DT><CODE>set confirm off</CODE>
<DD>Disables confirmation requests.
<P>
<DT><CODE>set confirm on</CODE>
<DD>Enables confirmation requests (the default).
<P>
<A NAME="IDX1155"></A>
<DT><CODE>show confirm</CODE>
<DD>Displays state of confirmation requests.
<P>
</DL>
<P>
<A NAME="IDX1156"></A>
If you need to debug user-defined commands or sourced files you may find it
useful to enable <EM>command tracing</EM>. In this mode each command will be
printed as it is executed, prefixed with one or more <SAMP>`+'</SAMP> symbols, the
quantity denoting the call depth of each command.
</P><P>
<DL COMPACT>
<A NAME="IDX1157"></A>
<A NAME="IDX1158"></A>
<DT><CODE>set trace-commands on</CODE>
<DD>Enable command tracing.
<DT><CODE>set trace-commands off</CODE>
<DD>Disable command tracing.
<DT><CODE>show trace-commands</CODE>
<DD>Display the current state of command tracing.
</DL>
<P>
<A NAME="Debugging Output"></A>
<HR SIZE="6">
<A NAME="SEC228"></A>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC227"> < </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_21.html#SEC229"> > </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC220"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC220"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_21.html#SEC229"> >> </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_38.html#SEC764">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H2> 19.8 Optional Messages about Internal Happenings </H2>
<!--docid::SEC228::-->
<P>
GDB has commands that enable optional debugging messages from
various GDB subsystems; normally these commands are of
interest to GDB maintainers, or when reporting a bug. This
section documents those commands.
</P><P>
<DL COMPACT>
<A NAME="IDX1159"></A>
<DT><CODE>set exec-done-display</CODE>
<DD>Turns on or off the notification of asynchronous commands'
completion. When on, GDB will print a message when an
asynchronous command finishes its execution. The default is off.
<A NAME="IDX1160"></A>
<DT><CODE>show exec-done-display</CODE>
<DD>Displays the current setting of asynchronous command completion
notification.
<A NAME="IDX1161"></A>
<A NAME="IDX1162"></A>
<A NAME="IDX1163"></A>
<DT><CODE>set debug arch</CODE>
<DD>Turns on or off display of gdbarch debugging info. The default is off
<A NAME="IDX1164"></A>
<DT><CODE>show debug arch</CODE>
<DD>Displays the current state of displaying gdbarch debugging info.
<DT><CODE>set debug aix-thread</CODE>
<DD><A NAME="IDX1165"></A>
Display debugging messages about inner workings of the AIX thread
module.
<DT><CODE>show debug aix-thread</CODE>
<DD>Show the current state of AIX thread debugging info display.
<DT><CODE>set debug event</CODE>
<DD><A NAME="IDX1166"></A>
Turns on or off display of GDB event debugging info. The
default is off.
<DT><CODE>show debug event</CODE>
<DD>Displays the current state of displaying GDB event debugging
info.
<DT><CODE>set debug expression</CODE>
<DD><A NAME="IDX1167"></A>
Turns on or off display of debugging info about GDB
expression parsing. The default is off.
<DT><CODE>show debug expression</CODE>
<DD>Displays the current state of displaying debugging info about
GDB expression parsing.
<DT><CODE>set debug frame</CODE>
<DD><A NAME="IDX1168"></A>
Turns on or off display of GDB frame debugging info. The
default is off.
<DT><CODE>show debug frame</CODE>
<DD>Displays the current state of displaying GDB frame debugging
info.
<DT><CODE>set debug infrun</CODE>
<DD><A NAME="IDX1169"></A>
Turns on or off display of GDB debugging info for running the inferior.
The default is off. <TT>`infrun.c'</TT> contains GDB's runtime state machine used
for implementing operations such as single-stepping the inferior.
<DT><CODE>show debug infrun</CODE>
<DD>Displays the current state of GDB inferior debugging.
<DT><CODE>set debug lin-lwp</CODE>
<DD><A NAME="IDX1170"></A>
<A NAME="IDX1171"></A>
Turns on or off debugging messages from the Linux LWP debug support.
<DT><CODE>show debug lin-lwp</CODE>
<DD>Show the current state of Linux LWP debugging messages.
<DT><CODE>set debug observer</CODE>
<DD><A NAME="IDX1172"></A>
Turns on or off display of GDB observer debugging. This
includes info such as the notification of observable events.
<DT><CODE>show debug observer</CODE>
<DD>Displays the current state of observer debugging.
<DT><CODE>set debug overload</CODE>
<DD><A NAME="IDX1173"></A>
Turns on or off display of GDB C<TT>++</TT> overload debugging
info. This includes info such as ranking of functions, etc. The default
is off.
<DT><CODE>show debug overload</CODE>
<DD>Displays the current state of displaying GDB C<TT>++</TT> overload
debugging info.
<A NAME="IDX1174"></A>
<A NAME="IDX1175"></A>
<A NAME="IDX1176"></A>
<A NAME="IDX1177"></A>
<A NAME="IDX1178"></A>
<DT><CODE>set debug remote</CODE>
<DD>Turns on or off display of reports on all packets sent back and forth across
the serial line to the remote machine. The info is printed on the
GDB standard output stream. The default is off.
<DT><CODE>show debug remote</CODE>
<DD>Displays the state of display of remote packets.
<DT><CODE>set debug serial</CODE>
<DD>Turns on or off display of GDB serial debugging info. The
default is off.
<DT><CODE>show debug serial</CODE>
<DD>Displays the current state of displaying GDB serial debugging
info.
<DT><CODE>set debug solib-frv</CODE>
<DD><A NAME="IDX1179"></A>
Turns on or off debugging messages for FR-V shared-library code.
<DT><CODE>show debug solib-frv</CODE>
<DD>Display the current state of FR-V shared-library code debugging
messages.
<DT><CODE>set debug target</CODE>
<DD><A NAME="IDX1180"></A>
Turns on or off display of GDB target debugging info. This info
includes what is going on at the target level of GDB, as it happens. The
default is 0. Set it to 1 to track events, and to 2 to also track the
value of large memory transfers. Changes to this flag do not take effect
until the next time you connect to a target or use the <CODE>run</CODE> command.
<DT><CODE>show debug target</CODE>
<DD>Displays the current state of displaying GDB target debugging
info.
<DT><CODE>set debugvarobj</CODE>
<DD><A NAME="IDX1181"></A>
Turns on or off display of GDB variable object debugging
info. The default is off.
<DT><CODE>show debugvarobj</CODE>
<DD>Displays the current state of displaying GDB variable object
debugging info.
<DT><CODE>set debug xml</CODE>
<DD><A NAME="IDX1182"></A>
Turns on or off debugging messages for built-in XML parsers.
<DT><CODE>show debug xml</CODE>
<DD>Displays the current state of XML debugging messages.
</DL>
<P>
<A NAME="Sequences"></A>
<HR SIZE="6">
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_20.html#SEC220"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="gdb_21.html#SEC229"> >> </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_38.html#SEC764">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>March, 27 2008</I>
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>
</BODY>
</HTML>