debug/org.eclipse.ptp.debug.sdm/libaif/doc/libaif.xml

<?xml version='1.0'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
          "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<book><title>Libaif</title>
  <bookinfo>
    <authorgroup>
      <author>
	<firstname>Greg</firstname>
	<surname>Watson</surname>
      </author>
      <author>
	<firstname>David</firstname>
	<surname>Abramson</surname>
      </author>
      <author>
	<firstname>Brian</firstname>
	<surname>May</surname>
      </author>
      <author>
	<firstname>Donny</firstname>
	<surname>Kurniawan</surname>
      </author>
    </authorgroup>
    <copyright>
      <year>2001</year>
      <holder>GuardSoft Pty. Ltd.</holder>
    </copyright>
    <affiliation>
      <orgname>Monash University</orgname>
      <address>Clayton, Victoria, Melbourne</address>
    </affiliation>
  </bookinfo>

<!-- ====================================================================== -->
<chapter><title>Quick Start</title>
<para>
This chapter describes how to start using <emphasis>libaif</emphasis>
in the minimum amount of time.
</para>

<section><title>Installing <emphasis>libaif</emphasis></title>

<para>
<itemizedlist>
  <listitem>
    <para>Download and extract the source code:</para>
<para>
<screen>

$ tar -xzf libaif-1.0.0.tar.gz

</screen>
    </para>
  </listitem>

  <listitem>
    <para>Compile and install <emphasis>libaif</emphasis> by
    changing to the
    directory, and using <userinput>configure</userinput> and
    <userinput>make</userinput>, followed by
    <userinput>make install</userinput> (as root).</para>

    <para>For example:
<screen>

$ cd libaif-1.0.0
$ configure

...

$ make

...

$ make install

...

</screen></para>
  </listitem>
</itemizedlist>
</para>

</section>

<!-- ...................................................................... -->

<section><title>Installing patched <emphasis>GDB</emphasis></title>

<para>
<itemizedlist>
  <listitem>
    <para>AIF is currently supported in versions 5.0 and 5.2 of <emphasis>GDB</emphasis>. 
    Download the source code for the version of <emphasis>GDB</emphasis> that suits your system.
    </para>
  </listitem>
  <listitem>
    <para>Extract source code, and apply the patch from
    <emphasis>libaif</emphasis>, using
    the supplied patch script <userinput>applypatch</userinput>.</para>

    <para> For example:
<screen>

$ cd /tmp
$ tar -xzf gdb_5.0.tar.gz 
$ cd $(libaif)/patches
$ ./applypatch -install-all /tmp/gdb-5.0
patching file gdb-5.0/gdb/aif-valprint.c
patching file gdb-5.0/gdb/c-valprint.c
patching file gdb-5.0/gdb/printcmd.c
patching file gdb-5.0/gdb/typeprint.c
patching file gdb-5.0/gdb/valprint.c
patching file gdb-5.0/gdb/Makefile.in
patching file gdb-5.0/gdb/libaif.mk

</screen>
    </para>
  </listitem>

  <listitem>
    <para>Compile and install <emphasis>GDB</emphasis> by
    changing to the
    directory, and using <userinput>configure</userinput> and
    <userinput>make</userinput>, followed by
    <userinput>make install</userinput> (as root).
    </para>

    <note><para>You should use the
      <userinput>--with-aif=<replaceable>dir</replaceable></userinput> (or 
      <userinput>--with-aif-lib=<replaceable>dir</replaceable></userinput> and
      <userinput>--with-aif-include=<replaceable>dir</replaceable></userinput>)
      options in order to allow <userinput>configure</userinput> to locate the
      libaif library and include files.
    </para></note>

    <para> Example:
<screen>

$ cd /tmp/gdb-5.0
$ ./configure --with-aif=$(libaif-insdir) alpha-redhat-linux

...

$ make

...

$ make install

...

</screen>
</para>
  </listitem>

</itemizedlist>
</para>

</section>

<!-- ...................................................................... -->

</chapter>

<!-- ====================================================================== -->

</book>