130 lines
4.8 KiB
HTML
130 lines
4.8 KiB
HTML
<html lang="en">
|
|
<head>
|
|
<title>TUI Overview - Debugging with GDB</title>
|
|
<meta http-equiv="Content-Type" content="text/html">
|
|
<meta name="description" content="Debugging with GDB">
|
|
<meta name="generator" content="makeinfo 4.13">
|
|
<link title="Top" rel="start" href="index.html#Top">
|
|
<link rel="up" href="TUI.html#TUI" title="TUI">
|
|
<link rel="next" href="TUI-Keys.html#TUI-Keys" title="TUI Keys">
|
|
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
|
|
<!--
|
|
Copyright (C) 1988-2019 Free Software Foundation, Inc.
|
|
|
|
Permission is granted to copy, distribute and/or modify this document
|
|
under the terms of the GNU Free Documentation License, Version 1.3 or
|
|
any later version published by the Free Software Foundation; with the
|
|
Invariant Sections being ``Free Software'' and ``Free Software Needs
|
|
Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,''
|
|
and with the Back-Cover Texts as in (a) below.
|
|
|
|
(a) The FSF's Back-Cover Text is: ``You are free to copy and modify
|
|
this GNU Manual. Buying copies from GNU Press supports the FSF in
|
|
developing GNU and promoting software freedom.''
|
|
-->
|
|
<meta http-equiv="Content-Style-Type" content="text/css">
|
|
<style type="text/css"><!--
|
|
pre.display { font-family:inherit }
|
|
pre.format { font-family:inherit }
|
|
pre.smalldisplay { font-family:inherit; font-size:smaller }
|
|
pre.smallformat { font-family:inherit; font-size:smaller }
|
|
pre.smallexample { font-size:smaller }
|
|
pre.smalllisp { font-size:smaller }
|
|
span.sc { font-variant:small-caps }
|
|
span.roman { font-family:serif; font-weight:normal; }
|
|
span.sansserif { font-family:sans-serif; font-weight:normal; }
|
|
--></style>
|
|
</head>
|
|
<body>
|
|
<div class="node">
|
|
<a name="TUI-Overview"></a>
|
|
<p>
|
|
Next: <a rel="next" accesskey="n" href="TUI-Keys.html#TUI-Keys">TUI Keys</a>,
|
|
Up: <a rel="up" accesskey="u" href="TUI.html#TUI">TUI</a>
|
|
<hr>
|
|
</div>
|
|
|
|
<h3 class="section">25.1 TUI Overview</h3>
|
|
|
|
<p>In TUI mode, <span class="sc">gdb</span> can display several text windows:
|
|
|
|
<dl>
|
|
<dt><em>command</em><dd>This window is the <span class="sc">gdb</span> command window with the <span class="sc">gdb</span>
|
|
prompt and the <span class="sc">gdb</span> output. The <span class="sc">gdb</span> input is still
|
|
managed using readline.
|
|
|
|
<br><dt><em>source</em><dd>The source window shows the source file of the program. The current
|
|
line and active breakpoints are displayed in this window.
|
|
|
|
<br><dt><em>assembly</em><dd>The assembly window shows the disassembly output of the program.
|
|
|
|
<br><dt><em>register</em><dd>This window shows the processor registers. Registers are highlighted
|
|
when their values change.
|
|
</dl>
|
|
|
|
<p>The source and assembly windows show the current program position
|
|
by highlighting the current line and marking it with a ‘<samp><span class="samp">></span></samp>’ marker.
|
|
Breakpoints are indicated with two markers. The first marker
|
|
indicates the breakpoint type:
|
|
|
|
<dl>
|
|
<dt><code>B</code><dd>Breakpoint which was hit at least once.
|
|
|
|
<br><dt><code>b</code><dd>Breakpoint which was never hit.
|
|
|
|
<br><dt><code>H</code><dd>Hardware breakpoint which was hit at least once.
|
|
|
|
<br><dt><code>h</code><dd>Hardware breakpoint which was never hit.
|
|
</dl>
|
|
|
|
<p>The second marker indicates whether the breakpoint is enabled or not:
|
|
|
|
<dl>
|
|
<dt><code>+</code><dd>Breakpoint is enabled.
|
|
|
|
<br><dt><code>-</code><dd>Breakpoint is disabled.
|
|
</dl>
|
|
|
|
<p>The source, assembly and register windows are updated when the current
|
|
thread changes, when the frame changes, or when the program counter
|
|
changes.
|
|
|
|
<p>These windows are not all visible at the same time. The command
|
|
window is always visible. The others can be arranged in several
|
|
layouts:
|
|
|
|
<ul>
|
|
<li>source only,
|
|
|
|
<li>assembly only,
|
|
|
|
<li>source and assembly,
|
|
|
|
<li>source and registers, or
|
|
|
|
<li>assembly and registers.
|
|
</ul>
|
|
|
|
<p>A status line above the command window shows the following information:
|
|
|
|
<dl>
|
|
<dt><em>target</em><dd>Indicates the current <span class="sc">gdb</span> target.
|
|
(see <a href="Targets.html#Targets">Specifying a Debugging Target</a>).
|
|
|
|
<br><dt><em>process</em><dd>Gives the current process or thread number.
|
|
When no process is being debugged, this field is set to <code>No process</code>.
|
|
|
|
<br><dt><em>function</em><dd>Gives the current function name for the selected frame.
|
|
The name is demangled if demangling is turned on (see <a href="Print-Settings.html#Print-Settings">Print Settings</a>).
|
|
When there is no symbol corresponding to the current program counter,
|
|
the string <code>??</code> is displayed.
|
|
|
|
<br><dt><em>line</em><dd>Indicates the current line number for the selected frame.
|
|
When the current line number is not known, the string <code>??</code> is displayed.
|
|
|
|
<br><dt><em>pc</em><dd>Indicates the current program counter address.
|
|
</dl>
|
|
|
|
</body></html>
|
|
|