/usr/share/doc/gnat-gps/html/The-Debugger-Console.html is in gnat-gps-doc 5.0-6.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 | <html lang="en">
<head>
<title>The Debugger Console - Using the GNAT Programming Studio</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Using the GNAT Programming Studio">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Debugging.html#Debugging" title="Debugging">
<link rel="prev" href="The-Assembly-Window.html#The-Assembly-Window" title="The Assembly Window">
<link rel="next" href="Customizing-the-Debugger.html#Customizing-the-Debugger" title="Customizing the Debugger">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
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 3 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/'.-->
<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; }
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>
<div class="node">
<a name="The-Debugger-Console"></a>
<p>
Next: <a rel="next" accesskey="n" href="Customizing-the-Debugger.html#Customizing-the-Debugger">Customizing the Debugger</a>,
Previous: <a rel="previous" accesskey="p" href="The-Assembly-Window.html#The-Assembly-Window">The Assembly Window</a>,
Up: <a rel="up" accesskey="u" href="Debugging.html#Debugging">Debugging</a>
<hr>
</div>
<h3 class="section">11.8 The Debugger Console</h3>
<p><a name="index-debugger-569"></a><a name="index-debugger-console-570"></a><!-- -->
<p class="noindent">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's
documentation, but usually typing <i>help</i> will give you an overview of
the commands available).
<p>If the underlying debugger allows it, pressing <Tab> in this
window will provide completion for the command that is being typed (or for
its arguments).
<p>There are also additional commands defined to provide a simple
text interface to some graphical features.
<p>Here is the complete list of such commands. The arguments between square
brackets are optional and can be omitted.
<dl>
<dt><samp><span class="command">graph (print|display) expression [dependent on display_num] [link_name name] [at x, y] [num num]</span></samp><dd><a name="index-graph-print-571"></a><a name="index-graph-display-572"></a>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>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>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.
<br><dt><samp><span class="command">graph (print|display) `command`</span></samp><dd>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>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-573"></a>
<pre class="smallexample"> graph display `print /x my_variable`
</pre>
<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>This command is the one used by default to display the value of registers
for instance.
<br><dt><samp><span class="command">graph (enable|disable) display display_num [display_num ...]</span></samp><dd><a name="index-graph-enable-574"></a><a name="index-graph-disable-575"></a>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>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.
<br><dt><samp><span class="command">graph undisplay display_num</span></samp><dd><a name="index-graph-undisplay-576"></a>This command will remove an item from the canvas
<br><dt><samp><span class="command">view (source|asm|source_asm)</span></samp><dd><a name="index-view-577"></a><a name="index-asm-578"></a>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.
</dl>
<!-- -->
</body></html>
|