/usr/share/doc/gnat-gps/html/The-Debugger-Console.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 2002-2010 AdaCore.

This document is free; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This document is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, see http://www.gnu.org/licenses/.

A copy of the license is included in the section entitled
"GNU General Public License". -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Using the GNAT Programming Studio: The Debugger Console</title>

<meta name="description" content="Using the GNAT Programming Studio: The Debugger Console">
<meta name="keywords" content="Using the GNAT Programming Studio: The Debugger Console">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Index-table.html#Index-table" rel="index" title="Index table">
<link href="Debugging.html#Debugging" rel="up" title="Debugging">
<link href="Customizing-the-Debugger.html#Customizing-the-Debugger" rel="next" title="Customizing the Debugger">
<link href="The-Assembly-Window.html#The-Assembly-Window" rel="previous" title="The Assembly Window">
<style type="text/css">
<!--
   

a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
pre.smallexample {background-color:rgb(240,240,240);
                     font-family: courier new,courier,fixed;
                     font-size: 14px;
                     margin: 0px 40px 0px 40px;
                     border-width: 1px 2px 2px 1px;
                     border-top-style: dotted;
                     border-left-style: dotted;
                     border-right-style: solid;
                     border-bottom-style: solid;
                     border-color: black;}
   code             {color:black;
                     font-family: courier new,courier,fixed;
                     font-size: 14px;}
   body             {font-family: arial,helvetica,sans-serif;
                     font-size: 16px;
                     max-width: 800px;
                     text-align: justify}
   samp             {font-family: courier new,courier,fixed;
                     font-size: 14px}
                    

-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="The-Debugger-Console"></a>
<div class="header">
<p>
Next: <a href="Customizing-the-Debugger.html#Customizing-the-Debugger" accesskey="n" rel="next">Customizing the Debugger</a>, Previous: <a href="The-Assembly-Window.html#The-Assembly-Window" accesskey="p" rel="previous">The Assembly Window</a>, Up: <a href="Debugging.html#Debugging" accesskey="u" rel="up">Debugging</a> &nbsp; [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="The-Debugger-Console-1"></a>
<h3 class="section">11.8 The Debugger Console</h3>
<a name="index-debugger-3"></a>
<a name="index-debugger-console"></a>

<p>This is the text window located at the bottom of the main window.
In this console, you have direct access to the underlying debugger,
and can send commands (you need to refer to the underlying debugger&rsquo;s
documentation, but usually typing <i>help</i> will give you an overview of
the commands available).
</p>
<p>If the underlying debugger allows it, pressing <tt class="key">Tab</tt> in this
window will provide completion for the command that is being typed (or for
its arguments).
</p>
<p>There are also additional commands defined to provide a simple
text interface to some graphical features.
</p>
<p>Here is the complete list of such commands. The arguments between square
brackets are optional and can be omitted.
</p>
<dl compact="compact">
<dt><code>graph (print|display) expression [dependent on display_num] [link_name name] [at x, y] [num num]</code></dt>
<dd><a name="index-graph-print"></a>
<a name="index-graph-display"></a>
<p>This command creates a new item in the canvas, that shows the value of
<var>Expression</var>. <var>Expression</var> should be the name of a variable, or one
of its fields, that is in the current scope for the debugger.
</p>
<p>The command <code>graph print</code> will create a frozen item, that is not
automatically refreshed when the debugger stops, whereas <code>graph display</code>
displays an automatically refreshed item.
</p>
<p>The new item is associated with a number, that is visible in its title bar.
This number can be specified through the <code>num</code> keyword, and will be taken
into account if no such item already exists.
These numbers can be used to create links between the items, using the
second argument to the command, <var>dependent on</var>. The link itself (i.e. the
line) can be given a name that is automatically displayed, using the third
argument.
</p>
</dd>
<dt><code>graph (print|display) `command`</code></dt>
<dd><p>This command is similar to the one above, except it should be used to
display the result of a debugger command in the canvas.
</p>
<p>For instance, if you want to display the value of a variable in hexadecimal
rather than the default decimal with gdb, you should use a command like:
</p>
<a name="index-example-2"></a>
<div class="smallexample">
<pre class="smallexample">graph display `print /x my_variable`
</pre></div>

<p>This will evaluate the command between back-quotes every time the debugger
stops, and display this in the canvas. The lines that have changed will
be automatically highlighted (in red by default).
</p>
<p>This command is the one used by default to display the value of registers
for instance.
</p>
</dd>
<dt><code>graph (enable|disable) display display_num [display_num ...]</code></dt>
<dd><a name="index-graph-enable"></a>
<a name="index-graph-disable"></a>
<p>This command will change the refresh status of items in the canvas. As
explained above, items are associated with a number visible in their title
bar.
</p>
<p>Using the <code>graph enable</code> command will force the item to be automatically
refreshed every time the debugger stops, whereas the <code>graph disable</code>
command will freeze the item.
</p>
</dd>
<dt><code>graph undisplay display_num</code></dt>
<dd><a name="index-graph-undisplay"></a>
<p>This command will remove an item from the canvas
</p>
</dd>
<dt><code>view (source|asm|source_asm)</code></dt>
<dd><a name="index-view-2"></a>
<a name="index-asm"></a>
<p>This command indicates what should be displayed in the source window.
The first option indicates that only the source code should be visible,
the second one specifies that only the assembly code should be visible,
and the last one indicates that both should be displayed.
</p>
</dd>
</dl>

<hr>
<div class="header">
<p>
Next: <a href="Customizing-the-Debugger.html#Customizing-the-Debugger" accesskey="n" rel="next">Customizing the Debugger</a>, Previous: <a href="The-Assembly-Window.html#The-Assembly-Window" accesskey="p" rel="previous">The Assembly Window</a>, Up: <a href="Debugging.html#Debugging" accesskey="u" rel="up">Debugging</a> &nbsp; [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
gnat-gps-doc 5.0-16 / usr / share / doc / gnat-gps / html / The-Debugger-Console.html
