/usr/share/doc/gnat-gps/html/The-Assembly-Window.html is in gnat-gps-doc 5.0-16.
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 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 | <!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 Assembly Window</title>
<meta name="description" content="Using the GNAT Programming Studio: The Assembly Window">
<meta name="keywords" content="Using the GNAT Programming Studio: The Assembly Window">
<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="The-Debugger-Console.html#The-Debugger-Console" rel="next" title="The Debugger Console">
<link href="Using-the-Source-Editor-when-Debugging.html#Using-the-Source-Editor-when-Debugging" rel="previous" title="Using the Source Editor when Debugging">
<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-Assembly-Window"></a>
<div class="header">
<p>
Next: <a href="The-Debugger-Console.html#The-Debugger-Console" accesskey="n" rel="next">The Debugger Console</a>, Previous: <a href="Using-the-Source-Editor-when-Debugging.html#Using-the-Source-Editor-when-Debugging" accesskey="p" rel="previous">Using the Source Editor when Debugging</a>, Up: <a href="Debugging.html#Debugging" accesskey="u" rel="up">Debugging</a> [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="The-Assembly-Window-1"></a>
<h3 class="section">11.7 The Assembly Window</h3>
<p>It is sometimes convenient to look at the assembly code for the subprogram
or source line you are currently debugging.
</p>
<p>You can open the assembly window by using the menu
<code>Debug->Data->Assembly</code>.
</p>
<a name="index-screen-shot-42"></a>
<img src="assembly.jpg" alt="assembly">
<p>The current assembly instruction is highlighted with a green
arrow on its left. The instructions corresponding to the current source
line are highlighted in red by default. This allows you to easily see
where the program counter will point to, once you have pressed the "Next"
button on the tool bar.
</p>
<p>Moving to the next assembly instruction is done through the "Nexti"
(next instruction) button in the tool bar. If you choose "Stepi"
instead (step instruction), this will also jump to the subprogram
being called.
</p>
<p>For efficiency reasons, only a small part of the assembly code around the
current instruction is displayed.
You can specify in the <a href="The-Preferences-Dialog.html#preferences-dialog">preferences dialog</a> how many instructions
are displayed by default. Also, you can easily
display the instructions immediately preceding or following the
currently displayed instructions by pressing one of the <tt class="key">Page up</tt> or
<tt class="key">Page down</tt> keys, or by using the contextual menu in the assembly
window.
</p>
<p>A convenient complement when debugging at the assembly level is the
ability of displaying the contents of machine registers.
When the debugger supports it (as gdb does), you can select the
<code>Data->Display Registers</code> menu to get an item in the canvas that will
show the current contents of each machine register, and that will be updated
every time one of them changes.
</p>
<p>You might also choose to look at a single register.
With gdb, select the <code>Data->Display Any Expression</code>, entering
something like
</p>
<a name="index-example-1"></a>
<div class="smallexample">
<pre class="smallexample">output /x $eax
</pre></div>
<p>in the field, and selecting the toggle button "Expression is a subprogram
call". This will create a new canvas item that will be refreshed every
time the value of the register (in this case eax) changes.
</p>
<hr>
<div class="header">
<p>
Next: <a href="The-Debugger-Console.html#The-Debugger-Console" accesskey="n" rel="next">The Debugger Console</a>, Previous: <a href="Using-the-Source-Editor-when-Debugging.html#Using-the-Source-Editor-when-Debugging" accesskey="p" rel="previous">Using the Source Editor when Debugging</a>, Up: <a href="Debugging.html#Debugging" accesskey="u" rel="up">Debugging</a> [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|