Author: ken Date: 2012-01-27 11:05:39 -0700 (Fri, 27 Jan 2012) New Revision: 9242
Added: trunk/BOOK/general/prog/gdb.xml Modified: trunk/BOOK/general.ent trunk/BOOK/general/prog/prog.xml trunk/BOOK/introduction/welcome/changelog.xml Log: Add gdb. Added: trunk/BOOK/general/prog/gdb.xml =================================================================== --- trunk/BOOK/general/prog/gdb.xml (rev 0) +++ trunk/BOOK/general/prog/gdb.xml 2012-01-27 18:05:39 UTC (rev 9242) @@ -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 && +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> Property changes on: trunk/BOOK/general/prog/gdb.xml ___________________________________________________________________ Added: svn:keywords + Date LastChangedBy Modified: trunk/BOOK/general/prog/prog.xml =================================================================== --- trunk/BOOK/general/prog/prog.xml 2012-01-27 16:18:46 UTC (rev 9241) +++ trunk/BOOK/general/prog/prog.xml 2012-01-27 18:05:39 UTC (rev 9242) @@ -32,6 +32,7 @@ <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"/> Modified: trunk/BOOK/general.ent =================================================================== --- trunk/BOOK/general.ent 2012-01-27 16:18:46 UTC (rev 9241) +++ trunk/BOOK/general.ent 2012-01-27 18:05:39 UTC (rev 9242) @@ -3,13 +3,13 @@ $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 @@ <!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"> Modified: trunk/BOOK/introduction/welcome/changelog.xml =================================================================== --- trunk/BOOK/introduction/welcome/changelog.xml 2012-01-27 16:18:46 UTC (rev 9241) +++ trunk/BOOK/introduction/welcome/changelog.xml 2012-01-27 18:05:39 UTC (rev 9242) @@ -42,6 +42,15 @@ --> <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> <listitem> -- http://linuxfromscratch.org/mailman/listinfo/blfs-book FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
