git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@9242 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Ken Moffat 2012-01-27 18:05:39 +00:00
parent 19975bdbf3
commit 4b0ebf707b
4 changed files with 173 additions and 2 deletions

View File

@ -3,13 +3,13 @@ $LastChangedBy$
$Date$
-->
<!ENTITY day "27"> <!-- Always 2 digits -->
<!ENTITY day "28"> <!-- Always 2 digits -->
<!ENTITY month "01"> <!-- Always 2 digits -->
<!ENTITY year "2012">
<!ENTITY copyrightdate "2001-&year;">
<!ENTITY copyholder "The BLFS Development Team">
<!ENTITY version "&year;-&month;-&day;">
<!ENTITY releasedate "January 27th, &year;">
<!ENTITY releasedate "January 28th, &year;">
<!-- <!ENTITY releasedate "November &day;st, &year;"> -->
<!ENTITY pubdate "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
<!ENTITY blfs-version "svn"> <!-- svn|[release #] -->
@ -345,6 +345,7 @@ $Date$
<!ENTITY gc-version "7.1">
<!ENTITY gcc-version "4.5.1">
<!ENTITY gcc3-version "3.3.6">
<!ENTITY gdb-version "7.3.1">
<!ENTITY guile-version "2.0.3">
<!ENTITY icedtea6-version "1.9.7">
<!ENTITY jdk-version "6 Update 18">

160
general/prog/gdb.xml Normal file
View File

@ -0,0 +1,160 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY gdb-download-http "http://ftp.gnu.org/gnu/gdb/gdb-&gdb-version;.tar.bz2">
<!ENTITY gdb-download-ftp "ftp://ftp.gnu.org/gnu/gdb/gdb-&gdb-version;.tar.bz2">
<!ENTITY gdb-md5sum "b89a5fac359c618dda97b88645ceab47">
<!ENTITY gdb-size "19 MB">
<!ENTITY gdb-buildsize "369 MB">
<!ENTITY gdb-time "1.5 SBU">
]>
<sect1 id="gdb" xreflabel="gdb-&gdb-version;">
<?dbhtml filename="gdb.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>gdb-&gdb-version;</title>
<indexterm zone="gdb">
<primary sortas="a-gdb">gdb</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to gdb</title>
<para><application>GDB</application>, the GNU Project debugger, allows you
to see what is going on `inside' another program while it executes -- or
what another program was doing at the moment it crashed.</para>
&lfs70_built;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&gdb-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&gdb-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &gdb-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &gdb-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &gdb-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &gdb-time;</para>
</listitem>
</itemizedlist>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gdb"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of gdb</title>
<para>Install <application>gdb</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr \
--disable-werror &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make -C gdb install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>--disable-werror</command>: Recent versions of
<application>gcc</application> generate warnings for a lot more
<emphasis>possible</emphasis> errors. Because the <filename>Makefile</filename>
uses the <literal>-Werror</literal> switch by default (to treat warnings as
errors), this override is needed to allow the package to compile.</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>gdb, gdbserver, and gdbtui</seg>
<seg>libinproctrace.so</seg>
<seg>/usr/share/gdb/{python/gdb/command,syscalls}</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="gdb-prog">
<term><command>gdb</command></term>
<listitem>
<para>is the GNU Debugger.</para>
<indexterm zone="gdb gdb-prog">
<primary sortas="b-gdb-prog">gdb-prog</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gdbserver">
<term><command>gdbserver</command></term>
<listitem>
<para>is a remote server for the GNU debugger (it allows programs to be
debugged from a different machine).</para>
<indexterm zone="gdb gdbserver">
<primary sortas="b-gdbserver">gdbserver</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gdbtui">
<term><command>gdbtui</command></term>
<listitem>
<para>is a text user interface for <application>gdb</application>.</para>
<indexterm zone="gdb gdbtui">
<primary sortas="b-gdbtui">gdbtui</primary>
</indexterm>
</listitem>
</varlistentry>
<!-- commenting, unless anyone feels able to describe this.
<varlistentry id="libinproctrace">
<term><filename class='libraryfile'>libinproctrace.so</filename></term>
<listitem>
<para>contains functions that .....</para>
<indexterm zone="gdb libinproctrace">
<primary sortas="c-libinproctrace">libinproctrace.so</primary>
</indexterm>
</listitem>
</varlistentry> -->
</variablelist>
</sect2>
</sect1>

View File

@ -32,6 +32,7 @@ $Date$
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gc.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gcc.xml"/>
<!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gcc3.xml"/> -->
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gdb.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="guile.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="icedtea6.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="jdk.xml"/>

View File

@ -41,6 +41,15 @@
</listitem>
-->
<listitem>
<para>January 28th, 2012</para>
<itemizedlist>
<listitem>
<para>[ken] - Add gdb-7.3.1 from Wayne.</para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>January 27th, 2012</para>
<itemizedlist>