source: general/prog/gdb.xml@ 0b8d9023

10.0 10.1 11.0 7.10 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 0b8d9023 was 0b8d9023, checked in by Fernando de Oliveira <fernando@…>, 7 years ago

Update to gdb-7.9.1.

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

  • Property mode set to 100644
File size: 6.5 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 "https://ftp.gnu.org/gnu/gdb/gdb-&gdb-version;.tar.xz">
8 <!ENTITY gdb-download-ftp "ftp://ftp.gnu.org/gnu/gdb/gdb-&gdb-version;.tar.xz">
9 <!ENTITY gdb-md5sum "35374c77a70884eb430c97061053a36e">
10 <!ENTITY gdb-size "18 MB">
11 <!ENTITY gdb-buildsize "406 MB (additional 105 MB for checks)">
12 <!ENTITY gdb-time "2.2 SBU (add up to 6.0 SBU for checks)">
13]>
14
15<sect1 id="gdb" xreflabel="GDB-&gdb-version;">
16 <?dbhtml filename="gdb.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>GDB-&gdb-version;</title>
24
25 <indexterm zone="gdb">
26 <primary sortas="a-GDB">GDB</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to GDB</title>
31
32 <para>
33 <application>GDB</application>, the GNU Project debugger, allows you
34 to see what is going on <quote>inside</quote> another program while it
35 executes -- or what another program was doing at the moment it crashed.
36 Note that <application>GDB</application> is most effective when tracing
37 programs and libraries that were built with debugging symbols and not
38 stripped.
39 </para>
40
41 &lfs77_checked; &gcc5_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&gdb-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&gdb-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &gdb-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &gdb-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &gdb-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &gdb-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">GDB Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Optional</bridgehead>
80 <para role="optional">
81 <xref linkend="dejagnu"/> (for tests),
82 <xref linkend="doxygen"/>,
83 <xref linkend="guile"/>, and
84 <xref linkend="python2"/>
85 </para>
86
87 <para condition="html" role="usernotes">User Notes:
88 <ulink url="&blfs-wiki;/gdb"/>
89 </para>
90 </sect2>
91
92 <sect2 role="installation">
93 <title>Installation of GDB</title>
94
95 <para>
96 Install <application>GDB</application> by running the following
97 commands:
98 </para>
99
100<screen><userinput>./configure --prefix=/usr --with-system-readline &amp;&amp;
101make</userinput></screen>
102
103 <para>
104 Optionally, to build the API documentation using
105 <xref linkend="doxygen"/>, run:
106 </para>
107
108<screen><userinput>make -C gdb/doc doxy</userinput></screen>
109
110 <para>
111 To test the results, issue: <command>make -k check</command>. There are
112 many problems with the test suite. Depends on installed compilers, there
113 are differences if run locally or remotely, a large number of timeouts
114 (there is a variable that can be set to increase time for timeout, but
115 changing it, apparently the total number of tests is not conserved),
116 there are failures associated with system readline 6.x, between others.
117 Unexpected failures are of the order of 0.5%.
118 </para>
119
120 <para>
121 Now, as the <systemitem class="username">root</systemitem> user:
122 </para>
123
124<screen role="root"><userinput>make -C gdb install</userinput></screen>
125
126 <para>
127 If you have built the API documentation, it is now in gdb/doc/doxy.
128 You can install it (as the <systemitem class="username">root</systemitem>
129 user):
130 </para>
131
132<screen role="root"><userinput>install -d /usr/share/doc/gdb-&gdb-version; &amp;&amp;
133cp -Rv gdb/doc/doxy /usr/share/doc/gdb-&gdb-version;</userinput></screen>
134
135 </sect2>
136
137 <sect2 role="content">
138 <title>Contents</title>
139
140 <segmentedlist>
141 <segtitle>Installed Programs</segtitle>
142 <segtitle>Installed Library</segtitle>
143 <segtitle>Installed Directories</segtitle>
144
145 <seglistitem>
146 <seg>
147 gcore, gdb and gdbserver
148 </seg>
149 <seg>
150 libinproctrace.so
151 </seg>
152 <seg>
153 /usr/include/gdb and
154 /usr/share/gdb
155 </seg>
156 </seglistitem>
157 </segmentedlist>
158
159 <variablelist>
160 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
161 <?dbfo list-presentation="list"?>
162 <?dbhtml list-presentation="table"?>
163
164 <varlistentry id="gcore">
165 <term><command>gcore</command></term>
166 <listitem>
167 <para>
168 generates a core dump of a running program.
169 </para>
170 <indexterm zone="gdb gcore">
171 <primary sortas="b-gcore">gcore</primary>
172 </indexterm>
173 </listitem>
174 </varlistentry>
175
176 <varlistentry id="gdb-prog">
177 <term><command>gdb</command></term>
178 <listitem>
179 <para>
180 is the GNU Debugger.
181 </para>
182 <indexterm zone="gdb gdb-prog">
183 <primary sortas="b-gdb-prog">gdb-prog</primary>
184 </indexterm>
185 </listitem>
186 </varlistentry>
187
188 <varlistentry id="gdbserver">
189 <term><command>gdbserver</command></term>
190 <listitem>
191 <para>
192 is a remote server for the GNU debugger (it allows programs
193 to be debugged from a different machine).
194 </para>
195 <indexterm zone="gdb gdbserver">
196 <primary sortas="b-gdbserver">gdbserver</primary>
197 </indexterm>
198 </listitem>
199 </varlistentry>
200
201 <varlistentry id="libinproctrace">
202 <term><filename class="libraryfile">libinproctrace.so</filename></term>
203 <listitem>
204 <para>
205 contains functions for the in-process tracing agent. The agent
206 allows for installing fast tracepoints, listing static tracepoint
207 markers, probing static tracepoints markers, and starting trace
208 monitoring.
209 </para>
210 <indexterm zone="gdb libinproctrace">
211 <primary sortas="c-libinproctrace">libinproctrace.so</primary>
212 </indexterm>
213 </listitem>
214 </varlistentry>
215
216 </variablelist>
217
218 </sect2>
219
220</sect1>
Note: See TracBrowser for help on using the repository browser.