161 lines
9.5 KiB
HTML
161 lines
9.5 KiB
HTML
|
<html lang="en">
|
||
|
|
<head>
|
||
|
|
<title>Requirements - Debugging with GDB</title>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html">
|
||
|
|
<meta name="description" content="Debugging with GDB">
|
||
|
|
<meta name="generator" content="makeinfo 4.13">
|
||
|
|
<link title="Top" rel="start" href="index.html#Top">
|
||
|
|
<link rel="up" href="Installing-GDB.html#Installing-GDB" title="Installing GDB">
|
||
|
|
<link rel="next" href="Running-Configure.html#Running-Configure" title="Running Configure">
|
||
|
|
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
|
||
|
|
<!--
|
||
|
|
Copyright (C) 1988-2019 Free Software Foundation, Inc.
|
||
|
|
|
||
|
|
Permission is granted to copy, distribute and/or modify this document
|
||
|
|
under the terms of the GNU Free Documentation License, Version 1.3 or
|
||
|
|
any later version published by the Free Software Foundation; with the
|
||
|
|
Invariant Sections being ``Free Software'' and ``Free Software Needs
|
||
|
|
Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,''
|
||
|
|
and with the Back-Cover Texts as in (a) below.
|
||
|
|
|
||
|
|
(a) The FSF's Back-Cover Text is: ``You are free to copy and modify
|
||
|
|
this GNU Manual. Buying copies from GNU Press supports the FSF in
|
||
|
|
developing GNU and promoting software freedom.''
|
||
|
|
-->
|
||
|
|
<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; }
|
||
|
|
--></style>
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<div class="node">
|
||
|
|
<a name="Requirements"></a>
|
||
|
|
<p>
|
||
|
|
Next: <a rel="next" accesskey="n" href="Running-Configure.html#Running-Configure">Running Configure</a>,
|
||
|
|
Up: <a rel="up" accesskey="u" href="Installing-GDB.html#Installing-GDB">Installing GDB</a>
|
||
|
|
<hr>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<h3 class="section">C.1 Requirements for Building <span class="sc">gdb</span></h3>
|
||
|
|
|
||
|
|
<p><a name="index-building-_0040value_007bGDBN_007d_002c-requirements-for-3300"></a>
|
||
|
|
Building <span class="sc">gdb</span> requires various tools and packages to be available.
|
||
|
|
Other packages will be used only if they are found.
|
||
|
|
|
||
|
|
<h3 class="heading">Tools/Packages Necessary for Building <span class="sc">gdb</span></h3>
|
||
|
|
|
||
|
|
<dl>
|
||
|
|
<dt>C<tt>++</tt>11 compiler<dd><span class="sc">gdb</span> is written in C<tt>++</tt>11. It should be buildable with any
|
||
|
|
recent C<tt>++</tt>11 compiler, e.g. GCC.
|
||
|
|
|
||
|
|
<br><dt>GNU make<dd><span class="sc">gdb</span>'s build system relies on features only found in the GNU
|
||
|
|
make program. Other variants of <code>make</code> will not work.
|
||
|
|
</dl>
|
||
|
|
|
||
|
|
<h3 class="heading">Tools/Packages Optional for Building <span class="sc">gdb</span></h3>
|
||
|
|
|
||
|
|
<dl>
|
||
|
|
<dt>Expat<dd><a name="Expat"></a><span class="sc">gdb</span> can use the Expat XML parsing library. This library may be
|
||
|
|
included with your operating system distribution; if it is not, you
|
||
|
|
can get the latest version from <a href="http://expat.sourceforge.net">http://expat.sourceforge.net</a>.
|
||
|
|
The <samp><span class="file">configure</span></samp> script will search for this library in several
|
||
|
|
standard locations; if it is installed in an unusual path, you can
|
||
|
|
use the <samp><span class="option">--with-libexpat-prefix</span></samp> option to specify its location.
|
||
|
|
|
||
|
|
<p>Expat is used for:
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>Remote protocol memory maps (see <a href="Memory-Map-Format.html#Memory-Map-Format">Memory Map Format</a>)
|
||
|
|
<li>Target descriptions (see <a href="Target-Descriptions.html#Target-Descriptions">Target Descriptions</a>)
|
||
|
|
<li>Remote shared library lists (See <a href="Library-List-Format.html#Library-List-Format">Library List Format</a>,
|
||
|
|
or alternatively see <a href="Library-List-Format-for-SVR4-Targets.html#Library-List-Format-for-SVR4-Targets">Library List Format for SVR4 Targets</a>)
|
||
|
|
<li>MS-Windows shared libraries (see <a href="Shared-Libraries.html#Shared-Libraries">Shared Libraries</a>)
|
||
|
|
<li>Traceframe info (see <a href="Traceframe-Info-Format.html#Traceframe-Info-Format">Traceframe Info Format</a>)
|
||
|
|
<li>Branch trace (see <a href="Branch-Trace-Format.html#Branch-Trace-Format">Branch Trace Format</a>,
|
||
|
|
see <a href="Branch-Trace-Configuration-Format.html#Branch-Trace-Configuration-Format">Branch Trace Configuration Format</a>)
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<br><dt>Guile<dd><span class="sc">gdb</span> can be scripted using GNU Guile. See <a href="Guile.html#Guile">Guile</a>. By
|
||
|
|
default, <span class="sc">gdb</span> will be compiled if the Guile libraries are
|
||
|
|
installed and are found by <samp><span class="file">configure</span></samp>. You can use the
|
||
|
|
<code>--with-guile</code> option to request Guile, and pass either the Guile
|
||
|
|
version number or the file name of the relevant <code>pkg-config</code>
|
||
|
|
program to choose a particular version of Guile.
|
||
|
|
|
||
|
|
<br><dt>iconv<dd><span class="sc">gdb</span>'s features related to character sets (see <a href="Character-Sets.html#Character-Sets">Character Sets</a>) require a functioning <code>iconv</code> implementation. If you are
|
||
|
|
on a GNU system, then this is provided by the GNU C Library. Some
|
||
|
|
other systems also provide a working <code>iconv</code>.
|
||
|
|
|
||
|
|
<p>If <span class="sc">gdb</span> is using the <code>iconv</code> program which is installed
|
||
|
|
in a non-standard place, you will need to tell <span class="sc">gdb</span> where to
|
||
|
|
find it. This is done with <samp><span class="option">--with-iconv-bin</span></samp> which specifies
|
||
|
|
the directory that contains the <code>iconv</code> program. This program is
|
||
|
|
run in order to make a list of the available character sets.
|
||
|
|
|
||
|
|
<p>On systems without <code>iconv</code>, you can install GNU Libiconv. If
|
||
|
|
Libiconv is installed in a standard place, <span class="sc">gdb</span> will
|
||
|
|
automatically use it if it is needed. If you have previously
|
||
|
|
installed Libiconv in a non-standard place, you can use the
|
||
|
|
<samp><span class="option">--with-libiconv-prefix</span></samp> option to <samp><span class="file">configure</span></samp>.
|
||
|
|
|
||
|
|
<p><span class="sc">gdb</span>'s top-level <samp><span class="file">configure</span></samp> and <samp><span class="file">Makefile</span></samp> will
|
||
|
|
arrange to build Libiconv if a directory named <samp><span class="file">libiconv</span></samp> appears
|
||
|
|
in the top-most source directory. If Libiconv is built this way, and
|
||
|
|
if the operating system does not provide a suitable <code>iconv</code>
|
||
|
|
implementation, then the just-built library will automatically be used
|
||
|
|
by <span class="sc">gdb</span>. One easy way to set this up is to download GNU
|
||
|
|
Libiconv, unpack it inside the top-level directory of the <span class="sc">gdb</span>
|
||
|
|
source tree, and then rename the directory holding the Libiconv source
|
||
|
|
code to ‘<samp><span class="samp">libiconv</span></samp>’.
|
||
|
|
|
||
|
|
<br><dt>lzma<dd><span class="sc">gdb</span> can support debugging sections that are compressed with
|
||
|
|
the LZMA library. See <a href="MiniDebugInfo.html#MiniDebugInfo">MiniDebugInfo</a>. If this library is not
|
||
|
|
included with your operating system, you can find it in the xz package
|
||
|
|
at <a href="http://tukaani.org/xz/">http://tukaani.org/xz/</a>. If the LZMA library is available in
|
||
|
|
the usual place, then the <samp><span class="file">configure</span></samp> script will use it
|
||
|
|
automatically. If it is installed in an unusual path, you can use the
|
||
|
|
<samp><span class="option">--with-lzma-prefix</span></samp> option to specify its location.
|
||
|
|
|
||
|
|
<br><dt>MPFR<dd><a name="MPFR"></a><span class="sc">gdb</span> can use the GNU MPFR multiple-precision floating-point
|
||
|
|
library. This library may be included with your operating system
|
||
|
|
distribution; if it is not, you can get the latest version from
|
||
|
|
<a href="http://www.mpfr.org">http://www.mpfr.org</a>. The <samp><span class="file">configure</span></samp> script will search
|
||
|
|
for this library in several standard locations; if it is installed
|
||
|
|
in an unusual path, you can use the <samp><span class="option">--with-libmpfr-prefix</span></samp>
|
||
|
|
option to specify its location.
|
||
|
|
|
||
|
|
<p>GNU MPFR is used to emulate target floating-point arithmetic during
|
||
|
|
expression evaluation when the target uses different floating-point
|
||
|
|
formats than the host. If GNU MPFR it is not available, <span class="sc">gdb</span>
|
||
|
|
will fall back to using host floating-point arithmetic.
|
||
|
|
|
||
|
|
<br><dt>Python<dd><span class="sc">gdb</span> can be scripted using Python language. See <a href="Python.html#Python">Python</a>.
|
||
|
|
By default, <span class="sc">gdb</span> will be compiled if the Python libraries are
|
||
|
|
installed and are found by <samp><span class="file">configure</span></samp>. You can use the
|
||
|
|
<code>--with-python</code> option to request Python, and pass either the
|
||
|
|
file name of the relevant <code>python</code> executable, or the name of the
|
||
|
|
directory in which Python is installed, to choose a particular
|
||
|
|
installation of Python.
|
||
|
|
|
||
|
|
<br><dt>zlib<dd><a name="index-compressed-debug-sections-3301"></a><span class="sc">gdb</span> will use the ‘<samp><span class="samp">zlib</span></samp>’ library, if available, to read
|
||
|
|
compressed debug sections. Some linkers, such as GNU gold, are capable
|
||
|
|
of producing binaries with compressed debug sections. If <span class="sc">gdb</span>
|
||
|
|
is compiled with ‘<samp><span class="samp">zlib</span></samp>’, it will be able to read the debug
|
||
|
|
information in such binaries.
|
||
|
|
|
||
|
|
<p>The ‘<samp><span class="samp">zlib</span></samp>’ library is likely included with your operating system
|
||
|
|
distribution; if it is not, you can get the latest version from
|
||
|
|
<a href="http://zlib.net">http://zlib.net</a>.
|
||
|
|
</dl>
|
||
|
|
|
||
|
|
</body></html>
|
||
|
|
|