source: general/prog/gdb.xml@ 5ad8a1f

10.0 10.1 11.0 9.1 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 5ad8a1f was 5ad8a1f, checked in by Bruce Dubbs <bdubbs@…>, 2 years ago

Update to BIND Utilities and bind-9.14.6.
Update to gdb-8.3.1.
Update to mesa-19.1.7.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22185 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 9.3 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY gdb-download-http "&gnu-http;/gdb/gdb-&gdb-version;.tar.xz">
8 <!ENTITY gdb-download-ftp "&gnu-ftp;/gdb/gdb-&gdb-version;.tar.xz">
9 <!ENTITY gdb-md5sum "73b6a5d8141672c62bf851cd34c4aa83">
10 <!ENTITY gdb-size "20 MB">
11 <!ENTITY gdb-buildsize "625 MB (add 57 MB for tests, add 748 MB for docs)">
12 <!ENTITY gdb-time "1.9 SBU (Using parallelism=4; add 66 SBU for tests, add 0.6 SBU for docs)">
13]>
14
15<!-- I skipped running the full tests for this 8.3.1 point version. Bruce -->
16
17<sect1 id="gdb" xreflabel="GDB-&gdb-version;">
18 <?dbhtml filename="gdb.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>GDB-&gdb-version;</title>
26
27 <indexterm zone="gdb">
28 <primary sortas="a-GDB">GDB</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to GDB</title>
33
34 <para>
35 <application>GDB</application>, the GNU Project debugger, allows you
36 to see what is going on <quote>inside</quote> another program while it
37 executes -- or what another program was doing at the moment it crashed.
38 Note that <application>GDB</application> is most effective when tracing
39 programs and libraries that were built with debugging symbols and not
40 stripped.
41 </para>
42
43 &lfs90_checked;
44
45 <bridgehead renderas="sect3">Package Information</bridgehead>
46 <itemizedlist spacing="compact">
47 <listitem>
48 <para>
49 Download (HTTP): <ulink url="&gdb-download-http;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download (FTP): <ulink url="&gdb-download-ftp;"/>
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download MD5 sum: &gdb-md5sum;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Download size: &gdb-size;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated disk space required: &gdb-buildsize;
70 </para>
71 </listitem>
72 <listitem>
73 <para>
74 Estimated build time: &gdb-time;
75 </para>
76 </listitem>
77 </itemizedlist>
78
79 <bridgehead renderas="sect3">GDB Dependencies</bridgehead>
80
81 <bridgehead renderas="sect4">Recommended Runtime Dependency</bridgehead>
82 <para role="recommended">
83 <xref linkend="six"/> (Python 3 module, required at run-time to
84 use GDB scripts from various LFS/BLFS packages with Python 3
85 installed in LFS)
86 </para>
87
88 <bridgehead renderas="sect4">Optional</bridgehead>
89 <para role="optional">
90 <xref linkend="dejagnu"/> (required for tests),
91 <xref linkend="doxygen"/>,
92 <xref linkend="gcc"/> (ada and gfortran are used for tests),
93 <xref linkend="guile"/>,
94 <xref linkend="python2"/>,
95 <xref linkend="rust"/> (used for some tests),
96 <xref linkend="valgrind"/>, and
97 <ulink url="https://sourceware.org/systemtap/">SystemTap</ulink>
98 (run-time, used for tests)
99 </para>
100
101 <para condition="html" role="usernotes">User Notes:
102 <ulink url="&blfs-wiki;/gdb"/>
103 </para>
104 </sect2>
105
106 <sect2 role="installation">
107 <title>Installation of GDB</title>
108
109 <para>
110 Install <application>GDB</application> by running the following
111 commands:
112 </para>
113
114<screen><userinput>./configure --prefix=/usr \
115 --with-system-readline \
116 --with-python=/usr/bin/python3 &amp;&amp;
117make</userinput></screen>
118
119 <para>
120 Optionally, to build the API documentation using
121 <xref linkend="doxygen"/>, run:
122 </para>
123
124<screen remap="doc"><userinput>make -C gdb/doc doxy</userinput></screen>
125
126 <para>
127 To test the results, issue:
128 </para>
129
130<screen remap="test"><userinput>pushd gdb/testsuite &amp;&amp;
131make site.exp &amp;&amp;
132echo "set gdb_test_timeout 120" &gt;&gt; site.exp &amp;&amp;
133runtest
134popd</userinput></screen>
135
136 <para>
137 See <emphasis>gdb/testsuite/README</emphasis> and <ulink
138 url="https://sourceware.org/gdb/wiki/TestingGDB">TestingGDB</ulink>.
139 There are many problems with the test suite:
140 </para>
141
142 <itemizedlist>
143 <listitem>
144 <para>
145 Clean directories are needed if re-running the tests. For that
146 reason, make a copy of the compiled source code
147 directory before the tests in case you need to run the tests again.
148 </para>
149 </listitem>
150
151 <listitem>
152 <para>
153 Results depend on installed compilers.
154 </para>
155 </listitem>
156
157 <listitem>
158 <para>
159 There are a large number of timeouts (there is a variable
160 that can be set to increase time for timeout, but
161 changing it will result in a different number of tests being
162 run).
163 </para>
164 </listitem>
165
166 <listitem>
167 <para>
168 There are failures associated with system readline 6.x.
169 </para>
170 </listitem>
171
172 <listitem>
173 <para>
174 A few tests assume that the header file
175 <filename>&lt;sys/sdt.h&gt;</filename>, part of <ulink
176 url="https://sourceware.org/systemtap/">SystemTap</ulink>, is
177 present.
178 </para>
179 </listitem>
180
181 <listitem>
182 <para>
183 If the test suite is run on a Skylake-based Intel CPU or newer,
184 many tests will fail due to the removal of the deprecated/problematic
185 libmpx library in GCC.
186 </para>
187 </listitem>
188
189 <listitem>
190 <para>
191 Approximately 1-3% of the tests fail (out of over 56000 tests).
192 </para>
193 </listitem>
194
195 </itemizedlist>
196
197 <para>
198 Now, as the <systemitem class="username">root</systemitem> user:
199 </para>
200
201<screen role="root"><userinput>make -C gdb install</userinput></screen>
202
203 <para>
204 If you have built the API documentation, it is now in gdb/doc/doxy.
205 You can install it (as the <systemitem class="username">root</systemitem>
206 user):
207 </para>
208
209<screen role="root"
210 remap="doc"><userinput>install -d /usr/share/doc/gdb-&gdb-version; &amp;&amp;
211rm -rf gdb/doc/doxy/xml &amp;&amp;
212cp -Rv gdb/doc/doxy /usr/share/doc/gdb-&gdb-version;</userinput></screen>
213
214 </sect2>
215
216 <sect2 role="commands">
217 <title>Command Explanations</title>
218
219 <para>
220 <parameter>--with-system-readline</parameter>: This switch forces
221 <application>GDB</application> to use the copy of
222 <application>Readline</application> installed in LFS.
223 </para>
224
225 <para>
226 <parameter>--with-python=/usr/bin/python3</parameter>: This switch
227 forces <application>GDB</application> to use Python 3 installed
228 in LFS. Remove this switch if you have installed
229 <xref linkend="python2"/> and want to use it instead of Python 3.
230 </para>
231
232 </sect2>
233
234 <sect2 role="content">
235 <title>Contents</title>
236
237 <segmentedlist>
238 <segtitle>Installed Programs</segtitle>
239 <segtitle>Installed Library</segtitle>
240 <segtitle>Installed Directories</segtitle>
241
242 <seglistitem>
243 <seg>
244 gcore, gdb and gdbserver
245 </seg>
246 <seg>
247 libinproctrace.so
248 </seg>
249 <seg>
250 /usr/{include,share}/gdb and /usr/share/doc/gdb-&gdb-version;
251 </seg>
252 </seglistitem>
253 </segmentedlist>
254
255 <variablelist>
256 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
257 <?dbfo list-presentation="list"?>
258 <?dbhtml list-presentation="table"?>
259
260 <varlistentry id="gcore">
261 <term><command>gcore</command></term>
262 <listitem>
263 <para>
264 generates a core dump of a running program.
265 </para>
266 <indexterm zone="gdb gcore">
267 <primary sortas="b-gcore">gcore</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 <varlistentry id="gdb-prog">
273 <term><command>gdb</command></term>
274 <listitem>
275 <para>
276 is the GNU Debugger.
277 </para>
278 <indexterm zone="gdb gdb-prog">
279 <primary sortas="b-gdb-prog">gdb-prog</primary>
280 </indexterm>
281 </listitem>
282 </varlistentry>
283
284 <varlistentry id="gdbserver">
285 <term><command>gdbserver</command></term>
286 <listitem>
287 <para>
288 is a remote server for the GNU debugger (it allows programs
289 to be debugged from a different machine).
290 </para>
291 <indexterm zone="gdb gdbserver">
292 <primary sortas="b-gdbserver">gdbserver</primary>
293 </indexterm>
294 </listitem>
295 </varlistentry>
296
297 <varlistentry id="libinproctrace">
298 <term><filename class="libraryfile">libinproctrace.so</filename></term>
299 <listitem>
300 <para>
301 contains functions for the in-process tracing agent. The agent
302 allows for installing fast tracepoints, listing static tracepoint
303 markers, probing static tracepoints markers, and starting trace
304 monitoring.
305 </para>
306 <indexterm zone="gdb libinproctrace">
307 <primary sortas="c-libinproctrace">libinproctrace.so</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311
312 </variablelist>
313
314 </sect2>
315
316</sect1>
Note: See TracBrowser for help on using the repository browser.