/usr/share/doc/gnat-gps/html/Debugging.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 160 161 162 163 164 165 166 167 168 169 170 171 172 173 | <!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: Debugging</title>
<meta name="description" content="Using the GNAT Programming Studio: Debugging">
<meta name="keywords" content="Using the GNAT Programming Studio: Debugging">
<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="index.html#Top" rel="up" title="Top">
<link href="The-Debug-Menu.html#The-Debug-Menu" rel="next" title="The Debug Menu">
<link href="Entity-Browser.html#Entity-Browser" rel="previous" title="Entity Browser">
<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="Debugging"></a>
<div class="header">
<p>
Next: <a href="Version-Control-System.html#Version-Control-System" accesskey="n" rel="next">Version Control System</a>, Previous: <a href="Source-Browsing.html#Source-Browsing" accesskey="p" rel="previous">Source Browsing</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Debugging-1"></a>
<h2 class="chapter">11 Debugging</h2>
<a name="index-debugger-1"></a>
<a name="index-debugging"></a>
<p>GPS is also a graphical front-end for text-based debuggers such as GDB.
A knowledge of the basics of the underlying debugger used by GPS will help
understanding how GPS works and what kind of functionalities it provides.
</p>
<p>Please refer to the debugger-specific documentation -
e.g. the GDB documentation
(<a href="gdb.html">gdb.html</a>)
- for more details.
</p>
<p>Debugging is tightly integrated with the other components of GPS. For
example, it is possible to edit files and navigate through your sources
while debugging.
</p>
<a name="index-menu-8"></a>
<p>To start a debug session, go to the menu <code>Debug->Initialize</code>, and choose
either the name of your executable, if you have specified the name of
your main program(s) in the project properties, or start an empty debug
session using the <code><no main file></code> item. It is then possible to load
any file to debug, by using the menu <code>Debug->Debug->Load File...</code>
</p>
<p>Note that you can create multiple debuggers by using the <code>Initialize</code>
menu several times: this will create a new debugger each time.
All the debugger-related actions (e.g. stepping, running) are performed on
the current debugger, which is represented by the current debugger console.
To switch between debuggers, simply select its corresponding console.
</p>
<p>After the debugger has been initialized, you have access to two new windows:
the data window (in the top of the working area), and the debugger console
(in a new page, after the Messages and Shell windows).
All the menus under <code>Debugger</code>
are now also accessible, and you also have access to additional contextual
menus, in particular in the source editor where it is possible to easily
display variables, set breakpoints, and get automatic display
(via <i>tool tips</i>) of object values.
</p>
<a name="index-menu-9"></a>
<p>When you want to quit the debugger without quitting GPS, go to the menu
<code>Debug->Terminate Current</code>, that will terminate your current debug
session, or the menu <code>Debug->Terminate</code> that will terminate all your
debug sessions at once.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="The-Debug-Menu.html#The-Debug-Menu" accesskey="1">The Debug Menu</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="The-Call-Stack-Window.html#The-Call-Stack-Window" accesskey="2">The Call Stack Window</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="The-Data-Window.html#The-Data-Window" accesskey="3">The Data Window</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="The-Breakpoint-Editor.html#The-Breakpoint-Editor" accesskey="4">The Breakpoint Editor</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="The-Memory-Window.html#The-Memory-Window" accesskey="5">The Memory Window</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Using-the-Source-Editor-when-Debugging.html#Using-the-Source-Editor-when-Debugging" accesskey="6">Using the Source Editor when Debugging</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="The-Assembly-Window.html#The-Assembly-Window" accesskey="7">The Assembly Window</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="The-Debugger-Console.html#The-Debugger-Console" accesskey="8">The Debugger Console</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Customizing-the-Debugger.html#Customizing-the-Debugger" accesskey="9">Customizing the Debugger</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
<div class="header">
<p>
Next: <a href="Version-Control-System.html#Version-Control-System" accesskey="n" rel="next">Version Control System</a>, Previous: <a href="Source-Browsing.html#Source-Browsing" accesskey="p" rel="previous">Source Browsing</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|